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

# Coleções (banco do script)

> Declare coleções, regras de acesso e use o banco dentro das funções.

As coleções são o banco de dados do script. Você declara as coleções e quem pode ler e gravar em `supabase/collections.json`.

## collections.json

```json theme={null}
{
  "collections": {
    "notas": { "read": "users", "write": "users" },
    "placar": { "read": "public", "write": "owner" }
  }
}
```

| Regra | Quem pode |
| - | - |
| `owner` | Só o dono do script (padrão quando você não informa) |
| `users` | Qualquer pessoa logada no DoglyTdc |
| `public` | Qualquer pessoa, mesmo sem login |

Limites: até 20 coleções; nome com letras minúsculas, números, `_` e `-`, até 40 caracteres. O arquivo é lido quando o backend é publicado. Se estiver com erro, as coleções anteriores continuam e o erro aparece no resumo da publicação.

## Usar dentro da função

```js theme={null}
function handler(request) {
  const notas = doglytdc.db.collection("notas");
  const nova = notas.insert({ texto: "Oi" });
  const lista = notas.list({ limit: 20, order: "desc", where: { texto: "Oi" } });
  const total = notas.count({ texto: "Oi" });
  return doglytdc.respond(200, { nova, lista, total });
}
```

| Método | O que faz |
| - | - |
| `get(id)` | Um documento, ou `null` |
| `list({ limit, offset, order, where })` | Lista. `limit` de 1 a 100 (padrão 20), `offset` até 10.000, `order` `asc` ou `desc` (padrão `desc`, pela data de criação), `where` com até 10 campos de igualdade |
| `count(where)` | Quantos documentos |
| `insert(data)` | Cria um documento |
| `update(id, data)` | Substitui os dados |
| `delete(id)` | Apaga |

## Formato do documento

```json theme={null}
{
  "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
  "data": { "texto": "Oi" },
  "created_at": "2026-11-06T12:00:00Z",
  "updated_at": "2026-11-06T12:00:00Z",
  "mine": true
}
```

`mine` diz se quem chamou criou o documento. O documento nunca mostra quem o criou.

## Regras importantes

* O documento precisa ser um objeto e ter até **64 KB**.
* Até **10.000 documentos** por coleção.
* `update` e `delete` só funcionam para **quem criou o documento** ou para o dono do script, mesmo que a regra de gravação seja `users` ou `public`.

Erros possíveis: "Coleção … não existe em supabase/collections.json.", "Sem permissão para ler/gravar em …", "Documento não encontrado.", "Documento grande demais (máx. 64 KB).", "Limite de 10000 documentos por coleção.", "Só quem criou o documento (ou o dono do script) pode alterá-lo."

## Pela API

As mesmas coleções e as mesmas regras valem na API: veja [Coleções e documentos](https://docs.doglytdc.dev/pt-BR/scripts/api-reference/collections.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.