PRD — Operação do Zoe Docs com Publicação Segura

Versão: 1.0
Data: 2026-04-17
Owner: Infra Network / Zoe

1. Objetivo

Validar um fluxo real de documentação operacional publicado pela Zoe em ambiente seguro, com navegação web, organização por categoria e publicação automatizada.

2. Problema

A Zoe precisava de um ambiente em que documentos não dependessem de acesso manual por SSH para consulta, mantendo segurança, organização e praticidade.

3. Solução adotada

Implantação de um servidor documental com: - MkDocs - Nginx - HTTPS com Let's Encrypt - restrição por IP - diretório dedicado em /opt/zoe-docs - script de publicação automatizada

4. Estrutura funcional

Categorias padrão: - PRDs - Relatórios - Decisões - Tarefas - Clientes

Fluxo operacional: 1. Zoe gera o markdown 2. salva em /opt/zoe-docs/docs/... 3. executa publish.sh 4. MkDocs gera HTML 5. Nginx publica com HTTPS

5. Regras de segurança

não usar /root/.openclaw/workspace como origem web
restringir acesso por IP
bloquear arquivos ocultos
manter HTTPS válido
evitar sobrescrita sem controle

6. Resultado esperado

acesso simples via navegador
documentação organizada
ambiente preparado para expansão futura
base segura para integração com InfraFlow

7. Status atual

Implementado e funcional em produção controlada.

8. Próximos passos

melhorar a navegação inicial
criar templates reais por tipo de documento
padronizar publicação de PRDs, relatórios e decisões