How kamuz-01/agrofraiburgo works
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: repository Relational repositories · VitrineController.java Search and showcase · RecomendacaoService.java Recommendations · EmailService.java Email delivery
Components 23
Web experience
- Spring application
src/main/java/org/main/AgroFraiburgoApplication.java - Page routing
src/main/java/org/main/controllers/TelasController.java
Identity and accounts
- Login and OAuth
src/main/java/org/main/controllers/AuthController.java - JWT and access control
src/main/java/org/main/config/SecurityConfig.java - JWT service
src/main/java/org/main/services/JwtService.java - Password recovery
src/main/java/org/main/services/RecuperacaoSenhaService.java
Local marketplace
- Search and showcase
src/main/java/org/main/controllers/VitrineController.java - Product management
src/main/java/org/main/controllers/ProdutoController.java - Fair details
src/main/java/org/main/controllers/FeiraController.java - Producer ratings
src/main/java/org/main/controllers/AvaliacaoController.java - Favorites
src/main/java/org/main/controllers/FavoritoProdutorController.java
Moderation and messaging
- Producer registration
src/main/java/org/main/controllers/CadastroProdutorController.java - Producer moderation
src/main/java/org/main/controllers/ModeracaoProdutorController.java - Account moderation
src/main/java/org/main/controllers/ModeracaoController.java - Email delivery
src/main/java/org/main/services/EmailService.java - RabbitMQ email queue
src/main/java/org/main/config/RabbitConfig.java
Persistence and recommendations
- Relational repositories
src/main/java/org/main/repository - MySQL records
- Recommendations
src/main/java/org/main/services/RecomendacaoService.java - Graph interactions
src/main/java/org/main/neo4j/Neo4jInteracaoService.java - Neo4j graph
- Graph export
src/main/java/org/main/neo4j/Neo4jExportService.java
Other components
- Resident / user
Connections 27
- Resident / user → Spring application: uses
README.md - Spring application → Page routing: serves pages
- Resident / user → Search and showcase: searches and browses
README.md - Resident / user → Product management: manages products
README.md - Resident / user → Fair details: views active fair
README.md - Resident / user → Producer ratings: rates producers
README.md - Resident / user → Favorites: favorites producers
README.md - Resident / user → Producer registration: registers as producer
README.md - Resident / user → Login and OAuth: signs in
README.md - Resident / user → Password recovery: requests reset
README.md - Login and OAuth → JWT service: issues tokens
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
src/main/java/org/main/controllers/ModeracaoProdutorController.java - Account moderation → Relational repositories: updates account status
- Search and showcase → Relational repositories: loads listings and ratings
src/main/java/org/main/controllers/VitrineController.java - Search and showcase → Recommendations: requests suggestions
src/main/java/org/main/controllers/VitrineController.java - Recommendations → Relational repositories: loads products and fallback ratings
src/main/java/org/main/services/RecomendacaoService.java - Recommendations → Neo4j graph: queries graph suggestions
README.md - Favorites → Graph interactions: records graph interactions
- Graph interactions → Neo4j graph: stores interactions
- Relational repositories → MySQL records: reads and writes
README.md - Graph export → Relational repositories: reads relational data
src/main/java/org/main/neo4j/Neo4jExportService.java - Graph export → Neo4j graph: prepares graph import
src/main/java/org/main/neo4j/Neo4jExportService.java - Password recovery → Email delivery: sends reset email
src/main/java/org/main/services/RecuperacaoSenhaService.java - Email delivery → RabbitMQ email queue: queues delivery
src/main/java/org/main/services/EmailService.java - Producer moderation → Email delivery: notifies producer
src/main/java/org/main/controllers/ModeracaoProdutorController.java