From 2467d0c58fe7c6080fabb521555d9bc04a5dd2a8 Mon Sep 17 00:00:00 2001 From: Joseph Spiker Date: Tue, 6 Oct 2026 04:33:43 -0400 Subject: [PATCH] docs: correct Blog System in the beta README Evidence: spikersoft-backend@master SpikerSoft.Business/Domain/Blog/Validation/BlogPostStatusPolicy.cs:54 verified adults publish without staff review. Co-authored-by: Cursor --- README.md | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) 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