61 lines
3.1 KiB
Markdown
61 lines
3.1 KiB
Markdown
# 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.
|