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

123 lines
1.9 KiB
Markdown

# Modelo de Datos MVP
## Entity
Persona o empresa.
```json
{
"id": "darwin",
"name": "Darwin Bruna",
"kind": "person",
"rut": "17.194.206-3"
}
```
## Account
Cuenta, tarjeta o billetera.
```json
{
"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.
```json
{
"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.
```json
{
"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.
```json
{
"id": "event:black-spa-10804",
"kind": "real_expense",
"entityId": "muralla",
"amount": { "currency": "CLP", "value": 126616 },
"description": "Gasto Muralla BLACK SPA folio 10804"
}
```
## Link
Enlace entre nodos.
```json
{
"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`