Importadora León · Documentación técnica

Documentación del sistema

Mapa completo del proyecto: la arquitectura, los modelos de datos, la API del backend, interfaces de usuario y cada componente que lo compone. Se recomienda comenzar por la arquitectura general y descender al detalle desde ahí.

Arquitectura del ERP→

Diagrama vivo del conjunto: el catálogo público, el panel de gestión, las analíticas del negocio, sus bases de datos y los servicios externos con los que integra. El punto de entrada a la documentación.

Modelo de datos

Esquema de datos Oficial
El modelo canónico del negocio, tabla por tabla y campo por campo. La fuente de verdad del esquema.
bases-de-datos.html
Relaciones entre tablas Partida v1
Esquema inicial y tablas puente. Se conserva como referencia del punto de partida del diseño.
connect-tables-db.html

Backend

API del backend Oficial
El contrato REST documentado endpoint por endpoint y agrupado por dominio: catálogo, inventario, compras, ventas y facturación.
backend-api.html
Visión general del backend
Qué es el backend (Django + DRF), de qué se encarga y su stack tecnológico. La perspectiva de componente.
el-motor.html

Datos y almacenamiento

Base de datos principal
PostgreSQL: el repositorio persistente del negocio. También resuelve las consultas de búsqueda.
base-principal.html
Caché en memoria
Redis: gestiona el carrito de compra y la cola de tareas en segundo plano.
memoria-rapida.html
Almacenamiento de archivos
Gestión de ficheros: imágenes de producto y documentos.
almacenamiento.html
Motor de búsqueda Función de Postgres
Búsqueda instantánea mediante pg_trgm, integrada en la base de datos. No constituye un servicio independiente.
buscador.html

Interfaces de usuario

Catálogo público
La tienda online: donde los clientes consultan productos y realizan sus compras.
catalogo-publico.html
Panel de gestión
El back-office: desde donde el equipo administra la operativa completa del negocio.
panel-gestion.html
Reportes y analítica Prototipo
Dashboard del back-office: KPIs y gráficos (Chart.js) sobre datos simulados.
panel-reportes.html

Operación e integraciones

Servicios externos
Integraciones con SUNAT para comprobantes electrónicos, pasarela de pagos y courier de envíos.
servicios-externos.html
Tareas automáticas
Celery: procesamiento en segundo plano de facturas y notificaciones.
tareas-automaticas.html

Legal

Aviso legal
Identificación del titular (razón social, RUC, domicilio) y condiciones generales de uso del sitio.
legal-aviso.html
Términos y condiciones
Reglas de compra mayorista y minorista: precios, comprobantes SUNAT, pagos, envíos, devoluciones y garantía.
legal-terminos.html
Política de privacidad
Tratamiento de datos personales conforme a la Ley N° 29733 y derechos ARCO del cliente.
legal-privacidad.html
Política de cookies
Qué cookies utiliza el sitio, con qué finalidad y cómo gestionarlas o desactivarlas.
legal-cookies.html
Libro de reclamaciones
Registro de reclamos y quejas exigido por Indecopi (Código del Consumidor, Ley N° 29571).
legal-libro-reclamaciones.html

Dos documentos prevalecen sobre el resto: Esquema de datos (el modelo) y API del backend (el contrato del backend). Ante cualquier discrepancia, estos dos tienen prioridad. Los documentos del apartado Legal son modelos orientativos.