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

# Prometrômetro

> Endpoints para promessas, metas, etapas e progresso

## Endpoints do Prometrômetro

Base path: `/v1/promises`

<Note>
  Os endpoints abaixo representam a estrutura planejada. A implementação detalhada será gerada durante o desenvolvimento.
</Note>

## Promessas

| Método | Endpoint                    | Descrição                         |
| ------ | --------------------------- | --------------------------------- |
| `GET`  | `/v1/promises`              | Listar promessas (com filtros)    |
| `POST` | `/v1/promises`              | Cadastrar nova promessa           |
| `GET`  | `/v1/promises/{id}`         | Detalhes de uma promessa          |
| `PUT`  | `/v1/promises/{id}`         | Atualizar promessa                |
| `PUT`  | `/v1/promises/{id}/status`  | Atualizar status da promessa      |
| `GET`  | `/v1/promises/{id}/history` | Histórico de evolução da promessa |

## Metas

| Método | Endpoint                            | Descrição                    |
| ------ | ----------------------------------- | ---------------------------- |
| `GET`  | `/v1/promises/{id}/goals`           | Listar metas de uma promessa |
| `POST` | `/v1/promises/{id}/goals`           | Criar meta                   |
| `PUT`  | `/v1/promises/{id}/goals/{goal_id}` | Atualizar meta               |

## Etapas

| Método | Endpoint                                       | Descrição                     |
| ------ | ---------------------------------------------- | ----------------------------- |
| `GET`  | `/v1/promises/{id}/stages`                     | Listar etapas de uma promessa |
| `POST` | `/v1/promises/{id}/stages`                     | Criar etapa                   |
| `PUT`  | `/v1/promises/{id}/stages/{stage_id}`          | Atualizar etapa               |
| `PUT`  | `/v1/promises/{id}/stages/{stage_id}/progress` | Atualizar progresso da etapa  |

## Evidências

| Método   | Endpoint                                    | Descrição                         |
| -------- | ------------------------------------------- | --------------------------------- |
| `GET`    | `/v1/promises/{id}/evidences`               | Listar evidências de uma promessa |
| `POST`   | `/v1/promises/{id}/evidences`               | Registrar evidência               |
| `DELETE` | `/v1/promises/{id}/evidences/{evidence_id}` | Remover evidência                 |