refinement phase 1

server/CLAUDE.md

@@ -56,8 +56,9 @@ You are a **senior .NET software engineer** working on this codebase. That means
 | Update DB | `dotnet ef database update --project src/Infrastructure/Baya.Infrastructure.Persistence --startup-project src/API/Baya.Web.Api` |
 
 **Default URL:** `https://localhost:5002` — Swagger at `/swagger`.
-On boot, `Program.cs` calls `ApplyMigrationsAsync()` and `SeedDefaultUsersAsync()` — a reachable SQL
-Server is required to start.
+On boot, `Program.cs` calls `ApplyMigrationsAsync()`, `SeedDefaultUsersAsync()`, `SeedPaymentGatewaysAsync()`
+— and, **only in Development**, `SeedDemoWorldAsync()` (the demo marketplace seeder, see Persistence below).
+A reachable SQL Server is required to start.
 
 ---
 
@@ -571,6 +572,15 @@ action to `sender.Send(...)`. Full conventions are in [CONVENTIONS.md](CONVENTIO
 - Always project to a DTO in queries — never return entity objects from handlers.
 - Add entity config in `Persistence/Configuration/<Area>Config/` implementing `IEntityTypeConfiguration<T>`.
 - Soft delete is enforced via a global query filter per entity (see [CONVENTIONS.md](CONVENTIONS.md) §6).
+- **Development demo seeder (refinement-phase-1).** `Persistence/Services/Seeding/DemoWorldSeeder.cs`
+  (+ `DemoWorldDefinitions.cs`) idempotently populates a coherent demo marketplace on top of the reference
+  `HasData` seeds — 3 nurses (2 verified w/ variants + Tehran coverage + `approved` verification + credentials
+  + a `matched_national_id` bank account, 1 unverified), 2 customers (patients + addresses), and one
+  cross-category required demo option group (شیفت / *Shift Type*). It writes through the real entities and
+  drives the search projection through `ISearchIndexMaintainer.RebuildAsync` (never hand-inserts index rows),
+  guarding each persona on its phone number so re-runs are a no-op. Invoked via `SeedDemoWorldAsync()`
+  **only under `IsDevelopment()`** — never in Production/Staging. The demo world (phones, which nurse is
+  verified) is in `dev/post-phase/refinement/RUNBOOK.md`.
 
 ---