Autoparts-DB/docs/GUIA-DE-USO.md

# Guia de Uso -- Nexus Autoparts POS

Manual de usuario para el sistema de Punto de Venta Nexus Autoparts.

---

## 1. Acceso al sistema

1. Abrir el navegador e ir a `http://[IP]:5001/pos/login`
2. Se muestra la lista de empleados del tenant
3. Seleccionar tu usuario
4. Escribir tu PIN de 4 digitos
5. El sistema te lleva al dashboard o al POS segun tu rol

**Primer acceso:** El PIN del dueno se configura al crear el tenant. El dueno puede crear empleados desde Configuracion.

**Seguridad:**
- 5 intentos fallidos por minuto maximo
- 10 intentos fallidos bloquean el dispositivo por 15 minutos
- Cada sesion genera un token JWT con duracion de 8 horas

---

## 2. Navegacion

- **Sidebar izquierdo**: contiene todas las secciones del sistema
- **Toggle de tema**: icono de luna/sol en la parte superior del sidebar para cambiar entre tema Industrial (oscuro) y Moderno (claro)
- **Logout**: boton en la parte inferior del sidebar
- **Breadcrumbs**: en el catalogo, muestran la ruta de navegacion actual

Las secciones visibles dependen del rol:
| Seccion | Dueno | Admin | Cajero | Almacenista | Contador |
|---------|-------|-------|--------|-------------|----------|
| Dashboard | Si | Si | No | No | No |
| Catalogo | Si | Si | Si | Si | Si |
| POS | Si | Si | Si | No | No |
| Inventario | Si | Si | No | Si | No |
| Clientes | Si | Si | Si | No | Si |
| Facturacion | Si | Si | No | No | Si |
| Contabilidad | Si | No | No | No | Si |
| Reportes | Si | Si | No | No | Si |
| Configuracion | Si | Si | No | No | No |

---

## 3. Catalogo

El catalogo conecta con la base de datos maestra TecDoc (1.5M+ partes OEM) y muestra stock local.

### Navegacion por vehiculo

1. **Marca** -- seleccionar marca del vehiculo (Toyota, Nissan, Ford, etc.)
2. **Modelo** -- seleccionar modelo (Corolla, Sentra, F-150, etc.)
3. **Ano** -- seleccionar ano del vehiculo
4. **Motor** -- seleccionar motorizacion
5. **Categoria** -- categoria de partes (Frenos, Motor, Suspension, etc.)
6. **Subcategoria** -- grupo especifico (Pastillas, Discos, Balatas, etc.)
7. **Partes** -- lista de partes con numero OEM, precio y stock

### Busqueda inteligente

- Escribir en la barra de busqueda un **numero de parte** (ej. "04465-02220") o **texto** (ej. "pastillas corolla")
- El sistema busca en partes OEM, aftermarket y cross-references
- Resultados muestran stock local y alternativas disponibles

### Panel de detalle

Al seleccionar una parte se abre un panel lateral con:
- Numero de parte OEM y descripcion
- **Stock local**: cantidad en la sucursal actual
- **Stock en bodegas**: disponibilidad en otras sucursales
- **Alternativas**: partes aftermarket equivalentes con precios
- **Cross-references**: numeros alternos de otras marcas

### Carrito

- Hacer clic en "Agregar" para anadir partes al carrito
- El carrito muestra cantidad, precio unitario y subtotal
- Boton **"Ir a cobrar"** salta directamente al POS con las partes cargadas

### Modo offline

Cuando no hay conexion a internet:
- Solo se muestra el inventario local (partes en la sucursal)
- La navegacion TecDoc no esta disponible
- Al restaurar la conexion, se sincronizan las operaciones pendientes

---

## 4. Punto de Venta (POS)

Pantalla principal de cobro con atajos de teclado para operacion rapida.

### Operacion basica

1. **Buscar parte** (F1): escribir numero de parte o descripcion
2. **Seleccionar cliente** (F2): buscar por nombre, RFC o telefono. Si no se selecciona, se vende a "Publico General"
3. Las partes se agregan a la lista con cantidad, precio y descuento
4. **Cobrar** (F3): abrir dialogo de pago

### Metodos de pago

| Metodo | Descripcion |
|--------|-------------|
| Efectivo | Calcula cambio automaticamente |
| Transferencia | Registra referencia bancaria |
| Tarjeta | Registra numero de autorizacion |
| Mixto | Combina dos o mas metodos |

