Add client-side Notes page with API integration and shared contracts

This commit is contained in:
Chuck Smith
2026-02-22 15:24:56 -05:00
parent 9cf0cbadd6
commit 6a1aed8e13
17 changed files with 678 additions and 193 deletions

47
docs/ai/AI_TASKS.md Normal file
View File

@@ -0,0 +1,47 @@
# AI_TASKS.md
Quick task cookbook for common changes in this repo.
## Add a new API endpoint group
1) Create `Freman.Sample.Web/Endpoints/<Feature>Endpoints.cs`
2) Add an extension method:
- `public static IEndpointRouteBuilder Map<Feature>Endpoints(this IEndpointRouteBuilder app)`
3) Call it from `Freman.Sample.Web/Program.cs`:
- `app.Map<Feature>Endpoints();`
## Add a new Client page that calls the API
1) Create page in `Freman.Sample.Web.Client/Pages/<Page>.razor`
2) Ensure it runs as WASM and avoids server prerender DI issues:
- `@rendermode @(new InteractiveWebAssemblyRenderMode(prerender: false))`
3) Inject `HttpClient`:
- `@inject HttpClient Http`
4) Call server endpoints under `/api/*`
## Add shared request/response models
1) Add to `Freman.Sample.Web.Contracts`
2) Reference contracts project from Server + Client
3) Use contracts types in endpoints + client code (avoid duplicates)
## Add an EF Core migration
From solution root:
```
powershell dotnet tool restore
dotnet tool run dotnet-ef -- migrations add --project .\Freman.Sample.Web\Freman.Sample.Web\Freman.Sample.Web.csproj --startup-project .\Freman.Sample.Web\Freman.Sample.Web\Freman.Sample.Web.csproj ` --output-dir Data\Migrations
```
## Apply migrations manually (optional)
```
powershell dotnet tool run dotnet-ef -- database update --project .\Freman.Sample.Web\Freman.Sample.Web\Freman.Sample.Web.csproj --startup-project .\Freman.Sample.Web\Freman.Sample.Web\Freman.Sample.Web.csproj
```
## Add a confirmation step in the client
Use `Freman.Sample.Web.Client/Components/ConfirmModal.razor` and call:
- `await _confirmModal.ShowAsync("Title", "Message")`