diff --git a/Invest-MyVexx/RULE-SPECS-POR-PROJECTO-VAULT-FORGEJO.md b/Invest-MyVexx/RULE-SPECS-POR-PROJECTO-VAULT-FORGEJO.md new file mode 100644 index 0000000..1923929 --- /dev/null +++ b/Invest-MyVexx/RULE-SPECS-POR-PROJECTO-VAULT-FORGEJO.md @@ -0,0 +1,60 @@ +# 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//` | +| 2. Git Forgejo | `https://git.spec.ligbox.com.br/ligbox/` | + +Espelho de trabalho no disco do hub: `/opt/ligbox-spec-hub/repos//` + +**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//specs/-/` (e espelho Obsidian na pasta do projecto). +3. `git add && commit && push` para `git.spec.ligbox.com.br/ligbox/`. +4. Actualizar vault `obsidian-vault//` + 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.