# plantbookpro/lab1-monolith architecture

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

- Interactive diagram: https://gitdiagram.com/plantbookpro/lab1-monolith
- Repository: https://github.com/plantbookpro/lab1-monolith

## Overview

Plant Arena is a modular-monolith backend for plant competitions. A user uploads an image, submits it as a plant, and the plant is automatically moderated before becoming eligible for private or global competition. Tournament scheduling advances voting rounds and results; the feed presents eligible entries and voting context. The README documents these domain handoffs, while sampled source confirms selected application behavior. Most tournament, identity, geo, and wiring implementations were not excerpted, so their internal calls are not asserted.

Main entry points: [`src/main/java/com/plantarena/plants/application/PlantService.java`](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/plants/application/PlantService.java) (Plant Lifecycle), [`src/main/java/com/plantarena/tournaments/application/AdvanceGlobalCompetitionService.java`](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/application/AdvanceGlobalCompetitionService.java) (Round Advancement), [`src/main/java/com/plantarena/feed/application/FeedService.java`](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/feed/application/FeedService.java) (Feed Projection), [`src/main/java/com/plantarena/tournaments/application/GlobalQueryService.java`](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/application/GlobalQueryService.java) (Global Competition)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and Profiles"]
  node_identity_api["Profiles and Roles"]
  node_actor["Current Actor<br/>[CurrentActor.java]"]
end

subgraph group_plant_media["Plants and Media"]
  node_media_api["Image Uploads"]
  node_media_store["Media Storage"]
  node_plants_api["Plant Lifecycle<br/>[PlantService.java]"]
  node_plant_store[("Plant Records")]
end

subgraph group_moderation["Image Moderation"]
  node_moderation_jobs["Moderation Jobs"]
  node_classifier["Plant Classifier"]
end

subgraph group_competition["Tournaments and Voting"]
  node_tournament_api["Private Tournaments"]
  node_invitations["Invitations"]
  node_rounds["Round Advancement"]
  node_voting["Voting and Results"]
  node_global["Global Competition"]
  node_tournament_store[("Competition State")]
  node_guest["Guest Sessions"]
end

subgraph group_discovery["Geo and Feed"]
  node_geo["Geo Clustering"]
  node_feed["Feed Projection<br/>[FeedService.java]"]
  node_feed_store[("Feed Cards")]
end

node_user(("User"))
node_api_client(("API Client"))

node_user -->|"manages profile"| node_identity_api
node_user -->|"uploads image"| node_media_api
node_media_api -->|"stores image"| node_media_store
node_user -->|"submits plant"| node_plants_api
node_plants_api -->|"claims asset"| node_media_api
node_plants_api -.->|"persists plant"| node_plant_store
node_plants_api -->|"publishes submission"| node_moderation_jobs
node_moderation_jobs -->|"classifies image"| node_classifier
node_moderation_jobs -.->|"applies decision"| node_plants_api
node_user -->|"creates tournament"| node_tournament_api
node_tournament_api -->|"manages invites"| node_invitations
node_invitations -->|"reserves plant"| node_plants_api
node_tournament_api -->|"starts competition"| node_rounds
node_rounds -->|"opens voting"| node_voting
node_user -->|"casts vote"| node_voting
node_voting -->|"closes window"| node_rounds
node_rounds -.->|"records rounds"| node_tournament_store
node_user -->|"joins global"| node_global
node_global -->|"clusters entrants"| node_geo
node_geo -.->|"assigns clusters"| node_global
node_global -->|"advances finals"| node_rounds
node_api_client -->|"requests feed"| node_feed
node_feed -.->|"queries cards"| node_feed_store
node_feed -->|"checks voted entries"| node_voting
node_feed -->|"resolves guest token"| node_guest
node_user -->|"creates session"| node_guest
node_api_client -.->|"uses API"| node_identity_api
node_actor -.->|"supplies subject"| node_identity_api

