Loading repository data…
CrIsTiAnPvP / repository
Este proyecto es OpenSource. Enfocado en el aprendizaje de uso de aplicaciones para Oauth, bases de datos no relacionales-NoSQL, y NextJs Con React y TypeScript.
Futbolisimos es una plataforma web diseñada para los amantes del fútbol. Permite a los usuarios crear ligas, invitar amigos, gestionar equipos y competir entre ellos. Este README documenta la estructura del proyecto, con un enfoque especial en la API, para que cualquier desarrollador o usuario técnico pueda entender cómo funciona y cómo interactuar con el sistema.
Futbolisimos permite a los usuarios:
El proyecto utiliza Next.js como framework principal, con soporte para internacionalización (i18n) y autenticación mediante NextAuth. La base de datos está gestionada con Prisma y se utiliza MongoDB como sistema de almacenamiento.
El proyecto está organizado de la siguiente manera:
Futbolisimos-Web/
├── src/
│ ├── app/
│ │ ├── [locale]/ # Páginas organizadas por idioma
│ │ ├── api/ # Endpoints de la API
│ │ └── layout.tsx # Layout principal
│ ├── components/ # Componentes reutilizables
│ ├── i18n/ # Configuración de internacionalización
│ ├── lib/ # Utilidades compartidas
│ ├── prisma/ # Configuración de Prisma
│ └── provider/ # Proveedores de contexto (e.g., sesión)
├── .env # Variables de entorno
├── README.md # Documentación del proyecto
└── package.json # Dependencias del proyecto
.env.envEl archivo .env debe contener las siguientes variables de entorno para el correcto funcionamiento del proyecto. Asegúrate de configurarlas con los valores adecuados:
# Base de datos
DATABASE_URL="mongodb+srv://<usuario>:<contraseña>@<cluster>.mongodb.net/<nombre_base_datos>"
# Entorno de desarrollo
NODE_ENV=development
# Configuración de autenticación
AUTH_TRUST_HOST=true
# AUTH_REDIRECT_PROXY_URL=<url_proxy_redireccion>
# NEXTAUTH_URL_INTERNAL=<url_interna_nextauth>
# Credenciales de OAuth
AUTH_GITHUB_ID=<id_github>
AUTH_GITHUB_SECRET=<secreto_github>
AUTH_GOOGLE_ID=<id_google>
AUTH_GOOGLE_SECRET=<secreto_google>
AUTH_SPOTIFY_ID=<id_spotify>
AUTH_SPOTIFY_SECRET=<secreto_spotify>
# Claves públicas
NEXT_PUBLIC_API_KEY=<clave_api>
NEXT_PUBLIC_API_URL=<url_api>
NEXT_PUBLIC_INVITE_URL=<url_invitaciones>
# Secreto de autenticación
AUTH_SECRET=<secreto_autenticacion>
Asegúrate de no compartir este archivo públicamente, ya que contiene información sensible.
Clona el repositorio:
git clone https://github.com/tu-usuario/Futbolisimos-Web.git
cd Futbolisimos-Web
Instala las dependencias:
pnpm install
Configura las variables de entorno en el archivo .env:
DATABASE_URL="mongodb+srv://<usuario>:<contraseña>@<cluster>.mongodb.net/futbolisimos"
NEXT_PUBLIC_API_KEY="tu-api-key"
Ejecuta el servidor de desarrollo:
pnpm run dev
La API de Futbolisimos está organizada en diferentes endpoints que permiten gestionar usuarios, ligas, invitaciones y equipos. A continuación, se documentan los principales endpoints:
POST /api/auth
Descripción: Maneja la autenticación de usuarios.
Requiere: Credenciales de OAuth (GitHub, Google, etc.).
Respuesta:
{
"user": {
"id": "123",
"name": "Usuario",
"email": "usuario@example.com"
}
}
GET /api/user
id (string): ID del usuario.{
"user": {
"id": "123",
"name": "Usuario",
"email": "usuario@example.com"
}
}
POST /api/account
Descripción: Actualiza la información de un usuario.
Cuerpo de la solicitud:
{
"id": "123",
"name": "Nuevo Nombre",
"apiKey": "tu-api-key"
}
Respuesta:
{
"message": "User updated successfully"
}
GET /api/league
Descripción: Obtiene información de una liga por su ID.
Parámetros de consulta:
id (string): ID de la liga.Respuesta:
{
"liga": {
"id": "456",
"nombre": "Liga Ejemplo",
"descripcion": "Descripción de la liga",
"cantidadMiembros": 10
}
}
POST /api/league/create
Descripción: Crea una nueva liga.
Cuerpo de la solicitud:
{
"id": "123",
"name": "Liga Ejemplo",
"description": "Descripción de la liga",
"image": "https://example.com/image.png",
"maxMembers": 20,
"apiKey": "tu-api-key",
"privateLeague": true
}
Respuesta:
{
"message": "League created successfully",
"league": {
"id": "456",
"nombre": "Liga Ejemplo"
}
}
DELETE /api/league/delete
Descripción: Elimina una liga existente.
Cuerpo de la solicitud:
{
"id": "456",
"apiKey": "tu-api-key"
}
Respuesta:
{
"message": "League deleted successfully"
}
POST /api/league/[liga]/invite/create
Descripción: Crea una invitación para una liga.
Cuerpo de la solicitud:
{
"id": "123",
"apiKey": "tu-api-key",
"privada": true
}
Respuesta:
{
"message": "Invitation created successfully"
}
DELETE /api/league/[liga]/invite/delete
Descripción: Elimina una invitación existente.
Cuerpo de la solicitud:
{
"id": "789",
"apiKey": "tu-api-key"
}
Respuesta:
{
"message": "Invitation deleted successfully"
}
GET /api/team/eteam
Descripción: Obtiene los 10 equipos mejor valorados.
Respuesta:
[
{
"id": "1",
"nombre": "Equipo 1",
"valor": 100
},
{
"id": "2",
"nombre": "Equipo 2",
"valor": 95
}
]
¡Las contribuciones son bienvenidas! Si deseas colaborar, por favor sigue estos pasos:
Haz un fork del repositorio.
Crea una rama para tu funcionalidad:
git checkout -b feature/nueva-funcionalidad
Realiza tus cambios y haz un commit:
git commit -m 'Añadir nueva funcionalidad'
Envía un pull request.
Si tienes preguntas o problemas, no dudes en abrir un issue en el repositorio.
¡Gracias por ser parte de Futbolisimos!
Selected from shared topics, language and repository description—not editorial ratings.
joseyx /
Este proyecto es una API REST construida con Express y TypeScript que permite obtener y almacenar tasas de cambio. La API incluye documentación generada con Swagger y utiliza Prisma como ORM para interactuar con una base de datos PostgreSQL.
drfcozapata /
Este proyecto es una API Rest desarrollada usando Node.js, Express, TypeScript, JWT y MySQL para la creación de endpoints para hacer registro y login de usuarios y tiene una tabla ejemplo de productos que permite practicar el uso de JWT para la autenticación de usuarios.
felipeinf /
Deno es el más moderno y seguro entorno de ejecución para Typescript, este proyecto es un ejemplo de servidor API REST desarrollado con Ts y Deno implementando una arquitectura de capas y Clean Architecture+.
EnzoAMelgarejo /
Este proyecto es una API RESTful desarrollada con Node.js y TypeScript, que utiliza Prisma como ORM para interactuar con una base de datos PostgreSQL. Implementa un sistema de autenticación basado en JWT para proteger rutas y operaciones CRUD de usuarios. Todo el entorno está gestionado mediante Docker para facilitar su despliegue y ejecución.
Giovaolmos /
Este proyecto fue parte de mi especialización en Back-End en Henry, es una API REST, acá pude poner a prueba todos los conocimientos adquiridos en la especialización.
CrIsTiAnPvP /
Este proyecto es en base a una tarea del módulo SRI en el cual se pide usar la api de nuestro proveedor de dominio, para hacer un acortador de URLs mediante registros TXT.