O SGC (Sistema de Gestão de Competências) é uma aplicação corporativa para mapeamento, revisão e diagnóstico de competências organizacionais. O sistema permite que unidades mapeiem suas atividades e conhecimentos necessários, identifiquem gaps de competência e gerenciem o desenvolvimento de suas equipes.

O projeto segue uma arquitetura Modular Monolith no backend e Component-Based no frontend.

A documentação técnica foi desacoplada deste README para facilitar a manutenção e evitar duplicação. Consulte os documentos abaixo para detalhes sobre padrões, arquitetura e regras:

• AGENTS.md: Leitura obrigatória para desenvolvedores e agentes de IA. Contém convenções de código, padrões de projeto e regras fundamentais.
• backend/README.md: Arquitetura detalhada do backend, módulos e comunicação.
• frontend/README.md: Arquitetura do frontend, estrutura de pastas e componentes.
• regras/: Diretório contendo guias específicos de padrões (backend, frontend, E2E).

sgc/
├── backend/            # Código-fonte da API REST (Spring Boot)
├── frontend/           # Código-fonte da aplicação Web (Vue.js)
├── e2e/                # Testes End-to-End (Playwright)
├── reqs/               # Documentação de requisitos (Casos de Uso)
├── regras/             # Guias de padrões e convenções
├── scripts/            # Scripts utilitários (captura de telas, quality checks)
└── build.gradle.kts    # Configuração de build raiz

• JDK 21
• Node.js 22+

1. Backend:

   ./gradlew bootRun

   A API estará disponível em http://localhost:10000.

2. Frontend:

   cd frontend
   npm install
   npm run dev

   Acesse em http://localhost:5173.

O projeto possui uma suite abrangente de testes e verificações de qualidade.

Para rodar todas as verificações (Checkstyle, PMD, SpotBugs, Testes, Lint, Typecheck) de uma só vez:

./quality-check.sh

Os relatórios são gerados em:

• Backend: backend/build/reports/
• Frontend: frontend/coverage/

Para aprender como criar novos testes unitários e de integração seguindo as melhores práticas do projeto, consulte:

• guia-testes-junit.md: Guia completo com recomendações, exemplos e checklist

Os requisitos do sistema estão documentados em casos de uso (CDUs) no diretório reqs/.

• Processo de Mapeamento: Criação e definição de mapas de competências.
• Revisão: Fluxo de aprovação e ajuste de mapas.
• Diagnóstico: Avaliação de proficiência e identificação de gaps.

Todo o código, comentários e documentação devem ser escritos em Português Brasileiro.

Para detalhes completos sobre nomenclaturas (Classes, Variáveis, Banco de Dados) e padrões de projeto (Facade, DTO, Store, Service), consulte o arquivo AGENTS.md.