https://github.com/lauta-dev/game-api-nestjs
Este repositorio alberga el código fuente de un proyecto que implementa una API utilizando JavaScript en conjunto con el framework de backend NestJS. La aplicación está diseñada para almacenar datos en una base de datos SQLite.
https://github.com/lauta-dev/game-api-nestjs
nestjs-backend sql sqlite sqlite3 turso
Last synced: about 1 month ago
JSON representation
Este repositorio alberga el código fuente de un proyecto que implementa una API utilizando JavaScript en conjunto con el framework de backend NestJS. La aplicación está diseñada para almacenar datos en una base de datos SQLite.
- Host: GitHub
- URL: https://github.com/lauta-dev/game-api-nestjs
- Owner: Lauta-dev
- Created: 2024-01-27T22:26:34.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-23T13:52:31.000Z (over 1 year ago)
- Last Synced: 2025-09-10T03:10:47.027Z (10 months ago)
- Topics: nestjs-backend, sql, sqlite, sqlite3, turso
- Language: TypeScript
- Homepage: https://game-api-nestjs.vercel.app
- Size: 1.21 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Game API
Este repositorio alberga el código fuente de un proyecto que implementa una API utilizando JavaScript en conjunto con el framework de backend NestJS. La aplicación está diseñada para almacenar datos en una base de datos SQLite.
Esta base de datos cuenta con **35** registros con su:
1. Título
2. Descripción
3. Género
4. Cover/Caratula en **webp** y **jpg**
5. Consola
6. Año de lanzamiento
7. Precio
8. Generación que pertenece el juego
[Ver demo](https://game-api-nestjs-9zti.vercel.app/)
[Probar API](https://game-api-nestjs.vercel.app/)
## Tecnologías Utilizadas
- [NestJS](https://github.com/nestjs/nest): Framework de backend que facilita el desarrollo de aplicaciones escalables y modularizadas en Node.js.
- [SQLite](https://turso.tech/): Alojamiento de la base de datos SQLite.
- [Preact](https://github.com/preactjs/preact): Una alternativa a **React** con una API similar.
- [Hosting Vercel](https://vercel.com): Hosting dónde esta alojada la demo
- [Hosting Render](https://render.com): Hosting dónde esta alojada la API
## Requirementos
- Instalar [Turso](https://turso.tech/)
- [NodeJS](https://nodejs.org/en)
- Tener instalado **NPM** este ya viene con **NodeJS** o [pnpm](https://github.com/pnpm/pnpm)
## Uso de Turso
0. Se tiene que crear una cuenta con GitHub
1. Autenticarse.
```bash
turso auth login
```
2. Crear una base de datos.
```bash
turso db create games
```
### Obtener URL y Token
1. Token
```bash
turso db tokens create games.
```
2. Url
```bash
turso db show games --url
```
> Tanto el **token** como la **url** tienen que ir en un archivo **.env**. [Este es el ejemplo](./backend/env.example).
### Insertar los datos
1. Acceder
```bash
turso db shell games
```
2. En el repo tiene el [La definición de la base de datos](./backend/createTable.sql) y las [sentencias SQL para añadir las columnas](./backend/insertGames.sql).
Solo se tendra que copiar y pegar.
## Iniciarlo en local
#### Clonar el repositorio
```bash
git clone https://github.com/Lauta-dev/render-nestjs.git
```
1.1. Instalar dependencias de la API
```bash
cd ./backend
```
```bash
pnpm install
```
1.2. Levantar API
```bash
pnpm run start:dev
```
2.1. Instalar dependencias del Frontend
```bash
cd ./demo/
```
```bash
pnpm install
```
1.2. Levantar el Frontend
```bash
pnpm run dev
```
## Rutas de la API
- **Ruta:** `/`
- **Método:** `GET`
- **Descripción:** Obtener todos los juegos.
#### Parámetros de Consulta Soportados:
- `limit`, (opcional), **Por defecto el limite es 10 x página**
- **Descripción:** Limita el número de juegos devueltos por página.
- **Tipo**: Number
- `page`, (opcional), **Por defecto es la página 0**
- **Descripción:** Especifica la página de resultados.
- **Tipo**: Number
---
- **Ruta:** `/consoles`
- **Método:** `GET`
- **Descripción:** Obtener todas las consolas de la base de datos.
---
- **Ruta:** `/generations`
- **Método:** `GET`
- **Descripción:** Obtener todas las generaciones de consolas de ls base de datos.
---
- **Ruta:** `/id/:id`
- **Parámetro:** `id`
- **Método:** `GET`
- **Descripción:** Obtener un objeto del juego que se le pase por `id`.
---
- **Ruta:** `/console/:console`
- **Método:** `GET`
- **Descripción:** Obtener todos los juegos de una misma consola.
- **Posibles valores:** ps1, ps2, ps3, ps4, xbox, xbox_360, xbox_one
---
- **Ruta:** `/generation/:generation`
- **Método:** `GET`
- **Descripción:** Obtener todos los juegos de una Generación.
- **Posibles valores:** ps1, ps2, ps3, ps4, xbox, xbox_360, xbox_one