Import your bank movements (or connect your bank), let AI categorize them, issue Verifactu invoices, and instantly see your VAT, estimated income tax and cash-flow forecast — the numbers your accountant asks for, without the spreadsheet.
Plus a field toolkit for electricians: design an installation to the Spanish REBT, trace the real floor plan, and turn it into a certificate and a quote.
⚠️ Work in progress. This project is being built in public, step by step, with every decision documented indocs/. Follow the build indocs/DEVLOG.md.
🌐 Live demo: cuentia-snowy.vercel.app
Register (or log in) and click “Load sample data” to explore with realistic movements. The backend runs on a free tier, so the very first request may take ~30–60 s to wake up.
| Dashboard — spending, income vs expenses, cash-flow forecast | Taxes — VAT & IRPF (modelo 130) with deadline alert |
|---|---|
 |
 |
Every freelancer (autónomo) and small business in Spain faces the same monthly grind: export the bank statement, open a spreadsheet, and manually tag each movement — supplier, income, expense category, VAT — so they know how much tax they owe and whether they'll make payroll. It is tedious, error-prone, and most of them only find out their real numbers when the quarter is already closing.
Cuentia turns raw bank movements into financial clarity — and then covers the whole billing cycle:
- Import movements — CSV, Spanish Norma 43, or real open banking (GoCardless / PSD2).
- Auto-categorize each movement with AI (supplier, expense category, income).
- Invoicing with Verifactu — issue invoices sealed into a tamper-evident SHA-256 hash chain, each with its AEAT QR, its RegistroAlta XML and a downloadable PDF (Spain's 2026 e-invoicing rules).
- Billing module — customers, a reusable services catalog, and quotes that convert into a sealed invoice (idempotently: converting twice never duplicates).
- Tax panel: output vs input VAT, estimated IRPF, and quarterly deadline alerts (modelo 130 / 303).
- Cash-flow forecast for the next 30 / 60 / 90 days.
- Ask in plain language: "How much did I spend on software this quarter?"
- Bring your own keys — each user stores their own AI and open-banking credentials, encrypted with AES-256-GCM. The plaintext never travels back to the browser.
A vertical built on top of the same billing core, because an electrician's paperwork is their invoicing:
- Installation designer (REBT ITC-BT-25) — from the rooms and their loads, it derives the electrification grade, the power to contract, circuits C1–C12 with their sections and breakers, the minimum points per room, the bill of materials, and a single-line diagram.
- Floor plan (2D) — drop the real scanned plan underneath, calibrate its scale against a known dimension, and trace each room as a polygon (an L-shaped living room, a corridor). Place the panel and the devices; cable is then measured from actual positions, not estimated from floor area.
- Compliance check — every socket declares the circuit that feeds it, and the plan is contrasted, room by room, against the minimum points of use of ITC-BT-25 table 2. Fall short and it says exactly what is missing ("cocina: 3 more · base 16 A 2p+T (lavadora, lavavajillas, termo)") — and refuses to issue the certificate.
- Main panel (CGMP) — drawn from the devices actually placed: circuits sized by the points connected and split at the maximum of table 1, the IGA rated from the contracted power, one differential per five circuits, and the DIN modules counted so the enclosure can be ordered.
- 3D view — the same layout extruded into walls, with the devices at realistic heights.
- Export & chain it — download the finished plan as a PNG, turn the design into an electrical installation certificate (CIE) ready to sign with AutoFirma, or turn the bill of materials into a quote → invoice.
Every issued invoice generates a registro de alta carrying a SHA-256 fingerprint chained to the
previous one (the layout of Orden HAC/1177/2024). Altering any past invoice breaks every hash after it,
and GET /api/invoices/verify walks the chain to prove — or disprove — its integrity. It's the kind of
correctness-critical, spec-driven feature that shows up in real fintech: exact money in integer cents,
gapless numbering, and a cryptographic audit trail. See guide 25.
The app used to compute "minimum points per room" from a plausible-looking rule someone had invented. Going to the Ministry's Guía Técnica GUÍA-BT-25 and reading tabla 2 turned up five discrepancies — including a kitchen that required no sockets at all (the regulation asks for nine, across four circuits), and a rule that promoted a dwelling to electrificación elevada past five circuits when the text says the opposite: what it needs is an extra differential. That one silently raised the customer's contracted power from 5 750 W to 9 200 W. Domain software is only as correct as its source. See guide 37.
An electrician on site has a phone, not a scanner, and a photo of a plan is rotated and keystoned. A two-point calibration can only recover scale, so a metre still measures differently across the sheet. Cuentia asks for the four corners, solves the homography by Gaussian elimination and remaps the image with bilinear sampling — an exact projective transform, not an approximation. A self-intersecting or near-flat quad still yields a solvable system while collapsing the image, so convexity is checked separately. Afterwards, two perpendicular dimensions check out at once: that is what makes the measured cable trustworthy. See guide 34.
I'm a web development student with a second diploma in Business Administration & Finance. This project sits exactly on that intersection: the hard part isn't the CRUD, it's knowing what the numbers mean — VAT mechanics, Spanish tax models, what a healthy cash flow looks like. That domain knowledge is the core of the product.
Product sense matters, so let's be honest about scope. Cuentia started as a "vitamin" (visibility: categorized movements, an estimate of VAT/IRPF, a cash-flow forecast) and now reaches toward the "painkiller" problems freelancers actually pay to solve:
- it issues Verifactu invoices with a tamper-evident hash chain, QR, XML and PDF;
- it can import movements straight from the bank via open banking (GoCardless);
- it turns an electrician's design into a certificate and a quote, which is billable paperwork.
What still separates it from a product people pay for is the last mile of trust and action:
- Real fiscal submission to the AEAT — the Verifactu SOAP web service. Deliberately out of scope here: Cuentia isn't a registered issuer, so the QR/XML target the AEAT test host (a faithful demonstration, not a live filing). See ADR 0003.
- An accurate, per-line tax engine (deductibility rules, exemptions, reverse charge…).
- A live open-banking run — the integration is built and unit-tested against the documented API, but ships behind a credentials flag (creating GoCardless app credentials needs real KYC data). See guide 27.
- The installation designer is a pre-dimensioning aid, not a signed project, and the CIE is filed by the installer at the GVA sede — Cuentia never touches the signing certificate. See guide 32. The compliance check verifies the number of points of use, which is all a drawing can prove; sections, earthing and the measurements a certificate also rests on are outside it. No software can promise a certificate is never returned.
- Filing / accountant integration — validated with real users first.
The goal was never revenue: it's to demonstrate building serious business software at the intersection of web development and finance — and knowing exactly where that product line sits is part of the skill.
- Backend: PHP · Symfony · Doctrine · PostgreSQL
- Frontend: React · Vite · Three.js (react-three-fiber, lazy-loaded)
- AI: Anthropic Claude (categorization + natural-language queries)
- e-invoicing: Verifactu — SHA-256 hash chain · QR (
endroid/qr-code, SVG) · RegistroAlta XML · PDF (Dompdf) - Open banking: GoCardless Bank Account Data (PSD2), behind a feature flag
- Secrets: per-user credentials encrypted with AES-256-GCM (bring-your-own-key)
- Quality: PHPUnit (80 unit + integration tests) · GitHub Actions CI — including a job that applies every
migration to a clean PostgreSQL and asserts the schema matches the entities · bilingual docs (
docs/guide/00→37)
Requirements: PHP, Composer, Symfony CLI, PostgreSQL and Node.js (see guide 00). Then:
powershell -ExecutionPolicy Bypass -File .\start-dev.ps1This starts PostgreSQL, the Symfony API (:8000) and the Vite dev server, then open
http://localhost:5173. The first time, install dependencies (cd backend; composer install
and cd frontend; npm install) and create the database (see guide 03).
The servers only respond while they are running — if the page says connection refused, start them.
| Doc | What it is |
|---|---|
| docs/ROADMAP.md | Phased plan, from MVP to full product |
| docs/ARCHITECTURE.md | System design and domain model |
| docs/DEVLOG.md | Running log of every step taken |
| docs/decisions/ | Architecture Decision Records (ADRs) |
| docs/guide/ | 38 step-by-step guides, in English and Spanish |
Cada autónomo y pequeña empresa en España sufre la misma rutina mensual: exportar el extracto del banco, abrir una hoja de cálculo y etiquetar a mano cada movimiento —proveedor, ingreso, categoría de gasto, IVA— para saber cuánto impuesto debe y si llegará a fin de mes. Es tedioso, propenso a errores, y la mayoría solo descubre sus números reales cuando el trimestre ya se está cerrando.
Cuentia convierte los movimientos bancarios en claridad financiera — y cubre el ciclo de facturación:
- Importar movimientos — CSV, Norma 43, o banca abierta real (GoCardless / PSD2).
- Categorización automática de cada movimiento con IA (proveedor, categoría de gasto, ingreso).
- Facturación con Verifactu — emite facturas selladas en una cadena de hash SHA-256 inalterable, cada una con su QR de la AEAT, su XML RegistroAlta y un PDF descargable (normativa de 2026).
- Módulo de facturación — clientes, catálogo de servicios reutilizable y presupuestos que se convierten en factura sellada (de forma idempotente: convertir dos veces nunca duplica).
- Panel fiscal: IVA repercutido vs soportado, estimación de IRPF y avisos de trimestre (modelo 130 / 303).
- Previsión de tesorería a 30 / 60 / 90 días.
- Preguntar en lenguaje natural: "¿cuánto gasté en software este trimestre?"
- Tus propias claves — cada usuario guarda sus credenciales de IA y de banca abierta, cifradas con AES-256-GCM. El texto en claro nunca vuelve al navegador.
Un vertical construido sobre el mismo núcleo de facturación, porque el papeleo de un electricista es su facturación:
- Diseñador de instalaciones (REBT ITC-BT-25) — a partir de las estancias y sus cargas deduce el grado de electrificación, la potencia a contratar, los circuitos C1–C12 con sus secciones y magnetotérmicos, los puntos mínimos por estancia, los materiales y un esquema unifilar.
- Plano de planta (2D) — pon debajo el plano real escaneado, calibra su escala con una cota conocida y calca cada estancia como polígono (un salón en L, un pasillo). Coloca el cuadro y los dispositivos: el cable se mide desde las posiciones reales, no se estima por superficie.
- Comprobación de cumplimiento — cada toma declara el circuito que la alimenta, y el plano se contrasta, estancia por estancia, con los puntos mínimos de utilización de la tabla 2 de la ITC-BT-25. Si falta algo lo dice con nombre y apellidos ("cocina: faltan 3 · base 16 A 2p+T (lavadora, lavavajillas, termo)") y se niega a emitir el certificado.
- Cuadro general (CGMP) — dibujado a partir de los dispositivos realmente colocados: circuitos dimensionados por los puntos conectados y desdoblados al máximo de la tabla 1, IGA según la potencia contratada, un diferencial por cada cinco circuitos, y los módulos DIN contados para pedir el envolvente.
- Vista 3D — la misma planta extruida en paredes, con los dispositivos a su altura real.
- Exportar y encadenar — descarga el plano acabado en PNG, convierte el diseño en un Certificado de Instalación Eléctrica (CIE) listo para firmar con AutoFirma, o convierte los materiales en un presupuesto → factura.
Cada factura emitida genera un registro de alta con una huella SHA-256 encadenada a la anterior (el
formato de la Orden HAC/1177/2024). Alterar cualquier factura pasada rompe todos los hashes posteriores, y
GET /api/invoices/verify recorre la cadena para demostrar — o refutar — su integridad. Es el tipo de
función crítica y guiada por especificación que aparece en fintech real: dinero exacto en céntimos enteros,
numeración sin huecos y un rastro de auditoría criptográfico. Ver guía 25.
La app calculaba los "puntos mínimos por estancia" con una regla de aspecto razonable que alguien se había inventado. Ir a la Guía Técnica GUÍA-BT-25 del Ministerio y leer la tabla 2 destapó cinco desviaciones — entre ellas una cocina que no exigía ni un enchufe (la norma pide nueve, en cuatro circuitos) y una regla que pasaba la vivienda a electrificación elevada al superar cinco circuitos, cuando el texto dice justo lo contrario: lo que hace falta es un diferencial adicional. Esa subía en silencio la potencia contratada del cliente de 5 750 W a 9 200 W. El software de dominio es tan correcto como su fuente. Ver guía 37.
Un electricista en obra lleva el móvil, no un escáner, y una foto de un plano sale girada y con perspectiva. Una calibración de dos puntos solo recupera la escala, así que un metro sigue midiendo distinto en cada zona de la hoja. Cuentia pide las cuatro esquinas, resuelve la homografía por eliminación gaussiana y remapea la imagen con muestreo bilineal — una transformación proyectiva exacta, no una aproximación. Un cuadrilátero cruzado o casi plano todavía da un sistema resoluble mientras colapsa la imagen, así que la convexidad se comprueba aparte. Después, dos cotas perpendiculares cuadran a la vez: eso es lo que hace fiables los metros de cable. Ver guía 34.
Soy estudiante de desarrollo web con un segundo título en Administración y Finanzas. Este proyecto está justo en esa intersección: lo difícil no es el CRUD, es saber qué significan los números —la mecánica del IVA, los modelos fiscales españoles, cómo se ve una tesorería sana—. Ese conocimiento del dominio es el núcleo del producto.
El criterio de producto importa, así que seamos honestos con el alcance. Cuentia empezó como una "vitamina" (visibilidad: movimientos categorizados, una estimación de IVA/IRPF, una previsión de tesorería) y ahora se acerca a los problemas "analgésico" por los que un autónomo paga de verdad:
- emite facturas Verifactu con cadena de hash inalterable, QR, XML y PDF;
- puede importar movimientos directamente del banco vía banca abierta (GoCardless);
- convierte el diseño de un electricista en certificado y presupuesto, que es papeleo facturable.
Lo que aún la separa de un producto de pago es la última milla de confianza y acción:
- Presentación fiscal real ante la AEAT — el servicio web SOAP de Verifactu. Deliberadamente fuera de alcance: Cuentia no es un emisor registrado, así que el QR/XML apuntan al host de pruebas de la AEAT (una demostración fiel, no una presentación real). Ver ADR 0003.
- Un motor fiscal preciso por línea (deducibilidad, exenciones, inversión del sujeto pasivo…).
- Una ejecución en vivo de banca abierta — la integración está construida y testeada contra la API documentada, pero va tras un flag de credenciales (crearlas exige datos KYC reales). Ver guía 27.
- El diseñador es una ayuda de predimensionado, no un proyecto firmado, y el CIE lo presenta el instalador en la sede de la GVA — Cuentia nunca toca el certificado de firma. Ver guía 32. La comprobación verifica el número de puntos de utilización, que es todo lo que un dibujo puede demostrar; las secciones, las tierras y las mediciones en las que también se apoya un certificado quedan fuera. Ningún software puede prometer que un certificado no sea devuelto.
- Integración de presentación / gestor — validado antes con usuarios reales.
El objetivo nunca fue facturar: es demostrar que sé construir software de negocio serio en la intersección entre desarrollo web y finanzas — y saber exactamente dónde está esa línea de producto forma parte de la habilidad.
- Backend: PHP · Symfony · Doctrine · PostgreSQL
- Frontend: React · Vite · Three.js (react-three-fiber, en carga diferida)
- IA: Anthropic Claude (categorización + consultas en lenguaje natural)
- Factura electrónica: Verifactu — cadena de hash SHA-256 · QR (
endroid/qr-code, SVG) · XML RegistroAlta · PDF (Dompdf) - Banca abierta: GoCardless Bank Account Data (PSD2), tras un flag de función
- Secretos: credenciales por usuario cifradas con AES-256-GCM (bring your own key)
- Calidad: PHPUnit (80 tests unitarios + integración) · GitHub Actions CI — con un job que aplica todas
las migraciones sobre un PostgreSQL limpio y comprueba que el esquema cuadra con las entidades ·
docs bilingües (
docs/guide/00→37)
Requisitos: PHP, Composer, Symfony CLI, PostgreSQL y Node.js (ver guía 00). Después:
powershell -ExecutionPolicy Bypass -File .\start-dev.ps1Esto arranca PostgreSQL, la API Symfony (:8000) y el servidor de Vite; luego abre
http://localhost:5173. La primera vez, instala dependencias (cd backend; composer install
y cd frontend; npm install) y crea la base de datos (ver guía 03).
Los servidores solo responden mientras están en marcha — si la página dice connection refused, arráncalos.
| Documento | Qué es |
|---|---|
| docs/ROADMAP.md | Plan por fases, del MVP al producto completo |
| docs/ARCHITECTURE.md | Diseño del sistema y modelo de dominio |
| docs/DEVLOG.md | Diario de cada paso dado |
| docs/decisions/ | Registros de Decisiones de Arquitectura (ADR) |
| docs/guide/ | 38 guías paso a paso, en inglés y español |