Mercotrace Directory · Commercial Proposal

COMMERCIAL PROPOSAL · V1.0

Mercotrace
Directory (Customer App)

Consumer-facing Customer App connecting Buyers, Sellers, Brokers and Business Entities — with Dashboards, Directory discovery, GPS for Business Registrations, Notification Module, Profile & Settings, Broker Bill, Admin Panel and Client AWS Deployment. Priority 1 delivery — 7 weeks in parallel across web, Android, iOS and Spring Boot (13 Jul 2026 – 30 Aug 2026).

Person-Weeks

Weeks Delivery

Team Members

~12.5

Person-Months

Project Deliverables

React.js Customer Web Application
Android Customer App (React Native with Capacitor)
iOS Customer App (React Native with Capacitor)
Java Spring Boot REST APIs (shared backend)
PostgreSQL Database & Schema
Dashboard Module (Buyer, Seller, Broker)
Directory & Discovery Module with Bookmarks & Deep-links / QR
GPS for Business Registrations (geo-tag entity location on signup, map-based discovery, nearby filters, distance & directions)
Notification Module (App + WhatsApp + Push Digest)
Profile & Settings with KYC and Trust Badge scaffolding
Broker Bill Management (split bids, integrity rules, bill history)
Admin Panel (Approval, Users, Entities, Subscriptions)
Client AWS Deployment
Unit Testing, QA (Manual), SAST & Performance Testing
UAT & Production Go-Live

Technology Stack

Customer WebReact.js

Android AppReact Native (with Capacitor)

iOS AppReact Native (with Capacitor)

Admin PanelReact.js

BackendJava 21 + Spring Boot

DatabasePostgreSQL + PostGIS

APIREST APIs

AuthenticationOTP + JWT + RBAC

NotificationsFCM Push + WhatsApp Business API

Maps / Geo / GPSGoogle Maps + Geolocation API

CloudClient Hosted AWS

DevOpsJenkins CI/CD

Version ControlGit

TestingJUnit / Vitest · Manual QA · SAST · Perf

Effort Estimation

AI-Assisted Development · parallel execution across tracks

Solution Architecture2 PW

UI/UX Design3 PW

Database Design (incl. PostGIS geo schema)2 PW

Backend API Development11 PW

GPS for Business Registrations (Geo APIs + Maps)2 PW

React.js Customer Web4.5 PW

Android Development3.5 PW

iOS Development3.5 PW

Admin Panel (Web)3 PW

WhatsApp & Push Notification Integration2 PW

DevOps & CI/CD2 PW

Unit Testing2 PW

QA Functional Testing (Manual)4 PW

SAST Security Testing1.5 PW

Performance Testing1.5 PW

UAT Support2 PW

Production Deployment1 PW

Total Development Effort50.5 Person-Weeks · ~12.5 Person-Months

Parallel Delivery Schedule

1
Week 1 · Jul 13 – Jul 19
Architecture, UI/UX, Database Design (with PostGIS), Auth (OTP + JWT), backend & app scaffolding
2
Week 2 · Jul 20 – Jul 26
Backend core APIs, Customer Web + Mobile foundations, Google Maps SDK integration
3
Week 3 · Jul 27 – Aug 02
Directory & Discovery, GPS for Business Registrations (geo-tag on signup, nearby search), Buyer/Seller/Broker Dashboards
4
Week 4 · Aug 03 – Aug 09
Broker Bill, Admin Panel
5
Week 5 · Aug 10 – Aug 16
WhatsApp & Push integration, end-to-end system integration
6
Week 6 · Aug 17 – Aug 23
Unit Testing, QA (Manual), SAST & Performance Testing
7
Week 7 · Aug 24 – Aug 30
UAT, Bug Fixes, Production Deployment & Go-Live

Estimated Project Duration

7 Weeks · 13 July 2026 – 30 August 2026

Team Structure

Solution Architect

UI/UX Designer

React.js Developer

Mobile Developer

Spring Boot Developers

QA Engineer

DevOps Engineer

Total Team Size: 8 Resources

Assumptions

!Client will provide AWS infrastructure and credentials.
!WhatsApp Business API account, templates and sender number are provided by the client.
!Google Maps / Geolocation / Places API keys are provided by the client; per-request billing is on the client account.
!GPS capture for Business Registrations requires user location consent at signup; fallback manual pin-drop will be provided when GPS is unavailable.
!Infrastructure hosting and third-party API/messaging charges are excluded.
!Payment Gateway integration is out of scope for v1 (roadmap item).
!Requirements are based on Mercotrace Customer App SRS v2.3.
!Major scope changes will be handled through Change Requests (CRs).

Feature Scope

Complete functionality delivered in this scope (per SRS v2.3, excluding Agent mode, Consignment Tracking, Deals / Analytics and My Farm)

Authentication System

OTP-based mobile authentication
JWT + Role-Based Access Control (RBAC)
Single role-agnostic person ID with contextual relationships
Shared identity across Customer App, Auction & Retail

Dashboard Module

Role-based dashboards (visible after first transaction / subscription)
Pending Payments & Credit Tracking
In-app Notifications feed
Buyer dashboard: Purchase History
Seller dashboard: Sales History
Broker dashboard: buyer relationships & bill summary

Directory & Discovery Module

