How kalainidhias/forest-edge works
Forest Edge is a wildlife-intrusion reporting and early-warning system. Villagers submit location-tagged sightings; officers review and verify reports, after which nearby residents can receive alerts. The sampled backend implements authentication, report processing, alert dispatch, and local file storage. The README also describes mobile mapping, history, and offline sync, but the supplied tree contains only platform shells—not the Flutter application logic—so those capabilities are noted without inventing internal components or connections.
Main entry points: ReportService.java Report workflow · UserRepository.java User repository · AlertService.java Alert dispatch · AuthService.java Authentication service
Components 20
API workflows
- Authentication API
backend/src/main/java/com/forestedge/controller/AuthController.java - Report API
backend/src/main/java/com/forestedge/controller/ReportController.java - File API
backend/src/main/java/com/forestedge/controller/FileController.java
Wildlife domain
- Report workflow
backend/src/main/java/com/forestedge/service/ReportService.java - Animal reports
backend/src/main/java/com/forestedge/model/AnimalReport.java - Users and roles
backend/src/main/java/com/forestedge/model/User.java - Report repository
backend/src/main/java/com/forestedge/repository/ReportRepository.java - User repository
backend/src/main/java/com/forestedge/repository/UserRepository.java
Identity and security
- Authentication service
backend/src/main/java/com/forestedge/service/AuthService.java - JWT token provider
backend/src/main/java/com/forestedge/security/JwtTokenProvider.java - User details lookup
backend/src/main/java/com/forestedge/security/UserDetailsServiceImpl.java
Alerts and files
- Alert records
backend/src/main/java/com/forestedge/model/Alert.java - Alert repository
backend/src/main/java/com/forestedge/repository/AlertRepository.java - Alert dispatch
backend/src/main/java/com/forestedge/service/AlertService.java - Firebase messaging
backend/src/main/java/com/forestedge/service/FCMService.java - File storage
backend/src/main/java/com/forestedge/service/FileStorageService.java - Storage configuration
backend/src/main/java/com/forestedge/config/FileStorageProperties.java
Other components
- Villagers and officers
- MySQL database
- Firebase Cloud Messaging
Connections 22
- Report API → Report workflow: delegates reports
backend/src/main/java/com/forestedge/controller/ReportController.java - Report API → User repository: looks up caller
backend/src/main/java/com/forestedge/controller/ReportController.java - Report workflow → Report repository: reads and writes
backend/src/main/java/com/forestedge/service/ReportService.java - Report workflow → User repository: loads users
backend/src/main/java/com/forestedge/service/ReportService.java - Report workflow → Alert dispatch: triggers alerts
backend/src/main/java/com/forestedge/service/ReportService.java - Report workflow → Alert repository: deletes related alerts
backend/src/main/java/com/forestedge/service/ReportService.java - Report repository → Animal reports: persists reports
backend/src/main/java/com/forestedge/repository/ReportRepository.java - User repository → Users and roles: queries users
backend/src/main/java/com/forestedge/repository/UserRepository.java - Alert dispatch → User repository: finds recipients
backend/src/main/java/com/forestedge/service/AlertService.java - Alert dispatch → Alert repository: saves alerts
backend/src/main/java/com/forestedge/service/AlertService.java - Alert dispatch → Firebase messaging: sends notifications
backend/src/main/java/com/forestedge/service/AlertService.java - Alert repository → Alert records: persists alerts
backend/src/main/java/com/forestedge/repository/AlertRepository.java - Firebase messaging → Firebase Cloud Messaging: dispatches pushes
README.md - File API → File storage: stores and loads files
backend/src/main/java/com/forestedge/controller/FileController.java - File storage → Storage configuration: reads upload settings
backend/src/main/java/com/forestedge/service/FileStorageService.java - Authentication service → User repository: saves and finds users
backend/src/main/java/com/forestedge/service/AuthService.java - Authentication service → JWT token provider: creates tokens
backend/src/main/java/com/forestedge/service/AuthService.java - User details lookup → User repository: loads account
backend/src/main/java/com/forestedge/security/UserDetailsServiceImpl.java - Villagers and officers → Authentication API: registers or logs in
README.md - Villagers and officers → Report API: submits sightings
README.md - Report workflow → MySQL database: stores report data
README.md - Authentication service → MySQL database: stores account data
README.md