docs: update AGENTS.md with Blazor TPOS cloud-specific instructions

Co-authored-by: Velik <hongochai10@users.noreply.github.com>
This commit is contained in:
Cursor Agent
2026-02-26 15:46:36 +00:00
parent 088869f256
commit 706cb07e98

View File

@@ -33,3 +33,6 @@ Standard commands are documented in `README.md` and `package.json` scripts. Quic
- **Pre-existing test failures**: 6 tests in `apps/web-client` fail due to Zustand persist middleware requiring `localStorage` which is not properly mocked in the jsdom test environment. These are pre-existing and not caused by environment setup. The failing stores are `auth-store` and `chat-store`. - **Pre-existing test failures**: 6 tests in `apps/web-client` fail due to Zustand persist middleware requiring `localStorage` which is not properly mocked in the jsdom test environment. These are pre-existing and not caused by environment setup. The failing stores are `auth-store` and `chat-store`.
- **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. - **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`. - **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 `&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).