jason/breedr
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e62d35041f0d79d688490644969d0e1a670896e5
breedr/ROADMAP.md

9.2 KiB
Raw Blame History

BREEDR Development Roadmap

✅ Phase 1: Foundation (COMPLETE)

Infrastructure

  • Docker multi-stage build configuration
  • SQLite database with automatic initialization
  • Express.js API server
  • React 18 frontend with Vite
  • Git repository structure

Database Schema

  • Dogs table with core fields
  • Parents relationship table
  • Litters breeding records
  • Health records tracking
  • Heat cycles management
  • Traits genetic mapping
  • Indexes and triggers

API Endpoints

  • /api/dogs - Full CRUD operations
  • /api/pedigree - Tree generation and COI calculator
  • /api/litters - Breeding records
  • /api/health - Health tracking
  • /api/breeding - Heat cycles and whelping calculator
  • Photo upload with Multer

✅ Phase 2: Core Functionality (COMPLETE)

Dog Management

  • Add new dogs with full form
  • Edit existing dogs
  • View dog details
  • List all dogs with search/filter
  • Upload multiple photos per dog
  • Delete photos
  • Parent selection (sire/dam)

User Interface

  • Dashboard with statistics
  • Dog list with grid view
  • Dog detail pages
  • Modal forms for add/edit
  • Photo management UI
  • Search and sex filtering
  • Responsive navigation

Features Implemented

  • Photo upload and storage
  • Parent-child relationships
  • Basic information tracking
  • Registration numbers
  • Microchip tracking

✅ Phase 3: Breeding Tools (COMPLETE)

Priority Features

  • Interactive pedigree tree visualization

    • Integrate React-D3-Tree
    • Show 3-5 generations
    • Click to navigate
    • Zoom and pan controls
    • Beautiful color-coded nodes
    • Male/Female distinction

  • Trial Pairing Simulator

    • Select sire and dam
    • Display COI calculation
    • Show common ancestors
    • Risk assessment display

  • Heat Cycle Management

    • Add/edit heat cycles
    • Track progesterone levels
    • Calendar view
    • Breeding date suggestions

  • Litter Management ✅ NEW

    • Create litter records
    • Link puppies to litter
    • Track whelping details
    • Auto-link parent relationships
    • Database migration for litter_id
    • Enhanced API endpoints
    • Dual parent selection mode (litter/manual)
    • UI fix for proper layout and error handling

📋 Phase 4: Health & Genetics (PLANNED)

Health Records

  • Add health test results
  • Vaccination tracking
  • Medical history timeline
  • Document uploads (PDFs, images)
  • Alert for expiring vaccinations

Genetic Tracking

  • Track inherited traits
  • Color genetics calculator
  • Health clearance status
  • Link traits to ancestors

📋 Phase 5: Advanced Features (PLANNED)

Pedigree Tools

  • Reverse pedigree (descendants view)
  • PDF pedigree generation
  • Export to standard formats
  • Print-friendly layouts
  • Multi-generation COI analysis

Breeding Planning

  • Breeding calendar
  • Heat cycle predictions
  • Expected whelping alerts
  • Breeding history reports

Search & Analytics

  • Advanced search filters
    • By breed, color, age
    • By health clearances
    • By registration status
  • Statistics dashboard
    • Breeding success rates
    • Average litter sizes
    • Popular pairings

📋 Phase 6: Polish & Optimization (PLANNED)

User Experience

  • Loading states for all operations
  • Better error messages
  • Confirmation dialogs
  • Undo functionality
  • Keyboard shortcuts

Performance

  • Image optimization
  • Lazy loading
  • API caching
  • Database query optimization

Mobile

  • Touch-friendly interface
  • Mobile photo capture
  • Responsive tables
  • Offline mode

Documentation

  • User manual
  • API documentation
  • Video tutorials
  • FAQ section

Future Enhancements (BACKLOG)

Multi-User Support

  • User authentication
  • Role-based permissions
  • Activity logs
  • Shared access

Integration

  • Import from other systems
  • Export to Excel/CSV
  • Integration with kennel clubs
  • Backup to cloud storage

Advanced Genetics

  • DNA test result tracking
  • Genetic diversity analysis
  • Breed-specific calculators
  • Health risk predictions

Kennel Management

  • Breeding contracts
  • Buyer tracking
  • Financial records
  • Stud service management

🎉 Latest Release: v0.3.1 - UI Fixes & Error Handling

What's New in This Release

