Skip to content

Latest commit

Β 

History

66 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌾 CeyTrack β€” Smart Agricultural Supply Chain & GIS-Based Land Management System

A fully role-based πŸ“± Flutter mobile application designed to digitize and modernize Sri Lanka’s agricultural ecosystem, focusing on πŸƒ Tea & 🌿 Cinnamon production, logistics, export coordination, and intelligent GIS-powered land boundary management.

CeyTrack transforms traditional agricultural workflows into a real-time digital ecosystem where πŸ‘¨β€πŸŒΎ Land Owners and 🏭 Factory Owners collaborate seamlessly through GPS tracking, polygon land mapping, and live data synchronization powered by Firebase.

The system improves transparency, reduces manual paperwork, enhances traceability, and enables data-driven decision-making across the entire agricultural supply chain.


πŸš€ Key Highlights

  • ⚑ Real-time agricultural digitization system
  • πŸ—Ί Advanced GIS-based land boundary mapping (Polygon system)
  • πŸ“ GPS-driven land tracking & live visualization
  • πŸ“¦ Full export lifecycle management (Create β†’ Track β†’ Complete)
  • 🌍 Interactive map-based agricultural monitoring system
  • πŸ”„ Live Firestore synchronization across roles
  • 🧠 Scalable role-based architecture (Land Owner / Factory Owner)
  • πŸ“Š Real-time analytics for production & exports

πŸ— System Architecture Overview

CeyTrack follows a modular, scalable, role-driven architecture designed for long-term maintainability:

πŸ” 1. Authentication Layer

  • Firebase Authentication system
  • Role-based login (Land Owner / Factory Owner)
  • Secure session handling
  • User verification & access control

πŸ‘₯ 2. Role Management System

  • Dynamic role assignment
  • Permission-based feature access
  • Separate workflows for each user type

πŸ—Ί 3. GIS & Map Engine

  • Google Maps + OpenStreetMap integration
  • Real-time GPS tracking engine
  • Polygon boundary rendering system
  • GeoPoint β†’ LatLng transformation pipeline
  • Crop-based visual mapping system

πŸ“¦ 4. Export & Workflow Engine

  • Export request creation system
  • Factory approval & tracking flow
  • Status lifecycle management (Pending β†’ Processing β†’ Completed)
  • History & audit tracking

πŸ”„ 5. Real-time Sync Layer

  • Firestore real-time listeners
  • Instant UI updates across devices
  • Live order & land updates
  • Offline-safe synchronization logic

πŸ“Š 6. Analytics Engine

  • Crop-based analytics
  • Export performance tracking
  • Factory workload insights
  • Real-time dashboard metrics

πŸ›  Technology Stack

πŸ–₯ Frontend (Mobile App)

  • Flutter (Cross-platform UI framework)
  • Dart (Core logic & state handling)
  • Role-based modular architecture
  • Reusable component-driven UI system
  • Clean architecture pattern for scalability

☁️ Backend & Cloud

  • πŸ” Firebase Authentication
  • πŸ’Ύ Cloud Firestore (Real-time NoSQL database)
  • πŸ–Ό Firebase Storage (Image/evidence uploads)
  • ☁️ Cloudinary (Optimized media delivery)
  • ⚑ Firestore real-time listeners

πŸ—Ί Maps & Location Services

  • 🌍 Google Maps API integration
  • πŸ—Ί OpenStreetMap support
  • πŸ“ High-accuracy GPS tracking
  • 🟩 Polygon land boundary system
  • 🏷 Reverse Geocoding (address extraction)
  • 🎨 Crop-based land visualization system
  • πŸ“‘ Live map rendering for factories

πŸ‘₯ User Roles & Detailed Features


🏭 Factory Owner Module

πŸ“Š Advanced Dashboard

  • Real-time agricultural analytics
  • Crop distribution insights (Tea/Cinnamon)
  • Incoming supply monitoring
  • Export demand visualization
  • Live system health indicators

