docs/dev/pots_workspace_phase6_progress_model.md

POTS Workspace Phase 6 - Intake Progress Model

Goal

Track answer-state progress across intake questions and compute completion by section and overall.

Data Model

• Question status enum:
  • answered
  • unknown
  • deferred
  • needs_owner
• Payload model:
  • questions[] with question_id, section_id, status
• Persisted project fields:
  • progress_questions
  • progress_summary.sections
  • progress_summary.overall

API

• POST /api/pots_workspace/projects/{project_id}/progress
  • accepts progress payload.
  • computes section and overall completion percentages.
  • sets lifecycle from draft -> discovery when progress entries are first added.

Completion Formula

• completion_pct = answered / total * 100
• Calculated per section and overall.

Verification

• python3 -m pytest -q backend/app/test_pots_workspace_api.py
  • includes progress-summary regression test.