conference/SPEC.md

# Networking Event Platform - Specification

## Project Overview
- **Project Name**: NetEvent
- **Type**: Full-stack web application (Flask + MySQL)
- **Core Functionality**: A platform for organizing networking events where attendees can RSVP, connect, schedule appointments, and attend breakout sessions
- **Target Users**: Event organizers, event staff, and event attendees

## Technology Stack
- **Backend**: Python Flask
- **Database**: MySQL (roast.duckdns.org:33062)
- **Frontend**: HTML/CSS/JavaScript with Jinja2 templates

## Database Schema

### Tables

#### `organizers`
| Column | Type | Description |
|--------|------|-------------|
| id | INT PRIMARY KEY AUTO_INCREMENT | Organizer ID |
| email | VARCHAR(255) UNIQUE | Organizer email |
| password_hash | VARCHAR(255) | Hashed password |
| name | VARCHAR(255) | Organizer name |
| staff_code | VARCHAR(10) UNIQUE | Staff access code |
| preferred_language | VARCHAR(5) DEFAULT 'en' | Preferred language code |
| reset_token | VARCHAR(64) | Password reset token |
| reset_token_expiry | DATETIME | Password reset token expiry |
| created_at | TIMESTAMP | Creation timestamp |

#### `events`
| Column | Type | Description |
|--------|------|-------------|
| id | INT PRIMARY KEY AUTO_INCREMENT | Event ID |
| organizer_id | INT FOREIGN KEY | Reference to organizers |
| code | VARCHAR(10) UNIQUE | Unique 10-char alphanumeric event code |
| name | VARCHAR(255) | Event name |
| description | TEXT | Event description |
| start_time | DATETIME | Event start date/time |
| end_time | DATETIME | Event end date/time |
| location | VARCHAR(255) | Event location |
| max_attendees | INT | Maximum attendees (NULL = unlimited) |
| created_at | TIMESTAMP | Creation timestamp |

#### `attendees`
| Column | Type | Description |
|--------|------|-------------|
| id | INT PRIMARY KEY AUTO_INCREMENT | Attendee ID |
| event_id | INT FOREIGN KEY | Reference to events |
| email | VARCHAR(255) | Attendee email |
| password_hash | VARCHAR(255) | Hashed password |
| first_name | VARCHAR(100) | First name |
| last_name | VARCHAR(100) | Last name |
| organisation | VARCHAR(255) | Organization/Company |
| role | VARCHAR(255) | Role/Profession |
| introduction | TEXT | Short introduction |
| profile_picture | VARCHAR(255) | Profile picture path |
| checked_in | BOOLEAN DEFAULT FALSE | Check-in status |
| attendance_status | ENUM('attending', 'not_attending') | Attendance status |
| confirmation_token | VARCHAR(64) | Email confirmation token |
| attendee_code | VARCHAR(10) UNIQUE | Unique attendee code for QR |
| phone | VARCHAR(50) | Phone number |
| linkedin | VARCHAR(255) | LinkedIn profile URL |
| attendee_type_id | INT FOREIGN KEY | Reference to attendee_types |
| preferred_language | VARCHAR(5) DEFAULT 'en' | Preferred language code |
| created_at | TIMESTAMP | Creation timestamp |

#### `connections`
| Column | Type | Description |
|--------|------|-------------|
| id | INT PRIMARY KEY AUTO_INCREMENT | Connection ID |
| attendee_id | INT FOREIGN KEY | Requester attendee |
| connected_attendee_id | INT FOREIGN KEY | Connect target attendee |
| status | ENUM('pending','accepted','rejected') | Connection status |
| created_at | TIMESTAMP | Creation timestamp |

#### `appointments`
| Column | Type | Description |
|--------|------|-------------|
| id | INT PRIMARY KEY AUTO_INCREMENT | Appointment ID |
| event_id | INT FOREIGN KEY | Reference to events |
| requester_id | INT FOREIGN KEY | Requester attendee |
| target_id | INT FOREIGN KEY | Target attendee |
| appointment_time | DATETIME | Proposed meeting time |
| location | VARCHAR(255) | Meeting location |
| notes | TEXT | Appointment notes |
| status | ENUM('pending','accepted','rejected') | Appointment status |
| created_at | TIMESTAMP | Creation timestamp |

