diff --git a/README.md b/README.md index b50badd..24eac13 100644 --- a/README.md +++ b/README.md @@ -2146,24 +2146,27 @@ All endpoints require authentication. ## Blog System -Members create travel and learning blog posts that connect to the platform's geography and fact system. Posts go through a staff moderation workflow before publishing, and uploaded media passes through an async processing pipeline. +Members create travel and learning blog posts that can link to a geographic fact. A draft stays a draft. Verified adults, and minors whose parent pre-approves posts, publish immediately. Other minors, and authors with no profile, wait for staff review. Uploaded media passes through an async processing pipeline. ### Moderation Workflow ``` -Author creates post → Status: Draft +Author saves a draft → Status: Draft ↓ -Author submits for review → Status: Pending +Author submits the post ↓ -Staff reviews at /admin/blog-moderation +┌──── Verified adult, or a minor with parent pre-approval → Status: Published +└──── Other minors, and authors with no profile → Status: PendingReview ↓ -┌──── Approve → Status: Published (visible on platform) -└──── Reject → Status: Rejected (author notified with reason) +Staff reviews PendingReview posts at /admin/blog-moderation + ↓ +┌──── Approve → Status: Published +└──── Reject → Status: Rejected (the reason is stored on the post) ``` ### LinkedFact Integration -Blog posts can be linked to geographic facts via `LinkedFact` references (factId, countryCode, countryName). This creates a bidirectional connection: the geography explorer shows related blog posts for a fact, and blog posts link out to the interactive map. +Blog posts can be linked to geographic facts via `LinkedFact` references (factId, factTitle, countryCode, countryName, and an optional state). The geography explorer lists published posts for the open country. A linked fact on a post opens that country in the explorer. ### Media Processing Pipeline