TutorConnect UC - Hackscate 2025

Resumen Ejecutivo

TutorConnect UC es una plataforma web exclusiva para estudiantes de la Pontificia Universidad Católica de Chile que conecta estudiantes que necesitan apoyo académico con tutores certificados de la misma universidad. Con verificación institucional (@uc.cl), códigos de ramos reales (IIC2233, MAT1610, etc.) y recomendaciones inteligentes potenciadas por Gemini AI de Google.

📋 Información del Evento

Campo	Valor
Hackathon	Hackscate 2025
Organiza	Open Source UC
Fecha	5 de diciembre, 9:00 - 18:00 hrs (9 horas)
Lugar	Campus Oriente - Centro de extensión PUC
Categoría	Vida Académica y Colaboración

🎯 El Problema

Problemas que enfrentan los estudiantes UC

Ramos difíciles sin apoyo cercano: Cursos como IIC2233 (Programación Avanzada), MAT1610 (Cálculo II), o FIS1503 (Física) tienen altas tasas de reprobación

Desconfianza en tutores externos: No hay forma de verificar si un tutor realmente aprobó el ramo o tiene la experiencia necesaria

Pérdida de talento estudiantil: Estudiantes destacados que podrían enseñar no tienen una plataforma para compartir su conocimiento

Descoordinación logística: Difícil coordinar horarios, lugares de estudio y expectativas de precio

Falta de transparencia: No hay información clara sobre notas, experiencia o reseñas de tutores

💡 Nuestra Solución

Para Estudiantes (Usuarios)

Funcionalidades para Estudiantes

✅ Buscar tutores por código de ramo específico UC (ej: IIC2233, MAT1610)

✅ Ver perfil completo del tutor con nota de aprobación, semestre cursado, campus y tarifa

✅ Recibir recomendaciones inteligentes de tutores compatibles usando Gemini AI

✅ Leer reseñas verificadas de otros estudiantes UC

✅ Coordinar sesiones presenciales en campus UC

Para Tutores UC

Funcionalidades para Tutores

✅ Verificación automática con correo institucional @uc.cl

✅ Compartir conocimiento y generar ingresos extra

✅ Gestionar disponibilidad por campus (San Joaquín, Casa Central, Lo Contador, Villarrica)

✅ Construir reputación académica con sistema de reseñas

✅ Establecer tarifas propias por sesión de tutoría

⚙️ Stack Tecnológico Completo

Stack Full-Stack

Frontend

Framework: Next.js 14 con App Router + TypeScript

Styling: Tailwind CSS (mobile-first)

Components: Shadcn/UI para componentes accesibles

Forms: React Hook Form

Deploy: Vercel (gratuito, auto-deploy desde GitHub)

Backend

Framework: Laravel 11 (API-only)

Lenguaje: PHP 8.2+

Base de datos: PostgreSQL

Autenticación: Laravel Sanctum (tokens)

Deploy: Railway ($5 gratis/mes incluye PostgreSQL)

IA (Premio Google)

API: Google Gemini API (gemini-1.5-flash)

Uso: Matching inteligente tutor-estudiante

Features: Recomendaciones personalizadas, análisis de compatibilidad

Costo Total

$0 durante hackathon (todo gratuito)

🏗️ Arquitectura del Sistema

graph TB
    A[Next.js Frontend - Vercel] -->|API REST| B[Laravel Backend - Railway]
    B -->|SQL| C[(PostgreSQL - Railway)]
    B -->|API Call| D[Google Gemini AI]
    A -->|Direct API| D

Flujo de Datos

Usuario accede a Next.js (Vercel)

Frontend hace requests a Laravel API (Railway)

Laravel consulta PostgreSQL y/o Gemini AI

Respuesta se renderiza en Next.js

📁 Estructura BDD

🎨 Estructura Frontend Next.js

Estructura de Carpetas

