Your Administrative Command Centre

The Admin Dashboard is your first stop when managing your organisation's Kora instance. It provides at-a-glance visibility into system health, user activity, animal population, Knowledge API status, and quick access to all administrative functions.

Access the Admin Dashboard at /Admin in your Kora instance. Only users with SuperUser role can see and access this panel.

Dashboard Statistics

The dashboard displays four key statistics providing instant insight into your organisation's Kora deployment:

Active Users

What It Shows: Total number of user accounts currently active in your instance.

What It Means:

• Users who have been created and have active access
• Includes all user types: standard users, veterinarians, regulators, other SuperUsers
• Does not include locked or disabled accounts
• Does not include deleted users

Why It Matters:

• Understand how many people are using your Kora instance
• Monitor growth as your organisation expands
• Identify when user counts approach licence limits (if applicable)
• Assess training and support needs based on user population

Example Interpretation:

• "85 active users" equals 85 people with Kora access in your organisation
• Significant increase: Recent hiring, new facility onboarded, or expanded operations
• Unexpected decrease: Accounts were deactivated (check user management for details)

Animals Managed

What It Shows: Total count of animals currently tracked in your instance.

What It Means:

• Individual animals with complete records
• Animal mobs (groups) counted collectively
• Active animals across all locations in your organisation
• Does not include deceased animals or deleted records

Why It Matters:

• Quick view of operational scale
• Monitor population changes over time
• Understand data volume and system load
• Assess whether system configuration matches current animal populations

Example Interpretation:

• "2,450 animals managed" means your organisation tracks 2,450 animals across all locations
• Large increase: Breeding season, new acquisitions, facility expansion
• Decrease: Sales, mortalities, relocations to other facilities
• Stable count: Consistent herd/flock size, steady-state operations

Note: Animal mobs are counted as single units. A mob of 500 cattle appears as "1" in mob count but represents 500 animals operationally. Dashboard shows individual animals plus mobs, not total animal heads.

Knowledge API Status

What It Shows: Health status of the disease knowledge database powering the Knowledge Hub (Chapter 4).

What It Means:

• Healthy: Knowledge API is accessible, disease database is current, emergency contacts available
• Degraded: Partial functionality, some features unavailable, performance issues
• Unavailable: Knowledge API is down, users cannot access disease information or emergency contacts

Why It Matters:

• Users rely on Knowledge Hub for disease information during emergencies
• Veterinarians need access to disease profiles for clinical observations
• Authority contacts must be available during disease outbreaks
• System integration (contact tracing, quarantine calculation) depends on Knowledge API

What to Do:

• Healthy: No action needed, Knowledge Hub is fully operational
• Degraded/Unavailable: Contact Kora support team or check with your technical team if self-hosted

Example Interpretation:

• "Healthy" means all users can access disease information normally
• "Unavailable" is urgent. Users cannot search diseases or access emergency contacts during potential outbreak

System Health

What It Shows: Overall health status of your Kora instance.

What It Means:

• Database connectivity and performance
• System responsiveness and availability
• Background services operating normally
• Recent backup status

Indicators:

• Healthy: All systems operational, normal performance
• Warning: Minor issues detected, functionality intact but monitoring needed
• Critical: Significant issues requiring immediate attention

What to Do:

• Healthy: Normal operations, continue regular maintenance schedule
• Warning: Review system health details, schedule maintenance if needed
• Critical: Immediate investigation required, contact technical team or Kora support

Navigation to Admin Functions

The dashboard provides quick access to three primary administrative areas:

User Management

Access: Click "User Management" card on dashboard or navigate to /Admin/Users

What You Can Do:

• View directory of all users in your organisation
• Create new user accounts (administrators, veterinarians, standard users)
• Approve veterinarian applications
• Assign and modify user roles
• Manage permissions and access levels
• Perform bulk operations (role assignments, account updates)
• Review user activity and audit logs

When to Use:

• Onboarding new staff or service providers
• Processing veterinarian credential applications
• Adjusting access when roles change
• Investigating user activity during audits
• Removing access when users leave organisation

