npm package: @orbent/control
Description: Plano de Controle Soberano da Plataforma Orbent.
Latest version: 1.0.2

# orbent-control

Plano de Controle Soberano da Plataforma Orbent.

O `orbent-control` governa a plataforma.  
Ele não opera módulos.  
Ele não negocia conveniência.  
Ele não improvisa.

Este repositório representa o **Estado do sistema**.

---

## 🏛️ O que é o orbent-control

O `orbent-control` é o **plano de controle soberano** da plataforma Orbent.

Ele é responsável por:

- governar tenants
- impor regras de acesso (RBAC e Feature Flags)
- controlar segurança, ética e conformidade
- supervisionar billing como mecanismo de bloqueio
- orquestrar automações e inteligência de forma controlada
- garantir auditoria e rastreabilidade total

Se todos os módulos funcionais forem desligados,  
o `orbent-control` **continua operacional**.

---

## ❌ O que o orbent-control NÃO é

O `orbent-control` **não é**:

- produto do cliente
- módulo funcional (RH, Financeiro, Jurídico etc.)
- backend de conveniência
- qualquer forma de camada instrucional voltada ao usuário final
- espaço de experimentação técnica
- lugar para “aproveitar embalo”

Qualquer tentativa de usá-lo como tal é considerada **violação de governança**.

---

## 🧭 Doutrina Oficial

O `orbent-control` opera sob uma doutrina de comando e controle:

- controle acima de conveniência
- segurança acima de fluidez
- auditoria acima de velocidade
- previsibilidade acima de criatividade

Essa doutrina está formalizada em:

📄 `docs/adr/ADR-000-doutrina-fundacional.md`

Este documento é **fundacional e imutável**.

---

## ❄️ Freeze de Escopo (v1.0)

O escopo do `orbent-control` está **congelado desde o nascimento**.

### ✅ Autorizado na v1.0

- Governança global de tenants
- RBAC central e Feature Flags
- Billing Guard (controle de acesso por assinatura)
- Segurança, ética e conformidade (Orbent Shield)
- Auditoria e forensics
- Inteligência sistêmica controlada (Orbent Infinity)
- Integrações de infraestrutura

### ❌ Proibido na v1.0

- Módulos funcionais de negócio
- experiências instrucionais, tutoriais ou fluxos orientativos
- Configuração operacional de módulos
- Relatórios operacionais detalhados
- Lógica de conveniência ou exceções tácitas

Referência obrigatória:

📄 `docs/adr/ADR-001-freeze-v1.md`

---

## 🧱 Hierarquia da Plataforma

A hierarquia da Orbent é inegociável:

**NÍVEL 0 — ORBENT-CONTROL (PLANO DE CONTROLE)**  
Autoridade máxima da plataforma

Abaixo dele podem existir:

- módulos funcionais
- Admins locais de tenant
- camadas operacionais

Nenhum deles governa o `orbent-control`.

---

## 📜 Decisões Técnicas (ADR)

Qualquer decisão estrutural deve:

- ser registrada em ADR
- ser versionada
- indicar impactos e consequências

Decisão sem ADR **não é reconhecida**.

Os ADRs vivem em:

/docs/adr

🔐 Governança de Código
Pull Requests

Todo PR relacionado ao orbent-control deve:

usar o template oficial de PR

respeitar integralmente o Freeze v1.0

não introduzir lógica de módulos

gerar auditoria para ações sensíveis

PR sem template não é revisado.

CI de Governança

O pipeline de CI bloqueia automaticamente PRs que:

violem o freeze

não usem o template

criem ações sem auditoria

alterem RBAC sem justificativa formal

Governança aqui é sistema, não esforço humano.

🛡️ Segurança e Incidentes

A segurança é governada pelo Orbent Shield.

incidentes críticos geram bloqueios automáticos

toda ação é auditada

toda reversão exige ação humana registrada

Referência:

📄 docs/adr/ADR-003-politica-incidentes.md (quando aplicável)

🤖 Inteligência Artificial

A IA da plataforma (Orbent Infinity) não é soberana.

Ela pode:

analisar

alertar

sugerir

automatizar ações reversíveis e auditadas

Ela não pode decidir sobre:

acesso

billing

ética

bloqueios definitivos

Referência:

📄 docs/adr/ADR-002-politica-ia.md

🚨 Regra Final

Nada entra por pressa.
Nada entra sem controle.
Nada entra sem log.

O orbent-control não evolui rápido.
Ele evolui correto.

Quando o plano de controle está sob domínio,
toda a plataforma permanece estável.

Status:
🟢 Fundação estabelecida
❄️ Freeze v1.0 ativo
🏛️ Estado operacional

## Estado do Repositório

Este repositório encontra-se em **repouso institucional**.

A Fase 1 foi encerrada e selada pela tag `v1.0.0-phase1-closed`.
Qualquer evolução futura requer decisão formal registrada em ADR.

Nada evolui por urgência.
Tudo evolui por soberania.