mejor version del wiki 2.0

2026-09-28 17:35:13 -06:00
parent 983e19716d
commit 444706b78e
52 changed files with 4086 additions and 108 deletions
@@ -1,49 +1,60 @@
-# Starlight Starter Kit: Basics
+# Manual de usuario de Eréndira

-[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
+Sitio de documentación en español, construido con el Astro y Starlight existentes en este repositorio.

-```
-npm create astro@latest -- --template starlight
+## 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
 ```

-> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+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:

-## 🚀 Project Structure
-
-Inside of your Astro + Starlight project, you'll see the following folders and files:
-
-```
-.
-├── public/
-├── src/
-│   ├── assets/
-│   ├── content/
-│   │   └── docs/
-│   └── content.config.ts
-├── astro.config.mjs
-├── package.json
-└── tsconfig.json
+```bash
+export PATH="$HOME/.local/share/nvm/v22.23.2/bin:$PATH"
 ```

-Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.
+La dirección local habitual es `http://127.0.0.1:4321/`. El servidor informa la dirección efectiva al arrancar.

-Images can be added to `src/assets/` and embedded in Markdown with a relative link.
+## Compilar y verificar

-Static assets, like favicons, can be placed in the `public/` directory.
+```bash
+npm run build
+python3 scripts/verificar-enlaces.py
+```

-## 🧞 Commands
+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.

-All commands are run from the root of the project, from a terminal:
+## Actualizar el inventario

-| Command                   | Action                                           |
-| :------------------------ | :----------------------------------------------- |
-| `npm install`             | Installs dependencies                            |
-| `npm run dev`             | Starts local dev server at `localhost:4321`      |
-| `npm run build`           | Build your production site to `./dist/`          |
-| `npm run preview`         | Preview your build locally, before deploying     |
-| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
-| `npm run astro -- --help` | Get help using the Astro CLI                     |
+```bash
+python3 scripts/inventario.py ../compras
+```

-## 👀 Want to learn more?
+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.

-Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).
+## 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.