Major update: ESG, KPIs, metas, alertas, auditoria, documentos, importação, relatórios, subcategorias, dashboard orçamentos

2026-02-10 18:52:52 -03:00
parent d8ca580acb
commit 90c7a2cacb
92 changed files with 10265 additions and 1238 deletions
--- a/docs/DELTA-DASHBOARD-ORCAMENTOS.md
+++ b/docs/DELTA-DASHBOARD-ORCAMENTOS.md
@@ -0,0 +1,26 @@
+# Delta Dashboard + Orçamentos — Nexus Facilities
+> Especificação recebida em 2026-02-09
+
+## 1. Tela Principal (Dashboard)
+
+### 1.1 Gráfico Orçamento vs Realizado
+- Incluir filtro: Centro de Custo | Categoria | Todos
+- Opção "Todos" = visão macro
+
+### 1.2 Cards de Demandas (Abertas, Em Cotação, Em Aprovação, Concluídas)
+- Ao clicar no card, abrir lista das demandas naquele status
+- Drill-down funcional
+
+### 1.3 Gráfico por Categoria
+- BUG: não está trazendo as quantidades associadas — corrigir
+
+### 1.4 Campo Busca
+- BUG: não está funcionando — corrigir
+
+## 2. Tela de Orçamentos
+
+### 2.1 Gráficos por Tipo de Investimento
+- Mostrar total planejado, total realizado e economia separados por Capex e Opex
+
+### 2.2 Grid
+- Incluir coluna "Tipo de Investimento" (Capex/Opex, vem da categoria)
--- a/docs/DELTA-ESG.md
+++ b/docs/DELTA-ESG.md
@@ -0,0 +1,60 @@
+# Delta ESG — Nexus Facilities
+> Especificação recebida em 2026-02-09
+
+## 1. Cadastros Auxiliares
+
+### 1.1 Local — ALTERAÇÃO
+- `tipo_operacao_local`: Administrativo | Industrial | Logístico | Comercial
+- `classificacao_impacto_ambiental`: Baixo | Médio | Alto
+- `praticas_sustentaveis`: Lista (Coleta Seletiva, Reuso de Água, Energia Renovável)
+- **Regra:** Demandas em locais Alto Impacto → sinalizar no Dashboard + aprovação adicional (matriz alçada)
+
+### 1.2 Categorias/Subcategorias — ALTERAÇÃO
+- `tipo_manutencao`: Preventiva | Corretiva | Emergencial
+- `impacto_ambiental_esperado`: Baixo | Médio | Alto
+- `potencial_geracao_residuos`: Baixo | Médio | Alto
+- **Regra:** Emergenciais + Alto Impacto → destaque em relatórios/indicadores
+
+### 1.3 Fornecedores — ALTERAÇÃO
+- `possui_politica_ambiental`: Sim | Não
+- `possui_politica_sst`: Sim | Não
+- `declara_uso_epi`: Sim | Não
+- `equipe_treinada`: Sim | Não
+- `classificacao_esg`: Básico | Intermediário | Avançado
+- **Regra:** ESG Básico → sinalizar reavaliação em demandas críticas
+
+### 1.4 Matriz de Aprovação (Alçadas) — ALTERAÇÃO
+- `exige_avaliacao_esg`: Sim | Não
+- **Regra:** Se Sim + (Impacto Alto OU Fornecedor ESG Básico) → justificativa adicional na aprovação
+
+## 2. Gestão de Demanda — ALTERAÇÃO
+- `impacto_ambiental_demanda`: Herdado da Categoria (editável)
+- `justificativa_manutencao_emergencial`: Obrigatório se tipo_manutencao = Emergencial
+
+## 3. Proposta Recebida — ALTERAÇÃO
+- `uso_material_sustentavel`: Sim | Não | Não Informado
+- `gera_residuos`: Baixo | Médio | Alto
+- `descarte_certificado`: Sim | Não | Não Informado
+- **Regra:** Extração automática via OCR quando possível, preenchimento manual na equalização (não obrigatório)
+
+## 4. Painel Comparação/Equalização — ALTERAÇÃO
+- Mostrar Classificação ESG do Fornecedor
+- Indicador visual de Impacto Ambiental da Demanda
+- **Recomendação automática:** menor valor + match escopo + ESG fornecedor (secundário)
+
+## 5. Dashboard — INCLUSÃO
+- % Demandas Preventivas vs Corretivas
+- % Demandas Emergenciais
+- % Fornecedores ESG Intermediário/Avançado
+- Demandas com Impacto Ambiental Alto
+- Evolução mensal manutenção preventiva
+
+## 6. Relatórios/Auditoria — ALTERAÇÃO
+- Demandas por Impacto Ambiental
+- Fornecedores por Classificação ESG
+- Evolução Manutenção Preventiva
+- Exceções de Governança (aprovações com ressalva)
+
+## 7. Regras Gerais de Governança
+- Alto Impacto Ambiental → justificativa obrigatória registrada
+- Dados ESG auditáveis e versionados
--- a/docs/ESPECIFICACAO-FUNCIONAL.md
+++ b/docs/ESPECIFICACAO-FUNCIONAL.md
@@ -0,0 +1,215 @@
+# Especificação Funcional — Sistema de Controle Orçamentário para Facilities (HEFESTO)
+
+## 1. Objetivo do Sistema
+Desenvolver um sistema integrado para gestão de demandas de Facilities, com foco em controle orçamentário, comparação de propostas, governança financeira, compliance e apoio à tomada de decisão.
+
+O sistema deverá:
+- Centralizar demandas de Facilities
+- Controlar orçamento planejado x comprometido x realizado
+- Automatizar comparação e equalização de propostas
+- Suportar aprovações por alçada e fluxo sequencial
+- Garantir rastreabilidade, auditoria e histórico decisório
+
+## 2. Perfis de Usuário
+
+| Perfil | Descrição | Principais Permissões |
+|--------|-----------|----------------------|
+| Solicitante | Área demandante | Abertura e acompanhamento de demandas |
+| Gestor de Facilities | Responsável operacional | Criar escopo, validar propostas, interagir com fornecedores |
+| Aprovador Financeiro | Controle orçamentário | Aprovar/reprovar propostas conforme alçada |
+| Diretoria | Aprovação estratégica | Aprovação de alto valor / exceções |
+| Fornecedor | Prestador de serviço | Envio e revisão de propostas |
+| Administrador | Governança do sistema | Cadastros, parâmetros e regras |
+
+### 2.1 Dashboard Inicial (Home)
+O Dashboard é a tela inicial do sistema, oferecendo uma visão executiva e operacional em tempo real, adaptada conforme o perfil do usuário.
+
+#### 2.1.1 Indicadores Principais (Cards)
+- Demandas Abertas
+- Demandas em Cotação
+- Propostas Pendentes de Avaliação
+- Demandas em Aprovação
+- Ordens de Serviço Ativas
+- Demandas com Alerta de Orçamento
+
+Cada card deve permitir drill-down para a lista filtrada correspondente.
+
+#### 2.1.2 Visões Gráficas
+- Demandas por Status (Aberta, Em Cotação, Em Aprovação, Aprovada, Cancelada)
+- Demandas por Categoria de Serviço
+- Consumo Orçamento (Planejado x Comprometido x Realizado)
+- Propostas por Fornecedor
+
+Os gráficos devem permitir:
+- Filtro por período
+- Filtro por Centro de Custo
+- Filtro por Local
+
+#### 2.1.3 Alertas e Pendências
+- Propostas aguardando leitura/validação
+- Demandas paradas acima do SLA
+- Propostas acima do orçamento (>20%)
+- Aprovações pendentes do usuário logado
+
+Alertas devem ser destacados visualmente (cores/ícones).
+
+#### 2.1.4 Listas Operacionais (Quick Access)
+- Minhas Demandas
+- Demandas Críticas
+- Propostas Pendentes
+- Aprovações Pendentes
+
+Cada item deve permitir navegação direta para a demanda/proposta.
+
+#### 2.1.5 Personalização por Perfil
+- Gestor de Facilities: foco operacional e fornecedores
+- Financeiro/Diretoria: foco em orçamento, valores e riscos
+- Solicitante: acompanhamento de status
+
+O sistema deve ocultar indicadores não relevantes ao perfil.
+
+## 3. Cadastros Base (Tabelas de Apoio)
+
+### 3.1 Locais / Unidades
+- ID_Local
+- Nome
+- Endereço
+- Centro de Custo
+- Responsável pelo Centro de Custo
+
+**Regra:** Toda demanda deve estar vinculada a um Local e Centro de Custo.
+
+### 3.2 Categorias e Subcategorias de Serviço
+- ID_Categoria
+- Nome
+- Subcategoria
+- Criticidade Padrão
+- SLA Padrão
+
+### 3.3 Fornecedores
+- Tipo Pessoa (Física / Jurídica)
+- CPF / CNPJ
+- Categorias Atendidas
+- Rating Facilities (1 a 5)
+- Certidões Obrigatórias
+- Status das Certidões
+
+**Regra:** Fornecedor com certidão vencida não pode receber OS.
+
+### 3.4 Orçamento Planejado
+- Ano / Mês
+- Centro de Custo
+- Categoria
+- Valor Planejado
+- Valor Comprometido (calculado)
+- Valor Realizado (calculado)
+
+### 3.5 Matriz de Aprovação (Alçadas)
+- Centro de Custo
+- Valor Mínimo
+- Valor Máximo
+- Perfil Aprovador
+- Ordem Sequencial (se aplicável)
+
+## 4. Gestão de Demandas
+
+### 4.1 Abertura da Demanda
+Campos principais:
+- Título da Demanda
+- Descrição
+- Local
+- Centro de Custo
+- Categoria / Subcategoria
+- Criticidade
+- Data Desejada
+- Upload de documentos (plantas, fotos, laudos)
+
+### 4.2 Definição de Escopo
+- Criação de Itens de Linha obrigatórios
+  - Ex: Mão de Obra, Material, Equipamento
+- Quantidade esperada (opcional)
+- Observações técnicas
+
+**Validações:**
+- Não permitir publicação sem itens de linha
+- Não permitir publicação sem CC e Local
+
+## 5. Recebimento e Leitura de Propostas
+
+### 5.1 Upload de Propostas
+- Upload de PDF pelo fornecedor
+- Versionamento automático (V1, V2, V3…)
+
+### 5.2 OCR e Extração Inteligente
+Campos extraídos:
+- Valor Bruto
+- Valor Líquido
+- Impostos (ISS, INSS, PCC)
+- Condição de Pagamento
+- Prazo de Execução
+- Data Estimada de Entrega
+
+O sistema deve:
+- Mapear itens da proposta com os itens de linha do escopo
+- Calcular Match de Escopo (%)
+- Indicar nível de confiabilidade da extração
+
+## 6. Comparação e Equalização de Propostas
+
+### 6.1 Painel Comparativo
+- Visualização em grid das propostas
+- Comparação por item, valor total, impostos e prazo
+- Destaque da proposta benchmark (menor valor)
+
+### 6.2 Deep Dive
+- Clique em qualquer campo abre o trecho original do PDF
+- Destaque visual da origem do dado
+
+### 6.3 Anotações
+- Comentários privados (internos)
+- Comentários públicos (questionamentos ao fornecedor)
+- Registro com data, hora e usuário
+
+## 7. Controle Orçamentário
+- Verificação automática de orçamento disponível
+- Alertas de estouro (>20%)
+- Bloqueio ou solicitação de revisão de escopo
+
+## 8. Workflow de Aprovação
+
+### 8.1 Regras Gerais
+- Aprovação baseada no valor final da proposta selecionada
+- Consulta automática à matriz de alçada
+
+### 8.2 Modelo Híbrido
+- Até o limite da alçada → aprovação automática
+- Acima do limite → fluxo sequencial: Facilities → Financeiro → Diretoria
+
+### 8.3 Exceções
+- Demandas críticas/emergenciais
+- Aprovação com ressalva (justificativa obrigatória)
+
+## 9. Ordem de Serviço (OS)
+- Geração automática após aprovação
+- Bloqueio se fornecedor estiver irregular
+- Registro de valores comprometidos no orçamento
+
+## 10. Encerramento e Avaliação
+- Confirmação da execução
+- Avaliação do fornecedor
+- Atualização do rating
+- Consolidação do valor realizado
+
+## 11. Relatórios, Auditoria e Analytics
+- Consumo orçamentário por CC e Categoria
+- Saving gerado
+- Histórico completo de decisões
+- Lead time por status
+- Gargalos de aprovação
+- Exportação para PDF e Excel
+
+## 12. Requisitos Não Funcionais (Resumo)
+- Controle de acesso por perfil
+- Logs de auditoria
+- Interface responsiva
+- LGPD (tratamento de documentos e dados)
--- a/docs/MANUAL-NEGOCIOS-v2.pdf
+++ b/docs/MANUAL-NEGOCIOS-v2.pdf
--- a/docs/MANUAL-NEGOCIOS.html
+++ b/docs/MANUAL-NEGOCIOS.html
--- a/docs/MANUAL-NEGOCIOS.md
+++ b/docs/MANUAL-NEGOCIOS.md
@@ -2,7 +2,7 @@

 **Sistema de Controle Orçamentário para Facilities**