#### `breakout_sessions`
| Column | Type | Description |
|--------|------|-------------|
| id | INT PRIMARY KEY AUTO_INCREMENT | Session ID |
| code | VARCHAR(10) UNIQUE | Unique session code |
| event_id | INT FOREIGN KEY | Reference to events |
| name | VARCHAR(255) | Session name |
| description | TEXT | Session description |
| start_time | DATETIME | Session start time |
| end_time | DATETIME | Session end time |
| location | VARCHAR(255) | Session location |
| max_attendees | INT | Maximum attendees (NULL = unlimited) |
| created_at | TIMESTAMP | Creation timestamp |

#### `breakout_session_organizers`
| Column | Type | Description |
|--------|------|-------------|
| id | INT PRIMARY KEY AUTO_INCREMENT | ID |
| breakout_session_id | INT FOREIGN KEY | Reference to breakout_sessions |
| organizer_id | INT FOREIGN KEY | Reference to organizers |
| created_at | TIMESTAMP | Creation timestamp |

#### `breakout_session_rsvps`
| Column | Type | Description |
|--------|------|-------------|
| id | INT PRIMARY KEY AUTO_INCREMENT | RSVP ID |
| breakout_session_id | INT FOREIGN KEY | Reference to breakout_sessions |
| attendee_id | INT FOREIGN KEY | Reference to attendees |
| status | ENUM('registered','cancelled') | RSVP status |
| created_at | TIMESTAMP | Creation timestamp |

#### `staff`
| Column | Type | Description |
|--------|------|-------------|
| id | INT PRIMARY KEY AUTO_INCREMENT | Staff ID |
| event_id | INT FOREIGN KEY | Reference to events |
| email | VARCHAR(255) | Staff email |
| password_hash | VARCHAR(255) | Hashed password |
| first_name | VARCHAR(100) | First name |
| last_name | VARCHAR(100) | Last name |
| staff_code | VARCHAR(10) UNIQUE | Staff access code |
| invite_token | VARCHAR(64) | Invite token |
| invite_used | BOOLEAN DEFAULT FALSE | Invite used flag |
| preferred_language | VARCHAR(5) DEFAULT 'en' | Preferred language code |
| created_at | TIMESTAMP | Creation timestamp |

#### `languages`
| Column | Type | Description |
|--------|------|-------------|
| code | VARCHAR(5) PRIMARY KEY | Language code |
| name | VARCHAR(50) | English language name |
| native_name | VARCHAR(50) | Native language name |
| is_active | BOOLEAN | Active status |
| is_default | BOOLEAN | Default language flag |
| date_format | VARCHAR(30) | Date format string |
| sort_order | INT | Display sort order |

#### `attendee_types`
| Column | Type | Description |
|--------|------|-------------|
| id | INT PRIMARY KEY AUTO_INCREMENT | Type ID |
| event_id | INT FOREIGN KEY | Reference to events |
| code | VARCHAR(10) | Type code (unique per event) |
| name | VARCHAR(100) | Type name |
| price | DECIMAL(10,2) | Ticket price |
| created_at | TIMESTAMP | Creation timestamp |

## Functionality Specification

### Organizer Features
1. **Authentication**: Login/logout for organizers
2. **Event Management**: Create, edit, delete events
3. **Attendee Management**: View, edit attendees; manage attendee types
4. **Badge Printing**: Generate printable badge list (PDF-ready HTML)
5. **QR Code Scanning**: Mobile camera-based check-in by scanning attendee QR codes
6. **Breakout Sessions**: Create/manage breakout sessions within events
7. **Staff Management**: Add staff members to events via invite codes
8. **Event Staff View**: See which staff are assigned to events

### Staff Features
1. **Authentication**: Login via staff invite code
2. **QR Scanning**: Scan attendee QR codes for check-in
3. **Event Dashboard**: View assigned events and scan functionality

