Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .vscode/launch.json
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
{
// F5 : lance toute l'application (Postgres + API + front) avec le débogueur attaché.
// F5 : lance toute l'application (Postgres, RabbitMQ, services, Gateway, front) avec le débogueur attaché.
"version": "0.2.0",
"configurations": [
{
"name": "TaskFlow (Aspire)",
"type": "aspire",
"request": "launch",
"program": "${workspaceFolder}/src/TaskFlow.AppHost/TaskFlow.AppHost.csproj"
"program": "${workspaceFolder}/src/AppHost/TaskFlow.AppHost/TaskFlow.AppHost.csproj"
}
]
}
2 changes: 1 addition & 1 deletion .vscode/tasks.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
{
"label": "TaskFlow : lancer (Aspire)",
"type": "shell",
"command": "dotnet run --project src/TaskFlow.AppHost",
"command": "dotnet run --project src/AppHost/TaskFlow.AppHost",
"isBackground": true,
"problemMatcher": []
},
Expand Down
15 changes: 13 additions & 2 deletions Directory.Packages.props
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,22 @@
<PackageVersion Include="Aspire.Hosting.PostgreSQL" Version="13.5.4" />
<PackageVersion Include="Aspire.Hosting.JavaScript" Version="13.5.4" />
<PackageVersion Include="Aspire.Npgsql.EntityFrameworkCore.PostgreSQL" Version="13.5.4" />
<PackageVersion Include="Aspire.Hosting.RabbitMQ" Version="13.5.4" />
<PackageVersion Include="Aspire.RabbitMQ.Client" Version="13.5.4" />
</ItemGroup>

<ItemGroup Label="Microservices">
<PackageVersion Include="Yarp.ReverseProxy" Version="2.3.0" />
<PackageVersion Include="Microsoft.Extensions.ServiceDiscovery.Yarp" Version="10.10.0" />
<PackageVersion Include="WolverineFx" Version="6.41.0" />
<PackageVersion Include="WolverineFx.RabbitMQ" Version="6.41.0" />
<PackageVersion Include="WolverineFx.EntityFrameworkCore" Version="6.41.0" />
<PackageVersion Include="WolverineFx.Postgresql" Version="6.41.0" />
</ItemGroup>

<ItemGroup Label="ServiceDefaults">
<PackageVersion Include="Microsoft.Extensions.Http.Resilience" Version="10.8.0" />
<PackageVersion Include="Microsoft.Extensions.ServiceDiscovery" Version="10.8.0" />
<PackageVersion Include="Microsoft.Extensions.Http.Resilience" Version="10.10.0" />
<PackageVersion Include="Microsoft.Extensions.ServiceDiscovery" Version="10.10.0" />
<PackageVersion Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="1.19.1" />
<PackageVersion Include="OpenTelemetry.Extensions.Hosting" Version="1.19.1" />
<PackageVersion Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.19.0" />
Expand Down
54 changes: 36 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,27 @@
# TaskFlow

Outil de gestion de projets (style Jira/Trello), projet de formation .NET 10 + Angular 22.
Voir le mémo technique : [docs/TaskFlow_Memo_Technique_v1.html](docs/TaskFlow_Memo_Technique_v1.html).
Outil de gestion de projets (style Jira/Trello) en **microservices**, projet de formation .NET 10 + Angular 22.

- Mémo v1, les fondations : [docs/TaskFlow_Memo_Technique_v1.html](docs/TaskFlow_Memo_Technique_v1.html)
- Mémo v2, les microservices et RabbitMQ : [docs/TaskFlow_Memo_Technique_v2.html](docs/TaskFlow_Memo_Technique_v2.html)

## Architecture

```
Angular ──► Gateway (YARP) ──► Projects API ──► projectsdb (Postgres)
│
└────────► RabbitMQ 4 ◄── (Tasks, Notifications, Reports : à venir)
```

## Stack

