SMB — Sutady Moneybook

SMB (Sutady Moneybook) 2.4.1 es un sistema completo de contabilidad personal basado en SQLite y MCP (Model Context Protocol). Admite de forma nativa la ejecución local en un solo equipo y el guardado sin conexión, y también permite el acceso seguro entre redes mediante Cloudflare Tunnel; la única fuente de datos del libro de cuentas es el SQLite local, sin depender de bases de datos externas en la nube, con control total de los datos.

Funcionalidades implementadas

• Registro rápido de ingresos/gastos, registrando solo la fecha de ocurrencia; el importe se guarda como entero en "céntimos".

• Categorías totalmente personalizables, desactivación, migración o eliminación permanente de categorías, facturas mensuales/anuales, filtros de búsqueda, papelera global de 30 días y exportación CSV/JSON.

• Tendencias semanales, mensuales y anuales, desglose por categorías, composición de categorías y comparación de progreso con el mismo periodo anterior.

• Resumen de consumo de DeepSeek, crecimiento anómalo, sugerencias de ahorro, estructura de categorías y preguntas personalizadas; el programa se encarga de los números y el modelo solo de la interpretación; actualmente no se envían notas de las cuentas a modelos externos.

• MCP estándar sobre Streamable HTTP; la página web puede alternar entre "modo de confirmación" y "modo de control directo". El modo directo puede gestionar cuentas, categorías, préstamos, suscripciones, IA, copias de seguridad y zona horaria, y conserva un registro de operaciones reversibles de 30 días.

• SQLite WAL＋synchronous=FULL, instantáneas previas a la migración, copias de seguridad diarias de integridad/claves foráneas, cifrado con clave pública age y carga a Google Drive.

• Protección de doble capa con Cloudflare Access, instalación PWA, inicio automático al iniciar sesión en Windows y script auxiliar de reinicio tras fallos.

• Cuatro temas, cuatro fondos de página integrados y una imagen de fondo personal que solo se guarda en el dispositivo actual. La imagen personal se comprime en el navegador y se le eliminan los metadatos; se puede volver temporalmente a los fondos integrados sin que se elimine.

• Página de inicio de información priorizando la consulta: el periodo y el tipo de ingresos/gastos se guardan en la URL, y al actualizar o volver desde la factura por categorías se mantiene la posición de visualización original.

• En el móvil se usa un resumen compacto, conmutación entre desglose/composición, navegación inferior fija y cajón de filtros de facturas; durante la búsqueda se conserva la lista anterior para evitar parpadeos de contenido.

• Las fechas de todo el sitio siguen la zona horaria del libro de cuentas configurada; cuando la zona horaria del ordenador y la de Android difieren, "hoy", el mes predeterminado y el periodo de análisis de IA siguen siendo coherentes.

• Módulo independiente de "asuntos" para gestionar préstamos que otros me deben, reembolsos parciales y suscripciones en CNY/USD. Los asuntos no entran por defecto en las estadísticas de consumo; solo las cuentas ordinarias asociadas activamente o creadas a la vez afectan a los gráficos.

• Los préstamos admiten desactivación del prestatario, reembolso parcial, liquidación automática y papelera de 30 días; las suscripciones admiten oferta del primer periodo, ciclos mensuales/anuales/personalizados, confirmación de vencimiento, historial de pagos y recordatorios dentro de la aplicación.

• Cada mes se puede establecer un presupuesto total en RMB y presupuestos por categoría; el presupuesto no se traslada ni bloquea el registro, y la página de información muestra lo usado, lo restante, la previsión y los riesgos por categoría.

• El "chequeo del libro de cuentas" usa reglas deterministas para señalar posibles duplicados, gastos elevados, riesgos de presupuesto, renovaciones pendientes de confirmar y anomalías de asociación; la verificación no modifica cuentas automáticamente, y la IA solo explica los hechos que el programa descubre.

• El menú de la aplicación tras la instalación en Android/Windows ofrece un acceso directo de "registrar una cuenta"; OpenClaw admite la escritura atómica de hasta 20 cuentas de una vez y su revocación en bloque.

