# hellocbibi4-ship-it/tinyfarm-485k architecture

> Architecture diagram of the GitHub repository hellocbibi4-ship-it/tinyfarm-485k, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hellocbibi4-ship-it/tinyfarm-485k
- Repository: https://github.com/hellocbibi4-ship-it/tinyfarm-485k

## Overview

TinyFarm is a Spring Boot farm-management game with an integrated JavaScript front end. The principal workflow is GitHub sign-in, selection or creation of a player’s farm, then managing animals and resources through daily farm actions, trading, and cooperative supplies. The graph shows the sampled service and persistence layers, plus documented but unsampled capabilities such as habitat management and rankings. Some controller and UI wiring is not shown; those connections are omitted or marked unverified rather than inferred as confirmed calls.

Main entry points: [`project/src/main/java/com/farm/tinyfarm/service/FermeService.java`](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/FermeService.java) (Farm simulation), [`project/src/main/java/com/farm/tinyfarm/service/MarcheService.java`](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/MarcheService.java) (Market trading), [`project/src/main/java/com/farm/tinyfarm/service/RemiseService.java`](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/RemiseService.java) (Store inventory), [`project/src/main/java/com/farm/tinyfarm/controller/AuthController.java`](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/AuthController.java) (Login & farm choice)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; access"]
  node_oauth["OAuth user service"]
  node_security["Security config"]
  node_auth["Login &amp; farm choice"]
  node_user["User endpoints"]
end

subgraph group_farm["Farm simulation"]
  node_farmctl["Farm endpoints"]
  node_farmservice["Farm simulation<br/>[FermeService.java]"]
  node_animalctl["Animal endpoints"]
  node_animalservice["Animal care<br/>[AnimalService.java]"]
  node_habitatctl["Habitat endpoints"]
  node_habitatservice["Habitat care"]
  node_utilities["Game utilities<br/>[Utilitaires.java]"]
end

subgraph group_economy["Stock &amp; economy"]
  node_marketctl["Market endpoints"]
  node_marketservice["Market trading<br/>[MarcheService.java]"]
  node_cooperative["Cooperative supplies"]
  node_remisectl["Store endpoints"]
  node_remiseservice["Store inventory<br/>[RemiseService.java]"]
end

subgraph group_persistence["Domain &amp; persistence"]
  node_models["Farm &amp; game entities<br/>[Ferme.java]"]
  node_animals["Animal entity<br/>[Animal.java]"]
  node_remisemodel["Store entity<br/>[Remise.java]"]
  node_types["Game enums<br/>[TypeStock.java]"]
  node_farmerpo[("Farm repository")]
  node_animalrepo[("Animal repository")]
  node_userrepo[("User repository")]
  node_marketrepo[("Market repository")]
  node_remiserepo[("Store repository")]
end

subgraph group_interface["Web interface"]
  node_frontend["Farm web UI<br/>[app-ui.js]"]
end

node_player(("Player"))
node_github(("GitHub OAuth"))

node_player -.->|"uses"| node_frontend
node_player -->|"starts login"| node_auth
node_auth -->|"OAuth login"| node_github
node_github -->|"returns identity"| node_oauth
node_oauth -->|"looks up user"| node_userrepo
node_auth -->|"selects or creates farm"| node_farmservice
node_auth -->|"loads user"| node_userrepo
node_farmctl -->|"runs farm actions"| node_farmservice
node_farmctl -->|"requests market data"| node_marketservice
node_farmctl -->|"requests store data"| node_remiseservice
node_animalctl -->|"runs animal actions"| node_animalservice
node_animalctl -->|"accesses farm logic"| node_farmservice
node_animalservice -->|"updates farm balance"| node_farmservice
node_habitatctl -.->|"manages habitats"| node_habitatservice
node_marketctl -->|"handles offers"| node_marketservice
node_marketservice -->|"transfers stock"| node_remiseservice
node_marketservice -->|"updates farm state"| node_farmservice
node_cooperative -->|"updates farm purchases"| node_farmservice
node_cooperative -->|"manages supplies"| node_remiseservice
node_remisectl -.->|"manages inventory"| node_remiseservice
node_farmservice -->|"reads and saves farms"| node_farmerpo
node_farmservice -->|"reads and saves animals"| node_animalrepo
node_farmservice -->|"reads and saves stores"| node_remiserepo
node_animalservice -->|"persists animals"| node_animalrepo
node_marketservice -->|"reads and saves offers"| node_marketrepo
node_marketservice -->|"loads buyer farms"| node_farmerpo
node_remiseservice -->|"persists inventory"| node_remiserepo
node_remiseservice -->|"loads farm balance"| node_farmerpo
node_oauth -->|"persists identity"| node_userrepo
node_frontend -.->|"requests farm actions"| node_farmctl
node_frontend -.->|"requests animal actions"| node_animalctl

