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, and schedule appointments
• Target Users: Event organizers 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
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 for deep linking
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
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

Functionality Specification

Organiser Features

1. Authentication: Login/logout for organizers
2. Event Management: Create, edit, delete events
3. Attendee List: View all attendees for their events
4. Badge Printing: Generate printable badge list (PDF-ready HTML)
5. Attendance Stats: See check-in counts and attendee statistics
6. QR Code Scanning: Mobile camera-based check-in by scanning attendee QR codes

Attendee Features

1. Authentication: Register/login for attendees
2. Event RSVP: Register for events
3. Profile Management: Update profile with name, org, role, intro, photo
4. Connections: Send/accept/reject connection requests
5. Appointments: Request/accept/reject meeting appointments

User Interactions & Flows

Organiser Flow

1. Login → Dashboard → Create Event → View Attendees → Print Badges

Attendee Flow

1. Register → Login → RSVP to Event → Manage Profile → Connect with Attendees → Request Appointments

API Endpoints

Auth

• POST /api/auth/organizer/register - Register organizer
• POST /api/auth/organizer/login - Login organizer
• POST /api/auth/attendee/register - Register attendee
• POST /api/auth/attendee/login - Login attendee
• POST /api/auth/logout - Logout

Events

• GET /api/events - List public events
• POST /api/events - Create event (organizer)
• GET /api/events/<id> - Get event details
• PUT /api/events/<id> - Update event
• DELETE /api/events/<id> - Delete event

Attendees

• GET /api/events/<id>/attendees - List attendees for event
• GET /api/attendees/<id> - Get attendee profile
• PUT /api/attendees/<id> - Update attendee profile
• POST /api/attendees/<id>/photo - Upload profile photo

Connections

• GET /api/connections - List my connections
• POST /api/connections - Send connection request
• PUT /api/connections/<id> - Accept/reject connection
• GET /api/attendees - Search attendees

Appointments

• GET /api/appointments - List my appointments
• POST /api/appointments - Request appointment
• PUT /api/appointments/<id> - Accept/reject appointment

Organizer Tools

• GET /api/organizer/events/<id>/badges - Get badge printable view
• GET /api/organizer/events/<id>/stats - Get attendance stats
• GET /api/organizer/events/<id>/scan - QR code scanner page for check-in

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
└── templates/
    ├── base.html
    ├── index.html
    ├── auth/
    │   ├── login.html
    │   └── register.html
    ├── organizer/
    │   ├── dashboard.html
    │   ├── create_event.html
    │   ├── event_detail.html
    │   ├── badges.html
    │   └── scan.html
    └── attendee/
        ├── dashboard.html
        ├── event.html
        ├── profile.html
        ├── connections.html
        └── appointments.html