Ejecuta la agencia en local

Instala e inicia cada aplicación con Node.js y Yarn, una terminal por aplicación.

Para el paquete Full Stack

Antes de empezar: instala Node.js 22 o más reciente y ejecuta corepack enable una vez (en Node.js 25 y posteriores, que no incluyen Corepack, ejecuta antes npm install -g corepack). No hace falta ningún servidor de base de datos.

Ver los requisitos

Abre cada terminal donde la esperan los comandos siguientes: dentro de velra-real-estate-full-stack para el paquete completo, o junto a la carpeta de la aplicación para un paquete de una sola aplicación.

Aplicación	Carpeta	Dirección
API	`back-end`	localhost:8000Local
Sitio web público	`storefront`	localhost:3030Local
Panel de la agencia	`admin-dashboard`	localhost:3031Local

Inicia primero la API: ambos frontends obtienen de ella todos sus datos.

Inicia la API

01
Instala y configura
.env.example funciona tal cual para el desarrollo local: SQLite en el puerto 8000.
Terminal
```
corepack enable
cd back-end
yarn install
cp .env.example .env
```
¿Tienes problemas?
Ya hice este paso
02
Crea la base de datos
yarn seed comprueba que cada foto de la carga inicial esté presente y luego crea database.sqlite, sus tablas y la agencia de demostración: 31 permisos, los roles Super Admin y Agent, las dos cuentas, 11 ajustes de la agencia, 6 barrios, 17 propiedades (15 publicadas, 2 borradores) con 38 fotos de galería, 2 vistas previas de amueblado aprobadas, 5 consultas y 8 solicitudes de visita. Si lo ejecutas otra vez, solo añade lo que falta y nunca restablece una contraseña.
Terminalen back-end
```
yarn seed
```
Ya hice este paso
03
Inicia el servidor
Terminalen back-end
```
yarn dev
```
Resultado esperado: localhost:8000/api/healthLocal responde con "status":"ok" y "database":"up".
¿Tienes problemas?
Ya hice este paso

Inicia la API

01
Instala y configura
.env.example funciona tal cual para el desarrollo local: SQLite en el puerto 8000.
Terminal
```
corepack enable
cd velra-backend
yarn install
cp .env.example .env
```
¿Tienes problemas?
Ya hice este paso
02
Crea la base de datos
yarn seed comprueba que cada foto de la carga inicial esté presente y luego crea database.sqlite, sus tablas y la agencia de demostración: 31 permisos, los roles Super Admin y Agent, las dos cuentas, 11 ajustes de la agencia, 6 barrios, 17 propiedades (15 publicadas, 2 borradores) con 38 fotos de galería, 2 vistas previas de amueblado aprobadas, 5 consultas y 8 solicitudes de visita. Si lo ejecutas otra vez, solo añade lo que falta y nunca restablece una contraseña.
Terminalen velra-backend
```
yarn seed
```
Ya hice este paso
03
Inicia el servidor
Terminalen velra-backend
```
yarn dev
```
Resultado esperado: localhost:8000/api/healthLocal responde con "status":"ok" y "database":"up".
¿Tienes problemas?
Ya hice este paso

Inicia el sitio web público

En una segunda terminal:

01
Instala y configura
El .env copiado apunta el sitio web a la API en el puerto 8000.
Terminal
```
cd storefront
yarn install
cp .env.example .env
```
Ya hice este paso
02
Inícialo
Terminalen storefront
```
yarn dev
```
Resultado esperado: localhost:3030Local abre el sitio web en inglés con los anuncios de demostración; el árabe está en /ar.
¿Tienes problemas?
Ya hice este paso

Inicia el sitio web público

La API no forma parte de este paquete. Iníciala primero; el .env copiado la espera en http://localhost:8000/api.

01
Instala y configura
Si tu API funciona en otro lugar, configura NEXT_PUBLIC_API_BASE_URL en .env con su dirección, incluido /api.
Terminal
```
corepack enable
cd velra-website
yarn install
cp .env.example .env
```
¿Tienes problemas?
Ya hice este paso
02
Inícialo
Terminalen velra-website
```
yarn dev
```
Resultado esperado: localhost:3030Local abre el sitio web con los anuncios de tu API; el árabe está en /ar.
¿Tienes problemas?
Ya hice este paso

Inicia el panel de la agencia

En una tercera terminal:

