Perfil Publico del Profesional de Salud

1. Definicion y Proposito

Permite a un paciente evaluar rapidamente a un profesional antes de agendar (credenciales, experiencia, reseñas, seguros, sedes y disponibilidad).

Nota tecnica: por compatibilidad de API, este modulo usa rutas /api/v1/doctors/* y esquema doctor_profiles.

2. Reglas de negocio

• Mostrar solo profesionales de la salud con estado publico/aprobado.
• Datos criticos (colegiado, especialidad principal) no se editan sin aprobacion.
• Si no hay disponibilidad activa, mostrar CTA alterno: "Solicitar contacto".

3. Endpoints propuestos

Recurso	Metodo	Descripcion	Rol
/api/v1/doctors/{public_id}	GET	Detalle publico del profesional de la salud.	Publico
/api/v1/doctors/{public_id}/reviews	GET	Reseñas del profesional de la salud.	Publico
/api/v1/doctors/{public_id}/availability	GET	Slots por sede/modalidad.	Publico

4. Campos minimos de respuesta

• public_id, professional_prefix, display_name, full_name, specialties, years_experience.
• rating_avg, reviews_count.
• modalities (onsite, home, telehealth).
• insurances_supported.
• entities (sede principal y secundarias).
• next_available_slot.

5. Seguridad y privacidad

• No exponer IDs internos, PII sensible ni documentos crudos.
• URLs de evidencias deben ser firmadas y expirables.
• Enmascarar telefono/correo si existe contacto publico.

6. Trazabilidad

• Relacionado con buscador.md, agenda-citas.md, autenticacion.md.
• OpenAPI principal: swagger.html y openapi.yaml.