Technical
Research Home
The command center for a CaveauAI workspace: plan status, document counts, query usage, model routing, and the next best places to continue work.
Public and internal interfaces
These are the main routes, handlers, and integration surfaces used by this product area.
/api/portal/plan
/api/portal/usage
/api/portal/rag/documents
/api/portal/gitea/status
Architecture notes
- The React page is caveauai-web/src/pages/app/Dashboard.tsx.
- Dashboard data is assembled from plan, usage, document list, and Gitea status hooks.
- The page is read-only and session-authenticated through the bnl_session cookie.
Access and permissions
App pages are authenticated through the shared bnl_session cookie unless explicitly marked public. Public docs should describe integration behavior without including secrets, private tokens, private IPs, or tenant-specific records.
Troubleshooting
- Empty counts usually mean no corpus documents are ready or the usage endpoint is still loading.
- If plan information is missing, verify /api/portal/plan and the authenticated session.