​

Animal Management & Records

​

Overview

​

Dual Identification System

​

reptidex Universal IDs

• Format: 1-3 species letters + sequential numbers (e.g., “CG11209”, “BP22093”)
• Universal Search: All animals searchable by reptidex ID across the platform
• Cross-Reference: Enables lineage tracking across vivariums and ownership changes
• API Integration: Consistent identifier for external system integration

​

Custom Vivarium IDs

​

Search & Cross-Reference

• Dual Search: Find animals by either reptidex ID or custom vivarium ID
• Relationship Indexing: Efficient lookup across identification systems
• Historical Preservation: IDs maintained through ownership transfers
• Batch Operations: Support for bulk ID management and updates

​

Species Integration & Taxonomy

​

Taxonomic Database Integration

• Common Name Focus: Animal profiles display common names for accessibility
• Scientific Backbone: Species data linked to taxonomic database for accuracy
• Morph Classification: Comprehensive morph tracking with genetic implications
• Care Integration: Species-specific care requirements and recommendations

​

Smart Species Features

​

Dynamic Status Lifecycle

​

Core Animal Statuses

​

Automated Status Transitions

• Pairing Creation → Parents automatically transition to “Breeding” status
• Sale Completion → Animal automatically transitions to “Sold” status
• Marketplace Listing → Animal automatically transitions to “For Sale” status
• Transfer Initiation → Animal temporarily locked during transfer process
• Breeding Success → Gravid animal transitions to “Active” after laying/birthing

​

Manual Override & Approval Workflows

• Curator/Herpetologist Control: Only authorized vivarium roles can modify sensitive statuses
• Approval Requirements: Critical status changes (deceased, sold externally) require confirmation
• Audit Trail: Complete history of status changes with user attribution and timestamps
• Bulk Operations: Efficient status management for large collections

​

Comprehensive Measurement Tracking

​

Primary Measurements

​

Weight Tracking

• Multiple Units: Grams, ounces, pounds with automatic conversion
• Frequency Flexibility: Weekly, monthly, or custom measurement schedules
• Growth Curves: Visual progression tracking with species-appropriate milestones
• Alert System: Notifications for weight loss, abnormal gains, or growth concerns

​

Length Tracking

• Species-Specific: Total length, snout-to-vent, shell measurements based on species type
• Growth Progression: Visual timeline showing development over time
• Breeding Readiness: Size-based breeding eligibility indicators
• Comparative Analysis: Size comparisons within breeding lines and clutch mates

​

Advanced Measurement Features

​

Professional Photo Management

​

Comprehensive Documentation System

​

Photo Categories & Organization

• Progression Series: Before/after comparisons, growth documentation, weight correlation photos
• Breeding Documentation: Pairing photos, gravid progression, clutch documentation
• Health Records: Shed documentation, veterinary visit photos, treatment progress
• Evaluation Sets: Breeding assessment photos with scoring and decision documentation
• Facility Documentation: Enclosure setups, breeding facilities, operational infrastructure

​

Advanced Photo Features

​

Professional Media Management

• High-Resolution Storage: Professional quality image storage with compression options
• Batch Upload: Efficient photo management for large breeding operations
• Metadata Preservation: EXIF data retention with automatic date/time correlation
• Export Capabilities: Professional photo export for marketing, documentation, and sales

​

Health & Veterinary Integration

​

Comprehensive Health Records

​

Medical Record Management

• Veterinary Visits: Complete visit documentation with diagnosis, treatment, and follow-up scheduling
• Medication Tracking: Dosage schedules, treatment duration, and effectiveness monitoring
• Vaccination Records: Species-appropriate vaccination tracking with renewal reminders
• Document Storage: Secure storage for veterinary reports, lab results, and medical imaging

​

Health Monitoring & Alerts

​

Future Veterinary Integration (Phase 4)

• Practice Management Integration: Direct connection with veterinary practice software
• Telemedicine Support: Virtual consultation integration with photo and video sharing
• Health Database Contribution: Anonymous health data contribution for species-wide health insights

​

Care Scheduling & Husbandry

​

Species-Adaptive Care Management

​

Core Care Activities

