How zrn2003/avyana-fashion-store-backend works
Avyana Craft is an e-commerce backend API. Customers authenticate, browse the catalog and store settings, place and track orders, and complete payment; admins manage catalog, fulfillment, settings, and media. The graph distinguishes route/controller dispatch from service-level work and includes the persistence and middleware layers. The README documents capabilities such as inventory-safe transactions, Razorpay verification, and Cloudflare R2 uploads; some implementation details are unsampled, so those relationships are shown only where documented or indexed.
Main entry points: index.ts Express API · schema.prisma PostgreSQL · auth.service.ts Auth Service · orders Order Lifecycle
Components 21
API Runtime
- Express API
src/index.ts - Request Middleware
src/middleware - Health Probe
src/index.ts
Identity
- Auth Routes
src/modules/auth/auth.routes.ts - Auth Controller
src/modules/auth/auth.controller.ts - Auth Service
src/modules/auth/auth.service.ts - Auth Validation
src/modules/auth/auth.schema.ts
Storefront
- Catalog Products
src/modules/products - Store Settings
src/modules/settings
Commerce Operations
- Order Lifecycle
src/modules/orders - Order Validation
src/modules/orders/order.schema.ts - Payment Processing
src/modules/payments - Media Assets
src/modules/media - Store MCP Server
src/mcp/store-mcp-server.ts
Platform Services
- PostgreSQL
prisma/schema.prisma - Prisma Client
src/config/prisma.ts - Runtime Configuration
src/config/env.ts
Other components
- Storefront / Admin
- Google / Firebase Auth
- Razorpay
- Cloudflare R2
Connections 26
- Storefront / Admin → Express API: sends requests
README.md - Express API → Auth Routes: mounts routes
src/index.ts - Express API → Catalog Products: mounts routes
src/index.ts - Express API → Order Lifecycle: mounts routes
src/index.ts - Express API → Media Assets: mounts routes
src/index.ts - Express API → Store Settings: mounts routes
src/index.ts - Express API → Payment Processing: mounts routes
src/index.ts - Express API → Request Middleware: applies
src/index.ts - Auth Routes → Auth Controller: dispatches
src/modules/auth/auth.routes.ts - Auth Routes → Auth Validation: validates with
src/modules/auth/auth.routes.ts - Auth Controller → Auth Service: calls
src/modules/auth/auth.controller.ts - Auth Service → Prisma Client: reads and writes
src/modules/auth/auth.service.ts - Auth Service → Google / Firebase Auth: verifies identity
src/modules/auth/auth.service.ts - Catalog Products → PostgreSQL: reads and writes
src/modules/products/product.service.ts - Store Settings → PostgreSQL: reads and writes
src/modules/settings/settings.service.ts - Order Lifecycle → Order Validation: validates with
src/modules/orders/order.routes.ts - Order Lifecycle → Payment Processing: calls payment service
src/modules/orders/order.service.ts - Order Lifecycle → PostgreSQL: places and tracks
README.md - Payment Processing → Razorpay: verifies payments
README.md - Media Assets → PostgreSQL: registers assets
src/modules/media/media.service.ts - Media Assets → Cloudflare R2: uploads assets
README.md - Store MCP Server → PostgreSQL: queries store data
src/mcp/store-mcp-server.ts - Prisma Client → PostgreSQL: connects to
src/config/prisma.ts - Request Middleware → Runtime Configuration: reads limits and secrets
src/middleware/rateLimit.middleware.ts - Auth Service → Runtime Configuration: reads auth settings
src/modules/auth/auth.service.ts - Health Probe → PostgreSQL: probes health
README.md