E Event

ROADMAP — FLA Event & Awards Platform

Living plan. Status: ✅ done · 🚧 in progress · ⬜ planned.
Browse in-app at /docs/roadmap. Spec: docs/SRS.md. Handoff: TODO.md.

Vision

A modular, plain-PHP platform at https://event.production1.jugaar.ai for running events whose centerpiece is public-voted, AI-assessed awards — branded entirely from an admin control panel, auditable end-to-end, and shareable by design (everyone gets cards + links worth posting).

Milestones

v0.1.0 — Docs & Scaffold ✅

  • Plain-PHP modular scaffold (Core + 14 Modules), views, config, composer (autoload only).
  • Living docs: SRS, 7 workflows, TODO, ROADMAP, CHANGELOG, WORKFLOW, HELP, AGENTS.
  • Docs viewer: every .md rendered as organized webpages at /docs.
  • Core services: AI gateway (MiniMax m3 driver + mock), LinkedIn (+mock), WhatsApp (null), GD cards.
  • DB migrations 001–009 + seed (settings, toggles).
  • Git baseline + tag.

v0.2.0 — Admin Core & Branding ⬜

  • Admin auth + first admin (seeded, forced password change).
  • Branding control panel (name, logo upload, colors, tagline, campaign texts).
  • Feature toggles UI; audit writer wired in.
  • Admin home starter: KPI cards + first chart (registrations over time) using Chart.js.

v0.3.0 — Events & Categories ⬜

  • Event CRUD + status lifecycle; category CRUD, show/hide, ordering.
  • Public event pages (details, categories list).

v0.4.0 — Registration ⬜

  • Visitor, Award, Guest-of-Honor flows (LinkedIn OAuth + basic + WhatsApp).
  • Photo upload; staff manual entry; BR-001/002/007 enforced.
  • "I am visiting / I have applied" cards wired to success pages.

v0.5.0 — AI Interview ⬜

  • Admin question bank per category; randomized session; progressing UI.
  • MiniMax m3 marking (score + feedback); session stats; fallback to mock.

v0.6.0 — Public Voting & Cards ⬜

  • Share links, candidate pages (OG tags), LinkedIn voter auth, restriction modes,

optional voter reason, 70/30 engine, veto UI.

  • Public cards polished (better templates/fonts); AI card driver pluggable.

v0.7.0 — Judges Panel ⬜

  • Judge accounts + assignments; review board; decisions + notes; admin report.

v0.8.0 — Dashboards, Tickets, Comms ⬜

  • Admin dashboard full: graphs (votes-over-time, funnel, per-category shares, top candidates, AI score distribution), KPI cards with 7d/30d trends, audit-log tab with filters, drill-down lists.
  • AI insights (FR-0407): weekly event summary, judge-ready applicant briefs, vote-anomaly flags — mock-compatible until MiniMax key.
  • Applicant (own votes chart/voters/AI stats/tickets/cards), staff queue.
  • Ticketing system; mass comms (email + WhatsApp simulated→live); notifications + reminders.

v0.9.0 — Winners & Audit ⬜

  • Finalize (blend, veto, approve & lock), public results, winner badges/cards.
  • Audit log viewer (filter/search).

v1.0.0 — Launch Polish ⬜

  • Full responsive pass; accessibility; rate limiting; backups verified; perf pass;

owner walkthrough + go-live checklist.

Feature / enhancement backlog (post-1.0 ideas)

  • More OAuth providers for voters (X, Google), referral tracking for share links.
  • Certificates for finalists; printable award templates.
  • AI-generated share cards (cards.driver=ai) once image API key provided.
  • Multi-event homepage (event directory), past-events archive.
  • Live leaderboard graphics for the venue screen.
  • SMS channel; bilingual (EN/AR) UI pack.
  • PWA install; push notifications.
  • REST API + webhooks.

Workflow

Per feature: SRS use-case → workflow doc → code → CHANGELOG/ROADMAP/TODO → conventional commit → tag (details in WORKFLOW.md).