Bug Fixes

  • ✅ Fixed blank screen issue when opening Add Dog modal
  • ✅ Fixed overlapping radio buttons and dropdown in Parent Information section
  • ✅ Added graceful error handling for API failures
  • ✅ Improved layout with proper spacing and visual hierarchy
  • ✅ Fixed typo: useManualParents variable name

UI Improvements

  • ✅ Enhanced parent selection section with subtle indigo background
  • ✅ Properly sized radio buttons (16px) for better clickability
  • ✅ Horizontal radio button layout with proper flex spacing
  • ✅ Checkmark feedback when litter is selected
  • ✅ Conditional rendering based on litters availability
  • ✅ Fallback to manual parent selection when litters API fails

Technical Changes

  • ✅ Added littersAvailable state flag
  • ✅ Wrapped API calls in try-catch blocks with fallbacks
  • ✅ Set empty arrays as defaults to prevent undefined errors
  • ✅ Added name attribute to radio buttons for proper grouping

Migration Instructions (if not already done)

  1. Run database migration:

    docker exec breedr node server/db/migrate_litter_id.js

    OR if running locally:

    node server/db/migrate_litter_id.js

  2. Pull latest changes:

    git pull origin fix/dog-form-litter-ui

  3. Restart the application:

    docker-compose restart

    OR

    npm run dev

Current Sprint Focus

Next Up (Priority)

Option 1: Trial Pairing Simulator (Recommended) 🏆

Complexity: Medium | Impact: High | User Value: Excellent

Why this is recommended:

  • Leverages existing COI calculator backend
  • Provides immediate breeding decision support
  • High value feature for breeders
  • Relatively quick to implement

Tasks:

  • Create PairingSimulator component
  • Add sire/dam selection dropdowns
  • Display COI calculation results
  • Show common ancestors table
  • Add genetic risk assessment
  • Color-coded recommendations (green/yellow/red)

Estimated Time: 4-6 hours

Option 2: Heat Cycle Management

Complexity: Medium-High | Impact: Medium | User Value: Good

Why consider this:

  • Natural extension of litter management
  • Helps with breeding planning
  • Provides calendar functionality

Tasks:

  • Create HeatCycleForm component
  • Add calendar view with heat cycle tracking
  • Track progesterone levels
  • Implement breeding date suggestions
  • Whelping date calculator

Estimated Time: 6-8 hours

Option 3: Enhanced Litter Features

Complexity: Low-Medium | Impact: Medium | User Value: Good

Why consider this:

  • Polish existing litter functionality
  • Improves user workflow
  • Quick wins

Tasks:

  • Puppy batch addition (add multiple puppies at once)
  • Photo gallery per litter
  • Whelping countdown timer
  • Expected vs actual puppy count tracking
  • Litter statistics dashboard

Estimated Time: 3-5 hours

Option 4: Health Records System

Complexity: Medium | Impact: High | User Value: Excellent

Why consider this:

  • Important for breeding decisions
  • Vaccination tracking is valuable
  • Document management adds utility

Tasks:

  • Create HealthRecordForm component
  • Add vaccination tracking with expiry alerts
  • Medical history timeline view
  • PDF/image document uploads
  • Health clearance status badges

Estimated Time: 6-8 hours

Testing Needed

  • Add/edit dog forms with litter selection
  • Database migration execution
  • Pedigree tree rendering
  • Zoom/pan controls
  • UI layout fixes
  • Error handling for API failures
  • Trial pairing simulator
  • Heat cycle tracking
  • Enhanced litter features
  • Health records

Known Issues

  • ✅ Fixed: Blank screen when opening Add Dog modal
  • ✅ Fixed: Overlapping UI elements in parent selection
  • ✅ Fixed: Missing error handling for litters API
  • None currently

How to Contribute

  1. Pick a feature from "Priority Features"
  2. Create a feature branch: feature/feature-name
  3. Implement with tests
  4. Update this roadmap
  5. Submit for review

Version History

  • v0.3.1 (Current - March 9, 2026) - UI Fixes & Error Handling

    • Fixed blank screen issue on Add Dog modal
    • Improved parent selection layout
    • Added comprehensive error handling
    • Enhanced visual design with proper spacing

  • v0.3.0 - Litter Management & Interactive Pedigree

    • Added litter_id to dogs table
    • Implemented LitterForm component
    • Created PedigreeView with React-D3-Tree
    • Enhanced DogForm with dual parent selection
    • Fixed "no such column: sire" error
    • Added comprehensive documentation

  • v0.2.0 - Dog CRUD operations complete

  • v0.1.0 - Initial foundation with API and database

Reference in New Issue View Git Blame Copy Permalink