How genissonemilio/coleta-seletiva-backend works
Coleta Seletiva is a Spring API connecting residents, collection points, recyclable materials, and collection operators. The principal workflow is a client request to manage or consult collection points and materials, or submit and progress a pickup request; records are persisted in PostgreSQL. The README documents actor-selection headers for local demonstrations, not production authentication. Core service-to-repository and pagination links are supported by sampled source/index references; several controller and domain-service links are shown as unverified because those implementations were not excerpted.
Main entry points: PontoService.java Point management · ColetaSeletivaApiApplication.java Spring application · ContextoController.java Actor context · ContextoService.java Context resolver
Components 22
API and context
- Spring application
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/ColetaSeletivaApiApplication.java - Actor context
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/controller/ContextoController.java - Context resolver
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/contexto/ContextoService.java - Demo actors
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/contexto/DadosDemoService.java
Collection catalog
- Point endpoints
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/controller/PontoController.java - Point management
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/ponto/PontoService.java - Accepted materials
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/pontomaterial/PontoMaterialService.java - Material endpoints
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/controller/MaterialController.java - Material management
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/material/MaterialService.java - Resident records
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/morador/MoradorService.java - Operator records
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/operador/OperadorService.java
Pickup requests
- Pickup endpoints
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/controller/SolicitacaoController.java - Pickup lifecycle
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/solicitacao/SolicitacaoService.java
Consultation and indicators
- Public endpoints
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/controller/ConsultaPublicaController.java - Public lookup
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/publico/ConsultaPublicaService.java - Collection indicators
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/indicador/IndicadorService.java
Persistence and shared rules
- PostgreSQL
- Point queries
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/repository/PontoRepository.java - Resident queries
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/repository/MoradorRepository.java - Pagination rules
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/paginacao/PaginacaoService.java - API error handling
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/exception/GlobalExceptionHandler.java
Other components
- API client
Connections 24
- API client → Spring application: sends HTTP
README.md - Spring application → PostgreSQL: persists data
README.md - API client → Actor context: selects actor
README.md - Actor context → Context resolver: resolves context
- Context resolver → Resident queries: looks up resident
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/contexto/ContextoService.java - API client → Point endpoints: manages points
- Point endpoints → Point management: delegates
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/controller/PontoController.java - Point management → Point queries: queries and saves
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/ponto/PontoService.java - Point management → Pagination rules: builds pages
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/ponto/PontoService.java - API client → Material endpoints: manages materials
- Material endpoints → Material management: delegates
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/controller/MaterialController.java - Material management → Pagination rules: builds pages
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/material/MaterialService.java - API client → Pickup endpoints: submits pickup
- Pickup endpoints → Pickup lifecycle: delegates
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/controller/SolicitacaoController.java - API client → Public endpoints: searches points
- Public endpoints → Public lookup: delegates
- API client → Collection indicators: requests metrics
- Demo actors → PostgreSQL: seeds demo actors
README.md - Accepted materials → PostgreSQL: stores point links
- Resident records → PostgreSQL: stores residents
- Operator records → PostgreSQL: stores operators
- Pickup lifecycle → PostgreSQL: stores requests
- Public lookup → Point queries: searches active points
coleta-seletiva-api/src/main/java/br/edu/ifs/web1/coletaseletiva/services/publico/ConsultaPublicaService.java - API error handling → API client: formats errors