How dhanusrisenthikumar/furry-backend works
This is a MongoDB-backed pet-commerce API. Shoppers browse products, manage carts, get order quotes, place and pay for orders, then follow delivery, returns, rewards, and notifications; staff manage catalog and operations. The graph includes the documented domain branches and the shared persistence layer. Evidence is limited to the README (empty), SOURCE INDEX references, and sampled excerpts; unsampled routes and integrations are shown only where those references support the link.
Main entry points: main.py API application · orders/service.py Orders · stock_alerts/service.py Stock alerts · repository.py Product catalog
Components 23
API and access
- API application
app/main.py - Authentication
app/modules/auth/router.py - MCP tools
app/mcp/server.py
Commerce lifecycle
- Product catalog
app/modules/products/repository.py - Cart
app/modules/cart/service.py - Orders
app/modules/orders/service.py - Payments
app/modules/payments/service.py - Returns and refunds
app/modules/returns/service.py - Pricing and shipping
app/core/pricing.py - Reviews and questions
app/modules/reviews/service.py - Recommendations
app/modules/recommendations/service.py
Customer services
- Loyalty and referrals
app/modules/loyalty/service.py - Notifications
app/modules/notifications/service.py - Email delivery
app/core/email.py - Customer accounts
app/modules/users/service.py
Store operations
- Stock alerts
app/modules/stock_alerts/service.py - Subscriptions
app/modules/subscriptions/service.py - Administration
app/modules/admin/service.py - Subscription scheduler
app/scheduler.py
Persistence
- MongoDB connection
app/db/mongodb.py - Repository base
app/db/base_repository.py
Other components
- Shopper
- Staff
Connections 40
- Shopper → API application: uses API
- Staff → API application: uses API
- API application → Authentication: routes to
app/main.py - API application → MCP tools: mounts tools
app/main.py - API application → MongoDB connection: initializes
app/main.py - API application → Product catalog: routes catalog
app/main.py - API application → Cart: routes cart
app/main.py - API application → Orders: routes orders
app/main.py - API application → Payments: routes payments
app/main.py - API application → Returns and refunds: routes returns
app/main.py - API application → Stock alerts: routes alerts
app/main.py - API application → Administration: routes admin
app/main.py - MCP tools → Orders: uses order logic
app/mcp/server.py - MCP tools → Cart: uses cart logic
app/mcp/server.py - MCP tools → Product catalog: queries catalog
app/mcp/server.py - Orders → Product catalog: checks stock
app/modules/orders/service.py - Orders → Pricing and shipping: calculates totals
app/modules/orders/service.py - Orders → Payments: coordinates payment
app/modules/payments/service.py - Orders → Loyalty and referrals: applies rewards
app/modules/orders/service.py - Orders → Notifications: notifies lifecycle
app/modules/orders/service.py - Orders → Email delivery: sends order mail
app/modules/orders/service.py - Orders → Stock alerts: flushes stock alerts
app/modules/orders/service.py - Payments → Orders: uses order service
app/modules/payments/service.py - Returns and refunds → Orders: checks eligibility
app/modules/returns/service.py - Returns and refunds → Pricing and shipping: prices refunds
app/modules/returns/service.py - Returns and refunds → Notifications: reports decisions
app/modules/returns/service.py - Returns and refunds → Email delivery: emails customer
app/modules/returns/service.py - Loyalty and referrals → Notifications: pushes rewards
app/modules/loyalty/service.py - Stock alerts → Product catalog: checks availability
app/modules/stock_alerts/service.py - Stock alerts → Customer accounts: looks up customer
app/modules/stock_alerts/service.py - Stock alerts → Notifications: announces restock
app/modules/stock_alerts/service.py - Stock alerts → Email delivery: emails restock
app/modules/stock_alerts/service.py - Subscription scheduler → MongoDB connection: connects database
app/scheduler.py - Subscription scheduler → Subscriptions: runs due work
- Recommendations → Product catalog: ranks products
app/modules/recommendations/service.py - Reviews and questions → Product catalog: checks products
app/modules/reviews/service.py - Reviews and questions → Orders: verifies purchases
app/modules/reviews/service.py - Customer accounts → MongoDB connection: persists accounts
- Repository base → MongoDB connection: accesses collections
- Administration → MongoDB connection: manages store data