breedr/ROADMAP.md

# BREEDR Development Roadmap (v0.8.0)

## 🚀 Current Status: v0.8.0 (Active Development)

### 🔜 Next Up — Phase 4b: Health & Genetics Build Order
> **Context:** Golden Retriever health clearances follow GRCA Code of Ethics and OFA/CHIC standards.

#### Step 1: DB Schema Extensions
- [ ] Extend `health_records` table with OFA-specific columns (test_type, result, ofa_number, chic_number, expires_at, document_url)
- [ ] Create `genetic_tests` table (PRA, ICH, NCL, DM, MD, GR-PRA variants)
- [ ] Create `cancer_history` table
- [ ] Add `chic_number`, `age_at_death`, `cause_of_death` to `dogs` table
- [ ] All changes via safe ALTER TABLE / CREATE TABLE IF NOT EXISTS guards

#### Step 2: API Layer
- [ ] `GET|POST|PUT|DELETE /api/health/:dogId` (OFA records)
- [ ] `GET /api/health/:dogId/clearance-summary`
- [ ] `GET /api/health/:dogId/chic-eligible`
- [ ] `GET|POST|PUT|DELETE /api/genetics/:dogId`
- [ ] `GET /api/genetics/pairing-risk` (sire + dam carrier check)
- [ ] Cancer history endpoints

#### Step 3: Core UI — Health Records
- [ ] `HealthRecordForm` modal (test type, result, OFA#, expiry, doc upload)
- [ ] `HealthTimeline` on DogDetail page
- [ ] `ClearanceSummaryCard` 2×2 grid (Hip / Elbow / Heart / Eyes)
- [ ] `ChicStatusBadge` on dog cards
- [ ] Expiry alert badges (90-day warning, expired)

#### Step 4: Core UI — Genetics Panel
- [ ] `GeneticTestForm` modal
- [ ] `GeneticPanelCard` on DogDetail (color-coded markers)
- [ ] Pairing risk overlay on Trial Pairing Simulator

#### Step 5: Eligibility Checker
- [ ] Eligibility logic (`grca_eligible`, `chic_eligible` computed fields)
- [ ] Eligibility badge on dog cards
- [ ] Pre-litter eligibility warning modal

---

## 🕒 Version History & Recent Progress

- **v0.8.0** (March 12, 2026) - Reverse Pedigree & External Parentage (LATEST)
  - [x] **Reverse Pedigree** (descendants view) toggle on Pedigree page
  - [x] **External dog parentage** improvements (allowed assigning sire/dam to external dogs)
  - [x] **Universal parent selection** (sire/dam dropdowns now include all dogs)
  - [x] Updated documentation and roadmap

- **v0.7.0** (In Progress) - Phase 4b: Health & Genetics
  - OFA clearance tracking (Hip, Elbow, Heart, Eyes + CHIC number)
  - DNA genetic panel (PRA, ICH, NCL, DM, MD variants)
  - Cancer lineage & longevity tracking
  - Breeding eligibility checker (GRCA + CHIC gates)

- **v0.6.1** (March 10, 2026) - COI Direct-Relation Fix
  - Fixed `calculateCOI` to correctly compute coefficient for parent×offspring pairings (~25%)
  - Removed blanket sire exclusion in ancestor mapping logic

- **v0.6.0** (March 9, 2026) - Champion Bloodline, Settings, Build Fixes
  - `is_champion` flag on dogs table with ALTER TABLE migration guard
  - Champion toggle in DogForm; `✪` suffix in parent dropdowns; offspring badge
  - Kennel settings table + `GET/PUT /api/settings` + `SettingsProvider`
  - `useSettings.jsx` rename (Vite build fix)
  - `server/index.js` fix: `initDatabase()` no-arg, duplicate health route removed
  - `server/routes/settings.js` rewrite: double-encoded base64 fixed

- **v0.5.1** (March 9, 2026) - Projected Whelping Calendar
  - Indigo whelp window cells (days 58–65) on month grid
  - `Baby` icon + "[Name] due" label in whelp day cells
  - Live whelp preview in Cycle Detail modal

- **v0.5.0** (March 9, 2026) - Breeding Tools
  - Trial Pairing Simulator: COI calculator, risk badge, common ancestors
  - Heat Cycle Calendar: month grid, phase color coding, suggestions

---

## 📋 Future Roadmap

### ✅ Phase 5: Advanced Features (IN PROGRESS)
- [x] Reverse pedigree (descendants view)
- [ ] PDF pedigree generation
- [ ] Export to standard formats (CSV, JSON)
- [ ] Print-friendly layouts
- [ ] Multi-generation COI analysis

### 📅 Phase 6: Polish & Optimization
- [ ] **User Experience**: Loading states, better error messages, undo functionality
- [ ] **Performance**: Image optimization, lazy loading, API caching
- [ ] **Mobile**: Touch-friendly interface, mobile photo capture
- [ ] **Documentation**: API technical docs, video tutorials

---

## ✅ Completed Milestones

### Phase 1: Foundation
- [x] Docker multi-stage build & SQLite database
- [x] Express.js API server & React 18 frontend
- [x] Parents relationship table for sire/dam tracking

### Phase 2: Core Functionality
- [x] Dog Management (Full CRUD, photo uploads)
- [x] Modern dark theme with glass morphism
- [x] Branded navigation with custom logo

### Phase 3: Breeding Tools
- [x] Interactive pedigree tree visualization (React-D3-Tree)
- [x] Litter Management & linking puppies
- [x] Trial Pairing Simulator & Heat Cycle Calendar
- [x] Projected Whelping identifiers

### Phase 4a: Champion & Settings
- [x] Champion bloodline tracking and badges
- [x] Universal Kennel Settings system

---

## 🏃 Testing & Quality Assurance
- [x] Database schema initialization guards
- [x] Pedigree tree rendering & zoom/pan
- [x] Parent relationship creation logic
- [x] Static asset serving (prod/dev)
- [ ] Champion toggle load/save trip
- [ ] Heat cycle calendar whelping logic
- [ ] Health records OFA clearance CRUD (Upcoming)

---

## How to Contribute
1. Pick a feature from "Next Up" above
2. Create a feature branch off `master`: `feat/feature-name`
3. Implement with tests and update this roadmap
4. Submit PR for review

---
*Last Updated: March 12, 2026*