A comprehensive digital ecosystem connecting Tunisian fishermen, farmers, and consumers through specialized applications sharing a single Firebase backend.
TnGreen is designed to modernize the Tunisian agri-fishery sector by enabling producers to manage operations and sell fresh produce directly to local markets—often before it even arrives ashore.
- el-3ida (Fisherman App): [Primary Deliverable] Flutter app for boat/crew management, catch logging, and marketplace listings.
- Zr3i (Farmer App): [Planned] Flutter app for land management, crop tracking, and IoT sensor integration.
- TnGreen Market: [Planned] A two-part system consisting of a Consumer Flutter App for buyers and an Angular 17+ Web Portal for market managers and admins.
- Single Source of Truth: All apps share a single Firebase project.
- Pre-Arrival Listings: Producers post products (pre-catch/pre-harvest) to ensure freshness and rapid sales.
- Tunisian Market Fit: Optimized for offline use at sea and cash-first payment strategies.
| Layer | Technology | Usage |
|---|---|---|
| Mobile Apps | Flutter 3.x | el-3ida, Zr3i, Consumer Market |
| Web Admin | Angular 17+ | TnGreen Admin & Market Manager |
| Database | Firestore / RTDB | Real-time NoSQL data & IoT sensor streams |
| Backend | Cloud Functions | Order processing, notifications, and reports |
| Maps/Weather | Google Maps / OpenMeteo | Fishing zones and sea condition monitoring |
- Boat Management: Multi-boat support, document tracking (ANPA licenses), and status monitoring (Active/Maintenance/Retired).
- Crew & Trip Management: Roster management with role-based salary calculations (share % + fixed bonuses) and trip history logging.
- Marketplace: Post catches before arrival with photos, bidding system, and direct pricing options.
- Weather & Safety: Real-time sea conditions (wind, waves, visibility) with safety level alerts (Safe/Moderate/Danger).
- Fish Prediction: AI/Rule-based probability mapping for Tunisian species (Tuna, Sardines, Squid, etc.) across geographic zones.
- Land Management: GPS boundary mapping and parcel tracking.
- Crop Cycle: Stage tracking from seeding to harvest.
- IoT Integration: Real-time monitoring of soil moisture, pH, and temperature via Firebase Realtime DB.
- Market Forecasts: Demand analytics to help farmers decide what to plant.
- Market Discovery: Select nearest market via GPS.
- Pre-Arrival Ordering: Order "Arriving soon" products to secure the freshest catch.
- Payment: Primary focus on Cash on Pickup, with D17/digital wallet options for subscriptions.
- Listing Approval: Review and approve producer listings before they go live.
- Inventory Dashboard: Real-time view of available stock and incoming arrivals.
- Analytics: Revenue tracking, top products, and producer performance reports.
- Franchise Fees: Monthly SaaS tiers for market operators (150 - 800 TND).
- Commissions: 3–5% on confirmed market orders.
- Premium Subscriptions: 29 TND/month for producers to unlock unlimited listings, advanced AI, and PDF reporting.
- B2B Tools: Premium access for restaurants and hotels.
After cloning the repository, follow these steps to launch each component:
For each of el_3ida, zr3i, and tngreen_consumer:
cd <app_directory>
flutter pub get
flutter runcd tngreen_admin
npm install
npm start- PowerPoint:
TnGreen_Ecosystem_Presentation.pptx - Presentation Deck:
TNGREEN_PRESENTATION.md - Setup Manual: See detailed SETUP_GUIDE.md for platform-specific notes.
System Plan v1.1 | Developed for the Future of Tunisian Freshness.