Directorio de profesores
Ruta: /profesores (Astro SSR) · Auth: Ninguna (publica)
Pagina publica que lista todos los profesores con servicios activos. Incluye un quiz de compatibilidad, filtros de busqueda y tarjetas con informacion resumida de cada profesor.
Que hay
Section titled “Que hay”Quiz de compatibilidad
Section titled “Quiz de compatibilidad”Formulario de 5 preguntas (HTML nativo, sin JavaScript) que redirige a /profesores con query params:
- Objetivo: Conversacion, examen, trabajo, viaje, otro
- Nivel actual: Principiante → Avanzado
- Horario preferido: Manana, tarde, noche, fines de semana
- Horas por semana: 1-2h, 3-4h, 5+h
- Estilo de aprendizaje: Estructurado, conversacional, mixto
El quiz se muestra solo cuando no hay filtros activos.
Filtros de busqueda
Section titled “Filtros de busqueda”Panel lateral con:
- Busqueda por texto (nombre, headline)
- Especialidad (select con opciones del API)
- Idioma (select)
- Rango de precio (minimo/maximo)
Todos los filtros se envian como query params a la misma pagina (SSR, sin JS).
Atribucion de referral
Section titled “Atribucion de referral”Los links del directorio a perfiles de profesores NO incluyen ?ref=direct.
Esto significa que cualquier alumno que llegue desde el directorio se registra con
referralSource: 'directory' (lead de PinTeach). Solo los enlaces directos compartidos
por el profesor llevan ?ref=direct.
Tarjetas de profesores
Section titled “Tarjetas de profesores”Grid responsive (1-3 columnas) con tarjetas que muestran:
- Avatar + badge Super Tutor
- Nombre y headline
- Materias (tags)
- Rating promedio + total de resenas
- Precio desde (servicio mas barato)
- Badge de disponibilidad proxima
- Link al perfil completo
Referencia tecnica
Section titled “Referencia tecnica”Archivos clave
Section titled “Archivos clave”| Archivo | Proposito |
|---|---|
apps/pinteach-web/src/pages/profesores/index.astro | Pagina del directorio |
apps/pinteach-web/src/components/directory/TeacherCard.astro | Tarjeta de profesor |
apps/pinteach-web/src/components/directory/CompatibilityQuiz.astro | Quiz de compatibilidad |
apps/pinteach-web/src/components/directory/FilterSidebar.astro | Panel de filtros |
| Endpoint | Metodo | Proposito |
|---|---|---|
/public/teachers | GET | Listado de profesores con filtros (q, specialty, language, minPrice, maxPrice) |
/public/sitemap-slugs | GET | Slugs de profesores para sitemap |
Query params
Section titled “Query params”| Param | Tipo | Descripcion |
|---|---|---|
q | string | Busqueda por texto (nombre, headline) |
specialty | string | Filtro por materia |
language | string | Filtro por idioma |
minPrice | number | Precio minimo (centavos) |
maxPrice | number | Precio maximo (centavos) |
goal | string | Objetivo del quiz |
Cache-Control: public, s-maxage=300, stale-while-revalidate=600 (5 min cache, 10 min stale).