Skip to main content

Changelog & Release Notes

Legal Notice

All compliance features described in this changelog are based on our interpretation of regulations at the time of development. Regulations change frequently. Users are responsible for ensuring their use of this software meets current legal requirements. We take no responsibility for compliance violations or out-of-date information.

Version 3.3.0 - Feed Calculators​

Released: April 2026

Flying Fox Feed Calculator​

  • New tool at /tools/feed-calculator/flying-fox covering Grey-headed Flying Fox and Little Red Flying-fox pups
  • Two input modes: age in days or forearm length in mm
  • Milk formula options: Wombaroo Flying-fox Milk Replacer, Wombaroo Impact (colostrum substitute), Di-Vetelact
  • Per-stage outputs: expected weight, total daily mL, feeds per day (6 → 2 as pups mature), per-feed mL, stage husbandry notes, formula-specific guidance
  • Conflict warnings: raised when age and forearm imply different stages

Macropod Joey Feed Calculator​

  • New tool at /tools/feed-calculator/macropod covering Eastern Grey Kangaroo, Red-necked Wallaby, Swamp Wallaby, and Common Wallaroo joeys
  • Flexible inputs: weight (recommended) and/or age
  • Wombaroo stage recommendation: Impact, 0.4, 0.6, 0.8, or >0.8 based on species-specific weight thresholds
  • Feed plan outputs: daily mL (10-20% of body weight), feeds per day (6 → 3), per-feed mL, stage guidance
  • Transition warnings: raised when a joey is within 10% of the next stage threshold to prompt a 3-5 day blended transition
  • Age-weight cross-check: warns when age and weight imply different stages

Tools Landing Page​

  • New /tools page: discoverable from a dedicated Tools link added to the desktop and mobile header navigation, visible to all roles
  • Client-side only: calculators run entirely in the browser with no database writes

No Database Changes​

Both calculators are pure client-side tools; no schema changes or migrations are required for this release.

Version 3.2.0 - Animal IDs & Member IDs​

Released: April 2026

Org-Configurable Animal IDs​

  • Animal ID template: Admins configure an ID format (e.g., {ORG_SHORT}-{YYYY}-{seq:4}) from a new Organisation Settings page in the admin panel
  • Auto-generation with peek/commit: New animals are assigned the next available ID automatically; abandoning a form does not consume a sequence number
  • Always editable: Users can override the auto-generated ID at creation or any time during editing
  • Uniqueness validation: The system prevents duplicate Animal IDs within the same organisation
  • Displayed everywhere: Animal IDs appear on the animal detail page, dashboard cards, and all data exports

Member IDs​

  • New field on carer profiles: Optional free-text Member ID for mapping to your organisation's internal membership system
  • Editable from two locations: The carer profile edit page and the admin People Management inline editor
  • Per-organisation: The same person can have different Member IDs in different organisations

Organisation Settings​

  • New admin tab: Organisation Settings page under Admin > Admin Options for configuring the Animal ID template and organisation short code
  • Live preview: See what generated IDs will look like as you configure the template

Compliance Readiness Checklist Updates​

  • New check: Member IDs: Flags members who are missing a Member ID
  • New check: Animal IDs: Flags animals who are missing an Animal ID
  • Dashboard banner: Admins see a standalone alert on the home dashboard when animals are missing IDs

Database Changes​

  • New model: OrganisationSettings -- stores org short code and animal ID template per organisation
  • New model: AnimalIdSequence -- per-org-per-year sequence counters for auto-generated IDs
  • New field: memberId on CarerProfile -- optional free-text member identifier

Version 3.1.0 - Growth Calculator​

Released: April 2026

Growth Calculator​

  • Growth Chart: Interactive Recharts line chart showing actual weight (red) vs predicted weight (blue) over age in days, displayed on the animal detail page Growth tab
  • Weight For Age (WFA): Calculates the difference between actual and predicted weight at each measurement date, colour-coded green/amber/red to flag animals falling behind
  • Birth Date Estimator: Estimates date of birth from physical measurements (weight, foot length, arm length, etc.) using linear interpolation against species reference data. Appears automatically when an animal has no DOB and the species has reference data
  • Growth Measurements: Dedicated measurement recording with weight (grams) and body part lengths (mm) -- head, ear, arm, leg, foot, tail, body, wing. Form adapts to show only relevant fields per species type
  • Species Growth Reference Data: Pre-loaded reference curves for 8 species across macropods, possums, and flying foxes (male and female), sourced from published scientific literature (Poole et al. 1982, ARAZPA, Kerle 1984, How 1983, Divljan 2006, Hall & Richards 2000)
  • Admin Growth Data tab: View reference data by species and sex with full academic citations
  • Automatic deployment: Growth reference data loaded via database migration -- no manual seeding required

