Muze Uniform Solutions/
├── backend/ # NestJS API (port 3001)
│ ├── src/
│ │ ├── main.ts # Bootstrap: helmet, cors, ValidationPipe, global filters
│ │ ├── app.module.ts # Root module, imports all feature modules
│ │ ├── auth/ # Session/permissions/scope guards, permission registry
│ │ ├── prisma/ # PrismaModule (global) + PrismaService
│ │ ├── config/ # Zod env validation, CORS origins
│ │ ├── filters/ # Prisma + HTTP exception filters
│ │ ├── clients/ # Client CRUD
│ │ ├── regions/ # Region CRUD
│ │ ├── departments/ # Department CRUD
│ │ ├── stores/ # Store CRUD + bulk CSV import
│ │ ├── catalog/ # Uniform categories + products
│ │ ├── employees/ # Employee management + CSV import
│ │ ├── entitlements/ # Entitlement engine, rule sets, CSV import
│ │ ├── orders/ # Order lifecycle, approvals, status transitions
│ │ ├── notifications/ # In-app notifications + email service
│ │ ├── reports/ # Spend, replacement-due, production reports
│ │ ├── users/ # Staff accounts + role assignment
│ │ ├── audit-logs/ # Audit trail
│ │ └── system-settings/ # System-wide settings
│ ├── prisma/
│ │ ├── schema.prisma # Data model (SOURCE OF TRUTH)
│ │ └── migrations/ # Prisma migrations
│ ├── render.yaml # Render deployment config
│ └── package.json
│
├── frontend/ # React SPA (Vite)
│ ├── src/
│ │ ├── main.tsx # Providers + router mount
│ │ ├── App.tsx # Route tree, lazy loading, route guards, error boundaries
│ │ ├── index.css # Brand tokens, Tailwind, motion vocabulary
│ │ ├── lib/ # api.ts, auth-client.ts, domain-types.ts, status.ts, seo.ts, constants.ts
│ │ ├── hooks/ # use-auth, use-active-client, use-permissions, use-document-title, ...
│ │ ├── components/ # ui/ (shadcn), common/, layout/, admin/, manager/, orders/
│ │ ├── pages/ # login, dashboard, profile, notifications + admin/, manager/
│ │ └── types/ # Shared TypeScript types
│ ├── scripts/ # Build-time generators (e.g. robots.txt + sitemap.xml)
│ ├── e2e/ # Playwright E2E suite
│ └── package.json
│
├── .agents/ # AI agent skill definitions
└── docs-site/ # Documentation sites (Mintlify)
├── docs/ # User guide
└── architecture/ # Architecture docs (this site)
