QR Attendance - Multi-Tenant Platform

Event attendance management with QR codes, real-time dashboard, and automated email delivery.

Quick Start

# Build and run
go build
./event-manager

# Access at https://localhost:8443

Architecture

Multi-tenant platform with organization and event isolation:

Users → Organizations → Events → Attendees
                              → Staff
                              → Settings

Key Features

• Multi-tenant with org/event isolation
• JWT authentication + role-based access
• QR code check-in system
• Real-time attendance dashboard
• Automated email delivery
• Subdomain routing support

API Endpoints

Authentication

• POST /api/auth/register - User registration
• POST /api/auth/login - Login
• GET /api/auth/me - Current user

Organizations

• GET /api/organizations - List organizations
• POST /api/organizations - Create organization
• GET /api/organizations/:id/members - Manage members

Events

• GET /api/events - List events
• POST /api/events - Create event
• POST /api/events/:id/activate - Set active event

Event Operations

• POST /api/events/:event_id/scan - QR scanning
• GET /api/events/:event_id/attendees - List attendees
• POST /api/events/:event_id/staff - Manage staff
• GET /api/events/:event_id/audit/logs - Audit logs

Project Structure

event-manager/
├── api/              # REST API handlers
├── data/             # Database layer
├── ui/               # React frontend
├── email/            # Email service
├── docs/             # Documentation
└── scripts/          # Utility scripts

Documentation

Essential docs:

• QUICK_START.md - Getting started guide
• REMAINING_WORK_CHECKLIST.md - Development tasks
• docs/ARCHITECTURE.md - System architecture
• docs/SECURITY.md - Security features
• docs/DEPLOYMENT.md - Deployment guide

Development

# Build
go build

# Run tests
go test ./...

# Start server
./start.sh

License

MIT