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

PostHog server-side events (Phase 9.6 backend)

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

Línea de trabajo

Comienza localizando los puntos de integración de SharedKernel, las tres rutas de activación (webhook, activación manual y repetición de huérfanos) y los patrones existentes del harness de xUnit en tests/CommunityPro.Tests. Define la finalización en función del comportamiento no-op, cubre todas las rutas de activación y los fallos registrados que no lanzan excepciones; actualiza también env.example según se especifica.

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

Descripción

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).
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.