NFC WESMUN is a cutting-edge conference management platform designed specifically for Model United Nations events. It leverages NFC technology to streamline delegate check-ins, bag verification, attendance tracking, and dietary management—all through a secure, role-based system.

• ⚡ Lightning Fast: Instant delegate identification via NFC tags
• 🔒 Enterprise Security: Multi-layer security with audit logging
• 📱 Mobile Optimized: Perfect for on-the-go security personnel
• 🎨 Modern UI: Beautiful, responsive interface built with shadcn/ui
• 📊 Rich Analytics: Export and analyze data in CSV/PDF formats
• 🌍 Scalable: Handles hundreds of delegates efficiently

• Unique UUID Assignment: Each delegate receives a unique NFC identifier
• Instant Recognition: Fast delegate lookup and verification
• Custom UUID Format: Base36 encoding for compact, URL-safe identifiers

• User Registration & Approval: Multi-step approval workflow for new users
• Bulk Operations: Create, update, and delete users in bulk
• Data-Only Users: Import delegate lists without login credentials
• Profile Management: Comprehensive delegate profiles with dietary info
• Role Assignment: Granular permission control with 4 distinct roles
• Email Domain Restrictions: Elevated roles limited to @wesmun.com emails

Four specialized roles with distinct permissions:

Plus: Emergency Admin role for audit log access and setup

• Bag Check: Mark when security screening is complete
• Attendance: Track delegate check-in/check-out
• Food Distribution: Monitor meal allocation status
• Dietary Preferences: Veg/Non-veg with allergen tracking
• Scan History: View complete interaction timeline
• Live Updates: Real-time synchronization across devices

• Complete Activity Trail: Every action logged with actor and target
• IP & User Agent Tracking: Enhanced security monitoring
• Historical Snapshots: Preserve user data even after changes
• Advanced Filtering: Search by action, user, date, or IP
• Emergency Admin Access: Dedicated role for audit review

• Multiple Formats: Export to CSV or PDF
• Advanced Filtering: Filter by attendance, diet, bags, etc.
• Count Queries: Get statistics without downloading data
• Custom Columns: Include NFC links, scan counts, allergens
• Date Stamping: Auto-generated filenames with timestamps
• Bulk Data: Handle hundreds of records efficiently

• Responsive Layout: Optimized for phones, tablets, and desktops
• Touch-Friendly: Large buttons and intuitive gestures
• Dark Mode: Reduce eye strain during long events
• Fast Loading: Optimized bundle sizes for mobile networks
• Scanner View: Dedicated interface for security/overseer/admin personnel

• Session-Based Auth: Secure HTTP-only cookies
• Rate Limiting: Prevent brute force attacks
• SQL Injection Protection: Parameterized queries throughout
• XSS Prevention: Content Security Policy headers

• Node.js: v18.0.0 or higher
• npm/pnpm/yarn: Latest version
• PostgreSQL: v15.0 or higher (local or hosted)
• Git: For version control

1. Clone the repository

   git clone https://github.com/DefinetlyNotAI/WESMUN_NFC
   cd nfc-wesmun

2. Install dependencies

   npm install
   # or
   pnpm install

3. Set up environment variables

   Create a .env.local file in the root directory:

   # Database Configuration
   DATABASE_URL=postgresql://user:password@host:5432/database
   # Session Secret (generate with: openssl rand -base64 32)
   SESSION_SECRET=your-super-secret-session-key-here
   # Emergency Admin
    EMERGENCY_ADMIN_USERNAME=username@wesmun.com
    EMERGENCY_ADMIN_PASSWORD=your-password-here

4. Set up the database

   # Use the Python script
   python scripts/setupSQL.py

5. Run the development server

   npm run dev

6. Open your browser

   Navigate to http://localhost:3000

1. Login in via emergency admin and setup new admin accounts to share
2. Create NFC links for delegates in the admin panel
3. Start scanning NFC tags at your event

• Framework: Next.js 16 with App Router
• Language: TypeScript 5
• Styling: Tailwind CSS v4
• Components: shadcn/ui + Radix UI
• Icons: Lucide React
• Theme: next-themes for dark mode
• Analytics: Vercel Analytics

• Runtime: Node.js 18+
• Database: PostgreSQL 15+
• ORM: Raw SQL with node-postgres (pg)
• Authentication: Custom session-based auth
• PDF Generation: pdf-lib

• Hosting: Vercel (recommended) or any Node.js host
• Database Hosting: Neon, Supabase, Aiven or self-hosted PostgreSQL
• Version Control: Git
• CI/CD: Vercel automatic deployments

1. Push to GitHub

   git push origin main

2. Import to Vercel

   • Go to vercel.com/new
   • Import your repository
   • Configure environment variables
   • Deploy!

3. Set Environment Variables in Vercel Dashboard

Node.js Server

npm run build
npm start

┌─────────────────────────────────────────────────────────────┐
│ Frontend (Next.js) │
│ ┌──────────┬──────────┬──────────┬──────────┬──────────┐ │
│ │ Auth │ Users │ NFC │ Admin │ Audit │ │
│ │ Pages │ Mgmt │ Scan │ Panel │ Logs │ │
│ └──────────┴──────────┴──────────┴──────────┴──────────┘ │
│ ↕ HTTP │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ API Routes (/api/*) │ │
│ │ • Authentication • Users • NFC • Admin • Audit │ │
│ └──────────────────────────────────────────────────────┘ │
│ ↕ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Business Logic Layer (lib/) │ │
│ │ • auth.ts • db.ts • permissions.ts • audit.ts │ │
│ └──────────────────────────────────────────────────────┘ │
└─────────────────────────────┬───────────────────────────────┘
 ↕
 ┌─────────────────────────┐
 │ PostgreSQL Database │
 │ • users • profiles │
 │ • nfc_links • roles │
 │ • audit_logs │
 └─────────────────────────┘

1. Authentication: User logs in → Session created → Cookie set
2. NFC Scan: QR/NFC scanned → UUID sent to API → User data fetched → Profile updated
3. Audit Log: Action performed → Log entry created with actor, target, details
4. Permissions: Request received → User authenticated → Role checked → Permission verified

Default role for all registered users

• Do not sign-in [Data only users]
• Used primarily as data subjects in the system, for the other roles

For checkpoint personnel

• ✅ Scan NFC tags and view delegate info
• ✅ Update attendance, bag and food receival status
• ❌ Cannot modify dietary information
• ❌ Cannot manage users or roles

Ideal for: Entry checkpoints, bag screening stations

Read-only security access

• ✅ Scan NFC tags and view delegate info
• ❌ Cannot modify any information
• ❌ Cannot approve users or manage system

Ideal for: Conference coordinators, observers, reporting staff

Full system control

• ✅ All Security and Overseer capabilities
• ✅ Approve/reject user registrations
• ✅ Create and manage users (including bulk operations)
• ✅ Assign roles (for @wesmun.com emails only)
• ✅ Update all profile fields (diet, allergens, etc.)
• ✅ Create NFC links for delegates
• ✅ Export data in multiple formats
• ❌ No access to audit

Ideal for: Conference organizers, Secretary Generals

Special elevated access

• ✅ All Admin capabilities
• ✅ View/Delete complete audit logs

Set via environment variable

Ideal for: Security investigations, IT Department

We welcome contributions! Here's how to get started:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• shadcn/ui for beautiful component primitives
• Vercel for serverless hosting and deployment platform
• Aiven for PostgreSQL DB

• Issues: GitHub Issues
• Documentation: Wiki
• Security: See SECURITY.md

This project is licensed under the MIT License - see the LICENSE file for details.