complete codex docs

docs/modules/dashboard.md

@@ -0,0 +1,53 @@
+# Dashboard
+
+## Purpose
+
+Main landing dashboard with widgets and quick server overview.
+
+## Current Status
+
+- Functional
+
+## Dependencies
+
+- Panel dashboard widgets
+- user permissions
+
+## Database Tables
+
+- `widgets`
+- `widgets_users`
+
+## Agent Interaction
+
+- indirect through monitor widgets and server summaries
+
+## User Workflow
+
+- view server summary widgets
+- access quick links
+
+## Admin Workflow
+
+- manage dashboard widgets and layout
+
+## Security Concerns
+
+- widget visibility should respect permissions
+
+## Known Issues
+
+- some default widgets are legacy
+
+## Missing Functionality
+
+- richer status and alert surfaces
+
+## Suggested Future Improvements
+
+- surface lifecycle state, support, billing, and docs more prominently
+
+## Recommendation
+
+- Keep / Improve
+