Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Mentorship: mentor directory endpoints (Phase 6.6 backend)

Abierto
  • ¿Algo no está bien?
#13 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
42/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
csharp, postgresql
Área
api, backend, databases

Línea de trabajo

Empieza revisando los problemas de dependencias #9 y #10; después, inspecciona el contrato público de Members y tests/Members/MembersTestHarness.cs para conocer los patrones de módulos existentes. Rastrea el registro del endpoint de mentorship mediante IEndpointModule.MapEndpoints y verifica los filtros indicados, el ordenamiento, la paginación, la exclusión según el estado del miembro, el manejo de la capacidad, los datos de zona horaria y el mapeo de mentorship.not_found con pruebas de xUnit.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

mentorship

Scope

Public-to-members directory the frontend grid consumes.

Method Path Auth Notes
GET /mentorship/mentors active member paginated; filters: expertiseTag, acceptingOnly=true
GET /mentorship/mentors/{id} active member mentor detail incl. expertise, capacity headroom, availability summary

Rules

  • Enrich with member card data (display name, title, avatar) via the Members module public contract — no cross-module DbContext reach-ins.
  • Exclude mentors whose underlying member is not Active (pending/deactivated must never surface — query level, not UI level).
  • acceptingOnly filters on IsAcceptingMentees and actual capacity headroom (belt and braces — the flag can lag).
  • Detail endpoint exposes weekly availability in the mentor's timezone plus the IANA id, so the booking UI can convert client-side.

Error codes

mentorship.not_found

Dependencies

Blocked by #9. Capacity headroom needs #10's Mentorship table (soft — can land computing headroom as capacity until M2 merges).

Acceptance criteria

  • Deactivated/pending members filtered out (tested)
  • Tag filter matches case-insensitively
  • Pagination + deterministic ordering (accepting first, then newest opt-in)
Conventions (project-wide, non-negotiable)
  • .NET 9, records for immutable shapes, file-scoped namespaces, primary constructors where they read well. Minimal-API endpoints grouped per module via IEndpointModule.MapEndpoints.
  • Result<T> (SharedKernel) instead of exception-driven control flow. Endpoint results map failures to ProblemDetails with the stable error codes listed above — the frontend keys off them.
  • Module owns its EF Core DbContext mapped to its own Postgres schema. Modules never reference each other's internals — cross-module needs go through a public contract interface or an in-process domain event (IEventPublisher).
  • All external calls (GitHub, Stripe, Brevo, Cloudinary, Meilisearch) behind interfaces owned by the consuming module.
  • Every list endpoint paginated (offset is fine). xUnit tests in tests/CommunityPro.Tests/<Module>/ following the existing harness patterns (see Members/MembersTestHarness.cs).
Lenguaje dominante
C#
Estrellas
0
Forks
0
Sin PR fusionados en 30 d

Preparar el entorno

  • Incluye un Dockerfile o un archivo de Docker Compose
  • Sin plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de CommunityPro/community-pro-api

Todos los issues de CommunityPro/community-pro-api

Issues similares

Más issues de C#

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.