### Tipos de operacion

- **Venta directa** (F3): cobro inmediato, descuenta inventario
- **Cotizacion** (F4): guarda sin cobrar, se puede convertir a venta despues
- **Apartado**: reserva partes con pago parcial (enganche minimo configurable). El cliente hace pagos subsecuentes hasta completar
- **Credito**: venta a cuenta del cliente (requiere cliente con credito autorizado y limite suficiente)

### Atajos de teclado

| Tecla | Accion |
|-------|--------|
| F1 | Buscar parte |
| F2 | Seleccionar cliente |
| F3 | Cobrar |
| F4 | Cotizacion |
| F5 | Apartado |
| F6 | Ultimo ticket |
| + / - | Aumentar/disminuir cantidad |
| * | Editar cantidad directa |
| Enter | Confirmar |
| Delete | Eliminar linea |
| Escape | Cancelar / cerrar dialogo |

### Margen y costos

- La columna de **costo** y **margen** solo es visible para roles Dueno y Admin
- El cajero solo ve precio de venta

---

## 5. Inventario

Gestion completa de productos y stock.

### Tab Productos

- **Ver**: lista paginada con busqueda por nombre, SKU o codigo de barras
- **Crear**: nuevo producto con nombre, SKU, codigo de barras, costo, precios (mostrador/taller/mayoreo), stock minimo, stock maximo, ubicacion en almacen
- **Editar**: modificar datos del producto

### Tab Entradas (Compras)

- Registrar compra a proveedor
- Campos: proveedor, factura del proveedor, lista de productos con cantidad y costo
- El stock se incrementa automaticamente
- Se genera movimiento en el historial

### Tab Ajustes

- Ajuste manual de inventario (merma, error de conteo, dano, etc.)
- **Requiere motivo**: el sistema no permite ajustes sin explicacion
- Genera registro en auditoria con usuario, fecha y motivo

### Tab Transferencias

- Mover productos entre sucursales
- Origen y destino, lista de productos con cantidad
- Descuenta del origen y suma al destino
- Rastrea estado: pendiente, en transito, recibida

### Tab Toma Fisica

1. **Iniciar conteo**: genera documento de toma fisica
2. **Capturar conteos**: registrar cantidades fisicas por producto
3. **Comparar**: el sistema muestra diferencias vs stock teorico
4. **Aprobar**: aplica los ajustes automaticamente

### Tab Alertas

- **Stock en cero**: productos sin existencia
- **Bajo minimo**: productos por debajo del punto de reorden
- **Sobre maximo**: productos con sobreinventario

### Tab Reportes de Inventario

| Reporte | Descripcion |
|---------|-------------|
| Valorizacion | Valor total del inventario a costo y a precio de venta |
| ABC | Clasificacion de productos por volumen de venta (A=80%, B=15%, C=5%) |
| Sin movimiento | Productos sin venta en X dias |
| Stock bajo | Productos por debajo del minimo |
| Comparativo sucursales | Stock del mismo producto en todas las sucursales |

---

## 6. Clientes

### Crear cliente

Campos principales:
- Nombre / Razon social
- RFC (para facturacion)
- Regimen fiscal SAT
- Codigo postal fiscal
- Uso de CFDI (ej. G03 Gastos en general)
- Telefono, email
- Direccion

### Tiers de precio

Cada cliente pertenece a un tier que determina el precio automatico:

| Tier | Descripcion |
|------|-------------|
| Mostrador | Precio publico (default) |
| Taller | Descuento para talleres mecanicos |
| Mayoreo | Mejor precio para compradores de volumen |

### Credito

- Asignar limite de credito al cliente
- El sistema valida que el saldo no exceda el limite al crear ventas a credito
- **Estado de cuenta**: muestra compras, pagos y saldo pendiente
- **Registrar pago**: abono parcial o total a la cuenta

### Vehiculos

- Asociar vehiculos al cliente (marca, modelo, ano, motor, placas, VIN)
- Facilita la busqueda de partes en futuras visitas

### Historial

- Ver todas las compras del cliente con fecha, total y estatus

---

## 7. Facturacion CFDI

### Generar factura

1. Ir a Facturacion
2. Seleccionar una venta completada
3. Verificar datos fiscales del cliente (RFC, razon social, regimen, CP, uso CFDI)
4. Generar factura -- se crea el XML CFDI 4.0

### Tipos de comprobante