-Versão 1.0 | Fevereiro 2025
+Versão 2.0 | Fevereiro 2025

 ---

@@ -190,6 +190,53 @@ Solicitante     Gestor Fac.     Fornecedor      Financ./Diret.
 - Tempo médio de ciclo por etapa
 - Exportação em PDF e Excel

+### 5.9 ESG / Sustentabilidade 🌱
+Funcionalidades inspiradas no **SAP Sustainability Control Tower**, entregues a uma fração do custo.
+
+- **Métricas ambientais:** Registro e acompanhamento de consumo de energia (kWh), água (m³), resíduos (kg) e emissões de CO₂ (tCO₂e) por unidade
+- **Dashboard ESG consolidado:** Visão por unidade e período com gráficos de tendência
+- **Metas ESG:** Definição de metas ambientais com acompanhamento de progresso e status (em andamento, atingida, atrasada)
+- **Relatórios para compliance:** Dados prontos para relatórios de sustentabilidade corporativa e auditorias ambientais
+- Ideal para empresas do **agronegócio** que precisam demonstrar conformidade ESG a investidores e certificadoras
+
+### 5.10 KPIs — Indicadores de Performance 📊
+- **Cálculo automático** dos principais indicadores: % orçamento consumido, tempo médio de OS, rating médio de fornecedores, taxa de conclusão de demandas
+- **Status semáforo** (verde/amarelo/vermelho) para identificação visual imediata de desvios
+- Filtros por categoria, ano e centro de custo
+- Dashboard dedicado com visão gerencial consolidada
+
+### 5.11 Auditoria e Compliance 🔒
+- **Trilha completa de auditoria:** Registro detalhado de quem fez o quê, quando, com dados antes e depois
+- Relatório de conformidade por período para auditorias internas e externas
+- Exportação de logs em CSV e JSON
+- **Compliance LGPD:** Rastreabilidade total de acessos e alterações de dados pessoais
+- Atende requisitos de governança corporativa e normas ISO
+
+### 5.12 Importação de Dados (Excel/CSV) 📥
+- Upload de planilhas com **validação automática** de dados
+- Importação de orçamento planejado e demandas em massa
+- Relatório detalhado de erros por linha, facilitando correção
+- Ideal para migração de dados e carga inicial do sistema
+
+### 5.13 Relatórios Automatizados 📈
+- **Orçamento mensal:** Planejado vs. realizado com variações
+- **Demandas por período:** Status, valores e responsáveis
+- **Ranking de fornecedores:** Nota, volume e valor contratado
+- **Performance de OS:** SLA, tempo médio e taxa de conclusão
+- Exportação em JSON, CSV e PDF
+
+### 5.14 Metas e Progresso 🎯
+- Definição de metas por centro de custo: **orçamentárias**, **operacionais** e **ESG**
+- Acompanhamento de % atingido em tempo real
+- Status automático: em andamento, atingida, atrasada
+- Visão consolidada de progresso para toda a organização
+
+### 5.15 Alertas Inteligentes 🔔
+- Configuração de limites por centro de custo e categoria
+- **Tipos de alerta:** orçamento excedido, certidão vencendo, OS atrasada, meta em risco
+- Verificação automática com notificação proativa aos responsáveis
+- Prevenção de problemas antes que se tornem críticos
+
 ## 6. Modelo de Negócio

 ### 6.1 Formato
