stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity

up

Browse Source
This commit is contained in:
StellaOps Bot
2025-12-14 23:20:14 +02:00
parent 3411e825cd
commit b058dbe031
356 changed files with 68310 additions and 1108 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
docs/18_CODING_STANDARDS.md
View File

@@ -54,8 +54,8 @@ There are no folders named “Module” and no nested solutions.
| Namespaces | File‑scoped, StellaOps.<Area> | namespace StellaOps.Scanners; |
| Interfaces | I prefix, PascalCase | IScannerRunner |
| Classes / records | PascalCase | ScanRequest, TrivyRunner |
| Private fields | camelCase (no leading underscore) | redisCache, httpClient |
| Constants | SCREAMING_SNAKE_CASE | const int MAX_RETRIES = 3; |
| Private fields | _camelCase (with leading underscore) | _redisCache, _httpClient |
| Constants | PascalCase (standard C#) | const int MaxRetries = 3; |
| Async methods | End with Async | Task<ScanResult> ScanAsync() |
| File length | ≤ 100 lines incl. using & braces | enforced by dotnet format check |
| Using directives | Outside namespace, sorted, no wildcards | — |
@@ -133,7 +133,7 @@ Capture structured logs with Serilog’s message‑template syntax.
| Layer | Framework | Coverage gate |
| ------------------------ | ------------------------ | -------------------------- |
| Unit | xUnit + FluentAssertions | ≥ 80 % line, ≥ 60 % branch |
| Integration | Testcontainers | Real Redis & Trivy |
| Integration | Testcontainers | PostgreSQL, real services |
| Mutation (critical libs) | Stryker.NET | ≥ 60 % score |
One test project per runtime/contract project; naming <Project>.Tests.
@@ -165,5 +165,6 @@ One test project per runtime/contract project; naming <Project>.Tests.
| Version | Date | Notes |
| ------- | ---------- | -------------------------------------------------------------------------------------------------- |
| v2.0 | 2025‑07‑12 | Updated DI policy, 100‑line rule, new repo layout, camelCase fields, removed “Module” terminology. |
| 1.0 | 2025‑07‑09 | Original standards. |
| v2.1 | 2025-12-14 | Corrected field naming to _camelCase, constants to PascalCase, integration tests to PostgreSQL. |
| v2.0 | 2025-07-12 | Updated DI policy, 100-line rule, new repo layout, removed "Module" terminology. |
| v1.0 | 2025-07-09 | Original standards. |