LauckCycles/resources/a.md at 04a8ecbd9a7e8d67eafa3726e17383b6762ab5a9

Files

T

BryamE 20e7da64de Creados un monton de componentes para reutilizar en las paginas, modificadas vistas, faltan agregar mas cosas

2025-12-06 19:52:33 -03:00

6.7 KiB

Raw Blame History

¡Perfecto! Tus respuestas aclaran muchísimo el panorama. Al ser un sistema Intranet (Local) con un Admin y Empleados (visores/operadores), y con procesos manuales en el taller, podemos simplificar la arquitectura para lanzar un MVP (Producto Mínimo Viable) rápido y robusto, pero preparado para crecer.

Aquí tienes la Guía Maestra de Desarrollo para Lauck Systems.

1. Arquitectura de Base de Datos (El Cimiento)

Antes de escribir código, definamos las tablas. Laravel hace esto fácil con migraciones.

Tablas Principales:

users (Ya viene en Laravel)
- Agregamos campo: role (enum: 'admin', 'employee').
- Lógica: El Admin crea, edita y borra. El Empleado solo ve y registra ventas/turnos (según definas).
clients (Clientes)
- name, phone (clave para WhatsApp), email, address.
- Nota: Fundamental para agendar turnos y registrar garantías.
products (Inventario Mixto)
- name, sku (código único), description.
- price (precio venta), cost (costo, solo visible para admin).
- stock_quantity (entero).
- min_stock_alert (entero, para la alerta que pediste).
- type (enum: 'bike', 'accessory', 'service').
- serial_number (nullable, solo para bicicletas).
appointments (Turnos / Taller)
- client_id (relación).
- scheduled_at (datetime - fecha y hora del turno).
- bike_model (texto libre, ej: "Venzo Loki 29").
- problem_description (motivo de la consulta).
- status (enum: 'pending', 'confirmed', 'in_progress', 'ready', 'delivered').
- notes (uso interno del mecánico).
sales (Ventas Internas / Historial)
- user_id (quién vendió).
- client_id (opcional, si es consumidor final anónimo).
- total_amount.
- payment_method (efectivo, tarjeta, transferencia).
- created_at (fecha de venta).
sale_items (Detalle de venta)
- sale_id, product_id, quantity, unit_price.

2. Estructura de Rutas y Controladores (Backend)

En Laravel, organizaremos esto por "Dominios".

Autenticación: (Ya lo tienes con Breeze/Jetstream).
DashboardController:
- index(): Muestra las tarjetas, alertas de stock bajo (query simple Product::whereColumn('stock', '<=', 'min_stock')->get()) y turnos de hoy.
ProductController:
- CRUD completo (Crear, Leer, Actualizar, Borrar).
- Función extra search(): Para el buscador de precios de los empleados.
ClientController:
- CRUD simple.
AppointmentController (Gestión de Taller):
- calendar(): Vista de calendario o lista cronológica.
- statusUpdate(): Para mover el turno de "Pendiente" a "Listo".
SaleController:
- create(): Formulario para registrar una salida de mercadería.
- store(): Resta el stock y guarda la venta.

3. Componentes de UI (Frontend - Blade + Tailwind)

Para mantener el estilo "Lauck" que ya definimos, necesitaremos crear estos componentes reutilizables (además de los que ya tienes):

x-ui.status-badge:
- Una etiqueta pequeña redondeada que cambia de color según el estado (Verde para 'Stock Alto', Rojo para 'Sin Stock' o 'Turno Atrasado', Amarillo para 'En Reparación').
x-ui.table:
- Una tabla estilizada con el modo oscuro, filas alternadas y cabeceras fijas. Vital para listas de precios y clientes.
x-forms.input / x-forms.select:
- Inputs con el estilo oscuro y borde neón al hacer foco, para no repetir las clases de Tailwind en cada formulario.
x-ui.alert:
- Para mostrar mensajes de éxito ("Producto guardado") o alertas ("¡Quedan solo 2 cámaras rodado 29!").

4. Funcionalidades Específicas a Implementar

Aquí está la lógica para los requerimientos que mencionaste:

A. Alertas de Stock ⚠️

Lógica: No necesitas un sistema complejo de notificaciones en tiempo real todavía.
Implementación: En el DashboardController, pasas una variable $lowStockProducts a la vista.
Vista: En el Dashboard, si esa lista no está vacía, muestras una tarjeta roja o amarilla avisando "X productos con stock crítico".

B. Consulta de Precios (Modo Solo Lectura) 🔍

Requerimiento: Empleados consultan, no editan.
Implementación:
- Crear una vista products.checker.
- Un input de búsqueda grande en el centro.
- Al escribir (AJAX o Livewire sería ideal aquí, pero un form simple con botón "Buscar" funciona), muestra una tarjeta gigante con el Nombre y el Precio.
- Seguridad: Usar Laravel Gates o Policies.
```
// En AuthServiceProvider
Gate::define('edit-products', function ($user) {
    return $user->role === 'admin';
});
```
  En Blade: @can('edit-products') <button>Editar</button> @endcan. Así el empleado ve el producto pero no el botón de editar.

C. Agenda de Turnos 📅

Lógica: "Consulta -> Cita".
Implementación:
- No te compliques con un calendario visual complejo (tipo Google Calendar) al principio.
- Usa una Lista Agrupada por Días.
- Ejemplo visual:
  - HOY:
    - 09:00 - Jose (Pincharura) [Ver]
    - 10:30 - Maria (Service General) [Ver]
  - MAÑANA:
    - ...

5. Roadmap Sugerido (Paso a Paso)

Este es el orden lógico para programar sin perderse:

Semana 1: Cimientos y Stock (Lo más urgente)
- Configurar Migraciones (products, clients).
- Crear Modelos y Seeders (datos falsos para probar).
- Hacer el CRUD de Productos (Alta, Baja y Modificación).
- Hito: Poder cargar una bicicleta y verla en la lista.
Semana 2: Seguridad y Consultas
- Agregar campo role a Users.
- Crear la vista "Consulta de Precios" (solo lectura).
- Proteger las rutas de edición para que solo el Admin entre.
- Hito: El empleado puede loguearse y buscar un precio, pero no borrar nada.
Semana 3: El Taller (Turnos)
- Crear migración appointments.
- Crear formulario para "Nuevo Turno" (Seleccionar Cliente + Fecha + Motivo).
- Crear vista de "Lista de Turnos" en el Dashboard.
- Hito: Dejar de usar el cuaderno de papel para los turnos.
Semana 4: Refinamiento
- Alertas de stock visuales.
- Mejoras estéticas (Dark Mode en tablas).
- Pruebas finales en el servidor local.

¿Cómo seguimos?

¿Te gustaría que generemos el código para la Migración de Productos y el Modelo, o prefieres que diseñemos primero el componente visual de la Tabla de Stock?

6.7 KiB Raw Blame History