> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiparlance.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Emitter PostgreSQL

> @aiparlance/sql — papel schema, nota 15/23, objetivos pass/partial/fail

# Emitter PostgreSQL

|                     |                                                                                                                                   |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Pacote              | `@aiparlance/sql`                                                                                                                 |
| CLI                 | `aip emit sql`                                                                                                                    |
| Papel               | `schema`                                                                                                                          |
| **Nota**            | **15/23** (65%)                                                                                                                   |
| Nível               | Fatia sólida                                                                                                                      |
| Ficha de maturidade | [transpilers/sql/EMITTER\_OBJECTIVES.md](https://github.com/eudameron/aiparlance/blob/main/transpilers/sql/EMITTER_OBJECTIVES.md) |

Avaliado pelo checklist mestre ([55 IDs](https://github.com/eudameron/aiparlance/blob/main/EMITTER_OBJECTIVES.md), v2 · 2026-08-06).

## Resumo

| ✅ Passou | ⚠️ Parcial | ❌ Falhou | ➖ N/A |
| -------- | ---------- | -------- | ----- |
| 15       | 1          | 7        | 32    |

Itens N/A estão fora do papel `schema` e não entram no denominador da nota.

## O que produz

DDL PostgreSQL: `CREATE TABLE`, índices, seeds. SQL principal.

## ✅ Passou

| ID   | Objetivo                                                                                  |
| ---- | ----------------------------------------------------------------------------------------- |
| `A1` | Gerar as estruturas da entidade (types / structs / schemas / tables) a partir de `entity` |
| `A4` | Gerar enums / variantes restritas a partir de `enum(…)`                                   |
| `A5` | Gerar `belongs_to` como FKs ou referências                                                |
| `A6` | Gerar a chave primária implícita `id`                                                     |
| `A7` | Gerar `timestamps` (`created_at` / `updated_at`)                                          |
| `A8` | Gerar campo/coluna `soft_delete` (`deleted_at`)                                           |
| `B1` | Respeitar `required` / `optional`                                                         |
| `B2` | Respeitar `unique`                                                                        |
| `C1` | Schema persistente (DDL ou ORM / modelos de query)                                        |
| `C2` | Índices a partir de `index { }`                                                           |
| `C3` | Seeds a partir de `seed { }`                                                              |
| `C6` | Respeitar o alvo definido em `app.database`                                               |
| `H3` | Golden / CI para `minimal.aip` (ou equivalente no alvo)                                   |
| `H4` | O emit funciona nos examples full-tier correspondentes sem crash                          |
| `H5` | Nomenclatura alinhada à documentação (tabelas no plural, `*_id`, snake\_case)             |

## ⚠️ Parcial

| ID   | Objetivo                                                        |
| ---- | --------------------------------------------------------------- |
| `B4` | Mapear tipos semânticos (`email`, `phone`, …) de forma distinta |

## ❌ Ainda falhando (aplicáveis)

| ID   | Objetivo                                                            |
| ---- | ------------------------------------------------------------------- |
| `A9` | Semântica de soft-delete (leituras padrão filtram linhas deletadas) |
| `B3` | Aplicar `validation { }` além de marcar campos como obrigatórios    |
| `C4` | Migrations versionadas (**up** ordenado)                            |
| `C5` | Migration **down** / rollback                                       |
| `C7` | Transações para writes multi-statement / de workflow                |
| `H1` | Documentação legível de API / domínio                               |
| `H2` | Fixtures ou scaffolds de testes automatizados                       |

Ficha de maturidade completa (incluindo ➖ N/A): [transpilers/sql/EMITTER\_OBJECTIVES.md](https://github.com/eudameron/aiparlance/blob/main/transpilers/sql/EMITTER_OBJECTIVES.md).

## Testes

Vitest do pacote + golden `transpilers/sql/fixtures/minimal.sql`. CI do repo cobre `minimal.aip` e seeds/índices em exemplos ricos.

```bash theme={null}
npm test
node packages/cli/dist/cli.js emit sql examples/blog-crud.aip
```

## Relacionado

* [Visão geral dos emitters](/pt/emitters)
* [EMITTER\_OBJECTIVES mestre](https://github.com/eudameron/aiparlance/blob/main/EMITTER_OBJECTIVES.md)
* [Primeiros emitters](/pt/first-transpiler)
* [Comece aqui](/pt/getting-started)