How amenmnx/bean-beacon works
Bean Beacon is a café-discovery application: users explore nearby places, search and filter results, inspect café profiles, and save favorites or contribute reviews. The frontend also supports café submissions and administration; the backend serves these workflows with MongoDB-backed records and OpenStreetMap integrations. The graph reflects the sampled routes and controller calls plus README-documented capabilities. Several frontend component-to-page/API links and backend startup wiring were not excerpted, so those relationships are omitted rather than inferred.
Main entry points: api.ts API client · App.tsx Web app routes · Index.tsx Cafe discovery · cafeRoutes.ts Cafe endpoints
Components 33
Discovery frontend
- Web app routes
bean-beacon-frontend/src/App.tsx - Cafe discovery
bean-beacon-frontend/src/pages/Index.tsx - Dashboard
bean-beacon-frontend/src/pages/Dashboard.tsx - Cafe management
bean-beacon-frontend/src/pages/Manage.tsx - Cafe profile
bean-beacon-frontend/src/pages/CafeProfile.tsx - Interactive map
bean-beacon-frontend/src/components/CafeMap.tsx - Search and filters
bean-beacon-frontend/src/components/SearchBar.tsx - Preference recommender
bean-beacon-frontend/src/components/CafeRecommender.tsx - Reviews interface
bean-beacon-frontend/src/components/CafeReviews.tsx - API client
bean-beacon-frontend/src/lib/api.ts
API workflows
- Cafe endpoints
bean-beacon-backend/src/routes/cafeRoutes.ts - Recommendation handler
bean-beacon-backend/src/controllers/recommendationController.ts - Auth endpoints
bean-beacon-backend/src/routes/authRoutes.ts - Admin endpoints
bean-beacon-backend/src/routes/adminRoutes.ts - Favorite endpoints
bean-beacon-backend/src/routes/favoriteRoutes.ts - Rating endpoints
bean-beacon-backend/src/routes/ratingRoutes.ts
Place data
- Cafe operations
bean-beacon-backend/src/controllers/cafeController.ts - Preference matching
bean-beacon-backend/src/services/recommendationService.ts - Place data lookup
bean-beacon-backend/src/services/overpassService.ts - Address geocoding
bean-beacon-backend/src/services/geocodingService.ts
Accounts and community
- Authentication
bean-beacon-backend/src/controllers/authController.ts - Favorites operations
bean-beacon-backend/src/controllers/favoriteController.ts - Ratings and reviews
bean-beacon-backend/src/controllers/ratingController.ts - Admin operations
bean-beacon-backend/src/controllers/adminController.ts - Token authorization
bean-beacon-backend/src/middleware/auth.ts
Persistence
- Cafe records
bean-beacon-backend/src/models/Cafe.ts - User records
bean-beacon-backend/src/models/User.ts - Favorite records
bean-beacon-backend/src/models/Favorite.ts - Rating records
bean-beacon-backend/src/models/Rating.ts
Other components
- Visitor
- OpenStreetMap services
- MongoDB
- Nominatim
Connections 42
- Visitor → Web app routes: uses
- Web app routes → Cafe discovery: routes to
bean-beacon-frontend/src/App.tsx - Web app routes → Dashboard: routes to
bean-beacon-frontend/src/App.tsx - Web app routes → Cafe management: routes to
bean-beacon-frontend/src/App.tsx - Web app routes → Cafe profile: routes to
bean-beacon-frontend/src/App.tsx - Cafe discovery → Interactive map: displays on
- Cafe discovery → Search and filters: filters with
- Cafe discovery → Preference recommender: offers
- Cafe profile → Reviews interface: shows
- Cafe discovery → API client: requests data
- Cafe profile → API client: requests details
- Cafe management → API client: submits changes
- API client → Cafe endpoints: calls API
- API client → Auth endpoints: calls API
- API client → Favorite endpoints: calls API
- API client → Rating endpoints: calls API
- Cafe endpoints → Cafe operations: dispatches
bean-beacon-backend/src/routes/cafeRoutes.ts - Cafe endpoints → Recommendation handler: dispatches
bean-beacon-backend/src/routes/cafeRoutes.ts - Recommendation handler → Preference matching: ranks cafes
bean-beacon-backend/src/controllers/recommendationController.ts - Cafe operations → Cafe records: reads and writes
bean-beacon-backend/src/controllers/cafeController.ts - Cafe operations → Place data lookup: fetches places
bean-beacon-backend/src/controllers/cafeController.ts - Cafe operations → Address geocoding: geocodes addresses
bean-beacon-backend/src/controllers/cafeController.ts - Place data lookup → OpenStreetMap services: queries places
bean-beacon-backend/src/services/overpassService.ts - Address geocoding → Nominatim: resolves addresses
- Auth endpoints → Authentication: dispatches
bean-beacon-backend/src/routes/authRoutes.ts - Authentication → User records: reads and writes
bean-beacon-backend/src/controllers/authController.ts - Favorite endpoints → Favorites operations: dispatches
bean-beacon-backend/src/routes/favoriteRoutes.ts - Favorites operations → Favorite records: reads and writes
bean-beacon-backend/src/controllers/favoriteController.ts - Favorites operations → Cafe records: looks up cafes
bean-beacon-backend/src/controllers/favoriteController.ts - Rating endpoints → Ratings and reviews: dispatches
bean-beacon-backend/src/routes/ratingRoutes.ts - Ratings and reviews → Rating records: reads and writes
bean-beacon-backend/src/controllers/ratingController.ts - Ratings and reviews → Cafe records: updates averages
bean-beacon-backend/src/controllers/ratingController.ts - Admin endpoints → Admin operations: dispatches
bean-beacon-backend/src/routes/adminRoutes.ts - Admin endpoints → Ratings and reviews: dispatches
bean-beacon-backend/src/routes/adminRoutes.ts - Admin endpoints → Token authorization: guards endpoints
bean-beacon-backend/src/routes/adminRoutes.ts - Cafe endpoints → Token authorization: guards writes
bean-beacon-backend/src/routes/cafeRoutes.ts - Favorite endpoints → Token authorization: guards endpoints
bean-beacon-backend/src/routes/favoriteRoutes.ts - Rating endpoints → Token authorization: guards endpoints
bean-beacon-backend/src/routes/ratingRoutes.ts - Cafe records → MongoDB: persists
- User records → MongoDB: persists
- Favorite records → MongoDB: persists
- Rating records → MongoDB: persists