Browser-only Zero backend v1.2.1

Bem-vindo ao
EFSys.

Padronize e organize a forma como a equipe escreve
Especificações Funcionais — sem planilhas, sem docs soltos.

Cada spec segue a mesma estrutura: blocos tipados, fluxos conectados, regras rastreáveis — e tudo exporta num único HTML autocontido.

Use ← → ou clique nos botões abaixo para navegar.

01 — Visão geral

Por que EFSys existe?

O problema

Specs espalhadas em docs, wikis, planilhas e e-mails — sem estrutura nem rastreabilidade.

Cada pessoa escreve de um jeito diferente, dificultando revisão e aprovação.

Regras de negócio misturadas com texto livre — difícil de consumir por devs e QA.

Versões sem controle: ninguém sabe o que mudou entre uma entrega e outra.

A solução

Estrutura padronizada — blocos tipados garantem que toda spec siga o mesmo formato.

Tudo num único HTML — exporta uma spec completa, legível por qualquer pessoa, sem instalar nada.

Snapshots de versão — histórico imutável de cada entrega com diff automático.

100% local — roda direto no navegador, dados no IndexedDB da máquina.

02 — Estrutura

Navegação

Projetos

Lista e criação de EFs — ponto de entrada principal.

Templates de Checklists

Modelos reutilizáveis — crie uma vez, instancie em vários EFs.

Catálogo de Canais

Alimenta as linhas da Matriz Canal × Funcionalidade.

Catálogo de Funcionalidades

Viram as colunas da Matriz Canal × Funcionalidade.

Backup

Importar dados — carrega JSON de outros PCs e restaura o banco inteiro.

Exportar dados — gera um .json com todo o conteúdo atual.

03 — Fluxo completo

Do zero ao documento

1
Criar projeto

Preenche metadados, seções padrão geradas automaticamente

2
Preencher seções

Adiciona e arranja blocos de conteúdo em cada seção

3
Configurar catálogos

Cadastra canais e funcionalidades para alimentar a Matriz

4
Salvar versão

Cria snapshot imutável — marco antes de revisão formal

5
Pré-visualizar

Confere layout e leitura antes de distribuir

6
Exportar HTML

Entrega final — arquivo auto-contido pronto para distribuir

Iterativo: volte a qualquer etapa e salve como nova versão

Compartilhe: exporte o JSON para outros PCs editarem juntos

Reutilize: importe o HTML gerado de volta para editar versões antigas

04 — Fluxo com IA

Gere com Cursor, refine no EFSys

PASSO 1 · CURSOR
Peça a spec com um comando
/spec

Spec técnica completa — fluxos, regras, integrações, casos de erro. Ideal para features complexas.

/spec2

Spec em linguagem menos técnica — mesma estrutura, escrita acessível para stakeholders não-técnicos.

PASSO 2 · OUTPUT
📄
HTML gerado pela IA

Arquivo spec.html autocontido, pronto para importar no EFSys

PASSO 3 · EFSYS
⬆️
Importar e refinar

Edite blocos, insira imagens, adicione regras, salve versões

PASSO 4 · ENTREGA
Exportar HTML final

Spec padronizada, versionada e pronta

/spec e /spec2 são skills do Cursor configuradas no projeto

O HTML gerado pela IA já é compatível com a importação do EFSys

O analista refina o que a IA gerou — em vez de escrever do zero

05 — Projetos

Tela de Projetos

Novo Projeto

Abre o cadastro. Nasce com seções-padrão: Contexto · Canais · Times · Testes · Regras · Escopo.

Importar

Importa um HTML gerado pelo EFSys, tornando possível editá-lo novamente.

Editar

Abre o editor completo do projeto.

Pré-visualizar (👁)

Abre o EF como ficaria na exportação final — HTML em nova aba.

Baixar HTML

Gera e baixa o .html auto-contido — entrega final da EF.

Excluir

Remove o projeto permanentemente. Sem confirmação dupla — cuidado.

06 — Editor

Editor — Layout

Menu Esquerdo

Seções da EF agrupadas na sidebar. Clique para navegar.

Sidebar

Área Principal

Conteúdo da seção selecionada, exibido bloco a bloco.

Conteúdo

Toolbar Superior

Ações globais — status, metadados, versões, exportação.

Ações globais
SEÇÕES
› Contexto
› Canais
› Regras
TOOLBAR ↑
Bloco 1 — Parágrafo
Bloco 2 — Tabela
+ Adicionar bloco
07 — Editor

Editor — Toolbar Superior

Status

Dropdown para indicar o estado — Em revisão, Aprovada, Rejeitada…

Metadados

Código · Tipo · Título · Data/Descrição da versão · Nome · Autor

Histórico

Entradas de versões exibidas no cabeçalho do documento exportado.

Pré-visualizar

Abre a EF em nova aba como ficaria no HTML final.

Salvar como nova versão

Snapshot imutável — marca marcos de mudança entre versões.

Baixar HTML

Gera EF_Tipo_Nome_V1.0.html.

💡

Preencha os metadados cedo — código, nome, autor, tipo. Eles determinam o nome do arquivo na exportação e facilitam o rastreio.

08 — Editor

Seções & Blocos

Seções

