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

Sponsorship: entities + Stripe catalog sync (Phase 7.1)

Abierto
  • ¿Algo no está bien?
#14 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
csharp, postgresql
Área
backend, database, payments

Línea de trabajo

Empieza revisando los patrones de los módulos existentes y tests/CommunityPro.Tests/Members/MembersTestHarness.cs; después, sigue el punto de entrada dotnet run -- sync-stripe-catalog. Comprueba env.example y las convenciones de las interfaces de servicios externos propias de los módulos. Se considera terminado cuando haya una sincronización idempotente del catálogo, datos de niveles migrados, configuración de Stripe y cobertura con xUnit usando un cliente falso.

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

Descripción

sponsorship

Scope

New CommunityPro.Sponsorship module (schema sponsorship): tiers, sponsors, invoices, and the Stripe product/price catalog sync.

Tiers: Community Supporter, Member Development Partner, Main Stage Sponsor — recurring subscriptions with monthly + annual prices, plus a one-off "custom contribution" path. (Flagged assumption from the spec: if tiers turn out to be one-off, Checkout mode changes in the follow-up ticket — the model here is unaffected.)

Data model

public sealed class SponsorshipTier
{
    public Guid Id { get; set; }
    public string Name { get; set; }
    public string[] Benefits { get; set; }        // copy lives in DB; prices live in Stripe
    public string StripeProductId { get; set; }
    public string StripeMonthlyPriceId { get; set; }
    public string StripeAnnualPriceId { get; set; }
}

public sealed class Sponsor
{
    public Guid Id { get; set; }
    public string OrgName { get; set; }
    public string ContactEmail { get; set; }
    public string StripeCustomerId { get; set; }
    public string? StripeSubscriptionId { get; set; }
    public Guid TierId { get; set; }
    public SponsorStatus Status { get; set; }     // Active | PastDue | Cancelled
    public string? LogoUrl { get; set; }          // Cloudinary
    public bool ShowInGallery { get; set; }
}

public sealed class SponsorInvoice
{
    public Guid Id { get; set; }
    public Guid SponsorId { get; set; }
    public string StripeInvoiceId { get; set; }
    public long AmountCents { get; set; }
    public string Currency { get; set; }
    public InvoiceStatus Status { get; set; }
    public string HostedInvoiceUrl { get; set; }
    public string PdfUrl { get; set; }
    public DateTimeOffset IssuedAt { get; set; }
}

Catalog sync

dotnet run -- sync-stripe-catalog: idempotently ensures Stripe Products + Prices exist for each tier from config, storing the resulting ids in the DB. Environment-aware — never hardcode price ids (test vs live keys produce different ids). Stripe SDK calls behind a module-owned interface.

Acceptance criteria

  • Sync is idempotent (re-run → no duplicate products/prices)
  • Tier seed data (names + benefits) migrated
  • env.example gains Stripe keys
  • xUnit coverage with a fake Stripe client
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.