click node_identity_api "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/identity/application/UserAdministrationService.java"
click node_actor "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/shared/security/CurrentActor.java"
click node_media_api "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/media/application/MediaAssetService.java"
click node_media_store "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/media/adapter/out/storage/LocalFileStorage.java"
click node_plants_api "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/plants/application/PlantService.java"
click node_plant_store "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/plants/adapter/out/persistence/JpaPlantRepository.java"
click node_moderation_jobs "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/moderation/application/ProcessModerationJobsService.java"
click node_classifier "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/moderation/adapter/out/classifier/OnnxPlantClassifier.java"
click node_tournament_api "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/adapter/in/web/TournamentController.java"
click node_invitations "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/application/InvitationService.java"
click node_rounds "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/application/AdvanceGlobalCompetitionService.java"
click node_voting "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/application/VotingQueryService.java"
click node_global "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/application/GlobalQueryService.java"
click node_tournament_store "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/adapter/out/persistence/JpaTournamentEntryRepository.java"
click node_geo "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/geo/application/ClusterAssignmentFacade.java"
click node_feed "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/feed/application/FeedService.java"
click node_feed_store "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/feed/adapter/out/persistence/JpaFeedCardRepository.java"
click node_guest "https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/application/GuestSessionService.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_identity_api,node_actor,node_user,node_api_client toneBlue
class node_media_api,node_media_store,node_plants_api,node_plant_store toneAmber
class node_moderation_jobs,node_classifier toneMint
class node_tournament_api,node_invitations,node_rounds,node_voting,node_global,node_tournament_store,node_guest toneRose
class node_geo,node_feed,node_feed_store toneIndigo
```

## Components

### Identity and Profiles

- [Profiles and Roles](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/identity/application/UserAdministrationService.java): `src/main/java/com/plantarena/identity/application/UserAdministrationService.java`
- [Current Actor](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/shared/security/CurrentActor.java): `src/main/java/com/plantarena/shared/security/CurrentActor.java`

### Plants and Media

- [Image Uploads](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/media/application/MediaAssetService.java): `src/main/java/com/plantarena/media/application/MediaAssetService.java`
- [Media Storage](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/media/adapter/out/storage/LocalFileStorage.java): `src/main/java/com/plantarena/media/adapter/out/storage/LocalFileStorage.java`
- [Plant Lifecycle](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/plants/application/PlantService.java): `src/main/java/com/plantarena/plants/application/PlantService.java`
- [Plant Records](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/plants/adapter/out/persistence/JpaPlantRepository.java): `src/main/java/com/plantarena/plants/adapter/out/persistence/JpaPlantRepository.java`

### Image Moderation

- [Moderation Jobs](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/moderation/application/ProcessModerationJobsService.java): `src/main/java/com/plantarena/moderation/application/ProcessModerationJobsService.java`
- [Plant Classifier](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/moderation/adapter/out/classifier/OnnxPlantClassifier.java): `src/main/java/com/plantarena/moderation/adapter/out/classifier/OnnxPlantClassifier.java`

### Tournaments and Voting

- [Private Tournaments](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/adapter/in/web/TournamentController.java): `src/main/java/com/plantarena/tournaments/adapter/in/web/TournamentController.java`
- [Invitations](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/application/InvitationService.java): `src/main/java/com/plantarena/tournaments/application/InvitationService.java`
- [Round Advancement](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/application/AdvanceGlobalCompetitionService.java): `src/main/java/com/plantarena/tournaments/application/AdvanceGlobalCompetitionService.java`
- [Voting and Results](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/application/VotingQueryService.java): `src/main/java/com/plantarena/tournaments/application/VotingQueryService.java`
- [Global Competition](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/application/GlobalQueryService.java): `src/main/java/com/plantarena/tournaments/application/GlobalQueryService.java`
- [Competition State](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/adapter/out/persistence/JpaTournamentEntryRepository.java): `src/main/java/com/plantarena/tournaments/adapter/out/persistence/JpaTournamentEntryRepository.java`
- [Guest Sessions](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/tournaments/application/GuestSessionService.java): `src/main/java/com/plantarena/tournaments/application/GuestSessionService.java`

### Geo and Feed

- [Geo Clustering](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/geo/application/ClusterAssignmentFacade.java): `src/main/java/com/plantarena/geo/application/ClusterAssignmentFacade.java`
- [Feed Projection](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/feed/application/FeedService.java): `src/main/java/com/plantarena/feed/application/FeedService.java`
- [Feed Cards](https://github.com/plantbookpro/lab1-monolith/blob/main/src/main/java/com/plantarena/feed/adapter/out/persistence/JpaFeedCardRepository.java): `src/main/java/com/plantarena/feed/adapter/out/persistence/JpaFeedCardRepository.java`

### Other components

- **User**
- **API Client**

## Connections

- User → Profiles and Roles: manages profile
- User → Image Uploads: uploads image
- Image Uploads → Media Storage: stores image
- User → Plant Lifecycle: submits plant
- Plant Lifecycle → Image Uploads: claims asset
- Plant Lifecycle → Plant Records: persists plant
- Plant Lifecycle → Moderation Jobs: publishes submission
- Moderation Jobs → Plant Classifier: classifies image
- Moderation Jobs → Plant Lifecycle: applies decision
- User → Private Tournaments: creates tournament
- Private Tournaments → Invitations: manages invites
- Invitations → Plant Lifecycle: reserves plant
- Private Tournaments → Round Advancement: starts competition
- Round Advancement → Voting and Results: opens voting
- User → Voting and Results: casts vote
- Voting and Results → Round Advancement: closes window
- Round Advancement → Competition State: records rounds
- User → Global Competition: joins global
- Global Competition → Geo Clustering: clusters entrants
- Geo Clustering → Global Competition: assigns clusters
- Global Competition → Round Advancement: advances finals
- API Client → Feed Projection: requests feed
- Feed Projection → Feed Cards: queries cards
- Feed Projection → Voting and Results: checks voted entries (evidence: `src/main/java/com/plantarena/feed/application/FeedService.java`)
- Feed Projection → Guest Sessions: resolves guest token (evidence: `src/main/java/com/plantarena/feed/application/FeedService.java`)
- User → Guest Sessions: creates session
- API Client → Profiles and Roles: uses API
- Current Actor → Profiles and Roles: supplies subject (evidence: `src/main/java/com/plantarena/identity/application/UserAdministrationService.java`)
