Skip to content

docs(phase-13): admin web UI design (slice 0)#58

Open
BangRocket wants to merge 1 commit into
mainfrom
phase-13-slice-0-design
Open

docs(phase-13): admin web UI design (slice 0)#58
BangRocket wants to merge 1 commit into
mainfrom
phase-13-slice-0-design

Conversation

@BangRocket
Copy link
Copy Markdown
Owner

Summary

Phase 13 design doc — no code, awaiting Joshua sign-off before 13.1 (scaffold + first screens) starts. Same pattern as phase 12 (slice 0 = design only).

The doc covers:

  • Stack (§2): Vite + React + TypeScript + Tailwind + TanStack Query + shadcn/ui. Alternatives (HTMX, Astro, plain JS, separate repo) considered and rejected with reasons.
  • Location (§3): `apps/admin-ui/` sibling to `mypalace_client/`.
  • Auth (§4): `sessionStorage` + existing `X-Palace-Key` header. No new endpoints, no cookies, no CSRF surface.
  • CORS (§5): UI served from same origin under `/admin/*` via FastAPI `StaticFiles`. CORS doesn't apply.
  • Build + deploy (§6): multi-stage Dockerfile; UI ships inside the server image. Single tag, single artifact.
  • v1 surface (§1): tenants + keys + stats + audit + memories (read-only) + health. Personality + entity-alias screens deferred.
  • Test strategy (§7): Vitest + React Testing Library + Playwright smoke E2E.

Decision needed

§9 lists seven checkboxes Joshua needs to ratify (or push back on) before 13.1 work starts.

Test plan

  • No code changes; nothing to test
  • Document checked into `docs/admin-ui-design.md`

🤖 Generated with Claude Code

Scopes the browser-based operator console. No code yet — covers stack
choice (Vite + React + TS + Tailwind + TanStack Query + shadcn/ui),
repo location (apps/admin-ui/), auth flow (sessionStorage +
X-Palace-Key header, no new endpoints), CORS (same-origin static
mount under /admin/*), build + deploy (multi-stage Docker, single
image), and the v1 surface (tenants + keys + stats + audit +
memories read-only + health).

§9 lists seven decisions Joshua needs to ratify before 13.1 starts.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant