Manual de usuario de Eréndira
Sitio de documentación en español, construido con el Astro y Starlight existentes en este repositorio.
Contenido
- Inicio con accesos a los siete roles de compras confirmados por la organización.
- Menú de tareas para Solicitante, Comprador, Autorizador, Almacén, Contabilidad, Proveedor y Administrador.
- Campos, requisitos, filtros, acciones y conexiones entre pantallas.
- Solicitudes, concursos, cotizaciones, pedidos, autorizaciones, recepciones, evidencias, contratos, facturas, pagos y catálogos.
- Inventario de 60 vistas Vue, 38 componentes, 46 controladores Laravel y 35 plantillas Blade, con relación a sus guías.
Las guías son archivos editables en src/content/docs/. astro.config.mjs define los menús y src/styles/manual.css los estilos. analysis/inventario.json guarda las fuentes y sus huellas para mantenimiento.
Ejecutar
Usa una versión de Node compatible con el proyecto. La compilación se verificó con Node 22.23.2 y las dependencias del lockfile existente.
npm ci
npm run dev -- --background --host 127.0.0.1
npm run astro -- dev status
npm run astro -- dev logs
npm run astro -- dev stop
En el entorno de creación, Node está instalado en ~/.local/share/nvm/v22.23.2/bin; si no está en el PATH de la terminal:
export PATH="$HOME/.local/share/nvm/v22.23.2/bin:$PATH"
La dirección local habitual es http://127.0.0.1:4321/. El servidor informa la dirección efectiva al arrancar.
Compilar y verificar
npm run build
python3 scripts/verificar-enlaces.py
El resultado estático queda en dist/, con búsqueda Pagefind. Para publicar, configura el dominio real en site dentro de astro.config.mjs y sirve dist/ desde la raíz del dominio. No se configuró un dominio ficticio. Si se publica en una subcarpeta, hay que adaptar base y los enlaces absolutos.
Actualizar el inventario
python3 scripts/inventario.py ../compras
Este comando actualiza la tabla de cobertura y las huellas; no actualiza las instrucciones funcionales. Revisa primero el cambio en Vue/Laravel y edita la guía correspondiente. Los mapeos están en el script para identificar archivos nuevos y asignarles su documentación.
Alcance de la revisión
Se trabajó con el código local el 28 de septiembre de 2026. La organización confirmó los siete roles y el flujo de recepciones parciales: evidencia de servicios por Solicitante y de materiales por Almacén. No se ejecutaron operaciones contra una base de datos de compras ni se modificó el proyecto de origen.
Las diferencias entre frontend y backend, pantallas sin ruta y dependencias de configuración están documentadas en src/content/docs/referencia/observaciones.md. Los controles de los tableros externos no forman parte del repositorio de compras.
Referencias del sitio
La estructura de contenido usa las colecciones de Astro y la navegación sigue la configuración de Starlight. El contenido operativo procede del proyecto local de compras.