How vitoryoshii/conecta-comunidade works
Conecta Comunidade is a community-help platform: residents and institutions browse or publish requests and offers, coordinate through chat and scheduled deliveries, and discover nearby help. The Flet mobile/PWA app calls a FastAPI JSON API, whose domain routes use SQLModel-backed persistence. The graph preserves the documented map, favorites, NGO, locality, and profile capabilities. API-to-database and client-to-API links are documented; unsampled router internals are not inferred beyond the visible registrations and references.
Main entry points: backend/main.py API entry · deps.py Session and auth dependencies · solicitacoes.py Help requests · mobile/main.py Flet application
Components 27
Flet client
- Flet application
mobile/main.py - HTTP API client
mobile/api_client.py - Feature views
mobile/views - Map view
mobile/views/mapa.py - App state
mobile/state.py
FastAPI API
- API entry
backend/main.py - Authentication routes
backend/routers/auth.py
Community features
- Help requests
backend/routers/solicitacoes.py - Help offers
backend/routers/ofertas.py - Chat messages
backend/routers/mensagens.py - Scheduled deliveries
backend/routers/entregas.py - Map data
backend/routers/mapa.py - Favorites
backend/routers/favoritos.py - NGO directory
backend/routers/ongs.py - Profiles and impact
backend/routers/usuarios.py - Localities
backend/routers/localidades.py - Categories
backend/routers/categorias.py
Shared foundations
- Request and response schemas
backend/schemas - JWT and password security
backend/services/auth_service.py - Personal-data rules
backend/services/dados_pessoais_service.py - Geolocation
backend/services/geo_service.py - Presentation formatting
backend/services/apresentacao.py - Session and auth dependencies
backend/deps.py - Domain models
backend/models - SQLModel persistence
backend/database.py
Other components
- Residents
- PostgreSQL / SQLite
Connections 36
- Residents → Flet application: use
README.md - Flet application → Feature views: renders
mobile/main.py - Flet application → HTTP API client: creates
mobile/main.py - Flet application → App state: maintains
mobile/main.py - Feature views → HTTP API client: request data
- Map view → HTTP API client: request map data
- HTTP API client → API entry: HTTP JSON
README.md - API entry → Authentication routes: registers
backend/main.py - API entry → Help requests: registers
backend/main.py - API entry → Help offers: registers
backend/main.py - API entry → Chat messages: registers
backend/main.py - API entry → Scheduled deliveries: registers
backend/main.py - API entry → Map data: registers
backend/main.py - API entry → Favorites: registers
backend/main.py - API entry → NGO directory: registers
backend/main.py - API entry → Profiles and impact: registers
backend/main.py - API entry → Localities: registers
backend/main.py - API entry → Categories: registers
backend/main.py - Authentication routes → JWT and password security: uses
backend/routers/auth.py - Authentication routes → Personal-data rules: validates data
backend/routers/auth.py - Authentication routes → Session and auth dependencies: uses
backend/routers/auth.py - Chat messages → Session and auth dependencies: uses
backend/routers/mensagens.py - Chat messages → Presentation formatting: formats
backend/routers/mensagens.py - Help requests → Session and auth dependencies: uses
backend/routers/solicitacoes.py - Help requests → Geolocation: uses
backend/routers/solicitacoes.py - Help requests → Presentation formatting: formats
backend/routers/solicitacoes.py - Profiles and impact → Session and auth dependencies: uses
backend/routers/usuarios.py - Profiles and impact → JWT and password security: uses
backend/routers/usuarios.py - Profiles and impact → Personal-data rules: uses
backend/routers/usuarios.py - Request and response schemas → Domain models: shares enums
backend/schemas/usuario.py - Session and auth dependencies → JWT and password security: decodes token
backend/deps.py - Session and auth dependencies → SQLModel persistence: gets session
backend/deps.py - Session and auth dependencies → Domain models: loads user
backend/deps.py - SQLModel persistence → PostgreSQL / SQLite: connects
README.md - Help requests → Domain models: uses entities
backend/routers/solicitacoes.py - Chat messages → Domain models: uses entities
backend/routers/mensagens.py