e268d8026a
Documenta como o cursos.overia.com.br e construido (LearnHouse 1.3.6 community no NAS4, login pelo Keycloak via oauth2-proxy e ponte, tema overia injetado pelo nginx, aulas por proxy /aulas), as armadilhas ja encontradas, o runbook de publicacao, rollback, backup e atualizacao, e as decisoes e pendencias. learnhouse-upstream.md resume o repositorio e a documentacao oficiais e marca onde a doc diverge do codigo da imagem (cookies LH_*, politica de login por organizacao). deploy/publicar-tema.sh publica deploy/theme e o nginx.prod.conf com nginx -t e volta automatica; recebe host, porta, usuario e senha por variaveis de ambiente. O repositorio e publico: nenhum IP, porta, usuario, conta ou segredo nos arquivos. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Documentação — cursos.overia.com.br
Estado documentado em 2026-10-04. Este repositório é público no Gitea: não coloque aqui IPs, portas de SSH, usuários,
senhas, tokens nem segredos de qualquer tipo. Os segredos vivem só nos servidores (oauth2-proxy.env, .env do stack) e no
gerenciador de senhas.
| Documento | Para que serve |
|---|---|
| arquitetura.md | Como o site é construído: componentes, fluxos e onde cada coisa mora |
| sso.md | Login pelo login.overia.com.br (Keycloak): desenho, segurança e armadilhas já encontradas |
| tema.md | O visual do overia (claro, escuro e botão de tema) aplicado por cima do LearnHouse |
| operacao.md | Como publicar mudanças, voltar atrás, fazer backup e diagnosticar problemas |
| learnhouse-upstream.md | O que sabemos do LearnHouse (repositório e documentação oficiais) e o que isso muda para nós |
| decisoes-e-pendencias.md | Decisões tomadas (com o porquê), riscos aceitos e o que ainda está aberto |
| superpowers/ | Spec e plano originais do pipeline de publicação de cursos (2026-09-29) |
Em uma frase
O cursos.overia.com.br é uma instalação LearnHouse 1.3.6 (edição community) hospedada no NAS4, com login pelo Keycloak
(oauth2-proxy + uma ponte própria), visual do overia.com.br injetado pelo nginx e conteúdo publicado por um pipeline neste
repositório. A imagem do LearnHouse não foi alterada.
Onde está o código deste repositório
| Pasta | O que é |
|---|---|
courses/ |
Conteúdo dos cursos (Markdown) e course.json de cada um |
scripts/ |
Pipeline que publica os cursos pela API do LearnHouse |
sso_bridge/ |
Ponte que cria a sessão do LearnHouse a partir do login do Keycloak |
deploy/ |
Arquivos que vão para o servidor: nginx.prod.conf, docker-compose.override.yml, theme/, publicar-tema.sh |
tests/ |
Testes do pipeline e da ponte (uv run pytest) |