How sonajus007-commits/marutham-agrolink works
Marutham Agrolink is a farm-to-consumer produce marketplace with public shopping and a signed-in operations app. A shopper discovers produce, registers or signs in, places an order, and tracks delivery; farmers manage listings and orders, agents handle delivery, and administrators oversee platform operations. The React app routes users by role to these workflows, while Express exposes API routes backed by Supabase. The README documents additional marketplace capabilities; unsampled route internals are represented at their existing directory paths, with edges limited to documented or indexed relationships.
Main entry points: App.tsx App routes · server.js Express entry · supabase.js Supabase data store · ConsumerPage.tsx Consumer workflow
Components 24
Public marketplace
- Marketplace
apps/shop/app/products/page.tsx - Product detail
apps/shop/app/products/[id]/page.tsx - Shop cart
apps/shop/components/cart/CartProvider.tsx
Signed-in app
- App routes
apps/web/src/App.tsx - Session and roles
apps/web/src/auth/AuthContext.tsx - Consumer workflow
apps/web/src/pages/consumer/ConsumerPage.tsx - Consumer data
apps/web/src/pages/consumer/ConsumerDataContext.tsx - Farmer workflow
apps/web/src/pages/farmer/FarmerPage.tsx - Agent workflow
apps/web/src/pages/agent/AgentPage.tsx - Admin workflow
apps/web/src/pages/admin/AdminPage.tsx
API and access
- Express entry
backend/server.js - Authentication API
backend/routes/auth.js - Authentication middleware
backend/middleware/auth.js - Permission resolution
backend/middleware/permissions.js
Platform operations
- Order API
backend/routes/orders.js - Delivery API
backend/routes/delivery.js - Marketplace APIs
backend/routes - Management APIs
backend/routes/dashboard.js
Shared services
- Typed API client
packages/api-client/src/client.ts - Supabase data store
backend/db/supabase.js
Other components
- Shopper
- Farmer
- Delivery agent
- Administrator
Connections 30
- Shopper → Marketplace: browses
README.md - Marketplace → Product detail: opens products
apps/shop/app/products/page.tsx - Product detail → Shop cart: adds to cart
- Shopper → App routes: opens app
README.md - App routes → Session and roles: provides session
apps/web/src/App.tsx - App routes → Consumer workflow: routes consumer
apps/web/src/App.tsx - App routes → Farmer workflow: routes farmer
apps/web/src/App.tsx - App routes → Agent workflow: routes agent
apps/web/src/App.tsx - App routes → Admin workflow: routes admin
apps/web/src/App.tsx - Consumer workflow → Consumer data: uses data context
apps/web/src/pages/consumer/ConsumerPage.tsx - Consumer workflow → Typed API client: loads marketplace data
- Farmer → Farmer workflow: manages listings
README.md - Delivery agent → Agent workflow: handles deliveries
README.md - Administrator → Admin workflow: oversees platform
README.md - Session and roles → Typed API client: verifies session
apps/web/src/auth/AuthContext.tsx - Typed API client → Express entry: calls API
README.md - Express entry → Authentication API: mounts routes
backend/server.js - Express entry → Order API: mounts routes
backend/server.js - Express entry → Delivery API: mounts routes
backend/server.js - Express entry → Marketplace APIs: mounts routes
backend/server.js - Express entry → Management APIs: mounts routes
backend/server.js - Authentication API → Authentication middleware: guards requests
backend/routes/auth.js - Authentication API → Supabase data store: reads and writes
backend/routes/auth.js - Authentication middleware → Supabase data store: loads user
backend/middleware/auth.js - Authentication middleware → Permission resolution: resolves access
backend/middleware/auth.js - Permission resolution → Supabase data store: loads role rules
backend/middleware/permissions.js - Order API → Supabase data store: persists orders
- Delivery API → Supabase data store: updates delivery
- Marketplace APIs → Supabase data store: serves platform data
backend/routes/auth.js - Management APIs → Supabase data store: queries metrics
backend/routes/dashboard.js