🤝 Proveedores

---

1. 🧩 Descripción General

El módulo de Proveedores centraliza la información de los socios comerciales que abastecen a la empresa. Gestiona sus datos, condiciones de pago, historial de desempeño, y permite integrarse con los módulos de Compras y Finanzas para automatizar la adquisición de insumos y el seguimiento de cuentas por pagar.

---

2. 🧱 Modelos del Módulo

a. Provider

• id: integer (PK)
• name: string
• rfc: string
• email: string
• phone: string
• payment_terms: integer (días)
• currency: string (MXN, USD)
• credit_limit: decimal
• is_active: boolean

b. ProviderAddress

• id: integer (PK)
• provider_id: FK → Provider
• type: enum (fiscal, entrega)
• street, city, state, zip, country: strings

c. ProviderDocument

• id: integer (PK)
• provider_id: FK → Provider
• type: string (contrato, certificado, etc.)
• path: string
• expiry_date: date

d. ProviderEvaluation

• id: integer (PK)
• provider_id: FK → Provider
• rating: integer
• comment: text
• date: datetime

---

3. 🔁 Funciones del Controlador

• index(): Lista de proveedores registrados.
• store(): Registrar proveedor nuevo.
• show($id): Ver detalle completo del proveedor.
• update($id): Editar información.
• destroy($id): Desactivar proveedor.
• uploadDocument(): Cargar archivo adjunto.
• evaluate(): Registrar evaluación de desempeño.

---

4. 🌐 Endpoints detallados y justificados

Método	Ruta	Descripción	Justificación
GET	/api/providers	Listar proveedores	Selección para órdenes
POST	/api/providers	Registrar proveedor	Alta de nuevo socio comercial
GET	/api/providers/{id}	Ver proveedor	Consulta de información completa
PUT	/api/providers/{id}	Editar proveedor	Actualización de condiciones o contacto
DELETE	/api/providers/{id}	Desactivar proveedor	Mantenimiento del catálogo
POST	/api/providers/{id}/documents	Subir documentos	Contratos, certificados
POST	/api/providers/{id}/evaluate	Evaluar proveedor	Desempeño operativo

---

5. 🖥️ Diseño UX sugerido (flujo de usuario)

Página: "Listado de Proveedores"

• Tabla con nombre, RFC, teléfono, condiciones de pago
• Filtros por estado, moneda o país
• Acciones: Ver, Editar, Desactivar

Página: "Ficha del Proveedor"

• Información fiscal y comercial
• Evaluaciones pasadas
• Documentos cargados (descargables)
• Botón: Cargar nuevo documento / Evaluar

---

6. 📄 Vistas sugeridas (tipo wireframe)

Vista	Campos sugeridos	Acciones
Listado	Nombre, RFC, correo, activo	Ver, Editar, Desactivar
Formulario	Nombre, RFC, email, teléfono, moneda, plazo	Guardar
Documentos	Tipo, fecha de vencimiento, archivo	Descargar, Cargar
Evaluaciones	Fecha, comentario, puntuación	Ver, Crear nueva

---

7. 🔗 Conexión Frontend ↔ API JSON:API

Acción en Frontend	Método/API	Resultado esperado
Cargar proveedores	GET /api/providers	Tabla con búsqueda
Ver proveedor	GET /api/providers/{id}	Mostrar detalle completo
Crear proveedor	POST /api/providers	Alta nueva
Subir documento	POST /api/providers/{id}/documents	Asociar PDF o contrato
Evaluar proveedor	POST /api/providers/{id}/evaluate	Añadir historial de desempeño

---

📦 Este módulo facilita la administración de proveedores desde una perspectiva operativa, documental y estratégica, y prepara el terreno para integrarse con procesos de compras automatizados y cuentas por pagar.