HIPCTF2/docs/database/blog-posts.md

type, title, description, tags, timestamp

type	title	description	tags	timestamp
database	Blog Post Table	blog_post table — draft/published Markdown posts surfaced on the public landing page.	database blog markdown	2026-07-23T10:12:24Z

Schema

Column	Type	Description
id	TEXT PK	UUID v4 (set by the service, not auto-generated).
title	TEXT	Post title.
body_md	TEXT (default '')	Markdown body.
status	TEXT (default 'draft')	One of draft or published.
created_at	TEXT	ISO 8601 (TypeORM @CreateDateColumn).
updated_at	TEXT	ISO 8601 (TypeORM @UpdateDateColumn).
published_at	TEXT, nullable	ISO 8601 timestamp the post was published (set when status flips).

Indexes

Index	Columns	Purpose
idx_blog_status_published	(status, published_at)	Lets GET /api/v1/blog/posts filter to status='published' and order by published_at DESC cheaply.

Behavior

• Only rows with status = 'published' are exposed through the public endpoint GET /api/v1/blog/posts (see Blog API). Drafts are hidden from the landing page and authenticated /blog page.
• The admin CRUD endpoints under /api/v1/admin/blog/posts expose both statuses and all timestamps to administrators.
• First publication sets published_at. Later edits, demotion to draft, and republication preserve that original timestamp.
• BlogService.listPublished() orders by published_at DESC, falling back to created_at when published_at is null.

See also

• Database Schema Overview
• Blog API
• Blog Publishing and Reading
• Landing Page Guide