Ferramentas Digitais Internas
SID · CRONOS · SIGO
As três plataformas desenvolvidas internamente para apoiar a gestão de projetos, controlo de equipas e gestão documental nas obras da Aceitar Sucessos.
📋 Visão geral — stack tecnológico comum
▾As três ferramentas partilham a mesma base tecnológica, o que facilita a manutenção e a evolução futura:
| Componente | Tecnologia | Detalhe |
|---|---|---|
| Frontend | HTML + CSS + JS | Ficheiro único, sem frameworks — corre diretamente no browser |
| Base de dados | Supabase (PostgreSQL) | Alojamento cloud, acesso via API REST e SDK JS |
| Autenticação | Supabase Auth | Login com email/password, sessão persistente |
| Alojamento | Vercel | Deploy automático via GitHub push |
| Domínio | AMEN DNS + CNAME | *.aceitar.pt aponta para Vercel |
| Repositórios | GitHub (CarSanFer) | sid-aceitar · cronos.aceitar · sigo-aceitar |
O que é o SID
O SID (Sistema de Informação e Dados) é a plataforma de registo e acompanhamento de obras da Aceitar Sucessos.
Propósito e âmbito
▾O SID centraliza toda a informação operacional das obras: dados da obra, intervenientes, equipa afeta e estado de execução. É a referência principal para quem precisa de consultar rapidamente qual a equipa responsável por cada obra.
| O SID faz | O SID não faz |
|---|---|
| Registo e consulta de obras | Gestão documental detalhada (→ SIGO) |
| Afetação de colaboradores a obras | Dashboard com gráficos (→ CRONOS) |
| Registo de intervenientes (donos, empreiteiros) | Controlo financeiro |
| Controlo de estado das obras | Arquivo em NAS (→ SIGO) |
Estrutura de dados
▾| Tabela Supabase | Conteúdo | Campos principais |
|---|---|---|
| obras | Registo central de cada obra | codigo, nome, tipo, estado, dono_obra_id, data_inicio, data_fim |
| intervenientes | Entidades externas (donos, empreiteiros) | nome, nif, tipo, contacto, email |
| intervenientes_do | Donos de Obra específicos | nome, referência para obras |
| obras_afetacoes | Afetações de equipa por obra | obra_id, user_id, funcao, data_inicio (jsonb por utilizador) |
Obras e Estados
Criar e gerir obras
▾Aceder ao separador Obras
No menu lateral, clica em "Obras" para ver a listagem completa.
Nova Obra
Clica no botão "+ Nova Obra", preenche o formulário: código (ex: OBR-042), nome, tipo e dono de obra.
Código único
O campo codigo é a chave de identificação — é usado para importação e matching com outras ferramentas.
Atualizar estado
Clica na obra e seleciona o estado atual: Em Curso, Suspensa, Concluída ou Arquivada.
Filtros e ordenação
▾A lista de obras suporta:
- Ordenação por colunas — clica no cabeçalho de qualquer coluna para ordenar
- Filtro por estado — botões rápidos no topo da lista
- Pesquisa por texto — filtra por código ou nome da obra em tempo real
Intervenientes
Registo das entidades externas associadas a cada obra.
Tab Intervenientes (só leitura)
▾O separador Intervenientes no SID é uma vista de consulta — permite ver todas as entidades registadas, mas a edição é feita diretamente na base de dados Supabase ou por um administrador.
| Tipo | Exemplos | Tabela Supabase |
|---|---|---|
| Dono de Obra | Câmaras, empresas privadas, particulares | intervenientes_do |
| Empreiteiro | Empresas de construção | intervenientes |
| Projetista | Gabinetes de arquitetura/engenharia | intervenientes |
| Subempreiteiro | Especialidades: AVAC, elétrico, etc. | intervenientes |
Afetações de Equipa
Associar colaboradores a obras com a sua função e período.
Como funciona a afetação
▾Cada utilizador autenticado pode ver as suas próprias afetações. As afetações são guardadas como jsonb por utilizador na tabela obras_afetacoes.
Abre a obra
Na lista de obras, clica na obra à qual queres afetar equipa.
Separador Afetações
Vai ao tab "Afetações" no detalhe da obra.
Adicionar colaborador
Seleciona o colaborador da lista, define a função (Fiscal, CSO, Coord.) e a data de início.
Guardar
A afetação fica registada e visível na listagem da obra e no perfil do colaborador.
Importação de Dados
Importar obras via ficheiro
▾O SID suporta importação de obras em lote a partir de ficheiro Excel/CSV. O matching é feito pelo campo codigo — se uma obra com o mesmo código já existir, os dados são atualizados; caso contrário, é criada uma nova obra.
| Coluna | Tipo | Obrigatório | Exemplo |
|---|---|---|---|
| codigo | Texto | ✅ | OBR-042 |
| nome | Texto | ✅ | Reabilitação Ed. Municipal |
| tipo | FISC/CSO/CONC/GP | ✅ | FISC |
| estado | Texto | — | Em Curso |
| dono_obra | Texto | — | Câmara Municipal do Porto |
| data_inicio | Data (DD/MM/AAAA) | — | 01/03/2025 |
O que é o CRONOS
O CRONOS é a plataforma de gestão de projetos e obras da Aceitar Sucessos, com dashboard visual, controlo de afetações e importação/exportação XLSX.
Propósito e diferença face ao SID
▾O CRONOS é uma evolução do SID com funcionalidades mais avançadas — inclui dashboard com gráficos, controlo de prazos e integração com Supabase completa com autenticação.
| SID | CRONOS | |
|---|---|---|
| Dashboard com gráficos | ❌ | ✅ Chart.js |
| Afetações de equipa | ✅ | ✅ |
| Import/Export XLSX | Parcial | ✅ SheetJS |
| Autenticação Supabase | ✅ | ✅ |
| Distinção Obra/Projeto | Obras apenas | ✅ Obras + Projetos |
| Módulo de relatórios | ❌ | Em desenvolvimento |
Estrutura de dados (Supabase)
▾| Tabela | Conteúdo |
|---|---|
| obras | Obras e projetos — inclui Tipo (FISC/CSO/CONC), Estado, datas, valor contrato |
| afetacoes | Associação colaborador ↔ obra, com função e período |
| colaboradores | Equipa interna com cargo e disponibilidade |
| profiles | Perfis de utilizador ligados ao Supabase Auth |
Projetos e Tipos
Obras vs. Projetos
▾O CRONOS distingue dois tipos de entidade:
| Entidade | Descrição | Exemplos |
|---|---|---|
| Obra | Contrato de prestação de serviços numa obra física | Fiscalização de empreitada, Coord. Segurança |
| Projeto | Trabalho de conceção, consultoria ou estudo | Projetos de arquitetura, estudos de viabilidade |
Criar e editar uma obra/projeto
▾Menu Obras ou Projetos
Seleciona o separador correspondente no menu lateral.
+ Nova Obra / + Novo Projeto
Preenche: código, nome, tipo, estado, responsável, datas previstas e valor de contrato.
Guardar
O registo é imediatamente guardado no Supabase e fica visível a toda a equipa.
Editar
Clica no ícone de edição na linha da obra para atualizar qualquer campo.
Afetações de Equipa
Gerir afetações
▾As afetações no CRONOS associam colaboradores a obras com função e período definidos. São visíveis no dashboard e permitem calcular a carga de cada elemento da equipa.
Abre o detalhe da obra
Clica numa obra da lista para ver o painel de detalhe.
Separador Afetações
Vai ao tab "Afetações" e clica "+ Adicionar".
Preenche os dados
Seleciona o colaborador, define a função e o período de afetação.
Guardar
A afetação fica registada na tabela afetacoes e atualiza o dashboard.
Dashboard
Visão consolidada do estado da carteira de obras e projetos.
O que mostra o Dashboard
▾Import / Export XLSX
Exportar para Excel
▾Clica no botão Exportar XLSX (ícone de folha de cálculo) para descarregar a listagem atual de obras/projetos com todos os campos visíveis.
- O ficheiro gerado inclui: código, nome, tipo, estado, responsável, datas e valor
- Útil para partilhar com a direção ou para análise externa no Excel
- Usa a biblioteca SheetJS — gerado diretamente no browser, sem servidor
Importar de Excel
▾Para importar um conjunto de obras em lote:
Preparar o ficheiro
O Excel deve ter os cabeçalhos na primeira linha: codigo, nome, tipo, estado, data_inicio, data_fim, valor
Clicar em Importar XLSX
Seleciona o ficheiro no explorador de ficheiros.
Pré-visualização
O CRONOS mostra uma pré-visualização dos dados antes de confirmar.
Confirmar importação
Clica "Importar" — o matching faz-se pelo campo codigo: atualiza se existe, cria se é novo.
O que é o SIGO
O SIGO é a plataforma de gestão documental e de controlo de obra da Aceitar Sucessos — a mais completa das três ferramentas.
Arquitetura e propósito
▾O SIGO vai além do registo de obras — gere os documentos produzidos em cada fase do acompanhamento: autos de vistoria, relatórios, validações, prazos e adjudicações. Os documentos são armazenados no NAS Synology da empresa.
| Componente | Tecnologia | Função |
|---|---|---|
| Frontend | HTML single-file | Interface do utilizador |
| Backend API | Vercel serverless (Node.js) | Lógica de negócio, ligação ao NAS |
| Base de dados | Supabase | Metadados dos documentos e obras |
| Arquivo de ficheiros | NAS Synology (empresa) | PDFs, XLSX, documentos de obra |
| IA | Anthropic API | Leitura e extração de documentos (api/ler-documento.js) |
Módulos e Documentos
Cada obra no SIGO é organizada por módulos, cada um correspondendo a um tipo de documento ou fase.
Módulos disponíveis
▾| Código | Nome | Descrição |
|---|---|---|
| VAL | Validação | Validação de documentos recebidos — conformidade com projeto |
| PZO | Prazos | Controlo de prazos contratuais e notificações de atraso |
| AR | Auto de Revisão | Autos de revisão e vistoria em obra |
| RV | Revisão de Valores | Revisão de preços e ajustes contratuais |
| ADJ | Adjudicação | Gestão de trabalhos a mais/a menos e adjudicações adicionais |
| PTQ | Plano de Trabalhos e Qualidade | Controlo do plano de trabalhos e plano de qualidade |
| PE | Plano de Equipamentos | Leitura de CES_Listas.xlsx — registo de equipamentos |
| PA | Plano de Acabamentos | Leitura de CES_Listas.xlsx — registo de acabamentos |
Adicionar um documento
▾Seleciona a obra
Na lista de obras do SIGO, clica na obra onde queres adicionar documentação.
Escolhe o módulo
Clica no módulo correspondente ao tipo de documento (ex: VAL, PZO, AR…).
Novo documento
Clica "+ Novo" e preenche os metadados: referência, data, descrição, assunto.
Upload do ficheiro
Faz upload do PDF ou XLSX — o ficheiro é enviado para a pasta correspondente no NAS.
Submeter para aprovação
O estado muda para "Em Curso" — aguarda validação por outro elemento.
Workflow de Aprovação
Cada documento no SIGO passa por um ciclo de vida controlado.
Estados do documento
▾| Estado | Significado | Quem pode alterar |
|---|---|---|
| Em Curso | Documento criado, em edição — ainda não submetido | Autor do documento |
| Em Aprovação | Submetido para revisão — aguarda validação | Qualquer utilizador |
| Validado | Aprovado e arquivado — não pode ser editado | Utilizador com perfil de aprovação |
Regras de revisão no NAS
▾Quando um documento já validado é substituído por uma nova versão, o SIGO aplica as seguintes regras de revisão automática:
- O ficheiro anterior é movido para uma pasta /Arquivo dentro da pasta da obra no NAS
- O novo ficheiro assume o nome base com sufixo de revisão:
REF_REV01.pdf,REF_REV02.pdf, etc. - O Supabase regista o histórico de revisões com data e utilizador
Arquivo no NAS
O NAS Synology é o repositório de todos os ficheiros de obra geridos pelo SIGO.
Estrutura de pastas no NAS
▾📁 SIGO/
📁 OBR-042/
📁 VAL/
📄 VAL_001_Plano-Qualidade.pdf ← documento ativo
📁 Arquivo/
📄 VAL_001_Plano-Qualidade_REV00.pdf ← versão anterior
📁 AR/
📄 AR_001_Auto-Vistoria-Jan25.pdf
📄 AR_002_Auto-Vistoria-Fev25.pdf
📁 PZO/
📁 ADJ/
📁 PTQ/
📁 OBR-043/
...
Sincronização SIGO ↔ NAS
▾A sincronização é gerida pela função serverless api/sincronizar-nas.js no Vercel:
- Ao fazer upload de um ficheiro no SIGO, é enviado para o NAS e os metadados são guardados no Supabase
- Ao validar um documento, o estado no Supabase é atualizado e o ficheiro é movido para a pasta final no NAS
- Ao arquivar uma revisão anterior, o ficheiro original é movido para a subpasta /Arquivo
Relatório Mensal
O SIGO gera automaticamente o relatório mensal de acompanhamento de obra.
Módulo Relatório (Relatório)
▾O módulo Relatório agrega automaticamente os dados dos outros módulos (VAL, AR, PZO, ADJ…) para gerar um relatório mensal de acompanhamento. O relatório pode ser exportado para PDF.
- Identificação da obra e período de reporte
- Resumo do estado de execução (% concluído por módulo)
- Documentos submetidos e validados no mês
- Prazos em risco ou em atraso (módulo PZO)
- Trabalhos a mais/menos aprovados (módulo ADJ)
- Observações e próximos passos
Seleciona a obra e o período
No módulo Relatório, escolhe a obra e o mês de reporte.
Gerar relatório
Clica "Gerar Relatório" — o SIGO agrega os dados dos módulos automaticamente.
Rever e completar
Adiciona as observações manuais e ajusta os campos editáveis.
Exportar
Exporta para PDF — o ficheiro é guardado no NAS na pasta da obra.
⚖️ Quando usar cada ferramenta
Guia rápido para decidir qual a ferramenta mais adequada para cada necessidade.
Tabela de decisão rápida
▾| Necessidade | Ferramenta | Módulo/Função |
|---|---|---|
| Consultar rapidamente quem está em que obra | SID | Afetações |
| Ver o estado geral da carteira de obras | CRONOS | Dashboard |
| Registar uma nova obra recém-adjudicada | SID ou CRONOS | Nova Obra |
| Fazer upload de um auto de vistoria | SIGO | Módulo AR |
| Controlar prazos contratuais | SIGO | Módulo PZO |
| Registar um trabalho a mais | SIGO | Módulo ADJ |
| Gerar relatório mensal de obra | SIGO | Relatório |
| Exportar lista de obras para Excel | CRONOS | Exportar XLSX |
| Ver equipamentos e acabamentos previstos | SIGO | Módulos PE / PA |
| Consultar intervenientes de uma obra | SID | Intervenientes |
Fluxo típico de trabalho
▾Na prática, as três ferramentas complementam-se ao longo do ciclo de vida de uma obra:
Adjudicação
Registo no SID ou CRONOS → código de obra, tipo, dono, estado "Em Preparação"
Arranque
CRONOS → afetação da equipa, definição do responsável · SIGO → upload do contrato e plano de qualidade (PTQ)
Acompanhamento mensal
SIGO → autos de vistoria (AR), controlo de prazos (PZO), validações (VAL) · CRONOS → atualização do estado e % de execução
Eventos contratuais
SIGO → trabalhos a mais/menos (ADJ), revisão de preços (RV)
Relatório mensal
SIGO → gerar e exportar relatório mensal · CRONOS → dashboard para reuniões de equipa
Conclusão
SID / CRONOS → atualizar estado para "Concluída" · SIGO → arquivar documentação final