> For the complete documentation index, see [llms.txt](https://softypaq.gitbook.io/centro-de-ayuda-softypaq/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://softypaq.gitbook.io/centro-de-ayuda-softypaq/tabla-de-contenidos/introduccion.md). # Introducción ## Manual de usuario — Softypaq Softypaq es el sistema de gestión de paquetería que administra todo el ciclo de una guía de envío: desde la captura de datos geográficos y clientes, hasta la generación de guías, la organización de recolecciones en campo y la impresión de etiquetas. El sistema tiene dos partes con audiencias distintas: * **Panel administrativo** (navegador de escritorio): lo usa el personal de oficina para dar de alta clientes, consignatarios, vehículos y usuarios; crear y gestionar guías; organizar rutas y coberturas; y armar los manifiestos de recolección que se asignan a los operadores. * **App del Operador** (navegador móvil, funciona sin conexión): la usa el personal de campo para iniciar su jornada con un vehículo y una ruta, ver las recolecciones que tiene asignadas y escanear los paquetes conforme los va recogiendo. > **Nota sobre el alcance de este manual.** Este manual se generó a partir del análisis directo del código fuente del proyecto, no de documentación previa (el `README.md` original del repositorio es el genérico de plantilla y no describía el sistema). Cubre lo que cada pantalla hace según su implementación actual. Algunos comportamientos de borde (mensajes de error específicos, reglas de negocio no evidentes en la interfaz) pueden no estar documentados si no eran verificables directamente en el código de la interfaz. ### Cómo está organizado este manual * **Geografía** — el catálogo base de estados, municipios, asentamientos y códigos postales sobre el que se apoya todo lo demás. * **Distribución** — cómo se definen las rutas de reparto y qué zonas (coberturas) atiende cada una. * **Operación** — el trabajo del día a día: crear guías y organizar recolecciones. * **Administración** — catálogos de apoyo: plantillas de impresión, clientes, consignatarios, vehículos, usuarios y configuración visual del sistema. * **App del Operador** — el manual específico para el personal de campo. ### Requisitos previos Para usar el panel administrativo se necesita una sesión iniciada con un usuario válido del sistema. Para usar la App del Operador se necesita, además, tener un vehículo y una ruta previamente dados de alta en el panel administrativo (secciones **Vehículos** y **Rutas**). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://softypaq.gitbook.io/centro-de-ayuda-softypaq/tabla-de-contenidos/introduccion.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.