System Architecture & Jury Presentation Specification

Official PromptWars Qualification Edition — V2 Auto GitHub Publishing & One-Click Cloud Deployment

“Don't just generate a project. Build the right one — then ship it.”

1. Product Positioning & Core Thesis

Decision Differentiator

“We don't give students more project ideas — we help them make better project decisions based on skills, timeline, and capacity.”

Execution Differentiator (V2)

“From project idea to live URL without making the student become a DevOps engineer.”

2. 3-Tier System Architecture Topology

DECOUPLED 3-TIER MICRO-SERVICE TOPOLOGY DIAGRAM

[ Client Browser / Student UI ]  --->  [ Next.js 14 App Router (Vercel Edge) ]
                                         | (Zod Payload Validation & XSS Sanitization)
                                         v
                            [ FastAPI ML Microservice (Render Cloud) ]
                                         |
                                         +---> [ XGBoost Model Inference Engine ]
                                         |
                                         v
                            [ Supabase PostgreSQL + RLS ] <---> [ Redis Cache Tier ]

3. Deterministic 6-Factor Health Scoring Math Engine

Overall Health = (SkillFit × 0.25) + (Feasibility × 0.20) + (Innovation × 0.20) + (Career × 0.15) + (Demo × 0.10) + (Risk × 0.10)

• Skill Fit: 25% Weight

• Feasibility: 20% Weight

• Innovation: 20% Weight

• Career Value: 15% Weight

• Demo Potential: 10% Weight

• Risk Adjustment: 10% Weight

4. Scope Explosion Detection & AI Rescue Transformation

Diagnosed Scope Explosion (43/100)

AI + Ethereum Blockchain + Custom IoT Microcontroller Hardware + Dual Swift/Kotlin Native Mobile Apps.

Recalibrated Rescued MVP (86/100)

Strips hardware soldering, smart contracts, and dual mobile apps $\rightarrow$ Retains Python ML Risk Model + Next.js Web Dashboard.

5. 8-Tab Technical Architecture Specification

1. Overview Spec

2. System Topology

3. Priority Matrix

4. Recommended Stack

5. Relational DB Design

6. REST API Endpoints

7. Security & RLS

8. Deployment & Demo

6. Security & Row Level Security (RLS) Model

• 10 PostgreSQL tables enforce ENABLE ROW LEVEL SECURITY (auth.uid() = user_id).

• Zero client-side secret leakage (all API keys execute server-side).

• Zod schema validation enforced on 100% of payloads.

7. 2-Minute Hackathon Jury Presentation Script Flow

0:00 - 0:30Hook: State the student project selection & scope bloat problem.

0:30 - 1:00Scope Rescue: Trigger live AI Scope Rescue (43 → 86 score jump).

1:00 - 1:30Blueprint & Mentor: Show 8-tab Technical Blueprint & AI Mentor.

1:30 - 2:00Auto-Ship: Auto GitHub Repo Creation & One-Click Cloud Deployment.