ADR-001: Nomes de Repositórios
Resumo publicável desta decisão arquitetural.
Decisão
A MIDDAG usa nomes previsíveis por família de projeto para facilitar descoberta, automação e suporte operacional.
Padrões principais
| Família | Padrão | Exemplo |
|---|---|---|
| Moodle plugins | moodle-{frankenstyle} | moodle-local_middag |
| Moodle sites | docker-moodle-{nome} ou moodle-{nome} | moodle-helico |
| WordPress plugins | wp-plugin-{nome} | wp-plugin-my-project |
| WordPress themes | wp-theme-{nome} | wp-theme-my-project |
| Composer/PHP packages | middag-php-{nome} | middag-php-framework |
| Apps | app-{runtime}-{nome} quando necessário | app-vite-helico |
| Infra | infra-{nome} ou docker-{stack}-{nome} | my-satis-repo |
Regras operacionais
- Moodle preserva frankenstyle quando aplicável.
- Projetos não-Moodle usam hifens como separador.
- Evitar nomes históricos que escondem a família técnica do projeto.
- Repos de clientes ativos podem manter exceções quando renomear criaria risco operacional.
Uso
Use esta ADR ao criar ou normalizar repositórios e ao preparar wrappers para workflows reutilizáveis.