yoserladhibi/CompassIQ

AI-powered entrepreneurial orientation platform that diagnoses startup maturity and provides personalized guidance for the Tunisian entrepreneurship ecosystem. CompassIQ Intelligent Entrepreneurial Orientation Engine for Tunisia > Empowering Tunisian entrepreneurs through AI-driven startup diagnosis, explainable scoring, and personalized guidance. --- ## Table of Contents - Overview - Problem Statement - Solution - Key Features - Startup Maturity Model - Explainable Scoring Methodology - System Diagrams - Documentation & Deliverables - Tech Stack - Repository Structure - Getting Started --- ## Overview CompassIQ is an AI-powered entrepreneurial orientation platform built for the **AINS Hackathon 2026**. It helps Tunisian entrepreneurs understand their startup maturity stage, evaluate business readiness, detect key gaps, and receive personalized recommendations — all through structured reasoning grounded in real entrepreneurial knowledge. Unlike generic AI chatbots, CompassIQ is a **decision-support engine** combining: - Rule-based maturity classification - Weighted explainable scoring across 5 dimensions - Gating rules for realistic (not inflated) evaluation - Groq-powered LLM for personalized recommendations - Bilingual interface (French / Arabic) --- ## Problem Statement Early-stage entrepreneurs in Tunisia face real structural challenges: - Difficulty identifying their true startup maturity stage - No structured feedback on project readiness - Fragmented access to ecosystem resources - Over-reliance on generic AI tools that lack domain grounding - No clear guidance on next actionable steps Existing tools offer either raw information (search engines, documents) or generic answers (chatbots) — **not structured entrepreneurial diagnosis.** --- ## Solution CompassIQ provides a guided, structured entrepreneurial assessment that: 1. Collects startup data through an **adaptive questionnaire** (JSON-driven) 2. Classifies the startup into one of **6 maturity stages** using a rule-based engine 3. Evaluates across **5 scored dimensions** with full explainability 4. Detects specific **gaps** blocking pr …