Add RULE SPECs por projecto to Invest vault folder
This commit is contained in:
parent
1e2dd78c29
commit
732c2b2eb4
1 changed files with 60 additions and 0 deletions
60
Invest-MyVexx/RULE-SPECS-POR-PROJECTO-VAULT-FORGEJO.md
Normal file
60
Invest-MyVexx/RULE-SPECS-POR-PROJECTO-VAULT-FORGEJO.md
Normal file
|
|
@ -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/<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.
|
||||||
Loading…
Reference in a new issue