localgreenchain/docs
Claude 3d2ccdc29a
feat(db): implement PostgreSQL database integration with Prisma ORM
Agent 2 - Database Integration (P0 Critical):

- Add Prisma ORM with PostgreSQL for persistent data storage
- Create comprehensive database schema with 20+ models:
  - User & authentication models
  - Plant & lineage tracking
  - Transport events & supply chain
  - Vertical farming (farms, zones, batches, recipes)
  - Demand & market matching
  - Audit logging & blockchain storage

- Implement complete database service layer (lib/db/):
  - users.ts: User CRUD with search and stats
  - plants.ts: Plant operations with lineage tracking
  - transport.ts: Transport events and carbon tracking
  - farms.ts: Vertical farm and crop batch management
  - demand.ts: Consumer preferences and market matching
  - audit.ts: Audit logging and blockchain integrity

- Add PlantChainDB for database-backed blockchain
- Create development seed script with sample data
- Add database documentation (docs/DATABASE.md)
- Update package.json with Prisma dependencies and scripts

This provides the foundation for all other agents to build upon
with persistent, scalable data storage.
2025-11-23 03:56:40 +00:00
..
api Add complete documentation suite for LocalGreenChain 2025-11-22 18:48:42 +00:00
architecture Add complete documentation suite for LocalGreenChain 2025-11-22 18:48:42 +00:00
concepts Add complete documentation suite for LocalGreenChain 2025-11-22 18:48:42 +00:00
examples Add complete documentation suite for LocalGreenChain 2025-11-22 18:48:42 +00:00
guides Add complete documentation suite for LocalGreenChain 2025-11-22 18:48:42 +00:00
vertical-farming Add complete documentation suite for LocalGreenChain 2025-11-22 18:48:42 +00:00
AGENTS.md Add comprehensive 10-agent autonomous system for LocalGreenChain 2025-11-22 21:24:40 +00:00
DATABASE.md feat(db): implement PostgreSQL database integration with Prisma ORM 2025-11-23 03:56:40 +00:00
README.md Add seed-to-seed transport tracking, demand forecasting, and vertical farming systems 2025-11-22 18:23:08 +00:00
TRANSPARENCY.md Add comprehensive transparency system for LocalGreenChain 2025-11-23 03:29:56 +00:00

LocalGreenChain Documentation

A demand-driven, seasonal agriculture platform leveraging blockchain technology to track plant lineage from seed-to-seed while reducing the global footprint of human consumption.

Vision

LocalGreenChain transforms agriculture by enabling:

  • Demand-Driven Production: Grow what consumers need, when they need it
  • Seasonal Optimization: Align production with natural growing cycles
  • Footprint Reduction: Minimize transportation, waste, and resource consumption
  • Complete Traceability: Track every plant from seed origin to harvest and back to seed

Documentation Index

Getting Started

Core Concepts

Architecture

Vertical Farming

API Reference

Guides

Project Goals

Environmental Impact Reduction

Traditional Supply Chain:
[Seed] → [Farm] → [Processor] → [Distributor] → [Retailer] → [Consumer]
         ↓         ↓              ↓              ↓
       Waste     Transport      Storage        Spoilage
       (30%)     Emissions      Energy         (15%)
LocalGreenChain Model:
[Seed] ← → [Local Grower] ← → [Consumer]
            ↓
     [Vertical Farm]
            ↓
    Demand-Optimized
    Zero-Waste Cycle

Key Metrics We Track

Metric Traditional LocalGreenChain Target
Food Miles 1,500+ avg < 50 miles
Spoilage Rate 30-40% < 5%
Carbon/lb 2.5 kg CO2 0.3 kg CO2
Water Usage 100% 10% (vertical)
Pesticide Use Variable Zero (controlled)

Technology Stack

  • Runtime: Bun (fast JavaScript runtime)
  • Frontend: Next.js, React, TypeScript, Tailwind CSS
  • Blockchain: Custom proof-of-work implementation
  • Transport Tracking: GPS integration, QR code scanning
  • Demand Engine: Machine learning forecasting
  • Vertical Farming: IoT sensor integration, automation APIs

Contributing

See CONTRIBUTING.md for guidelines on contributing to LocalGreenChain.

License

MIT License - see LICENSE for details.