Sponsorship: Stripe webhooks, invoice mirroring, Brevo receipts (Phase 7.3, 7.4)
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 32/100
調査の方向性
まず #14 と #15 のメタデータ契約を確認し、次に既存の GitHub webhook の一意制約パターンに従ってください。署名処理、ライフサイクルの順序、冪等性、IEmailSender の best-effort 動作を含む POST /webhooks/stripe を実装してテストしてください。MembersTestHarness.cs のパターンを使用して tests/CommunityPro.Tests// 配下に xUnit のカバレッジを追加してください。完了とは、列挙されたすべての受け入れ基準を満たすことです。
索引モデルが issue の本文から書いたものです。
説明
Scope
POST /webhooks/stripe — signature-verified, idempotent, drives the sponsor lifecycle and local invoice mirror.
Events
| Event | Action |
|---|---|
checkout.session.completed |
create/activate Sponsor from session metadata + customer/subscription ids |
invoice.paid |
upsert SponsorInvoice (amount, hosted URL, PDF); relay branded receipt/thank-you via Brevo incl. customer-portal link |
invoice.payment_failed |
upsert invoice as failed; sponsor → PastDue |
customer.subscription.updated / deleted |
sync SponsorStatus (Active/PastDue/Cancelled) |
Rules
- Verify
Stripe-Signatureagainst the webhook secret on the raw request body. - Idempotent by Stripe event id — same unique-constraint-insert pattern as the GitHub webhooks (Stripe retries for days). Unhandled event types → 200 no-op.
- Rely on Stripe Invoicing natively (subscriptions generate invoices; PDFs/emails enabled in Stripe settings) — local rows exist purely for the admin dashboard.
- Brevo sends best-effort via
IEmailSender; failures never 500 the webhook (Stripe would retry and duplicate side effects — idempotency guard must cover this).
Error codes
webhooks.invalid_signature (401); everything else 200
Dependencies
Blocked by #14 and #15 (metadata contract).
Acceptance criteria
- Replayed event id → no-op (tested for every handled event type)
- Out-of-order events don't corrupt status (e.g.
subscription.deletedbefore a lateinvoice.paid) - Signature failure → 401 without body processing
- Full lifecycle test: checkout → paid → failed → cancelled
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
DbContextmapped 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 (seeMembers/MembersTestHarness.cs).
- 主要言語
- C#
- スター
- 0
- フォーク
- 0
- PR マージ指標
- 30日以内にマージされた PR はありません
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートなし
- コントリビューションガイドなし
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
CommunityPro/community-pro-api のほかの issue
-
cross-cutting decision
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
-
cross-cutting
難易度 4/5 3〜5日 初心者へのやさしさ 58/100
-
admin
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
-
admin
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
-
sponsorship
難易度 4/5 3〜5日 初心者へのやさしさ 48/100
CommunityPro/community-pro-api の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
stryker-mutator/stryker-net#3892 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
MobiFlight/MobiFlight-Connector#3419 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
Kryptos-FR/MarkView.Avalonia#105 ·
メンテナーはふだん 1 日以内に返信
-
[辞書]オープン提案 辞書
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
microsoft/fluentui-blazor#5410 ·
メンテナーはふだん 1 日以内に返信