KORA END-USER GUIDE - PROPOSED STRUCTURE

PART 1: UNDERSTANDING KORA (Concepts First)

Chapter 1: Introduction to Kora

• What is Kora?
• Why an Unopinionated System Matters
• Who Uses Kora? (Overview of 8+ user contexts)
• The One Health Approach
• How to Use This Guide

Chapter 2: Core Concepts - How to Think About Kora

Purpose: Build the mental model before diving into features

• 2.1 The Location Hierarchy
  • Locations (Farms, Reserves, Facilities)
  • Subdivisions (Paddocks, Enclosures, Zones)
  • Features (Water Points, Gates, Infrastructure)
  • GPS & Boundaries
• 2.2 The Dual-Tier Animal Management System
  • Individual Animals: When and Why
  • Animal Mobs (Groups): When and Why
  • Moving Between Individual and Group Management
  • Real-World Examples Across Contexts
• 2.3 Events, Observations & History
  • What Happens to Animals (The Activity Layer)
  • Observations vs. Treatments vs. Movements
  • The Timeline Concept
  • Scheduled vs. Historical vs. Real-Time
• 2.4 Traceability - The Lifetime Audit Trail
  • What is Traceability and Why It Matters
  • How Kora Creates Immutable Records
  • Regulatory Compliance Without the Complexity
  • Blockchain Integration (Optional)
• 2.5 Biosecurity & Disease Prevention
  • Zones, Quarantine & Containment
  • Automatic Contact Tracing Explained
  • Prevention vs. Response
  • How Kora Thinks Like an Epidemiologist
• 2.6 Tasks & Workflows
  • How Work Gets Done in Kora
  • Recurring Tasks for Routine Care
  • Task Assignment & Collaboration
  • Integration with Animals, Mobs, and Locations

Chapter 3: User Types & Permissions

Purpose: Help users understand their role and capabilities

• 3.1 Overview of User Types
  • Professional
  • Veterinarian (Approval Process Explained)
  • Farmer
  • Community Animal Health Worker (CAHW)
  • Paraprofessional
  • Conservation & NGO
  • Wildlife Management
  • Regulatory Authority
  • Education
  • Public
• 3.2 Permission Levels Explained
  • Read-Only → Basic → Standard → Advanced → Administrative
  • What Each Level Means in Practice
• 3.3 Understanding Your Dashboard
  • How Your User Type Shapes What You See
  • Feature Access by Role
  • Customizing Your Experience
• 3.4 Multi-Context Users
  • Veterinarians Serving Multiple Facility Types
  • How Location Type Affects Defaults
  • Switching Contexts Seamlessly

Chapter 4: The Knowledge API - Your Disease Intelligence Hub

Purpose: Explain the integrated knowledge system

• 4.1 What is the Knowledge API?
  • Emergency Animal Disease Database
  • Why Separate from Regular Records?
  • How It Powers Kora's Intelligence
• 4.2 What Information Is Available?
  • 100+ Emergency Disease Profiles
  • 100,000+ Outbreak Records
  • Plant Poisoning Database
  • Educational Explainers
  • Authority Contacts & Emergency Hotlines
  • Resource Library (WOAH, FAO, etc.)
• 4.3 How to Use Disease Information
  • Browsing & Searching Diseases
  • Understanding Disease Detail Pages
  • Interactive Symptom Visualization
  • Bookmarking Frequently Referenced Diseases
  • Emergency Reporting Procedures
• 4.4 Integration with Daily Work
  • How Disease Data Powers Quarantine Calculations
  • Automatic Biosecurity Protocols
  • Outbreak Monitoring & Alerts
  • Educational Content for Team Training

Chapter 5: Desktop vs. Mobile Experience

Purpose: Help users understand device-specific features

• 5.1 Overview
  • Responsive Design Philosophy
  • When to Use Desktop vs. Mobile
• 5.2 Desktop Experience
  • Side Navigation (SideNav)
  • Full Feature Access
  • Multi-Column Layouts
  • Data Tables & Analytics
  • Map Controls & Editing
• 5.3 Mobile & Tablet Experience
  • Bottom Navigation Bar
  • Touch-Optimized Interface
  • Card-Based Data Views
  • Bottom Sheets for Context
  • Mobile Map Experience
