60 lines
2.3 KiB
Markdown
60 lines
2.3 KiB
Markdown
# RULE — SPECs por projecto (Vault + Forgejo)
|
||
|
||
**Data:** 2026-08-05
|
||
**Para:** Roger
|
||
**Obrigatório:** sim
|
||
|
||
---
|
||
|
||
## Regra de ouro
|
||
|
||
**Cada SPEC vive no projecto respectivo**, em **dois** sítios:
|
||
|
||
| Camada | Onde |
|
||
|--------|------|
|
||
| 1. Vault Obsidian (CT130) | `/opt/ligbox-spec-hub/obsidian-vault/<Projecto>/` |
|
||
| 2. Git Forgejo | `https://git.spec.ligbox.com.br/ligbox/<projecto>` |
|
||
|
||
Espelho de trabalho no disco do hub: `/opt/ligbox-spec-hub/repos/<projecto>/`
|
||
|
||
**Proibido:** deixar SPEC solta na raiz do vault, ou meter SPEC de um projecto dentro de `ligbox-ops-platform` (salvo SPECs nativas desse monorepo).
|
||
|
||
---
|
||
|
||
## Mapa projecto → paths
|
||
|
||
| Projecto | Pasta vault | Repo Forgejo |
|
||
|----------|-------------|--------------|
|
||
| Ligbox Ops | `ligbox-ops-platform/` | https://git.spec.ligbox.com.br/ligbox/ligbox-ops-platform |
|
||
| Obsidian Vault (índice) | (raiz + sidebars) | https://git.spec.ligbox.com.br/ligbox/obsidian-vault |
|
||
| **Invest MyVexx** | `Invest-MyVexx/` | https://git.spec.ligbox.com.br/ligbox/invest-myvexx |
|
||
| **ERP Odoo** | `ERP-Odoo-Ligit-MyVexx/` | https://git.spec.ligbox.com.br/ligbox/erp-odoo-ligit-myvexx |
|
||
| **Infra / Network** | `Infra-Network/` | https://git.spec.ligbox.com.br/ligbox/infra-network |
|
||
|
||
GitHub público/org (`itecnologys-tech/...`) é **espelho opcional**; a fonte Spec Hub é o **Forgejo**.
|
||
|
||
---
|
||
|
||
## Checklist ao criar / gravar uma SPEC
|
||
|
||
1. Escolher o **projecto** (não “raiz do vault”).
|
||
2. Escrever em `repos/<projecto>/specs/<id>-<slug>/` (e espelho Obsidian na pasta do projecto).
|
||
3. `git add && commit && push` para `git.spec.ligbox.com.br/ligbox/<projecto>`.
|
||
4. Actualizar vault `obsidian-vault/<Projecto>/` + commit `obsidian-vault` se o portal/Obsidian depender disso.
|
||
5. Regenerar menu: `bash /opt/ligbox-spec-hub/portal/generate-sidebars.sh` (+ refresh portal).
|
||
6. Confirmar link no Vault UI e no Forgejo.
|
||
|
||
---
|
||
|
||
## Naming
|
||
|
||
- Pasta Forgejo/repos: `kebab-case` (`invest-myvexx`)
|
||
- Pasta vault: `Title-Case` ou nome estável do projecto (`Invest-MyVexx`)
|
||
- Ficheiro SPEC: `SPEC-NNN-TITLE.md` ou Spec Kit `specs/NNN-slug/spec.md`
|
||
|
||
---
|
||
|
||
## Excepções
|
||
|
||
- SPECs **Ligbox Ops** (001–045…) ficam em `ligbox-ops-platform` (vault copy + repo).
|
||
- Documentos transversais de índice podem estar no README do vault, com **links** para o projecto — não substituem o alojamento no projecto.
|