AgriPoint

Installation

Run

npm install

Then:

npm run generate-cert

{{BASE_URL}}/api

User Authentication

• POST: /auth/register
• POST: /auth/login

interface User {
firstName string;
lastName: string;
middleName?: string;
phoneNumber: string;
nin: string
}

users (collections)

Farmers Onboarding

Registers Farmers details and initiate verification

• POST: /farmers

  {
    status: "pending" | "verified" | "rejected";
  }

Produce Losting

Action: List produce(quantity,price,harvest date, e.t.c)

• POST: /farmers/list-produce

Demand Side Flow (Buyer Ordering)

Buyers use the marketplace to find and purchase listed produce.

• 1. Browsing & Selection: User: Buyer (via Buyer catalog page). Action: Views available produce listings. API Route: GET/produce
• 2. Order Placement: User: Buyer (via Cart & checkout). Action: Creates an order. API Route: POST/orders Database Impact: orders tables

Logistics & Fulfillment Flow

The system matches the order with a transporter, initiating the delivery.

• 1. Logistics Matching: System Action: Logistics matching system assigns the order to an available Logistics Provider. API Route: POST/logistics/assign Database Impact: logistics table, notifications table.
• 2. Delivery Execution: User: Logistics Provider (via Driver delivery - flow). Action: Picks up produce from Farmer and delivers to Buyer.

Finalization & Oversight

The system tracks the payment and Admin monitors the entire operation.

• 1. Transaction Tracking: System Action: Finalizes the sale and applies the Commission per transaction (3-8%) and Logistics fees. Action: Transaction tracking. Database Impact: transactions table.
• 2. Admin Oversight: User: Admin (via Admin dashboard/Admin control center). Action: Monitors all system activity, revenue, and logistics status. API Route: GET/admin/overview