Operations Manual

Sign in (email/password, Google OTP).

Create account; email+password, then OTP verification.

User

Onboarding

Request password reset email.

Set new password via token.

Pick role(s) + country after first sign-in.

User (user_role, additional_roles, country)

Submit identity documents for verification.

User (kyc fields)

KYC review by Compliance/HR/Country Director/Super

KYC approved/rejected

Account preferences.

Reputation profile (public view at /profile/:id).

Role-adaptive stats, quick-access hubs, weather, command link.

Unified service discovery grid for all AgriLink services.

Global marketplace search.

Browse produce listings; filter by category/location/grade.

Product (read)

View a listing; buy a quantity via card/EcoCash/Zimswitch.

quantity

Order, EscrowTransaction, Base44Purchase|EcoCashPayment|ZimswitchPayment

Payment -> escrow funded -> Order pending/confirmed

order_created, payment status

Create a produce listing.

title, price, qty, unit, images, location, grade, organic

Product

active listing

My listings; edit/suspend/delete.

Product

Farmers see sales; buyers see purchases. Confirm, assign transporter, cancel.

Order, EscrowTransaction

confirmed -> awaiting_pickup -> in_transit -> delivered

order status changes

Live delivery tracking timeline + collection confirmation.

TransportJob, Order

List auction-eligible produce; browse live/scheduled auctions.

Auction

Place a bid; view high bid.

bid amount

Bid

active -> outbid/won/lost; auction -> ended

outbid (note: known gap — see Help register)

Buyer posts what they need; browse notices.

BuyNotice

Create a buy notice.

BuyNotice

Farmer responds with offer; buyer accepts a response to create an Order.

BuyNoticeResponse, Order

submitted -> accepted/declined/withdrawn

Browse seeds, seedlings, saplings, cuttings, tubers.

SeedListing

Nursery directory.

Nursery

Nursery detail + stock.

Store owner manages nursery profile + seed listings.

Nursery, SeedListing

Buy/list fertilizers, pesticides, tools, irrigation, feed.

SupplyProduct

Buyer views their input orders.

InputOrder

Supplier fulfils input orders.

InputOrder, FarmInput

delivered -> linked to farm

Store owner dashboard: listings, supply, nursery, analytics, low-stock alerts.

SupplyProduct, SeedListing, Nursery

Store performance insights.

Transporters browse/claim open jobs; shippers post jobs.

TransportJob

open -> assigned -> in_transit -> delivered

Shipper posts a shipment (pickup, delivery, weight, budget, dates).

commodity, route, weight, budget, dates

TransportJob

Job detail; transporter claims/assigns; collection confirmation with photos.

TransportJob, AccountTransaction

assigned -> in_transit -> delivered

Past transport jobs.

Deterministic step-flow cost calculator for transporters using vehicle + configurable defaults.

TransportQuote, TransporterDefaults

draft -> submitted -> (archived)

Transporter fleet; add/edit vehicles, docs, maintenance.

Vehicle, VehicleDocument, VehicleMaintenance

Vehicle detail; documents, maintenance log, status.

Vehicle

Role-scoped accounting (business_type=transport); income/expense ledger, cash flow.

AccountTransaction (business_type=transport)

Browse/list equipment to rent; initiate hire + prepare agreement.

EquipmentRental

Create an equipment rental listing.

EquipmentRental

Hirer requests equipment.

EquipmentHireRequest

open -> fulfilled -> returned | closed | expired

Owner reviews hire requests + offers.

EquipmentHireRequest

Buy/sell used tractors, implements.

UsedEquipment

List used equipment for sale.

UsedEquipment

My equipment sales.

Machinery owners manage fleet, hires, job requests; farmers request machinery.

MachineryServiceRequest

request -> quoted -> accepted -> completed

Farmer creates a machinery service request.

MachineryServiceRequest

Browse drone operators; request missions; operators manage inbox.

DroneMission

requested -> approved -> in_progress -> completed

Directory of specialist services.

SpecialistService

Create a specialist service listing.

SpecialistService

Specialist detail + book for a date.

SpecialistBooking

Specialist manages bookings.

SpecialistBooking

Specialist client roster.

Browse/list warehouses; book storage (capacity visualised).

Warehouse, WarehouseBooking

booking -> active -> completed

Browse loan providers.

LoanProduct

Apply for credit; view my loans.

Loan

applied -> under review -> approved/rejected -> disbursed

Lender manages loan applications.

