{"id":45914437,"url":"https://github.com/danielcastillomera/dashboard-enterprise","last_synced_at":"2026-04-02T11:37:03.577Z","repository":{"id":339706481,"uuid":"1163043394","full_name":"danielcastillomera/dashboard-enterprise","owner":"danielcastillomera","description":"Sistema de gestión empresarial pensado para negocios de comercio y retail en Ecuador. Permite llevar el control completo de ventas, compras, inventario, clientes y pedidos desde un solo lugar, con un diseño moderno y fácil de usar. Incluye un módulo de facturación electrónica que genera comprobantes en formato XML.","archived":false,"fork":false,"pushed_at":"2026-03-17T04:29:09.000Z","size":1314,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-17T17:35:17.309Z","etag":null,"topics":["dashboard","erp","facturacion-electronica","inventory-management","multi-tenant","nextjs","postgresql","prisma","react","retail","saas","sri-ecuador","supabase","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://dashboard-enterprise-kappa.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/danielcastillomera.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-21T02:28:47.000Z","updated_at":"2026-03-17T04:28:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/danielcastillomera/dashboard-enterprise","commit_stats":null,"previous_names":["danielcastillomera/dashboard-enterprise"],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/danielcastillomera/dashboard-enterprise","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielcastillomera%2Fdashboard-enterprise","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielcastillomera%2Fdashboard-enterprise/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielcastillomera%2Fdashboard-enterprise/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielcastillomera%2Fdashboard-enterprise/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danielcastillomera","download_url":"https://codeload.github.com/danielcastillomera/dashboard-enterprise/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielcastillomera%2Fdashboard-enterprise/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31305696,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T09:48:21.550Z","status":"ssl_error","status_checked_at":"2026-04-02T09:48:19.196Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dashboard","erp","facturacion-electronica","inventory-management","multi-tenant","nextjs","postgresql","prisma","react","retail","saas","sri-ecuador","supabase","tailwindcss","typescript"],"created_at":"2026-02-28T07:12:57.810Z","updated_at":"2026-04-02T11:37:03.572Z","avatar_url":"https://github.com/danielcastillomera.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dashboard Enterprise\n\nSistema de gestión empresarial multi-tenant con facturación electrónica SRI Ecuador.\n\n## Stack Tecnológico\n\n| Capa | Tecnología |\n|------|-----------|\n| Frontend | Next.js 16, TypeScript, Tailwind CSS 4 |\n| Backend | Next.js API Routes, Server Actions |\n| Base de datos | Supabase (PostgreSQL) + Prisma ORM |\n| Autenticación | Supabase Auth |\n| Email transaccional | Resend |\n| Deployment | Vercel |\n\n## Requisitos Previos\n\n- Node.js \u003e= 18.0\n- npm \u003e= 9.0\n- Cuenta de Supabase (proyecto creado)\n- Cuenta de Vercel (para producción)\n- Cuenta de Resend (para emails — opcional en desarrollo)\n\n## Instalación\n\n```bash\n# 1. Clonar repositorio\ngit clone https://github.com/danielcastillomera/dashboard-enterprise.git\ncd dashboard-enterprise\n\n# 2. Instalar dependencias\nnpm install\n\n# 3. Configurar variables de entorno\ncp .env.example .env.local\n# Editar .env.local con sus credenciales\n\n# 4. Generar cliente Prisma\nnpx prisma generate\n\n# 5. Ejecutar migración en Supabase\n# Copiar contenido de supabase/migration-v2.2.0-complete.sql\n# y ejecutar en Supabase Dashboard \u003e SQL Editor\n\n# 6. Iniciar servidor de desarrollo\nnpm run dev\n```\n\n## Variables de Entorno\n\n```env\n# Supabase\nNEXT_PUBLIC_SUPABASE_URL=https://tu-proyecto.supabase.co\nNEXT_PUBLIC_SUPABASE_ANON_KEY=tu-anon-key\nSUPABASE_SERVICE_ROLE_KEY=tu-service-role-key\n\n# Base de datos\nDATABASE_URL=postgresql://...\nUSE_REAL_DB=true\n\n# Resend (Email)\nRESEND_API_KEY=re_xxxxxxxxxxxx\nEMAIL_FROM=facturacion@tu-dominio.com\n```\n\n## Estructura del Proyecto\n\n```\nsrc/\n├── app/\n│   ├── (auth)/          # Páginas de autenticación\n│   ├── (dashboard)/     # Módulos del dashboard\n│   │   ├── panel/       # Panel de Control\n│   │   ├── clientes/    # Gestión de Clientes\n│   │   ├── compras/     # Módulo de Compras\n│   │   ├── ventas/      # Módulo de Ventas\n│   │   ├── pedidos/     # Pedidos Online\n│   │   ├── productos/   # Catálogo de Productos\n│   │   ├── inventario/  # Control de Inventario\n│   │   ├── facturacion/ # Facturación Electrónica SRI\n│   │   ├── reportes/    # Reportes y Analíticas\n│   │   └── configuracion/ # Configuración del Sistema\n│   └── api/             # API Routes\n├── components/\n│   ├── layout/          # Sidebar, TopNav\n│   └── ui/              # Componentes reutilizables\n├── lib/\n│   ├── billing/         # Lógica de facturación SRI\n│   ├── email/           # Integración con Resend\n│   ├── hooks/           # Custom hooks (useData)\n│   └── db/              # Data source, queries\n└── prisma/              # Schema de base de datos\n```\n\n## Módulos\n\n- **Panel de Control** — KPIs, gráficos de ventas, resumen financiero\n- **Clientes** — CRUD con validación de cédula/RUC Ecuador\n- **Compras** — Registro de compras e inventario\n- **Ventas** — Registro de ventas con selector de productos\n- **Pedidos Online** — Gestión de pedidos con estados\n- **Productos** — Catálogo con categorías, imágenes, precios\n- **Inventario** — Control de stock, alertas de mínimo\n- **Facturación** — Factura electrónica SRI (XML v2.1.0, clave de acceso)\n- **Reportes** — Exportación CSV/PDF\n- **Configuración** — Perfil empresarial, SRI, preferencias regionales\n\n## Facturación Electrónica SRI\n\nEl módulo de facturación cumple con la normativa del Servicio de Rentas Internas de Ecuador:\n\n- Generación de XML v2.1.0\n- Clave de acceso de 49 dígitos (Módulo 11)\n- Numeración secuencial sin gaps\n- IVA 15%, 0%, No Objeto, Exento\n- Formas de pago según Tabla 24 SRI\n- Facturas emitidas son **inmutables** (no editables)\n- Envío automático por email al momento de emitir\n\n## Configuración de Resend (Email)\n\n1. Crear cuenta en [resend.com](https://resend.com)\n2. Obtener API Key desde el dashboard de Resend\n3. Configurar dominio verificado (DNS: SPF, DKIM, DMARC)\n4. Agregar variables de entorno:\n   - `RESEND_API_KEY=re_xxxxxxxxxxxx`\n   - `EMAIL_FROM=facturacion@tu-dominio.com`\n\n## Despliegue en Vercel\n\n```bash\n# Push a GitHub (Vercel auto-deploy)\ngit add .\ngit commit -m \"v2.2.0\"\ngit push origin main\n```\n\nConfigurar las variables de entorno en Vercel Dashboard \u003e Settings \u003e Environment Variables.\n\n## Scripts\n\n| Comando | Descripción |\n|---------|-------------|\n| `npm run dev` | Servidor de desarrollo |\n| `npm run build` | Build de producción |\n| `npm run start` | Iniciar producción |\n| `npx prisma generate` | Generar cliente Prisma |\n| `npx prisma db push` | Push schema a DB |\n\n## Licencia\n\n**Propiedad intelectual de Daniel Fernando Castillo Mera.**\n\nEste software es privado y confidencial. Queda estrictamente prohibida la clonación, copia, distribución o uso no autorizado de este proyecto sin previo permiso escrito del titular. Ver archivo [LICENSE](./LICENSE) para términos completos.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielcastillomera%2Fdashboard-enterprise","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanielcastillomera%2Fdashboard-enterprise","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielcastillomera%2Fdashboard-enterprise/lists"}