Skip to content

Píer

Ferramenta de captura de regras de negócio através de planilha, montagem de ontologia e criação automática de um miro-sistema para rodar a empresa

Core trick

Profiles spreadsheets deterministically, has an LLM emit a schema-validated operational model with cell-level evidence, and materializes it into a runtime.

Tags

Description

Ferramenta de captura de regras de negócio através de planilha, montagem de ontologia e criação automática de um miro-sistema para rodar a empresa
mateusncardoso/workflow-self-service-build★ 00 forksTypeScriptCreated Aug 19, 2026 · last push Aug 19, 2026

README excerpt

# Fluxo — workflow self-service a partir da operação real

Vertical slice executável que transforma `.xlsx`/`.csv` operacional em uma **Operational IR** validada e a materializa em um runtime comum. O modelo gera configuração; não gera um app por cliente.

## Fluxo funcional

1. upload real para Supabase Storage privado;
2. profiling determinístico de abas, colunas, tipos, nulidade, enums e relações por valores naturais — IDs na planilha não são exigidos;
3. OpenAI Responses API com Structured Outputs, validação semântica, preservação literal de evidências `Aba!Cabeçalho` e no máximo um reparo;
4. fallback determinístico explícito quando não há credencial ou o gate semântico falha;
5. clarificações que aplicam patches append-only e materializam um novo snapshot;
6. runtime com fila de atenção, diretórios, boards, card, fase, histórico, modelo e evidências;
7. automação interna `create_follow_up`, inicialmente `unknown`/desligada, ativada apenas por resposta explícita e executada em `suggest/confirm`, sem efeito externo.

## Stack e decisões

| Camada | Escolha |
|---|---|
| Web | React 19, TypeScript, Vinext |
| Planilhas | `read-excel-file`, Papa Parse |
| Contratos | Zod + validação semântica própria |
| Dados | Supabase Postgres, schema isolado `fluxo_mvp` |
| Arquivos | bucket privado `fluxo-mvp-sources` |
| IA | `gpt-5.6-terra`, reasoning `medium`, Responses API |

O MVP está intencionalmente **sem login**. Cada workspace recebe um capability token aleatório enviado em `

Team