English Français العربية

io.github.ilopezluna/factura-luz

السجل الرسمي الإنتاجية

Lee y explica facturas de la luz españolas (QR de la CNMC). Todo en local.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package factura-luz-mcp
Claude Code 
claude mcp add factura-luz -- npx -y factura-luz-mcp@0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "factura-luz": {
            "command": "npx",
            "args": [
                "-y",
                "factura-luz-mcp@0.1.0"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Entiende tu factura
  2. Stack
  3. Requisitos
  4. Desarrollo
  5. Scripts
  6. Estructura
  7. Despliegue

Entiende tu factura

Aplicación 100% cliente (sin backend) que explica tu factura de la luz. Sube tu factura (PDF o imagen), el navegador lee el código QR de la CNMC y te muestra un desglose claro de lo que estás pagando: potencia, energía, impuestos y contrato.

👉 Pruébala en vivo: entiende-tu-factura.com

Privacidad: todo el procesamiento ocurre en tu navegador. Tu factura nunca se envía a ningún servidor.

Stack

  • React 19 + Vite + TypeScript
  • Tailwind CSS v4
  • Extracción de QR/PDF con jsqr + pdfjs-dist
  • Tests con Vitest

Requisitos

  • Node.js (ver .nvmrc → 22.20.0)

Desarrollo

npm install
npm run dev        # http://localhost:5173

Scripts

ScriptDescripción
npm run devServidor de desarrollo (Vite)
npm run buildTypecheck + build de producción a dist/
npm run previewSirve el build de producción
npm testTests (Vitest)
npm run typecheckComprobación de tipos sin emitir
npm run formatFormatea con Prettier
npm run validateformat:check + typecheck + test

Estructura

src/
├── lib/cnmc/          # Extracción y cálculo (lógica CNMC propia)
│   ├── extraction/    # scan/pdf (agnósticos) + extractor (navegador) + validadores
│   ├── parsing/       # parseo de parámetros del QR
│   ├── types/         # QrParameters + enums
│   ├── content/       # vocabulario y explicaciones en español
│   ├── format/        # formateo de números en es-ES
│   ├── utils/         # cálculo de costes y análisis de potencia
│   └── __tests__/     # tests de lógica pura
├── styles/            # Tailwind v4 + design tokens
├── App.tsx
└── main.tsx

Solo extraction/extractor.ts depende del navegador; extraction/scan.ts y extraction/pdf.ts no tocan el DOM.

Despliegue

Push a main despliega automáticamente a GitHub Pages (.github/workflows/deploy.yml), disponible en **https://entiende-tu-factura.com**. El base de Vite es relativo (./), por lo que funciona tanto en usuario.github.io/<repo>/ como en un dominio propio.

الأسئلة الشائعة

ما هو io.github.ilopezluna/factura-luz؟

Lee y explica facturas de la luz españolas (QR de la CNMC). Todo en local.

كيف أثبّت io.github.ilopezluna/factura-luz؟

يعمل على جهازك. في Claude Code: claude mcp add factura-luz -- npx -y factura-luz-mcp@0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ilopezluna/factura-luz إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.ilopezluna/factura-luz مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون io.github.ilopezluna/factura-luz؟

ينشره ilopezluna. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.