• El registro de préstamos usa un selector de prestatario único y buscable; el nuevo prestatario se guarda en la misma transacción que el préstamo. Los registros activos con el mismo nombre se reutilizan; los desactivados deben restaurarse primero.

• El reintento de propuestas de OpenClaw no crea elementos pendientes de confirmación duplicados; el centro de operaciones permite consultar los cambios de campos y los estados de error según sea necesario. El chequeo del libro de cuentas también se puede consultar de solo lectura mediante MCP, sin devolver notas.

• Módulo opcional de "fondos" que registra cuentas en RMB, movimientos de saldo, transferencias entre cuentas, comisiones, calibración de saldo y reembolsos completos; el total de fondos no incluye préstamos pendientes de cobro, inversiones ni ingresos futuros.

• Las cuentas históricas anteriores a la activación del seguimiento de fondos no se rastrean retroactivamente; tras la activación, los ingresos/gastos ordinarios se vinculan a cuentas, y el saldo se calcula a partir del saldo inicial y los movimientos de fondos aditivos, sin mantener una segunda fuente de verdad del saldo.

• OpenClaw puede consultar y gestionar con precisión cuentas, transferencias, calibraciones y reembolsos; todas las escrituras directas siguen usando el requestId idempotente, y los nombres de cuenta ambiguos se rechazan.

Las operaciones reales de "asuntos", las reglas de vinculación antes y después de activar fondos y los permisos de OpenClaw se describen en la Guía de uso de préstamos y suscripciones. La activación de cuentas, el impacto en fondos, los reembolsos y los avisos del chequeo se describen en la Guía de uso y mantenimiento del seguimiento de fondos.

Related MCP server: ExpenseTracker MCP Server

Información y facturas

• El "desglose por categorías" de la información se usa para comparar la posición, el importe y la variación relativa al periodo anterior de las categorías; la "composición de categorías" se usa para ver el gráfico circular, los importes y los porcentajes; ambos no se muestran a la vez.

• La composición de categorías muestra de forma completa todas las categorías con importe en el periodo actual, sin fusionarlas en "otros"; cada sector y leyenda permite profundizar hasta la factura correspondiente.

• La página de facturas tiene cuatro entradas al mismo nivel: "Registros recientes", "Factura mensual", "Factura anual" y "Papelera". La papelera abarca todas las fechas y se ordena por hora de eliminación, sin heredar el mes de la última visita.

• Las URL antiguas siguen siendo compatibles: /bills abre los registros recientes; /bills?view=ledger&period=month&anchor=... abre la factura mensual; cambiar period a year abre la factura anual; /bills?view=trash abre la papelera global.

• La eliminación normal conserva los datos durante 30 días y permite restaurarlos. Las cuentas de la papelera se pueden eliminar permanentemente; la gestión de categorías en los ajustes también permite eliminar permanentemente una categoría y todas sus cuentas tras mostrar el alcance del impacto y confirmar el nombre. La eliminación permanente es irreversible, pero los asuntos de préstamos o suscripciones asociados se conservan y se desvinculan automáticamente del libro de cuentas.

Actualización de páginas y fondo personal

• Mientras la página está abierta, los datos del libro de cuentas de la página actual se sincronizan cada 30 segundos; al volver a enfocar la ventana o recuperar la red también se sincroniza de inmediato.

• La PWA comprueba una nueva versión cada minuto y, al detectarla, se actualiza automáticamente si no hay formularios en edición. También se puede pulsar "Comprobar y actualizar" en "Ajustes → Estado de ejecución".

• Cuando caduca la sesión de Cloudflare, usa "Volver a iniciar sesión" en la página; no elimines las cookies del sitio ni borres los datos del sitio. "Volver a iniciar sesión" y "Comprobar y actualizar" solo reemplazan la caché del programa PWA, conservando las cookies de sesión, las preferencias de apariencia y el fondo personal de IndexedDB; solo al borrar todos los datos del sitio se elimina la imagen personal del dispositivo actual.

• Elegir "Puro, Papel, Textura, Niebla" desactiva temporalmente la imagen personal, pero la imagen se conserva en el dispositivo actual y se puede restaurar en cualquier momento pulsando "Usar imagen".