Discovery of registered Business Entities (Mandis, retailers, cold-storage, etc.)
Search & filter by category, product and location
GPS for Business Registrations — geo-tag entity on signup
Map-based discovery with nearby filter, distance and directions
Entity profile view (products, contacts, hours, verification)
Phone Click — logged as Lead (transaction intent signal)
Bookmark entity — dual role: notification filter + customer acquisition
Deep-link / QR sharing by entities to drive installs & bookmarks
Smart Recommendations (ranking includes bookmarked/preferred entity, radius, categories)
User controls: mute entity, preferred radius, categories, notification frequency

Notification Module

In-app Notifications
WhatsApp channel notifications
Push notification digest
User-controlled frequency and category preferences

Profile & Settings

Buyer / Seller / Broker profile management
KYC document upload & verification workflow
Privacy controls (profile visibility, opt-out of behavioural tracking, KYC visibility scope)
Trust Badge for verified users (threshold-based activation)
Preferences (radius, categories, language)

Broker Bill Management

View draft bills received from mandis
Split bids across multiple buyer-named bills
Set coolie charges per bill
Integrity rules: original bid persists in a residual bill; no bill/bid deletion by broker
Submit bills to mandi for review
Mandi notification, review, approval and finalisation flow
Finalised bills available in Broker Bill History

Registration Module (Entities)

Business Entity registration & onboarding
Owner & Staff account setup
KYC / verification submission

Campaign Module (Entity side)

Campaigns via App + WhatsApp channels
Scheduling & frequency controls
Mandatory campaign expiry (auto-close)
Metrics: Sent count, Click rate, ROI tracking
Voice input mapped to structured campaign fields
Assistive agent to suggest templates and flag underperformers

Promotion Module (Revenue Engine)

Featured listings
Wallet-based campaign charges
Add-on module charges

Lead Management (Subscription-gated)

Lead Inbox for entities
Lead details: name, contact, activity, lead type (Phone Click / Bookmark)
Lead status: New → Contacted → Converted (self-reported)

Entity Settings Module

Entity profile management
Staff access control
Entity preferences

Admin Panel

Approval System for entities and staff
User Management (view, block, modify profiles)
Business Entity Management (edit / delete, across Auction & Retail)
Staff permission granularity incl. Manage Connected Devices
Campaign Monitoring
Subscription Management — pricing, payment tracking, Entity Control (Activation / Suspension / Soft Deletion)
System Controls — Audit logs, Fraud detection, Content moderation

Security & Platform

OTP authentication
Role-based access control
Data encryption in transit & at rest
Privacy controls
Cross-platform delivery — Android, iOS and Web

Role-Based Features

Capabilities scoped by user role — Buyer, Seller, Broker and Agent

Buyer

Discovers entities, bookmarks, generates leads, tracks purchases.

OTP login with Buyer context on shared person ID
Discover mandis, retailers, cold-storage via search, category & location filters
Map-based nearby discovery with GPS, distance & directions
View entity profile — products, contacts, hours, verification, trust badge
Phone Click on entity → captured as Lead (intent signal to seller)
Bookmark entity → receive filtered notifications + counts as acquisition signal
Smart Recommendations tuned by bookmarks, preferred radius & categories
Personal controls — mute entity, preferred radius, categories, notification frequency
Receive campaign & promotion notifications (App + WhatsApp) per preference
Purchase History dashboard (visible after first transaction)
Pending Payments & credit tracking view
KYC upload, privacy controls, profile visibility management
Deep-link / QR install & bookmark flows

Seller (Business Entity Owner / Staff)

Registers the entity, runs campaigns, manages leads and bills.

Business Entity registration & onboarding with GPS geo-tag at signup
Owner + Staff account setup with granular staff permissions
KYC document submission & verification workflow
Entity profile management — products, contacts, hours, media
Create & schedule Campaigns via App + WhatsApp channels
Voice input mapped to structured campaign fields; assistive template suggestions
Mandatory campaign expiry, frequency controls, underperformer flags
Campaign metrics — Sent count, Click rate, ROI
Promotion engine — Featured Listings, Wallet-based charges, Add-on modules
Lead Inbox (subscription-gated) — name, contact, activity, lead type
Lead status pipeline — New → Contacted → Converted (self-reported)
Sales History dashboard and Pending Payments view
Bookmark analytics — see acquisition signals from buyers
Trust Badge activation on meeting verification thresholds
Manage Connected Devices for staff access control

Broker

Bridges buyers and mandis; manages draft bills with integrity rules.

OTP login with Broker context on shared person ID
Broker dashboard — buyer relationships & bill summary
View draft bills received from mandis
Split bids across multiple buyer-named bills
Set coolie charges per bill
Integrity rules — original bid persists in a residual bill; no bill/bid deletion by broker
Submit bills to mandi for review
Track mandi review, approval and finalisation flow
Broker Bill History — finalised bills archive
Notifications for bill status changes (App + WhatsApp)
KYC upload, profile & privacy controls

Agent (Field / Onboarding Agent)

Assists entity onboarding, KYC and verification in the field.

Assisted Business Entity registration on behalf of owners
On-site GPS capture & manual pin-drop fallback for geo-tagging
KYC document collection & upload workflow
Owner & Staff account setup assistance
Track onboarded entities & verification status
Route onboarding requests to Admin approval queue
Notifications on approval / rejection outcomes

Mercotrace Directory · Commercial Proposal v1.0

Confidential · Prepared for client review

MercotraceDirectory (Customer App)