breedr/ROADMAP.md

BREEDR Development Roadmap

🚀 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)

  • Reverse Pedigree (descendants view) toggle on Pedigree page
  • External dog parentage improvements (allowed assigning sire/dam to external dogs)
  • Universal parent selection (sire/dam dropdowns now include all dogs)
  • 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)

• 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

• Docker multi-stage build & SQLite database
• Express.js API server & React 18 frontend
• Parents relationship table for sire/dam tracking

Phase 2: Core Functionality

• Dog Management (Full CRUD, photo uploads)
• Modern dark theme with glass morphism
• Branded navigation with custom logo

Phase 3: Breeding Tools

• Interactive pedigree tree visualization (React-D3-Tree)
• Litter Management & linking puppies
• Trial Pairing Simulator & Heat Cycle Calendar
• Projected Whelping identifiers

Phase 4a: Champion & Settings

• Champion bloodline tracking and badges
• Universal Kennel Settings system

---

🏃 Testing & Quality Assurance

• Database schema initialization guards
• Pedigree tree rendering & zoom/pan
• Parent relationship creation logic
• 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