feat(wiki): padronizar upload de arquivos e midias para MinIO Paiol

This commit is contained in:
Luiz Silva 2026-10-06 18:24:03 -03:00
parent 19df29ea45
commit 49943f82bf
13 changed files with 272 additions and 12 deletions

View file

@ -44,6 +44,31 @@ Todo desenvolvimento e manutenção no ecossistema deve obrigatoriamente respeit
---
## Armazenamento de Arquivos e Mídias da Wiki no MinIO Paiol
Para evitar o inchaço (*bloat*) irreversível do repositório Git da Wiki (`<modulo-wiki>`), **arquivos binários e mídias pesadas** (manuais em PDF, imagens em alta resolução, fluxogramas, diagramas, gravações em vídeo e anexos) **NUNCA** devem ser commitados no Git da Wiki.
### Protocolo de Envio e Nomenclatura:
- **Destino:** Bucket público `wiki` no MinIO Paiol:
```
https://paiol.idz.one/wiki/{modulo}/{funcionalidade/pagina}-{aleatorio}.{ext}
```
Onde `{modulo}` é extraído de `modulo-id` em `memorias-ia/modulo.yml` e `{aleatorio}` é um sufixo alfanumérico curto (8 caracteres) para renovação de cache e prevenção de colisão.
- **Envio via Utilitário CLI (Recomendado):**
```bash
./.agent/scripts/upload-paiol-wiki.sh <caminho-do-arquivo> <slug-funcionalidade>
```
- **Envio Direto via cURL:**
```bash
curl -X PUT --upload-file ./manual.pdf https://paiol.idz.one/wiki/{modulo}/{funcionalidade/pagina}-{aleatorio}.pdf
```
- **Referência nos Markdowns da Wiki:**
Nos arquivos `.md` da Wiki, utilize exclusivamente as URLs públicas geradas:
- Para imagens: `![Descrição](https://paiol.idz.one/wiki/{modulo}/{slug}-{aleatorio}.png)`
- Para manuais/documentos: `[Baixar Manual (PDF)](https://paiol.idz.one/wiki/{modulo}/{slug}-{aleatorio}.pdf)`
---
## Protocolo DDD
Para toda nova demanda, módulo ou funcionalidade, execute os passos abaixo:

View file

@ -71,6 +71,15 @@ Na Wiki (caminho resolvido dinamicamente via `modulo-wiki` em `memorias-ia/modul
- Havendo conflitos de merge, a IA resolve as marcações diretamente na `master`, preservando a coerência da documentação dos 6 pilares.
- Adiciona os arquivos resolvidos (`git -C <modulo-wiki> add -A`), finaliza o rebase (`git -C <modulo-wiki> rebase --continue` ou commit) e envia com `git push origin master`.
3. **Proibição de Binários Pesados no Git da Wiki (Usar MinIO Paiol)**:
- É expressamente proibido versionar no Git da Wiki arquivos binários ou mídias pesadas (manuais em `.pdf`, vídeos `.mp4`/`.webm`, imagens pesadas, pacotes `.zip`).
- Todo arquivo estático da Wiki DEVE ser enviado ao MinIO Paiol:
```bash
./.agent/scripts/upload-paiol-wiki.sh <arquivo> <funcionalidade/pagina>
```
ou via `curl -X PUT --upload-file ... https://paiol.idz.one/wiki/{modulo}/{slug}-{aleatorio}.{ext}`.
- Apenas o arquivo Markdown contendo a URL pública gerada deve ser commitado no repositório.
---
## Exemplos