01
Instala y configura
El .env copiado apunta el panel a la API y a sus notificaciones en directo en el puerto 8000.
Terminal
```
cd admin-dashboard
yarn install
cp .env.example .env
```
Ya hice este paso
02
Inícialo e inicia sesión
yarn dev primero copia el worker de la biblioteca de mapas en public/maplibre/ y luego inicia el panel.
Terminalen admin-dashboard
```
yarn dev
```
Resultado esperado: localhost:3031Local abre el formulario de inicio de sesión. Inicia sesión con admin@velra.example y la contraseña Admin@123.
¿Tienes problemas?
Ya hice este paso

Inicia el panel de la agencia

La API no forma parte de este paquete. Iníciala primero; el .env copiado la espera en http://localhost:8000/api.

01
Instala y configura
Si tu API funciona en otro lugar, configura en .env NEXT_PUBLIC_API_BASE_URL (con /api) y NEXT_PUBLIC_WEBSOCKET_BASE_URL (sin él) con su dirección.
Terminal
```
corepack enable
cd velra-agency-dashboard
yarn install
cp .env.example .env
```
¿Tienes problemas?
Ya hice este paso
02
Inícialo e inicia sesión
Terminalen velra-agency-dashboard
```
yarn dev
```
Resultado esperado: localhost:3031Local abre el formulario de inicio de sesión. Inicia sesión con admin@velra.example y la contraseña Admin@123, que una API con los datos cargados acepta.
¿Tienes problemas?
Ya hice este paso

Otros puertos

Sin Docker los puertos están fijados en los archivos. Los scripts dev y start del sitio web en package.json pasan -p 3030, y los del panel pasan -p 3031: cambia el número ahí para mover uno, luego añade la nueva dirección a CORS_ORIGIN en el .env de la API y, para el panel, pon también allí FRONTEND_URL con ella. Para mover la API, define PORT y PUBLIC_MEDIA_URL en su .env con el mismo número, y NEXT_PUBLIC_API_BASE_URL en ambos frontends (y también NEXT_PUBLIC_WEBSOCKET_BASE_URL en el del panel).

Un puerto ya está en uso

Versión de producción

Las mismas carpetas, construidas una vez y luego iniciadas. Primero configura el .env de la API para producción: con NODE_ENV=production la API nunca cambia las tablas al iniciar, y se niega a iniciar mientras JWT_SECRET esté vacío o siga con el valor de ejemplo, o mientras CORS_ORIGIN esté vacío.

El .env de la API

NODE_ENV=production
JWT_SECRET=paste-the-generated-secret-here
CORS_ORIGIN=http://localhost:3030,http://localhost:3031
FRONTEND_URL=http://localhost:3031
PUBLIC_MEDIA_URL=http://localhost:8000/media

Genera el secreto con node -e "console.log(require('crypto').randomBytes(48).toString('hex'))". Luego, en la carpeta de la API, constrúyela, crea sus tablas una vez e inicia. yarn seed:prod añade la agencia de demostración y sus cuentas; yarn db:sync:prod en su lugar crea tablas vacías sin cuentas.

Terminal

yarn build
yarn seed:prod
yarn start:prod

Despliégalo

Construcción de producción de los frontends

En la carpeta de cada frontend, construye una vez e inicia. El sitio web funciona en el 3030 y el panel en el 3031.

Terminal

yarn build
yarn start

Los frontends compilan su .env en el momento de la construcción, así que ejecuta yarn build otra vez después de cambiarlo. Antes de desplegar en cualquier lugar público, lee la guía de despliegue.

Despliégalo

Empieza de cero con datos de demostración nuevos

Detén la API, elimina el archivo de la base de datos y vuelve a cargar los datos, en la carpeta de la API. Esto elimina todo lo que creaste.

Terminal

rm -f database.sqlite* && yarn seed

En PowerShell:

Terminal

Remove-Item database.sqlite*; yarn seed

Inicia la API

Instala y configura

Crea la base de datos

Inicia el servidor

Inicia la API

Instala y configura

Crea la base de datos

Inicia el servidor

Inicia el sitio web público

Instala y configura

Inícialo

Inicia el sitio web público

Instala y configura

Inícialo

Inicia el panel de la agencia

Instala y configura

Inícialo e inicia sesión

Inicia el panel de la agencia

Instala y configura

Inícialo e inicia sesión

Otros puertos

Versión de producción

Construcción de producción de los frontends

Empieza de cero con datos de demostración nuevos

Siguiente

Preferencias de Cookies