• Feeding Management: Species-appropriate feeding schedules with prey size, frequency, and nutritional tracking
• Habitat Maintenance: Cleaning schedules, substrate changes, equipment maintenance, and environmental monitoring
• Health Monitoring: Regular weigh-ins, visual health checks, and behavioral assessments
• Environmental Management: Temperature, humidity, lighting cycles, and seasonal adjustments

​

Smart Care Features

​

Notification & Reminder System

• Multi-Channel Alerts: Email, SMS, push notifications, and in-app reminders
• User Preferences: Customizable notification frequency, timing, and delivery methods
• Team Coordination: Care assignment and completion tracking for vivarium collaborators
• Smart Prioritization: Urgent care alerts prioritized over routine maintenance reminders

​

Genetics-First Breeding Management

​

Comprehensive Pedigree Integration

​

Advanced Genetic Features

• Complete Pedigree Management: Multi-generation lineage tracking with visual pedigree trees
• Morph Genetics: Detailed genetic marker tracking with inheritance prediction
• Trait Expression: Visual trait tracking with photo documentation and genetic correlation
• Breeding Predictions: Phase 3 feature for AI-powered breeding outcome prediction

​

Breeding History & Analytics

​

Breeding Calendar & Planning (Phase 2)

• Seasonal Breeding: Species-appropriate breeding season tracking and planning
• Genetic Goals: Long-term breeding program planning with genetic objective tracking
• Partner Coordination: Cross-vivarium breeding project planning and execution
• Outcome Prediction: Advanced AI-powered breeding outcome modeling and recommendations

​

Financial & Commercial Integration

​

Comprehensive Financial Tracking

​

Valuation & Investment Tracking

• Purchase Documentation: Original purchase price, source, and acquisition documentation
• Current Valuation: Market-based valuation tracking with appreciation/depreciation analysis
• Sale Integration: Seamless marketplace integration with automatic pricing and sales documentation
• Investment Analytics: ROI calculation, breeding program profitability, and collection value tracking

​

Advanced Financial Features (Phase 3)

• Care Cost Analysis: Predictive cost tracking based on feeding, housing, and veterinary expenses
• Breeding ROI: Detailed breeding program profitability with offspring value and care cost correlation
• Market Intelligence: Comparative pricing analysis and market trend integration
• Tax Documentation: Business expense tracking and tax reporting integration

​

Seamless Ownership Transfers

​

Collection Organization & Management

​

Flexible Organization System

​

Multi-Level Organization

• Animal Groups: Custom groupings by species, projects, breeding lines, or facility location
• Tag System: Robust tagging with custom categories, genetic markers, and project associations
• Vivarium Separation: Multi-vivarium organization with cross-vivarium relationship tracking
• Custom Attributes: User-defined fields for specialized tracking and organization needs

​

Advanced Collection Features

​

Scalability & Performance

• Optimized for Scale: Efficient performance with collections from 2 to 2,000+ animals
• Lazy Loading: Progressive data loading for responsive interface with large collections
• Caching Strategy: Intelligent caching for frequently accessed collection views and searches
• Archive Management: Efficient handling of historical animals without cluttering active views

​

Vivarium Integration & Collaboration

​

Seamless Vivarium Integration

​

Role-Based Animal Management

• Keeper (Viewer): Read-only access to animal records, pedigrees, and care information
• Handler (Editor): Add/update animals, record care activities, upload photos, manage day-to-day operations
• Curator (Admin): Full animal management, care schedule configuration, breeding program setup
• Herpetologist (Owner): Complete control including financial data, transfers, and sensitive operations

​

Cross-Vivarium Features

​

Data Preservation & Historical Integrity

​

Complete Historical Preservation

​

Permanent Record Keeping

• No Hard Deletion: Animals never permanently deleted from system
• Lineage Preservation: Complete pedigree integrity maintained across all ownership changes
• Access Control: Historical data accessible to appropriate parties with privacy controls
• Archive Organization: Sold/deceased/transferred animals organized separately from active collections

​

Historical Access & Rights

