35 lines
1.4 KiB
Markdown
35 lines
1.4 KiB
Markdown
# EventSphere Enterprise Event Management Platform
|
|
|
|
Production-oriented multi-tenant event management SaaS with a Next.js admin/public frontend, NestJS API, PostgreSQL persistence, Redis-backed workers, RBAC, audit logging, payments, communications, QR check-in, CRM, forms, workflows, calendar routing, and reporting.
|
|
|
|
## Apps
|
|
- `apps/web`: Next.js 14 App Router frontend.
|
|
- `apps/api`: NestJS backend API.
|
|
- `packages/shared`: shared TypeScript contracts.
|
|
|
|
## Core modules
|
|
Events, event pages, ticket types, attendees, invitees, RSVP, registrations, QR codes, live check-in logs, calendar routing forms, bookings, email/SMS/WhatsApp via worker queues, CRM leads/deals/activities, Paystack payments/webhooks, reporting, tenant settings, integrations, users, roles, and permissions.
|
|
|
|
## Quick start
|
|
```bash
|
|
pnpm install
|
|
pnpm --filter api prisma:generate
|
|
pnpm dev
|
|
```
|
|
|
|
## Environment
|
|
Copy `.env.example` to `.env`.
|
|
|
|
For production, copy `.env.production.example` to `.env`, replace every secret, and use `docker-compose.prod.yml`.
|
|
|
|
## Verification
|
|
```bash
|
|
pnpm run typecheck
|
|
pnpm run lint
|
|
pnpm run build
|
|
docker compose -f docker-compose.prod.yml config --quiet
|
|
```
|
|
|
|
## First Tenant
|
|
Set `AUTO_BOOTSTRAP=1` with the `DEFAULT_*` values for first deployment, or visit `/setup` before any tenant exists. After the first tenant exists, public tenant creation is disabled unless `ALLOW_PUBLIC_SIGNUP=1`.
|