feat(mentorship): PR7 — mentor opt-in, discovery, and recommendation surfaces

[indcoder]

PR7 — Mentor Opt-In, Discovery & Recommendation Surfaces

Stacked on indcoder-pr6-recommendation-audit-foundation. Closes the foundation slice for community mentorship.

---

What changed

Layer	File(s)	Summary
Core enums	MentorshipStatus.cs, MentorExpertiseArea.cs	Opt-in lifecycle states + 11-area expertise taxonomy
Core value object	CommunityIds.cs	MentorProfileId Vogen struct
Core model	MentorProfile.cs	Opt-in record — status, expertise areas (JSON), availability, discoverability
Core repository	IMentorProfileRepository.cs	GetByMemberId, GetDiscoverableMentors, Upsert
Infrastructure config	MentorProfileConfiguration.cs	EF config: unique index on MemberId, composite on Status+IsDiscoverable, FK → CommunityMembers
Infrastructure repo	MentorProfileRepository.cs	EF upsert pattern; in-memory expertise-area filter post-query
DB context	BethuyaDbContext.cs	+MentorProfiles DbSet
Migration	20260731160539_MentorshipOptIn	MentorProfiles table + indexes
Contracts	MentorshipContracts.cs	MentorOptInRequest, MentorStatusUpdateRequest, MentorProfileResponse, MentorDiscoveryEntryResponse, DraftMentorPairingSuggestionRequest
Service	MentorshipService.cs	Opt-in/upsert, status transitions, discovery (privacy-aware), mentor-pairing recommendation draft using shared RecommendationEnvelope + Decision audit trail
Endpoints	MentorshipEndpoints.cs	Route group /api/community/mentorship
DI + routing	Program.cs	Register service + map endpoints
Tests	MentorshipServiceTests.cs	11 TUnit tests

Endpoint surface

Method	Route	Policy
POST	/api/community/mentorship/opt-in	RequireAttendee
PATCH	/api/community/mentorship/status	RequireAttendee
GET	/api/community/mentorship/my-profile	RequireAttendee
GET	/api/community/mentorship/discover	RequireAttendee
POST	/api/community/mentorship/recommendations/mentor-pairing	RequireOrganizer

Test coverage (TUnit)

• Opt-in creates profile with IsDiscoverable = true by default
• Idempotent upsert updates existing profile
• GetMyProfile returns null before opt-in
• Pausing hides from discovery (IsDiscoverable = false)
• Opting out removes from discovery
• UpdateStatus without prior opt-in throws InvalidOperationException
• Discovery returns only OptedIn + IsDiscoverable members
• Expertise-area filter works correctly
• Paused and opted-out members excluded from discovery
• Mentor-pairing recommendation draft persists as auditable pending Decision
• Recommendation summary reflects active mentor count
• Availability hours clamped to [1, 40]

Reuse from earlier slices

• CommunityMember / CommunityPassportService — member provisioning and privacy fields
• ParticipationLedgerEntry / CommunityJourneyReadModelService — leadership-funnel signals in recommendation evidence
• RecommendationEnvelope + Decision / IDecisionRepository — human-review-gated audit trail (PR6 schema)
• BethuyaPolicyNames — RequireAttendee + RequireOrganizer

Validation commands

dotnet build src/Hackmum.Bethuya.Backend/Hackmum.Bethuya.Backend.csproj
dotnet test tests/Hackmum.Bethuya.Tests/Hackmum.Bethuya.Tests.csproj
# Results: 275 passed, 0 failed

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 84e0b727-1eca-42c4-bc59-0c83cf5aedc8

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[Copilot]

Pull request overview

Adds the mentorship “mentor opt-in → discovery → organizer recommendation draft” slice to the backend/core/infrastructure layers, including persistence (EF Core) and TUnit coverage, aligning mentorship features with existing Community Passport + Decision/audit patterns.

Changes:

• Introduces MentorProfile domain model + enums/value-object IDs and a repository contract/EF implementation for opt-in and discovery.
• Adds mentorship service + minimal API endpoints (/api/community/mentorship/*) with attendee/organizer policy enforcement.
• Updates EF Core context/configuration and adds a migration + snapshot updates, plus a dedicated TUnit test suite.

Reviewed changes

Copilot reviewed 15 out of 16 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tests/Hackmum.Bethuya.Tests/Services/MentorshipServiceTests.cs	Adds TUnit coverage for opt-in, status transitions, discovery filtering, and recommendation draft persistence.
src/Hackmum.Bethuya.Infrastructure/Repositories/MentorProfileRepository.cs	EF Core repository implementation for mentor profile reads/discovery + upsert.
src/Hackmum.Bethuya.Infrastructure/Data/Migrations/BethuyaDbContextModelSnapshot.cs	Updates EF model snapshot to include MentorProfiles.
src/Hackmum.Bethuya.Infrastructure/Data/Migrations/20260731160539_MentorshipOptIn.Designer.cs	Adds migration designer model for MentorProfiles.
src/Hackmum.Bethuya.Infrastructure/Data/Migrations/20260731160539_MentorshipOptIn.cs	Creates MentorProfiles table + indexes/FK.
src/Hackmum.Bethuya.Infrastructure/Data/Configurations/MentorProfileConfiguration.cs	EF mapping for MentorProfile including JSON column + indexes + FK.
src/Hackmum.Bethuya.Infrastructure/Data/BethuyaDbContext.cs	Adds DbSet<MentorProfile> MentorProfiles.
src/Hackmum.Bethuya.Core/ValueObjects/CommunityIds.cs	Adds Vogen MentorProfileId.
src/Hackmum.Bethuya.Core/Repositories/IMentorProfileRepository.cs	Defines mentor profile persistence contract.
src/Hackmum.Bethuya.Core/Models/MentorProfile.cs	Introduces mentor opt-in model including JSON-backed expertise areas and discoverability fields.
src/Hackmum.Bethuya.Core/Enums/MentorshipStatus.cs	Adds mentorship opt-in lifecycle enum.
src/Hackmum.Bethuya.Core/Enums/MentorExpertiseArea.cs	Adds mentor expertise taxonomy enum.
src/Hackmum.Bethuya.Backend/Services/MentorshipService.cs	Implements opt-in/upsert, status updates, privacy-aware discovery, and auditable recommendation draft creation.
src/Hackmum.Bethuya.Backend/Program.cs	Registers mentorship DI + maps mentorship endpoints.
src/Hackmum.Bethuya.Backend/Endpoints/MentorshipEndpoints.cs	Adds minimal API endpoints for opt-in, status, my-profile, discovery, and mentor-pairing draft.
src/Hackmum.Bethuya.Backend/Contracts/MentorshipContracts.cs	Adds request/response contracts for mentorship APIs.

Files not reviewed (1)

• src/Hackmum.Bethuya.Infrastructure/Data/Migrations/20260731160539_MentorshipOptIn.Designer.cs: Generated file