Almafrica Documentation

Welcome to the Almafrica platform documentation. This is your guide to understanding, developing, and deploying the agricultural management system.

Quick Navigation

I want to...	Go to
Get started as a new developer	Onboarding Guide
Understand the system architecture	Architecture Overview
Learn the development workflow	Development Guide
Run a release with a one-page checklist	Release One-Page
Deploy to production	Deployment Guide
Troubleshoot issues	Troubleshooting Guide
Reference API endpoints	API Reference
Run operational procedures	Runbooks

System Overview

┌─────────────────┐     ┌──────────────────┐     ┌─────────────┐
│  Web Dashboard  │────>│   .NET Backend   │────>│  PostgreSQL │
│  (Next.js 15)   │     │  (ASP.NET Core)  │     │  Database   │
└─────────────────┘     └──────────────────┘     └─────────────┘
                               ^
                               │
                        ┌──────┴──────┐
                        │ Mobile App  │
                        │  (Flutter)  │
                        │ + SQLite    │
                        └─────────────┘

Technology Stack:

• Backend: .NET 10, ASP.NET Core, EF Core, PostgreSQL
• Web: Next.js 15, TypeScript, Zustand, Tailwind CSS
• Mobile: Flutter, Provider, offline-first sync