Transcripción fiel de las dos láminas dibujadas a mano (maestros + ciclo comercial de 8 etapas, y almacén + 12 formatos), re-representadas como diagramas y mockups, con la lectura de cómo Willhelm concibe el sistema y el mapeo contra lo ya construido en ABC Turbo.
Willhelm define dos fichas maestras con clasificación de dos ejes: una categoría (importancia u origen) y un sector/rubro codificado.
erDiagram
CLIENTE {
string categoria "A Importante · B Alguna vez · C Potencial · D Ninguna vez"
string sector "1 C-ABB · 2 C-AGR · 3 C-GEN · 4 C-IND · 5 C-MGP · 6 C-MIN · 7 C-NAV · 8 C-PES · 9 NET"
string razon_social "completa + nombre comercial"
string ruc
string direccion "fiscal / almacen"
string ciudad_pais
string pagina_web
}
CLIENTE_CONTACTO {
string cargo
string nombre
string tel_rpm
string tel_particular
string correo_corporativo
string correo_particular
string extras "fecha nacimiento · DNI · direccion casa"
}
PROVEEDOR {
string categoria "A Internacional · B Nacional"
string sector "1 EPP · 2 Consumibles · 3 Ferreteros · 4 Herramientas · 5 Calibracion · 6 Repuestos · 7 Equipos · 8 Especiales"
string nombre_comercial
string razon_social
string ruc
string direccion "fiscal / almacen"
string contacto "cargo · nombre · cel · email"
string lista_catalogos
string compras_acumuladas "monto + facturas"
}
CLIENTE ||--o{ CLIENTE_CONTACTO : tiene
Ejemplos reales que él mismo anotó: cliente Electro Oriente S.A. (ELOR) — categoría A, sector C-GEN, RUC 20103795631, Iquitos, contacto GG Bonet Manrique García. Proveedores: Würth Perú S.A. (B / 4-Herramientas, contacto GV Julio Caldini) y Sinoteck Turbo Limited de Shanghai (A / 6-Repuestos, contacto Jordin Cheng).
En el margen del proveedor dibujó además dos acumuladores: lista de catálogos y compras (monto y nº de factura) — quiere ver, dentro de la ficha, el histórico de cuánto se le compró a cada proveedor y qué catálogos maneja.
El corazón del plano. Cada operación de venta nace con un correlativo anual (ej. Q-26-2607 = año 26, operación 2607) y avanza por 8 etapas. Cada etapa produce documentos con un prefijo propio — todo lo que está en rosa en su plano es un código de documento que termina como PDF archivado y renombrado.
flowchart LR E1["ETAPA 1
Requerimiento
Q-26-#### · doc cliente AA"] --> E2["ETAPA 2
Cotización
BB-26-#### PDF"] E2 --> E3["ETAPA 3
Orden del cliente
CC-26-#### + nº OC externa"] E3 --> E4["ETAPA 4
Producción / Compra
OC proveedor DD-26-####-01/02/03"] E4 --> E5["ETAPA 5
Entrega
EA-26-#### · Guía F4 · SR F5 · Informe F6"] E5 --> E6["ETAPA 6
Conformidad del cliente
ED/EF-26-#### · Acta F7 · HES"] E6 --> E7["ETAPA 7
Facturación
FF-26-####-01 PDF · -02 XML"] E7 --> E8["ETAPA 8
Seguimiento de pago
PP-26-####"]
| Etapa | Nombre | Campos que dibujó | Documentos / códigos |
|---|---|---|---|
| 1 | Ingreso / Requerimiento | Nº ref, fecha, cliente, descripción, tipo (SER / SUM / DOS), contacto (nombre, cel, email) | Q-26-2607 correlativo · AA-26-2607 doc del cliente (PDF) |
| 2 | Cotización | Nº cotización, fecha, moneda, valor sin IGV | BB-26-2607 PDF renombrado (Formato 1) |
| 3 | Orden del cliente | Nº OC-cliente, fecha, moneda, valor sin IGV, plazo de entrega, fecha de inicio, plazo de pago | CC-26-2607 + nº de la OC externa (ej. +4007673) |
| 4 | Producción / Compra | Proveedor, fecha, moneda, monto, nº cuenta, banco, total (varias OC por operación) | DD-26-2607-01 ·02 ·03 — OC a proveedor, F2 PDF |
| 5 | Entrega | Doc 1/2/3, nº, fecha | EA-26-2607-1 Guía (F4) · -2 Service Report (F5, partes A/B/C) · -3 Informe (F6) |
| 6 | Conformidad del cliente | Doc 1/2, nº, fecha | ED-26-2607 Acta de conformidad (F7) · EF-26-2607 HES del cliente |
| 7 | Facturación | Factura nº (1/2), fecha, monto + IGV | FF-26-2607-01 …PDF · FF-26-2607-02 …XML (SUNAT), F8 |
| 8 | Seguimiento de pago | Fecha de pago, moneda, monto, doc | PP-26-2607 constancia de pago |
El almacén no es una lista plana: es una matriz de familias con atributos condicionales. Todas comparten los atributos base; cada familia agrega los suyos (los ✓ de su cuadro).
| Familia | Subtipos | Nombre | Especif. | Marca | Valor | Fact. compra | Proveedor | Cantidad | Extras condicionales |
|---|---|---|---|---|---|---|---|---|---|
| Herramientas FORMATO | mecánicas · eléctricas · neumáticas · mixtas | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Foto · Peso · Calibración (fecha, doc, próxima) · Mantenimiento |
| Consumibles | EPP · limpieza · otros | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Foto |
| Repuestos FORMATO | importados · nacionales | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Foto · Peso · Dimensión (L·M·A) |
| Equipos FORMATO | predictivo · mecánico · neumático · eléctricos · mixtos | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Calibración · Mantenimiento (fecha, doc, proveedor) |
| Mobiliario | oficina · taller · almacén | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — |
| Instrumentos de medición FORMATO | mecánicos · eléctricos | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Calibración · Mantenimiento · Foto · Peso · Dimensión |
| Vehículos | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Mantenimiento (fecha, doc, proveedor) · Kilometraje |
Las familias marcadas "FORMATO" en el plano tienen una plantilla de documento asociada (ficha de registro/inspección). La anotación suelta "INTERNET" al margen confirma que lo piensa como sistema en la nube, accesible desde el taller.
Doce plantillas de documento, numeradas y con su prefijo de código en rosa. Willhelm distingue tres orígenes: los que el sistema genera, los que SUNAT ya emite (solo se renombran y archivan), y los que se capturan con foto.
| # | Formato | Código | Origen | Notas del plano |
|---|---|---|---|---|
| 1 | Cotización | BB-26-#### | Genera el sistema | Carátula 1/2/3/4, cliente + contacto, solicitud, responsable, descripción, precio, condiciones comerciales (FP · PE · Ga · Re · Val), condiciones generales, anexos |
| 2 | Orden de compra | DB-26-#### | Genera el sistema | Proveedor (nombre, dirección, RUC), contacto, forma de pago, referencia, descripción, precio, condiciones de compra |
| 3 | Solicitud de compra (interna) | DA-26-#### | Genera el sistema | Documento interno previo a la OC |
| 4 | Guía de remisión | EA-26-#### | Automático SUNAT | «Solo renombrar» |
| 5 | Service Report | EB-26-#### | Modelo existente | «Hay modelo» |
| 6 | Informe técnico | EC-26-#### | Modelo existente | «Hay modelo — hacer la primera página» |
| 7 | Acta de conformidad | ED-26-#### | Modelo existente | «Hay» |
| 8 | Factura (PDF + XML) | FA-26-#### | Automático SUNAT | «Solo renombrar» — archiva PDF y XML |
| 9 | Time sheet | — | Foto | Registro fotográfico |
| 10 | Toma foto / servicio | — | Foto | Evidencia de servicio |
| 11 | Para caja / envío | — | Foto | Evidencia de despacho |
| 12 | Boleta de pago personal | — | Foto | Comprobantes de personal |
Willhelm no dibuja transacciones ni asientos: dibuja expedientes. Cada venta es una carpeta con correlativo anual (26-2607) y cada etapa deja dentro un PDF con nombre normado. El sistema que él imagina es, ante todo, un registro con archivador trazable: si mañana ELOR reclama, él abre la operación 2607 y encuentra requerimiento, cotización, OC, guías, acta, factura y constancia de pago, en orden y con el mismo código.
Todo lo resaltado en rosa es nomenclatura. Los prefijos (Q, AA, BB, CC, DD, EA…FF, PP) codifican la etapa; el 26 el año; el correlativo une todo. Para él, «que el sistema funcione» significa que los nombres de archivo salgan solos — de ahí sus notas «automático SUNAT, solo renombrar».
Distingue con precisión qué genera el sistema (cotización, OC), qué ya existe y solo se adjunta (SUNAT, modelos Word de SR/informe) y qué basta fotografiar (time sheets, boletas). Es un diseño pragmático de alguien que hoy hace esto a mano y quiere quitarse fricción, no agregarla.
La categoría A/B/C/D de clientes y A/B de proveedores no es decorativa: es su criterio comercial (a quién atender primero, a quién importar directo). Igual la matriz de almacén: no le interesa un inventario contable sino saber qué tiene, dónde, con qué calibración vigente y qué se le vence.
| Bloque del plano | Ya existe en el sistema | Brecha (gap) |
|---|---|---|
| Clientes + contactos | ✓ tablas clientes, cliente_contactos, perfiles 360 con documentos por etapa | Categoría A/B/C/D y sector codificado (C-GEN, C-MIN…); campos personales del contacto (DNI, cumpleaños, dirección casa) |
| Proveedores | ✓ tabla proveedores, pantalla /proveedores | Categoría internacional/nacional, rubro 1–8, lista de catálogos, acumulado de compras en la ficha |
| Ciclo de 8 etapas | ✓ cotizaciones.etapa: solicitud → cotizada → orden_recibida → en_proceso → entregada → facturada → en_cobranza → liquidada (mapeo casi 1:1) | La numeración/nomenclatura visible tal como él la dibuja (Etapa 1–8 con prefijos de documento por etapa) |
| Codificación XX-26-#### + renombrado automático de PDFs | ✓ parcial: documento_series, cotizacion_adjuntos con categorías | Regla de nombres unificada prefijo-año-correlativo-sufijo aplicada automáticamente al subir/generar cada archivo |
| Etapa 4 — OC a proveedor | ✓ tabla compras | Múltiples OC por operación (-01/-02/-03), banco y nº de cuenta del proveedor, total consolidado |
| Almacén matricial | ✓ items + categorias + attribute_definitions (atributos por categoría), calibración y mantenimiento con alertas | Kilometraje de vehículos; peso/dimensión como atributos estándar de repuestos |
| Formatos 1–8 | ✓ documento_plantillas, editor de plantillas, SR e Informe Técnico ya en /documentos | Formato de solicitud de compra interna (DA); flujo «adjuntar SUNAT → renombrar solo» |
| Formatos 9–12 (foto) | ✓ parcial: item_media, adjuntos | Captura por foto tipificada (time sheet, evidencia de servicio, caja/envío, boletas de personal) colgada del expediente |
Conclusión: el sistema actual ya cubre la estructura; lo que el plano pide con más fuerza y aún falta es la capa de nomenclatura documental automática (el rosa del plano) y las clasificaciones comerciales de clientes/proveedores.