Plataforma escalable de gestión de reservas que permite a profesionales ofrecer servicios de agendamiento a sus clientes.

🏗️ Arquitectura del Proyecto

TurnoLink/
├── api/          # Backend .NET 9 (3-tier architecture)
│   ├── TurnoLink.WebAPI/         # Web API Layer
│   ├── TurnoLink.Business/       # Business Layer
│   └── TurnoLink.DataAccess/     # Data Access Layer
└── client/       # Frontend Next.js 16
│   ├── app/
│   ├── components/
│   ├── hooks/
│   ├── i18n/
│   ├── lib/
│   ├── messagges/
│   └── public/
└── docs/

🚀 Inicio Rápido

Requisitos Previos

• .NET 9 SDK
• PostgreSQL 18
• Node.js 22

Configuración Backend

1. Configurar base de datos:

# Asegúrate de que PostgreSQL esté corriendo
# Puerto: 55000 (o el que uses localmente)

2. Configurar variables locales:

cd api/TurnoLink.WebAPI
cp appsettings.Development.example.json appsettings.Development.json
# Editar appsettings.Development.json con tus credenciales

3. Aplicar migraciones:

cd api
dotnet ef database update --project TurnoLink.DataAccess --startup-project TurnoLink.WebAPI

4. Ejecutar API:

dotnet run --project TurnoLink.WebAPI
# API disponible en: https://localhost:5001
# Swagger: https://localhost:5001/swagger

Ver README del backend para más detalles.

🔐 Seguridad

⚠️ Archivos sensibles NO versionados:

• appsettings.Development.json - Credenciales locales
• .env* - Variables de entorno
• *.secrets.json - Secretos de usuario

✅ Usa los archivos .example como plantilla para tu configuración local.

📚 Documentación

• Instrucciones de desarrollo AI
• Backend README
• Frontend README (próximamente)

🛠️ Stack Tecnológico

Backend (.NET 9)

• Framework: ASP.NET Core 9
• ORM: Entity Framework Core 9
• Base de datos: PostgreSQL
• Autenticación: JWT Bearer Tokens
• Documentación: Swagger/OpenAPI

Frontend (Next.js 15) - Próximamente

• Framework: Next.js 15 (App Router)
• UI: Por definir
• Estado: Por definir

📝 Flujo de Trabajo

Backend

# Desarrollo con recarga automática
cd api
dotnet watch --project TurnoLink.WebAPI

# Crear nueva migración
dotnet ef migrations add NombreMigracion --project TurnoLink.DataAccess --startup-project TurnoLink.WebAPI

# Compilar
dotnet build

Branching Strategy

• main - Producción estable
• develop - Rama de desarrollo
• feature/* - Nuevas funcionalidades

🧪 Testing

# Ejecutar tests (cuando estén implementados)
cd api
dotnet test

🤝 Contribución

1. Crear rama desde develop: git checkout -b feature/nombre-feature
2. Hacer cambios y commits
3. Push y crear Pull Request a develop
4. Code review y merge

📄 Licencia

Proyecto privado - Todos los derechos reservados

👥 Autores

• Equipo TurnoLink

---

Nota: Este proyecto está en desarrollo activo. La documentación se actualiza constantemente.