Publish | Wiki do Projeto

governanca publicacao operacao

Scaffolds e configuração para publicar o vault como 3 wikis com audiências distintas, usando Quartz (gerador estático) + Cloudflare Pages (hosting) + Cloudflare Access (SSO Google). O vault permanece canônico. A wiki é publicação derivada — nunca substitui o vault.


Arquitetura alvo

[Vault em Google Drive / git] ──► [GitHub Action]
                                        │
                            ┌───────────┼───────────┐
                            ▼           ▼           ▼
                     [Quartz build] [Quartz build] [Quartz build]
                     filter:internal filter:client filter:board
                            │           │           │
                            ▼           ▼           ▼
                    [Cloudflare Pages projeto x3]
                            │           │           │
                            ▼           ▼           ▼
             wiki.anoukpartners.com/colliers-interno
             wiki.anoukpartners.com/colliers-cliente
             wiki.anoukpartners.com/colliers-board
                            │           │           │
                            └─── Cloudflare Access (SSO Google) ───┘
                              (grupos distintos por subdomínio)

Três audiências

AudiênciaQuemEscopoAuth
internalTime AnoukTudo exceto memory/, feedback/, sessões, #sensivel, scriptsSSO domínio @anoukpartners.com
clientIgor + designados Costal/ColliersHOME, visão de projeto, plano Costal, arquitetura empresarial, entregáveis explicitamente marcadosSSO lista de e-mails nomeada
boardRicardo, Bruno, LucasApenas briefs executivos com tag publish: [..., board]SSO lista de e-mails nomeada

Conteúdo desta pasta

Arquivo / PastaPropósito
handoff⭐ Checklist executável — o que falta, na ordem, com tempo estimado
publish-contractContrato de publicação — o que vai para cada audiência, defaults por pasta, regras
audience-schemeEsquema de frontmatter publish: e como tagar arquivos
deployment-guidePasso a passo detalhado (referência técnica)
cloudflare-setupDetalhe técnico Cloudflare Pages + Access (rules, SSO Google Workspace)
sync-optionsOpções de sincronizar Google Drive ↔ git (3 caminhos, com tradeoffs)
bootstrap.shScript que automatiza Fase 1 ponta a ponta (setup inicial)
preview.shPreview local — testa audiência localmente antes do deploy (idempotente)
quartz/Scaffold Quartz (config, filtros, layout) — copiado para o repo pelo bootstrap
workflows/Template GitHub Actions (wiki.yml, matrix build x3)

Status

  • Scaffold local: ✅ pronto (esta pasta)
  • GitHub repo: ✅ criado em Anouk-Partners/colliers-costal-wiki
  • DNS no Cloudflare: ✅ propagado
  • bootstrap.sh: ✅ automatiza Fase 1 ponta a ponta
  • Primeira tagagem de publish:: ✅ feita (15 arquivos + 1 brief board novo)
  • Merge scaffold + Quartz v4 no repo: pendente (Pedro roda bootstrap.sh)
  • Sync Drive → git: pendente (rclone config — ver sync-options §A)
  • Cloudflare Pages x3: pendente (Pedro cria no dashboard)
  • Cloudflare Access + SSO: pendente (Pedro configura Google Workspace + policies)

Ordem de execução recomendada

  1. Ler publish-contract e audience-scheme para entender o modelo
  2. Escolher opção de sync em sync-options
  3. Seguir deployment-guide do início ao fim
  4. Tagar arquivos-chave com frontmatter publish: antes do primeiro build
  5. Rodar primeiro build em ambiente internal apenas (validar)
  6. Depois habilitar client e board

Ver também