How frede43/agriktech works
AgriConnect Burundi is a bilingual agricultural marketplace connecting buyers, farmers, delivery workers, and administrators. The principal journey is product discovery and cart checkout, followed by escrow payment, delivery confirmation, and release of funds; supporting branches cover authentication, QR traceability, OBR tax reporting, and rural services. The README documents the frontend/API boundary and major capabilities; the sampled excerpts do not expose most router internals, so uncertain backend calls are omitted.
Main entry points: main.py FastAPI application · api-config.ts API client · LanguageContext.tsx French / Kirundi · page.tsx Marketplace pages
Components 30
User experience
- Marketplace pages
app/produits/page.tsx - Buyer workspace
app/acheteur/page.tsx - Farmer workspace
app/fermier/page.tsx - Delivery workspace
app/logistique/page.tsx - Admin workspace
app/admin/page.tsx - OTP access
app/connexion/page.tsx
Marketplace commerce
- Product catalogue
backend/routers/products.py - Cart validation
backend/routers/cart.py - Orders and escrow
backend/routers/orders.py - Payments
backend/routers/payments.py - Delivery missions
backend/routers/orders.py - QR traceability
app/trace/[token]/page.tsx - Wallet and withdrawals
backend/routers/wallet.py
Platform operations
- OBR tax reporting
backend/routers/obr.py - Co-ops and credit
backend/routers/cooperatives.py - Messaging and disputes
backend/routers/messages.py - Weather and market
backend/routers/weather.py
Shared foundation
- API client
lib/api-config.ts - Offline queue
lib/offline.ts - French / Kirundi
lib/LanguageContext.tsx - FastAPI application
backend/main.py - Application database
backend/database.py - Domain models
backend/models.py
Other components
- Buyer
- Farmer
- Delivery worker
- Administrator
- SMS provider
- Mobile money provider
- Open-Meteo
Connections 32
- Buyer → Marketplace pages: browses
README.md - Buyer → Buyer workspace: manages orders
README.md - Farmer → Farmer workspace: manages sales
README.md - Delivery worker → Delivery workspace: handles missions
README.md - Administrator → Admin workspace: administers platform
README.md - Marketplace pages → API client: fetches catalogue
app/produits/page.tsx - Buyer workspace → API client: fetches data
app/acheteur/page.tsx - Admin workspace → API client: fetches data
app/admin/page.tsx - Delivery workspace → API client: fetches data
app/logistique/page.tsx - OTP access → API client: requests OTP
app/connexion/page.tsx - API client → FastAPI application: calls backend
README.md - FastAPI application → Product catalogue: registers routes
backend/main.py - FastAPI application → Orders and escrow: registers routes
backend/main.py - FastAPI application → Wallet and withdrawals: registers routes
backend/main.py - FastAPI application → Cart validation: registers routes
README.md - FastAPI application → Payments: registers routes
README.md - FastAPI application → OBR tax reporting: registers routes
README.md - FastAPI application → Co-ops and credit: serves capabilities
README.md - FastAPI application → Messaging and disputes: serves capabilities
README.md - FastAPI application → Weather and market: serves forecasts
README.md - QR traceability → API client: loads trace
app/trace/[token]/page.tsx - Offline queue → API client: replays queued products
lib/offline.ts - French / Kirundi → Marketplace pages: provides translations
lib/LanguageContext.tsx - French / Kirundi → Buyer workspace: provides translations
lib/LanguageContext.tsx - French / Kirundi → Admin workspace: provides translations
lib/LanguageContext.tsx - Domain models → Application database: uses database layer
backend/models.py - Delivery missions → Orders and escrow: coordinates delivery
- Orders and escrow → Payments: escrows funds
- Payments → Mobile money provider: charges provider
- OTP access → SMS provider: requests OTP delivery
README.md - Weather and market → Open-Meteo: gets forecasts
README.md - OBR tax reporting → Administrator: reports tax
README.md