• En el primer arranque en frío de cada sesión de navegación se muestra una vez brevemente la pantalla de inicio de la marca SMB; al actualizar datos o cambiar de página no se reproduce de nuevo, y si el sistema tiene activada la opción "Reducir animaciones" se omite directamente.

Inicio rápido y ejecución local

Se necesita Node.js 22 o superior.

Opción 1: Inicio con un clic en Windows (muy recomendada)

Haz doble clic directamente en 打开 SMB.cmd en la raíz del proyecto.

• En la primera ejecución se comprueban automáticamente las dependencias, se genera automáticamente la configuración predeterminada de .env a partir de la plantilla y se completa la compilación y el empaquetado;

• A continuación se inicia automáticamente el servicio y se abre la página de inicio de contabilidad en el navegador predeterminado (acceso predeterminado a http://127.0.0.1:8788, modo de un solo equipo sin inicio de sesión).

Opción 2: Inicio manual desde la línea de comandos (multiplataforma: Windows / Linux / macOS)

Abre una terminal en la raíz del proyecto:

# 1. 安装项目依赖
npm install

# 2. 初始化本地配置（默认开启免登录单机模式）
cp .env.example .env

# 3. 运行开发模式（推荐本地体验，支持代码热重载）
npm run dev
# 浏览器访问 http://127.0.0.1:5173

# 或者编译并启动正式生产服务：
npm run build
npm start
# 浏览器访问 http://127.0.0.1:8788

Control de calidad

npm test
npm run typecheck
npm run build

Antes de una actualización oficial se puede crear adicionalmente una instantánea que haya pasado la comprobación de integridad:

npm.cmd run backup:snapshot -- manual-update
npm.cmd run backup:verify-restore

Funciones avanzadas y guía de despliegue

Si solo llevas la contabilidad en un solo equipo personal, no necesitas configurar ningún servicio externo; funciona de fábrica.

Si necesitas las siguientes capacidades avanzadas, puedes configurarlas según la guía correspondiente:

• Contabilidad remota entre redes desde el móvil: mediante Cloudflare Tunnel se consigue el tránsito sin IP pública y la autenticación de identidad con Access; consulta la Guía de despliegue.

• Análisis inteligente de consumo con IA: haz doble clic en 配置DeepSeek密钥.cmd en la raíz o rellena la API Key de DeepSeek en .env para activar la información de consumo y las sugerencias de ahorro.

• Copia de seguridad automática cifrada en la nube desde otra ubicación: configura Google Drive y la clave de cifrado age para subir instantáneas diarias automáticamente; consulta la Guía de recuperación.

• Gestión de fondos y cuentas: movimientos de activos de varias cuentas, transferencias y calibración de saldo; consulta la Guía de seguimiento de fondos.

• Gestión de préstamos y suscripciones: seguimiento de deudas externas, reembolsos parciales y cobros periódicos de suscripciones; consulta la Guía de uso de asuntos.

Directorio

• src/: PWA de React compartida entre móvil y ordenador.

• server/: API de Node, MCP, DeepSeek, fondos, asuntos financieros y servicios de copia de seguridad.

• db/: estructura de tablas de SQLite y migraciones.

• tests/: pruebas de importes, fechas, asuntos, interfaz, IA y MCP.

• scripts/: scripts de inicialización, inicio automático, claves de copia de seguridad y recuperación.

• deploy/: plantillas de configuración sin claves para Cloudflare y OpenClaw.

El archivo privado .env, la base de datos oficial, las copias de seguridad, los registros y los artefactos de compilación están excluidos del control de versiones.

El número de versión solo se mantiene en package.json. Las correcciones y los ajustes visuales incrementan la versión de parche, las nuevas capacidades compatibles hacia atrás incrementan la versión menor, y los cambios de identidad del producto o de contratos incompatibles incrementan la versión mayor; el historial de versiones se encuentra en CHANGELOG.md. Las especificaciones del logotipo y las fuentes editables se encuentran en la Guía de marca.

Las funciones explícitamente pospuestas, como la importación de facturas, la sincronización de saldos de terceros y capacidades de cuentas más complejas, se describen en ROADMAP.md.