How keiloktql/farmora works
Farmora is an FPO workspace for turning exporter demand into farmer-backed produce deals and tracking them through delivery. The principal workflow runs from buyer discovery or an order book, through contract creation and climate-risk farmer matching, to allocation and season progress. Separate capabilities include the farmer directory, recommendation chat, portfolio overview, and WhatsApp product reels. The README documents the page/runtime structure; source-index references and excerpts support the service links shown. Several page and API implementations were not sampled, so their internal wiring is omitted.
Main entry points: store.ts Contract Store · route.ts Recommendation API · data.ts Climate & Farmer Data · farmer-database.tsx Farmer Directory UI
Components 30
FPO Workspace
- Buyer Network
src/components/pages/buyers.tsx - Overview
src/components/pages/overview.tsx - Farmer Directory UI
src/components/pages/farmer-database.tsx - WhatsApp Reels
src/components/pages/whatsapp.tsx - Portfolio API
src/app/api/portfolio/route.ts - Portfolio Service
src/lib/portfolio.ts - Page Runtime
src/lib/dc.tsx - 3D Farm Scenes
src/lib/voxel.ts
Deal Flow
- Order Book Review
src/components/pages/new-project.tsx - Contracts UI
src/components/pages/contracts.tsx - Contract Farmers
src/components/pages/contracts-farmers.tsx - Buyer API
src/app/api/buyers - Order Book Parser
src/app/api/orderbook/parse/route.ts - Contracts API
src/app/api/contracts - Exporter Network
src/lib/buyers/store.ts - Contract Store
src/lib/contracts/store.ts - Export Standards
src/lib/contracts/standards.ts
Farmer Matching
- Farmer Picking UI
src/components/pages/recommendations.tsx - Recommendation API
src/app/api/recommend/route.ts - Preference Chat API
src/app/api/recommend/interpret/route.ts - Climate & Farmer Data
src/lib/recommender/data.ts - Preference Rules
src/lib/recommender/preferences.ts - Risk Recommender
src/lib/recommender/model.ts - Farmer Directory API
src/app/api/farmers - Farmer Directory Service
src/lib/farmers/directory.ts
Delivery Tracking
- Project Progress UI
src/components/pages/progress.tsx - Progress Reports API
src/app/api/progress - Progress Store
src/lib/progress/store.ts - Crop Season Stages
src/lib/progress/stages.ts
Other components
- FPO Manager
Connections 41
- FPO Manager → Buyer Network: find exporters
README.md - FPO Manager → Order Book Review: review order
README.md - FPO Manager → Farmer Picking UI: pick farmers
README.md - FPO Manager → Farmer Directory UI: browse farmers
README.md - FPO Manager → Overview: monitor deals
README.md - FPO Manager → WhatsApp Reels: view reels
README.md - FPO Manager → Project Progress UI: track projects
README.md - Buyer Network → Buyer API: loads network
- Order Book Review → Order Book Parser: submits order book
- Contracts UI → Contracts API: manages deals
- Order Book Parser → Export Standards: uses standards
src/app/api/orderbook/parse/route.ts - Order Book Parser → Climate & Farmer Data: loads crop data
src/app/api/orderbook/parse/route.ts - Order Book Parser → Contract Store: creates contracts
- Contracts API → Contract Store: reads and writes
src/app/api/contracts/route.ts - Buyer API → Exporter Network: serves exporter data
src/app/api/buyers/route.ts - Exporter Network → Contract Store: creates deals
src/lib/buyers/store.ts - Exporter Network → Climate & Farmer Data: loads capacity data
src/lib/buyers/store.ts - Exporter Network → Risk Recommender: scores capacity
src/lib/buyers/store.ts - Farmer Picking UI → Recommendation API: requests shortlist
- Farmer Picking UI → Preference Chat API: sends chat
- Recommendation API → Contract Store: checks reserved land
src/app/api/recommend/route.ts - Recommendation API → Climate & Farmer Data: loads data
src/app/api/recommend/route.ts - Recommendation API → Preference Rules: sanitizes filters
src/app/api/recommend/route.ts - Recommendation API → Risk Recommender: scores farmers
src/app/api/recommend/route.ts - Preference Chat API → Climate & Farmer Data: loads context
src/app/api/recommend/interpret/route.ts - Preference Chat API → Preference Rules: interprets chat
src/app/api/recommend/interpret/route.ts - Farmer Directory API → Farmer Directory Service: queries farmers
src/app/api/farmers/route.ts - Farmer Directory UI → Farmer Directory API: loads directory
src/components/pages/farmer-database.tsx - Farmer Directory Service → Contract Store: reads commitments
src/lib/farmers/directory.ts - Farmer Directory Service → Climate & Farmer Data: reads farmer data
src/lib/farmers/directory.ts - Farmer Directory Service → Risk Recommender: computes climate risk
src/lib/farmers/directory.ts - Portfolio API → Portfolio Service: requests summary
src/app/api/portfolio/route.ts - Portfolio Service → Contract Store: reads contracts
src/lib/portfolio.ts - Progress Reports API → Progress Store: reads and records
src/app/api/progress/reports/route.ts - Progress Store → Contract Store: loads allocations
src/lib/progress/store.ts - Progress Store → Crop Season Stages: uses season stages
src/lib/progress/store.ts - Project Progress UI → Progress Reports API: loads progress
- Overview → Page Runtime: runs in
src/components/pages/overview.tsx - Farmer Directory UI → Page Runtime: runs in
src/components/pages/farmer-database.tsx - Farmer Picking UI → Page Runtime: runs in
src/components/pages/recommendations.tsx - Farmer Directory UI → 3D Farm Scenes: renders scene
src/components/pages/farmer-database.tsx