Admin: mentorship + sponsorship oversight endpoints (Phase 8.4, 8.5)
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 35/100
Línea de trabajo
Empieza leyendo las implementaciones de IEndpointModule.MapEndpoints de los módulos responsables y las pruebas existentes en tests/CommunityPro.Tests//, especialmente Members/MembersTestHarness.cs. Confirma los contratos de las dependencias #1, #10, #11 y #16 antes de implementar. Se considera terminado cuando todos los endpoints están paginados o usan resúmenes baratos, se prueban MRR y las reglas de exclusión, los efectos secundarios de la conclusión coinciden con el flujo del participante y se bloquea el acceso de los usuarios que no son administradores.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Scope
Read-heavy admin surfaces for the dashboard, plus one intervention action.
Mentorship oversight
| Method | Path | Notes |
|---|---|---|
| GET | /admin/mentorship/pairs |
active pairs, paginated |
| GET | /admin/mentorship/sessions?upcoming=true |
upcoming sessions |
| GET | /admin/mentorship/mentors |
capacity overview (capacity vs active count) |
| POST | /admin/mentorship/{id}/conclude |
conclude-on-behalf for disputes (audit-logged via Serilog structured fields) |
Sponsorship oversight
| Method | Path | Notes |
|---|---|---|
| GET | /admin/sponsors |
list with status, tier, subscription state |
| GET | /admin/sponsors/summary |
MRR computed from active subscriptions (annual normalized to monthly) + counts by status |
| GET | /admin/sponsors/{id}/invoices |
mirrored invoices with status + Stripe hosted links |
Rules
- Endpoints live in the owning modules under
/admin/*with the admin policy at group level (#1's pattern) — the Admin module itself owns nothing here. - All list endpoints paginated; summaries are single cheap queries.
Error codes
admin.forbidden, mentorship.not_found, sponsorship.not_found
Dependencies
Blocked by #1; mentorship endpoints need #10/#11; sponsorship endpoints need #16.
Acceptance criteria
- MRR math tested: monthly + annual mix, PastDue excluded
- Conclude-on-behalf emits the same events/side-effects as participant conclusion
- Non-admin blocked on every endpoint
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
DbContextmapped 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 (seeMembers/MembersTestHarness.cs).
- Lenguaje dominante
- C#
- Estrellas
- 0
- Forks
- 0
- Métricas de merge de PR
- 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
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de CommunityPro/community-pro-api
-
cross-cutting decision
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
-
cross-cutting
Dificultad 4/5 3-5 días Aptitud para principiantes 58/100
-
admin
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
-
sponsorship
Dificultad 4/5 3-5 días Aptitud para principiantes 48/100
-
sponsorship
Dificultad 5/5 Más de una semana Aptitud para principiantes 32/100
Todos los issues de CommunityPro/community-pro-api
Issues similares
-
fix(testing): HeadlessTerminal disposes services synchronouslyPosiblemente ocupada @zidad la tomó hoy. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 69/100
RazorConsole/RazorConsole#388 ·
Los mantenedores suelen responder en 1 día
-
A practical example of rulerAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
starlinghq/starling#209 ·
Los mantenedores suelen responder en 1 día
-
affected/v17 area/frontend type/bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 63/100
umbraco/Umbraco-CMS#24323 · 1 comentario ·
Los mantenedores suelen responder en 2 días
-
Bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 73/100
dotnet/roslynator#1859 ·
Los mantenedores suelen responder en 1 día