Documentação de operação — Coaching¶
Bem-vindo. Este site é o ponto único para operações em produção: tarefas agendadas (systemd), reverse proxy (nginx), gestor de processos (PM2 + Node.js), permissões de deploy e alojamento do próprio docs.diasantos.com.
A interface da aplicação está do outro lado; aqui documentamos servidores, timers e infraestrutura.
Mapa da documentação¶
- Cron systemd
Timer coaching-cron-tick → POST /api/cron/tick, ficheiro env, sudo no deploy.
- Nginx
Reverse proxy para Next.js e TLS; timeouts longos para deploy admin (SSE).
- Alojar este site
Servir documentation/site/ em docs.diasantos.com com Certbot.
- Utilizador deploy e permissões
Utilizador Unix coaching, sudoers para instalar cron, build MkDocs, versão Node.
- PM2 e systemd
PATH, nvm, interpreter no ecosystem — PM2 sob systemd sem surpresas.
- Ollama (LLM)
Instalação Linux/Debian, OLLAMA_BASE_URL / OLLAMA_MODEL na app, segurança.
Visão em camadas (produção)¶
┌─────────────────┐
Internet ───────►│ nginx (TLS) │
│ app + docs │
└────────┬────────┘
│
┌───────────────┼───────────────┐
▼ ▼ ▼
┌────────────┐ ┌──────────────┐ ┌─────────────────┐
│ Next.js │ │ MkDocs estático │ │ timer systemd │
│ pm2 :3000 │ │ site/ │ │ → /api/cron/* │
└────────────┘ └──────────────┘ └─────────────────┘
│
▼
┌──────────────┐
│ PostgreSQL │
└──────────────┘
Começa pela visão geral
Vê Implantação — visão geral para uma checklist ordenada e ligações a todos os guias.
Editar ou pré-visualizar localmente¶
Na raiz do repositório:
cd documentation
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
mkdocs serve
Abre http://127.0.0.1:8000/pt/ (Português). O selector no cabeçalho alterna English / Português.
Build de produção¶
cd documentation
pip install -r requirements.txt
mkdocs build
Saída: documentation/site/. O pipeline Deploy na app corre documentation/build-from-deploy.sh no servidor.
Repositório¶
O Markdown fonte está em documentation/docs/ no repositório coaching_v2 — usa Edit this page no rodapé quando estiveres num tópico.