Fabrica de Software - Arquitetura Hanna & Panteao

Mapa completo: codigo, ambientes, deploys, sprints e agentes - tudo interligado, cada peca no seu lugar.

FABRICA DE SOFTWARE - ARQUITETURA COMPLETA
CASA
Seu PC / Notebook 		GITHUB
(novo, separado) 		CLOUDFLARE
Proxy / DNS / SSL 		VPS CONTABO (Alemanha)
194.163.166.14
Codigo Local
workspace-hanna/
Editor / Terminal
VSCode / webchat
Bitwarden
Suas senhas
SSH
Acesso a VPS
Hanna (aqui)
Orquestradora
→
Repo: algiz-phi/hanna
Novo, seu nao usa
main (producao)
develop (dev)
feature/* (tarefas)
hotfix/* (urgencias)
GitHub Actions
CI/CD automatico
→
DNS: *.algiz-phi.us
Proxy + SSL + CDN
→
Nginx (:80/:443)
OpenClaw Gateway
porta 18789
Docker
Ponto + Dokploy
Ambientes: DEV QA STG PRD
WorkSpace OpenClaw
Agentes: Hanna, Pitaco, Argus
git push/pull | deploy CI/CD | HTTPS + DNS | SSH terminal | navegador

Os 4 Ambientes

DEV

Seu PC. Codigo rodando so aqui. Testa, quebra, conserta a vontade.

QA

Branch develop. Sobe pra VPS em teste. Hanna e Pitaco revisam.

STAGING

Identico a producao. Ultimo teste antes de ir ao ar.

PRODUCTION

Branch main. O que o mundo ve. So sobe apos passar todos os outros.

Sprints

Planning

Inicio da sprint. Decide o que fazer, pega tarefas do backlog.

Dev

Dias de codar. Cada tarefa vira uma branch feature/. Commits.

Review

Pitaco revisa. Argus audita. Aprovado = merge na develop.

Deploy

CI/CD faz deploy automatico via GitHub Actions + Dokploy.

Rollback

Se quebrou: git revert + redeploy = volta ao normal em minutos.

Fluxo Completo

EDITAR -> COMMIT -> PUSH -> PR -> REVIEW -> MERGE -> CI/CD -> DEPLOY -> MONITOR
1. EDITAR

Voce edita o codigo no VSCode/terminal no seu PC.

2. COMMIT GIT

Tirar foto do codigo. git add . && git commit -m "feat: login via Google"

3. PUSH GIT

Enviar pro GitHub (nuvem). git push origin feature/x

4. PULL REQUEST

Pedido de revisao no GitHub. Pitaco recebe notificacao.

5. REVIEW QA

Pitaco + Argus revisam. Aprovam ou pedem mudancas.

6. MERGE GIT

Junta o codigo novo com develop ou main.

7. CI/CD DEV

GitHub Actions: testes automaticos + deploy se passar.

8. DEPLOY

Codigo novo no ar na VPS. Dokploy gerencia.

9. MONITOR

Observa. Se der erro = rollback.

Glossario Tecnico (mastigado)

GIT VERSIONAMENTO
Sistema que controla versoes do codigo. Cada alteracao vira um commit (checkpoint). Ctrl+Z infinito.
BRANCH GIT
Linha do tempo paralela. main=producao, develop=dev, feature/x=tarefa, hotfix/x=urgencia.
PULL REQUEST (PR) GIT
Pedido pra juntar seu codigo. Alguem revisa antes de aceitar.
COMMIT GIT
Savepoint do codigo. git commit -m "mensagem clara do que mudou".
PUSH / PULL GIT
Push = enviar pro GitHub. Pull = baixar do GitHub.
CI/CD DEV
CI = testes automaticos no push. CD = deploy automatico se passar. Codigo novo no ar em minutos.
DOKPLOY VPS
Painel visual de deploys. Mostra status de cada app. Acessa em :3000.
SPRINT SCRUM
Ciclo de 1-2 semanas. Planeja -> faz -> revisa -> entrega.
BACKLOG SCRUM
Lista de tarefas pendentes, ordenadas por prioridade.
ROLLBACK DEPLOY
Voltar pra versao anterior. git revert + redeploy. Feito em minutos.
GITHUB ACTIONS GIT
Robo que executa tarefas automaticamente quando voce pusha. Ex: fazer deploy.
POST-MORTEM SCRUM
Documento apos problema em producao: o que aconteceu, o que causou, como resolveram.

Onde ficam as senhas?

- Bitwarden (seu PC local) - suas senhas pessoais.

- GitHub Secrets (no repo dos agentes) - chaves que o CI/CD usa.

- OpenClaw Config (VPS, /root/.openclaw/) - API keys dos agentes.

Diagrama Fabrica de Software - Criado por Hanna - 28/05/2026