ssr-admin

name	ssr-admin
description	Work on Madoc TS admin SSR pipeline, HTML template injection, and admin render routing. Use when changing admin SSR behavior, template tokens, or admin SSR data wiring in services/madoc-ts.

Admin SSR (Madoc TS)

Goal

Document the admin SSR flow so template injection and admin render output remain consistent.

Scope

• Admin SSR route handler
• Admin template token injection
• Admin SSR data wiring (user, plugins, locales)

Non-scope

• Site SSR flow
• Frontend component implementation
• Non-SSR admin routes

Key Entry Points

• services/madoc-ts/src/routes/frontend/admin-frontend.ts
• services/madoc-ts/src/frontend/admin/server.tsx
• services/madoc-ts/src/admin.html

Architecture Summary (Based on Source)

• admin-frontend.ts enforces site.admin scope and redirects to site root when missing.
• SSR uses frontend/admin/server to render and injects <!--ssr-outlet--> and <!--ssr-head--> tokens.
• Development SSR uses Vite dev server and React refresh; production uses admin.html template replacement.

Quick Start Workflow

1. Review services/madoc-ts/src/routes/frontend/admin-frontend.ts for SSR request handling and auth checks.
2. Inspect services/madoc-ts/src/frontend/admin/server.tsx for render inputs and output shape.
3. Confirm services/madoc-ts/src/admin.html token locations for SSR injection.

Common Tasks

• Add new data passed into admin SSR render
• Update admin HTML template tokens
• Adjust auth/redirect behavior for admin SSR

Pitfalls

• Mismatched template tokens causing blank SSR output
• Missing scope checks and leaking admin content
• Updating dev SSR scripts without matching Vite port

Suggested Checks

• Admin SSR request in production mode
• Admin SSR request with missing site.admin scope