Zalmox
Multi-tenant property management system (PMS) for pensions and small hotels — Gantt calendar, check-in with MRZ/passport scanning, fiscal invoicing, guest stay app, public booking site, and platform admin.
Stack: Next.js 16 · React 19 · Supabase · TypeScript · Tailwind CSS 4 · Vitest
Quick start (local dev)
cp .env.example .env.local
# Supabase keys + ZALMOX_ADMIN_EMAILS (see .env.example)
npm run env:check:setup
npm install
npm run setup-platform-admin # once — platform admin account
npm run dev
Open http://localhost:3000. For tenant admin locally, set DEV_TENANT_SLUG in .env.local (see docs/tenant-security.md).
Staff pe un tenant: preferat signup (/signup) sau provision din /platform-admin. npm run setup-staff rămâne pentru legacy dev (vezi .env.example).
Verify
npm run typecheck
npm test
npm run build
Baseline: 1,308+ tests, strict TypeScript.
CI: GitHub Actions — npm test, test:security, typecheck, build on push/PR to main (.github/workflows/ci.yml).
Project map
| Area | Route | Code |
|---|
| Tenant admin (reception) | /admin/* | src/components/admin/, src/styles/features/admin/ |
| Platform admin | /platform-admin/* | src/components/platform-admin/, src/lib/platform-admin/ |
| Public site + booking | /, /calendar | src/features/public-site/ |
| Guest stay app | /stay/[code] | src/features/guest-app/ |
| Platform landing | /landing, /signup | src/app/[locale]/(platform)/ |
Architecture: ARCHITECTURE.md — layers, imports, CSS. Enforced by import-boundaries.test.ts and css-boundaries.test.ts.
Documentation
docs/README.md — index.
Scripts
| Command | Purpose |
|---|
npm run dev | Development server |
npm test | Unit + architecture tests |
npm run test:e2e | Playwright e2e |
npm run env:check | Validate .env.local |
npm run setup-platform-admin | Platform admin (Supabase Auth) |
npm run setup-staff | Legacy dev — tenant admin + operator |
License
Private — Zalmox.
