Business & Product

Planning documentation for the Your Solar Guy MVP.

Five-Phase MVP Delivery Plan

Delivery model

The MVP is planned as five gated phases. Each phase extends the same private workspace, document, result, and authorization foundations. Work moves forward after the phase checks pass and the owner approves the gate.

Phase 1: Web Upload, Extraction, and Private Workspace

Plan the private workspace, supported upload, optional installation date, native document extraction, deterministic results, read-only presentation, append, delete, retry, and free-tier quota handling.

Outcome: a homeowner can submit a manual and receive private, source-linked maintenance results.

Phase 2: Calendar Export

Use eligible Phase 1 results to create downloadable all-day ICS events with recurrence support and a requested 14-day reminder.

Outcome: supported future actions can move from a timeline into a calendar.

Phase 3: Email Workflow

Add private workspace invitations, inbound attachments, multi-day conversations, missing-information replies, approval-protected calendar delivery, admin alerts, durable workers, and Resend integration.

Outcome: a homeowner can complete the main workflow through an ongoing email conversation.

Phase 4: RAG Q&A

Add lazy indexing across retained workspace documents, workspace-scoped retrieval, document-grounded answers, source citations, index reuse, and deletion invalidation.

Outcome: the private workspace can answer later questions using retained manuals.

Phase 5: QA/QC

Add release gates for extraction, results, email, and calendar artifacts. Support bounded correction and item-level manual review. Per-answer RAG review remains outside this phase.

Outcome: important artifacts receive a consistent quality check before release.

Gate expectations

Each phase requires type checking, linting, automated tests, a release build, relevant local smoke testing, a short phase report, and owner acceptance.

Possible later work includes user correction and recalculation, longer-term identity and retention, direct calendar synchronization, broader manufacturer evaluation, and higher-throughput provider capacity. These items require separate product decisions.