76 lines
2.4 KiB
Markdown
76 lines
2.4 KiB
Markdown
---
|
|
type: project
|
|
status: active
|
|
source: git.alwisp.com
|
|
repo: jason/breedr
|
|
repo_url: https://git.alwisp.com/jason/breedr
|
|
language: JavaScript
|
|
branch: main
|
|
tags: [repo, jason]
|
|
updated: 2026-05-29
|
|
---
|
|
|
|
# breedr
|
|
|
|
**Repository:** [jason/breedr](https://git.alwisp.com/jason/breedr) · branch `main` · JavaScript
|
|
|
|
## Summary
|
|
|
|
Reactive dog breeding genealogy management system — pedigree mapping, litter records, and ancestor/descendant views in a single Docker container
|
|
|
|
## Current status
|
|
|
|
Active. Synced from Gitea on 2026-05-29.
|
|
|
|
## Documentation overview
|
|
|
|
# BREEDR - Dog Breeding Genealogy Management System
|
|
|
|
A reactive, interactive dog breeding genealogy mapping system for professional kennel management.
|
|
|
|
---
|
|
|
|
## 🌟 Recent Highlights (v0.8.0)
|
|
- **✅ Reverse Pedigree** — Toggle between ancestors and descendants view for full lineage tracking.
|
|
- **✅ External Dog Mapping** — Assign parents to external dogs, allowing for full genealogy of outside lines.
|
|
- **✅ Universal Parent Selection** — Select any dog (kennel or external) as a sire/dam from any profile.
|
|
|
|
---
|
|
|
|
## 🚀 Quick Start
|
|
|
|
### 1. Docker Deployment (Recommended)
|
|
```bash
|
|
git clone https://git.alwisp.com/jason/breedr.git
|
|
cd breedr
|
|
docker-compose up -d --build
|
|
```
|
|
Access at: `http://localhost:3000`
|
|
|
|
### 2. Manual Development Setup
|
|
```bash
|
|
npm install
|
|
npm run dev
|
|
```
|
|
> **Note:** The database initializes automatically on first boot. No manual migrations are required.
|
|
|
|
---
|
|
|
|
## 🐕 Managing Your Kennel
|
|
|
|
- **Adding Dogs**: Go to the **Dogs** page, click **Add New Dog**. You can mark dogs as **External** if they aren't in your kennel but are needed for pedigree mapping.
|
|
- **Champion Tracking**: Toggle the **Champion** status to title dogs. Offspring will automatically display the "Champion Bloodline" badge.
|
|
- **Photo Management**: Multiple high-quality photos per dog with a compact gallery view.
|
|
- **Litter Tracking**: Link puppies to breeding records automatically to track weight and health from birth.
|
|
|
|
## 🧬 Breeding & Genetics
|
|
|
|
- **Interactive Pedigree**: 5-generation trees with zoom/pan. Toggle the **Reverse Pedigree** switch to see descendant lineage.
|
|
- **Trial Pairing Simulator**: Calculate Wright's Inbreeding Coefficient (COI) instantly. Identifies common ancestors and providing risk badges (Low/Moderate/High).
|
|
|
|
…(truncated — see repo)
|
|
|
|
## Notes
|
|
|
|
- Project file auto-created from repo documentation.
|