🧙‍♂️⚔️ UniQuest

Uma plataforma gamificada que transforma a procura de emprego e o desenvolvimento de competências numa aventura RPG épica.

🏆 2º Lugar — Edumi Hackathon 🏆

O UniQuest conquistou o segundo lugar no Edumi Hackathon, sendo reconhecido pela sua abordagem inovadora em gamificação educacional e análise inteligente de competências profissionais.

O UniQuest é uma aplicação web desenvolvida em Svelte e Vite, projetada para extrair, categorizar e pontuar requisitos técnicos e comportamentais a partir de descrições de vagas. O projeto evoluiu para uma interface visual imersiva onde os utilizadores criam uma "Ficha de Personagem", enfrentam "Bosses" (Vagas de Emprego) e completam "Missões" (Cursos) para evoluir na sua carreira.

🗡️ Funcionalidades Principais

O sistema está agora dividido em três ecrãs principais de interação (SPA) e um motor de processamento em segundo plano:

🛠️ Stack Tecnológico Atualizado

• Frontend: Svelte (v5)
• Routing: svelte-routing (Navegação SPA sem recarregar a página)
• Build & Bundler: Vite
• Bibliotecas Visuais: * html2canvas (Para exportação da Ficha de Jogador)
  • canvas-confetti (Para feedback visual de vitória)
• Deployment: Preparado para a Vercel com reescrita de rotas configurada (vercel.json).

🧝 Arquitetura do Sistema

graph TD
    User["Utilizador"] --> SPA[Svelte SPA]
    
    subgraph Frontend App
        Router["Svelte Routing"] --> Profile["/ (PlayerCard)"]
        Router --> Battle["/fight (FightScreen)"]
        Router --> Quests["/quest (QuestScreen)"]
    end
    
    SPA --> Router
    
    subgraph Logic & Storage
        Battle --> Engine["Supreme Skill Engine (LexerParser)"]
        Engine --> |Extrai Competências| Quests
        Profile -.-> |Guarda Estado| Storage[(localStorage)]
        Battle -.-> |Guarda Progresso| Storage
        Quests -.-> |Lê Missões| Storage
    end
    
    Quests --> ExtLinks["Links Udemy/YouTube"]

🧚 Como Executar Localmente

Requisitos

• Node.js v18+
• npm (ou Yarn/PNPM)

Instalação

# Clone e entre na pasta da aplicação web
git clone [https://github.com/EduLoboM/UniQuest.git](https://github.com/EduLoboM/UniQuest.git)
cd UniQuest/webapp

# Instalar as dependências do projeto
npm install

# Executar o servidor de desenvolvimento com hot-reload (HMR)
npm run dev

# Aceda à aplicação através do link indicado na consola (geralmente http://localhost:5173)

🏰 Estrutura do Projeto

A estrutura foi reorganizada para suportar componentes de interface:

UniQuest/
└── webapp/
    ├── package.json              # Dependências e scripts do frontend
    ├── vercel.json               # Configuração de rotas para deploy na Vercel
    ├── vite.config.js            # Configuração do Vite
    ├── LexerParser.js            # Motor de Parsing & NLP
    ├── skill_registry.json       # Base de dados estruturada das habilidades
    ├── skill_courses.json        # Mapeamento do currículo de cursos pré-definidos
    └── src/
        ├── App.svelte            # Ponto de entrada e configuração do Router
        ├── stores.js             # Gestão de estado global e localStorage
        └── components/
            ├── PlayerCard.svelte # Componente do Perfil do Jogador
            ├── FightScreen.svelte# Componente de Análise de Vagas/Batalha
            └── QuestScreen.svelte# Componente de Missões e Cursos

🚀 Deployment (CI/CD)

O projeto está configurado para deploy instantâneo na Vercel. O ficheiro vercel.json incluído na raiz da pasta webapp garante que a navegação SPA funcione corretamente em produção, redirecionando todos os pedidos de rotas (como /fight ou /quest) para o ficheiro index.html.

Desenvolvido com ⚔️ por Alan Semil, Arthur Martins, Eduardo Lobo e Fabiana Reis.