docs(obsidian): vault pulse sync — 5 notas (Home, pulse-3d-landing, pulse-dev, design-tokens, pulse-libs)

2026-05-20 20:23:09 -03:00
parent e1924ad4f2
commit 4067389abe
8 changed files with 381 additions and 0 deletions
@@ -0,0 +1,99 @@
+---
+title: "Dev Environment Full-Stack Pulse"
+created: 2026-05-20
+tags: [dev, swarm, agents, taskboard, hot-reload]
+projeto: pulse-dev
+---
+
+# 🚀 Dev Environment Full-Stack Pulse
+
+## Stack Swarm `dev` — arquitetura
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    DEV ORCHESTRATOR                              │
+│   (taskboard + Redis queue + log stream)                        │
+├─────────────────────────────────────────────────────────────────┤
+│  FRONTEND  5173  │  BACKEND  3001  │  WORKERS (FEBE_DEV_OPS)   │
+│  Vite HMR        │  tsx HMR         │                              │
+│  [1 réplica]     │  [1 réplica]     │  [2 FE] [2 BE] [1 DevOps]  │
+├─────────────────────────────────────────────────────────────────┤
+│  Redis 6379 — fila `dev-tasks` + canal `dev-logs`               │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Serviços ativos
+
+| Serviço | Imagem | Porta | DOMÍNIO |
+|---------|--------|-------|---------|
+| redis | redis:8-alpine | 6379 | interno |
+| taskboard | nginx:alpine | 80 | `board.octal.tec.br` |
+| dev-frontend | node:24-alpine | 5173 | `frontend.octal.tec.br` |
+| dev-backend | node:24-alpine | 3001 | `api.octal.tec.br` |
+| agent-frontend ×2 | node:24-alpine | — | workers |
+| agent-backend ×2 | node:24-alpine | — | workers |
+| agent-devops ×1 | node:24-alpine | — | workers |
+
+## API Backend (porta 3001)
+
+| Rota | Método | Descrição |
+|------|--------|-----------|
+| `/health` | GET | Health check |
+| `/tasks` | GET | Listar todas as tarefas |
+| `/tasks` | POST | Criar tarefa (adiciona na fila `dev-tasks`) |
+| `/tasks/:id` | PUT | Atualizar tarefa |
+| `/agents` | GET | Listar agentes conectados |
+
+## Task Protocol (Redis)
+
+```json
+{
+  "id": "uuid",
+  "type": "feature|bug|refactor|test|devops",
+  "priority": "low|medium|high|critical",
+  "domain": "frontend|backend|devops|fullstack",
+  "title": "...",
+  "description": "...",
+  "files_affected": ["src/..."],
+  "acceptance_criteria": ["..."],
+  "created_at": "2026-05-20T19:00:00Z",
+  "status": "pending|in_progress|done|blocked",
+  "assignee": null | "agent-frontend" | "agent-backend" | "agent-devops"
+}
+```
+
+## Agentes (worker loop)
+
+- `agent-frontend` ×2 — React/Vite specialist, BLPOP domínio=frontend|fullstack
+- `agent-backend` ×2 — Node/Express specialist, BLPOP domínio=backend|fullstack
+- `agent-devops` ×1 — Docker Swarm specialist, BLPOP domínio=devops
+
+Ciclo: `claimTask → log(AGENT) → process (2-6s) → done → redis.publish`
+
+## Hot Reload
+
+| Serviço | Comando | Sistema |
+|---------|---------|---------|
+| Frontend | `npx vite --host 0.0.0.0 --port 5173` | Vite HMR (WS connect) |
+| Backend | `npx tsx watch --dir ./src server.ts` | tsx HMR (restart em mudança) |
+
+Código montado via volume bind mount (`:cached`) — qualquer alteração arquivo → hot reload instantâneo.
+
+## Vault Obsidian
+
+- Caminho: `/root/Obsidian-Pulse/`
+- Estrutura: Inbox / Projetos / Docker / Dev / Codex / Logs / Memorias / Templates
+- Skill: obsidian-vault-linker instalada e pronta
+
+## Hotlinks
+
+- `[[Swarm-Stacks-Reference]]` — todas as 11 stacks
+- `[[Task-Protocol]]` — protocolo de tasks entre agentes
+- `[[MEMORY]]` — memória curada do Pulse
+- `[[DEV-STACK-YML]]` — compose da stack `dev`
+
+## Referências
+
+- runbook: `pulse-docs/runbooks/dev-stack.yml`
+- guia: `pulse-docs/runbooks/dev-environment.md`
+- MEMORY.md → `{{project: pulse-memory → MEMORY.md}}`