How randommness/5-musketeers works
Pet Guardian is a pet-care shopping and customer-insights website backed by a FastAPI service. The principal workflow is browsing the catalog and retail information, placing orders, and submitting reviews; separate API capabilities provide login, customer dashboards, check-ins, goal-based recommendations, and product pairings. The backend routes requests to service modules, which query the database and, for selected insight and recommendation features, call an LLM. The README confirms the website connects to the API; source excerpts do not establish specific browser-to-route calls, so those links remain broad.
Main entry points: api.py Router registry · llm.py LLM client · check_in_service.py Check-in insights · goal_achiever_service.py Goal recommendations
Components 32
Website
- Website pages
frontend - API client
frontend/api.js
API runtime
- App entry
app/main.py - Router registry
app/api.py - Login route
app/routers/api_login.py - Catalog route
app/routers/api_catalog.py - Dashboard route
app/routers/api_customer_dashboard.py - Retail routes
app/routers/api_retail.py - Order route
app/routers/api_new_order.py - Order update route
app/routers/api_update_order.py - Review route
app/routers/api_new_review.py - Check-in route
app/routers/first_check_in.py - Goal route
app/routers/goal_achiever.py - Pairing route
app/routers/product_pair.py - Products route
app/routers/products.py - Health route
app/routers/health.py
Commerce services
- Login service
app/services/api_login_service.py - Catalog service
app/services/api_catalog_service.py - Retail data
app/services/api_retail_services.py - Order creation
app/services/api_new_order_service.py - Order updates
app/services/api_update_order_service.py - Review creation
app/services/api_new_review_service.py
Insights services
- Customer dashboard
app/services/api_customer_dashboard_service.py - Check-in insights
app/services/check_in_service.py - Goal recommendations
app/services/goal_achiever_service.py - Product pairing
app/services/product_pair_service.py - Product listing
app/services/products_service.py
Data and AI
- DB sessions
app/db/session.py - Application database
- LLM client
app/services/llm.py
Other components
- Pet owner
- LLM provider
Connections 36
- Pet owner → Website pages: uses
README.md - Website pages → API client: uses
- API client → Router registry: calls API
README.md - App entry → Router registry: creates app
app/main.py - Router registry → Login route: registers
app/api.py - Router registry → Catalog route: registers
app/api.py - Router registry → Dashboard route: registers
app/api.py - Router registry → Retail routes: registers
app/api.py - Router registry → Order route: registers
app/api.py - Router registry → Order update route: registers
app/api.py - Router registry → Review route: registers
app/api.py - Router registry → Check-in route: registers
app/api.py - Router registry → Goal route: registers
app/api.py - Router registry → Pairing route: registers
app/api.py - Router registry → Products route: registers
app/api.py - Router registry → Health route: registers
app/api.py - Login route → Login service: delegates to
app/routers/api_login.py - Catalog route → Catalog service: delegates to
app/routers/api_catalog.py - Dashboard route → Customer dashboard: delegates to
app/routers/api_customer_dashboard.py - Retail routes → Retail data: delegates to
app/routers/api_retail.py - Order route → Order creation: delegates to
app/routers/api_new_order.py - Order update route → Order updates: delegates to
app/routers/api_update_order.py - Review route → Review creation: delegates to
app/routers/api_new_review.py - Check-in route → Check-in insights: delegates to
app/routers/first_check_in.py - Goal route → Goal recommendations: delegates to
app/routers/goal_achiever.py - Pairing route → Product pairing: delegates to
app/routers/product_pair.py - Products route → Product listing: delegates to
app/routers/products.py - Retail data → Application database: queries
app/services/api_retail_services.py - Review creation → Application database: writes review
app/services/api_new_review_service.py - Check-in insights → Application database: reads orders
app/services/check_in_service.py - Goal recommendations → Application database: reads customer data
app/services/goal_achiever_service.py - Product pairing → Application database: reads product data
app/services/product_pair_service.py - Check-in insights → LLM client: requests text
app/services/check_in_service.py - Goal recommendations → LLM client: requests text
app/services/goal_achiever_service.py - Product pairing → LLM client: requests pairings
app/services/product_pair_service.py - LLM client → LLM provider: sends prompt
app/services/llm.py