docs: audit frontend mvp milestone

2026-04-26 18:54:00 +09:00
parent b570c93d94
commit c54da12a4c
2 changed files with 121 additions and 2 deletions
--- a/.planning/v2-FRONTEND-MVP-AUDIT.md
+++ b/.planning/v2-FRONTEND-MVP-AUDIT.md
@@ -0,0 +1,113 @@
+---
+milestone: v2
+name: Frontend MVP
+audited: 2026-04-26
+status: tech_debt
+scores:
+  requirements: 8/8
+  phases: 3/3
+  integration: 4/4
+  flows: 3/3
+gaps:
+  requirements: []
+  integration: []
+  flows: []
+tech_debt:
+  - phase: "007-web-app-shell-diagnostic-start"
+    items:
+      - "UI was initially verified with HTTP/API smoke rather than browser screenshots."
+  - phase: "008-learning-progress-view"
+    items:
+      - "Progress view has no charts or historical readiness timeline."
+  - phase: "009-material-asset-workspace"
+    items:
+      - "Chrome DevTools MCP timed out during local browser screenshot attempt."
+      - "Material and asset workspace is still prompt-only and has no real image generation."
+nyquist:
+  compliant_phases: []
+  partial_phases: []
+  missing_phases:
+    - "007-web-app-shell-diagnostic-start"
+    - "008-learning-progress-view"
+    - "009-material-asset-workspace"
+  overall: missing
+---
+
+# v2 Frontend MVP Audit
+
+## Verdict
+
+TECH_DEBT
+
+All v2 Frontend MVP requirements are satisfied. The Go service now serves a
+working browser UI for diagnostic practice, progress review, material
+ingestion, ontology inspection, and teaching asset prompt generation.
+
+The milestone remains `tech_debt` rather than `passed` because visual browser
+screenshot validation could not be completed: Chrome DevTools MCP timed out
+while opening the local page. HTTP/API smoke, static asset inspection, Go tests,
+and OpenSpec validation all passed.
+
+## Requirements Coverage
+
+| Requirement | Status | Evidence |
+|-------------|--------|----------|
+| WEB-01 | Satisfied | Web app served at `/`. |
+| WEB-02 | Satisfied | Diagnostic session creation wired from app script to API. |
+| WEB-03 | Satisfied | Answer submission and rubric feedback rendering implemented. |
+| WEB-04 | Satisfied | Learner memory, readiness, and next challenge APIs wired and rendered. |
+| WEB-05 | Satisfied | Material ingestion UI calls `POST /api/v1/materials`. |
+| WEB-06 | Satisfied | Ontology concept, edge, and gap summary rendering implemented. |
+| WEB-07 | Satisfied | Teaching asset prompt generation UI implemented. |
+| WEB-08 | Satisfied | Loading, empty, and error states exist across MVP flows. |
+
+Total: 8/8 v2 requirements satisfied.
+
+## Cross-Phase Integration
+
+| Integration | Result |
+|-------------|--------|
+| Go backend static serving to web app | PASS |
+| Diagnostic UI to backend diagnostic APIs | PASS |
+| Answer grading to learner progress UI | PASS |
+| Material ingestion to ontology to teaching asset prompt UI | PASS |
+
+## E2E Smoke Evidence
+
+```json
+{
+  "HtmlStatus": 200,
+  "HtmlHasWorkspace": true,
+  "JsHasAllApis": true,
+  "SessionID": "diag-1",
+  "Readiness": 75,
+  "OntologyConcepts": 4,
+  "AssetPromptID": "asset-prompt-1",
+  "VerifyGuard": true
+}
+```
+
+## Validation Evidence
+
+- `go test ./...` passed.
+- `openspec validate frontend-mvp --strict` passed.
+- `openspec validate bootstrap-job-tutor-platform --strict` passed.
+- Source line-count check passed.
+
+## Recommended Next Milestone
+
+Recommended next milestone: Persistence and Runtime Hardening.
+
+Rationale:
+
+- The browser MVP now proves the user journey.
+- The biggest product risk is data loss from in-memory stores.
+- Real `third-one` / internalized `agent-farm-go` runtime integration should be
+  added after durable state boundaries are in place.
+
+Candidate phases:
+
+1. Durable persistence for sessions, learner memory, ontology, and asset
+   prompts.
+2. Runtime configuration and workflow package execution.
+3. Browser visual regression and UI hardening.