• 5.4 Field Work Features (Mobile-First)
  • GPS Auto-Capture for Observations
  • Quick Field Observation Recording
  • QR Code Scanning for Visitor Check-In
  • Camera Integration
  • Offline Location Caching
• 5.5 What's Different on Mobile
  • Navigation Changes
  • Hidden Features (Breadcrumbs, Leaflet Controls)
  • Mobile-Optimized Workflows
  • Touch Targets & Accessibility

PART 2: GETTING STARTED (Onboarding)

Chapter 6: First Steps

• 6.1 Creating Your Account
  • Registration Process
  • Choosing Your User Type
  • Veterinarian Approval Process
  • Email Verification
• 6.2 Setting Up Your First Location
  • Creating a Location (Farm/Reserve/Facility)
  • Adding GPS Coordinates
  • Drawing Boundaries on Maps
  • Creating Subdivisions (Paddocks/Enclosures)
• 6.3 Your First Animal Record
  • Individual Animal Creation
  • Identification Methods (RFID, Tags, Microchips)
  • Basic Information
  • Assigning to Location
• 6.4 Navigation Basics
  • Understanding SideNav (Desktop)
  • Using MobileNav (Mobile/Tablet)
  • AppLauncher Overview
  • Home Dashboard
  • Universal Search

Chapter 7: Essential Daily Workflows

• 7.1 Recording Observations
  • Health Observations
  • Behavioral Observations
  • Field Observations with GPS
  • Photo Documentation
  • Follow-Up Flags
• 7.2 Managing Tasks
  • Creating Tasks
  • Assigning Tasks
  • Setting Due Dates
  • Recurring Tasks for Routine Care
  • Task Completion
• 7.3 Recording Movements
  • Moving Animals Between Locations
  • Movement Reasons & Documentation
  • Automatic Traceability Updates
  • Movement History
• 7.4 Basic Treatments
  • Recording Treatments
  • Medication Administration
  • Vaccination Schedules
  • Withdrawal Periods

PART 3: CORE FEATURES (Main Functionality)

Chapter 8: Animal Management

• 8.1 Individual Animal Records
  • Complete Animal Profiles
  • Health History
  • Weight Tracking
  • Reproductive Records
  • Identification Management
  • Status Badges (Quarantine, Pregnancy, etc.)
• 8.2 Animal Mobs (Group Management)
  • Creating Animal Groups
  • Population Tracking
  • Demographics (Males/Females, Age Ranges)
  • Mob Observations
  • Mob Treatments
  • Splitting & Merging Groups
• 8.3 Animal Lifecycle Management
  • Acquisition (Birth, Purchase, Rescue)
  • Daily Management
  • Medical Care
  • Reproduction
  • Exit (Sale, Death, Transfer)

Chapter 9: Maps & Location Management

• 9.1 Map Manager Overview
• 9.2 Creating & Editing Locations
  • Drawing Boundaries
  • Subdivision Hierarchy
  • Location Types (Farm, Zoo, Reserve, etc.)
• 9.3 Visualizing Animal Locations
  • Current Animal Positions
  • Movement History on Maps
  • Location-Based Searches
• 9.4 Biosecurity Zone Mapping
  • Defining Security Zones
  • Risk Level Visualization
  • Access Control by Zone

Chapter 10: Health & Treatment Management

• 10.1 Observations System
  • Types of Observations (Health, Behavior, Physical)
  • Severity Levels
  • Follow-Up Workflow
  • Veterinary Observations (Licensed Vets Only)
• 10.2 Treatment Administration
  • Individual Animal Treatments
  • Mob Treatments
  • Treatment Plans (Scheduled Care)
  • Medication Inventory Integration
• 10.3 Health Assessments
  • Five-Domain Welfare Assessments
  • Health Scoring
  • Automated Risk Alerts

Chapter 11: Biosecurity & Disease Management

• 11.1 Biosecurity Dashboard
  • Risk Level Overview
  • Active Protocols
  • Compliance Status
• 11.2 Quarantine Management
  • Initiating Quarantine
  • Automatic Duration Calculation
  • Health Checks During Quarantine
  • Release Protocols
  • Extension Management
