Plataforma de Gestão de Formação

Contexto Castelform

A Castelform gere ações de formação financiadas por programas públicos, com obrigações legais junto da DRAPN e da CCDRN. O dia-a-dia envolve formandos, formadores, empregadores, locais de formação, prazos de homologação, geração de formulários e controlo de cronogramas. Este projeto documenta a direção de um sistema próprio que substitui gradualmente ferramentas legadas e reduz trabalho manual repetitivo na equipa.

Problema e oportunidade

As soluções existentes no mercado — nomeadamente plataformas desktop de gestão de formação — tendem a ser complexas, visualmente desatualizadas e dependentes de conhecimento concentrado numa única pessoa. Há espaço para uma plataforma que priorize clareza de informação, fluxos intuitivos e infraestrutura sustentável. O Prisma parte dessa análise, mas não se limita a um rebranding: o objetivo é modelar o domínio de forma explícita e construir módulos que escalem sem duplicar lógica.

Relação com Automation Bot

No mesmo ecossistema Castelform existe o projeto Automation Bot — automação browser-based da plataforma estatal SIGO com Python e Playwright. Os dois projetos são complementares, não concorrentes: o Automation Bot trata operações repetitivas na interface web do SIGO (extração de dados, emissão de certificados, atualização de registos), enquanto o Prisma concentra a gestão interna, homologação, cronogramas e documentação da entidade formadora. Partilham domínio de formação profissional, convenções de dados e contexto operacional Castelform.

Domínio modelado

As entidades centrais reflectem a realidade das entidades formadoras portuguesas:

• Formandos
• Formadores
• Pessoal Não Docente
• Empregadores
• Fornecedores
• Entidades Parceiras
• Centros Qualifica

Hierarquia operacional

A estrutura de negócio segue quatro níveis, do programa de financiamento à unidade pedagógica:

• Projeto — programa de financiamento (ex.: Pessoas 2030)
• Curso — tipologia formativa dentro do projeto
• Ação — instância concreta da formação; é o que o formando costuma chamar «curso»
• Módulos — unidades pedagógicas dentro da ação

Esta hierarquia orienta navegação, permissões e geração documental em todo o produto.

Decisões de produto e UX

O desenho privilegia linguagem alinhada com o utilizador final — «ação» em vez de jargão interno, cronograma visual com deteção de conflitos de formadores, e formulários gerados a partir de templates em vez de preenchimento manual repetido. A arquitectura evolui para configuração sobre código: tipos de ação, templates e regras de validação descritos em YAML, com o núcleo do sistema como executor genérico. Novos tipos de documento entram por configuração, não por forks de código.

Estado actual e roadmap

O produto está em evolução activa. Já existe um módulo interno de homologação (Homologação Auto) em Python com interface NiceGUI, usado para criar e gerir ações, controlar fases de homologação, gerar documentos Word/PDF e visualizar cronogramas. A visão de plataforma completa — com modelo de dados unificado, API REST e interface web moderna — está em fase de concepção e refactorização arquitectural. O próximo passo prioritário é consolidar a geração documental config-driven e alargar a adopção pela equipa não-técnica da Castelform.

Stack e arquitectura

Implementação actual: Python, NiceGUI, ficheiros YAML como fonte de verdade das ações, bases JSON locais e serviços de geração de documentos. Direcção futura documentada: Django, PostgreSQL e API REST para a camada de plataforma completa. Padrão de evolução: strangler fig — novos módulos já nascem com arquitectura config-driven; o código legado migra incrementalmente sem parar operações.