Reference: See Chapter 27.2 for detailed user management guidance.

Knowledge API Management

Access: Click "Knowledge API" card on dashboard or navigate to /Admin/KnowledgeAPI

What You Can Do:

• Manage disease database (add, edit, review disease profiles)
• Maintain explainer articles (educational content about disease concepts)
• Update plant poisoning information
• Track and record outbreaks in your region
• Manage jurisdiction information
• Update authority emergency contacts

When to Use:

• New diseases emerge requiring documentation
• Outbreaks occur in your region
• Regulatory contacts change (new phone numbers, updated agencies)
• Expanding operations to new jurisdictions
• Educational content needs updates or additions

Context: Knowledge API administration maintains the disease intelligence system that all users access through the Knowledge Hub (Chapter 4). When you add a disease here, all users can search for it. When you update emergency contacts, they're immediately available to users during disease crises.

Reference: See Chapter 27.4 for Knowledge API administration details.

System Tasks

Access: Click "System Tasks" card on dashboard or navigate to /Admin/Tasks

What You Can Do:

• Create administrator and veterinarian accounts
• Manage system configurations (animal types, permissions, validation rules, medications)
• Perform maintenance tasks (location updates, database backups, system cleanup)
• Run health checks and diagnostics

When to Use:

• Adding new animal types to your operations
• Updating organisational configurations
• Performing routine maintenance
• Troubleshooting system issues
• Preparing for backups before major changes

Reference: See Chapter 27.3 for system configuration and maintenance guidance.

Understanding Dashboard Trends

User Growth Patterns

Gradual Increase (Expected):

• Organisation hiring, expanding operations
• Onboarding contractors or consultants
• Adding service providers (veterinarians, nutritionists)

Sudden Spike (Investigate):

• Large onboarding event (new facility, training programme)
• Bulk user creation (verify all are legitimate)
• System migration (importing historical users)

Decrease (Investigate):

• Users leaving organisation (expected if known)
• Accounts deactivated (verify appropriateness)
• Bulk deletion (check audit logs for who and why)

Animal Population Trends

Seasonal Patterns (Expected):

• Breeding season increases (spring lambing, calving)
• Sales or slaughter decreases (harvest seasons)
• Wildlife seasonal migrations (conservation contexts)

Operational Changes:

• New facility acquisition (population increase)
• Herd expansion or reduction (business decisions)
• Species additions (diversified operations)

Data Quality Issues (Investigate):

• Sudden unexplained population changes
• Mismatched expectations (you think you have 500 cattle, system shows 450)
• Indicates data entry errors, incomplete records, or synchronisation issues

Knowledge API Health Patterns

Consistent Healthy (Expected):

• Normal operations, disease information available
• Users accessing Knowledge Hub without issues

Intermittent Unavailability (Investigate):

• Network connectivity issues
• Self-hosted infrastructure problems
• Scheduled maintenance (if known)

Persistent Unavailability (Urgent):

• Critical infrastructure failure
• Database corruption
• Contact Kora support or technical team immediately

Dashboard as Early Warning System

The Admin Dashboard serves as an early warning system for organisational and system issues:

Warning Sign: User Count Doesn't Match Expectations

Scenario: Dashboard shows 120 users, but you expected approximately 80.

Investigate:

• Review user directory for unexpected accounts
• Check recent user creation in audit logs
• Verify all accounts are legitimate (no unauthorised access)
• Identify if bulk onboarding occurred without your knowledge

Possible Causes:

• Legitimate growth you weren't tracking
• Another SuperUser created accounts
• Imported users from another system
• Security issue (unauthorised account creation)

Warning Sign: Animal Count Dramatically Different

Scenario: Dashboard shows 850 animals, but operational records indicate approximately 1,200.

Investigate:

• Data entry gaps (animals not recorded in Kora)
• Mob vs. individual counting confusion
• Recent bulk deletions or archive operations
• Import errors from other systems

Possible Causes:

• Incomplete data migration
• Mobs not yet created for group-managed animals
• Records archived or soft-deleted unintentionally
• Synchronisation issues with external systems