• 11.3 Contact Tracing
  • Automatic Exposure Identification
  • Risk Scoring
  • Contact Network Visualization
• 11.4 Visitor Management
  • QR Code Generation
  • Visitor Check-In/Check-Out
  • Risk Screening
  • Location-Based Visitor Logs
• 11.5 Biosecurity Protocols
  • Creating Protocols
  • Scheduled Assessments
  • Compliance Tracking

Chapter 12: Traceability & Compliance

• 12.1 Understanding Traceability
  • Lifetime Identifiers
  • Cryptographic Security (SHA-256 Hashing)
  • Immutable Event Chains
• 12.2 Traceability Events
  • 50+ Event Types
  • Automatic vs. Manual Events
  • Evidence Attachment (Photos, Documents)
• 12.3 Health Certificates
  • Certificate Types (Export, Import, Movement)
  • Generation Workflow
  • Validity Tracking
• 12.4 Regulatory Compliance
  • ISO Standards Support
  • Regional Framework Compliance (EU TRACES, USDA, NLIS)
  • Export/Import Documentation

Chapter 13: Task Management & Workflows

• 13.1 Task System Overview
• 13.2 Creating & Assigning Tasks
• 13.3 Recurring Tasks
  • Daily Routines (Feeding, Health Checks)
  • Weekly/Monthly Schedules
  • Auto-Generation
• 13.4 Task Templates
  • Common Workflows
  • Customization

Chapter 14: Inventory & Supply Management

• 14.1 Inventory Tracking
  • 46+ Product Categories
  • Batch & Lot Tracking
  • Expiration Monitoring
  • Multi-Location Inventory
• 14.2 Supplier Management
  • Supplier Database
  • Performance Metrics
  • Pricing Intelligence
  • Sustainability Credentials
• 14.3 Usage Analytics
  • Consumption Patterns
  • Procurement Optimization
  • Cost Tracking

PART 4: SPECIALIZED FEATURES (Context-Specific)

Chapter 15: Wildlife Management & Conservation

• 15.1 Wildlife Sightings
  • GPS-Based Recording
  • Species Identification
  • Photo Documentation
  • Population Estimates
• 15.2 Wildlife Incidents
  • Human-Wildlife Conflict
  • Emergency Response
• 15.3 Habitat Monitoring
  • Habitat Quality Assessments
  • Seasonal Tracking
  • Restoration Projects
• 15.4 CITES Compliance
  • Endangered Species Documentation
  • Permit Management
  • Trade Documentation

Chapter 16: Breeding Programs & Genetics (Studbook)

• 16.1 Pedigree Documentation
  • Family Trees
  • Parentage Confidence Levels
• 16.2 Genetic Profiling
  • DNA Analysis Recording
  • Inbreeding Coefficients
  • Genetic Diversity Metrics
• 16.3 Breeding Recommendations
  • Evidence-Based Mating Guidance
  • Population Analysis
  • Conservation Integration
• 16.4 Multi-Institution Coordination
  • Species Survival Plans
  • Cross-Facility Breeding

Chapter 17: Beekeeping & Apiary Management

• 17.1 Apiary Operations
  • Hive Inventory
  • Queen Tracking
• 17.2 Hive Inspections
  • Health Assessments
  • Pest & Disease Monitoring
• 17.3 Production Tracking
  • Honey Harvests
  • Quality Grading
  • Analytics
• 17.4 Swarm Management

Chapter 18: Sustainability & Environmental Stewardship

• 18.1 Carbon Footprint Tracking
  • 11 Emission Categories
  • Data Quality Levels
  • Monthly Analytics
• 18.2 Environmental Impact Assessments
  • 10 Assessment Types
  • Multi-Dimensional Tracking
  • Certification Levels
• 18.3 Sustainability Goals & Practices
  • 15 Goal Categories
  • ROI Analysis
  • Impact Monitoring
• 18.4 Habitat Management
  • Location-Specific Tracking
  • Seasonal Management
  • Restoration Projects

Chapter 19: Antimicrobial Resistance (AMR) Tracking

• 19.1 AMR Dashboard Overview
• 19.2 WHO Classification System
  • Access, Watch, Reserve Categories
  • Clinical Justification Requirements
