# omborekar/terraspotter-mapping-the-right-place-to-plant architecture

> Architecture diagram of the GitHub repository omborekar/terraspotter-mapping-the-right-place-to-plant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-04-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/omborekar/terraspotter-mapping-the-right-place-to-plant
- Repository: https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant

## Overview

1. **Overall shape**
   TerraSpotter is a three-part system: a **Spring Boot backend** for core business logic and persistence, a **React/Vite frontend** for the user experience, and a separate **Flask ML service** for tree recommendation predictions. The backend is the main system of record; the frontend is a thin client; the ML service is an external dependency.

2. **Backend boundary and responsibilities**
   The backend (`backend/`) owns authentication, user management, land registration, land verification, plantation tracking, reviews, and aggregate stats. Its controllers are split by domain: `Auth`, `ForgotPassword`, `User`, `Land`, `LandVerification`, `Plantation`, and `Stats`. This is a conventional layered Spring architecture: controller → service → repository → database.

3. **Domain model**
   The backend’s entities show the business concepts explicitly: `User`, `Land`, `LandImage`, `LandRecommendation`, `LandReview`, `LandVerification`, `PlantationStart`, `PlantationCompletion`, `PlantationCompletionImage`, `PlantationReview`, and `PlantationReviewImage`. This suggests a workflow where a land parcel is registered, reviewed/verified, matched with recommendations, and then tracked through plantation start/completion and post-planting feedback.

4. **Persistence and schema**
   Data is persisted through Spring Data repositories and initialized via Flyway (`backend/src/main/resources/db/migration/V1__init.sql`). The repository layer is separated by aggregate, e.g. `LandRepository`, `LandVerificationRepository`, `PlantationStartRepository`, `UserRepository`, and image/review repositories. The README indicates PostgreSQL is the intended database, with configuration managed in `application.properties`.

5. **Authentication and security**
   Security is centralized in `SecurityConfig` with `CustomUserDetailsService` backing Spring Security user lookup. `AuthService`, `AuthController`, `SignupRequest`, and `LoginRequest` indicate standard login/signup flows. Password recovery is handled separately by `ForgotPasswordController`, `BrevoEmailService`, and `OtpStore`, which implies email-based OTP reset flow with temporary in-memory OTP state.

6. **External storage and media**
   Image uploads are offloaded to Cloudinary via `CloudinaryConfig` and `CloudinaryService`. This is important to the architecture because land images and plantation review/completion images are modeled separately in the database, while the actual binary media is stored externally. The backend therefore manages metadata and references, not file blobs.

7. **Land intelligence and recommendation flow**
   The “smart” part of the platform is centered on land evaluation. `LandService`, `LandRecommendation`, and `LandVerificationService` indicate a pipeline where land attributes and images are captured, then reviewed/verified, and finally used to generate recommendations or readiness status. This is the main bridge between user-submitted land data and the recommendation/plantation workflow.

8. **Plantation coordination and showcase**
   The plantation side is tracked separately from land registration. `PlantationStart`, `PlantationCompletion`, and the corresponding image entities model project progress over time. `PlantationShowcaseService` and `PlantationShowcaseDTO` suggest a curated view of planting projects for public or community-facing display, distinct from the internal operational records.

9. **Stats and reporting**
   `StatsController` and `StatsService` form a read-only aggregation layer for analytics or dashboard metrics. This is likely derived from the transactional domain tables rather than maintained as a separate source of truth, so it acts as a reporting boundary over the core operational data.

10. **Frontend application structure**
   The frontend (`frontend/`) is a Vite + React app composed of page-like components such as `Landing`, `Browse`, `SiteDetail`, `Login`, `Signup`, `ForgotPassword`, `Profile`, `PlantationForm`, `Reviewspage`, `AdminPendingLands`, and `AdminLandDetail`. `ProtectedRoute` indicates route-level access control on the client, while `Navbar`, `Main`, and `App.jsx` orchestrate navigation and page layout.

