🌾 Terra Platform

Real-time agricultural analytics platform for Central Asian farms

---

📖 Overview

Terra Platform is a production-grade web application that provides real-time analytics and monitoring for agricultural enterprises across Kazakhstan and Central Asia.

Farmers and agro-managers get a unified dashboard to track:

• 🌡️ Soil temperature & moisture sensors
• 🌦️ Live weather feeds per field zone
• 📈 Yield prediction models (ML-based)
• 🗺️ Interactive field map (Leaflet.js)
• 📊 Historical trend charts (Recharts)

✨ Features

• Real-time data — WebSocket-powered live sensor feeds
• Role-based access — Farm owner / Field manager / Analyst tiers
• Multi-farm support — Manage hundreds of fields from one dashboard
• Mobile-first — Fully responsive, works on any device
• Export — CSV/PDF reports for any date range
• Internationalization — Russian, Kazakh, English (next-intl)

🛠 Tech Stack

Layer	Technology
Framework	Next.js 14 (App Router)
Language	TypeScript 5
Styling	TailwindCSS + shadcn/ui
State	Zustand + React Query
Database	PostgreSQL 16
ORM	Prisma
Auth	NextAuth.js (JWT)
Charts	Recharts
Maps	Leaflet.js
Realtime	WebSockets (ws)
Deploy	Vercel + Supabase

🚀 Getting Started

# Clone the repo
git clone https://github.com/wpalish/terra-platform.git
cd terra-platform

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local

# Run database migrations
npx prisma migrate dev

# Start development server
npm run dev

Open http://localhost:3000 in your browser.

⚙️ Environment Variables

DATABASE_URL=postgresql://...
NEXTAUTH_SECRET=your-secret
NEXTAUTH_URL=http://localhost:3000
WEATHER_API_KEY=your-key

📁 Project Structure

terra-platform/
├── app/                  # Next.js App Router
│   ├── (auth)/           # Auth routes
│   ├── dashboard/        # Main dashboard
│   ├── fields/           # Field management
│   └── api/              # API routes
├── components/
│   ├── charts/           # Recharts components
│   ├── maps/             # Leaflet map components
│   └── ui/               # shadcn/ui primitives
├── lib/
│   ├── prisma.ts         # DB client
│   ├── auth.ts           # NextAuth config
│   └── websocket.ts      # WS client
├── prisma/
│   └── schema.prisma     # DB schema
└── public/

🗄 Database Schema

model Farm {
  id       String   @id @default(cuid())
  name     String
  location String
  fields   Field[]
  owner    User     @relation(fields: [ownerId], references: [id])
  ownerId  String
}

model Field {
  id        String   @id @default(cuid())
  name      String
  area      Float    // hectares
  crop      String
  sensors   Sensor[]
  farm      Farm     @relation(fields: [farmId], references: [id])
  farmId    String
}

model SensorReading {
  id          String   @id @default(cuid())
  sensorId    String
  temperature Float
  moisture    Float
  timestamp   DateTime @default(now())
}

📄 License

MIT © Алишер Нурсаин

---

_{Built with ❤️ in Astana, Kazakhstan 🇰🇿}