# kalainidhias/forest-edge architecture

> Architecture diagram of the GitHub repository kalainidhias/forest-edge, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kalainidhias/forest-edge
- Repository: https://github.com/kalainidhias/forest-edge

## Overview

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: [`backend/src/main/java/com/forestedge/service/ReportService.java`](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/ReportService.java) (Report workflow), [`backend/src/main/java/com/forestedge/repository/UserRepository.java`](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/repository/UserRepository.java) (User repository), [`backend/src/main/java/com/forestedge/service/AlertService.java`](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/AlertService.java) (Alert dispatch), [`backend/src/main/java/com/forestedge/service/AuthService.java`](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/AuthService.java) (Authentication service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API workflows"]
  node_auth_api["Authentication API"]
  node_report_api["Report API"]
  node_file_api["File API"]
end

subgraph group_domain["Wildlife domain"]
  node_report_service["Report workflow<br/>[ReportService.java]"]
  node_report_entity["Animal reports<br/>[AnimalReport.java]"]
  node_user_entity["Users and roles<br/>[User.java]"]
  node_report_repository["Report repository"]
  node_user_repository["User repository"]
end

subgraph group_security["Identity and security"]
  node_auth_service["Authentication service<br/>[AuthService.java]"]
  node_jwt_provider["JWT token provider"]
  node_user_details["User details lookup"]
end

subgraph group_delivery["Alerts and files"]
  node_alert_entity["Alert records<br/>[Alert.java]"]
  node_alert_repository["Alert repository"]
  node_alert_service["Alert dispatch<br/>[AlertService.java]"]
  node_fcm_service["Firebase messaging<br/>[FCMService.java]"]
  node_file_service["File storage"]
  node_file_properties["Storage configuration"]
end

node_villagers(("Villagers and officers"))
node_database[("MySQL database")]
node_firebase{{"Firebase Cloud Messaging"}}

node_report_api -->|"delegates reports"| node_report_service
node_report_api -->|"looks up caller"| node_user_repository
node_report_service -->|"reads and writes"| node_report_repository
node_report_service -->|"loads users"| node_user_repository
node_report_service -->|"triggers alerts"| node_alert_service
node_report_service -->|"deletes related alerts"| node_alert_repository
node_report_repository -->|"persists reports"| node_report_entity
node_user_repository -->|"queries users"| node_user_entity
node_alert_service -->|"finds recipients"| node_user_repository
node_alert_service -->|"saves alerts"| node_alert_repository
node_alert_service -->|"sends notifications"| node_fcm_service
node_alert_repository -->|"persists alerts"| node_alert_entity
node_fcm_service -.->|"dispatches pushes"| node_firebase
node_file_api -->|"stores and loads files"| node_file_service
node_file_service -->|"reads upload settings"| node_file_properties
node_auth_service -->|"saves and finds users"| node_user_repository
node_auth_service -->|"creates tokens"| node_jwt_provider
node_user_details -->|"loads account"| node_user_repository
node_villagers -.->|"registers or logs in"| node_auth_api
node_villagers -.->|"submits sightings"| node_report_api
node_report_service -.->|"stores report data"| node_database
node_auth_service -.->|"stores account data"| node_database

click node_auth_api "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/controller/AuthController.java"
click node_auth_service "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/AuthService.java"
click node_report_api "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/controller/ReportController.java"
click node_file_api "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/controller/FileController.java"
click node_report_service "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/ReportService.java"
click node_report_entity "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/model/AnimalReport.java"
click node_user_entity "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/model/User.java"
click node_alert_entity "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/model/Alert.java"
click node_report_repository "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/repository/ReportRepository.java"
click node_user_repository "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/repository/UserRepository.java"
click node_alert_repository "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/repository/AlertRepository.java"
click node_alert_service "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/AlertService.java"
click node_fcm_service "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/FCMService.java"
click node_file_service "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/FileStorageService.java"
click node_file_properties "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/config/FileStorageProperties.java"
click node_jwt_provider "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/security/JwtTokenProvider.java"
click node_user_details "https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/security/UserDetailsServiceImpl.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_api,node_report_api,node_file_api toneBlue
class node_report_service,node_report_entity,node_user_entity,node_report_repository,node_user_repository,node_database toneAmber
class node_auth_service,node_jwt_provider,node_user_details toneMint
class node_alert_entity,node_alert_repository,node_alert_service,node_fcm_service,node_file_service,node_file_properties toneRose
class node_villagers,node_firebase toneIndigo
```

## Components

### API workflows

- [Authentication API](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/controller/AuthController.java): `backend/src/main/java/com/forestedge/controller/AuthController.java`
- [Report API](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/controller/ReportController.java): `backend/src/main/java/com/forestedge/controller/ReportController.java`
- [File API](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/controller/FileController.java): `backend/src/main/java/com/forestedge/controller/FileController.java`

### Wildlife domain

- [Report workflow](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/ReportService.java): `backend/src/main/java/com/forestedge/service/ReportService.java`
- [Animal reports](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/model/AnimalReport.java): `backend/src/main/java/com/forestedge/model/AnimalReport.java`
- [Users and roles](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/model/User.java): `backend/src/main/java/com/forestedge/model/User.java`
- [Report repository](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/repository/ReportRepository.java): `backend/src/main/java/com/forestedge/repository/ReportRepository.java`
- [User repository](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/repository/UserRepository.java): `backend/src/main/java/com/forestedge/repository/UserRepository.java`

### Identity and security

- [Authentication service](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/AuthService.java): `backend/src/main/java/com/forestedge/service/AuthService.java`
- [JWT token provider](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/security/JwtTokenProvider.java): `backend/src/main/java/com/forestedge/security/JwtTokenProvider.java`
- [User details lookup](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/security/UserDetailsServiceImpl.java): `backend/src/main/java/com/forestedge/security/UserDetailsServiceImpl.java`

### Alerts and files

- [Alert records](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/model/Alert.java): `backend/src/main/java/com/forestedge/model/Alert.java`
- [Alert repository](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/repository/AlertRepository.java): `backend/src/main/java/com/forestedge/repository/AlertRepository.java`
- [Alert dispatch](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/AlertService.java): `backend/src/main/java/com/forestedge/service/AlertService.java`
- [Firebase messaging](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/FCMService.java): `backend/src/main/java/com/forestedge/service/FCMService.java`
- [File storage](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/service/FileStorageService.java): `backend/src/main/java/com/forestedge/service/FileStorageService.java`
- [Storage configuration](https://github.com/kalainidhias/forest-edge/blob/main/backend/src/main/java/com/forestedge/config/FileStorageProperties.java): `backend/src/main/java/com/forestedge/config/FileStorageProperties.java`

### Other components

- **Villagers and officers**
- **MySQL database**
- **Firebase Cloud Messaging**

## Connections

- Report API → Report workflow: delegates reports (evidence: `backend/src/main/java/com/forestedge/controller/ReportController.java`)
- Report API → User repository: looks up caller (evidence: `backend/src/main/java/com/forestedge/controller/ReportController.java`)
- Report workflow → Report repository: reads and writes (evidence: `backend/src/main/java/com/forestedge/service/ReportService.java`)
- Report workflow → User repository: loads users (evidence: `backend/src/main/java/com/forestedge/service/ReportService.java`)
- Report workflow → Alert dispatch: triggers alerts (evidence: `backend/src/main/java/com/forestedge/service/ReportService.java`)
- Report workflow → Alert repository: deletes related alerts (evidence: `backend/src/main/java/com/forestedge/service/ReportService.java`)
- Report repository → Animal reports: persists reports (evidence: `backend/src/main/java/com/forestedge/repository/ReportRepository.java`)
- User repository → Users and roles: queries users (evidence: `backend/src/main/java/com/forestedge/repository/UserRepository.java`)
- Alert dispatch → User repository: finds recipients (evidence: `backend/src/main/java/com/forestedge/service/AlertService.java`)
- Alert dispatch → Alert repository: saves alerts (evidence: `backend/src/main/java/com/forestedge/service/AlertService.java`)
- Alert dispatch → Firebase messaging: sends notifications (evidence: `backend/src/main/java/com/forestedge/service/AlertService.java`)
- Alert repository → Alert records: persists alerts (evidence: `backend/src/main/java/com/forestedge/repository/AlertRepository.java`)
- Firebase messaging → Firebase Cloud Messaging: dispatches pushes (evidence: `README.md`)
- File API → File storage: stores and loads files (evidence: `backend/src/main/java/com/forestedge/controller/FileController.java`)
- File storage → Storage configuration: reads upload settings (evidence: `backend/src/main/java/com/forestedge/service/FileStorageService.java`)
- Authentication service → User repository: saves and finds users (evidence: `backend/src/main/java/com/forestedge/service/AuthService.java`)
- Authentication service → JWT token provider: creates tokens (evidence: `backend/src/main/java/com/forestedge/service/AuthService.java`)
- User details lookup → User repository: loads account (evidence: `backend/src/main/java/com/forestedge/security/UserDetailsServiceImpl.java`)
- Villagers and officers → Authentication API: registers or logs in (evidence: `README.md`)
- Villagers and officers → Report API: submits sightings (evidence: `README.md`)
- Report workflow → MySQL database: stores report data (evidence: `README.md`)
- Authentication service → MySQL database: stores account data (evidence: `README.md`)