tutorconnect-uc/
├── app/
│   ├── page.tsx                    # Landing page
│   ├── layout.tsx                  # Root layout
│   ├── buscar/
│   │   └── page.tsx               # Búsqueda de tutores
│   ├── tutor/
│   │   └── [id]/
│   │       └── page.tsx           # Perfil individual
│   ├── login/
│   │   └── page.tsx               # Login estudiantes
│   ├── registro/
│   │   ├── estudiante/
│   │   │   └── page.tsx
│   │   └── tutor/
│   │       └── page.tsx
│   └── dashboard/
│       ├── estudiante/
│       │   └── page.tsx
│       └── tutor/
│           └── page.tsx
├── components/
│   ├── ui/                        # Shadcn/UI components
│   ├── TutorCard.tsx
│   ├── SearchBar.tsx
│   ├── FilterPanel.tsx
│   ├── GeminiRecommendations.tsx
│   └── ReviewCard.tsx
├── lib/
│   ├── api.ts                     # Axios config para Laravel API
│   ├── gemini.ts                  # Gemini SDK
│   └── utils.ts
├── hooks/
│   ├── useAuth.ts
│   └── useTutors.ts
├── types/
│   └── index.ts                   # TypeScript types
└── public/
    └── images/

⏱️ Plan de Trabajo - 9 Horas (5 diciembre)

Timeline Crítico IMPORTANTE:

Seguir este timeline estrictamente para completar MVP funcional

Hora 0-2 (9:00-11:00): Setup Completo

Backend Setup

Crear proyecto Laravel 11 (API-only): laravel new tutorconnect-api --api

Configurar PostgreSQL en Railway

Crear .env con credenciales Railway

Ejecutar migraciones

Ejecutar seeders con datos UC

Deploy inicial en Railway

Probar endpoints con Postman

Frontend Setup

Crear proyecto Next.js: npx create-next-app@latest tutorconnect-uc

Instalar dependencias: shadcn/ui, axios, react-hook-form

Configurar Tailwind con colores UC

Deploy inicial en Vercel

Conectar con API Laravel

Hora 2-5 (11:00-14:00): Features Core

Backend

Implementar todos los controladores (Auth, Tutor, Ramo, Review)

Testing endpoints con Postman

Configurar CORS para Next.js

Frontend

Landing page con value proposition

Búsqueda por código de ramo + filtros (campus, precio)

Grid de TutorCards con datos reales de API

Página de perfil de tutor con reviews

Formularios de registro (estudiante/tutor)

Hora 5-7 (14:00-16:00): Gemini AI + Polish

Gemini Integration (Premio Google)

Configurar API Key de Gemini en Laravel

Implementar endpoint /match en backend

Componente GeminiRecommendations.tsx en frontend

Testing matching inteligente

UI Polish

Diseño mobile-first refinado

Animaciones y transiciones

Estados de loading y errores

Responsive design para tablet/desktop

Hora 7-8 (16:00-17:00): Testing & Preparación

Testing Completo

Testing en móvil real (Chrome DevTools)

Testing flujo completo: búsqueda → perfil → Gemini

Fix bugs críticos

Verificar todos los enlaces

Documentación

README.md completo en GitHub

Comentarios en código

Licencia MIT

Hora 8-9 (17:00-18:00): Entrega & Buffer

DEADLINE 17:00 hrs

17:00: Enviar Google Form con:

Link repo GitHub público

Pitch deck PDF (máx. 5 slides)

Verificar deploy Vercel funcionando

Verificar deploy Railway funcionando

Preparar demo de 3-5 minutos

🎯 Criterios de Evaluación - Cómo Vamos a Ganar

Criterio	Peso	Nuestra Fortaleza
Impacto en Vida Universitaria	30%	Problema MUY real: todos en UC necesitamos tutorías. Solución específica para UC con verificación institucional.
Innovación y Creatividad	25%	Primera plataforma UC de tutorías P2P verificadas + Gemini AI para matching inteligente. Full-stack funcional.
Ejecución y Funcionalidad	20%	MVP funcional end-to-end: Backend Laravel + PostgreSQL + Frontend Next.js + Gemini AI todo integrado y funcionando.
Diseño y Accesibilidad (UX/UI)	15%	Mobile-first desde diseño. Shadcn/UI. Aplicación web multiplataforma. Colores UC. Accesible.
Calidad de Presentación (Pitch)	10%	Pitch claro y conciso. Demo en vivo impactante. Problema-Solución-Impacto bien comunicado.

Premio Especial Google

Nuestra implementación de Gemini AI no es cosmética - es funcional y demuestra casos de uso reales educativos. El matching inteligente usa capacidades avanzadas del modelo para análisis contextual y recomendaciones personalizadas.

🚀 Diferenciadores Clave

¿Por qué TutorConnect UC va a ganar?

✅ Específico para UC: Códigos de ramos reales, campus específicos, cultura universitaria conocida

