Skip to content

Vgoloshivskiy/BookingSystem / .claude/skills/add-booking-endpoint

add-booking-endpoint

Verified

Use when adding a new API endpoint to BookingSystem.Api, to keep controller/service/DTO/test structure consistent with the rest of the codebase.

FileKindSize
SKILL.mdskill md2.1 KB
---
name: add-booking-endpoint
description: Use when adding a new API endpoint to BookingSystem.Api, to keep controller/service/DTO/test structure consistent with the rest of the codebase.
---

# Adding a new endpoint to BookingSystem.Api

Follow this sequence so new endpoints match the codebase's conventions (see CLAUDE.md):

1. **DTOs first.** Add request/response `record` types to the relevant file in `DTOs/`
   (e.g. `BookingDtos.cs`). Never expose an EF entity directly from a controller.
2. **Service method.** If the endpoint does anything beyond a simple CRUD read, add the
   logic to the matching interface + implementation in `Services/` (e.g.
   `IBookingService` / `BookingService`), not directly in the controller.
   - If the new logic reads then writes state that another request could also be
     writing concurrently, do NOT use a plain read-then-write. Use an atomic
     conditional `UPDATE ... WHERE` (see `BookingService.CreateBookingAsync`) or an EF
     Core concurrency token, and return a distinguishable "conflict" outcome rather
     than throwing.
3. **Controller action.** Thin method: model-bind the request DTO, call the service,
   map the result to the response DTO / appropriate status code
   (`Ok` / `Created` / `Conflict` / `NotFound` — never a bare 500 for an expected
   outcome like "lost the race").
4. **Authorization.** Add `[Authorize]` (already on the controller by default) and
   `[Authorize(Roles = Roles.Admin)]` on the action if it's an admin-only operation.
5. **Test.** Add an xUnit test in `BookingSystem.Tests` for the happy path and for the
   conflict/error path. If the endpoint touches shared mutable state (like a booking or
   slot), add or extend a concurrency test modeled on `ConcurrencyTests.cs`: fire
   several requests with `Task.WhenAll` and assert exactly one wins.
6. **Frontend (optional).** If the endpoint needs a UI, add a small function to
   `frontend/app.js` following the existing `api()` helper pattern — no new frontend
   framework or build step.

Run `dotnet build && dotnet test` before considering the change done.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 323kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 323kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 323kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall