88 lines
2.7 KiB
Markdown
88 lines
2.7 KiB
Markdown
# Minerva Dashboard
|
|
|
|
Private-first household and personal-assistant dashboard for Manndra, with a Ravenclaw common-room feel and phone-first layout.
|
|
|
|
## Purpose
|
|
|
|
Minerva Dashboard is meant to be a calm, useful front page for Manndra's household flow. V1 keeps the data model simple and JSON-backed so the first live slice can be exercised quickly before deeper integrations arrive.
|
|
|
|
The first pass focuses on:
|
|
|
|
- agenda and reminders
|
|
- household lists
|
|
- quick notes
|
|
- useful links
|
|
- meal ideas and shortcuts
|
|
- Minerva quick actions for fast capture from a phone
|
|
|
|
## Runtime shape
|
|
|
|
- **Repo source:** `home/minerva-dashboard`
|
|
- **Expected live PD runtime:** `/mnt/docker-ssd/docker/compose/minerva-dashboard`
|
|
- **Expected first exposure:** private-first on PD unless later changed
|
|
- **Published app port:** `8094`
|
|
|
|
Do not run production from an agent workspace.
|
|
|
|
## V1 defaults
|
|
|
|
Unless John or Manndra changes direction later, V1 assumes:
|
|
|
|
- Manndra is the primary active user
|
|
- mobile-friendly first, desktop-usable second
|
|
- elegant Ravenclaw/common-room styling instead of playful novelty clutter
|
|
- JSON-backed state first for speed and easy inspection
|
|
- practical household wording over infra/operator language
|
|
- no live deploy in this scaffold task
|
|
|
|
## Current scaffold
|
|
|
|
The scaffold already provides:
|
|
|
|
- seeded Manndra profile and dashboard copy
|
|
- seeded agenda, reminders, lists, notes, links, meal ideas, shortcuts, and quick actions
|
|
- server-rendered homepage for phone use
|
|
- real themed graphics in visible UI locations (library hero, owl medallion, blue-interior art, Art Nouveau ornament)
|
|
- provenance notes for vendored imagery in `docs/ASSET_SOURCES.md`
|
|
- API endpoints for health, summary, and quick note capture
|
|
- form-based quick note capture from the dashboard
|
|
- Docker, compose, env example, local run helper, and pytest coverage for initial flows
|
|
|
|
## Current API surface
|
|
|
|
- `GET /api/health`
|
|
- `GET /api/dashboard/summary`
|
|
- `POST /api/notes/quick-add`
|
|
- `POST /quick-actions/notes`
|
|
|
|
## Local run
|
|
|
|
```bash
|
|
cd /home/fizzlepoof/repos/truenas-stacks/home/minerva-dashboard
|
|
python3 -m venv .venv
|
|
. .venv/bin/activate
|
|
pip install -r requirements.txt
|
|
uvicorn app.main:app --reload --port 8094
|
|
```
|
|
|
|
Or:
|
|
|
|
```bash
|
|
cd /home/fizzlepoof/repos/truenas-stacks/home/minerva-dashboard
|
|
bin/run-local.sh
|
|
```
|
|
|
|
## Verification targets
|
|
|
|
```bash
|
|
curl -fsS http://127.0.0.1:8094/api/health
|
|
curl -fsS http://127.0.0.1:8094/api/dashboard/summary
|
|
curl -fsS http://127.0.0.1:8094/ | grep 'Minerva Dashboard'
|
|
```
|
|
|
|
## Assumptions captured in scaffold
|
|
|
|
- Manndra is the first and primary user for this app
|
|
- agenda/reminders are seeded locally until a calendar or Donetick-style integration is chosen
|
|
- the quick-add mutation writes notes first because quick capture from a phone is a strong default for this product shape
|