# Reanimator Development Milestones

This file is the single source of truth for delivery progress and AI task delegation.

Status legend: `[ ] todo` `[-] in progress` `[x] done` `[!] blocked`

## MVP-1 Scope (Agreed)

### In Scope

- Registry: `customer/project/asset/component/internal_pn (LOT)`
- Ingest `logbundle` -> parse `first_seen` + installation relationships
- Timeline events: `LOG_COLLECTED`, `INSTALLED`, `REMOVED`, `FIRMWARE_CHANGED`
- UI: server card + current components + movement list
- Basic tickets import + link to server (`asset`)

### Out of Scope (After MVP-1)

- AFR/MTBF production analytics
- Spare-parts forecasting (ZIP)
- Advanced ticket/component time-window inheritance
- Predictive models and anomaly detection

---

## Milestone 0 - Bootstrap Foundation

**Goal:** ready-to-build Go service skeleton and migration scaffolding.

- [x] Initialize Go module (`go mod init`)
- [x] Create base folders (`cmd`, `internal/*`, `migrations`)
- [x] Add API entrypoint and `/health` endpoint
- [x] Add env-based config loader
- [x] Add migration loader command (`cmd/reanimator-migrate`)
- [x] Add Make targets (`build`, `test`, `run`, `migrate-up`, `migrate-down`)
- [x] Verify `go build ./...` passes

**Current state:** completed.

**AI task prompt:**
> Milestone 0 is done. Do not change bootstrap unless required by later milestones.

---

## Milestone 1 - Registry (MVP-1)

**Goal:** implement registry domain and CRUD API.

- [ ] SQL migrations: `customers`, `projects`, `locations`
- [ ] SQL migrations: `assets`, `components`, `lots`, `installations`
- [ ] Add indexes from README
- [ ] Repositories for registry entities
- [ ] API endpoints for create/list/get (`customers`, `projects`, `assets`, `components`)
- [ ] Basic validation and error mapping

**Definition of done:**
- migrations apply cleanly on MariaDB
- registry API works end-to-end

**AI task prompt:**
> Implement Milestone 1 from TODO.md. Focus on clean schema and working CRUD endpoints for registry entities. Update checkbox statuses in TODO.md.

---

## Milestone 2 - Ingest First Seen + Installations (MVP-1)

**Goal:** idempotent logbundle ingestion with first useful derived data.

- [ ] SQL migrations: `log_bundles`, `observations`
- [ ] `POST /ingest/logbundle` idempotent by content hash
- [ ] Persist raw bundle metadata + parsed observations
- [ ] Detect and persist `first_seen` for components
- [ ] Detect and persist installation relationships from observations

**Definition of done:**
- duplicate bundle upload does not duplicate state
- first_seen and installation data are queryable

**AI task prompt:**
> Implement Milestone 2 from TODO.md with strict idempotency and first_seen/installation extraction. Add integration test for duplicate uploads.

---

## Milestone 3 - Timeline v1 (MVP-1)

**Goal:** produce event history visible in API and ready for UI.

- [ ] SQL migration: `timeline_events`
- [ ] Event derivation from observations/installation deltas
- [ ] Emit: `LOG_COLLECTED`, `INSTALLED`, `REMOVED`, `FIRMWARE_CHANGED`
- [ ] API: `GET /assets/{id}/timeline`
- [ ] API: `GET /components/{id}/timeline`
- [ ] Deterministic sorting + pagination

**Definition of done:**
- timeline endpoints return stable chronological event history
- install/remove/firmware changes appear correctly

**AI task prompt:**
> Implement Milestone 3 from TODO.md. Build deterministic timeline generation and API pagination. Add tests for installed/removed/firmware-changed cases.

---

## Milestone 4 - UI v1 + Ticket Import (MVP-1)

**Goal:** first visible product value for operations workflow.

- [ ] Minimal UI: server card
- [ ] Minimal UI: current components list
- [ ] Minimal UI: movement/event list from timeline
- [ ] SQL migrations: `tickets`, `ticket_links`
- [ ] Endpoint: `POST /connectors/tickets/sync`
- [ ] Link ticket to server (`asset`)

**Definition of done:**
- operator opens server page and sees current hardware + movement history + linked tickets

**AI task prompt:**
> Implement Milestone 4 from TODO.md with minimal but usable UI and basic ticket sync/linking to assets.

---

## Milestone 5 - Post-MVP Analytics

**Goal:** after MVP-1, add reliability metrics and planning value.

- [ ] Explicit `failure_events` model and ingestion path
- [ ] AFR/MTBF calculations by LOT/component class
- [ ] Firmware risk analytics
- [ ] ZIP forecasting baseline

**Definition of done:**
- metrics are reproducible and usable for operational planning

**AI task prompt:**
> Implement Milestone 5 from TODO.md only after MVP-1 is complete. Prioritize metric correctness and reproducibility.

---

## Cross-Cutting Tasks

- [ ] Structured logs + request IDs
- [ ] OpenAPI spec
- [ ] CI (build/test/migration check)
- [ ] Release note discipline

---

## Progress Snapshot

Update this section after each merged PR.

- Last update: 2026-02-04
- Current milestone: Milestone 1 (Registry)
- MVP-1 progress: 1/5 milestones completed (Milestone 0 done)
- Active blockers: none