| Couche | Technologies |
|---|---|
| Orchestration locale | Aspire 13 (AppHost, dashboard, OpenTelemetry) |
| API | ASP.NET Core 10 Minimal APIs, ProblemDetails, OpenAPI + Scalar |
| Architecture | Modular monolith, Clean Architecture + Vertical Slices |
| Données | PostgreSQL 18 (conteneur Podman), EF Core 10 |
| Gateway | YARP 2 + service discovery Aspire |
| Services | ASP.NET Core 10 Minimal APIs, Clean Architecture + Vertical Slices |
| Messagerie | RabbitMQ 4, Wolverine 6 (outbox, sagas) |
| Données | PostgreSQL 18, une base par service, EF Core 10 |
| Front | Angular 22 zoneless, signals, `httpResource`, Vitest, ESLint |
| Tests | xUnit v3, Shouldly, NetArchTest |
| CI | GitHub Actions, Dependabot |
Expand All @@ -19,17 +30,24 @@ Voir le mémo technique : [docs/TaskFlow_Memo_Technique_v1.html](docs/TaskFlow_M

```
src/
TaskFlow.AppHost/ Orchestration Aspire (Postgres + API + front)
TaskFlow.ServiceDefaults/ OpenTelemetry, health checks, résilience
TaskFlow.Api/ Hôte HTTP : Program.cs, gestion d'erreurs
TaskFlow.SharedKernel/ Entity, AggregateRoot, Result, Error, DomainEvent
Modules/Projects/ Module Projects : Domain / Application / Infrastructure
web/taskflow-ui/ Application Angular (core / features / shared)
tests/ Tests d'architecture et unitaires
AppHost/TaskFlow.AppHost/ Orchestration Aspire (Postgres, RabbitMQ, services, gateway, front)
BuildingBlocks/
TaskFlow.ServiceDefaults/ OpenTelemetry, health checks, résilience
TaskFlow.SharedKernel/ Entity, AggregateRoot, Result, Error, DomainEvent
Gateway/TaskFlow.Gateway/ YARP : /api/projects/* -> projects-api
Services/Projects/
TaskFlow.Projects.Api/ Hôte HTTP du service
TaskFlow.Projects.Domain/
TaskFlow.Projects.Application/
TaskFlow.Projects.Infrastructure/
TaskFlow.Projects.Contracts/ Événements d'intégration publics
web/taskflow-ui/ Application Angular (core / features / shared)
tests/ Tests d'architecture et unitaires
```

Règle de dépendance, vérifiée par `tests/TaskFlow.ArchitectureTests` :
`Domain ← Application ← Infrastructure ← Api`.
Règles vérifiées par `tests/TaskFlow.ArchitectureTests` :
- dans un service : `Domain ← Application ← Infrastructure ← Api` ;
- entre services : on ne référence que le projet `*.Contracts` d'un autre service, et la Gateway n'en référence aucun.

## Prérequis

Expand All @@ -41,11 +59,11 @@ Règle de dépendance, vérifiée par `tests/TaskFlow.ArchitectureTests` :
## Lancer l'application

```bash
dotnet run --project src/TaskFlow.AppHost
dotnet run --project src/AppHost/TaskFlow.AppHost
```

Le lien du dashboard Aspire s'affiche dans la console. Il donne accès à Postgres, à l'API (`/scalar` pour tester les endpoints)
et au front Angular.
Ou **F5** dans VS Code. Le lien du dashboard Aspire s'affiche dans la console. Il donne accès à tous les services,
à l'interface d'administration de RabbitMQ et au front Angular.

## Tests

Expand All @@ -67,6 +85,6 @@ npm test -- --watch=false

## Particularités du poste de travail

- **Podman** remplace Docker : `ASPIRE_CONTAINER_RUNTIME=podman` est défini dans `src/TaskFlow.AppHost/Properties/launchSettings.json`.
- **Podman** remplace Docker : `ASPIRE_CONTAINER_RUNTIME=podman` est défini dans `src/AppHost/TaskFlow.AppHost/Properties/launchSettings.json`.
- **Pas de `.exe` pour les projets applicatifs** (`UseAppHost=false`, voir `Directory.Build.targets`) : ils sont lancés via `dotnet X.dll`.
- **Proxy d'entreprise** : le registre npm doit être en `https://registry.npmjs.org/`.
27 changes: 17 additions & 10 deletions TaskFlow.slnx
Original file line number Diff line number Diff line change
@@ -1,15 +1,22 @@
<Solution>
<Folder Name="/src/">
<Project Path="src/TaskFlow.Api/TaskFlow.Api.csproj" />
<Project Path="src/TaskFlow.AppHost/TaskFlow.AppHost.csproj" />
<Project Path="src/TaskFlow.ServiceDefaults/TaskFlow.ServiceDefaults.csproj" />
<Folder Name="/src/" />
<Folder Name="/src/AppHost/">
<Project Path="src/AppHost/TaskFlow.AppHost/TaskFlow.AppHost.csproj" />
</Folder>
<Folder Name="/src/Modules/" />
<Folder Name="/src/Modules/Projects/">
<Project Path="src/Modules/Projects/TaskFlow.Projects.Application/TaskFlow.Projects.Application.csproj" />
<Project Path="src/Modules/Projects/TaskFlow.Projects.Domain/TaskFlow.Projects.Domain.csproj" />
<Project Path="src/Modules/Projects/TaskFlow.Projects.Infrastructure/TaskFlow.Projects.Infrastructure.csproj" />
<Project Path="src/TaskFlow.SharedKernel/TaskFlow.SharedKernel.csproj" />
<Folder Name="/src/BuildingBlocks/">
<Project Path="src/BuildingBlocks/TaskFlow.ServiceDefaults/TaskFlow.ServiceDefaults.csproj" />
<Project Path="src/BuildingBlocks/TaskFlow.SharedKernel/TaskFlow.SharedKernel.csproj" />
</Folder>
<Folder Name="/src/Gateway/">
<Project Path="src/Gateway/TaskFlow.Gateway/TaskFlow.Gateway.csproj" />
</Folder>
<Folder Name="/src/Services/" />
<Folder Name="/src/Services/Projects/">
<Project Path="src/Services/Projects/TaskFlow.Projects.Api/TaskFlow.Projects.Api.csproj" />
<Project Path="src/Services/Projects/TaskFlow.Projects.Application/TaskFlow.Projects.Application.csproj" />
<Project Path="src/Services/Projects/TaskFlow.Projects.Contracts/TaskFlow.Projects.Contracts.csproj" />
<Project Path="src/Services/Projects/TaskFlow.Projects.Domain/TaskFlow.Projects.Domain.csproj" />
<Project Path="src/Services/Projects/TaskFlow.Projects.Infrastructure/TaskFlow.Projects.Infrastructure.csproj" />
</Folder>
<Folder Name="/tests/">
<Project Path="tests/TaskFlow.ArchitectureTests/TaskFlow.ArchitectureTests.csproj" />
Expand Down
Loading
Loading