11. **Frontend-to-backend interaction**
   The frontend is responsible for user interaction and calls the backend API for auth, land browsing, profile operations, and plantation workflows. `frontend/src/lib/utils.js` likely centralizes API base URL configuration, which makes the client deployable across environments. The React UI also includes specialized components such as `ContributionMap` and modal/form components for plantation completion, showing that map-driven land exploration is a major UX path.

12. **ML service boundary**
   The `models/` directory is a separate Flask application, not part of the Spring runtime. It loads a pre-trained model from `tree_model.pkl` and data from `data.csv`, exposing a `/predict` endpoint with environmental inputs (`temp`, `rainfall`, `soil`, `climate`). This service is an external inference engine for species recommendation and is intentionally decoupled from the main app stack.

13. **Deployment and packaging**
   The repo contains independent deployment artifacts for each subsystem: `backend/Dockerfile` for the Spring app, `frontend/vercel.json` for frontend hosting, and Python packaging in `models/requirements.txt`. This supports separate scaling and deployment of the API, UI, and ML inference service.

14. **Key system flow to diagram**
   The most important end-to-end path is: user interacts with the React UI → frontend sends requests to the Spring backend → backend authenticates, persists domain data, stores images in Cloudinary, sends OTP emails via Brevo when needed, and consults the ML service for recommendation predictions → backend returns curated land/plantation data and stats back to the UI. The database remains the authoritative store for all business records except external media and ML model artifacts.