Warning Sign: Knowledge API Unavailable

Scenario: Knowledge API status shows "Unavailable" during normal operations.

Immediate Impact:

• Users cannot search diseases
• Veterinarians cannot access disease profiles for diagnoses
• Emergency contacts unavailable during potential outbreaks
• Contact tracing and quarantine calculations non-functional

Urgent Action Required:

• Notify users of temporary Knowledge Hub unavailability
• Contact technical team or Kora support
• Check self-hosted infrastructure if applicable
• Provide alternative disease information resources temporarily

Regular Dashboard Review

Recommended Frequency:

Daily (Quick Check - 2 minutes):

• System Health status
• Knowledge API availability
• Any unusual statistics changes

Weekly (Detailed Review - 10 minutes):

• User count trends
• Animal population changes
• Knowledge API health patterns
• Plan upcoming administrative tasks

Monthly (Comprehensive Analysis - 30 minutes):

• User growth patterns and role distribution
• Animal population trends and data quality
• System performance and health history
• Audit log review for compliance and security
• Knowledge API content updates needed

Desktop vs Mobile Dashboard Access

Desktop Dashboard:

• Full statistics visibility
• Detailed navigation
• Multi-function workflows (switching between admin areas)
• Extended audit review
• Comprehensive system analysis

Mobile Dashboard:

• Quick health checks while away from desk
• Emergency statistics review
• Access to urgent admin functions (user creation, urgent updates)
• Limited detailed analysis

Recommendation: Primary dashboard reviews on desktop for comprehensive visibility and multi-tasking. Mobile for emergency checks and urgent administrative needs.

Common Dashboard Workflows

Workflow 1: Daily Morning Check

Purpose: Ensure system operational health before staff begin daily work

Steps:

1. Access Admin Dashboard (/Admin)
2. Check System Health (should be "Healthy")
3. Verify Knowledge API Status (should be "Healthy")
4. Note any unusual statistics changes
5. If all green, proceed with operational work
6. If issues detected, investigate before staff encounter problems

Time Required: 2 minutes

Workflow 2: Monthly Administrative Planning

Purpose: Plan upcoming administrative tasks based on organisational trends

Steps:

1. Access Admin Dashboard
2. Review user count trends (plan for onboarding or offboarding)
3. Review animal population trends (assess system capacity)
4. Navigate to User Management to see pending approvals
5. Navigate to Knowledge API to identify content needing updates
6. Navigate to System Tasks to schedule maintenance
7. Create task list for the month based on findings

Time Required: 30 minutes

Workflow 3: Pre-Audit Review

Purpose: Prepare for regulatory audit or compliance review

Steps:

1. Access Admin Dashboard
2. Note current user count and animal population for audit report
3. Verify Knowledge API is operational (auditors may access disease info)
4. Verify System Health is optimal
5. Navigate to User Management to review user roles and access
6. Navigate to Security & Audit to prepare audit log reports
7. Document current state for audit documentation

Time Required: 1 hour

Workflow 4: Incident Response

Purpose: Respond to system health alert or unexpected issue

Steps:

1. Access Admin Dashboard immediately
2. Check System Health status for details
3. Check Knowledge API status (critical for disease emergencies)
4. Review recent user activity (security incidents)
5. Navigate to System Tasks for diagnostics
6. Contact technical team or Kora support with specific details
7. Document incident and response in organisational records

Time Required: Variable (15 minutes to several hours depending on severity)

Integration with Other Admin Functions

The Admin Dashboard is your entry point, but administrative work happens in specialised sections:

User Management (27.2) - Detailed user administration, role assignment, credential verification, activity monitoring

System Configuration & Maintenance (27.3) - Animal type configs, organisational settings, maintenance tasks, health diagnostics

Knowledge API Administration (27.4) - Disease database, explainers, outbreak tracking, emergency contacts

Security & Audit (27.5) - Comprehensive audit logs, security monitoring, compliance documentation, incident investigation

The dashboard directs you to these sections based on what needs attention. Use it as your daily starting point and navigation hub for all administrative work.