docs(08): capture phase context
Phase 08: Admin Dashboard - Implementation decisions documented - Phase boundary established
This commit is contained in:
66
.planning/phases/08-admin-dashboard/08-CONTEXT.md
Normal file
66
.planning/phases/08-admin-dashboard/08-CONTEXT.md
Normal file
@@ -0,0 +1,66 @@
|
|||||||
|
# Phase 8: Admin Dashboard - Context
|
||||||
|
|
||||||
|
**Gathered:** 2026-02-04
|
||||||
|
**Status:** Ready for planning
|
||||||
|
|
||||||
|
<domain>
|
||||||
|
## Phase Boundary
|
||||||
|
|
||||||
|
Provide customizable dashboard after login and plugin settings interface. Dashboard displays widgets from plugins. Plugins can register settings pages accessible from admin menu. Settings use the same YAML-driven form system from Phase 7.
|
||||||
|
|
||||||
|
</domain>
|
||||||
|
|
||||||
|
<decisions>
|
||||||
|
## Implementation Decisions
|
||||||
|
|
||||||
|
### Dashboard Layout
|
||||||
|
- Masonry/fluid layout — widgets flow and stack based on their size
|
||||||
|
- Drag-and-drop customization — admins can reorder, resize, show/hide widgets
|
||||||
|
- Per-user layout preferences — each admin has their own dashboard arrangement
|
||||||
|
- Reset to default option — admins can restore plugin-provided default layout
|
||||||
|
|
||||||
|
### Widget System
|
||||||
|
- Widget types: stats/charts, lists/tables, and quick actions — all supported
|
||||||
|
- Sizing: plugin-defined defaults with admin customization
|
||||||
|
- Real-time updates via WebSocket/SSE — widgets receive push updates for live data
|
||||||
|
- Widget configuration — widgets can have their own settings (e.g., item count, date range)
|
||||||
|
|
||||||
|
### Settings Pages
|
||||||
|
- WinterCMS pattern: plugins define top-level menus for model CRUDs and custom views
|
||||||
|
- Central Settings area where plugins register their settings
|
||||||
|
- Grouped by category (System, Content, Users, etc.)
|
||||||
|
- Plugins can register new categories beyond core defaults
|
||||||
|
|
||||||
|
### Empty/Loading States
|
||||||
|
- Fresh install: default system widgets pre-populated (recent activity, quick links)
|
||||||
|
- Loading: skeleton screens matching content layout
|
||||||
|
- Empty widget: friendly message explaining why empty and what to do
|
||||||
|
- Error state: inline error within widget with retry option
|
||||||
|
|
||||||
|
### Claude's Discretion
|
||||||
|
- Save behavior for settings forms (HTMX vs full page based on patterns)
|
||||||
|
- Default widget arrangement on fresh install
|
||||||
|
- Exact skeleton screen designs
|
||||||
|
- Category ordering in settings
|
||||||
|
|
||||||
|
</decisions>
|
||||||
|
|
||||||
|
<specifics>
|
||||||
|
## Specific Ideas
|
||||||
|
|
||||||
|
- "Like in WinterCMS" — follow WinterCMS patterns where plugins have their own top-level menus for CRUDs but settings centralized
|
||||||
|
- Real-time widget updates prioritized over polling
|
||||||
|
|
||||||
|
</specifics>
|
||||||
|
|
||||||
|
<deferred>
|
||||||
|
## Deferred Ideas
|
||||||
|
|
||||||
|
None — discussion stayed within phase scope
|
||||||
|
|
||||||
|
</deferred>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Phase: 08-admin-dashboard*
|
||||||
|
*Context gathered: 2026-02-04*
|
||||||
Reference in New Issue
Block a user