DB Mock — guia prático
1. Abrir a aba DB Mock
Abra um projeto → selecione a aba DB Mock no topo (ao lado de API Mock).
2. Configurar o cluster
No card Cluster PostgreSQL:
| Campo | Padrão | Descrição |
|---|---|---|
| Porta | 5433 | Porta TCP local do Postgres |
Clique em Iniciar cluster. O app sobe um Postgres embarcado e provisiona os bancos habilitados.
3. Criar um banco lógico
Clique em Novo banco e preencha:
| Campo | Exemplo |
|---|---|
| Nome (rótulo) | Catálogo |
| Nome do database | catalogo |
| Usuário | mockflow |
| Senha | mockflow |
Cada banco lógico gera uma connection string própria — mesmo host/porta, database diferente.
4. Definir tabelas
Selecione o banco → Nova tabela:
- Nome da tabela (ex.:
products) - Colunas: nome, tipo, PK, nullable, default
- Seed — array JSON; cada chave = nome da coluna
Exemplo de seed:
[
{ "id": 1, "name": "Notebook Pro 14", "price_cents": 524800, "active": true },
{ "id": 2, "name": "Mouse sem fio", "price_cents": 12900, "active": true }
]5. Aplicar schema e seeds
- Ao iniciar o cluster, tabelas e seeds são criados automaticamente
- Se editar tabelas/seeds com o cluster rodando → clique em Recarregar seeds naquele banco
6. Connection strings
Com o cluster em execução e o banco Pronto, copie:
| Formato | Exemplo |
|---|---|
| URI (pg / psql) | postgresql://mockflow:mockflow@127.0.0.1:5433/catalogo |
| JDBC | jdbc:postgresql://127.0.0.1:5433/catalogo |
Use no application.properties, .env, ou datasource do seu backend.
7. Testar no console SQL
Antes de conectar o backend, rode no console integrado:
SELECT * FROM products;8. Múltiplos bancos
Um projeto pode ter vários bancos (ex.: catalogo + pedidos). Todos compartilham a mesma porta — ideal para simular microserviços com database-per-service.
Dicas
- Chaves do seed = nomes das colunas — se não bater, as linhas ficam nulas
- Recarregar seeds recria as tabelas — dados volátil voltam ao seed (não persiste INSERT manual entre reloads)
- Desabilitar um banco remove ele do provisionamento sem apagar a definição
Onde ficam os dados
~/Library/Application Support/mock-flow-desktop/MockFlowData/ (macOS)
projects/loja-demo/mockflow.json ← definição (tabelas, seeds)
databases/loja-demo/ ← cluster PostgresVoltar
Last updated on