PostHog server-side events (Phase 9.6 backend)
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 58/100
調査の方向性
まず、SharedKernel の統合ポイント、3 つのアクティベーション経路（webhook、手動アクティベーション、孤児の再実行）、および tests/CommunityPro.Tests にある既存の xUnit harness パターンを特定します。no-op 動作を基準に完了条件を定義し、すべてのアクティベーション経路と、スローされない失敗がログに記録されるケースのカバレッジを確保します。さらに、指定されているとおり env.example も更新します。
索引モデルが issue の本文から書いたものです。
説明
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 whenPOSTHOG_API_KEYis 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_activatedcaptured 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
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
-
admin
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
-
admin
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
-
sponsorship
難易度 4/5 3〜5日 初心者へのやさしさ 48/100
-
sponsorship
難易度 5/5 1週間以上 初心者へのやさしさ 32/100
CommunityPro/community-pro-api の issue をすべて見る
似ている issue
-
type/automation type/tech-debt
難易度 1/5 1時間未満 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
no-stack-trace
難易度 2/5 1〜3時間 初心者へのやさしさ 83/100
メンテナーはふだん 1 日以内に返信
-
enhancement
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
メンテナーはふだん 1 日以内に返信
-
v9 review: Testingオープンdocs/external squad/utforming
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
Altinn/altinn-studio#21041 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
stryker-mutator/stryker-net#3892 ·
メンテナーはふだん 1 日以内に返信