JosueTW/tfa-farm-os-mvp

TFA Farm OS - Agricultural operations management platform for TerraFerm Africa # TFA Farm Operating System (FOS) - MVP > **"Your boss is data"** — Building TerraFerm Africa's AI-powered farm operations digital twin ## 🎯 Quick Start ```bash # Clone and install git clone cd tfa-farm-os npm install # Setup environment cp .env.example .env.local # Edit .env.local with your Supabase + API keys # Initialize database npm run db:setup # Run development server npm run dev # Deploy (Vercel) npx vercel ``` ## 📁 Project Structure ``` tfa-farm-os/ ├── app/ # Next.js 14 App Router │ ├── (dashboard)/ # Dashboard routes │ │ ├── layout.tsx # Dashboard shell │ │ ├── page.tsx # Operations overview │ │ ├── plots/ # Plot management │ │ ├── activities/ # Activity logs │ │ ├── alerts/ # Alert center │ │ └── reports/ # Reports & analytics │ ├── api/ # API routes (serverless) │ │ ├── activities/ # Activity CRUD │ │ ├── plots/ # Plot management │ │ ├── ai/ # Claude AI processing │ │ ├── webhooks/ # External integrations │ │ └── dashboard/ # Dashboard data │ ├── field/ # Field worker PWA │ │ ├── layout.tsx # Mobile-optimized layout │ │ ├── page.tsx # Daily check-in │ │ └── tasks/ # Task management │ ├── globals.css # Tailwind + custom styles │ └── layout.tsx # Root layout ├── components/ # React components │ ├── ui/ # shadcn/ui components │ ├── dashboard/ # Dashboard-specific │ │ ├── KPICard.tsx # Metric cards │ │ ├── AlertBanner.tsx # Alert display │ │ ├── ActivityTimeline.tsx # Activity feed │ │ └── MapView.tsx # Mapbox integration │ ├── field/ # Field app components │ │ ├── VoiceRecorde …