From 8a1e5eafadc315ee9432f64d24cb5339df9c368d Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 26 Feb 2026 15:50:38 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20update=20AGENTS.md=20=E2=80=94=20remove?= =?UTF-8?q?=20stale=20Blazor=20build=20error=20note,=20fix=20port?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Velik --- AGENTS.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index fad0e7d8..33c824e1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -34,6 +34,5 @@ Standard commands are documented in `README.md` and `package.json` scripts. Quic - **Backend services (.NET)**: All services under `services/*-net/` require .NET 10 SDK, Neon PostgreSQL, and Redis. They are not runnable in the default cloud environment without those dependencies. - **web-client dev server**: Runs on port 3000 by default via `next dev`. - **.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 `"` 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 TPOS dev server**: `dotnet run --project src/WebClientTpos.Server` from `apps/web-client-tpos-net/` serves on port 5092 by default. Build with `dotnet build` from the same directory. Smoke tests: `dotnet test tests/WebClientTpos.SmokeTests/`. - **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.