Browse insurance products; take a policy.

InsuranceProduct, InsurancePolicy

Insurer manages policies.

Protected payments: buyer confirms satisfactory completion + review to authorise settlement preparation; parties track Accounts, provider-confirmation, reconciliation, dispute and refund states.

EscrowTransaction, SettlementInstruction, Review

created -> funded -> settlement_prepared -> settlement_verified -> settlement_approved -> payout_pending -> provider_confirmed -> settled

settlement preparation/provider confirmation/reconciliation, dispute/refund, review posted

All payments (card, EcoCash, Zimswitch).

Base44Purchase, EcoCashPayment, ZimswitchPayment

Public post-checkout return page.

Public Zimswitch payment result page.

Farm -> Enterprise -> Production Cycle hierarchy; fields, tasks, inputs, pest scouting, harvest.

FarmProfile, Enterprise, Field, ProductionCycle, FarmTask, FarmInput, PestScoutLog, HarvestRecord

Farmer groups, produce aggregation, pooled input demand, shared machinery and compatible load consolidation. Non-financial coordination only while payment activation is deferred.

FarmerGroup, GroupMember, AggregationCampaign, MemberContribution, AggregatedLot, GroupProcurementRequest, GroupProcurementMember, MachineryDemandCluster, MachineryDemandMember, ConsolidatedLoad, LoadConsignment, CollectiveActionEvent

consent -> group participation -> collective opportunity -> fulfilment planning -> awaiting financial activation where applicable

Income/expense ledger (business_type=farm), cash flow, category breakdown, allocations.

AccountTransaction

Farm analytics.

Yield, variety performance, quality trends, regional production, profit calculator.

Plan future harvest sales; buyers place forward bids.

ForwardPlan, ForwardBid

plan -> bid -> confirmed/rejected

Create a forward plan.

ForwardPlan

Forward plan detail + bids.

Buyer-grower grow contracts; supply register + agronomist reports.

ContractFarming, ContractSupply, AgronomistReport

pending_acceptance -> active -> completed

Create a contract farming agreement.

ContractFarming

Contract farming detail.

My contracts (all levels); filter by status.

Contract

Agreement detail: review markdown, sign (draw/type/click), PDF, integrity, condition reports, audit, dispute.

Contract, ContractSignature, ConditionReport

awaiting signatures -> fully_signed -> active -> completed

Generate-or-open contract gate for a transaction.

Contract

Legal manage country/type templates + lifecycle.

ContractTemplate

draft -> legal_review -> approved -> active -> superseded/archived

Printable register of all contracts.

Country x type template approval matrix (prevent cross-jurisdiction misuse).

Contracts requiring legal review; approve/reject/escalate.

Contract (legal_review_status)

pending -> approved/rejected/escalated

Legal/Admin CRUD over requirement rules (type x country x value/duration/risk -> level).

ContractRequirementRule

Level 1 terms acceptance audit log.

TermsAcceptance

Resolve required level for a transaction; L1 accept / L2-L3 route to agreement.

TermsAcceptance

Manage currencies, exchange rates, country configuration.

Currency, ExchangeRate, CountryConfiguration

Manage languages + interface/content translations.

Language, InterfaceTranslation, ContentTranslation, TranslationChangeLog

Download PDF reports.

Produce acceptance report.

Adjudicate disputes (order, escrow, transport, auction, specialist).

Dispute

open -> acknowledged -> investigating -> mediating -> resolved_buyer/seller/refund -> closed

Chat with counterparties.

DirectMessage, ChatConversation

Platform alerts.

Notification

Command Centre: Users, Finance, Operations, Messages, Disputes, Revenue tabs.

User, EscrowTransaction, PlatformSettings, AdministrativeAuditLog

Global operations centre (orders, transport, listings moderation).

View/edit role-permission matrix.

Permissions matrix overview.

Administrative audit trail.

AdministrativeAuditLog

User role-change requests.

RoleChangeRequest

Legal command centre: templates, register, coverage matrix, review queue, rules.

CFO command centre: escrow, revenue, currency, reports.

Ask an Expert (AI) — general advisory.

Diagnose crop pest/disease by photo or text (AI).

CropDiagnosis

AI agronomy recommendations.

Farming reference articles.

Farm tasks + key dates.

Weather + agricultural alerts for your country.

WeatherAlert

Help centre: AI assistant, user guide, admin manual download.

Browsable Operations Manual: the six registers.