Appearance
WattDee Platform Admin & Central Operations Manual
Internal bilingual VitePress documentation, LLM endpoints (/llms.txt, /llms-full.txt), and platform-scoped MCP service for WattDee Platform Administrators (SUPER_ADMIN) and Central Operations (Platform SERVICE).
- Production URL:
https://admin-docs.wattdee.com - Cloudflare Pages Project:
amr-admin-manual([email protected]'s Account, account ID01dc260d162e584b4ed7a7128dcbbdc2) - GitHub Repository:
https://github.com/unwraps/wattdee-admin-docs - Search Indexing: Disabled via
meta[name="robots"]andX-Robots-Tag: noindex, nofollowinpublic/_headers.
Local Development
sh
bun install --frozen-lockfile
bun run dev # VitePress dev server on http://localhost:4174
bun run build # Outputs .vitepress/dist + llms*.txt + mcp-bundle.json
bun test tests # Runs admin manual, policy parity, screenshot, and MCP tests
bun run mcp # Starts stdio admin MCP serverCloudflare Pages Configuration & Deployment
- Production branch:
main - Build command:
bun run build - Build output directory:
.vitepress/dist - Pages Function:
functions/api/mcp.tsservesPOST /api/mcpwith fullplatform(ADMIN33 capabilities,SERVICE9 capabilities) as well asdeveloperandcustomerpolicy visibility. - Custom domain:
admin-docs.wattdee.com(bound under Workers & Pages -> amr-admin-manual -> Custom domains with DNS CNAME pointing toamr-admin-manual.pages.dev).
Direct Upload (Wrangler)
sh
bun run deployAutomated Git Deployment
- GitHub Actions (
.github/workflows/deploy.yml): Automatically runsbun install --frozen-lockfile,bun run build,bun test tests, and publishes toamr-admin-manualon every push tomainonce the repository secretCLOUDFLARE_API_TOKENis configured with Cloudflare Pages: Edit permission for account01dc260d162e584b4ed7a7128dcbbdc2. - Cloudflare Pages Native Git Integration: Connect
unwraps/wattdee-admin-docsin Workers & Pages -> Create application -> Connect to Git (or replace the Direct Upload project with a Git-connected Pages project of the same build settings: production branchmain, build commandbun run build, output.vitepress/dist), and add a Cloudflare Access policy for internal operator emails if restricting access.
Authorization Policy Snapshot
policy/policy.ts is a snapshot of backend-api/src/auth/policy.ts from unwraps/AMR-weblayer (commit 8fedbdc). Verify alignment against an AMR checkout with:
sh
bun run check:policy /path/to/AMR/backend-api/src/auth/policy.tsCopy the updated file into policy/policy.ts, update the guides if needed, rebuild, test, and push to main.
