API Reference: Economia (Moeda Virtual)

Base URL: /api/economia. Todos os endpoints requerem autenticacao.

Cada nucleo configura o nome e sigla da sua moeda virtual (ex: Capixacoins/CC). Os exemplos abaixo usam CC mas a sigla varia por nucleo.

GET /api/economia/extrato

Retorna o historico de transacoes do usuario logado.

Query Params

Param	Tipo	Descricao
`page`	number	Pagina (default: 1)
`limit`	number	Itens por pagina (default: 20)
`origem`	string	Filtrar por origem (EVENTO, TAREFA, LOJA, PLANO, MANUAL, REFERRAL, ESTORNO)

Response 200

{
  "data": [
    { "id": "uuid", "valor": 150, "tipo": "CREDITO", "origem": "TAREFA", "descricao": "Tarefa aprovada: ...", "criado_em": "..." }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 47, "totalPages": 3 }
}

GET /api/economia/saldo

Retorna saldo atual do usuario.

Response

{ "saldo": 3500 }

GET /api/economia/painel

Painel anti-inflacao com totais de moeda do nucleo em circulacao.

Permissao: ADMINISTRADOR

Response

{
  "totalEmitidas": 150000,
  "totalGastas": 45000,
  "saldoCirculacao": 105000,
  "multiplicadorGlobal": 1.5,
  "tetoMensalCC": 5000
}

POST /api/economia/ajuste-manual

Credita ou debita moeda do nucleo de um usuario. Justificativa obrigatoria (aparece no extrato).

Permissao: ADMINISTRADOR

Body

{
  "usuarioId": "uuid",
  "valor": 500,
  "tipo": "CREDITO",
  "justificativa": "Bonus por participacao especial no evento X"
}

PATCH /api/economia/multiplicador

Define o multiplicador global de moeda do nucleo. Ex: 1.5x faz tarefa de 100 moedas pagar 150.

Permissao: ADMINISTRADOR

Body

{ "multiplicador": 1.5 }

PATCH /api/economia/teto-mensal

Define o limite maximo de moeda do nucleo que um membro pode ganhar por mes. Null remove o teto.

Permissao: ADMINISTRADOR

Body

{ "teto": 5000 }