Mageto369/aatos

African Agricultural Trade Operating System - The infrastructure for global agri trade # AATOS — African Agricultural Trade Operating System ## Technical Blueprint This repository contains the enterprise-grade technical foundation for AATOS — the operating system for global agricultural trade between Africa and the world. --- ## 📁 Repository Structure ``` aatos/ ├── docs/ │ ├── ARCHITECTURE.md # System architecture, principles, component diagrams │ ├── DATA_MODEL.md # Entity definitions, relationships, cardinality matrix │ └── SECURITY.md # Security model, threat assessment, controls (TODO) │ ├── schema/ │ └── 01_core_schema.sql # PostgreSQL 16 database schema │ # - All tables, enums, indexes, constraints │ # - Full-text search vectors │ # - Partitioned tables (messages, audit_logs) │ # - RLS policies │ # - Views and functions │ ├── api/ │ └── API_SPECIFICATION.md # REST API specification │ # - Authentication & Identity │ # - Organizations, Documents, Products │ # - RFQs, Quotations, Deals, Messages │ # - Compliance, WebSocket events │ # - Error formats, rate limits, versioning │ ├── frontend/ │ └── FRONTEND_ARCHITECTURE.md # React application architecture │ # - Component hierarchy and screen designs │ # - Design system (colors, typography, tokens) │ # - State management (Zustand + React Query) │ # - File structure and performance strategy │ └── diagrams/ └── SEQUENCE_DIAGRAMS.md # 10 critical business process flows # - Supplier onboarding & verification # - RFQ creation & supplier matching # - Deal creation & contract signing # - Escr …