Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Mentorship: mentor profiles + availability model (Phase 6.1, 6.2)

Đang mở
  • Có gì không ổn?
#9 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
48/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
csharp, postgres
Lĩnh vực
api, backend, databases

Hướng nghiên cứu

Bắt đầu bằng cách đọc Members/MembersTestHarness.cs và MemberProfileService để hiểu các quy ước về validation và test, sau đó lần theo IEndpointModule.MapEndpoints và mẫu context EF Core do module sở hữu. Công việc hoàn tất khi cả các endpoint profile và endpoint thay thế toàn bộ availability đều thực thi các quy tắc được liệt kê, sử dụng các mã lỗi Result ổn định, validation các zone IANA bằng NodaTime và ma trận validation của xUnit đều vượt qua.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

mentorship

Scope

New CommunityPro.Mentorship module (schema mentorship): mentor opt-in and weekly availability. This is the foundation ticket — model + timezone groundwork; requests/booking build on it.

Data model

public sealed class MentorProfile
{
    public Guid MemberId { get; set; }            // == AppUser.Id
    public string Headline { get; set; }
    public string TimezoneId { get; set; }        // IANA id, e.g. "Africa/Lagos" — validate against NodaTime TZDB
    public List<string> ExpertiseTags { get; set; }
    public int Capacity { get; set; }             // max concurrent mentees
    public bool IsAcceptingMentees { get; set; }  // auto-false at capacity, manual toggle too
}

public sealed class AvailabilitySlot
{
    public Guid Id { get; set; }
    public Guid MentorId { get; set; }
    public DayOfWeek Day { get; set; }
    public TimeOnly Start { get; set; }           // local to MentorProfile.TimezoneId
    public TimeOnly End { get; set; }
}

Endpoints (prefix /mentorship, active-member policy)

Method Path Notes
PUT /mentorship/mentors/me upsert opt-in: headline, timezone, tags, capacity, accepting toggle
PUT /mentorship/mentors/me/availability replace-all slot list

Rules

  • Use NodaTime for all timezone work — validate TimezoneId against the TZDB; do not hand-roll DST math (this module's #1 gotcha; Lagos is UTC+1 year-round but mentors/mentees won't all be).
  • Slot validation: End > Start, no overlapping slots on the same day, sane bounds (e.g. 15-min granularity).
  • Capacity ≥ 1, tags length-capped and deduped (mirror the skills validation in MemberProfileService).
  • Mentor is a flag in this module, not an Identity role.

Error codes

mentorship.invalid_profile, mentorship.invalid_timezone, mentorship.invalid_slots

Acceptance criteria

  • Invalid IANA id rejected; valid exotic ones (e.g. Pacific/Chatham) accepted
  • Overlapping/inverted slots rejected
  • Availability replace-all is transactional
  • xUnit coverage for validation matrix
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).
Ngôn ngữ chính
C#
Star
0
Fork
0
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

  • Có Dockerfile hoặc tệp Docker Compose
  • Không có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của CommunityPro/community-pro-api

Tất cả issue của CommunityPro/community-pro-api

Issue tương tự

Thêm issue về C#

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.