kua-money-trace/docs/data-model.md

1.9 KiB

Modelo de Datos MVP

Entity

Persona o empresa.

{
  "id": "darwin",
  "name": "Darwin Bruna",
  "kind": "person",
  "rut": "17.194.206-3"
}

Account

Cuenta, tarjeta o billetera.

{
  "id": "darwin-bchile-cc-5402",
  "ownerEntityId": "darwin",
  "institution": "Banco de Chile",
  "instrument": "checking_account",
  "currency": "CLP",
  "label": "Cuenta corriente 5402"
}

Instrumentos iniciales:

  • checking_account
  • current_account
  • savings_account
  • credit_card
  • debit_card
  • prepaid_card
  • wallet
  • foreign_account
  • cash

Movement

Movimiento financiero observado.

{
  "id": "mov:darwin-visa-black-spa",
  "date": "2025-12-30",
  "accountId": "darwin-lider-visa-5018",
  "direction": "out",
  "amount": { "currency": "CLP", "value": 126616 },
  "description": "CAFE CULTURA BLACK SPA",
  "counterparty": "BLACK SPA",
  "economicType": "card_charge",
  "beneficiaryEntityId": "muralla"
}

Document

Documento de respaldo.

{
  "id": "doc:black-spa-10804",
  "kind": "dte_invoice",
  "issuerName": "BLACK SPA",
  "issuerRut": "76.xxx.xxx-x",
  "receiverEntityId": "muralla",
  "folio": "10804",
  "documentDate": "2025-12-30",
  "amount": { "currency": "CLP", "value": 126616 }
}

Economic Event

Evento economico real: gasto, ingreso, deuda, reembolso.

{
  "id": "event:black-spa-10804",
  "kind": "real_expense",
  "entityId": "muralla",
  "amount": { "currency": "CLP", "value": 126616 },
  "description": "Gasto Muralla BLACK SPA folio 10804"
}

Enlace entre nodos.

{
  "from": "mov:darwin-bank-income-001",
  "to": "mov:darwin-bank-pay-visa-001",
  "type": "funds",
  "amount": { "currency": "CLP", "value": 126616 },
  "method": "fifo",
  "confidence": "rule",
  "state": "proposed"
}

Estados:

  • proposed
  • approved
  • rejected
  • needs_review

Confianzas:

  • exact
  • strong
  • probable
  • rule
  • manual
  • unknown