A-Conta ERP · Informe Técnico
Módulo POS — Punto de Venta
Estado de avance y plan de desarrollo para cierre del proyecto
1. Resumen Ejecutivo
52
Completas o funcionales
65,827
Líneas de código Vue
~30
Horas estimadas restantes
Resumen de situación
El módulo POS es el más maduro y complejo del sistema: 54 páginas Vue (65.827 líneas), 45 controllers, 48 modelos y 57 migraciones. Cubre ventas, compras, inventario, cajas, clientes, proveedores, arriendos, mantenciones, restaurante, traspasos y un WMS completo con editor 2D. El 96% de las páginas están completamente implementadas. Las brechas son puntuales: facturación electrónica DTE parcialmente integrada, el módulo Nota de Crédito sin vista frontend, y mejoras pendientes en reportes y el flujo de notas de débito.
2. Estado por módulo
Ventas 100%
- punto-de-venta.vue — POS completo, carrito, descuentos con autorización, impuestos (5.786 líneas)
- posrepuesto.vue — POS repuestos con búsqueda por aplicación marca/modelo (6.077 líneas)
- ventas.vue — Historial, filtros avanzados, PDF/ticket térmico, anulación con NC
- cotizaciones.vue — CRUD con estados, conversión automática a venta
- caja.vue — Procesamiento de tickets pendientes, panel dual
- registros.vue — Reporte con totales neto/IVA/cantidad
Inventario / Bodegas 100%
- articulos/index.vue — CRUD artículos, 5 tabs (general/empaques/códigos/compatibilidades/imágenes), ZXing QR scanner (4.150 líneas)
- bodegas/inventarios.vue — Kardex visual con stock/precio/utilidad
- bodegas/carga-masiva.vue — Importación CSV/XLSX dual (productos + aplicaciones)
- bodegas/bodegas.vue — CRUD bodegas con flag "vender sin stock"
- medidas, categorias, marcas — CRUD simples completos
Compras 100%
- compras.vue — Nueva compra, líneas con escaneo, totales automáticos
- solicitudes-compra.vue — Flujo de aprobación, contador de pendientes
- ordenes-compra.vue — OC con estados, generación masiva, impresión
- registros.vue — Historial de compras con filtros
Cajas 100%
- cajas.vue — Dashboard con 5 KPIs, movimientos, resumen por método de pago, cierre de caja
- cajas-mockup.vue — Prototipo visual (no operativo, datos hardcodeados)
Clientes y Créditos 100%
- clientes.vue — CRUD con validación RUT, geolocalización país/región/comuna
- creditos.vue — Dashboard deuda/mora/línea crédito, pago batch de créditos
- carga-masiva.vue — Drop zone con parseo CSV/Excel y progress bar
Proveedores 100%
- proveedor.vue — CRUD server-side, validación RUT, geo-dropdowns, SKU por proveedor
- Carga masiva de proveedores disponible en backend
Restaurante 100%
- restaurante.vue — POS con plano de mesas interactivo (2.503 líneas)
- mesas.vue — CRUD mesas/secciones + visualización plano 2D
- garzones.vue — CRUD garzones
- Componentes PlanoMesas y PlanoMesasSelector reutilizables
Arriendos y Maquinaria 100%
- arriendo.vue — Formulario con cliente, maquinarias, fechas FlatPickr
- list.vue — Listado con búsqueda y paginación servidor
- recep.vue — Recepción de arriendos con trigger por cliente
- Impresión de ticket para cada operación
Mantenciones 95%
- ingreso.vue — Formulario multi-tab con datos/mantenciones (1.605 líneas)
- despacho.vue — Flujo despacho con maquinarias seleccionadas
- mantencion.vue — Vista detalle con ítems (tabla interactiva, parcialmente readonly)
- Dashboard de mantenciones con análisis financiero y SVG circular
Traspasos entre Bodegas 100%
- crear.vue — Formulario con bodega origen/destino, tabla artículos, modal selector
- despachos.vue — Gestión de despachos
- recepcionar.vue — Recepción de traspasos
- registros.vue — Historial de traspasos
WMS — Gestión de Almacén 95%
- layout/[bodegaId].vue — Editor CAD 2D con Konva.js (3.500 líneas)
- racks/ — Gestión de racks con vista de elevación
- asignacion-ubicaciones.vue — Asignación de artículos a ubicaciones
- operaciones: tareas, ajustes-stock, conteo cíclico
- reportes: ocupación, rotación ABC, vencimientos
- empaques — Gestión de tipos de empaque
Dashboards 100%
- pos-venta.vue — KPIs ventas hoy/ayer/mes, gráfico evolución diaria
- panguimaq.vue — Dashboard ejecutivo arriendos/mantenciones por período
- mantenciones.vue — Análisis financiero con SVG circular progress chart
3. Inventario completo de vistas
3.1 Ventas
| Vista | Ruta | Estado | Líneas | Notas |
|---|
| Punto de Venta | /ventas/punto-de-venta | COMPLETA | 5.786 | Carrito dual (POS rápido + venta completa), autorización de descuentos, tasas impuesto cacheadas |
| POS Repuestos | /ventas/posrepuesto | COMPLETA | 6.077 | Búsqueda por aplicación (Marca/Modelo/Año), modo apartado, compatibilidades |
| Ventas (historial) | /ventas/ventas | COMPLETA | 3.466 | Filtros avanzados, PDF/ticket térmico, anulación con nota crédito, DTE integrado |
| Cotizaciones | /ventas/cotizaciones | COMPLETA | 746 | CRUD, estados, conversión a venta, vincular cotización existente |
| Caja (pendientes) | /ventas/caja | COMPLETA | 591 | Panel dual: tickets pendientes + detalle, anulación, impresión |
| Registros Ventas | /ventas/registros | COMPLETA | 872 | Reporte totales neto/IVA/cantidad con filtros |
3.2 Inventario y Bodegas
| Vista | Ruta | Estado | Líneas | Notas |
|---|
| Artículos | /inventario/articulos | COMPLETA | 4.150 | 5 tabs (general/empaques/códigos/compatibilidades/imágenes), ZXing QR/barras, paginación server-side |
| Inventario | /inventario/bodegas/inventarios | COMPLETA | 1.410 | Kardex visual, saldos origen/tránsito/vendido, métricas de precio y utilidad |
| Carga Masiva | /inventario/bodegas/carga-masiva | COMPLETA | 2.509 | Dual drop-zone (productos + aplicaciones), 8 secciones, CSV/XLSX, pre-validación |
| Bodegas | /inventario/bodegas/bodegas | COMPLETA | 257 | CRUD, flag "vender sin stock", integración WMS |
| Medidas | /inventario/medidas | COMPLETA | 339 | CRUD unidades de medida |
| Categorías | /inventario/categorias | COMPLETA | 161 | CRUD categorías |
| Marcas | /inventario/marcas | COMPLETA | 161 | CRUD marcas |
3.3 Compras
| Vista | Estado | Líneas | Notas |
|---|
| Compras | COMPLETA | 3.698 | Nueva compra con encabezado + líneas, escaneo artículos, métodos de pago |
| Órdenes de Compra | COMPLETA | 2.825 | CRUD completo, estados, generación masiva, impresión PDF |
| Solicitudes de Compra | COMPLETA | 1.328 | Flujo aprobación/rechazo, contador visual de pendientes |
| Registros Compras | COMPLETA | 210 | Historial con filtros de fecha |
3.4 WMS
| Vista | Estado | Líneas | Notas |
|---|
| Editor Layout 2D | COMPLETA | 3.500 | CAD con Konva.js: dibujar polígonos, racks, zonas, snap ortogonal, zoom |
| Asignación Ubicaciones | COMPLETA | 1.868 | Asignación de artículos a ubicaciones WMS |
| Racks | COMPLETA | 355 | Gestión de racks con vista elevación |
| Rack Elevación | COMPLETA | 806 | Vista lateral de rack con ubicaciones |
| Tareas | COMPLETA | 349 | Gestión de tareas WMS |
| Ajustes de Stock | COMPLETA | 326 | Ajustes manuales de inventario con auditoría |
| Conteo Cíclico | COMPLETA | 304 | Proceso de conteo físico de inventario |
| Empaques | COMPLETA | 125 | Gestión tipos de empaque |
| Reporte Ocupación | COMPLETA | 248 | % ocupación por rack/zona |
| Reporte Rotación ABC | COMPLETA | 204 | Clasificación ABC por rotación |
| Reporte Vencimientos | COMPLETA | 211 | Control de productos próximos a vencer |
| Dashboard WMS | COMPLETA | 564 | Vista general del estado del almacén |
3.5 Resto de módulos
| Vista | Módulo | Estado | Notas |
|---|
| Cajas | Cajas | COMPLETA | Dashboard KPIs, movimientos, cierre de caja |
| Cajas Mockup | Cajas | MOCKUP | Prototipo con datos hardcodeados — no operativo |
| Clientes | Clientes | COMPLETA | CRUD, validación RUT, geo-dropdowns |
| Créditos | Clientes | COMPLETA | Dashboard deuda/mora, pago batch |
| Carga Masiva Clientes | Clientes | COMPLETA | Drop zone CSV/Excel con progress |
| Proveedores | Proveedores | COMPLETA | CRUD server-side, RUT, geo, SKU por proveedor |
| Restaurante | Restaurante | COMPLETA | POS con plano mesas interactivo |
| Mesas | Restaurante | COMPLETA | CRUD + plano 2D |
| Garzones | Restaurante | COMPLETA | CRUD simple |
| Arriendo | Arriendos | COMPLETA | Formulario cliente + maquinarias + fechas |
| Listado Arriendos | Arriendos | COMPLETA | Listado paginado server-side |
| Recepción | Arriendos | COMPLETA | Recepción con trigger por cliente |
| Ingreso Mantención | Mantenciones | COMPLETA | Multi-tab datos/mantenciones |
| Despacho Mantención | Mantenciones | COMPLETA | Flujo despacho |
| Detalle Mantención | Mantenciones | PARCIAL | Vista parcialmente readonly; tabla ítems interactiva pero falta flujo de edición completo |
| Crear Traspaso | Traspasos | COMPLETA | Bodega origen/destino, modal selector artículos |
| Despachos Traspaso | Traspasos | COMPLETA | Gestión de despachos |
| Recepción Traspaso | Traspasos | COMPLETA | Recepción de traspasos |
| Registros Traspaso | Traspasos | COMPLETA | Historial |
| Dashboard POS Venta | Dashboard | COMPLETA | KPIs ventas + gráfico diario |
| Dashboard Panguimaq | Dashboard | COMPLETA | Dashboard ejecutivo arriendos/mantenciones |
| Dashboard Mantenciones | Dashboard | COMPLETA | Análisis financiero con SVG circular chart |
4. Funcionalidades faltantes y pendientes
Nota sobre facturación electrónica DTE
El backend tiene PosVentaToDteMapper y la migración add_dte_documento_id_to_pos_ventas, lo que indica integración DTE iniciada. Sin embargo no hay una vista dedicada de gestión de DTE ni un flujo de emisión/envío al SII visible desde el frontend. Este es el gap más importante del módulo.
| # | Funcionalidad | Prioridad | Descripción | Estimado |
|---|
| 1 |
Vista de Notas de Crédito |
ALTA |
El controller PosNotaCreditoController existe y el endpoint /posNotasCredito también, pero no hay ninguna vista frontend para listar, crear o gestionar notas de crédito. El flujo de anulación desde ventas.vue las crea pero no hay forma de consultarlas. |
6 hrs |
| 2 |
Vista Gestión DTE / Facturación Electrónica |
ALTA |
El mapper PosVentaToDteMapper y el campo dte_documento_id en ventas existen. Se necesita vista para: ver estado de emisión del DTE, reenviar al SII si falla, listar documentos tributarios emitidos (boletas/facturas electrónicas). |
12 hrs |
| 3 |
Notas de Débito |
MEDIA |
No hay controller ni modelo de notas de débito. Complemento natural de las notas de crédito para ajustes en más. |
8 hrs |
| 4 |
Completar Detalle Mantención |
MEDIA |
mantenciones/mantencion.vue tiene vista readonly parcial. Falta completar el flujo de edición de ítems y guardar cambios en una mantención existente. |
4 hrs |
| 5 |
Eliminar cajas-mockup.vue |
BAJA |
El archivo cajas/cajas-mockup.vue tiene datos hardcodeados y no es operativo. Debe eliminarse o removerse del menú para no confundir usuarios. |
0.5 hrs |
| 6 |
Reporte de Rentabilidad por Artículo |
BAJA |
El inventario calcula precio/utilidad pero no hay un reporte consolidado de rentabilidad por artículo/categoría con tendencia histórica. |
8 hrs |
| 7 |
Dashboard POS Global |
BAJA |
Existe pos-venta.vue pero es básico. Un dashboard integrado con ventas + compras + stock mínimo + alertas de quiebre de stock sería de alto valor. |
10 hrs |
5. Plan de trabajo — 3 semanas
Semana 1 — Notas de Crédito y Detalle Mantención
- Crear vista
ventas/notas-credito.vue usando PosNotaCreditoController 6 hrs
- Agregar link a Notas de Crédito en menú desde
ventas.vue 0.5 hrs
- Completar flujo edición en
mantenciones/mantencion.vue 4 hrs
- Eliminar o desactivar
cajas-mockup.vue del menú 0.5 hrs
Semana 2 — Facturación Electrónica DTE
- Auditar integración DTE existente en backend (PosVentaToDteMapper, CafRepositoryInterface) 3 hrs
- Crear vista
ventas/dte.vue: listado documentos emitidos, estado SII, reenvío 9 hrs
- Integrar indicador de estado DTE en
ventas.vue (ícono por fila) 2 hrs
Semana 3 — Notas de Débito y Mejoras
- Backend: crear
PosNotaDebitoController y migración 4 hrs
- Frontend: vista
ventas/notas-debito.vue 5 hrs
- Reporte rentabilidad por artículo/categoría 8 hrs
- QA general del flujo completo: venta → caja → DTE → NC 3 hrs
6. Resumen de horas estimadas
| Semana | Foco | Horas |
|---|
| Semana 1 | Notas de Crédito (vista) + Detalle Mantención + limpieza mockup | 11 hrs |
| Semana 2 | Facturación Electrónica DTE — vista + integración en ventas | 14 hrs |
| Semana 3 | Notas de Débito + Reporte Rentabilidad + QA | 20 hrs |
| TOTAL ESTIMADO | ~45 hrs |
Estado del módulo para producción
El módulo POS está en condiciones de operar en producción HOY para los flujos de: venta directa, compras, inventario, cajas, clientes, restaurante, arriendos, mantenciones y WMS. Los ítems del plan son mejoras y complementos, no bloqueantes del flujo principal.
7. Fortalezas técnicas destacadas
POS de Ventas — Nivel Profesional
- Dual mode: POS rápido (teclado) + venta completa (modal)
- Autorización de descuentos con flujo de aprobación
- POS especializado para repuestos con búsqueda por aplicación vehículo
- Caché de tasas de impuesto para performance
- Generación de ticket térmico y PDF
- Integración DTE iniciada (campo dte_documento_id)
WMS — Sistema de Almacén Enterprise
- Editor CAD 2D con Konva.js (dibujo de planos reales)
- Gestión de racks con vista de elevación
- Conteo cíclico de inventario
- Reportes ABC de rotación y vencimientos
- Integración bidireccional con inventario POS
- Empaques configurables por artículo
Inventario — Alta Configurabilidad
- 5 tabs de artículo: general, empaques, códigos, compatibilidades, imágenes
- ZXing para lectura de QR/barras desde cámara
- Carga masiva dual (productos + tabla de aplicaciones por marca/modelo/año)
- Kardex en tiempo real con métricas de precio y utilidad
- SKU por proveedor
Módulos Verticales Completos
- Restaurante: POS con plano de mesas interactivo
- Arriendos: flujo completo arriendo → recepción → devolución
- Mantenciones: ingreso → mantención → despacho con dashboard financiero
- Compras: solicitud → OC → compra con recepción
- Créditos: gestión de deuda con pago batch