πŸ“¦ Order Management System

  • Create, approve, and track export orders
  • Full lifecycle tracking (Pending β†’ Processing β†’ Completed)
  • Supplier-wise order filtering
  • Real-time status updates from land owners
  • Order history with audit logs

🌍 GIS Land Visualization

  • Interactive map with all supplier lands
  • Auto-rendered polygons from Firestore GeoPoints
  • Crop-based color-coded land regions
  • Land metadata display (owner, crop type, size)
  • Live GPS-based land updates

🏒 Factory Operations

  • Factory profile management
  • Supplier relationship tracking
  • Contact integration with land owners
  • Export workflow optimization tools

🌱 Land Owner Module

🌾 Land Management System

  • Add and manage agricultural lands
  • Crop classification (Tea, Cinnamon, etc.)
  • Multi-land support per user
  • GPS-based land registration

πŸ—Ί Smart Boundary Mapping

  • Walk-around GPS polygon drawing system
  • Automatic coordinate capture
  • Firestore-based polygon storage
  • Instant visual map rendering
  • Crop-based boundary coloring

🏭 Factory Integration

  • Select and link factories per crop
  • One-tap calling functionality
  • Direct communication channel
  • Export collaboration system

πŸ“€ Export Workflow

  • Create export requests with details
  • Add quantity, crop type, date, notes
  • Upload supporting images/evidence
  • Track export status in real-time
  • View factory responses instantly

πŸ“œ History & Tracking

  • Complete export history log
  • Transparent workflow tracking
  • Real-time status updates
  • Past performance insights

🎨 UI / UX Design System

  • ✨ Modern blue-themed professional UI system
  • πŸ“± Fully responsive design (mobile-first approach)
  • 🧩 Modular reusable UI components
  • 🌈 Gradient-based dashboard cards
  • πŸͺŸ Glassmorphism-inspired interface elements
  • 🎞 Smooth animations & micro-interactions
  • πŸ”Ž Advanced search + filtering system
  • πŸ—‚ Redesigned navigation architecture
  • πŸ“Ά Offline/online connectivity-aware UI states
  • ⚑ High-performance rendering optimizations

⚑ Performance & Optimization

  • πŸš€ Optimized Firestore queries for low latency
  • ⚑ Efficient real-time map rendering system
  • 🧠 Clean state management architecture
  • πŸ“¦ Modular scalable code structure
  • πŸ”₯ Reduced redundant rebuilds & UI lag
  • 🧹 Refactored legacy codebase for performance
  • πŸ“ˆ Improved onboarding & user flow efficiency
  • πŸ—Ί Optimized polygon rendering for large datasets

πŸ” Security Features

  • Firebase Auth secure login system
  • Role-based access control (RBAC)
  • Session validation & protection
  • Firestore security rules implementation
  • Audit-ready action tracking system
  • Account lockout protection system

πŸš€ Future Enhancements

  • πŸ€– AI-based crop yield prediction system
  • πŸ’° Smart pricing & market demand forecasting
  • 🚁 Drone-based land verification system
  • πŸ“Š Machine learning analytics dashboard
  • 🌐 National agricultural integration platform
  • πŸ“‘ IoT sensor integration for soil monitoring

πŸ“± Supported Platforms

  • Android
  • iOS
  • Web
  • Windows
  • Linux
  • macOS

πŸ‘¨β€πŸ’» Developer

Malitha Tishamal
Full-Stack Mobile & Backend Developer


🏷️ Tech Stack Tags

Flutter Firebase GIS SmartAgriculture LandMapping
GPS Firestore CrossPlatform MobileApp AgriTech
RealTimeSystem SupplyChain UIUX GeoSpatialSystem

About

A smart role-based πŸ“± Flutter mobile application built to modernize Sri Lanka’s agricultural supply chain with πŸƒ Tea & 🌿 Cinnamon export management, GPS land tracking, and smart polygon boundary mapping. CeyTrack V2 introduces πŸ—ΊοΈ real-time polygon land visualization using Firebase Firestore GeoPoints

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages