kisotokopwi/NgombeCoin

Tokenized Livestock Investment Platform - Blockchain-based livestock tokenization for Tanzania # 🐄 NgombeCoin — Digital Livestock Commodity Marketplace **Modernizing livestock trading through blockchain-backed commodity vouchers.** NgombeCoin is a Production-Grade PWA (Progressive Web App) that enables transparent sourcing, trading, and forward delivery of livestock assets in Tanzania. Built with a "Feature-First" architecture for scalability and security. --- ## 📚 Documentation Center > **Start Here**: These documents define *how* we build NgombeCoin. | Document | Description | |----------|-------------| | **Functional Requirements (SRS)** | Full functional requirements, workflows (Retail & Commercial), and care fee logic. | | **System Architecture** | High-level design, data flow diagrams, and tech stack rationale. | | **Security Guidelines** | **CRITICAL**: Mandatory Web3 security practices and rules. | | **Style Guide** | Coding standards, naming conventions, and best practices. | | **API Documentation** | API contract, endpoints, and error handling. | --- ## 🏗️ Technical Architecture This project follows a **Feature-Based Architecture** to ensure scalability. Instead of grouping by "pages", we group by **Business Domains**. ### Folder Structure ```bash src/ modules/ # Domain-specific features (Self-contained) marketplace/ # Listing, filtering, and bulk purchase logic animals/ # Animal registration, verification, redemption wallet/ # Connection, signing, balance auth/ # JWT, session management disputes/ # Mediation logic & flows shared/ # Reusable code across modules components/ # UI Design System (ShadCN) hooks/ # Global hooks (e.g., useNetwork) utils/ # Formatting, validation helpers services/ # API clients (RTK Query definitions) ``` ### Technology Stack * **Frontend**: Next.js 14 (App Router), TypeScript (Strict Mode) * **Styling**: Tailwind CSS + ShadCN UI (Component System) * **State Management**: Redux Toolkit + RTK Query (Caching & Sync) * **Offline …