# Mirage Planning App — project notes

## Reference screens (Deltek Vantage Point + current artifacts)
18 full-res (1920×1080) reference screenshots live in `uploads/`, catalogued in
`uploads/INDEX.md` (file → source timestamp → what it shows → which screen it feeds).
Read `uploads/INDEX.md` first, then view only the images relevant to the screen
being designed.

Quick map:
- Schedule / Gantt → `04_schedule-gantt.png`, `05_schedule-gantt-dependencies.png`
- WBS + milestones → `02_choose-project-structure-WBS.png`, `03_edit-project-structure-milestones.png`
- Resource Plan → `07_assign-resources-modal.png`, `08_fill-hours-per-day-dialog.png`, `09_resource-plan-planned-vs-actual.png`, `14_excel_resource-deployment-plan.png`
- Rates / plan settings → `06_plan-settings-rate-tables.png`
- Project Review → `10_project-review-financial-grid.png`, `11_project-review-structure-browser.png`
- Progress / % complete → `13_cost-summary-percent-complete.png`
- Resource utilisation → `12_resource-view-utilisation-heatmap.png`
- Dashboard / cost report → `17_mirage_monthly-cost-report.png`, `18_mirage_cost-report-summary-by-stage.png`
- Estimate + scope context → `15_excel_baseline-precontract-estimate.png`, `16_pdf_project-scope-bradsol-mirage.png`

These are **legacy-system references for content, vocabulary and data density only** —
never for visual style. All visuals follow the Mirage Planning App design system.

## Product context
Mirage replaces Deltek Vantage Point as the planning & resource-management layer for a
Dubai architecture group (~50 desktop power users). Oracle Fusion is the system of
record: it owns WBS, rates, timesheets, actuals. Structure is locked (no add/delete of
stages/disciplines/tasks); plan values are editable, actual values read-only.
Vocabulary: Project → Stage → Discipline → Task → Resource assignment.
Cost categories: Labour, Consultants, Expenses (incl. contingency).

## Build conventions
- Every screen sits inside `MirageDS.AppShell`; design at 1440px desktop.
- Compose from real DS components; never invent generic equivalents.
- Token-backed Tailwind utilities only; `tnum` on numbers; density over whitespace.
- Main file so far: `Mirage App Shell.dc.html`.