| Tipo | Uso |
|------|-----|
| Ingreso | Factura de venta normal |
| Egreso | Nota de credito (devolucion/cancelacion) |
| Pago | Complemento de pago para ventas a credito (PPD) |

### Cola de timbrado

- Las facturas se encolan para envio al PAC (Horux)
- El PAC firma el XML con el CSD del contribuyente
- Estado: pendiente, timbrada, error, cancelada
- Reintentar facturas con error

### Cancelacion

- Seleccionar factura a cancelar
- Indicar motivo SAT:
  - 01: Comprobante emitido con errores con relacion
  - 02: Comprobante emitido con errores sin relacion
  - 03: No se llevo a cabo la operacion
  - 04: Operacion nominativa relacionada en una factura global
- Si el motivo es 01, indicar el UUID de la factura sustituta

### PDF

- Descargar representacion impresa (PDF) de cualquier factura timbrada

---

## 8. Contabilidad

### Polizas automaticas

Cada venta genera automaticamente una poliza contable:
- Cargo a Caja/Bancos (por el monto cobrado)
- Abono a Ventas (por el subtotal)
- Abono a IVA Trasladado (por el impuesto)
- Cargo a Costo de Ventas / Abono a Inventario (por el costo)

### Catalogo de cuentas

- Basado en el catalogo SAT
- Estructura jerarquica: Activo, Pasivo, Capital, Ingresos, Costos, Gastos
- Cada cuenta tiene codigo SAT, nombre, tipo (deudora/acreedora), nivel

### Reportes financieros

| Reporte | Descripcion |
|---------|-------------|
| Balanza de comprobacion | Saldos iniciales + movimientos del periodo + saldos finales |
| Estado de resultados | Ingresos - Costos - Gastos = Utilidad del periodo |
| Balance general | Activo = Pasivo + Capital a una fecha |
| Antiguedad de saldos | Cuentas por cobrar agrupadas por dias de atraso (0-30, 31-60, 61-90, 90+) |

### Periodos fiscales

- Ver periodos mensuales con estado (abierto/cerrado)
- Cerrar periodo: bloquea movimientos en ese mes. Esta accion es irreversible.

---

## 9. Caja Registradora

### Flujo diario

1. **Abrir caja**: indicar numero de caja y fondo inicial en efectivo
2. **Operar**: las ventas se registran automaticamente en la caja abierta
3. **Movimientos**: registrar entradas (cobros externos, cambio) o salidas (gastos menores, compras) de efectivo con motivo
4. **Corte X**: consulta de ventas y movimientos sin cerrar la caja
5. **Corte Z**: cierre de caja con conteo final. El sistema calcula la diferencia entre lo esperado y lo contado

### Multi-caja

- Cada cajero abre su propia sesion de caja
- Un empleado solo puede tener una caja abierta a la vez
- El numero de caja identifica la caja fisica (1, 2, 3...)

### Historial

- Consultar cortes anteriores con detalle de ventas, movimientos y diferencias

### Resumen diario

- Vista consolidada de todas las cajas del dia

---

## 10. Dashboard (Dueno)

Pantalla de resumen ejecutivo disponible solo para Dueno y Admin:

- **Ventas del dia** vs meta configurada
- **Cajas activas**: cuantas cajas estan abiertas y quien las opera
- **Alertas**: productos sin stock, facturas con error, cajas sin cerrar
- **Resumen semanal**: grafico de ventas de los ultimos 7 dias

---

## 11. Configuracion

### Datos del negocio

- Nombre, RFC, regimen fiscal, direccion, logo
- Configuracion de CFDI (serie, folio, certificados)

### Sucursales

- Crear y editar sucursales
- Nombre, direccion, telefono
- Activar/desactivar sucursal

### Empleados y roles

- Crear empleados con nombre, telefono, email, PIN y rol
- Roles disponibles:

| Rol | Permisos principales |
|-----|---------------------|
| Dueno | Todo (no se puede eliminar) |
| Admin | Todo excepto configuracion de tenant |
| Cajero | POS, catalogo, clientes basico |
| Almacenista | Inventario completo, catalogo |
| Contador | Contabilidad, facturacion, reportes |

- Cada rol tiene permisos granulares que se asignan automaticamente

### Temas

- **Industrial**: tema oscuro con tonos grafito y acentos naranja
- **Moderno**: tema claro con tonos blancos y azul primario
- El toggle esta en el sidebar y se aplica inmediatamente