✅ Verificación institucional: Solo estudiantes UC verificados con @uc.cl

✅ Full-stack funcional: Backend Laravel + PostgreSQL + Frontend Next.js integrados

✅ Gemini AI integrado: Recomendaciones inteligentes (Premio Especial Google)

✅ Mobile-first: Diseñado para estudiantes que usan celular constantemente

✅ Transparencia total: Notas, precios, campus y reseñas visibles

✅ Open Source real: Código MIT, puede crecer post-hackathon

✅ Integración futura UC: Preparado para Ubícate, Canvas, etc.

💰 Modelo de Negocio

Fase Hackathon (MVP)

Gratis para validar Plataforma 100% gratuita para validar concepto y ganar tracción inicial.

Post-Hackathon

Fuentes de Ingreso

Comisión por transacción: 10-15% de cada tutoría agendada exitosamente

Suscripción Premium para tutores: $4.990/mes

Perfil destacado en búsquedas

Estadísticas avanzadas

Sin límite de tutorías

Alianzas institucionales UC:

Licencia institucional

Integración con sistemas UC (Canvas, Ubícate)

Validación automática de ramos aprobados

Proyección Conservadora

Con 100 tutores activos realizando 4 tutorías/mes a $15.000 * * c a d a u na, co n * * 12$ 720.000/mes recurrente

📊 Roadmap Post-Hackathon

Fase	Timeframe	Objetivos
Mes 1-2	Enero-Febrero	Backend real con pagos (Webpay), calendario, notificaciones push
Mes 3-4	Marzo-Abril	Lanzamiento público UC, integración Ubícate, sistema de mensajería
Mes 5-6	Mayo-Junio	Expansión a otras universidades, app móvil nativa, dashboard analytics

🎨 Diseño Mobile-First

Paleta de Colores UC

Color Hex Uso
Azul UC #002D5E Color primario, headers, botones principales
Dorado UC #D4AF37 Acentos, highlights, elementos premium
Gris Claro #F3F4F6 Fondos, cards, secciones alternadas
Gris Medio #9CA3AF Textos secundarios, placeholders
Gris Oscuro #1F2937 Textos principales, contenido

Color	Hex	Uso
Azul UC	`#002D5E`	Color primario, headers, botones principales
Dorado UC	`#D4AF37`	Acentos, highlights, elementos premium
Gris Claro	`#F3F4F6`	Fondos, cards, secciones alternadas
Gris Medio	`#9CA3AF`	Textos secundarios, placeholders
Gris Oscuro	`#1F2937`	Textos principales, contenido

Principios de Diseño

Mobile primero: Diseñar en 375px (iPhone), luego escalar

Accesibilidad WCAG AA: Contraste, labels, navegación por teclado

Performance: Lazy loading, optimización de assets

UX Clara: Máximo 3 clicks para cualquier acción crítica

Touch-friendly: Botones grandes (min 44x44px)

✅ Checklist Pre-Hackathon

Antes del 30 de noviembre

Inscripción

Inscripción completada en Major League Hacking

Leer y aceptar Código de Conducta Open Source UC

Confirmar asistencia para el 5 de diciembre

Antes del 5 de diciembre

Preparación Técnica

Cuenta GitHub lista y configurada

Cuenta Vercel conectada a GitHub

Cuenta Railway creada ($5 gratis)

API Key de Google Gemini configurada y probada

Laravel 11 instalado localmente

PostgreSQL instalado localmente (Docker o nativo)

Postman configurado para testing APIs

Estudiar códigos de ramos UC más demandados

Diseño y Datos

Wireframes básicos mobile-first diseñados

Lista de 30+ ramos UC reales con códigos

Campus UC conocidos (San Joaquín, Casa Central, Lo Contador, Villarrica)

Hardware

Laptop cargada + cargador + mouse

Celular para probar versión móvil

Snacks y agua para el día

El día del evento (5 de diciembre)

Day-of Checklist

Llegar 9:00 am Campus Oriente - Centro de extensión UC

Conectar con mentores y organizadores

Seguir timeline estricto de 9 horas

ENVIAR ANTES DE 17:00 hrs (Google Form):

Link repo GitHub público

Pitch deck PDF (máx. 5 slides)

Preparar demo de 3-5 minutos para presentación

🎤 Pitch de Elevator (30 segundos)

Discurso para Jueces

