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

Contributors: historical backfill command (Phase 5.2)

Abierto
  • ¿Algo no está bien?
#7 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
48/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
csharp, github, postgresql
Área
api, backend, databases

Línea de trabajo

Empieza leyendo el comando backfill-activations existente y su integración con el host; después inspecciona la interfaz de GitHub propiedad del módulo, así como la entidad y la restricción unique de #6. Se considera terminado cuando el objetivo del Makefile y la entrada de env.example están cubiertos, las pruebas con fake-client ejercitan la paginación, la idempotencia y el backoff por rate limit, y el comando registra los repositorios escaneados, los PR encontrados, los insertados y los omitidos.

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

Descripción

contributors

Scope

dotnet run -- backfill-contributions host command that pages the GitHub REST API across all org repos and records every historically merged PR as a ContributionEvent.

Mechanics

  • GET /orgs/{org}/repos then GET /repos/{owner}/{repo}/pulls?state=closed&per_page=100 per repo, filtering merged_at != null.
  • Honor rate limits: conditional requests where possible, respect Retry-After / X-RateLimit-Remaining, back off rather than fail.
  • Idempotent: reuses the (Repo, PrNumber) unique constraint from #6 — safe to re-run any time (plan: run once at launch, webhooks keep it current; re-run right before launch to catch stragglers).
  • Follow the existing backfill-activations command as the structural reference (host command wiring, Makefile target make backfill-contributions, logging summary at the end: repos scanned, PRs found, inserted, skipped).
  • GitHub calls go behind the module-owned interface (no direct HttpClient in the command).

Dependencies

Blocked by #6 (entity + constraints).

Acceptance criteria

  • Re-running produces zero duplicates
  • Rate-limit responses back off instead of throwing
  • Pagination exercised in tests via a fake GitHub client
  • Makefile target + env.example entry for the org token if a separate one is needed
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.