BREEDR - Dog Breeding Genealogy Management System

A reactive, interactive dog breeding genealogy mapping system for professional kennel management.

Features

• Interactive Pedigree Visualization - Multi-generational family trees with zoom/pan
• Health & Genetics Tracking - Comprehensive health records and genetic trait mapping
• Breeding Management - Heat cycles, pairing analysis, and litter tracking
• Inbreeding Coefficient Calculator - COI analysis for responsible breeding decisions
• Trial Pairing Simulator - Preview offspring genetics before breeding
• Document Management - Digital storage for certificates, contracts, and records

Technology Stack

• Frontend: React 18 with TypeScript
• Visualization: React-D3-Tree for pedigree charts
• Backend: Node.js/Express API
• Database: SQLite (embedded, zero-config)
• Container: Single Docker image with multi-stage build

Installation (Unraid)

Build the Docker Image

1. Clone the repository:

cd /mnt/user/appdata/breedr-build
git clone https://git.alwisp.com/jason/breedr.git .

2. Build the Docker image:

docker build -t breedr:latest .

Deploy in Unraid

1. Go to Docker tab in Unraid UI
2. Click Add Container
3. Configure:
   • Name: Breedr
   • Repository: breedr:latest
   • Network Type: Bridge
   • Port: 3000 → 3000 (or your preferred port)
   • Path 1: /mnt/user/appdata/breedr → /app/data (for database)
   • Path 2: /mnt/user/appdata/breedr/uploads → /app/uploads (for photos/documents)
4. Click Apply

Access the Application

Navigate to: http://[UNRAID-IP]:3000

Development

Local Development Setup

# Install dependencies
npm install

# Run development server (frontend + backend)
npm run dev

# Build for production
npm run build

Project Structure

breedr/
├── client/           # React frontend
│   ├── src/
│   ├── public/
│   └── package.json
├── server/           # Node.js backend
│   ├── routes/
│   ├── models/
│   ├── db/
│   └── index.js
├── Dockerfile        # Multi-stage Docker build
├── docker-compose.yml
├── package.json
└── README.md

Environment Variables

• NODE_ENV - production/development (default: production)
• PORT - Server port (default: 3000)
• DB_PATH - SQLite database path (default: /app/data/breedr.db)
• UPLOAD_PATH - Upload directory (default: /app/uploads)

Database Schema

SQLite database automatically initializes on first run with tables:

• dogs - Core dog registry
• parents - Parent-child relationships
• litters - Breeding records
• health_records - Medical and genetic testing
• heat_cycles - Breeding cycle tracking
• traits - Genetic trait mapping

Roadmap

✅ Phase 1: Foundation (Current)

• Project structure
• Docker containerization
• Database schema
• Basic API endpoints

🚧 Phase 2: Core Features

• Dog profile management (CRUD)
• Interactive pedigree visualization
• Parent-child relationship mapping
• Basic photo uploads

📋 Phase 3: Breeding Tools

• Inbreeding coefficient calculator
• Trial pairing simulator
• Heat cycle tracking
• Litter management

📋 Phase 4: Health & Genetics

• Health record management
• Genetic trait tracking
• Document storage

📋 Phase 5: Advanced Features

• PDF pedigree generation
• Reverse pedigree (descendants)
• Advanced search and filters
• Export capabilities

License

Private use only - All rights reserved

Support

For issues or questions, contact the system administrator.