# kamuz-01/agrofraiburgo architecture

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

- Interactive diagram: https://gitdiagram.com/kamuz-01/agrofraiburgo
- Repository: https://github.com/kamuz-01/agrofraiburgo

## Overview

AgroFraiburgo is a web marketplace-style information and showcase system for local family agriculture, not a transaction platform. Residents discover and search products, producers, and active fairs; consumers can rate and favorite producers, while producers manage profiles and product availability. Producer applications pass through document review, and moderators manage account status. Authentication, password recovery, and optional personalized recommendations support these journeys. The README documents capabilities beyond sampled implementation; edges are limited to those documented there or directly evidenced by the source index and excerpts.

Main entry points: [`src/main/java/org/main/repository`](https://github.com/kamuz-01/agrofraiburgo/tree/main/src/main/java/org/main/repository) (Relational repositories), [`src/main/java/org/main/controllers/VitrineController.java`](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/VitrineController.java) (Search and showcase), [`src/main/java/org/main/services/RecomendacaoService.java`](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/services/RecomendacaoService.java) (Recommendations), [`src/main/java/org/main/services/EmailService.java`](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/services/EmailService.java) (Email delivery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_application["Spring application"]
  node_pages["Page routing"]
end

subgraph group_identity["Identity and accounts"]
  node_auth["Login and OAuth"]
  node_security["JWT and access control"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_recovery["Password recovery"]
end

subgraph group_market["Local marketplace"]
  node_showcase["Search and showcase"]
  node_catalog["Product management"]
  node_fair["Fair details"]
  node_reviews["Producer ratings"]
  node_favorites["Favorites"]
end

subgraph group_operations["Moderation and messaging"]
  node_producer_signup["Producer registration"]
  node_review_queue["Producer moderation"]
  node_accounts_admin["Account moderation"]
  node_email["Email delivery<br/>[EmailService.java]"]
  node_mail_queue["RabbitMQ email queue<br/>[RabbitConfig.java]"]
end

subgraph group_data["Persistence and recommendations"]
  node_repository_layer["Relational repositories"]
  node_mysql[("MySQL records")]
  node_recommendations["Recommendations"]
  node_neo4j_interactions["Graph interactions"]
  node_neo4j[("Neo4j graph")]
  node_neo4j_export["Graph export"]
end

node_visitor(("Resident / user"))

node_visitor -->|"uses"| node_application
node_application -.->|"serves pages"| node_pages
node_visitor -->|"searches and browses"| node_showcase
node_visitor -->|"manages products"| node_catalog
node_visitor -->|"views active fair"| node_fair
node_visitor -->|"rates producers"| node_reviews
node_visitor -->|"favorites producers"| node_favorites
node_visitor -->|"registers as producer"| node_producer_signup
node_visitor -->|"signs in"| node_auth
node_visitor -->|"requests reset"| node_recovery
node_auth -->|"issues tokens"| node_jwt
node_security -.->|"validates tokens"| node_jwt
node_producer_signup -->|"registers accounts"| node_repository_layer
node_review_queue -->|"reviews producer records"| node_repository_layer
node_accounts_admin -.->|"updates account status"| node_repository_layer
node_showcase -->|"loads listings and ratings"| node_repository_layer
node_showcase -->|"requests suggestions"| node_recommendations
node_recommendations -->|"loads products and fallback ratings"| node_repository_layer
node_recommendations -->|"queries graph suggestions"| node_neo4j
node_favorites -.->|"records graph interactions"| node_neo4j_interactions
node_neo4j_interactions -.->|"stores interactions"| node_neo4j
node_repository_layer -->|"reads and writes"| node_mysql
node_neo4j_export -->|"reads relational data"| node_repository_layer
node_neo4j_export -->|"prepares graph import"| node_neo4j
node_recovery -->|"sends reset email"| node_email
node_email -.->|"queues delivery"| node_mail_queue
node_review_queue -->|"notifies producer"| node_email

click node_application "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/AgroFraiburgoApplication.java"
click node_pages "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/TelasController.java"
click node_showcase "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/VitrineController.java"
click node_catalog "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/ProdutoController.java"
click node_fair "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/FeiraController.java"
click node_reviews "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/AvaliacaoController.java"
click node_favorites "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/FavoritoProdutorController.java"
click node_producer_signup "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/CadastroProdutorController.java"
click node_review_queue "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/ModeracaoProdutorController.java"
click node_accounts_admin "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/ModeracaoController.java"
click node_auth "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/AuthController.java"
click node_security "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/config/SecurityConfig.java"
click node_jwt "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/services/JwtService.java"
click node_recovery "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/services/RecuperacaoSenhaService.java"
click node_email "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/services/EmailService.java"
click node_mail_queue "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/config/RabbitConfig.java"
click node_repository_layer "https://github.com/kamuz-01/agrofraiburgo/tree/main/src/main/java/org/main/repository"
click node_recommendations "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/services/RecomendacaoService.java"
click node_neo4j_interactions "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/neo4j/Neo4jInteracaoService.java"
click node_neo4j_export "https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/neo4j/Neo4jExportService.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_application,node_pages,node_visitor toneBlue
class node_auth,node_security,node_jwt,node_recovery toneAmber
class node_showcase,node_catalog,node_fair,node_reviews,node_favorites toneMint
class node_producer_signup,node_review_queue,node_accounts_admin,node_email,node_mail_queue toneRose
class node_repository_layer,node_mysql,node_recommendations,node_neo4j_interactions,node_neo4j,node_neo4j_export toneIndigo
```

## Components

### Web experience

- [Spring application](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/AgroFraiburgoApplication.java): `src/main/java/org/main/AgroFraiburgoApplication.java`
- [Page routing](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/TelasController.java): `src/main/java/org/main/controllers/TelasController.java`

### Identity and accounts

- [Login and OAuth](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/AuthController.java): `src/main/java/org/main/controllers/AuthController.java`
- [JWT and access control](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/config/SecurityConfig.java): `src/main/java/org/main/config/SecurityConfig.java`
- [JWT service](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/services/JwtService.java): `src/main/java/org/main/services/JwtService.java`
- [Password recovery](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/services/RecuperacaoSenhaService.java): `src/main/java/org/main/services/RecuperacaoSenhaService.java`

### Local marketplace

- [Search and showcase](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/VitrineController.java): `src/main/java/org/main/controllers/VitrineController.java`
- [Product management](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/ProdutoController.java): `src/main/java/org/main/controllers/ProdutoController.java`
- [Fair details](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/FeiraController.java): `src/main/java/org/main/controllers/FeiraController.java`
- [Producer ratings](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/AvaliacaoController.java): `src/main/java/org/main/controllers/AvaliacaoController.java`
- [Favorites](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/FavoritoProdutorController.java): `src/main/java/org/main/controllers/FavoritoProdutorController.java`

### Moderation and messaging

- [Producer registration](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/CadastroProdutorController.java): `src/main/java/org/main/controllers/CadastroProdutorController.java`
- [Producer moderation](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/ModeracaoProdutorController.java): `src/main/java/org/main/controllers/ModeracaoProdutorController.java`
- [Account moderation](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/controllers/ModeracaoController.java): `src/main/java/org/main/controllers/ModeracaoController.java`
- [Email delivery](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/services/EmailService.java): `src/main/java/org/main/services/EmailService.java`
- [RabbitMQ email queue](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/config/RabbitConfig.java): `src/main/java/org/main/config/RabbitConfig.java`

### Persistence and recommendations

- [Relational repositories](https://github.com/kamuz-01/agrofraiburgo/tree/main/src/main/java/org/main/repository): `src/main/java/org/main/repository`
- **MySQL records**
- [Recommendations](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/services/RecomendacaoService.java): `src/main/java/org/main/services/RecomendacaoService.java`
- [Graph interactions](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/neo4j/Neo4jInteracaoService.java): `src/main/java/org/main/neo4j/Neo4jInteracaoService.java`
- **Neo4j graph**
- [Graph export](https://github.com/kamuz-01/agrofraiburgo/blob/main/src/main/java/org/main/neo4j/Neo4jExportService.java): `src/main/java/org/main/neo4j/Neo4jExportService.java`

### Other components

- **Resident / user**

## Connections

- Resident / user → Spring application: uses (evidence: `README.md`)
- Spring application → Page routing: serves pages
- Resident / user → Search and showcase: searches and browses (evidence: `README.md`)
- Resident / user → Product management: manages products (evidence: `README.md`)
- Resident / user → Fair details: views active fair (evidence: `README.md`)
- Resident / user → Producer ratings: rates producers (evidence: `README.md`)
- Resident / user → Favorites: favorites producers (evidence: `README.md`)
- Resident / user → Producer registration: registers as producer (evidence: `README.md`)
- Resident / user → Login and OAuth: signs in (evidence: `README.md`)
- Resident / user → Password recovery: requests reset (evidence: `README.md`)
- Login and OAuth → JWT service: issues tokens (evidence: `src/main/java/org/main/controllers/AuthController.java`)
- JWT and access control → JWT service: validates tokens
- Producer registration → Relational repositories: registers accounts
- Producer moderation → Relational repositories: reviews producer records (evidence: `src/main/java/org/main/controllers/ModeracaoProdutorController.java`)
- Account moderation → Relational repositories: updates account status
- Search and showcase → Relational repositories: loads listings and ratings (evidence: `src/main/java/org/main/controllers/VitrineController.java`)
- Search and showcase → Recommendations: requests suggestions (evidence: `src/main/java/org/main/controllers/VitrineController.java`)
- Recommendations → Relational repositories: loads products and fallback ratings (evidence: `src/main/java/org/main/services/RecomendacaoService.java`)
- Recommendations → Neo4j graph: queries graph suggestions (evidence: `README.md`)
- Favorites → Graph interactions: records graph interactions
- Graph interactions → Neo4j graph: stores interactions
- Relational repositories → MySQL records: reads and writes (evidence: `README.md`)
- Graph export → Relational repositories: reads relational data (evidence: `src/main/java/org/main/neo4j/Neo4jExportService.java`)
- Graph export → Neo4j graph: prepares graph import (evidence: `src/main/java/org/main/neo4j/Neo4jExportService.java`)
- Password recovery → Email delivery: sends reset email (evidence: `src/main/java/org/main/services/RecuperacaoSenhaService.java`)
- Email delivery → RabbitMQ email queue: queues delivery (evidence: `src/main/java/org/main/services/EmailService.java`)
- Producer moderation → Email delivery: notifies producer (evidence: `src/main/java/org/main/controllers/ModeracaoProdutorController.java`)
