# nilorac86/invasiveplants architecture

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

- Interactive diagram: https://gitdiagram.com/nilorac86/invasiveplants
- Repository: https://github.com/nilorac86/invasiveplants

## Overview

Invasiva Växter is a community reporting and rewards web app: users browse invasive species, submit sightings and removal evidence, and earn points after admin review. The React app routes users through these tasks and calls a Spring REST backend, whose services coordinate validation, domain operations, and persistence. The README documents the main capabilities; sampled code confirms routing, authentication, reporting, profile aggregation, and admin review. Several feature-specific pages, controllers, and services are unsampled, so their detailed call relationships are not asserted.

Main entry points: [`frontend/src/service`](https://github.com/nilorac86/invasiveplants/tree/main/frontend/src/service) (Frontend services), [`frontend/src/App.js`](https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/App.js) (App routes), [`src/main/java/com/carolin/invasiveplants/Service/UserService.java`](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/UserService.java) (User profiles), [`src/main/java/com/carolin/invasiveplants/Service/AdminService.java`](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/AdminService.java) (Admin operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app_router["App routes<br/>[App.js]"]
  node_species_browse["Species catalog<br/>[PlantCardsPage.js]"]
  node_species_detail["Species details"]
  node_sighting_form["Sighting form"]
  node_removal_form["Removal form<br/>[RemovePlantForm.js]"]
  node_admin_review_ui["Admin review UI"]
  node_frontend_services["Frontend services"]
  node_api_client["API client<br/>[Api.js]"]
end

subgraph group_identity["Identity and profiles"]
  node_auth_api["Authentication API"]
  node_auth_logic["Authentication service<br/>[AuthService.java]"]
  node_user_api["User API"]
  node_user_logic["User profiles<br/>[UserService.java]"]
  node_user_store[("User records")]
end

subgraph group_plant_ops["Plant reporting and review"]
  node_admin_api["Admin API"]
  node_admin_logic["Admin operations<br/>[AdminService.java]"]
  node_report_api["Sightings API"]
  node_report_logic["Sightings service"]
  node_removal_api["Removal API"]
  node_removal_logic["Removal service"]
  node_plant_store[("Plant records")]
  node_removal_store[("Removal records")]
end

subgraph group_rewards["Rewards and persistence"]
  node_reward_api["Rewards API"]
  node_reward_logic["Rewards service<br/>[RewardService.java]"]
  node_reward_store[("Reward records")]
end

node_visitor(("Public user"))
node_admin_actor(("Administrator"))

node_visitor -->|"uses"| node_app_router
node_admin_actor -->|"uses"| node_app_router
node_app_router -->|"routes to"| node_species_browse
node_app_router -->|"routes to"| node_species_detail
node_app_router -->|"routes to"| node_sighting_form
node_app_router -->|"routes to"| node_removal_form
node_app_router -.->|"routes to"| node_admin_review_ui
node_sighting_form -->|"submits through"| node_frontend_services
node_frontend_services -->|"uses"| node_api_client
node_frontend_services -.->|"calls REST"| node_auth_api
node_frontend_services -.->|"calls REST"| node_report_api
node_frontend_services -.->|"calls REST"| node_removal_api
node_frontend_services -.->|"calls REST"| node_admin_api
node_frontend_services -.->|"calls REST"| node_user_api
node_frontend_services -.->|"calls REST"| node_reward_api
node_auth_api -->|"delegates to"| node_auth_logic
node_auth_logic -->|"reads"| node_user_store
node_user_api -->|"delegates to"| node_user_logic
node_user_logic -->|"reads and writes"| node_user_store
node_user_logic -->|"reads"| node_plant_store
node_user_logic -->|"reads"| node_removal_store
node_admin_api -->|"delegates to"| node_admin_logic
node_admin_logic -->|"writes"| node_plant_store
node_admin_logic -->|"reviews"| node_removal_store
node_admin_logic -.->|"writes"| node_reward_store
node_report_api -.->|"delegates to"| node_report_logic
node_report_logic -->|"writes"| node_plant_store
node_removal_api -.->|"delegates to"| node_removal_logic
node_removal_logic -.->|"writes"| node_removal_store
node_reward_api -.->|"delegates to"| node_reward_logic
node_reward_logic -.->|"reads and writes"| node_reward_store

click node_app_router "https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/App.js"
click node_species_browse "https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/Pages/PlantCardsPage.js"
click node_species_detail "https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/Pages/SpeciesDetailPage.js"
click node_sighting_form "https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/components/ReportPlantForm.jsx"
click node_removal_form "https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/Pages/RemovePlantForm.js"
click node_admin_review_ui "https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/Pages/AdminProfilePage.js"
click node_frontend_services "https://github.com/nilorac86/invasiveplants/tree/main/frontend/src/service"
click node_api_client "https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/util/Api.js"
click node_auth_api "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Controller/AuthController.java"
click node_auth_logic "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/AuthService.java"
click node_user_api "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Controller/UserController.java"
click node_user_logic "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/UserService.java"
click node_admin_api "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Controller/AdminController.java"
click node_admin_logic "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/AdminService.java"
click node_report_api "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Controller/ReportPlantController.java"
click node_report_logic "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/ReportPlantService.java"
click node_removal_api "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Controller/RemovePlantController.java"
click node_removal_logic "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/RemovePlantService.java"
click node_reward_api "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Controller/RewardController.java"
click node_reward_logic "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/RewardService.java"
click node_plant_store "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Repository/PlantRepository.java"
click node_removal_store "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Repository/RemovePlantRepository.java"
click node_user_store "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Repository/UserRepository.java"
click node_reward_store "https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Repository/RewardRepository.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_app_router,node_species_browse,node_species_detail,node_sighting_form,node_removal_form,node_admin_review_ui,node_frontend_services,node_api_client,node_visitor toneBlue
class node_auth_api,node_auth_logic,node_user_api,node_user_logic,node_user_store toneAmber
class node_admin_api,node_admin_logic,node_report_api,node_report_logic,node_removal_api,node_removal_logic,node_plant_store,node_removal_store toneMint
class node_reward_api,node_reward_logic,node_reward_store toneRose
class node_admin_actor toneIndigo
```

## Components

### Web experience

- [App routes](https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Species catalog](https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/Pages/PlantCardsPage.js): `frontend/src/Pages/PlantCardsPage.js`
- [Species details](https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/Pages/SpeciesDetailPage.js): `frontend/src/Pages/SpeciesDetailPage.js`
- [Sighting form](https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/components/ReportPlantForm.jsx): `frontend/src/components/ReportPlantForm.jsx`
- [Removal form](https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/Pages/RemovePlantForm.js): `frontend/src/Pages/RemovePlantForm.js`
- [Admin review UI](https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/Pages/AdminProfilePage.js): `frontend/src/Pages/AdminProfilePage.js`
- [Frontend services](https://github.com/nilorac86/invasiveplants/tree/main/frontend/src/service): `frontend/src/service`
- [API client](https://github.com/nilorac86/invasiveplants/blob/main/frontend/src/util/Api.js): `frontend/src/util/Api.js`

### Identity and profiles

- [Authentication API](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Controller/AuthController.java): `src/main/java/com/carolin/invasiveplants/Controller/AuthController.java`
- [Authentication service](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/AuthService.java): `src/main/java/com/carolin/invasiveplants/Service/AuthService.java`
- [User API](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Controller/UserController.java): `src/main/java/com/carolin/invasiveplants/Controller/UserController.java`
- [User profiles](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/UserService.java): `src/main/java/com/carolin/invasiveplants/Service/UserService.java`
- [User records](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Repository/UserRepository.java): `src/main/java/com/carolin/invasiveplants/Repository/UserRepository.java`

### Plant reporting and review

- [Admin API](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Controller/AdminController.java): `src/main/java/com/carolin/invasiveplants/Controller/AdminController.java`
- [Admin operations](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/AdminService.java): `src/main/java/com/carolin/invasiveplants/Service/AdminService.java`
- [Sightings API](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Controller/ReportPlantController.java): `src/main/java/com/carolin/invasiveplants/Controller/ReportPlantController.java`
- [Sightings service](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/ReportPlantService.java): `src/main/java/com/carolin/invasiveplants/Service/ReportPlantService.java`
- [Removal API](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Controller/RemovePlantController.java): `src/main/java/com/carolin/invasiveplants/Controller/RemovePlantController.java`
- [Removal service](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/RemovePlantService.java): `src/main/java/com/carolin/invasiveplants/Service/RemovePlantService.java`
- [Plant records](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Repository/PlantRepository.java): `src/main/java/com/carolin/invasiveplants/Repository/PlantRepository.java`
- [Removal records](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Repository/RemovePlantRepository.java): `src/main/java/com/carolin/invasiveplants/Repository/RemovePlantRepository.java`

### Rewards and persistence

- [Rewards API](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Controller/RewardController.java): `src/main/java/com/carolin/invasiveplants/Controller/RewardController.java`
- [Rewards service](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Service/RewardService.java): `src/main/java/com/carolin/invasiveplants/Service/RewardService.java`
- [Reward records](https://github.com/nilorac86/invasiveplants/blob/main/src/main/java/com/carolin/invasiveplants/Repository/RewardRepository.java): `src/main/java/com/carolin/invasiveplants/Repository/RewardRepository.java`

### Other components

- **Public user**
- **Administrator**

## Connections

- Public user → App routes: uses (evidence: `README.md`)
- Administrator → App routes: uses (evidence: `README.md`)
- App routes → Species catalog: routes to (evidence: `frontend/src/App.js`)
- App routes → Species details: routes to (evidence: `frontend/src/App.js`)
- App routes → Sighting form: routes to (evidence: `frontend/src/App.js`)
- App routes → Removal form: routes to (evidence: `frontend/src/App.js`)
- App routes → Admin review UI: routes to
- Sighting form → Frontend services: submits through (evidence: `frontend/src/components/ReportPlantForm.jsx`)
- Frontend services → API client: uses (evidence: `frontend/src/service/NotificationService.js`)
- Frontend services → Authentication API: calls REST
- Frontend services → Sightings API: calls REST
- Frontend services → Removal API: calls REST
- Frontend services → Admin API: calls REST
- Frontend services → User API: calls REST
- Frontend services → Rewards API: calls REST
- Authentication API → Authentication service: delegates to (evidence: `src/main/java/com/carolin/invasiveplants/Controller/AuthController.java`)
- Authentication service → User records: reads (evidence: `src/main/java/com/carolin/invasiveplants/Service/AuthService.java`)
- User API → User profiles: delegates to (evidence: `src/main/java/com/carolin/invasiveplants/Controller/UserController.java`)
- User profiles → User records: reads and writes (evidence: `src/main/java/com/carolin/invasiveplants/Service/UserService.java`)
- User profiles → Plant records: reads (evidence: `src/main/java/com/carolin/invasiveplants/Service/UserService.java`)
- User profiles → Removal records: reads (evidence: `src/main/java/com/carolin/invasiveplants/Service/UserService.java`)
- Admin API → Admin operations: delegates to (evidence: `src/main/java/com/carolin/invasiveplants/Controller/AdminController.java`)
- Admin operations → Plant records: writes (evidence: `src/main/java/com/carolin/invasiveplants/Service/AdminService.java`)
- Admin operations → Removal records: reviews (evidence: `src/main/java/com/carolin/invasiveplants/Service/AdminService.java`)
- Admin operations → Reward records: writes (evidence: `src/main/java/com/carolin/invasiveplants/Service/AdminService.java`)
- Sightings API → Sightings service: delegates to (evidence: `src/main/java/com/carolin/invasiveplants/Controller/ReportPlantController.java`)
- Sightings service → Plant records: writes (evidence: `src/main/java/com/carolin/invasiveplants/Service/ReportPlantService.java`)
- Removal API → Removal service: delegates to
- Removal service → Removal records: writes (evidence: `src/main/java/com/carolin/invasiveplants/Service/RemovePlantService.java`)
- Rewards API → Rewards service: delegates to
- Rewards service → Reward records: reads and writes
