Backend en Node.js + Express que permite crear ruletas, abrirlas para recibir apuestas y cerrarlas generando el resultado ganador. Está conectado a MongoDB mediante Mongoose y expone la documentación interactiva con Swagger UI para facilitar las pruebas.
- Node.js 18+ y npm
- MongoDB en ejecución (por defecto
mongodb://localhost:27017/roulette)
git clone https://github.com/Hertuq0910/roulette-backend.git
cd roulette-backend
npm install
# Arrancar proyecto
npm startEl servidor escucha en http://localhost:3000 (configurable con PORT) y usa la cadena definida en MONGODB_URI si está presente.
- Disponible en
http://localhost:3000/(servido desdepublic/index.html). - Permite seguir todo el flujo: crear, abrir, apostar (con header
user-id) y cerrar ruletas, mostrando las respuestas en pantalla. - No necesita build separado: se sirve con el mismo
npm startdel backend.
Todas las rutas están bajo /api/roulettes (routes/rouletteRoutes.js):
POST /– crea una ruleta con estadocreatedy devuelve suid.PATCH /:id/open– cambia el estado aopensi aún no se ha abierto/cerrado.POST /:id/bets– registra apuestas de tiponumberocolormientras la ruleta está abierta. Requiere headeruser-id. Número entre 0-36, coloresred/black, monto 1-10000.POST /:id/close– sortea un número ganador, calcula los pagos (x5para número,x1.8para color), marca cada apuesta como ganadora o perdedora, y cierra la ruleta.
Los modelos (models/Roulette.js y models/Bet.js) guardan los estados y las apuestas, incluyendo los campos calculados cuando se cierra la ruleta.
- URL:
http://localhost:3000/api-docs - Función: permite visualizar los esquemas, enviar peticiones y guardar el header
user-iddesde el botón Authorize (security schemeuserIdHeader). - Incluye ejemplos de cuerpo, respuestas y errores para cada endpoint.
- Crear ruleta:
POST /api/roulettes. - Abrir ruleta:
PATCH /api/roulettes/{id}/open. - Apostar:
POST /api/roulettes/{id}/betsagregandouser-idy el JSON requerido. - Cerrar ruleta:
POST /api/roulettes/{id}/closepara ver ganador y pagos.
Puedes usar Swagger, Postman o curl. Ejemplo curl para apostar:
curl -X POST "http://localhost:3000/api/roulettes/<id>/bets" \
-H "Content-Type: application/json" \
-H "user-id: demo-user-1" \
-d '{"betType":"color","color":"red","amount":500}'app.js: configuración de Express, conexión a Mongo, rutas y Swagger UI.routes/rouletteRoutes.js: lógica HTTP de creación, apertura, apuestas y cierre.models/Roulette.jsymodels/Bet.js: esquemas Mongoose con estados y resultados.swagger.js: especificación OpenAPI 3.0 utilizada por Swagger UI.