🧠 Memória Azteca

Sistema de memória centralizada para agentes e humanos.

Autenticação

Enviar header: CHAVE: $CHAVE

Criar memória

Campos

Campo	Tipo	Obrigatório	Descrição
titulo	string	sim (min 3)	Título da memória
conteudo	string	sim (min 10)	Conteúdo em Markdown
resumo	string	sim (min 10, max 500)	Resumo curto
categoria	enum	sim	Ver categorias abaixo
criado_por	string	sim	Autor (ex: @ag-back)
tipo	enum	não (default: nota)	nota, adr, solucao-problemas, referencia, procedimento
modulo	string	não	Módulo relacionado (ex: licencas)
tags	string[]	não	Tags livres

curl -s -X POST "https://memoria-ia.idz.one/api/memorias/criar" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: $CHAVE" \
  -d '{
    "titulo": "Padrão de resposta API",
    "conteudo": "A API retorna sempre um objeto com sucesso e dados...",
    "resumo": "Padrão de retorno da API com campos sucesso e dados",
    "categoria": "modulos",
    "tipo": "referencia",
    "modulo": "licencas",
    "tags": ["api", "resposta"],
    "criado_por": "@ag-back"
  }'

Buscar memórias (full-text)

curl -s -X POST "https://memoria-ia.idz.one/api/busca" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: $CHAVE" \
  -d '{"termo": "validação zod"}'

Listar com filtros

curl -s -X POST "https://memoria-ia.idz.one/api/memorias/listar" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: $CHAVE" \
  -d '{"categoria": "solucao-problemas", "modulo": "licencas", "limite": 10}'

Listar por tags

curl -s -X POST "https://memoria-ia.idz.one/api/memorias/listar" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: $CHAVE" \
  -d '{"tags": ["api", "resposta"], "limite": 10}'

Categorias (enum fixo)

modulos | tecnologias | regras-negocio | infraestrutura
decisoes | clientes | solucao-problemas | corporativo

Rotas disponíveis

POST /api/busca              — busca full-text
POST /api/busca/rapida       — busca simplificada (títulos e resumos)
POST /api/memorias/criar     — criar memória
POST /api/memorias/editar    — editar memória
POST /api/memorias/buscar    — buscar por código
POST /api/memorias/listar    — listar com filtros
POST /api/memorias/excluir   — exclusão lógica
POST /api/categorias/listar  — listar categorias (enum fixo)
POST /api/tags/listar        — listar tags
POST /api/tags/populares     — tags mais usadas