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

PostHog server-side events (Phase 9.6 backend)

Đang mở
  • Có gì không ổn?
#20 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
58/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
Lĩnh vực
analytics, backend

Hướng nghiên cứu

Bắt đầu bằng cách xác định các điểm tích hợp của SharedKernel, ba luồng kích hoạt (webhook, kích hoạt thủ công và phát lại các mục mồ côi), cùng các mẫu harness xUnit hiện có trong tests/CommunityPro.Tests. Xác định tiêu chí hoàn thành dựa trên hành vi no-op, bao phủ tất cả các luồng kích hoạt và các lỗi được ghi log nhưng không ném exception; đồng thời cập nhật env.example như đã chỉ định.

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

Mô tả

cross-cutting

Scope

Capture the money events server-side so they survive ad-blockers. Frontend PostHog is a separate (frontend-repo) task.

Events

Event Fired from
member_activated activation pipeline (webhook + manual + orphan replay)
post_approved Content admin approval
sponsor_activated Stripe checkout.session.completed handler
invoice_paid Stripe invoice.paid handler

Rules

  • PostHog .NET client behind a SharedKernel-owned interface (e.g. IAnalytics.Capture(event, distinctId, props)); a no-op implementation registers when POSTHOG_API_KEY is absent — local dev must not need PostHog.
  • Fire-and-forget: analytics failures are logged, never affect the request path.
  • Distinct ids: member id for member events, sponsor id for sponsor events. No emails or PII in properties.
  • Add key to env.example; Serilog remains the logging story — this is product analytics only.

Dependencies

None hard. post_approved lands with #4, sponsor events with #16 — implement the interface + member_activated now, and each later ticket adds its own capture call (note this in those PRs).

Acceptance criteria

  • No-op implementation when unconfigured (asserted in tests)
  • member_activated captured for all three activation paths
  • Failures logged, never thrown
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.