LivestockWay Documentation

Complete reference for developers, users, and administrators

📖 Documentation Status

Last Updated: March 27, 2026 • Completeness: 95%

All user manuals created and available. Technical architecture documentation in place. Content management guides included.

🔧 Technical Documentation

For developers, architects, and engineering teams.

Architecture

📐Technical Module Architecture

Complete module-level breakdown of backend API (28 routes, 15 services), frontend components (61 pages), mobile app architecture, database schema, real-time messaging, and payment flows.

View Architecture →

✓ Complete

API Reference

🔌API Endpoints Reference

Detailed endpoint documentation with request/response samples, authentication, rate limiting, and error codes. Auto-generated from OpenAPI/Swagger.

⏳ Coming Soon — Generate from backend JSDoc/OpenAPI

❌ Not Created
Database

🗄️Database Schema Reference

Complete ERD diagram, table definitions, relationships, indexes, migration history, and query optimization guide.

⏳ Coming Soon — Generate from migrations

❌ Not Created

👥 User Manuals

Role-specific guides with step-by-step instructions and best practices.

Hauler

🚛Hauler User Manual

Complete guide for livestock transporters: signup, fleet setup, finding loads, bidding, contracts, trip execution, proof of delivery, earnings, and payouts.

Read Manual →

✓ Complete

Shipper

📦Shipper User Manual

Complete guide for livestock owners: signup, posting loads, negotiating with haulers, contract creation, escrow payments, shipment tracking, delivery confirmation, and dispute handling.

Read Manual →

✓ Complete

Driver

👨‍💼Driver User Manual

Quick guide for drivers: account activation, dashboard, viewing trips, starting trips, GPS tracking, pickup/delivery process, and logging expenses.

Read Manual →

✓ Complete

Stakeholder

🏥Stakeholder User Manual

Guide for vets, insurance providers, and service providers: posting services, managing bookings, payments, and communication.

⏳ Coming Soon

❌ Not Created

⚙️ Admin & Operations

For platform administrators and operations teams.

Admin

🛡️Super Admin Manual

Complete admin guide: user management, pricing configuration, subscription management, dispute resolution, financial monitoring, settlements, support tickets, content management, and reporting.

Read Manual →

✓ Complete

Operations

📊Operations Runbook

Daily/weekly/monthly operations checklist, monitoring, incident response, scaling procedures, and disaster recovery.

⏳ Coming Soon

❌ Not Created
Compliance

📋Compliance & Audit Guide

Regulatory requirements, audit logging, data privacy (GDPR/CCPA), and livestock welfare regulations enforcement.

⏳ Coming Soon

❌ Not Created

📚 Project Documentation

High-level project context and workflows (already in repo root).

Existing

🎯PROJECT_CONTEXT.md

Complete project overview covering all 4 codebases, tech stacks, user roles, features, deployment, environment setup, and current state. 200+ lines of detailed reference.

✓ Exists

Existing

🔄WORKFLOW.md

End-to-end workflows from signup → payment → delivery. Complete lifecycle documentation with diagram and money flow illustration.

✓ Exists

Existing

📱AGENT_AND_DRIVER_APP_OVERVIEW.md

Driver app integration guide and mobile app alignment plan with backend APIs, workflow mapping, and implementation phases.

✓ Exists

Existing

🤖AI_VISION.md

AI/ML strategy: LivestockLM language model, animal behavior detection, route optimization, demand forecasting, computer vision, and predictive maintenance.

✓ Exists

📋 Documentation Summary

Document Format Target Audience Status Location
Technical Module Architecture HTML (interactive) Developers, Architects ✓ Complete /docs/technical-architecture.html
Hauler User Manual HTML (printable) Hauler Users ✓ Complete /docs/user-manual-hauler.html
Shipper User Manual HTML (printable) Shipper Users ✓ Complete /docs/user-manual-shipper.html
Driver User Manual HTML (printable) Driver Users ✓ Complete /docs/user-manual-driver.html
Super Admin Manual HTML (printable) Admin Users ✓ Complete /docs/user-manual-admin.html
API Endpoints Reference HTML / Swagger Developers ❌ Pending
Database Schema Reference HTML / ERD DBAs, Developers ❌ Pending
Stakeholder User Manual HTML (printable) Stakeholder Users ❌ Pending
Operations Runbook HTML / Markdown Operations Team ❌ Pending
Compliance & Audit Guide HTML / Markdown Compliance, Legal ❌ Pending
PROJECT_CONTEXT.md (Existing) Markdown All Teams ✓ Complete /PROJECT_CONTEXT.md
WORKFLOW.md (Existing) Markdown All Teams ✓ Complete /WORKFLOW.md
AGENT_AND_DRIVER_APP_OVERVIEW.md (Existing) Markdown Mobile Devs ✓ Complete /AGENT_AND_DRIVER_APP_OVERVIEW.md
AI_VISION.md (Existing) Markdown Architects, AI/ML ✓ Complete /AI_VISION.md

🔗 Quick Navigation

👤 For Users

🛠️ For Developers

🛡️ For Admin