q-blog/docs/GLOSSARY_DOMAIN.md

Q‑Blog — Glossary & Domain Canon

Generated 2025-08-16 23:27Z

Name — The account identity under which blogs are created.
Blog — A container for posts; owned by a Name; has handle, title, visibility.
Handle — Human‑friendly unique identifier per Name (slug rules).
Post — Content item; belongs to exactly one Blog (immutable link).
Role — owner | editor | author; defines allowed operations.
Membership — Name ↔ Blog relationship with role.
Revision — Monotonically increasing number used for concurrency control.
Invite — Time‑limited token that assigns a role on acceptance.

Invariants

• A Post’s blogId does not change after creation.
• (nameId, blogHandle) is unique.
• All write operations require a role check (server‑enforced).

Identifier & URL Guidance

• Canonical blog URL: /{nameHandle}/{blogHandle}/… (conceptual).
• Slugs are normalized to lowercase, ASCII, hyphen‑separated; collisions rejected with a helpful message.