43 lines
1.9 KiB
Markdown
43 lines
1.9 KiB
Markdown
|
# Codebase Structure
|
||
|
|
|
||
|
|
## Top-Level Map
|
||
|
|
|
||
|
|
| Path | Purpose | Evidence |
|
||
|
|
|---|---|---|
|
||
|
|
| `src/apps/` | Runnable application hosts | `Elsa.sln` |
|
||
|
|
| `src/common/` | Shared infrastructure | `Elsa.sln` |
|
||
|
|
| `src/modules/` | Feature and domain modules | `Elsa.sln` |
|
||
|
|
| `src/clients/` | API client contracts | `src/clients/Elsa.Api.Client/` |
|
||
|
|
| `test/` | Unit, integration, component, and performance tests | `test/Directory.Build.props` |
|
||
|
|
| `build/` | NUKE build automation | `build/Build.cs` |
|
||
|
|
| `specs/` | Feature specifications and plans | `specs/012-weaver-grounding-tools/plan.md` |
|
||
|
|
|
||
|
|
## Entry Points
|
||
|
|
|
||
|
|
- Main runtime entry points are the application projects under `src/apps/`.
|
||
|
|
- External Authentication is composed through `AddExternalAuthenticationServices` and optional EF Core replacement registration.
|
||
|
|
- Endpoint discovery is module-based; identity-link endpoints live under `Elsa.ExternalAuthentication/Endpoints/IdentityLinks`.
|
||
|
|
|
||
|
|
## Module Boundaries
|
||
|
|
|
||
|
|
| Boundary | Belongs here | Must not be here |
|
||
|
|
|---|---|---|
|
||
|
|
| `Elsa.ExternalAuthentication` | Broker orchestration, contracts, in-memory stores, safe HTTP DTOs | Provider-specific protocol behavior |
|
||
|
|
| `Elsa.ExternalAuthentication.OpenIdConnect` | OIDC callback and provider adapter behavior | Elsa user authorization policy |
|
||
|
|
| `Elsa.ExternalAuthentication.Persistence.EFCore` | Durable entities and store implementations | UI presentation |
|
||
|
|
| `Elsa.Api.Client` | Backward-compatible client DTOs and HTTP contracts | Persistence entities |
|
||
|
|
|
||
|
|
## Naming and Organization Rules
|
||
|
|
|
||
|
|
- C# files and public types use PascalCase.
|
||
|
|
- Modules are organized by feature, then by contracts/services/endpoints/stores.
|
||
|
|
- Namespaces follow folders and are file-scoped.
|
||
|
|
|
||
|
|
## Evidence
|
||
|
|
|
||
|
|
- `Elsa.sln`
|
||
|
|
- `src/modules/Elsa.ExternalAuthentication/Extensions/ServiceCollectionExtensions.cs`
|
||
|
|
- `src/modules/Elsa.ExternalAuthentication.Persistence.EFCore/Extensions/ServiceCollectionExtensions.cs`
|
||
|
|
- `.editorconfig`
|
||
|
|
|