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

Content: public read endpoints, Meilisearch posts index, ISR revalidation (Phase 4.4)

Đang mở
  • Có gì không ổn?
#5 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
42/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, frontend, search

Hướng nghiên cứu

Bắt đầu với các mẫu của module CommunityPro.Search, lệnh reindex hiện có và các test sử dụng những search fake hiện có; Members/MembersTestHarness.cs cho thấy các quy ước về test harness của project. Theo dõi event PostPublished được phát ra bởi #4 và các quy ước nhóm public endpoint. Được xem là hoàn tất khi tất cả tiêu chí chấp nhận đều đạt, bao gồm lọc các post chưa publish, đồng bộ và revalidation có khả năng chống lỗi, mã lỗi ổn định và reindex theo batch.

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

Mô tả

content

Scope

Public read surface + search sync + frontend cache invalidation for the blog.

Endpoints (anonymous)

Method Path Notes
GET /posts published only, tag filter, paginated, newest first
GET /posts/{slug} published only; feeds the ISR post page
GET /posts/featured the single featured published post

Meilisearch posts index

  • Follow the CommunityPro.Search module patterns exactly (hand-rolled REST client, index+settings ensured at boot, sync-on-write handler that logs failures and never throws).
  • Document shape mirrors public card data only: id, slug, title, excerpt, tags, authorId, publishedAt. Searchable: title, excerpt, tags; filterable: tags; sortable: publishedAt. Never index drafts/submitted/rejected posts — publish adds, unpublish/reject removes.
  • Extend the existing reindex command (dotnet run -- reindex) to rebuild posts alongside members in 500-doc batches.

ISR revalidation

On PostPublished: POST {FRONTEND_URL}/api/revalidate?tag=post-{slug} with a shared secret header (REVALIDATE_SECRET — treat like any credential). Best-effort with logging; never fail the pipeline.

Error codes

content.not_found, search.unavailable (degrade like members search does)

Dependencies

Blocked by #3; consumes the PostPublished event emitted by #4.

Acceptance criteria

  • Unpublished posts are unreachable via every public endpoint and absent from the index (query-level filtering, tested)
  • PostPublished handler upserts the search doc; failure is logged, not thrown
  • Revalidation call sends the secret and swallows/logs failures
  • reindex rebuilds posts (test via the existing search fakes)
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.