Business Requirements
Owner: Product
Reviewers: Business, Engineering
Status: Draft
Version: 0.1
Last Updated: 2026-09-16
Review Cycle: Per roadmap update
Goals
| ID |
Requirement |
Status |
| BR-01 |
Provide a digital operating platform for shrimp farm management. |
CONFIRMED |
| BR-02 |
Support multiple roles: admin, owner, manager, technician and viewer/owner-facing users. |
PARTIAL |
| BR-03 |
Centralize farm, pond, crop, water, feeding, ticket and report information. |
PARTIAL |
| BR-04 |
Support IoT telemetry ingestion for water/environment monitoring. |
PARTIAL |
| BR-05 |
Reduce manual reporting through export and scheduled report workflows. |
PARTIAL |
| BR-06 |
Provide operational knowledge through handbook content and future AI assistant flows. |
PLANNED/PARTIAL |
Business Constraints
| Constraint |
Status |
Notes |
| Role-specific access to farm data |
PARTIAL |
Auth and scopes exist, but temporary backend bypasses are documented. |
| Web admin/operator portal |
CONFIRMED |
React/Vite dashboard exists. |
| Mobile field workflows |
PARTIAL |
Expo app exists with role tabs and selected feature screens. |
| IoT data dependency |
PARTIAL |
Local MQTT/Telegraf/worker stack exists; production device operations need hardening. |
| Email/notification dependency |
PARTIAL |
Gmail/nodemailer services exist; full templates/config are not complete. |
Success Measures
| Metric |
Status |
| Authenticated users can complete role-appropriate workflows. |
TBD |
| Water telemetry is ingested and queryable for ponds. |
PARTIAL |
| Manual operational reports can be exported. |
CONFIRMED |
| Weekly report automation completes without manual intervention. |
PLANNED |
| Incident/ticket handling can be tracked end to end. |
PARTIAL |