ISC — Instituto Serzedello Corrêa | Tribunal de Contas da União | Projeto NuPlan • Em desenvolvimento
Trajetórias 2.0
Trajetórias 2.0
Em construção · MVP Sprint 1

Sistema moderno de gestão de trajetórias profissionais para servidores do TCU. Construído com spec-kit, orientado por User Stories e desenvolvido com apoio de IA.

143
Telas mapeadas (APEX)
33
Inconsistências resolvidas
10
Jornadas de usuário
52
Tabelas migradas

O contexto

De onde viemos e para onde vamos

O sistema original funciona, mas carrega 8 anos de decisões técnicas que dificultam a evolução.

⚠️

Oracle APEX 18 — legado

143 telas, 33 inconsistências documentadas, bug crítico que homologa servidores ao abrir uma página. PL/SQL com ~9.000 linhas distribuídas em 3 pacotes.

🗺

Engenharia reversa completa

6 fases de análise: mapa de páginas, manifestos por tela, regras PL/SQL, mapa de fluxos, análise tecnológica. Base sólida para a reconstrução.

Trajetórias 2.0

Stack moderna, interface responsiva com dark mode, celebrações visuais ao alcançar níveis, fluxos simplificados e dados reais de produção via migração do Oracle.

🤖

Desenvolvido com IA + spec-kit

Cada requisito é um GitHub Issue no formato User Story. O agente IA implementa, testa e abre PR. O time revisa e aprova. Rastreável do início ao fim.


Metodologia

Construído com spec-kit

O framework de especificação de produto do GitHub — para pensar antes de codificar.

github/spec-kit — ver no GitHub ↗
spec-kit

Template de especificação criado pelo time de produto do GitHub. Define uma estrutura padrão para documentar funcionalidades antes de implementá-las:

Problema → Objetivos → Não-objetivos → User Stories → Requisitos → Perguntas abertas

O resultado é um documento que pode ser revisado como um PR, discutido em issues e referenciado para sempre no histórico do repositório.

Por que usamos neste projeto

O APEX 18 original tem 143 telas mas zero documentação de requisitos. Cada funcionalidade precisou ser descoberta por engenharia reversa. No Trajetórias 2.0 fazemos o oposto: toda funcionalidade começa escrita e aprovada antes de qualquer código.

1
Escreva o specPRD no formato spec-kit · revisado em PR pelo time
2
Abra o Issue como User Story"Como [ator], quero [ação], para que [benefício]"
3
IA implementa e testaImplementa → roda testes unitários (Vitest) + E2E (Playwright) → só abre PR se passar
4
Time revisa e aprovaCode review no PR · merge só com CI verde · issue fechado automaticamente
Nada vai a produção sem testeCada funcionalidade tem critérios de aceite verificáveis antes do deploy

Stack moderna, infraestrutura própria

Tudo rodando no VPS Oracle do Gustavo — sem custos de nuvem proprietária, sem lock-in.

⚛️
React 18 + Vite
Interface do usuário
🎨
Tailwind CSS
Design System / Dark mode
Node.js 22 + Fastify
API REST
🔷
TypeScript
Tipagem ponta a ponta
🗄️
PostgreSQL 18
Banco de dados
🔺
Prisma ORM
Migrations + type-safe queries
☁️
Cloudflare Pages
Frontend global
🚢
Coolify + Docker
Deploy da API no VPS
🧪
Vitest
Testes unitários (obrigatório)
🎭
Playwright
Testes E2E (antes de todo deploy)

O que o sistema faz

10 jornadas de usuário redesenhadas

Cada jornada foi reconstruída a partir da engenharia reversa, corrigindo os problemas do sistema atual.

👤 Servidor

Aderir a uma trajetória

Com recomendações baseadas no espaço de atuação e cargo atual. Adesão em 1 clique.

👤 Servidor

Autoavaliar competências

Grau de entrega 1–5 por comportamento, salvamento automático, barra de progresso visual.

👤 Servidor

Avaliação 360° de liderança

Três perspectivas separadas e claras: auto, líder superior, liderado.

👔 Gestor

Homologar competências da equipe

Fila de homologações ordenada por urgência. Aprovação em lote. Histórico completo.

👔 Gestor

Delegar homologação

Delegação com data de expiração e notificação automática ao delegado.

👤 Servidor

Submeter evidências para avançar de nível

Fluxo unificado em 3 etapas: verificar requisitos → registrar evidências → solicitar avaliação.

🔧 ISC/Admin

Analisar pedido de nível

Ação explícita e auditável. Sem o bug crítico de homologação ao abrir página (E028).

👤 Servidor

Consultar minha posição

Dashboard de desenvolvimento: progresso por trajetória, nível atual, próximos passos.

📚 Curador

Curadoria de objetos de aprendizagem

Integração com ISCNet2 documentada. Objetos visíveis diretamente no Trajetórias.

🔧 ISC/Admin

Administrar trajetórias e competências

Painel de configuração em árvore: Trajetória → Níveis → Competências → Comportamentos.


Roadmap

Entregas por Sprint

Cada sprint é um conjunto de GitHub Issues implementados, revisados e entregues.

Concluído
Engenharia reversa APEX 18
143 páginas mapeadas, 33 erros documentados, 10 fluxos com Mermaid, análise tecnológica, MER com 52 tabelas.
PythonMermaidPL/SQL
Sprint 1 — Agora
Fundação: PRD + Infra + Login demo + Dashboard
Spec-kit, GitHub Issues, setup do VPS, login com seleção de papel, dashboard de posição do servidor (RF-F1, RF-F10).
spec-kitReactFastifyPrismaDemo seed
Sprint 2
Core: Autoavaliação + Homologação + Delegação
RF-F2, RF-F6, RF-F7. Inclui efeitos de celebração ao concluir avaliações e dark/light mode.
Framer Motioncanvas-confettiDark mode
Sprint 3
Avanço de nível: Evidências + Análise ISC
RF-F8, RF-F9. Fluxo unificado de 3 etapas, celebração ao alcançar nível, notificações.
NotificaçõesUpload
Pós-MVP
Liderança 360° + Curadoria + Administração
RF-F3/F4/F5, RF-F11, RF-F12. Integração ISCNet2, painel de configuração avançado.
ISCNet2Admin

Pronto para contribuir?

Abra um issue, revise um PR ou siga o desenvolvimento em tempo real.

Criar User Story → Ver repositório