click node_oauth "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/security/CustomOAuth2UserService.java"
click node_security "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/security/SecurityConfig.java"
click node_auth "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/AuthController.java"
click node_user "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/UserController.java"
click node_farmctl "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/FermeController.java"
click node_farmservice "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/FermeService.java"
click node_animalctl "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/AnimalController.java"
click node_animalservice "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/AnimalService.java"
click node_habitatctl "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/HabitatController.java"
click node_habitatservice "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/HabitatService.java"
click node_marketctl "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/MarcheController.java"
click node_marketservice "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/MarcheService.java"
click node_cooperative "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/CooperativeService.java"
click node_remisectl "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/RemiseController.java"
click node_remiseservice "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/RemiseService.java"
click node_models "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/model/Ferme.java"
click node_animals "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/model/Animal.java"
click node_remisemodel "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/model/Remise.java"
click node_types "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/model/TypeStock.java"
click node_farmerpo "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/repository/FermeRepository.java"
click node_animalrepo "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/repository/AnimalRepository.java"
click node_userrepo "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/repository/UtilisateurRepository.java"
click node_marketrepo "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/repository/MarcheRepository.java"
click node_remiserepo "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/repository/RemiseRepository.java"
click node_frontend "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/resources/static/js/app-ui.js"
click node_utilities "https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/outils/Utilitaires.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_oauth,node_security,node_auth,node_user toneBlue
class node_farmctl,node_farmservice,node_animalctl,node_animalservice,node_habitatctl,node_habitatservice,node_utilities toneAmber
class node_marketctl,node_marketservice,node_cooperative,node_remisectl,node_remiseservice toneMint
class node_models,node_animals,node_remisemodel,node_types,node_farmerpo,node_animalrepo,node_userrepo,node_marketrepo,node_remiserepo toneRose
class node_frontend,node_player,node_github toneIndigo
```

## Components

### Identity & access

- [OAuth user service](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/security/CustomOAuth2UserService.java): `project/src/main/java/com/farm/tinyfarm/security/CustomOAuth2UserService.java`
- [Security config](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/security/SecurityConfig.java): `project/src/main/java/com/farm/tinyfarm/security/SecurityConfig.java`
- [Login & farm choice](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/AuthController.java): `project/src/main/java/com/farm/tinyfarm/controller/AuthController.java`
- [User endpoints](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/UserController.java): `project/src/main/java/com/farm/tinyfarm/controller/UserController.java`

### Farm simulation

- [Farm endpoints](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/FermeController.java): `project/src/main/java/com/farm/tinyfarm/controller/FermeController.java`
- [Farm simulation](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/FermeService.java): `project/src/main/java/com/farm/tinyfarm/service/FermeService.java`
- [Animal endpoints](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/AnimalController.java): `project/src/main/java/com/farm/tinyfarm/controller/AnimalController.java`
- [Animal care](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/AnimalService.java): `project/src/main/java/com/farm/tinyfarm/service/AnimalService.java`
- [Habitat endpoints](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/HabitatController.java): `project/src/main/java/com/farm/tinyfarm/controller/HabitatController.java`
- [Habitat care](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/HabitatService.java): `project/src/main/java/com/farm/tinyfarm/service/HabitatService.java`
- [Game utilities](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/outils/Utilitaires.java): `project/src/main/java/com/farm/tinyfarm/outils/Utilitaires.java`

### Stock & economy

- [Market endpoints](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/MarcheController.java): `project/src/main/java/com/farm/tinyfarm/controller/MarcheController.java`
- [Market trading](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/MarcheService.java): `project/src/main/java/com/farm/tinyfarm/service/MarcheService.java`
- [Cooperative supplies](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/CooperativeService.java): `project/src/main/java/com/farm/tinyfarm/service/CooperativeService.java`
- [Store endpoints](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/controller/RemiseController.java): `project/src/main/java/com/farm/tinyfarm/controller/RemiseController.java`
- [Store inventory](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/service/RemiseService.java): `project/src/main/java/com/farm/tinyfarm/service/RemiseService.java`

### Domain & persistence

- [Farm & game entities](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/model/Ferme.java): `project/src/main/java/com/farm/tinyfarm/model/Ferme.java`
- [Animal entity](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/model/Animal.java): `project/src/main/java/com/farm/tinyfarm/model/Animal.java`
- [Store entity](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/model/Remise.java): `project/src/main/java/com/farm/tinyfarm/model/Remise.java`
- [Game enums](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/model/TypeStock.java): `project/src/main/java/com/farm/tinyfarm/model/TypeStock.java`
- [Farm repository](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/repository/FermeRepository.java): `project/src/main/java/com/farm/tinyfarm/repository/FermeRepository.java`
- [Animal repository](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/repository/AnimalRepository.java): `project/src/main/java/com/farm/tinyfarm/repository/AnimalRepository.java`
- [User repository](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/repository/UtilisateurRepository.java): `project/src/main/java/com/farm/tinyfarm/repository/UtilisateurRepository.java`
- [Market repository](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/repository/MarcheRepository.java): `project/src/main/java/com/farm/tinyfarm/repository/MarcheRepository.java`
- [Store repository](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/java/com/farm/tinyfarm/repository/RemiseRepository.java): `project/src/main/java/com/farm/tinyfarm/repository/RemiseRepository.java`

### Web interface

- [Farm web UI](https://github.com/hellocbibi4-ship-it/tinyfarm-485k/blob/Main_V2-(second-oral)/project/src/main/resources/static/js/app-ui.js): `project/src/main/resources/static/js/app-ui.js`

### Other components

- **Player**
- **GitHub OAuth**

## Connections

- Player → Farm web UI: uses
- Player → Login & farm choice: starts login (evidence: `README.md`)
- Login & farm choice → GitHub OAuth: OAuth login (evidence: `README.md`)
- GitHub OAuth → OAuth user service: returns identity (evidence: `README.md`)
- OAuth user service → User repository: looks up user (evidence: `project/src/main/java/com/farm/tinyfarm/security/CustomOAuth2UserService.java`)
- Login & farm choice → Farm simulation: selects or creates farm (evidence: `project/src/main/java/com/farm/tinyfarm/controller/AuthController.java`)
- Login & farm choice → User repository: loads user (evidence: `project/src/main/java/com/farm/tinyfarm/controller/AuthController.java`)
- Farm endpoints → Farm simulation: runs farm actions (evidence: `project/src/main/java/com/farm/tinyfarm/controller/FermeController.java`)
- Farm endpoints → Market trading: requests market data (evidence: `project/src/main/java/com/farm/tinyfarm/controller/FermeController.java`)
- Farm endpoints → Store inventory: requests store data (evidence: `project/src/main/java/com/farm/tinyfarm/controller/FermeController.java`)
- Animal endpoints → Animal care: runs animal actions (evidence: `project/src/main/java/com/farm/tinyfarm/controller/AnimalController.java`)
- Animal endpoints → Farm simulation: accesses farm logic (evidence: `project/src/main/java/com/farm/tinyfarm/controller/AnimalController.java`)
- Animal care → Farm simulation: updates farm balance (evidence: `project/src/main/java/com/farm/tinyfarm/service/AnimalService.java`)
- Habitat endpoints → Habitat care: manages habitats (evidence: `project/src/main/java/com/farm/tinyfarm/controller/HabitatController.java`)
- Market endpoints → Market trading: handles offers (evidence: `project/src/main/java/com/farm/tinyfarm/controller/MarcheController.java`)
- Market trading → Store inventory: transfers stock (evidence: `project/src/main/java/com/farm/tinyfarm/service/MarcheService.java`)
- Market trading → Farm simulation: updates farm state (evidence: `project/src/main/java/com/farm/tinyfarm/service/MarcheService.java`)
- Cooperative supplies → Farm simulation: updates farm purchases (evidence: `project/src/main/java/com/farm/tinyfarm/service/CooperativeService.java`)
- Cooperative supplies → Store inventory: manages supplies (evidence: `project/src/main/java/com/farm/tinyfarm/service/CooperativeService.java`)
- Store endpoints → Store inventory: manages inventory (evidence: `project/src/main/java/com/farm/tinyfarm/controller/RemiseController.java`)
- Farm simulation → Farm repository: reads and saves farms (evidence: `project/src/main/java/com/farm/tinyfarm/service/FermeService.java`)
- Farm simulation → Animal repository: reads and saves animals (evidence: `project/src/main/java/com/farm/tinyfarm/service/FermeService.java`)
- Farm simulation → Store repository: reads and saves stores (evidence: `project/src/main/java/com/farm/tinyfarm/service/FermeService.java`)
- Animal care → Animal repository: persists animals (evidence: `project/src/main/java/com/farm/tinyfarm/service/AnimalService.java`)
- Market trading → Market repository: reads and saves offers (evidence: `project/src/main/java/com/farm/tinyfarm/service/MarcheService.java`)
- Market trading → Farm repository: loads buyer farms (evidence: `project/src/main/java/com/farm/tinyfarm/service/MarcheService.java`)
- Store inventory → Store repository: persists inventory (evidence: `project/src/main/java/com/farm/tinyfarm/service/RemiseService.java`)
- Store inventory → Farm repository: loads farm balance (evidence: `project/src/main/java/com/farm/tinyfarm/service/RemiseService.java`)
- OAuth user service → User repository: persists identity (evidence: `project/src/main/java/com/farm/tinyfarm/security/CustomOAuth2UserService.java`)
- Farm web UI → Farm endpoints: requests farm actions
- Farm web UI → Animal endpoints: requests animal actions
