How kamisso96/woroba works
This is a multi-shop inventory and sales management application: users authenticate, select a shop, and manage its catalog, stock movements, sales, suppliers, and reporting/export needs. The backend’s sampled controllers show shop-scoped API operations, with authentication and shop access guards; the frontend tree indicates corresponding dashboard and management screens. Notifications and account/shop administration are additional capabilities. Frontend-to-backend wiring and several unsampled service internals are not established by the available excerpts, so those relationships are omitted.
Main entry points: prisma.service.ts Application database · auth.service.ts Authentication · shop-access.guard.ts Shop access · jwt-auth.guard.ts JWT guard
Components 19
Web application
- Dashboard
frontend/src/app/(app)/dashboard/page.tsx - Catalog screens
frontend/src/app/(app)/products/page.tsx - Reports screens
frontend/src/app/(app)/reports/page.tsx - Sales screens
frontend/src/app/(app)/sales/new/page.tsx - API client
frontend/src/lib/api.ts
Identity and shop access
- Authentication
backend/src/auth/auth.service.ts - JWT guard
backend/src/auth/guards/jwt-auth.guard.ts - Shop access
backend/src/shops/guards/shop-access.guard.ts - Shop administration
backend/src/shops/shops.service.ts
Inventory operations
- Categories
backend/src/categories/categories.service.ts - Products
backend/src/products/products.service.ts - Stock movements
backend/src/stock-movements/stock-movements.service.ts - Suppliers
backend/src/suppliers/suppliers.service.ts
Sales and insights
- Sales and receipts
backend/src/sales/sales.service.ts - Data exports
backend/src/export/export.service.ts
Shop services
- Stock notifications
backend/src/notifications/notifications.service.ts - User account
backend/src/users/users.service.ts - Application database
backend/src/prisma/prisma.service.ts
Other components
- Shop user
Connections 14
- Shop user → Authentication: authenticates
backend/src/auth/auth.service.ts - Shop user → Dashboard
- Shop user → Catalog screens
- Shop user → Reports screens
- Shop user → Sales screens
- Authentication → Application database: reads and writes
backend/src/auth/auth.service.ts - JWT guard → Shop access: guards shop routes
backend/src/products/products.controller.ts - Shop access → Application database: checks ownership
backend/src/shops/guards/shop-access.guard.ts - Categories → Application database: persists categories
backend/src/categories/categories.service.ts - Products → Application database: persists products
- Stock movements → Application database: persists movements
- Suppliers → Application database: persists suppliers
- Sales and receipts → Application database: persists sales
backend/src/sales/sales.service.ts - Data exports → Application database: reads export data
backend/src/export/export.service.ts