Documentação — Coaching¶
Bem-vindo. Aqui encontras os guias de utilização da aplicação, para treinadores, dirigentes e atletas, e os guias de operação para quem mantém os servidores (systemd, nginx, PM2, permissões de deploy e o alojamento de docs.diasantos.com).
Guias de utilização¶
Primeiros passos¶
- Primeiros passos
Entrar, escolher clube e época, início, alertas, perfil e opiniões.
- Área do atleta e encarregados
O que atletas e pais vêem e como avisam que faltam.
- Aplicação móvel
Entrar, separadores e módulos disponíveis no telemóvel.
Competição¶
- Jogos
Todos os separadores do jogo: jogo, convocatória e 5, preparação, tácticas, notas, notificações, resultado.
- Folha de jogo
Blocos, grelha, tamanho da página, quebras de página e impressão.
- Competições
Competições da época por escalão, séries e importação da FPB.
- Adversários
Clubes adversários, equipas por escalão e pavilhões.
Planeamento¶
- Calendário
Treinos, jogos e microciclos do mês; criar treinos e treinos em série.
- Treinos
Sessão, planeamento, plano com exercícios, assiduidade, grupos, fecho e impressão.
- Exercícios
Biblioteca, partilha, gráficos e editor de campo.
- Jogadas
Passos com texto de ensino, leituras da defesa, animação e breakdowns.
- Livros de jogadas
Juntar jogadas num livro com capa, imprimir e playbook da equipa.
- Ciclos
Macrociclos, mesociclos e microciclos, carga de treino e objectivos de sessão.
Clube¶
- Atletas
Lista, ficha do atleta, indisponibilidades, convites e pendentes.
- Equipas
Plantel, equipa técnica, assiduidade e definições de cada equipa.
- Equipa técnica
Fichas de treinadores e dirigentes, graus, licenças e contas.
- Equipamentos
Inventário de equipamentos e atribuição de números.
- Escalões
Escalões do clube: idades, género e descrição.
- Definições do clube
Dados do clube, permissões, contas, cores, faltas e notificações.
Administração¶
- Administração da plataforma
Clubes, épocas, contas, site, manutenção e deploy.
Operação e deploy¶
- 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 apps/docs/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 apps/docs
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 apps/docs
pip install -r requirements.txt
mkdocs build
Saída: apps/docs/site/. O pipeline Deploy na app corre apps/docs/build-from-deploy.sh no servidor.
Repositório¶
O Markdown fonte está em apps/docs/docs/ no repositório coaching_v2 — usa Edit this page no rodapé quando estiveres num tópico.