docs: add Blazor POS page patterns note to AGENTS.md

Co-authored-by: Velik <hongochai10@users.noreply.github.com>
This commit is contained in:
Cursor Agent
2026-02-26 15:49:41 +00:00
parent a2b5de5b18
commit 9bfab575c6

View File

@@ -36,3 +36,4 @@ Standard commands are documented in `README.md` and `package.json` scripts. Quic
- **.NET 10 SDK for Blazor apps**: Install via `~/.dotnet/dotnet-install.sh --channel 10.0 --install-dir $HOME/.dotnet`. The update script handles this automatically. Ensure `DOTNET_ROOT=$HOME/.dotnet` and `PATH` includes `$HOME/.dotnet`.
- **Blazor TPOS app (`web-client-tpos-net`) pre-existing build errors**: Files in `Pages/Pos/Shared/Dialogs/` (`VoidRefund.razor`, `OrderEdit.razor`, `SplitBill.razor`) have `&quot;` encoding and syntax errors that prevent `dotnet build`/`dotnet run`. The Payment workflow files in `Pages/Pos/Shared/Payment/` compile cleanly.
- **Blazor TPOS dev server**: `dotnet run --project src/WebClientTpos.Server` from `apps/web-client-tpos-net/` serves on port 5091 (requires pre-existing Dialogs build errors to be fixed first).
- **Blazor POS page patterns**: All POS Razor files use `@layout PosLayout`, `@inherits PosBase`, bilingual `EN: / VI:` comments, `@* ═══ SECTION ═══ *@` separators, CSS variables (`--pos-*`), `FormatPrice(decimal)`, `NavigateTo(string)`, Lucide icons, and hardcoded Vietnamese demo data. Verticals: Cafe, Restaurant, Karaoke, Spa, Retail. Shared screens: Operations (ClockInOut, ShiftManagement, CashDrawer, PendingOrders, QuickSale), Payment, Dialogs.