0fcc2763fe
This commit introduces a complete transparency infrastructure including: Core Transparency Modules: - AuditLog: Immutable, cryptographically-linked audit trail for all actions - EventStream: Real-time SSE streaming and webhook support - TransparencyDashboard: Aggregated metrics and system health monitoring - DigitalSignatures: Cryptographic verification for handoffs and certificates API Endpoints: - /api/transparency/dashboard - Full platform metrics - /api/transparency/audit - Query and log audit entries - /api/transparency/events - SSE stream and event history - /api/transparency/webhooks - Webhook management - /api/transparency/signatures - Digital signature operations - /api/transparency/certificate/[plantId] - Plant authenticity certificates - /api/transparency/export - Multi-format data export - /api/transparency/report - Compliance reporting - /api/transparency/health - System health checks Features: - Immutable audit logging with chain integrity verification - Real-time event streaming via Server-Sent Events - Webhook support with HMAC signature verification - Digital signatures for transport handoffs and ownership transfers - Certificate of Authenticity generation for plants - Multi-format data export (JSON, CSV, summary) - Public transparency portal at /transparency - System health monitoring for all components Documentation: - Comprehensive TRANSPARENCY.md guide with API examples |
||
|---|---|---|
| .. | ||
| api | ||
| architecture | ||
| concepts | ||
| examples | ||
| guides | ||
| vertical-farming | ||
| AGENTS.md | ||
| README.md | ||
| TRANSPARENCY.md | ||
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
- Seed-to-Seed Transport System
- Blockchain Architecture
- Demand Forecasting
- Seasonal Planning
- Carbon Footprint Tracking
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.