docs: README completo para Windows/Linux/macOS + fix conflicto de puertos

- README.md reescrito con instrucciones detalladas para principiantes y expertos
  * Tabla de contenidos con 14 secciones
  * Inicio rápido con Docker (Windows, Linux, macOS)
  * Configuración de variables de entorno con explicaciones
  * Sección de desarrollo local sin Docker
  * Comandos útiles (Docker, Alembic, calidad de código, testing)
  * Solución de problemas extensa (puertos, módulos, tenant, migraciones, Node.js)
  * Historial de versiones

- Fix: conflicto de puertos cuando ambos frontends corren en local
  * frontend-internal/vite.config.js: usa PORT=3001 por defecto (3000 en Docker)
  * frontend-internal/package.json: dev script sin puerto hardcodeado
  * docker-compose.yml: frontend-internal recibe PORT=3000 como variable de env
This commit is contained in:
2026-02-26 09:02:04 -07:00
parent bd21207aae
commit ba94152074
4 changed files with 712 additions and 133 deletions

View File

@@ -189,6 +189,7 @@ services:
- NODE_ENV=${ENVIRONMENT:-development}
- PUBLIC_API_URL=http://backend:8000
- PUBLIC_APP_NAME=ServiceManager Admin
- PORT=3000 # El contendor corre en 3000; docker mapea 3001:3000 al host
volumes:
- ./frontend-internal:/app
- /app/node_modules