### Attendee Features
1. **Authentication**: Register/login for attendees
2. **Event Registration**: RSVP for events with optional payment
3. **Profile Management**: Update profile with name, org, role, intro, photo (with crop/zoom)
4. **Connections**: Send/accept/reject connection requests
5. **Appointments**: Request/accept/reject meeting appointments
6. **Breakout Sessions**: RSVP for breakout sessions
7. **Password Reset**: Request password reset via email

### User Interactions & Flows

#### Organizer Flow
1. Login → Dashboard → Create Event → Manage Attendees → Print Badges / Scan Check-in
2. Create breakout sessions, manage attendee types, invite staff

#### Staff Flow
1. Use invite code → Login → View assigned events → Scan attendees for check-in

#### Attendee Flow
1. Register → Login → RSVP to Event → Manage Profile → Connect with Attendees → Request Appointments
2. Browse and register for breakout sessions

## Key Pages

### Auth
- `/auth/login` - Organizer/attendee login
- `/auth/forgot-password` - Request password reset
- `/auth/reset-password/<token>` - Reset password with token

### Organizer
- `/organizer/dashboard` - Event overview and management
- `/organizer/events/create` - Create new event
- `/organizer/events/<id>` - Event details and management
- `/organizer/events/<id>/edit` - Edit event
- `/organizer/events/<id>/attendees` - View attendee list
- `/organizer/events/<id>/badges` - Print badges
- `/organizer/events/<id>/scan` - QR scanner for check-in
- `/organizer/events/<id>/edit-attendee/<attendee_id>` - Edit attendee
- `/organizer/events/<id>/attendee-types` - Manage attendee types
- `/organizer/events/<id>/breakout-sessions` - Manage breakout sessions
- `/organizer/events/<id>/breakout-sessions/create` - Create breakout session
- `/organizer/events/<id>/breakout-sessions/<session_id>` - Edit breakout session
- `/organizer/events/<id>/staff` - Event staff management

### Attendee
- `/attendee/dashboard` - Event dashboard
- `/attendee/profile` - Profile management with photo crop/zoom
- `/attendee/connections` - View accepted connections
- `/attendee/connection-requests` - Manage incoming connection requests
- `/attendee/appointments` - View appointments
- `/register` - Event registration
- `/attendee/personal` - Personal information page

## Security
- Password hashing with bcrypt
- Session-based authentication
- CSRF protection
- SQL injection prevention via parameterized queries

## File Structure
```
/home/paul/conference/
├── app.py                 # Flask application
├── config.py              # Configuration
├── init_db.py             # Database initialization script
├── requirements.txt       # Python dependencies
├── static/
│   ├── css/
│   │   └── style.css
│   ├── js/
│   │   └── main.js
│   └── uploads/           # User uploaded files
└── templates/
    ├── base.html
    ├── index.html
    ├── register.html
    ├── attendees.html
    ├── auth/
    │   ├── login.html
    │   ├── forgot_password.html
    │   └── reset_password.html
    ├── organizer/
    │   ├── dashboard.html
    │   ├── create_event.html
    │   ├── edit_event.html
    │   ├── edit_event_confirm.html
    │   ├── event_detail.html
    │   ├── event_staff.html
    │   ├── badges.html
    │   ├── scan.html
    │   ├── edit_attendee.html
    │   ├── attendee_types.html
    │   ├── all_attendee_types.html
    │   ├── edit_attendee_type.html
    │   ├── breakout_sessions.html
    │   ├── breakout_session_detail.html
    │   ├── create_breakout_session.html
    │   ├── edit_breakout_session.html
    │   ├── edit_breakout_session_confirm.html
    │   └── edit_staff.html
    ├── attendee/
    │   ├── dashboard.html
    │   ├── profile.html
    │   ├── connections.html
    │   ├── connection_requests.html
    │   ├── event.html
    │   ├── event_register.html
    │   ├── payment.html
    │   ├── personal.html
    │   └── request_link.html
    ├── staff/
    │   ├── dashboard.html
    │   ├── staff_events.html
    │   └── scan.html
    └── presenter/
        └── dashboard.html
```