@mybuildex/pkg 0.10.3 → 0.12.0

package/README.md

@@ -51,6 +51,40 @@ createAuthMiddleware({
 createTenantMiddleware({getTenantClient, defaultClient, strictTenant: true});
 ```
 
+## 0.12.0 — ACL primeiro, governança junto
+
+**Muda comportamento** (⚠️) em quem registra o `createNetworkPlugin` (v1_settings, v1_acls, v3_peoples, v1_eads). Regra: sem governança, a ACL decide sozinha; com governança, a ACL valida primeiro e a governança em seguida (se a rede não libera, barra mesmo com a permissão da ACL); a governança nunca barra sozinha.
+
+- ⚠️ **Ordem.** A verificação da rede saiu do `preHandler` da instância (que rodava ANTES do guard da ACL, um `preHandler` de rota) para um guard na cadeia de cada rota, instalado no `onRoute` logo depois do guard da ACL: ACL → rede → preHandlers da rota. Quem não tem a permissão recebe o 403 da ACL ("Sem permissão para esta ação"), não o da rede, e a auditoria grava `acl_denied`. O guard da rede segue antes do `setRequest` dos controllers, que recebe o client da réplica.
+- ⚠️ **A governança só barra junto com a ACL.** O 403 da filial exige a ACL em `enforce` na rota (`aclEnforces(request)`, exportado). Rota sem `useModuleAcl`, ACL em `report` ou `ACL_MODE=off`: a rede não barra. A réplica da matriz não depende disso (ela não barra ninguém, só mantém as filiais iguais à matriz).
+- **Core fora do ar.** O cache guarda o último contexto bom de cada escola. Com o core sem responder, tabela fora desse catálogo segue só a ACL; tabela do catálogo (ou escola que nunca carregou o catálogo) leva 503, sempre DEPOIS da ACL. Com a ACL fora do `enforce`, nada de 503.
+- Registrar como antes: depois do `createAclPlugin`, antes da compressão e dos módulos (o `onRoute` só vale para as rotas registradas depois dele).
+- `ACL_MAP` regerado do front: entram `programs` e `projects` (projeto social). Nenhuma entrada existente muda.
+
+## 0.11.0 — governança de rede de escolas (matriz/filial)
+
+Módulo novo, opt-in: API que não registra o plugin não muda nada. Veio da `v1_settings` sem mudança de comportamento (19/10/2026), para as outras APIs ligarem com uma linha.
+
+- **`createNetworkPlugin({ttlMs, enabled, logger})`** — a escola é de rede quando o PRÓPRIO banco tem `configs.key = 'REDE'` com `TRUE` (gravada pelo core Go). Sem a flag o core nem é consultado. Com ela, o papel e as regras vêm do banco core (`my_builder_<env>_core`, por SQL cru qualificado no mesmo pool; env `CORE_DATABASE` sobrescreve):
+  - **filial** — cada ação (`read/add/edit/remove/restore/delete`) numa tabela do catálogo de módulos passa pelas `networks_policies`, **acima** da ACL: nega com 403 mesmo com a permissão do usuário. A ação sai da constante do router (`routeAcl.key` gravada pelo `useModuleAcl`) ou, sem ela, do método HTTP. A tabela é o segmento depois de `/v1/:id_school/`.
+  - **matriz** — pode tudo; o que grava nas tabelas do catálogo é replicado nas filiais com o mesmo id, numa transação única, no `onSend` (antes da resposta). Falha na réplica vira 500 com mensagem clara (a matriz já gravou, nenhuma filial foi alterada).
+  - **standalone** — sem flag, sem vínculo ou rede removida: nada muda.
+  - Core fora do ar numa escola de rede: 503 (fail-closed). Contexto em cache por escola (`NETWORK_CACHE_TTL_MS`, default 30 s). `NETWORK_GOVERNANCE=off` desliga tudo.
+- **Ordem no `loadPlugins`:** depois do `createAclPlugin` (usa a `routeAcl` dele) e **antes** do `createCompressPlugin` (o `onSend` da réplica pode trocar o corpo por erro).
+- **Para o front:** `effectivePermissions(request.network ?? standaloneContext(id))` devolve `{tabela: {read, add, ...}}` — é o que o `GET /v1/:id_school/networks/effective` da `v1_settings` responde.
+- Limitações (como antes): SQL cru na matriz não replica; escrita aninhada em relação só replica a tabela do model chamado; a réplica não entra no `audit_logs`.
+
+```ts
+import {createNetworkPlugin} from "@mybuildex/pkg";
+
+const pluginNetwork = createNetworkPlugin();
+// loadPlugins
+await createAclPlugin({api: settings.PREFIX, mode: "enforce"})(fastify);
+await pluginNetwork(fastify);
+await pluginCors(fastify);
+await pluginCompress(fastify);
+```
+
 ## 0.10.3 — ACL_MAP com split de pagamento
 
 - **`ACL_MAP` regerado do front** com os recursos `pay_split_recipients` (ações do CRUD + `sync`, para o botão "Sincronizar" que grava o recebedor no gateway) e `pay_split_rules`. Sem eles a `v1_payments` em enforce nega as rotas novas para todo mundo (10/10/2026). Nenhuma mudança de código.

package/dist/acl/map.generated.js

@@ -1024,6 +1024,12 @@ exports.ACL_MAP = {
         "restore": ["full", "months.restore", "meses.restaura"],
         "trash": ["full", "months.trash", "meses.lixeira"],
     },
+    "networks": {
+        "access": ["full", "networks.access"],
+        "access_all": ["full", "networks.access_all"],
+        "manage": ["full", "networks.manage"],
+        "menu": ["full", "networks.menu"],
+    },
     "notes": {
         "add": ["full", "notes.add", "notas_pessoa.adiciona"],
         "delete": ["full", "notes.delete", "notas_pessoa.exclui"],
@@ -1934,6 +1940,30 @@ exports.ACL_MAP = {
         "restore": ["full", "profiles.restore", "perfis.restaura"],
         "trash": ["full", "profiles.trash", "perfis.lixeira"],
     },
+    "programs": {
+        "add": ["full", "programs.add", "programas.adiciona"],
+        "delete": ["full", "programs.delete", "programas.exclui"],
+        "edit": ["full", "programs.edit", "programas.edita"],
+        "find": ["full", "programs.find", "programas.detalha"],
+        "list": ["full", "programs.list", "programas.lista"],
+        "menu": ["full", "programs.menu", "programas.menu"],
+        "paginate": ["full", "programs.paginate", "programas.pagina"],
+        "remover": ["full", "programs.remove", "programas.remove"],
+        "restore": ["full", "programs.restore", "programas.restaura"],
+        "trash": ["full", "programs.trash", "programas.lixeira"],
+    },
+    "projects": {
+        "add": ["full", "projects.add", "projetos.adiciona"],
+        "delete": ["full", "projects.delete", "projetos.exclui"],
+        "edit": ["full", "projects.edit", "projetos.edita"],
+        "find": ["full", "projects.find", "projetos.detalha"],
+        "list": ["full", "projects.list", "projetos.lista"],
+        "menu": ["full", "projects.menu", "projetos.menu"],
+        "paginate": ["full", "projects.paginate", "projetos.pagina"],
+        "remover": ["full", "projects.remove", "projetos.remove"],
+        "restore": ["full", "projects.restore", "projetos.restaura"],
+        "trash": ["full", "projects.trash", "projetos.lixeira"],
+    },
     "psychological_anamneses": {
         "add": ["full", "psychological_anamneses.add", "analises_psicologicas.adiciona"],
         "delete": ["full", "psychological_anamneses.delete", "analises_psicologicas.exclui"],