# 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.

```bash
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:

```bash
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

```bash
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

```bash
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](https://docs.astro.build/en/guides/content-collections/) y la navegación sigue la [configuración de Starlight](https://starlight.astro.build/reference/configuration/). El contenido operativo procede del proyecto local de compras.