@orbent/control
v1.0.2
Published
Plano de Controle Soberano da Plataforma Orbent.
Readme
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.
