Add microchip field fix migration notice to README
This commit is contained in:
92
README.md
92
README.md
@@ -2,6 +2,28 @@
|
|||||||
|
|
||||||
A reactive, interactive dog breeding genealogy mapping system for professional kennel management.
|
A reactive, interactive dog breeding genealogy mapping system for professional kennel management.
|
||||||
|
|
||||||
|
## ⚠️ Important: Database Migration Required
|
||||||
|
|
||||||
|
**If you have an existing BREEDR installation**, you must run a migration to fix the microchip field constraint:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Enter the container
|
||||||
|
docker exec -it breedr sh
|
||||||
|
|
||||||
|
# Run migration
|
||||||
|
node server/db/migrate_microchip.js
|
||||||
|
|
||||||
|
# Exit and restart
|
||||||
|
exit
|
||||||
|
docker restart breedr
|
||||||
|
```
|
||||||
|
|
||||||
|
**What this fixes:** The microchip field now allows multiple dogs without microchips (previously caused "UNIQUE constraint failed" errors).
|
||||||
|
|
||||||
|
**See full details:** [docs/MICROCHIP_FIX.md](docs/MICROCHIP_FIX.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
- **Interactive Pedigree Visualization** - Multi-generational family trees with zoom/pan
|
- **Interactive Pedigree Visualization** - Multi-generational family trees with zoom/pan
|
||||||
@@ -10,14 +32,16 @@ A reactive, interactive dog breeding genealogy mapping system for professional k
|
|||||||
- **Inbreeding Coefficient Calculator** - COI analysis for responsible breeding decisions
|
- **Inbreeding Coefficient Calculator** - COI analysis for responsible breeding decisions
|
||||||
- **Trial Pairing Simulator** - Preview offspring genetics before breeding
|
- **Trial Pairing Simulator** - Preview offspring genetics before breeding
|
||||||
- **Document Management** - Digital storage for certificates, contracts, and records
|
- **Document Management** - Digital storage for certificates, contracts, and records
|
||||||
|
- **Modern UI** - Sleek, dark-themed interface with compact info cards
|
||||||
|
|
||||||
## Technology Stack
|
## Technology Stack
|
||||||
|
|
||||||
- **Frontend**: React 18 with TypeScript
|
- **Frontend**: React 18 with modern component design
|
||||||
- **Visualization**: React-D3-Tree for pedigree charts
|
- **Visualization**: React-D3-Tree for pedigree charts
|
||||||
- **Backend**: Node.js/Express API
|
- **Backend**: Node.js/Express API
|
||||||
- **Database**: SQLite (embedded, zero-config)
|
- **Database**: SQLite (embedded, zero-config)
|
||||||
- **Container**: Single Docker image with multi-stage build
|
- **Container**: Single Docker image with multi-stage build
|
||||||
|
- **Styling**: CSS custom properties with dark theme
|
||||||
|
|
||||||
## Installation (Unraid)
|
## Installation (Unraid)
|
||||||
|
|
||||||
@@ -27,6 +51,7 @@ A reactive, interactive dog breeding genealogy mapping system for professional k
|
|||||||
```bash
|
```bash
|
||||||
cd /mnt/user/appdata/breedr-build
|
cd /mnt/user/appdata/breedr-build
|
||||||
git clone https://git.alwisp.com/jason/breedr.git .
|
git clone https://git.alwisp.com/jason/breedr.git .
|
||||||
|
git checkout feature/ui-redesign # For latest UI updates
|
||||||
```
|
```
|
||||||
|
|
||||||
2. Build the Docker image:
|
2. Build the Docker image:
|
||||||
@@ -76,9 +101,14 @@ breedr/
|
|||||||
│ └── package.json
|
│ └── package.json
|
||||||
├── server/ # Node.js backend
|
├── server/ # Node.js backend
|
||||||
│ ├── routes/
|
│ ├── routes/
|
||||||
│ ├── models/
|
|
||||||
│ ├── db/
|
│ ├── db/
|
||||||
|
│ │ ├── init.js
|
||||||
|
│ │ └── migrate_microchip.js
|
||||||
│ └── index.js
|
│ └── index.js
|
||||||
|
├── docs/ # Documentation
|
||||||
|
│ ├── MICROCHIP_FIX.md
|
||||||
|
│ ├── UI_REDESIGN.md
|
||||||
|
│ └── COMPACT_CARDS.md
|
||||||
├── Dockerfile # Multi-stage Docker build
|
├── Dockerfile # Multi-stage Docker build
|
||||||
├── docker-compose.yml
|
├── docker-compose.yml
|
||||||
├── package.json
|
├── package.json
|
||||||
@@ -102,19 +132,47 @@ SQLite database automatically initializes on first run with tables:
|
|||||||
- `heat_cycles` - Breeding cycle tracking
|
- `heat_cycles` - Breeding cycle tracking
|
||||||
- `traits` - Genetic trait mapping
|
- `traits` - Genetic trait mapping
|
||||||
|
|
||||||
|
## Upgrading
|
||||||
|
|
||||||
|
### From Earlier Versions
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Stop container
|
||||||
|
docker stop breedr
|
||||||
|
|
||||||
|
# Backup your data
|
||||||
|
cp -r /mnt/user/appdata/breedr /mnt/user/appdata/breedr-backup
|
||||||
|
|
||||||
|
# Pull latest code
|
||||||
|
cd /mnt/user/appdata/breedr-build
|
||||||
|
git pull
|
||||||
|
|
||||||
|
# Rebuild image
|
||||||
|
docker build -t breedr:latest .
|
||||||
|
|
||||||
|
# Start container (will auto-migrate)
|
||||||
|
docker start breedr
|
||||||
|
|
||||||
|
# Run migration if needed
|
||||||
|
docker exec -it breedr node server/db/migrate_microchip.js
|
||||||
|
```
|
||||||
|
|
||||||
## Roadmap
|
## Roadmap
|
||||||
|
|
||||||
### ✅ Phase 1: Foundation (Current)
|
### ✅ Phase 1: Foundation (Complete)
|
||||||
- [x] Project structure
|
- [x] Project structure
|
||||||
- [x] Docker containerization
|
- [x] Docker containerization
|
||||||
- [x] Database schema
|
- [x] Database schema
|
||||||
- [x] Basic API endpoints
|
- [x] Basic API endpoints
|
||||||
|
- [x] Modern UI redesign
|
||||||
|
|
||||||
### 🚧 Phase 2: Core Features
|
### 🚧 Phase 2: Core Features (In Progress)
|
||||||
- [ ] Dog profile management (CRUD)
|
- [x] Dog profile management (CRUD)
|
||||||
|
- [x] Photo management
|
||||||
|
- [x] Compact info card design
|
||||||
|
- [x] Search and filtering
|
||||||
- [ ] Interactive pedigree visualization
|
- [ ] Interactive pedigree visualization
|
||||||
- [ ] Parent-child relationship mapping
|
- [ ] Parent-child relationship mapping
|
||||||
- [ ] Basic photo uploads
|
|
||||||
|
|
||||||
### 📋 Phase 3: Breeding Tools
|
### 📋 Phase 3: Breeding Tools
|
||||||
- [ ] Inbreeding coefficient calculator
|
- [ ] Inbreeding coefficient calculator
|
||||||
@@ -122,21 +180,37 @@ SQLite database automatically initializes on first run with tables:
|
|||||||
- [ ] Heat cycle tracking
|
- [ ] Heat cycle tracking
|
||||||
- [ ] Litter management
|
- [ ] Litter management
|
||||||
|
|
||||||
### 📋 Phase 4: Health & Genetics
|
### 📊 Phase 4: Health & Genetics
|
||||||
- [ ] Health record management
|
- [ ] Health record management
|
||||||
- [ ] Genetic trait tracking
|
- [ ] Genetic trait tracking
|
||||||
- [ ] Document storage
|
- [ ] Document storage
|
||||||
|
|
||||||
### 📋 Phase 5: Advanced Features
|
### 🚀 Phase 5: Advanced Features
|
||||||
- [ ] PDF pedigree generation
|
- [ ] PDF pedigree generation
|
||||||
- [ ] Reverse pedigree (descendants)
|
- [ ] Reverse pedigree (descendants)
|
||||||
- [ ] Advanced search and filters
|
- [ ] Advanced search and filters
|
||||||
- [ ] Export capabilities
|
- [ ] Export capabilities
|
||||||
|
|
||||||
|
## Recent Updates
|
||||||
|
|
||||||
|
### March 8, 2026 - UI Redesign & Bug Fixes
|
||||||
|
- **Fixed:** Microchip field UNIQUE constraint (now properly optional)
|
||||||
|
- **Added:** Migration script for existing databases
|
||||||
|
- **Redesigned:** Modern dark theme with sleek aesthetics
|
||||||
|
- **Redesigned:** Compact horizontal info cards (80x80 avatars)
|
||||||
|
- **Improved:** Dashboard with gradient stats cards
|
||||||
|
- **Improved:** Navigation bar with glass morphism
|
||||||
|
- **Enhanced:** Age calculation and display
|
||||||
|
- **Added:** Sex-colored icons (blue ♂, pink ♀)
|
||||||
|
- **Added:** Registration number badges
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
Private use only - All rights reserved
|
Private use only - All rights reserved
|
||||||
|
|
||||||
## Support
|
## Support
|
||||||
|
|
||||||
For issues or questions, contact the system administrator.
|
For issues or questions:
|
||||||
|
- Check documentation in `docs/` folder
|
||||||
|
- Review container logs: `docker logs breedr`
|
||||||
|
- Contact the system administrator
|
||||||
Reference in New Issue
Block a user