Motor de Geração v1.0.0

ISE - Institutional Software Engine

De requisitos em linguagem natural a sistemas completos em produção. Backend, frontend, banco de dados e orquestração Docker - tudo gerado, validado e auto-corrigido automaticamente.

Pipeline de Geração

O ISE transforma texto em sistemas funcionais através de um pipeline determinístico de 6 fases, cada uma com validação e gates de segurança.

1

Intake & Normalização

Captura input (texto/IDL/Draft), normaliza, classifica blueprint e extrai requisitos.

SRS.json
2

Domain Modeling

Transforma SRS em IR (Intermediate Representation) com entidades, campos e regras.

IR.json
3

Contract Generation

Gera OpenAPI 3.0 com rotas CRUD e RBAC com roles e permissões.

OAS.yaml + RBAC.json
4

Planning & Patching

Gera PLAN com tasks ordenadas e aplica patches no repositório.

PLAN.json + Patches
5

Build & Fix Loop

Compila frontend (npm) e backend (Maven). Auto-corrige erros em até 3 tentativas.

Build OK / Fixed
6

Release Mode

Docker Compose up, smoke tests e validação de readiness. Sistema em produção.

Running

Componentes Principais

Arquitetura modular com agentes especializados, validadores e gates de segurança.

🎯

Intake Layer

Captura e processamento de requisitos com gramática PT-BR.

  • Normalizer (20k chars max)
  • Blueprint Classifier
  • Requirements Analyst
  • SRS Validator Gate
🧠

Agent Layer

Agentes especializados para geração de artefatos.

  • Domain Modeler (SRS → IR)
  • Contracts Agent (IR → OAS + RBAC)
  • Planner Agent (IR → PLAN)
  • Fix Loop Agent
🛡️

Validator Layer

7 gates de validação para garantir integridade.

  • SRS / IR / OAS / RBAC / PLAN
  • Policy Validator (cross-check)
  • Build Validator (npm/mvn)
  • Contract Gate (SHA256)
⚙️

Patch Engine

Aplicação segura de patches com proteção absoluta.

  • SLOT_MARKERS system
  • Path traversal protection
  • Max rewrite ratio (80%)
  • Rollback automático
📊

Observability

Rastreamento completo de execução e integridade.

  • Contract Ledger (SHA256)
  • Patch Manifest
  • Telemetry Emitter
  • Run Logs versionados
🚀

Release Layer

Deploy automatizado com smoke tests e rollback.

  • Docker Compose Validator
  • Smoke Runner (CRUD tests)
  • Release Checklist
  • Diagnostic Reports

Artefatos Gerados

Cada execução produz artefatos versionados com hashes SHA256 para rastreabilidade completa.

INPUT

Texto / IDL

→

SRS

Requisitos

→

IR

Domínio

→

OAS

API Contract

→

RBAC

Permissões

→

PLAN

Tasks

→

CODE

Repositório

SRS - Software Requirements

Requisitos estruturados com entidades, campos, regras de negócio e requisitos não-funcionais.

srs.schema.json

IR - Intermediate Representation

Modelo de domínio com entidades, relacionamentos, regras e páginas UI.

ir.schema.json

OAS - OpenAPI Specification

Contrato da API com 5 rotas CRUD por entidade (list, create, get, update, delete).

OpenAPI 3.0.0

RBAC - Role-Based Access Control

Controle de acesso com roles (authenticated, admin) e permissões por operação.

rbac.schema.json

PLAN - Execution Plan

Plano de execução com 8 tasks por entidade: DB, Model, Repo, Service, Controller, Security, Frontend, API Client.

plan.schema.json

RunLog - Execution Record

Registro completo da execução com Contract Ledger, hashes SHA256 e métricas.

runlog.v1.json

Fix Loop - Auto-Correção

Quando o build falha, o Fix Loop Agent analisa o erro, classifica, gera patch de correção e re-executa. Até 3 tentativas automáticas.

Build Failed

Erro detectado

→

Error Classifier

Analisa tipo de erro

→

Fix Patch Generator

Gera correção

→

Patch Engine

Aplica fix

→

Build OK

final_status: fixed

Tipos de Erro Detectados

JAVA_IMPORT

Cannot find symbol, package not found

JAVA_TYPE

Incompatible types, type mismatch

JAVA_SYNTAX

Syntax errors in Java code

TS_IMPORT

Module not found (TypeScript)

TS_TYPE

Type not found, property missing

SQL_SYNTAX

SQL migration errors

Segurança e Imutabilidade

Proteção absoluta de componentes críticos com bloqueios de path e Contract Gate.

Patch Engine Security

  • ✕ ../engine/**
  • ✕ ../templates/**
  • ✕ Path traversal (../)
  • ✕ Rewrite > 80% do arquivo
  • ✓ ../generated/{project}/**

Frozen Components (v1.0)

  • 🔒 Schemas JSON - versionados
  • 🔒 Templates - versionados
  • 🔒 Políticas - imutáveis
  • 🔒 Engine code - release

Validation Gates

  • 1 GATE 1: Draft schema
  • 2 GATE 2: IDL compile
  • 3 Contract Gate: SHA256
  • 4 SRS/IR/Policy Gates
  • 5 Build Validator

Release Mode - Produção

Com a flag --release, o ISE vai além do build: sobe containers, executa smoke tests e valida readiness.

🏗️

Build Pipeline

Executa pipeline completo (SRS → PLAN → Patches → Build)

🐳

Docker Compose Up

Sobe containers: postgres, backend, frontend (timeout: 300s)

⏱️

Wait for Readiness

Poll a cada 2s, máximo 120s, aguarda todos serviços healthy

🧪

Smoke Tests

Healthcheck (GET /health) + CRUD tests para cada entidade

✅

Release Report

final_status: running - Sistema em produção!

Linha de Comando

Interface CLI simples e poderosa para todas as operações do ISE.

Modo Básico (apenas artefatos) 
# Gerar apenas artefatos (SRS, IR, OAS, RBAC, PLAN)
python main.py --project demo --input "Sistema de cadastro de empresas" --skip-build
Modo Build (com compilação) 
# Gerar artefatos + código + build (npm/mvn)
python main.py --project crm --input "Sistema CRM com clientes e vendas"
Modo Release (produção) 
# Pipeline completo + Docker + smoke tests
python main.py --project erp --input "Sistema ERP financeiro" --release
Input Modes 
# Natural language (padrão)
python main.py --project p1 --input "texto livre" --input-mode natural

# IDL v1
python main.py --project p2 --input spec.idl --input-mode idl

# Auto-detect
python main.py --project p3 --input arquivo.json --input-mode auto

ISE em Números

6

Fases do Pipeline

7

Gates de Validação

3

Tentativas Fix Loop

108

Testes Unitários

5

Rotas CRUD/Entidade

8

Tasks/Entidade