“¿Alguna vez reprobaste un ramo porque no encontraste ayuda a tiempo? ¿O sacaste un 4.0 cuando sabías que podías sacar un 6.0 con el apoyo correcto?

TutorConnect UC conecta estudiantes UC con tutores verificados de su misma universidad. No son profesores externos - son compañeros que ya aprobaron ese ramo específico y saben exactamente lo que estás viviendo.

Verificamos cada tutor con su @uc.cl, mostramos la nota con la que aprobaron, y usamos Gemini AI de Google para recomendarte los mejores 3 tutores para tu perfil.

Es como Uber, pero para tutorías universitarias. Mobile-first, transparente, y hecho por estudiantes UC para estudiantes UC.”

📝 Entregables Finales

DEADLINE: 17:00 hrs - 5 diciembre

1. Repositorio GitHub Público

Código completo (backend + frontend)

README.md detallado

Licencia MIT (archivo LICENSE)

Commits organizados

2. Pitch Deck PDF (máx. 5 slides)

Slide 1: Problema (con datos/estadísticas UC) Slide 2: Solución (screenshots de la app) Slide 3: Stack Tecnológico + Gemini AI Slide 4: Demo/Screenshots Slide 5: Impacto + Roadmap futuro

🏆 Por Qué Vamos a Ganar

Factores de Éxito

✅ Problema validado y real: TODOS en UC hemos necesitado tutorías

✅ Solución técnicamente sólida: Full-stack funcional (no solo mocks)

✅ Diferenciación clara: Específico UC + verificación institucional

✅ Premio Especial Google: Gemini AI funcional y bien implementado

✅ Mobile-first real: Diseño responsive desde día 1

✅ Open Source genuino: Código MIT, puede crecer post-hackathon

✅ Modelo de negocio viable: Múltiples fuentes de ingreso

✅ Impacto social directo: Reduce tasas de reprobación UC

✅ Potencial de integración: Con Ubícate y otros proyectos OSS UC

✅ Ejecución realista: Plan hora por hora bien definido

📚 Referencias y Recursos

Documentación Técnica

Ramos UC Populares

IIC2233 - Programación Avanzada (Python)
MAT1610 - Cálculo II
FIS1503 - Física General II
IIC2413 - Bases de Datos
IIC2143 - Ingeniería de Software
MAT1620 - Álgebra Lineal
IIC2613 - Inteligencia Artificial
EYP1113 - Introducción a la Ingeniería

Motivación Final

“El mejor momento para usar TutorConnect UC fue antes de reprobar ese ramo. El segundo mejor momento es ahora, en Hackscate 2025.”

¡Vamos a ganar! 🚀

Documento creado para Hackscate 2024
Organiza: Open Source UC
5 de diciembre de 2024, 9:00-18:00 hrs
Campus Oriente - Centro de extensión PUC

Sebastian's Notes

Explorador

TutorConnect UC

TutorConnect UC - Hackscate 2025

📋 Información del Evento

🎯 El Problema

💡 Nuestra Solución

Para Estudiantes (Usuarios)

Para Tutores UC

⚙️ Stack Tecnológico Completo

Frontend

Backend

IA (Premio Google)

Costo Total

🏗️ Arquitectura del Sistema

📁 Estructura BDD

🎨 Estructura Frontend Next.js

Estructura de Carpetas

⏱️ Plan de Trabajo - 9 Horas (5 diciembre)

Hora 0-2 (9:00-11:00): Setup Completo

Hora 2-5 (11:00-14:00): Features Core

Hora 5-7 (14:00-16:00): Gemini AI + Polish

Hora 7-8 (16:00-17:00): Testing & Preparación

Hora 8-9 (17:00-18:00): Entrega & Buffer

🎯 Criterios de Evaluación - Cómo Vamos a Ganar

🚀 Diferenciadores Clave

💰 Modelo de Negocio

Fase Hackathon (MVP)

Post-Hackathon

📊 Roadmap Post-Hackathon

🎨 Diseño Mobile-First

✅ Checklist Pre-Hackathon

Antes del 30 de noviembre

Antes del 5 de diciembre

El día del evento (5 de diciembre)

🎤 Pitch de Elevator (30 segundos)

📝 Entregables Finales

1. Repositorio GitHub Público

2. Pitch Deck PDF (máx. 5 slides)

🏆 Por Qué Vamos a Ganar

📚 Referencias y Recursos

Documentación Técnica

Ramos UC Populares

Vista Gráfica

Tabla de Contenidos