• Original Breeder Access: Permanent access to animals they bred for lineage and genetic tracking
• Buyer Transparency: Complete historical data transferred with animal ownership
• Research Value: Long-term genetic research enabled through comprehensive historical data
• Industry Benefit: Platform-wide genetic intelligence improved through data preservation

​

Technical Implementation

​

Database Architecture

-- Core animal management
CREATE TABLE animals (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    reptidex_id VARCHAR(20) UNIQUE NOT NULL,
    custom_id VARCHAR(50),
    vivarium_id UUID REFERENCES vivariums(id),
    species_id UUID REFERENCES species(id),
    name VARCHAR(255),
    sex VARCHAR(10),
    status VARCHAR(20) DEFAULT 'active',
    birth_date DATE,
    acquisition_date DATE,
    acquisition_source TEXT,
    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);

-- Measurement tracking
CREATE TABLE measurements (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    animal_id UUID REFERENCES animals(id),
    measurement_type VARCHAR(20), -- 'weight', 'length', 'custom'
    value DECIMAL(10,2),
    unit VARCHAR(10),
    measured_at TIMESTAMP WITH TIME ZONE,
    notes TEXT,
    photo_ids UUID[]
);

-- Photo management
CREATE TABLE animal_photos (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    animal_id UUID REFERENCES animals(id),
    file_path VARCHAR(500),
    category VARCHAR(50), -- 'progression', 'breeding', 'health', 'evaluation'
    tags TEXT[],
    taken_at TIMESTAMP WITH TIME ZONE,
    metadata JSONB
);

-- Care tracking
CREATE TABLE care_events (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    animal_id UUID REFERENCES animals(id),
    event_type VARCHAR(50), -- 'feeding', 'cleaning', 'health_check'
    performed_by UUID REFERENCES users(id),
    performed_at TIMESTAMP WITH TIME ZONE,
    notes TEXT,
    next_due_date DATE
);

​

Performance & Scalability

• Indexed Searching: Optimized indexes for both reptidex and custom ID lookups
• Partition Strategy: Historical data partitioning for optimal performance
• Caching Layer: Intelligent caching for frequently accessed animal data
• Archive Optimization: Efficient storage and retrieval for historical animals

​

Competitive Advantages

​

Beyond Basic Animal Tracking

​

Industry-Leading Features

• Dual ID System: Professional breeding operations with platform consistency
• Smart Species Integration: Taxonomic database integration with user-friendly interfaces
• Advanced Photo Management: Professional breeding documentation and analysis tools
• Cross-Vivarium Breeding: Unprecedented collaboration capabilities for breeding partnerships

​

Future Enhancements

​

Phase 2: Advanced Breeding Tools

• Breeding Calendar: Comprehensive breeding planning and scheduling tools
• Advanced Analytics: Breeding success correlation and genetic outcome analysis
• Shipping Integration: Direct integration with shipping carriers and logistics

​

Phase 3: AI & Predictive Features

• Breeding Predictions: AI-powered genetic outcome prediction and breeding recommendations
• Care Cost Analysis: Predictive cost tracking and financial optimization
• Health Pattern Recognition: AI-powered health monitoring and early warning systems

​

Phase 4: Industry Integration

• Genetic Testing Integration: Direct integration with genetic testing laboratories
• Veterinary Practice Integration: Seamless veterinary workflow and telemedicine integration
• Registry Partnerships: Integration with reptile registries and breeding organizations

​

Getting Started

​

Setting Up Your First Animals

1. Species Selection: Choose species from taxonomic database for automatic care configuration
2. ID Configuration: Set up custom ID system for your vivarium or use reptidex defaults
3. Initial Documentation: Upload photos, record measurements, and document acquisition details
4. Care Schedule Setup: Configure species-appropriate care schedules with personal customizations
5. Genetic Documentation: Enter pedigree information and genetic markers for breeding tracking

​

Best Practices

• Consistent Documentation: Regular photo uploads and measurement tracking for complete records
• Collaborative Setup: Proper role assignment and care responsibility distribution in vivariums
• Genetic Accuracy: Careful pedigree documentation for long-term breeding program success
• Historical Preservation: Complete documentation before animal transfers or sales
• Health Monitoring: Proactive health tracking and veterinary documentation