Distribuição Docs e Playbook

Documento canônico: 06-public-sites/docs-playbook-distribution.md

Decisão

docs.techhuman.com.br e playbook.techhuman.com.br são experiências públicas premium servidas por repos distribuidores dedicados no GitHub Pages. O conteúdo continua canônico neste repositório privado.

TECH-HUMAN/th-new-business-model
        ↓ deploy key read-only
Repos distribuidores públicos
        ↓ GitHub Pages + CNAME
docs.techhuman.com.br / playbook.techhuman.com.br

Repositórios

Domínio	Repo distribuidor	Fonte canônica
docs.techhuman.com.br	TECH-HUMAN/techhuman-docs	05-docs-site/
playbook.techhuman.com.br	TECH-HUMAN/techhuman-playbook	07-playbook-site/

Os distribuidores não editam conteúdo. Eles apenas fazem checkout deste repo privado, geram o site estático e publicam o artifact no GitHub Pages.

DNS

Configuração na Hostinger:

docs      CNAME   tech-human.github.io
playbook  CNAME   tech-human.github.io

Não usar path no DNS. docs.techhuman.com.br e playbook.techhuman.com.br publicam na raiz do domínio; por isso cada um precisa de repo Pages próprio.

Secrets e permissões

Cada repo distribuidor tem um secret:

TH_NEW_BUSINESS_MODEL_DEPLOY_KEY

Esse secret guarda a chave privada de uma deploy key read-only registrada em TECH-HUMAN/th-new-business-model. A permissão é só de leitura do repo canônico.

Workflows

Repo	Workflow	Build
TECH-HUMAN/techhuman-docs	.github/workflows/deploy-pages.yml	npm run validate:custom-domain em 05-docs-site/
TECH-HUMAN/techhuman-playbook	.github/workflows/deploy-pages.yml	npm run validate em 07-playbook-site/

Os workflows rodam em push para main dos distribuidores, manualmente via workflow_dispatch e podem ser agendados para sincronizar mudanças canônicas.

Validação

Docs:

cd /Users/parreiras/projects/Techhuman/th-new-business-model/05-docs-site
npm run validate:custom-domain

Playbook:

cd /Users/parreiras/projects/Techhuman/th-new-business-model/07-playbook-site
NEXT_PUBLIC_DOCS_BASE_URL=https://docs.techhuman.com.br npm run validate

URLs públicas:

curl -I https://docs.techhuman.com.br/
curl -I https://playbook.techhuman.com.br/

Regra editorial

Docs guarda a íntegra. Playbook traduz a arquitetura em entendimento. Site comercial vende com curadoria. O repositório canônico governa todos.