Database Changes​

  • New model: SpeciesGrowthReference -- system-level growth reference data (age/weight/measurements per species+sex)
  • New model: GrowthMeasurement -- per-animal measurement records with structured numeric fields

Version 3.0.0 - RBAC, Audit Logging & Admin Enhancements​

Released: February 2026

🔐 Role-Based Access Control (RBAC)​

  • Three-tier role system: Admin, Coordinator, and Carer roles with granular permissions
  • Species-Based Access Control (SBAC): Carers only see animals in their assigned species groups
  • Self-service role provisioning: New users select their role on first sign-in
  • Role migration tooling: Existing Clerk users can be grandfathered into the new role system
  • UI guards: Navigation, pages, and actions adapt based on user role
  • Defence-in-depth: Server-side role validation on all API endpoints

📋 Audit Logging​

  • Comprehensive event tracking: All CRUD operations, role changes, assignments, and logins are recorded
  • Admin audit log viewer: Searchable, filterable, sortable, and paginated UI in the admin panel
  • User identity capture: Logs include user names and email addresses
  • Input validation hardening: Strict server-side validation on all audit log API parameters

✅ Compliance Readiness Checklist​

  • Dashboard widget for admins: At-a-glance EOFY readiness across three categories
  • Carer profile checks: Verifies phone numbers, emails, and licence numbers for all members
  • Training & licence checks: Flags expired certifications and licences
  • Organisation profile checks: Confirms org name, jurisdiction, contact details, and licence number
  • Direct action links: Each incomplete item links to the page where it can be resolved
  • 24-hour dismissal: Checklist can be temporarily hidden

👥 Carer Profile Improvements​

  • Clerk-sourced identity: Names and emails are now read-only, sourced from Clerk
  • Profile completion tracking: Dashboard alert for incomplete profiles
  • Admins as universal carers: Admins can be assigned to any animal without species group restrictions

🐾 Animal Management Enhancements​

  • Quick-add animal button: New "Add New Animal" button on the dashboard for faster admission
  • Simplified carer assignment: Dedicated "Assign Carer" / "Change Carer" button on animal detail pages
  • Enhanced record timeline: Records now show who recorded each entry, description, notes, location, and timestamps
  • Default admitted status: Animals are now created with "Admitted" status by default

🐛 Bug Fixes​

  • Fixed species combobox search losing focus inside dialogs
  • Fixed silent PATCH failure when assigning carer to animal
  • Fixed timezone issues in audit log timestamps
  • Added wombat species (Common, Northern hairy-nosed, Southern hairy-nosed)
  • Permanent care categories expanded with COMPANION and RESEARCH

Version 2.0.0 - NSW DCCEEW Compliance Update​

Released: August 2025

🎯 Major Features​

NSW Wildlife Rehabilitation Combined Annual Report​

  • Automated Report Generation: Complete Excel workbook generation matching DCCEEW template exactly
  • All Required Worksheets: Nil Return, Transferred Animals, Permanent Care, Preserved Specimens, Register of Members, Privacy Notice
  • Pre-populated Organization Data: Automatic population from Clerk authentication system
  • Calendar Year Defaults: Reports default to current calendar year for easy annual reporting

NSW-Specific Data Collection​

  • Encounter Types: 70+ DCCEEW-specified categories organized into logical groups:
    • Attacks & Collisions (bird, cat, dog, vehicle, etc.)
    • Dependency & Diseases (abandoned, disease, dependent young)
    • Environmental Factors (fire, flood, storm damage)
    • Human Interference (illegal activity, entanglement)
  • Animal Condition Assessment: 5-level scale (Good, Fair, Poor, Emaciated, Moribund)
  • Pouch Condition Tracking: 15 developmental stages for marsupials
  • Fate/Outcome Options: 30+ NSW-specific outcomes including all DCCEEW categories
  • Weight Recording: Initial weight capture in grams for all admissions