• 19.3 Treatment Documentation
  • Diagnostic Support
  • Alternatives Considered
  • Outcome Tracking
• 19.4 Stewardship Compliance
  • Usage Pattern Analysis
  • Resistance Trend Monitoring
  • Regulatory Reporting

PART 5: SPECIALIZED USER WORKFLOWS

Chapter 20: For Veterinarians

• 20.1 Veterinarian Dashboard
• 20.2 Cross-Property Animal Access
  • Search Capabilities
  • Access Tracking & Reasons
  • Recently Accessed Animals
• 20.3 Veterinary Observations
  • Clinical Diagnoses
  • Severity Assessments
  • Treatment Recommendations
• 20.4 Automatic Biosecurity Response
  • Disease-Triggered Workflows
  • Exposed Animal Identification
  • Quarantine Recommendations
• 20.5 AMR Stewardship
  • Responsible Antimicrobial Use
  • Diagnostic Justification
  • Outcome Monitoring

Chapter 21: For Community Animal Health Workers (CAHWs)

• 21.1 CAHW Dashboard
• 21.2 Simplified Workflows
• 21.3 Basic Health Interventions
• 21.4 Supervised Treatment Protocols
• 21.5 Field Data Collection

Chapter 22: For Conservation Organizations (NGO Dashboard)

• 22.1 NGO Dashboard Overview
  • Territory Metrics
  • Operations Board
  • Signals & Alerts
  • Mission Strip
• 22.2 Conservation Workflows
  • Population Monitoring
  • Habitat Management
  • Breeding Program Coordination
• 22.3 Analytics & Reporting

Chapter 23: For Regulatory Authorities

• 23.1 Regulatory Dashboard
• 23.2 Cross-Organization Visibility
  • Anonymized Data Access
  • Compliance Monitoring
• 23.3 Traceability Search
  • Animal Movement History
  • Chain of Custody
  • Food Safety Investigation
• 23.4 Compliance Matrix
  • Regulatory Status Tracking
  • Violation Management
• 23.5 Audit & Reporting

Chapter 24: For Farm Managers & Livestock Owners

• 24.1 Farm Dashboard
• 24.2 Daily Routines
  • Feeding Schedules
  • Health Checks
  • Movement Management
• 24.3 Production Tracking
  • Growth Metrics
  • Weight Trends
  • Reproductive Performance
• 24.4 Certification & Market Access
  • Organic Certification Support
  • Traceability Documentation
  • Premium Market Requirements

PART 6: ADVANCED FEATURES

Chapter 25: Analytics & Reporting

• 25.1 Dashboard Analytics
  • Farm Dashboard
  • Sustainability Dashboard
  • AMR Dashboard
  • Biosecurity Dashboard
  • Regulatory Dashboard
• 25.2 Data Export
  • Export Formats
  • Custom Filters
  • Regulatory Submission
• 25.3 Custom Reports

Chapter 26: Collaboration & Team Management

• 26.0 Collaboration & Team Management - Introduction
  • Working Together in Kora
  • What Collaboration Features Cover
  • Collaboration vs Task Management
  • Multi-User Coordination
  • Desktop vs Mobile for Team Collaboration
  • Integration with Operational Features
• 26.1 Staff Directory & Team Coordination
  • Your Team at a Glance
  • Viewing Your Team
  • Staff Profiles (Basic, Operational, Access Information)
  • Adding Team Members
  • Updating Staff Profiles
  • Access Levels (Basic, Standard, Advanced)
  • Marking Staff as Inactive
  • Staff Responsibilities and Coordination
  • Specializations and Certifications
  • Contact Information and Communication
  • Integration with Task Assignment
  • Best Practices and Common Workflows
• 26.2 Assigning Tasks to Team Members
  • How Task Assignment Works (References Chapter 13)
  • Assigning Tasks During Creation
  • Viewing Assigned Tasks
  • Re-Assigning Tasks
  • Assigning Tasks to Animal-Responsible Staff
  • Task Assignment and Workload Awareness
  • Assigning Recurring Tasks to Team Members
  • Task Assignment Notifications
  • Common Task Assignment Workflows
  • Integration with Other Features
  • Best Practices and Troubleshooting