Main entry points: [`backend/src/main/java/com/example/terraspoter/TerraSpoterApplication.java`](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/TerraSpoterApplication.java) (TerraSpoter), [`frontend/src/components/Landing.jsx`](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/frontend/src/components/Landing.jsx) (Pages), [`backend/src/main/java/com/example/terraspoter/repository/UserRepository.java`](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/repository/UserRepository.java) (Repositories), [`frontend/src/App.jsx`](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/frontend/src/App.jsx) (React app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_backend["Spring backend"]
  node_backend_app(("TerraSpoter<br/>Spring Boot app"))
  node_backend_security["Security"]
  node_backend_auth_controller["Auth API<br/>controller"]
  node_backend_forgot_controller["Reset API<br/>controller"]
  node_backend_land_controller["Land API<br/>controller"]
  node_backend_verification_controller["Verify API<br/>controller"]
  node_backend_plantation_controller["Plantation API<br/>controller"]
  node_backend_stats_controller["Stats API<br/>controller"]
  node_backend_user_controller["User API<br/>controller"]
  node_backend_auth_service["Auth svc<br/>[AuthService.java]"]
  node_backend_user_details["User details<br/>security service"]
  node_backend_land_service["Land svc<br/>[LandService.java]"]
  node_backend_verification_service["Verify svc"]
  node_backend_plantation_showcase["Showcase svc"]
  node_backend_stats_service["Stats svc<br/>[StatsService.java]"]
  node_backend_cloudinary["Media storage<br/>external storage"]
  node_backend_email_otp["Email OTP<br/>email + otp"]
  node_backend_repositories[("Repositories<br/>Spring Data layer")]
  node_backend_domain[("Domain model<br/>JPA entities<br/>[User.java]")]
  node_backend_db[("PostgreSQL<br/>database<br/>[V1__init.sql]")]
end

subgraph group_frontend["React frontend"]
  node_frontend_app(("React app<br/>Vite app<br/>[App.jsx]"))
  node_frontend_routes["Pages<br/>[Landing.jsx]"]
  node_frontend_shell["Shell<br/>layout<br/>[Navbar.jsx]"]
  node_frontend_map["Map UI<br/>feature UI"]
  node_frontend_utils["API utils<br/>client config<br/>[utils.js]"]
end

subgraph group_ml["ML service"]
  node_ml_app(("Flask app<br/>Flask inference<br/>[app.py]"))
  node_ml_model["Tree model<br/>prediction model<br/>[predict.py]"]
end

node_backend_app -->|"uses"| node_backend_security
node_backend_app -->|"hosts"| node_backend_auth_controller
node_backend_app -->|"hosts"| node_backend_forgot_controller
node_backend_app -->|"hosts"| node_backend_land_controller
node_backend_app -->|"hosts"| node_backend_verification_controller
node_backend_app -->|"hosts"| node_backend_plantation_controller
node_backend_app -->|"hosts"| node_backend_stats_controller
node_backend_app -->|"hosts"| node_backend_user_controller
node_backend_auth_controller -->|"calls"| node_backend_auth_service
node_backend_forgot_controller -->|"uses"| node_backend_email_otp
node_backend_auth_service -->|"depends on"| node_backend_user_details
node_backend_land_controller -->|"calls"| node_backend_land_service
node_backend_verification_controller -->|"calls"| node_backend_verification_service
node_backend_plantation_controller -->|"calls"| node_backend_plantation_showcase
node_backend_stats_controller -->|"calls"| node_backend_stats_service
node_backend_land_service -->|"persists via"| node_backend_repositories
node_backend_verification_service -->|"persists via"| node_backend_repositories
node_backend_plantation_showcase -->|"reads via"| node_backend_repositories
node_backend_stats_service -->|"aggregates via"| node_backend_repositories
node_backend_repositories -->|"maps"| node_backend_domain
node_backend_repositories -->|"stores in"| node_backend_db
node_backend_land_service -->|"uploads to"| node_backend_cloudinary
node_backend_plantation_showcase -->|"uploads to"| node_backend_cloudinary
node_frontend_app -->|"composes"| node_frontend_shell
node_frontend_app -->|"renders"| node_frontend_routes
node_frontend_routes -->|"uses"| node_frontend_map
node_frontend_app -->|"configures"| node_frontend_utils
node_frontend_app -.->|"calls"| node_backend_auth_controller
node_frontend_routes -.->|"calls"| node_backend_land_controller
node_frontend_routes -.->|"calls"| node_backend_plantation_controller
node_frontend_routes -.->|"calls"| node_backend_user_controller
node_frontend_routes -.->|"calls"| node_backend_stats_controller
node_backend_land_service -.->|"predicts via"| node_ml_app
node_ml_app -->|"serves"| node_ml_model

click node_backend_app "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/TerraSpoterApplication.java"
click node_backend_security "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/config/SecurityConfig.java"
click node_backend_auth_controller "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/AuthController.java"
click node_backend_forgot_controller "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/ForgotPasswordController.java"
click node_backend_land_controller "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/LandController.java"
click node_backend_verification_controller "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/LandVerificationController.java"
click node_backend_plantation_controller "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/PlantationController.java"
click node_backend_stats_controller "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/StatsController.java"
click node_backend_user_controller "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/UserController.java"
click node_backend_auth_service "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/AuthService.java"
click node_backend_user_details "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/CustomUserDetailsService.java"
click node_backend_land_service "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/LandService.java"
click node_backend_verification_service "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/LandVerificationService.java"
click node_backend_plantation_showcase "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/PlantationShowcaseService.java"
click node_backend_stats_service "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/StatsService.java"
click node_backend_cloudinary "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/CloudinaryService.java"
click node_backend_email_otp "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/BrevoEmailService.java"
click node_backend_repositories "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/repository/UserRepository.java"
click node_backend_domain "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/model/User.java"
click node_backend_db "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/resources/db/migration/V1__init.sql"
click node_frontend_app "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/frontend/src/App.jsx"
click node_frontend_routes "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/frontend/src/components/Landing.jsx"
click node_frontend_shell "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/frontend/src/components/Navbar.jsx"
click node_frontend_map "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/frontend/src/components/ContributionMap.jsx"
click node_frontend_utils "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/frontend/src/lib/utils.js"
click node_ml_app "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/models/app.py"
click node_ml_model "https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/models/model/predict.py"

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_backend_app,node_backend_security,node_backend_auth_controller,node_backend_forgot_controller,node_backend_land_controller,node_backend_verification_controller,node_backend_plantation_controller,node_backend_stats_controller,node_backend_user_controller,node_backend_auth_service,node_backend_user_details,node_backend_land_service,node_backend_verification_service,node_backend_plantation_showcase,node_backend_stats_service,node_backend_cloudinary,node_backend_email_otp,node_backend_repositories,node_backend_domain,node_backend_db toneBlue
class node_frontend_app,node_frontend_routes,node_frontend_shell,node_frontend_map,node_frontend_utils toneAmber
class node_ml_app,node_ml_model toneMint
```

## Components

### Spring backend

System of record for auth, land, plantation, stats, and persistence.

- [TerraSpoter](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/TerraSpoterApplication.java): Spring Boot app · Backend application entrypoint. · `backend/src/main/java/com/example/terraspoter/TerraSpoterApplication.java`
- [Security](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/config/SecurityConfig.java): Spring security · Central authentication and request security configuration. · `backend/src/main/java/com/example/terraspoter/config/SecurityConfig.java`
- [Auth API](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/AuthController.java): controller · Login and signup endpoints. · `backend/src/main/java/com/example/terraspoter/controller/AuthController.java`
- [Reset API](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/ForgotPasswordController.java): controller · Password recovery and OTP reset endpoints. · `backend/src/main/java/com/example/terraspoter/controller/ForgotPasswordController.java`
- [Land API](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/LandController.java): controller · Land registration, browsing, and recommendation endpoints. · `backend/src/main/java/com/example/terraspoter/controller/LandController.java`
- [Verify API](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/LandVerificationController.java): controller · Land verification workflow endpoints. · `backend/src/main/java/com/example/terraspoter/controller/LandVerificationController.java`
- [Plantation API](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/PlantationController.java): controller · Plantation start, completion, review, and showcase endpoints. · `backend/src/main/java/com/example/terraspoter/controller/PlantationController.java`
- [Stats API](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/StatsController.java): controller · Read-only aggregate metrics endpoints. · `backend/src/main/java/com/example/terraspoter/controller/StatsController.java`
- [User API](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/controller/UserController.java): controller · User profile and account endpoints. · `backend/src/main/java/com/example/terraspoter/controller/UserController.java`
- [Auth svc](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/AuthService.java): service · Authentication, account access, and user lookup orchestration. · `backend/src/main/java/com/example/terraspoter/service/AuthService.java`
- [User details](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/CustomUserDetailsService.java): security service · Spring Security user loading for authenticated principals. · `backend/src/main/java/com/example/terraspoter/service/CustomUserDetailsService.java`
- [Land svc](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/LandService.java): service · Land lifecycle, recommendation, and domain coordination. · `backend/src/main/java/com/example/terraspoter/service/LandService.java`
- [Verify svc](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/LandVerificationService.java): service · Land verification processing and status updates. · `backend/src/main/java/com/example/terraspoter/service/LandVerificationService.java`
- [Showcase svc](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/PlantationShowcaseService.java): service · Curated plantation view generation. · `backend/src/main/java/com/example/terraspoter/service/PlantationShowcaseService.java`
- [Stats svc](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/StatsService.java): service · Aggregation for reporting and dashboard metrics. · `backend/src/main/java/com/example/terraspoter/service/StatsService.java`
- [Media storage](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/CloudinaryService.java): external storage · Cloudinary integration for uploaded land and plantation images. · `backend/src/main/java/com/example/terraspoter/service/CloudinaryService.java`
- [Email OTP](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/service/BrevoEmailService.java): email + otp · Brevo email delivery and temporary OTP state for password recovery. · `backend/src/main/java/com/example/terraspoter/service/BrevoEmailService.java`
- [Repositories](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/repository/UserRepository.java): Spring Data layer · Persistence access for users, lands, verifications, plantations, and images. · `backend/src/main/java/com/example/terraspoter/repository/UserRepository.java`
- [Domain model](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/java/com/example/terraspoter/model/User.java): JPA entities · Users, lands, reviews, verifications, recommendations, and plantation records. · `backend/src/main/java/com/example/terraspoter/model/User.java`
- [PostgreSQL](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/backend/src/main/resources/db/migration/V1__init.sql): database · Primary persistent store initialized by Flyway migrations. · `backend/src/main/resources/db/migration/V1__init.sql`

### React frontend

User-facing client for browsing, forms, profiles, and admin workflows.

- [React app](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/frontend/src/App.jsx): Vite app · Frontend application shell and routing bootstrap. · `frontend/src/App.jsx`
- [Pages](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/frontend/src/components/Landing.jsx): UI pages · Landing, browse, auth, profile, plantation, and admin screens. · `frontend/src/components/Landing.jsx`
- [Shell](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/frontend/src/components/Navbar.jsx): layout · Navbar, main layout, and protected route gating. · `frontend/src/components/Navbar.jsx`
- [Map UI](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/frontend/src/components/ContributionMap.jsx): feature UI · Contribution map and plantation completion interactions. · `frontend/src/components/ContributionMap.jsx`
- [API utils](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/frontend/src/lib/utils.js): client config · Client-side API/base URL and shared helpers. · `frontend/src/lib/utils.js`

### ML service

Separate Flask inference service for tree recommendations.

- [Flask app](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/models/app.py): Flask inference · Standalone prediction service entrypoint. · `models/app.py`
- [Tree model](https://github.com/omborekar/terraspotter-mapping-the-right-place-to-plant/blob/main/models/model/predict.py): prediction model · Trained model and prediction logic for species recommendation. · `models/model/predict.py`

## Connections

- TerraSpoter → Security: uses · Bootstraps the security layer.
- TerraSpoter → Auth API: hosts · Exposes auth endpoints.
- TerraSpoter → Reset API: hosts · Exposes password reset endpoints.
- TerraSpoter → Land API: hosts · Exposes land endpoints.
- TerraSpoter → Verify API: hosts · Exposes verification endpoints.
- TerraSpoter → Plantation API: hosts · Exposes plantation endpoints.
- TerraSpoter → Stats API: hosts · Exposes stats endpoints.
- TerraSpoter → User API: hosts · Exposes user endpoints.
- Auth API → Auth svc: calls · Delegates login/signup logic.
- Reset API → Email OTP: uses · Sends recovery emails and manages OTP state.
- Auth svc → User details: depends on · Uses Spring Security user lookup.
- Land API → Land svc: calls · Delegates land workflow operations.
- Verify API → Verify svc: calls · Delegates land verification operations.
- Plantation API → Showcase svc: calls · Builds showcase views and plantation responses.
- Stats API → Stats svc: calls · Serves aggregated metrics.
- Land svc → Repositories: persists via · Reads and writes land-related data.
- Verify svc → Repositories: persists via · Updates verification records.
- Showcase svc → Repositories: reads via · Assembles curated plantation data.
- Stats svc → Repositories: aggregates via · Derives metrics from transactional data.
- Repositories → Domain model: maps · Repositories operate on the entity model.
- Repositories → PostgreSQL: stores in · Persists records in PostgreSQL.
- Land svc → Media storage: uploads to · Stores land and related images externally.
- Showcase svc → Media storage: uploads to · Stores plantation media externally.
- React app → Shell: composes · Wires navigation and route protection.
- React app → Pages: renders · Provides page-level screens.
- Pages → Map UI: uses · Shows map-centric land exploration and completion flows.
- React app → API utils: configures · Uses shared API/client helpers.
- React app → Auth API: calls · Sends auth requests to the backend API.
- Pages → Land API: calls · Browses and submits land data.
- Pages → Plantation API: calls · Submits plantation workflow data.
- Pages → User API: calls · Loads profile and account data.
- Pages → Stats API: calls · Loads dashboard metrics where needed.
- Land svc → Flask app: predicts via · Consults the external ML recommendation service.
- Flask app → Tree model: serves · Loads the trained tree recommendation model.
