runv-server

server tooling for runv.club
Log | Files | Refs | README

README.md (2639B)


      1 # Documentação runv-server
      2 
      3 Índice canónico do repositório **runv-server** (automação para pubnix Debian / runv.club). Tudo em **pt-BR**. Esta pasta é a **porta de entrada**; não dependa de ficheiros `.md` antigos nos módulos (foram removidos nesta reconstrução — ver `DOCS_REBUILD_CHANGELOG.md` na raiz).
      4 
      5 ## Ordem de leitura sugerida
      6 
      7 1. [Visão geral](00-overview.md)
      8 2. [Baseline Debian](01-server-baseline-debian.md)
      9 3. [Acesso admin e SSH](02-admin-access-and-ssh.md)
     10 4. [Caminhos e estado](03-paths-files-and-state.md)
     11 5. [Bootstrap](04-bootstrap-and-base-system.md)
     12 6. [Ferramentas globais](05-tools-and-system-experience.md)
     13 7. [Site e Apache](06-site-and-apache.md)
     14 8. [Membros públicos](07-public-members-directory.md)
     15 9. [Email](08-email.md)
     16 10. [Terminal entre](09-terminal-entre.md)
     17 11. [Provisionamento e admin](10-user-provisioning-and-admin-ops.md)
     18 12. [Operação diária](11-daily-operations.md)
     19 13. [Segurança e privacidade](12-security-and-privacy.md)
     20 14. [Resolução de problemas](13-troubleshooting.md)
     21 15. [Smoke tests](14-smoke-tests-and-validation.md)
     22 16. [Reparar usuários](16-repair-users.md)
     23 17. [Comandos comunitários](17-community-commands.md)
     24 18. [Glossário e referência](15-glossary-and-reference.md)
     25 
     26 ## Mapa rápido
     27 
     28 | Quero… | Documento |
     29 |--------|-----------|
     30 | Entender o que é o projeto | [00-overview.md](00-overview.md) |
     31 | Preparar o servidor Debian | [01](01-server-baseline-debian.md), [04](04-bootstrap-and-base-system.md) |
     32 | Instalar landing Apache | [06-site-and-apache.md](06-site-and-apache.md) |
     33 | Lista de bolhas / `members.json` | [07-public-members-directory.md](07-public-members-directory.md) |
     34 | Pedidos SSH `entre` | [09-terminal-entre.md](09-terminal-entre.md) |
     35 | Criar conta membro | [10-user-provisioning-and-admin-ops.md](10-user-provisioning-and-admin-ops.md) |
     36 | Reparar home incompleta / `Index of /~USER` | [16-repair-users.md](16-repair-users.md) |
     37 | Usar comandos sociais pubnix (`runv-who`, `runv-finger`, mural) | [17-community-commands.md](17-community-commands.md) |
     38 | Email Mailgun / legado | [08-email.md](08-email.md) |
     39 | Solicitar alias `usuario@runv.club` | [08-email.md](08-email.md), [17-community-commands.md](17-community-commands.md) |
     40 
     41 ## Diagramas (Mermaid)
     42 
     43 - [diagrams/architecture.mmd](diagrams/architecture.mmd)
     44 - [diagrams/member-flow.mmd](diagrams/member-flow.mmd)
     45 
     46 ## Código-fonte
     47 
     48 A documentação descreve scripts em `scripts/`, `terminal/`, `site/`, `tools/`, `email/`. As docstrings e `--help` dos scripts são fonte de verdade complementar (ver [14-smoke-tests-and-validation.md](14-smoke-tests-and-validation.md)).