How passaaqui/passaaqui-backend works
Passa Aqui is a REST backend connecting tourists with points of interest and local businesses. Its main journey spans account registration, discovery and navigation, POI check-ins and rewards, and local-product checkout with PIX payment. The graph also preserves documented supporting capabilities such as ratings, achievements, dashboards, and image storage. Sampled services and the source index support several internal links; unsampled controller wiring and other subsystem internals are not asserted.
Main entry points: ShopkeeperService.java Business profiles · StorageService.java Image storage · poi POI management · RouteService.java Route sessions
Components 23
Identity and profiles
- Tourist profiles
src/main/java/com/passaaqui/backend/modules/tourist/service/TouristService.java - Business profiles
src/main/java/com/passaaqui/backend/modules/shopkeeper/service/ShopkeeperService.java - Authentication
src/main/java/com/passaaqui/backend/modules/auth/service/AuthService.java
Places and discovery
- POI management
src/main/java/com/passaaqui/backend/modules/poi - Cities
src/main/java/com/passaaqui/backend/modules/city - Categories
src/main/java/com/passaaqui/backend/modules/category - Directions
src/main/java/com/passaaqui/backend/modules/direction - Route sessions
src/main/java/com/passaaqui/backend/modules/route/service/RouteService.java
Local commerce
- Product catalog
src/main/java/com/passaaqui/backend/modules/product/service/ProductService.java - Orders and checkout
src/main/java/com/passaaqui/backend/modules/order/service/OrderService.java - Ratings
src/main/java/com/passaaqui/backend/modules/product - Business dashboard
src/main/java/com/passaaqui/backend/modules/dashboard
Tourism engagement
- POI check-ins
src/main/java/com/passaaqui/backend/modules/poi/service/PoiCheckinService.java - Achievements
src/main/java/com/passaaqui/backend/modules/achievement/service/AchievementService.java - Live updates
src/main/java/com/passaaqui/backend/modules/websocket/service/WebSocketService.java
Infrastructure
- AbacatePay
src/main/java/com/passaaqui/backend/infra/integration/abacatepay/AbacateClient.java - Redis cache
src/main/java/com/passaaqui/backend/infra/integration/cache/CacheService.java - Image storage
src/main/java/com/passaaqui/backend/infra/integration/storage/StorageService.java - MinIO
src/main/java/com/passaaqui/backend/infra/integration/storage/MinioStorageServiceImpl.java - PostgreSQL
Other components
- Tourist or business user
- REST API
- OpenRouteService
Connections 23
- Tourist or business user → REST API: uses
README.md - REST API → Authentication: authenticates
- REST API → POI management: discovers places
- REST API → Product catalog: browses products
- Authentication → Tourist profiles: creates profiles
src/main/java/com/passaaqui/backend/modules/auth/service/AuthService.java - Authentication → Business profiles: creates profiles
src/main/java/com/passaaqui/backend/modules/auth/service/AuthService.java - Business profiles → Categories: looks up category
src/main/java/com/passaaqui/backend/modules/shopkeeper/service/ShopkeeperService.java - Business profiles → Cities: looks up city
src/main/java/com/passaaqui/backend/modules/shopkeeper/service/ShopkeeperService.java - Business profiles → POI management: creates business POI
src/main/java/com/passaaqui/backend/modules/shopkeeper/service/ShopkeeperService.java - Business profiles → Image storage: uploads images
src/main/java/com/passaaqui/backend/modules/shopkeeper/service/ShopkeeperService.java - Tourist profiles → Image storage: uploads images
src/main/java/com/passaaqui/backend/modules/tourist/service/TouristService.java - Tourist profiles → POI management: reads travel history
src/main/java/com/passaaqui/backend/modules/tourist/service/TouristService.java - Route sessions → Redis cache: stores sessions
src/main/java/com/passaaqui/backend/modules/route/service/RouteService.java - Route sessions → Live updates: pushes updates
src/main/java/com/passaaqui/backend/modules/route/service/RouteService.java - Route sessions → POI management: loads destination
src/main/java/com/passaaqui/backend/modules/route/service/RouteService.java - Route sessions → POI check-ins: triggers arrival check-in
src/main/java/com/passaaqui/backend/modules/route/service/RouteService.java - Product catalog → Categories: reads categories
src/main/java/com/passaaqui/backend/modules/product/service/ProductService.java - Product catalog → POI management: reads POI
src/main/java/com/passaaqui/backend/modules/product/service/ProductService.java - Product catalog → Image storage: uses image storage
src/main/java/com/passaaqui/backend/modules/product/service/ProductService.java - Orders and checkout → AbacatePay: requests payment
src/main/java/com/passaaqui/backend/modules/order/service/OrderService.java - Achievements → Image storage: uses image storage
src/main/java/com/passaaqui/backend/modules/achievement/service/AchievementService.java - Image storage → MinIO: stores files
README.md - Directions → OpenRouteService: calculates routes
README.md