David
e3f92fa534
- Added pnpm-workspace.yaml to define package structure. - Created prepare-local-env.py script for local environment setup. - Introduced tsconfig.json for TypeScript configuration. - Added turbo.json for task management with Turbo.
47 lines
1.9 KiB
Markdown
47 lines
1.9 KiB
Markdown
# Puesta en marcha
|
|
|
|
## Entorno
|
|
|
|
El repositorio está en /home/david/dev/metis-desk, dentro de WSL2 Ubuntu-24.04. Necesita Node.js 24.x, PNPM 11.25.0 y Docker disponible desde WSL. No depende de paquetes locales de factuges-erp.
|
|
|
|
Desde una terminal Ubuntu-24.04:
|
|
|
|
```bash
|
|
cd /home/david/dev/metis-desk
|
|
pnpm install --frozen-lockfile
|
|
pnpm db:up
|
|
pnpm dev
|
|
```
|
|
|
|
pnpm db:up genera .env con secretos locales si no existe e inicia MariaDB en un volumen persistente. No crea usuarios de la aplicación. El servidor aplica las migraciones al arrancar.
|
|
|
|
Abrir http://localhost:5173. La primera apertura permite crear el administrador inicial; las siguientes muestran el acceso. La API escucha en 127.0.0.1:3001 y la base de datos en 127.0.0.1:3307.
|
|
|
|
Consultar [Usuarios y acceso](usuarios-y-acceso.md) para la configuración inicial y protección de cuentas. No borrar el volumen para actualizar o reiniciar: contiene usuarios, compañías, contactos y sedes.
|
|
|
|
Si se cambia PORT, configurar API_PROXY_TARGET al arrancar Vite (por defecto http://127.0.0.1:3001). Si cambia el origen del navegador, actualizar APP_ORIGIN en .env.
|
|
|
|
## Verificaciones
|
|
|
|
```bash
|
|
pnpm typecheck
|
|
pnpm lint
|
|
pnpm test
|
|
pnpm check
|
|
pnpm build
|
|
```
|
|
|
|
La base local debe estar encendida para las pruebas de integración. Estas solo usan metis_desk_test. La compilación genera apps/server/dist y apps/web/dist.
|
|
|
|
Para ejecutar la API compilada, parar primero el servidor de desarrollo:
|
|
|
|
```bash
|
|
pnpm --filter @metis/server start
|
|
```
|
|
|
|
## Alcance
|
|
|
|
Hay acceso, sesiones persistentes, gestión de usuarios, compañías clientes con contactos y sedes y una página inicial que comprueba la conexión. Inventario y tickets siguen pendientes. Las tablas nuevas se crean al arrancar la API mediante migraciones explícitas.
|
|
|
|
La API compilada todavía no sirve la interfaz estática. El despliegue, proxy HTTPS, backups y recuperación de acceso se definirán en una entrega posterior.
|