Enhanced Location Management​

  • Automatic Address Extraction: Drop a pin on the map and get:
    • Street address automatically populated
    • Suburb/town automatically filled
    • Postcode automatically captured
    • State automatically determined
  • Structured Address Storage: Separate database fields for address components
  • Release Location Tracking: Automatic address capture when marking animals as released
  • Google Maps Integration: Visual map interface for all location selection
  • OpenStreetMap Nominatim: Reverse geocoding for accurate address extraction

🔧 Technical Improvements​

Database Schema Updates​

  • Added NSW-specific fields to animals table:
    • encounter_type, initial_weight_grams, animal_condition
    • pouch_condition, fate, mark_band_microchip, life_stage
  • Added structured address fields:
    • rescue_address, rescue_suburb, rescue_postcode
    • release_address, release_suburb, release_postcode
  • Added carer NSW fields:
    • executive_position, species_coordinator_for
    • rehabilitates_koala, rehabilitates_flying_fox, rehabilitates_bird_of_prey
    • member_since, training_level

Prisma Schema Mappings​

  • Proper snake_case to camelCase field mappings
  • Support for both legacy and new field names
  • Backward compatibility with existing data

Form Improvements​

  • Conditional Field Display: NSW fields only show when jurisdiction is NSW
  • Smart Defaults: Forms pre-populate with sensible defaults
  • Validation Enhancement: Comprehensive field validation with user-friendly errors
  • Auto-population: Address fields populate automatically from map selection
  • Controlled Inputs: Fixed React controlled component warnings

🐛 Bug Fixes​

  • Fixed form refresh issue that was clearing fields during data entry
  • Resolved uncontrolled input warnings for number fields
  • Corrected transfer animal filtering logic in NSW reports
  • Fixed date validation to allow current year end dates
  • Resolved Prisma client field mapping issues

📊 Animal Detail Page Enhancements​

  • Complete Field Display: All animal data now visible without entering edit mode
  • Organized Sections:
    • Basic Details (sex, age, dates)
    • NSW Compliance Data (all NSW-specific fields)
    • Address Details (structured rescue and release addresses)
    • Notes section with formatted display
  • Removed Image Placeholder: Cleaner interface without unused image section

📝 Documentation Updates​

  • Comprehensive NSW DCCEEW compliance documentation
  • Detailed field reference for all NSW requirements
  • Step-by-step NSW Annual Report generation guide
  • Automatic address population feature documentation
  • Updated compliance scoring information

🔐 Data Privacy & Security​

  • Privacy Notice included in NSW reports
  • Secure data handling for member information
  • Proper authorization tracking for special species
  • Audit trail for all compliance-related changes

💡 User Experience Improvements​

  • Clerk Integration: Organization and user data auto-populated
  • Smart Location Entry: No manual address typing required
  • Release Workflow: Streamlined process with automatic data capture
  • Error Messages: Clear, actionable validation feedback
  • Responsive Design: Works on all screen sizes

🌐 Jurisdiction Support​

  • Full ACT Wildlife Code of Practice 2020 compliance (existing)
  • NEW: Complete NSW DCCEEW reporting compliance
  • Jurisdiction-aware field display and validation
  • Automatic compliance rule application based on location

Previous Versions​

Version 1.5.0​

Released: July 2025

  • Initial release checklist implementation
  • Basic compliance scoring system
  • ACT jurisdiction support
  • Core animal admission workflow

Version 1.0.0​

Released: June 2025

  • Initial public release
  • Basic wildlife admission and tracking
  • Carer management
  • Simple reporting capabilities

Coming Soon​

Planned Features​

  • Queensland wildlife rehabilitation compliance
  • Victoria wildlife rehabilitation compliance
  • Automated report scheduling
  • Mobile app for field data entry
  • Advanced analytics dashboard
  • Multi-organization data sharing
  • Veterinary integration
  • Training module with certification tracking

Known Issues​

  • Manual report submission still required (no automatic email to authorities)
  • Limited batch editing capabilities
  • No offline mode support yet

For feature requests or bug reports, please contact your system administrator or submit an issue through the support portal.