Platform Overview¶

Overview¶

Nigall is a multi-module event management SaaS platform that lets organizations plan, publish, sell, operate, and measure events from a single workspace. It supports simple RSVP gatherings, large ticketed conferences, exhibitor expos, sponsor-driven galas, speaker programs, volunteer operations, and venue-backed productions.

Purpose¶

Replace fragmented tools (registration spreadsheets, separate email tools, manual check-in lists, disconnected sponsor CRMs) with one system where event data, participants, payments, and communications stay synchronized.

Who should use it¶

Persona	Primary use
Event organizer / host	Create events, configure modules, manage guests and revenue
Operations manager	Check-in, program, volunteer coordination
Marketing / comms	Email blasts, reminders, discover listing
Finance	Payments, refunds, sponsor invoicing
Attendee / guest	RSVP, register, pay, receive tickets
Exhibitor / vendor / sponsor	Apply, pay, fulfill deliverables
Speaker / volunteer	Apply, complete workflows, check in
Platform admin (Nigall staff)	Approval queues, system configuration

Benefits¶

Single source of truth for event configuration and participant records
Modular activation — enable only the modules each event needs
Two registration paths — lightweight RSVP or full attendee registration with tickets and QR
Stripe-native payments with platform fee handling
Role-aware Tools hub unlocked by subscription tier
Mobile API for discover, RSVP, and ticket wallet experiences

Area	URL
Landing / marketing events list	`/` → `/events/`
Discover (public events)	`/events/discover/`
My Events	`/events/my-events/`
Organizer Dashboard	`/events/organizer/`
Tools hub	`/events/tools/`
Pricing	`/pricing/`
Sign in	`/accounts/login/`
Sign up	`/accounts/signup/`

Prerequisites¶

Modern web browser (Chrome, Edge, Firefox, Safari)
Verified email address (recommended; verification mode may be set to optional)
For paid features: active subscription plan or accepted transaction-fee model

Architecture summary¶

Nigall is built as a Django monolith with per-event module toggles stored on the Event model. Key apps:

App	Responsibility
`events`	Event CRUD, RSVP, venues, volunteers, discover
`attendees`	Registration, tickets, check-in, networking, GDPR
`payments`	Stripe checkout, webhooks, platform fees
`communications`	Templates, blasts, reminders, tracking
`program`	Agenda, sessions, live board, Q&A
`speakers`	Call for speakers, contracts, travel
`exhibitors`	Booths, packages, lead capture
`vendors`	Stalls, settlements, trading
`sponsors`	Pipeline, contracts, deliverables
`talent_management`	Org-level talent CRM, VIP guests
`mobile_api`	JWT REST API for mobile clients

Business rules (platform-wide)¶

Rule	Detail
Event URL pattern	`/events/<pk>/<event_tag>/` — both ID and 6-char tag required
Host ownership	`event.host` is the primary organizer; most management views require host or staff
Public discover	Only events with `visibility=public` appear on Discover
Public events require category	At least one event category must be assigned
Free event hosting	Any authenticated user can create events
Module gating	Tools unlocked by `subscription_plan` on user account
Transaction fees	5% platform fee (Essentials/Free) or 3% (Pro tiers) on applicable ticket revenue

User permissions (summary)¶

See Roles & Permissions for the full matrix.

Workflow — typical event lifecycle¶

flowchart TD A[Create account] --> B[Create event] B --> C{Registration type?} C -->|RSVP| D[Configure RSVP + survey questions] C -->|Registration| E[Enable Attendees module + tiers] D --> F[Publish / share link] E --> F F --> G[Guests register] G --> H[Communications & reminders] H --> I[Day-of check-in] I --> J[Post-event analytics & thank-you]

Examples¶

Corporate town hall (RSVP): Private link, 200 capacity, dietary survey question, guest check-in list.

Industry conference (Registration): Public discover listing, paid tiers, attendee module, program schedule, speaker CFP, exhibitor hall.

Best practices¶

Choose RSVP for invite-only events with simple headcount; choose Registration + Attendees when you need tickets, QR check-in, transfers, or GDPR tooling.
Enable modules during create/edit, then complete the module setup wizard before going live.
Set capacity early; waitlist behavior depends on registration path.

Common mistakes¶

Creating a Registration event but never enabling Attendees — guests see legacy checkout instead of unified registration.
Setting event to Public without categories — save validation fails.
Testing as host and expecting to see the guest RSVP form — hosts see management UI instead.

FAQs¶

Is Nigall only for ticketed events?
No. RSVP-only events are fully supported without payments.

Can one user manage multiple events?
Yes. Use My Events and the Organizer Dashboard.

Troubleshooting¶

Symptom	Likely cause	Fix
Module menu missing	Plan or toggle not enabled	Upgrade plan; enable module on event edit
Event not on Discover	Private visibility or missing category	Set public + add category

Screenshot placeholders¶

[SCREENSHOT: Landing page hero and Host an Event CTA]
[SCREENSHOT: My Events dashboard]
[SCREENSHOT: Tools hub grid]

Administrator notes¶

Platform staff (is_staff) bypass subscription tool gating and can access admin approval queues for modules configured with approval_type=admin.

Developer/API notes¶

Web: Django templates + session auth (django-allauth)
Mobile: /api/mobile/v1/ JWT
Talent CRM: /api/v1/ DRF ViewSets