| Documentation
All Docs Back to App

AquaDealers Documentation

Complete product, technical, design and operational documentation for AquaDealers v3.0.0

Verified 24 documents verified against source code Review 2 documents need review Last updated: September 2026
Product
Verified

Product Overview

What AquaDealers is, who it's for, core capabilities, and tech stack.

Verified

Personas & Workflows

Dealer, Staff, and Admin roles — permissions, entry points, key workflows.

Verified

Information Architecture

Navigation structure, all 73 routes, feature gating, and layout system.

Verified

Page Specifications

Detailed specs for every major page — Dashboard, New Bill, Farmer Ledger, Reports, Settings.

Verified

Feature Specifications

Billing, Estimates, Returns, Transfers, Bill Editing, Cancellation, Transaction Undo.

Business
Verified

Business Rules

Billing calculations, GST, payment allocation, credit limits, settlement discounts.

Verified

Financial Logic

Cash flow, daily closing, financial metrics, profit calculation.

Verified

Inventory Logic

Three-level stock system, FIFO lot consumption, expiry management, auto-fanout.

Engineering
Verified

Database

48+ tables, triggers, RLS policies, views — complete Supabase PostgreSQL schema.

Verified

API & RPCs

All Supabase RPCs, Edge Functions, and API endpoints.

Verified

Roles & Permissions

Permission matrix, staff JSONB permissions, admin roles, RLS enforcement.

Verified

UI Design System

Color palette, typography, 23 UI components, notifications, design tokens.

Verified

Mobile UX

Bottom nav, mobile billing wizard, responsive patterns, touch targets.

Verified

Desktop UX

Sidebar layout, desktop billing, keyboard shortcuts, wide-screen optimizations.

Operations
Verified

WhatsApp

Dual system — wa.me links + authkey.io API, 10 templates, quota system.

Verified

Reports

Monthly finance pack, sales register, profit report, stock report, daily book.

Verified

Security

Authentication, RLS, known security issues, storage permissions.

Verified

Performance

Caching strategy, code splitting, known performance issues, what's working.

Verified

Testing

11 unit tests (Vitest), 3 E2E specs (Playwright), configuration.

Review

Analytics

PostHog event tracking, Sentry error monitoring, session replays.

Verified

Onboarding & Support

4-step onboarding wizard, support ticket system.

Meta
Planned

Roadmap

Completed features, recommended next priorities.

Verified

Changelog

Version history from git — recent changes by month.

Verified

Known Issues

All known bugs and limitations ranked by severity.

Verified

Glossary

Domain terminology — Dealer, Farmer, Lot, FIFO, MRP, HSN, and more.

Verified

AI / Codex Rules

Development rules for AI assistants — before changing anything, never do, architecture reference.