Sidebar
  • + Nova Seção — cria seção em branco
  • Cada seção possui:
    • Editar nome / excluir
    • Arrastar para reordenar

Blocos

Área principal
  • + Adicionar bloco — abre a paleta
  • Cada bloco possui:
    • Editar conteúdo
    • Duplicar / Excluir
    • Arrastar para reordenar

Markdown leve em campos de texto

**Negrito**

texto em destaque

`Código`

inline code

![alt](url)

imagem inline

Em parágrafos: cole imagem diretamente ou uma URL de imagem.

09 — Editor

Blocos Especiais

Checklist

Pode ser instanciado a partir de um template cadastrado — sem redigitar do zero. Reutilizável em vários EFs.

Matriz Canal × Funcionalidade

Depende dos catálogos — cadastre-os antes para evitar retrabalho. Cada célula tem 4 estados com click-to-cycle.

✓ Disponível ⚙ Em dev ✗ Indisponível — N/A
</>

HTML Cru

Permite inserir qualquer código HTML diretamente — escape hatch para casos não cobertos pelos outros blocos.

10 — Blocos disponíveis

Paleta completa de blocos

T
Texto
Parágrafo
Lista
Cabeçalho H3
HTML Cru
Glossário
Tabelas
Tabela Genérica
Regras de Negócio
Escopo de Produto
Logs
Alertas
Pontos em Aberto
API
Endpoint Card
Contrato Request
Contrato Response
Contrato Erro
HTTP Header Card
Especial
Diagrama de Fluxo
Cadeia de Resolução
Callout (Info / Aviso / Erro / Ok)
Checklist
Matriz Canal × Func.
Total: 21 tipos de bloco disponíveis na paleta
11 — Versões

Histórico de Versões

🔗

Acesso típico:

#/projetos/<id>/versões

Ver versão

Preview de uma versão antiga em nova aba — leitura somente.

Baixar versão

Gera o HTML de uma versão específica sem alterar a corrente.

Tornar atual

Restaura uma versão antiga como a versão corrente do projeto.

Excluir versão

Disponível para todas as versões exceto a atual.

12 — Dados

Importação & Exportação

Baixar HTML

Entrega final da EF. Auto-contido, sem dependências externas.

Distribuição

Importar EF

Reabre uma EF — apenas HTMLs gerados pelo próprio EFSys.

Edição legado
📤

Exportar Dados

Backup completo. JSON com todos os projetos, catálogos e templates.

JSON backup
📥

Importar Dados

Carrega um JSON e oferece a opção de apagar o banco atual ou mesclar com o conteúdo existente.

Apagar Mesclar
⚠️

Ao importar, você escolhe entre substituir tudo ou mesclar os dados. Se for substituir, exporte antes para preservar o estado atual.

13 — Uso correto

Boas práticas de uso

Preencher metadados cedo

Código, nome, autor e tipo — melhora rastreio e define o nome do arquivo exportado.

Salvar como nova versão em marcos

Antes de grandes mudanças — cria snapshot imutável do estado aprovado.

Catálogos antes da Matriz

Cadastre Canais e Funcionalidades primeiro — evita retrabalho e garante consistência.

Pré-visualizar antes de baixar

Confere layout e leitura antes da entrega — evita reenvio do arquivo.

Buscar antes de duplicar

Achou EF similar? Importe o HTML e edite — reaproveite blocos longos já formatados.

14 — O que não esperar

Limitações

Não é uma wiki multiusuário

Sem login, sem colaboração em tempo real. Compartilhamento é via arquivo — HTML ou JSON.

Importar HTML somente do EFSys

O parser reconhece apenas o formato gerado pelo próprio sistema. HTMLs externos não funcionam.

IndexedDB pode ser apagado pelo navegador

Se o usuário limpar dados do site, o banco é perdido. Faça backups regulares.

💾

Faça backup com frequência. Exportar Dados → salva JSON em local seguro. Custo zero, risco zero.

15 — Resultado final

O que sai do EFSys

EF-042 · Negócio · Aprovado
Minha Feature — API
V1.0 · 01/01/2026 · Autor
VISÃO GERAL
Contexto
Times Envolvidos
Entregáveis
Regras Gerais
CONTRATO
Autenticação
Contrato da API
FLUXOS
Fluxo Principal
Fluxo de Erro
Regras
1. Contexto
Descrição do contexto de negócio da feature, qual problema resolve e quem são os usuários impactados por essa funcionalidade…
POST /v1/recurso/acao
Descrição resumida do que o endpoint faz
⚠ Atenção
Exemplo de regra crítica de negócio que deve ser observada.

Auto-contido

CSS embutido, sem dependências externas. Funciona offline, por e-mail ou Confluence.

Sidebar de navegação

Sumário fixo com todas as seções — navegação imediata em documentos longos.

Reimportável

O HTML gerado pode ser importado de volta no EFSys para edição — mesmo meses depois.

Nome automático

EF_Negocio_CartaoVirtual_V9.html — gerado a partir dos metadados.

Pronto para usar v1.2.1

É isso. 🎉

Qualquer dúvida, consulte o README do projeto ou abra uma issue.

iniciar.bat

inicia o servidor local

🌐

localhost:8080