# QC Text Builder (Go)

Milestone 2 status:
- bootstrap app/server/config
- Quick Creator client contracts (Bearer token only)
- AI template sync endpoint
- onboarding/discovery endpoint with local manifest flattening
- site build flow via `POST /sites` using local manifest + own text (`content.aiData`)
- SQLite persistence (default) for settings, templates, manifests, fields, site builds, and build drafts
- build polling (`POST /api/site-builds/{id}/poll`) and background polling supervisor
- draft intake/review flow (`draft -> reviewed -> submitted`) before final build
- strict MVP scope: no ACP login flow, no DCM/EFL, no image payload handling

## Run

1. Set env vars:
   - `HTTP_ADDR=:8080`
   - `DB_DRIVER=sqlite` (default)
   - `DB_URL=data/qctextbuilder.db` (default, local file)
   - `QC_BASE_URL=https://qc-api.yggdrasil.dev-mono.net/api/v1`
   - `QC_TOKEN=<your bearer token>`
2. Start:
   - `go run ./cmd/qctextbuilder`

## API (Milestone 3)

- `GET /healthz`
- `POST /api/templates/sync`
- `GET /api/templates`
- `GET /api/templates/{id}`
- `POST /api/templates/{id}/onboard`
- `PUT /api/templates/{id}/fields`
- `POST /api/drafts/intake` (external prefilled draft intake)
- `GET /api/drafts`
- `GET /api/drafts/{id}`
- `PUT /api/drafts/{id}`
- `POST /api/site-builds`
- `GET /api/site-builds/{id}`
- `POST /api/site-builds/{id}/poll`
- `POST /api/site-builds/{id}/fetch-editor-url`

Draft payload (`POST /api/drafts/intake` / `PUT /api/drafts/{id}`) supports:
- `templateId`, optional `manifestId`
- `source`, `requestName`
- `globalData` (same documented QC fields as build flow)
- `fieldValues` keyed by manifest path (`section.keyName`)
- `status` (`draft|reviewed|submitted`), `notes`

Build request payload (`POST /api/site-builds`) expects:
- `templateId` (AI template only, onboarded/reviewed)
- `requestName`
- `globalData` (`companyName`, `email`, `username` required; all other documented fields optional)
- `fieldValues` keyed by manifest paths (`section.keyName`)

Documented `globalData` scope supported by UI/API mapping:
- `companyName`, `businessType`, `username`, `email`, `phone`
- `orgNumber`, `startDate`, `mission`, `descriptionShort`, `descriptionLong`, `siteLanguage`
- `address.line1`, `address.line2`, `address.city`, `address.region`, `address.zip`, `address.country`

UI note:
- `/builds/new` now supports loading an existing draft, reviewing/editing values, saving draft, and only then starting the build.
- Template fields in `/builds/new` are grouped block-first by extracted internal block IDs (for example `m1710`, `c7886`, `r4830`) with heuristic fallback for fields without block IDs.
- Template field settings in `/templates/{id}` include a persistent `websiteSection` mapping (`hero`, `intro`, `services`, `service_item`, `about`, `team`, `testimonials`, `cta`, `contact`, `footer`, `gallery`, `other`) used by `/builds/new` grouping with fallback when not set.