• 26.3 Real-Time Collaboration
  • How Real-Time Updates Work
  • Multi-User Awareness
  • Location-Based Collaboration
  • Real-Time Notifications
  • Desktop vs Mobile Real-Time Updates
  • Practical Benefits
  • Technical Considerations
• 26.4 Notifications & Alerts
  • Staying Informed About Important Events
  • Notification Types (Info, Success, Warning, Error)
  • Notification Sources (System, Biosecurity, Health, Tasks, User Actions)
  • Notification Priorities (High, Medium, Low)
  • Viewing Notifications
  • Managing Notifications
  • Notification Settings
  • Team Notifications
  • Acting on Notifications
  • Notification Best Practices
  • Common Notification Scenarios

Chapter 27: System Administration (SuperUsers Only)

• 27.0 System Administration - Introduction
  • Managing Your Organization's Kora Instance
  • Single-Tenant Architecture & Data Sovereignty
  • SuperUser Responsibilities
  • Security & Audit Logging
• 27.1 Admin Dashboard Overview
  • Dashboard Statistics (Users, Animals, Knowledge API, System Health)
  • Navigation to Admin Functions
  • Dashboard as Early Warning System
• 27.2 User Management
  • User Directory & Search
  • Creating User Accounts (Standard Users, Administrators, Veterinarians)
  • Veterinarian Approval Workflow
  • Role Management & Assignment
  • Bulk Operations
  • User Activity & Audit Logs
• 27.3 System Configuration & Maintenance
  • Configuration Management (Animal Types, Permissions, Validation Rules, Medications)
  • System Maintenance Tasks (Location Updates, Database Backup, System Cleanup, Health Checks)
  • Feature Configuration (Managed by Kora Team)
• 27.4 Knowledge API Administration
  • Disease Database Management
  • Explainer Articles & Educational Content
  • Plant Poisoning Information
  • Outbreak Tracking
  • Jurisdiction & Authority Contact Management
  • API Health Monitoring
• 27.5 Security & Audit
  • Understanding Audit Logging
  • Reviewing Audit Logs
  • Monitoring User Activity
  • Security Protocols & Access Control
  • Compliance Documentation
  • Incident Response

PART 7: PRACTICAL GUIDES & BEST PRACTICES

Chapter 28: Common Workflows by Scenario

• 28.0 Common Workflows - Introduction

  • Putting It All Together
  • Integration vs. Repetition
  • Decision Points and Branching
  • Timelines and Coordination
  • Cross-Context Examples
  • Workflow Format Standards
  • Understanding Automatic vs. Manual Actions

• 28.1 Daily Farm Operations

  • Workflow 1: Morning Routine (Location checks, animal counts, quick observations, planning)
  • Workflow 2: Health Check (Systematic assessment, severity evaluation, veterinary escalation)
  • Workflow 3: Treatment Administration (Preparation, execution, documentation, monitoring)
  • Cross-context variations (Dairy, Zoo, Wildlife, Small Farm, Veterinary Practice)

• 28.2 Biosecurity Event Response

  • Workflow 1: Disease Suspected (Detection, diagnosis, automatic response activation)
  • Workflow 2: Quarantine Initiation (Isolation, health monitoring, release protocols)
  • Workflow 3: Contact Tracing (Automatic exposure identification, risk assessment, containment)
  • Workflow 4: Outbreak Management (Multi-property coordination, regulatory oversight)
  • Integration with automatic contact tracing, quarantine recommendations, notifications

• 28.3 Regulatory Compliance

  • Workflow 1: Pre-Export Preparation (Requirements research, testing, quarantine, documentation)
  • Workflow 2: Health Certificate Generation (Veterinary certification, regulatory endorsement)
  • Workflow 3: Movement Documentation (Traceability events, ownership transfer, compliance)
  • Integration with traceability, health history, veterinarian oversight

• 28.4 Conservation Operations

  • Workflow 1: Wildlife Sighting Documentation (GPS-tagged observations, expert verification)
  • Workflow 2: Population Census Operations (Systematic surveys, statistical analysis)
  • Workflow 3: Conservation Breeding Coordination (Genetic management, studbook integration, CITES)
  • Scientific rigor and research integration