@@ -240,6 +287,40 @@ Sistema de avaliação baseado em critérios objetivos (prazo, qualidade, comuni
 ### 7.6 Audit Trail Completo
 Toda ação no sistema é registrada com timestamp, usuário, IP e dados antes/depois. Compliance total para auditorias.

+### 7.7 ESG Reporting — Inspirado no SAP Sustainability Control Tower
+Capacidade de monitoramento ambiental (energia, água, resíduos, emissões CO₂) com dashboard consolidado e metas — funcionalidades equivalentes ao SAP Sustainability Control Tower, a uma **fração do custo**. Ideal para facilities management no agronegócio, onde a demonstração de práticas ESG é cada vez mais exigida por investidores, bancos e certificadoras.
+
+### 7.8 KPIs com Semáforo Inteligente
+Indicadores calculados automaticamente com classificação visual verde/amarelo/vermelho, eliminando a necessidade de análise manual de planilhas. Gestores identificam desvios instantaneamente.
+
+### 7.9 Compliance LGPD e Rastreabilidade Total
+Trilha de auditoria completa com exportação para auditorias externas. Atende requisitos da Lei Geral de Proteção de Dados (LGPD) com registro detalhado de todo acesso e manipulação de dados pessoais. Relatórios de conformidade prontos para ISO 27001 e auditorias corporativas.
+
+### 7.10 Importação Inteligente de Dados
+Upload de planilhas Excel/CSV com validação automática e relatório de erros — migração de dados sem dor de cabeça. Empresas que usam planilhas podem adotar o HEFESTO sem perder dados históricos.
+
+### 7.11 Alertas Proativos
+Sistema de alertas inteligentes que notifica responsáveis **antes** de problemas acontecerem: orçamento prestes a estourar, certidões vencendo, OS atrasadas e metas em risco. Gestão preventiva, não reativa.
+
+### 7.12 HEFESTO vs. SAP — Comparativo
+
+| Funcionalidade | SAP | HEFESTO |
+|---|---|---|
+| Controle orçamentário | ✅ | ✅ |
+| Workflow de aprovações | ✅ | ✅ |
+| Dashboard ESG / Sustentabilidade | ✅ (Sustainability Control Tower) | ✅ |
+| KPIs com semáforo | ✅ | ✅ |
+| Auditoria e compliance | ✅ | ✅ |
+| Relatórios automatizados | ✅ | ✅ |
+| Metas e progresso | ✅ | ✅ |
+| Alertas inteligentes | ✅ | ✅ |
+| OCR em propostas | ❌ | ✅ |
+| Equalização automática | ❌ | ✅ |
+| Foco em Facilities | Genérico | ✅ Especializado |
+| Tempo de implantação | 6–18 meses | 2–4 semanas |
+| Custo de licença | Alto (6 dígitos/ano) | **Fração do custo** |
+| Ideal para agro | Complexo demais | ✅ Perfeito |
+
 ## 8. Roadmap de Evolução

 ### Fase 1 — MVP (Atual) ✅
@@ -250,6 +331,15 @@ Toda ação no sistema é registrada com timestamp, usuário, IP e dados antes/d
 - [x] Orçamento planejado vs. realizado
 - [x] Ordens de serviço

+### Fase 1.5 — Módulos SAP-Inspired (Fev 2025) ✅
+- [x] ESG / Sustentabilidade (métricas ambientais e metas)
+- [x] KPIs com status semáforo
+- [x] Auditoria e Compliance avançado
+- [x] Importação de dados Excel/CSV
+- [x] Relatórios automatizados
+- [x] Metas e Progresso por centro de custo
+- [x] Alertas Inteligentes configuráveis
+
 ### Fase 2 — Q2 2025
 - [ ] OCR para extração de valores de propostas
 - [ ] App mobile (React Native) para aprovações rápidas
@@ -301,4 +391,4 @@ Toda ação no sistema é registrada com timestamp, usuário, IP e dados antes/d

 ---

-*Documento gerado automaticamente — HEFESTO v1.0*
+*Documento gerado automaticamente — HEFESTO v2.0*
--- a/docs/MANUAL-NEGOCIOS.pdf
+++ b/docs/MANUAL-NEGOCIOS.pdf
--- a/docs/MANUAL-TECNICO-v2.pdf
+++ b/docs/MANUAL-TECNICO-v2.pdf
--- a/docs/MANUAL-TECNICO.html
+++ b/docs/MANUAL-TECNICO.html
--- a/docs/MANUAL-TECNICO.md
+++ b/docs/MANUAL-TECNICO.md
@@ -2,7 +2,7 @@

 **Sistema de Controle Orçamentário para Facilities**

-Versão 1.0 | Fevereiro 2025
+Versão 2.0 | Fevereiro 2025

 ---

@@ -91,7 +91,14 @@ backend/
 │       ├── orcamento/             # Orçamento planejado vs realizado
 │       ├── workflow/              # Máquina de estados de aprovação
 │       ├── dashboard/             # Indicadores e relatórios
-│       └── ordens-servico/        # Emissão e acompanhamento de OS
+│       ├── ordens-servico/        # Emissão e acompanhamento de OS
+│       ├── esg/                   # Métricas ESG e sustentabilidade
+│       ├── kpis/                  # Indicadores de performance
+│       ├── audit/                 # Auditoria e compliance avançado
+│       ├── import/                # Importação de dados Excel/CSV
+│       ├── relatorios/            # Relatórios automatizados
+│       ├── metas/                 # Metas e acompanhamento de progresso
+│       └── alertas-inteligentes/  # Configuração e verificação de alertas
 ├── test/
 ├── nest-cli.json
 ├── tsconfig.json
@@ -122,7 +129,13 @@ frontend/
 │   │   ├── Orcamentos.tsx         # Orçamento planejado vs realizado
 │   │   ├── OrdensServico.tsx      # Ordens de serviço
 │   │   ├── Relatorios.tsx         # Relatórios gerenciais
-│   │   └── Usuarios.tsx           # Administração de usuários
+│   │   ├── Usuarios.tsx           # Administração de usuários
+│   │   ├── ESG.tsx                # Dashboard ESG e métricas ambientais
+│   │   ├── KPIs.tsx               # Painel de indicadores de performance
+│   │   ├── Auditoria.tsx          # Logs de auditoria e compliance
+│   │   ├── Importacao.tsx         # Upload de planilhas Excel/CSV
+│   │   ├── Metas.tsx              # Metas e progresso por centro de custo
+│   │   └── Alertas.tsx            # Configuração de alertas inteligentes
 │   ├── services/                  # Axios clients e API calls
 │   │   └── api.ts
 │   ├── types/                     # Interfaces TypeScript
@@ -137,7 +150,7 @@ frontend/

 ### 4.1 Diagrama de Entidades

-O sistema possui 16 entidades principais:
+O sistema possui 21 entidades principais:

 ```
 perfis ──< usuarios ──< demandas ──< itens_linha
@@ -158,6 +171,15 @@ fornecedores ──< certidoes
 fornecedores ──< propostas

 alertas (standalone)
+
+locais ──< esg_metricas
+locais ──< esg_metas
+
+centros_custo ──< kpis
+centros_custo ──< metas
+
+centros_custo ──< alertas_config
+categorias ──< alertas_config
 ```

 ### 4.2 Descrição das Entidades
@@ -180,6 +202,11 @@ alertas (standalone)
 | 14 | **avaliacoes** | Avaliação pós-execução | id, ordem_servico_id, avaliador_id, nota, comentario, created_at |
 | 15 | **audit_log** | Log de auditoria | id, usuario_id, acao, entidade, entidade_id, dados_antes, dados_depois, ip, created_at |
 | 16 | **alertas** | Notificações e alertas | id, usuario_id, tipo, mensagem, lido, referencia_tipo, referencia_id, created_at |
+| 17 | **esg_metricas** | Métricas ambientais ESG | id, local_id, tipo (energia/agua/residuos/emissoes_co2), valor, unidade_medida, periodo, observacoes, created_at |
+| 18 | **esg_metas** | Metas ESG | id, local_id, tipo, descricao, valor_alvo, valor_atual, percentual_atingido, status, prazo, created_at |
+| 19 | **kpis** | Indicadores de performance calculados | id, nome, valor, unidade, status_semaforo, centro_custo_id, periodo, calculated_at |
+| 20 | **metas** | Metas por centro de custo | id, centro_custo_id, tipo (orcamento/operacional/esg), descricao, valor_alvo, valor_atual, percentual_atingido, status, prazo, created_at |
+| 21 | **alertas_config** | Configuração de alertas inteligentes | id, tipo, centro_custo_id, categoria_id, limite_percentual, notificar_usuarios (JSON), ativo, created_at |

 ### 4.3 Perfis de Acesso (RBAC)

@@ -341,7 +368,245 @@ alertas (standalone)
 | PATCH | `/api/alertas/:id/lido` | Marcar como lido |
 | DELETE | `/api/alertas/:id` | Remover alerta |

-**Total: 68 endpoints**
+### 5.14 ESG / Sustentabilidade (`/api/esg`)
+
+| Método | Rota | Descrição |
+|---|---|---|
+| GET | `/api/esg/metricas` | Listar métricas ambientais (filtros: unidade, período, tipo) |
+| POST | `/api/esg/metricas` | Registrar métrica ambiental |
+| PATCH | `/api/esg/metricas/:id` | Atualizar métrica |
+| DELETE | `/api/esg/metricas/:id` | Remover métrica |
+| GET | `/api/esg/dashboard` | Dashboard consolidado ESG por unidade/período |
+| GET | `/api/esg/metas` | Listar metas ESG |
+| POST | `/api/esg/metas` | Criar meta ESG |
+| PATCH | `/api/esg/metas/:id` | Atualizar meta ESG |
+| GET | `/api/esg/metas/:id/progresso` | Progresso da meta ESG |
+
+**Exemplo — POST `/api/esg/metricas`:**
+```json
+// Request
+{
+  "local_id": 3,
+  "tipo": "energia",
+  "valor": 12500.50,
+  "unidade_medida": "kWh",
+  "periodo": "2025-06",
+  "observacoes": "Consumo sede administrativa"
+}
+// Response 201
+{
+  "id": 42,
+  "local_id": 3,
+  "tipo": "energia",
+  "valor": 12500.50,
+  "unidade_medida": "kWh",
+  "periodo": "2025-06",
+  "created_at": "2025-06-30T14:00:00Z"
+}
+```
+
+**Tipos de métricas suportados:** `energia` (kWh), `agua` (m³), `residuos` (kg), `emissoes_co2` (tCO₂e).
+
+### 5.15 KPIs — Indicadores de Performance (`/api/kpis`)
+
+| Método | Rota | Descrição |
+|---|---|---|
+| GET | `/api/kpis` | Listar KPIs calculados (filtros: categoria, ano, centro_custo) |
+| GET | `/api/kpis/dashboard` | Dashboard de KPIs com status semáforo |
+
+**KPIs calculados automaticamente:**
+
+| KPI | Fórmula | Verde | Amarelo | Vermelho |
+|---|---|---|---|---|
+| % Orçamento Consumido | realizado / planejado × 100 | ≤ 80% | 81–100% | > 100% |
+| Tempo Médio de OS | média(data_fim_real - data_inicio) | ≤ SLA | SLA+20% | > SLA+20% |
+| Rating Fornecedores | média das avaliações | ≥ 4.0 | 3.0–3.9 | < 3.0 |
+| Taxa Conclusão Demandas | concluídas / total × 100 | ≥ 90% | 70–89% | < 70% |
+
+**Exemplo — GET `/api/kpis/dashboard`:**
+```json
+// Response 200
+{
+  "periodo": "2025-06",
+  "kpis": [
+    {
+      "nome": "orcamento_consumido",
+      "valor": 78.5,
+      "unidade": "%",
+      "status": "verde",
+      "centro_custo": "ADM-001"
+    },
+    {
+      "nome": "tempo_medio_os",
+      "valor": 12.3,
+      "unidade": "dias",
+      "status": "amarelo",
+      "centro_custo": "ADM-001"
+    }
+  ]
+}
+```
+
+### 5.16 Auditoria e Compliance (`/api/audit`)
+
+| Método | Rota | Descrição |
+|---|---|---|
+| GET | `/api/audit/logs` | Trilha de auditoria completa (filtros: usuario, entidade, período, ação) |
+| GET | `/api/audit/compliance-report` | Relatório de conformidade por período |
+| GET | `/api/audit/export` | Exportação de logs em CSV ou JSON (`?format=csv\|json`) |
+
+**Exemplo — GET `/api/audit/logs?entidade=demandas&periodo_inicio=2025-06-01`:**
+```json
+// Response 200
+{
+  "total": 245,
+  "page": 1,
+  "data": [
+    {
+      "id": 1023,
+      "usuario": "joao.silva@empresa.com",
+      "acao": "UPDATE",
+      "entidade": "demandas",
+      "entidade_id": 87,
+      "dados_antes": { "status": "EM_COTACAO" },
+      "dados_depois": { "status": "PROPOSTAS_RECEBIDAS" },
+      "ip": "192.168.1.50",
+      "created_at": "2025-06-15T10:32:00Z"
+    }
+  ]
+}
+```
+
+### 5.17 Importação de Dados (`/api/import`)
+
+| Método | Rota | Descrição |
+|---|---|---|
+| POST | `/api/import/excel` | Upload de planilha Excel/CSV com validação automática |
+
+**Tipos de importação:** `orcamento`, `demandas`.
+
+**Exemplo — POST `/api/import/excel` (multipart/form-data):**
+```json
+// Request: file=planilha.xlsx, tipo=orcamento
+// Response 200
+{
+  "status": "success",
+  "registros_importados": 48,
+  "registros_com_erro": 2,
+  "erros": [
+    { "linha": 15, "campo": "valor_planejado", "mensagem": "Valor inválido" },
+    { "linha": 32, "campo": "centro_custo_id", "mensagem": "Centro de custo não encontrado" }
+  ]
+}
+```
+
+### 5.18 Relatórios Automatizados (`/api/relatorios`)
+
+| Método | Rota | Descrição |
+|---|---|---|
+| GET | `/api/relatorios/orcamento-mensal` | Relatório de orçamento mensal (filtros: ano, mês, local) |
+| GET | `/api/relatorios/demandas-periodo` | Demandas por período com status e valores |
+| GET | `/api/relatorios/fornecedores-ranking` | Ranking de fornecedores com nota, valor e volume |
+| GET | `/api/relatorios/os-performance` | Performance de OS (SLA, tempo médio, conclusão) |
+
+**Todos os relatórios suportam `?format=json|csv|pdf`.**
+
+**Exemplo — GET `/api/relatorios/fornecedores-ranking?ano=2025&limit=10`:**
+```json
+// Response 200
+{
+  "periodo": "2025",
+  "ranking": [
+    {
+      "posicao": 1,
+      "fornecedor": "TechServ Ltda",
+      "rating": 4.8,
+      "total_os": 23,
+      "valor_total": 187500.00,
+      "sla_cumprido": 95.6
+    }
+  ]
+}
+```
+
+### 5.19 Metas e Progresso (`/api/metas`)
+
+| Método | Rota | Descrição |
+|---|---|---|
+| GET | `/api/metas` | Listar metas (filtros: centro_custo, tipo, status) |
+| POST | `/api/metas` | Criar meta |
+| PATCH | `/api/metas/:id` | Atualizar meta |
+| DELETE | `/api/metas/:id` | Remover meta |
+| GET | `/api/metas/progresso` | Progresso geral de todas as metas |
+| GET | `/api/metas/:id/progresso` | Progresso de meta específica |
+
+**Tipos de meta:** `orcamento`, `operacional`, `esg`.
+
+**Status:** `em_andamento`, `atingida`, `atrasada`.
+
+**Exemplo — POST `/api/metas`:**
+```json
+// Request
+{
+  "centro_custo_id": 5,
+  "tipo": "orcamento",
+  "descricao": "Reduzir gastos com manutenção em 10%",
+  "valor_alvo": 90,
+  "unidade": "%",
+  "prazo": "2025-12-31"
+}
+// Response 201
+{
+  "id": 12,
+  "centro_custo_id": 5,
+  "tipo": "orcamento",
+  "descricao": "Reduzir gastos com manutenção em 10%",
+  "valor_alvo": 90,
+  "valor_atual": 0,
+  "percentual_atingido": 0,
+  "status": "em_andamento",
+  "prazo": "2025-12-31",
+  "created_at": "2025-02-09T15:00:00Z"
+}
+```
+
+### 5.20 Alertas Inteligentes (`/api/alertas`)
+
+> **Nota:** Os endpoints abaixo complementam os alertas básicos da seção 5.13 com configuração avançada e verificação automática.
+
+| Método | Rota | Descrição |
+|---|---|---|
+| POST | `/api/alertas/configurar` | Configurar regra de alerta inteligente |
+| GET | `/api/alertas/configurar` | Listar configurações de alertas |
+| PATCH | `/api/alertas/configurar/:id` | Atualizar configuração |
+| DELETE | `/api/alertas/configurar/:id` | Remover configuração |
+| POST | `/api/alertas/verificar` | Disparar verificação manual de todos os alertas |
+
+**Tipos de alerta:** `orcamento_excedido`, `certidao_vencendo`, `os_atrasada`, `meta_em_risco`.
+
+**Exemplo — POST `/api/alertas/configurar`:**
+```json
+// Request
+{
+  "tipo": "orcamento_excedido",
+  "centro_custo_id": 5,
+  "limite_percentual": 85,
+  "notificar_usuarios": [1, 3, 7],
+  "ativo": true
+}
+// Response 201
+{
+  "id": 8,
+  "tipo": "orcamento_excedido",
+  "centro_custo_id": 5,
+  "limite_percentual": 85,
+  "notificar_usuarios": [1, 3, 7],
+  "ativo": true,
+  "created_at": "2025-02-09T15:00:00Z"
+}
+```
+
+**Total: 95 endpoints**

 ## 6. Autenticação e Autorização

@@ -505,4 +770,4 @@ pm2 startup

 ---

-*Documento gerado automaticamente — HEFESTO v1.0*
+*Documento gerado automaticamente — HEFESTO v2.0*
--- a/docs/MANUAL-TECNICO.pdf
+++ b/docs/MANUAL-TECNICO.pdf
--- a/docs/generate-pdfs.py
+++ b/docs/generate-pdfs.py
@@ -0,0 +1,605 @@
+#!/usr/bin/env python3
+"""Generate beautiful PDF manuals for HEFESTO from Markdown sources."""
+
+import markdown
+import subprocess
+import os
+import tempfile
+
+MANUALS = [
+    {
+        "md": "MANUAL-TECNICO.md",
+        "pdf": "MANUAL-TECNICO-v2.pdf",
+        "title": "Manual Técnico",
+        "subtitle": "Documentação Técnica Completa",
+        "version": "v2.0",
+        "type": "technical"
+    },
+    {
+        "md": "MANUAL-NEGOCIOS.md",
+        "pdf": "MANUAL-NEGOCIOS-v2.pdf",
+        "title": "Manual de Negócios",
+        "subtitle": "Visão Comercial e Estratégica",
+        "version": "v2.0",
+        "type": "business"
+    }
+]
+
+CSS = """
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800;900&display=swap');
+
+@page {
+    size: A4;
+    margin: 2cm 2cm 2.5cm 2cm;
+    @top-center {
+        content: "";
+    }
+    @bottom-center {
+        content: counter(page);
+        font-family: 'Inter', 'Segoe UI', sans-serif;
+        font-size: 9pt;
+        color: #999;
+    }
+}
+
+@page :first {
+    margin: 0;
+    @bottom-center { content: ""; }
+}
+
+* { box-sizing: border-box; }
+
+body {
+    font-family: 'Inter', 'Segoe UI', 'Helvetica Neue', Arial, sans-serif;
+    font-size: 10.5pt;
+    line-height: 1.7;
+    color: #333;
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+}
+
+/* COVER PAGE */
+.cover {
+    page-break-after: always;
+    width: 210mm;
+    height: 297mm;
+    margin: -2cm;
+    padding: 0;
+    display: flex;
+    flex-direction: column;
+    justify-content: center;
+    align-items: center;
+    background: linear-gradient(160deg, #0D1B2A 0%, #1A237E 40%, #1A237E 60%, #0D1B2A 100%);
+    color: white;
+    text-align: center;
+    position: relative;
+    overflow: hidden;
+}
+
+.cover::before {
+    content: '';
+    position: absolute;
+    top: 0;
+    left: 0;
+    right: 0;
+    height: 8px;
+    background: linear-gradient(90deg, #E65100, #FF8F00, #FFB300);
+}
+
+.cover::after {
+    content: '';
+    position: absolute;
+    bottom: 0;
+    left: 0;
+    right: 0;
+    height: 8px;
+    background: linear-gradient(90deg, #FFB300, #FF8F00, #E65100);
+}
+
+.cover .logo-icon {
+    font-size: 80pt;
+    margin-bottom: 10px;
+    filter: drop-shadow(0 4px 20px rgba(255, 143, 0, 0.5));
+}
+
+.cover .brand {
+    font-size: 42pt;
+    font-weight: 900;
+    letter-spacing: 12px;
+    margin-bottom: 5px;
+    background: linear-gradient(90deg, #FF8F00, #FFB300);
+    -webkit-background-clip: text;
+    -webkit-text-fill-color: transparent;
+}
+
+.cover .divider {
+    width: 120px;
+    height: 3px;
+    background: linear-gradient(90deg, transparent, #FF8F00, transparent);
+    margin: 20px auto;
+}
+
+.cover .manual-title {
+    font-size: 22pt;
+    font-weight: 300;
+    letter-spacing: 3px;
+    text-transform: uppercase;
+    color: rgba(255,255,255,0.95);
+    margin-bottom: 8px;
+}
+
+.cover .manual-subtitle {
+    font-size: 12pt;
+    font-weight: 300;
+    color: rgba(255,255,255,0.6);
+    margin-bottom: 60px;
+}
+
+.cover .meta {
+    position: absolute;
+    bottom: 50px;
+    text-align: center;
+    width: 100%;
+}
+
+.cover .company {
+    font-size: 11pt;
+    font-weight: 500;
+    letter-spacing: 4px;
+    text-transform: uppercase;
+    color: rgba(255,255,255,0.5);
+    margin-bottom: 8px;
+}
+
+.cover .date {
+    font-size: 10pt;
+    color: rgba(255,255,255,0.35);
+    letter-spacing: 2px;
+}
+
+/* GEOMETRIC DECORATIONS */
+.cover .geo1 {
+    position: absolute;
+    top: 60px;
+    right: 60px;
+    width: 200px;
+    height: 200px;
+    border: 1px solid rgba(255,143,0,0.15);
+    border-radius: 50%;
+}
+
+.cover .geo2 {
+    position: absolute;
+    bottom: 120px;
+    left: 40px;
+    width: 150px;
+    height: 150px;
+    border: 1px solid rgba(255,143,0,0.1);
+    transform: rotate(45deg);
+}
+
+/* PAGE HEADER */
+.page-header {
+    page-break-after: avoid;
+    margin-bottom: 30px;
+    padding-bottom: 12px;
+    border-bottom: 2px solid #E65100;
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    font-size: 9pt;
+    color: #999;
+    letter-spacing: 2px;
+    text-transform: uppercase;
+}
+
+.page-header .left {
+    font-weight: 700;
+    color: #1A237E;
+}
+
+.page-header .right {
+    color: #E65100;
+}
+
+/* TABLE OF CONTENTS */
+.toc-page {
+    page-break-after: always;
+}
+
+.toc-page h2 {
+    font-size: 18pt;
+    color: #1A237E;
+    border: none;
+    padding: 0;
+    margin-bottom: 25px;
+    letter-spacing: 3px;
+    text-transform: uppercase;
+}
+
+.toc-page h2::before {
+    content: '';
+    display: block;
+    width: 50px;
+    height: 3px;
+    background: #E65100;
+    margin-bottom: 15px;
+}
+
+/* HEADINGS */
+h1 {
+    font-size: 22pt;
+    font-weight: 800;
+    color: #1A237E;
+    margin-top: 40px;
+    margin-bottom: 20px;
+    padding-bottom: 10px;
+    border-bottom: 3px solid #E65100;
+    page-break-after: avoid;
+    letter-spacing: -0.5px;
+}
+
+h2 {
+    font-size: 16pt;
+    font-weight: 700;
+    color: #1A237E;
+    margin-top: 35px;
+    margin-bottom: 15px;
+    padding-left: 15px;
+    border-left: 4px solid #E65100;
+    page-break-after: avoid;
+}
+
+h3 {
+    font-size: 13pt;
+    font-weight: 600;
+    color: #283593;
+    margin-top: 25px;
+    margin-bottom: 12px;
+    page-break-after: avoid;
+}
+
+h4 {
+    font-size: 11pt;
+    font-weight: 600;
+    color: #E65100;
+    margin-top: 20px;
+    margin-bottom: 10px;
+    text-transform: uppercase;
+    letter-spacing: 1px;
+}
+
+/* FIRST H1 — remove top margin after cover */
+.content > h1:first-child {
+    margin-top: 0;
+}
+
+/* PARAGRAPHS */
+p {
+    margin-bottom: 12px;
+    text-align: justify;
+    hyphens: auto;
+}
+
+/* STRONG/BOLD in special contexts */
+strong {
+    color: #1A237E;
+    font-weight: 600;
+}
+
+/* TABLES */
+table {
+    width: 100%;
+    border-collapse: collapse;
+    margin: 20px 0;
+    font-size: 9.5pt;
+    page-break-inside: avoid;
+    box-shadow: 0 1px 4px rgba(0,0,0,0.08);
+    border-radius: 6px;
+    overflow: hidden;
+}
+
+thead {
+    background: linear-gradient(135deg, #1A237E, #283593);
+}
+
+th {
+    color: white;
+    font-weight: 600;
+    text-align: left;
+    padding: 12px 14px;
+    font-size: 9pt;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+}
+
+td {
+    padding: 10px 14px;
+    border-bottom: 1px solid #E8EAF6;
+    vertical-align: top;
+}
+
+tbody tr:nth-child(even) {
+    background-color: #F5F5FF;
+}
+
+tbody tr:hover {
+    background-color: #E8EAF6;
+}
+
+/* Checkmark styling for comparison tables */
+td:has(text("✅")), td:has(text("❌")) {
+    text-align: center;
+    font-size: 14pt;
+}
+
+/* CODE BLOCKS */
+pre {
+    background: #1E1E2E;
+    color: #CDD6F4;
+    border-radius: 8px;
+    padding: 18px 20px;
+    font-size: 9pt;
+    line-height: 1.6;
+    overflow-x: auto;
+    margin: 18px 0;
+    page-break-inside: avoid;
+    border-left: 4px solid #E65100;
+}
+
+code {
+    font-family: 'JetBrains Mono', 'Fira Code', 'Consolas', monospace;
+    font-size: 9pt;
+}
+
+p code, li code, td code {
+    background: #EDE7F6;
+    color: #4A148C;
+    padding: 2px 7px;
+    border-radius: 4px;
+    font-size: 8.5pt;
+}
+
+/* LISTS */
+ul, ol {
+    margin: 10px 0;
+    padding-left: 24px;
+}
+
+li {
+    margin-bottom: 6px;
+    line-height: 1.6;
+}
+
+li::marker {
+    color: #E65100;
+    font-weight: bold;
+}
+
+/* BLOCKQUOTES / CALLOUTS */
+blockquote {
+    background: linear-gradient(135deg, #FFF3E0, #FFF8E1);
+    border-left: 4px solid #FF8F00;
+    margin: 20px 0;
+    padding: 16px 20px;
+    border-radius: 0 8px 8px 0;
+    font-style: normal;
+    page-break-inside: avoid;
+}
+
+blockquote p {
+    margin: 0;
+    color: #5D4037;
+}
+
+blockquote strong {
+    color: #E65100;
+}
+
+/* HORIZONTAL RULES */
+hr {
+    border: none;
+    height: 2px;
+    background: linear-gradient(90deg, #E65100, #FF8F00, transparent);
+    margin: 35px 0;
+}
+
+/* LINKS */
+a {
+    color: #1A237E;
+    text-decoration: none;
+    border-bottom: 1px solid #E65100;
+}
+
+/* INFO BOX */
+.info-box {
+    background: #E3F2FD;
+    border-left: 4px solid #1565C0;
+    padding: 14px 18px;
+    border-radius: 0 8px 8px 0;
+    margin: 18px 0;
+}
+
+/* SUCCESS BOX */
+.success-box {
+    background: #E8F5E9;
+    border-left: 4px solid #2E7D32;
+    padding: 14px 18px;
+    border-radius: 0 8px 8px 0;
+    margin: 18px 0;
+}
+
+/* WARNING BOX */
+.warning-box {
+    background: #FFF3E0;
+    border-left: 4px solid #E65100;
+    padding: 14px 18px;
+    border-radius: 0 8px 8px 0;
+    margin: 18px 0;
+}
+
+/* PAGE BREAKS for major sections */
+h1 {
+    page-break-before: always;
+}
+
+h1:first-of-type {
+    page-break-before: avoid;
+}
+
+/* FOOTER NOTE */
+.doc-footer {
+    margin-top: 40px;
+    padding-top: 15px;
+    border-top: 1px solid #E0E0E0;
+    text-align: center;
+    font-size: 8.5pt;
+    color: #999;
+    font-style: italic;
+}
+
+/* Emoji sizing */
+.emoji-icon {
+    font-size: 14pt;
+}
+
+/* Print optimizations */
+@media print {
+    body { -webkit-print-color-adjust: exact !important; }
+    .cover { page-break-after: always; }
+    h1, h2, h3 { page-break-after: avoid; }
+    table, pre, blockquote { page-break-inside: avoid; }
+}
+"""
+
+COVER_HTML = """
+<div class="cover">
+    <div class="geo1"></div>
+    <div class="geo2"></div>
+    <div class="logo-icon">🔥</div>
+    <div class="brand">HEFESTO</div>
+    <div class="divider"></div>
+    <div class="manual-title">{title}</div>
+    <div class="manual-subtitle">{subtitle}</div>
+    <div class="meta">
+        <div class="company">Kislanski Industries &nbsp;|&nbsp; AI Vertice</div>
+        <div class="date">Fevereiro 2026 &nbsp;·&nbsp; {version}</div>
+    </div>
+</div>
+"""
+
+def generate_html(md_content, manual_info):
+    extensions = ['tables', 'fenced_code', 'toc', 'nl2br', 'sane_lists']
+    ext_configs = {
+        'toc': {'title': '', 'toc_depth': '1-3'}
+    }
+    
+    md = markdown.Markdown(extensions=extensions, extension_configs=ext_configs)
+    html_body = md.convert(md_content)
+    toc_html = md.toc
+    
+    cover = COVER_HTML.format(
+        title=manual_info['title'],
+        subtitle=manual_info['subtitle'],
+        version=manual_info['version']
+    )
+    
+    header_title = f"HEFESTO — {manual_info['title']}"
+    
+    full_html = f"""<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>HEFESTO - {manual_info['title']}</title>
+    <style>{CSS}</style>
+</head>
+<body>
+    {cover}
+    
+    <div class="toc-page">
+        <h2>Sumário</h2>
+        {toc_html}
+    </div>
+    
+    <div class="page-header">
+        <span class="left">{header_title}</span>
+        <span class="right">{manual_info['version']}</span>
+    </div>
+    
+    <div class="content">
+        {html_body}
+    </div>
+    
+    <div class="doc-footer">
+        HEFESTO {manual_info['version']} &nbsp;·&nbsp; Kislanski Industries | AI Vertice &nbsp;·&nbsp; Fevereiro 2026<br>
+        Documento confidencial — Todos os direitos reservados
+    </div>
+</body>
+</html>"""
+    
+    return full_html
+
+
+def generate_pdf(html_path, pdf_path):
+    cmd = [
+        'google-chrome',
+        '--headless',
+        '--disable-gpu',
+        '--no-sandbox',
+        '--disable-software-rasterizer',
+        f'--print-to-pdf={pdf_path}',
+        '--print-to-pdf-no-header',
+        '--no-margins',
+        f'file://{html_path}'
+    ]
+    
+    result = subprocess.run(cmd, capture_output=True, text=True, timeout=30)
+    if result.returncode != 0:
+        # Try chromium as fallback
+        cmd[0] = 'chromium-browser'
+        result = subprocess.run(cmd, capture_output=True, text=True, timeout=30)
+    
+    return os.path.exists(pdf_path)
+
+
+def main():
+    docs_dir = os.path.dirname(os.path.abspath(__file__))
+    
+    for manual in MANUALS:
+        md_path = os.path.join(docs_dir, manual['md'])
+        pdf_path = os.path.join(docs_dir, manual['pdf'])
+        
+        print(f"\n{'='*60}")
+        print(f"Generating: {manual['title']}")
+        print(f"{'='*60}")
+        
+        # Read markdown
+        with open(md_path, 'r', encoding='utf-8') as f:
+            md_content = f.read()
+        
+        # Generate HTML
+        html_content = generate_html(md_content, manual)
+        
+        # Write temp HTML
+        html_path = os.path.join(docs_dir, manual['md'].replace('.md', '.html'))
+        with open(html_path, 'w', encoding='utf-8') as f:
+            f.write(html_content)
+        print(f"  ✓ HTML generated: {html_path}")
+        
+        # Generate PDF
+        if generate_pdf(html_path, pdf_path):
+            size_mb = os.path.getsize(pdf_path) / (1024*1024)
+            print(f"  ✓ PDF generated: {pdf_path} ({size_mb:.1f} MB)")
+        else:
+            print(f"  ✗ PDF generation failed!")
+        
+        # Cleanup HTML
+        # os.remove(html_path)
+    
+    print(f"\n{'='*60}")
+    print("Done!")
+
+
+if __name__ == '__main__':
+    main()