Smart Farming Ethiopia smart-farming-backend
# Smart Farming Ethiopia Backend
Laravel API and Filament back-office for the Smart Farming Ethiopia project.
This backend is the system of record for farmer data, disease reports, expert/supporter review, soil health, weather records, alerts, yield prediction, treatment guidance, and administrative workflows. It works with the Flutter farmer mobile app and the optional Python inference service.
## Project Purpose
Smart Farming Ethiopia was developed as an applied technology-transfer project for career promotion from Assistant Instructor to Instructor.
- Developer: Admasu Feleke Mulatu
- Email: admasu.feleke21@gmail.com
- Phone: 0900824328
- Institution: Dalocha Polytechnic College
- Approval context: Technology Transfer Core, Dalocha Polytechnic College
## Main Capabilities
- Farmer-facing REST API
- Laravel Sanctum authentication
- Farmer-owned farm, plot, planting, soil, disease, weather, and alert data
- Filament back-office for administrators, supporters, and experts
- Disease report triage and review workflow
- Image evidence storage and secure preview
- Treatment guidance rules and pesticide/treatment registry support
- Schema-backed localized treatment registry content
- Disease prevention recommendations
- Soil health recommendation endpoint with optional sensor/IoT metadata
- Weather monitoring and summaries with optional sensor/IoT metadata
- Yield prediction endpoint
- Optional online inference integration
- Operational health checks and release-gate commands
## System Roles
- Farmer: uses the Flutter mobile app.
- Supporter: reviews assigned regional farmer reports and provides field support.
- Expert: validates disease reports and treatment guidance where needed.
- Regional administrator: manages scoped regional operations.
- Super administrator: manages global system configuration.
Administrative access is intentionally separated from the farmer mobile app.
## Architecture
```text
Flutter farmer app
|
| REST API / Sanctum
v
Laravel backend …