• 28.5 Veterinary Consultation

  • Workflow 1: Pre-Visit Preparation (Health history compilation, documentation sharing)
  • Workflow 2: Clinical Examination Documentation (Professional findings, diagnostic assessment)
  • Workflow 3: Treatment Plan Creation (Medical protocols, automated task generation)
  • Workflow 4: Follow-Up Scheduling (Continuity of care, longitudinal monitoring)
  • Integration with Chapter 20 (Veterinarian workflows)

Chapter 29: Best Practices

• 29.0 Best Practices - Introduction

  • Operational Excellence Through Proven Patterns
  • What Are Best Practices?
  • Why Best Practices Matter (Data Quality, Biosecurity, Traceability, Team Collaboration)
  • Best Practice Categories Overview
  • How to Use This Chapter (By User Type)
  • Best Practices vs. Requirements
  • Adapting Best Practices to Your Context
  • Integration with Previous Chapters
  • Metrics for Best Practice Success
  • Continuous Improvement Mindset

• 29.1 Data Quality

  • Accurate GPS Recording (Precision standards, accuracy thresholds, optimal capture conditions, location validation, context-specific standards)
  • Complete Observation Documentation (Required vs optional fields, categories, description quality, severity guidelines, additional notes)
  • Photo Evidence (Photo quality standards, what to photograph, attachment practices, documentation by context)
  • Timely Data Entry (Real-time vs retrospective entry, staleness thresholds, timestamp validation, audit trail requirements, context-specific timeliness)

• 29.2 Biosecurity Excellence

  • Preventive Protocols (Protocol categories, creation standards, execution best practices, compliance tracking)
  • Regular Assessments (Assessment purpose, frequency recommendations, 12-category framework, compliance scoring, critical issues and action items)
  • Visitor Management (Risk-based screening, point-based scoring system, QR code check-in/check-out, manager approval workflows, protocol compliance by risk level)
  • Zone Compliance (Zone definition and security levels, access control enforcement, zone movement tracking, breach prevention and response)

• 29.3 Traceability Compliance

  • Complete Movement Documentation (Required fields, movement validation, transport documentation standards, location validation, third-party documentation)
  • Evidence Attachment (12 document types, photo documentation standards, hash verification and integrity, document metadata best practices, attachment timing)
  • Regular Verification (Hash chain integrity verification, quick vs full verification, verification frequency, compliance scoring and gaps)

• 29.4 Team Collaboration

  • Clear Task Assignment (Assignment patterns: location-based, expertise-based, animal-type, rotation; responsibility delegation, reassignment and workload balancing)
  • Communication Best Practices (Notification types and prioritization, real-time update patterns, group-based notifications, communication workflows)
  • Workflow Standardization (Recurring task templates, template-instance pattern, task category standardization, frequency patterns, consistency metrics)
  • Multi-User Coordination (Access level coordination, concurrent work patterns, conflict prevention mechanisms, team coordination workflows)

Chapter 30: Troubleshooting & FAQs

• 30.1 Common Issues
  • GPS Not Working
  • QR Code Scanning Problems
  • Data Export Issues
  • Map Loading Failures
• 30.2 Frequently Asked Questions
  • By User Type
  • By Feature Area
• 30.3 Getting Help
  • Support Resources
  • Community Forums
  • Documentation

APPENDICES

Appendix A: Glossary of Terms

• Animal Management Terminology
• Biosecurity Terms
• Conservation Terms
• Regulatory & Compliance Terms
• Technical Terms (User-Friendly Definitions)

Appendix B: User Type Reference Matrix

• Feature Access by User Type
• Permission Levels Summary
• Approval Requirements

Appendix C: Country-Specific Compliance

• Australia (NLIS, PIC, LPA, EPBC)
• United States (USDA APHIS)
• European Union (TRACES)
• Kenya (Example)
• [Other Jurisdictions]

Appendix D: Regulatory Standards Reference

• ISO 11784/11785 (RFID Identification)
• ICAR Standards
• WOAH (World Organisation for Animal Health)
• CITES (Endangered Species)

Appendix E: Quick Reference Cards

• GPS Observation Quick Start
• QR Code Check-In Quick Start
• Quarantine Initiation Quick Reference
• Health Certificate Generation Quick Reference
• Emergency Disease Reporting Quick Reference