mosamapodile/MyPath

AI career navigation tool in the context of South Africa # MyPath — South African AI Career Intelligence Platform > **Version:** 1.0 > **Author:** Mosa Mapodile > **Project Status:** Active Development > **Target Deployment:** Docker / Google Cloud Run [[_TOC_]] --- # 1. Project Overview **MyPath** is an AI-powered career intelligence platform engineered specifically for South African learners. Rather than functioning as a standard, generic chatbot, MyPath integrates structured South African educational data, deterministic business logic, and large language models to deliver accurate, personalized career guidance. WARNING: **Anti-Hallucination Policy:** The system strictly separates data processing from text generation. AI models are strictly prohibited from performing APS score calculations or determining institutional admission thresholds directly. ### Key Questions Answered for Students * **What can I study?** * **Which universities or TVET colleges am I eligible for?** * **What careers align with my interests and academic performance?** * **Which bursaries, NSFAS opportunities, learnerships, and certifications should I apply for?** * **What practical steps should I take next?** **Long-Term Vision:** To establish South Africa's primary Career Intelligence Platform grounded in local educational context and labor market realities. --- # 2. Technology Stack ### Backend * **Language:** Python 3.12 * **Framework:** Flask, Gunicorn * **Middleware:** Flask-CORS * **Integrations:** OpenAI API (`gpt-4o`) * **Configuration:** `python-dotenv` ### Frontend * **Current:** HTML5, CSS3, JavaScript (Vanilla ES6+) * **Planned:** React / Next.js, Tailwind CSS ### Infrastructure & Deployment * **Containerization:** Docker * **Cloud Platform:** Google Cloud Run * **Target Persistence Layer:** PostgreSQL, Redis, Google Cloud Storage --- # 3. Development Philosophy & Architecture Principles MyPath explicitly divides system execution into two primary execution tiers: **Deterministic Python Computation** and **Generative AI R …