Architecture Overview
System Components
Backend Services
| Package | Framework | Purpose |
|---|---|---|
@hugo-saas/database | Prisma + SQLite | Shared schema, migrations, seed data, Prisma client |
@hugo-saas/identity-service | NestJS (REST) | Demo account switching for simulating different role/permission scenarios |
@hugo-saas/admin-bff | Koa + GraphQL | Admin dashboard BFF: organizations, users, memberships, roles, activity logs |
@hugo-saas/entitlement-service | NestJS (REST + GraphQL) | Product catalog, entitlements, seat allocations, bulk imports |
Frontend Tech Stack
| Project | Framework | UI Library | State Management | API Style |
|---|---|---|---|---|
| hugo-saas-console | React + TypeScript | @hugo-ui/mui (MUI + Emotion) | Module Federation split | GraphQL |
| hugo-entitlement-console | Vue 3 + TypeScript | @hugo-ui/shadcn-vue (Tailwind) | Pinia + TanStack Vue Query | GraphQL + REST |
| hugo-entitlement-importer-desktop | Electron + Vue 3 | @hugo-ui/shadcn-vue (Tailwind) | Pinia | REST |