2026-06-04 06:09:11 +03:30
|
|
|
@AGENTS.md
|
2026-06-05 10:47:51 +03:30
|
|
|
|
|
|
|
|
# Barg-e Vasat (Hokm) — start here
|
|
|
|
|
|
|
|
|
|
**Read `HANDOFF.md` first** — it is the single source of truth for this project:
|
|
|
|
|
what it is, how to run (dev + Docker stack), the architecture, the
|
|
|
|
|
client↔server gamification sync rule, feature status, CI/CD + mirror cert
|
|
|
|
|
workaround, and the TODO list.
|
|
|
|
|
|
|
|
|
|
Quick facts:
|
|
|
|
|
- Next.js 16 static-export app at root; .NET 10 SignalR backend in `server/`.
|
|
|
|
|
- Git remote `origin` = Gitea (`soroushdes/HokmPlay`, branch `main`); push triggers CI/CD.
|
|
|
|
|
- i18n: add every string to BOTH `fa` and `en` in `src/lib/i18n.tsx`.
|
|
|
|
|
- Gamification lives in `src/lib/online/gamification.ts` (client) AND
|
|
|
|
|
`server/src/Hokm.Server/Profiles/Gamification.cs` (server) — keep them in sync;
|
|
|
|
|
the server is authoritative in live mode.
|
|
|
|
|
- Verify before committing: `npx tsc --noEmit` · `npx tsx scripts/sim.ts` ·
|
|
|
|
|
`dotnet build server/Hokm.slnx -c Release` · `npm run build`.
|
