Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Contributors: historical backfill command (Phase 5.2)

Đang mở
  • Có gì không ổn?
#7 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
48/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
csharp, github, postgresql
Lĩnh vực
api, backend, databases

Hướng nghiên cứu

Bắt đầu bằng cách đọc lệnh backfill-activations hiện có và phần kết nối với host của lệnh đó, sau đó kiểm tra giao diện GitHub do module sở hữu cùng entity và unique constraint từ #6. Hoàn thành khi target trong Makefile và mục trong env.example được bao phủ, các bài kiểm thử với fake-client kiểm tra phân trang, tính idempotent và backoff khi rate limit, đồng thời lệnh ghi log các repository đã quét, các PR tìm thấy, các mục đã chèn và bị bỏ qua.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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).
Ngôn ngữ chính
C#
Star
0
Fork
0
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

  • Có Dockerfile hoặc tệp Docker Compose
  • Không có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của CommunityPro/community-pro-api

Tất cả issue của CommunityPro/community-pro-api

Issue tương tự

Thêm issue về C#

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.