-- 0001: initial schema of the messenger (lab 2). Design rationale: docs/DATA_MODEL.md -- Applied once by `python -m messenger.migrate`; the version is recorded in schema_migrations. -- User-supplied free text (display_name, title, message text) is stored as UTF-8 in BYTEA: -- the contract allows U+0000, and PostgreSQL TEXT cannot contain NUL bytes. -- Lengths are limited in code points by the API; the CHECKs below are byte-level safety nets -- (one code point is at most 4 bytes in UTF-8). CREATE TABLE users ( id uuid PRIMARY KEY, username text NOT NULL, display_name bytea NOT NULL, password_hash text NOT NULL, -- Argon2id PHC string, never the password created_at timestamptz NOT NULL DEFAULT clock_timestamp(), CONSTRAINT users_username_key UNIQUE (username), CONSTRAINT users_username_format CHECK (username ~ '^[a-z0-9_]{3,32}$'), CONSTRAINT users_display_name_len CHECK (octet_length(display_name) BETWEEN 1 AND 400) ); CREATE TABLE chats ( id uuid PRIMARY KEY, title bytea NOT NULL, created_by uuid NOT NULL REFERENCES users (id), created_at timestamptz NOT NULL DEFAULT clock_timestamp(), -- Per-chat clock: created_at of the newest message. Updating this row serialises writers -- of one chat, so message timestamps strictly increase in commit order (see DATA_MODEL.md). last_message_at timestamptz, CONSTRAINT chats_title_len CHECK (octet_length(title) BETWEEN 1 AND 400) ); CREATE TABLE chat_members ( chat_id uuid NOT NULL REFERENCES chats (id), user_id uuid NOT NULL REFERENCES users (id), position smallint NOT NULL, -- order of member_ids sent by the creator chat_created_at timestamptz NOT NULL, -- copy of chats.created_at for keyset listing PRIMARY KEY (chat_id, user_id), CONSTRAINT chat_members_position_key UNIQUE (chat_id, position) ); -- GET /chats of one user: (user_id, created_at, id) range scan, no sort. CREATE INDEX chat_members_user_keyset ON chat_members (user_id, chat_created_at, chat_id); CREATE TABLE messages ( id uuid PRIMARY KEY, chat_id uuid NOT NULL, sender_id uuid NOT NULL, text bytea NOT NULL, created_at timestamptz NOT NULL, -- The sender must be a member of this chat: enforced by the database, not only by the API. CONSTRAINT messages_sender_is_member FOREIGN KEY (chat_id, sender_id) REFERENCES chat_members (chat_id, user_id), CONSTRAINT messages_text_len CHECK (octet_length(text) BETWEEN 1 AND 16000) ); -- History page: WHERE chat_id = $1 AND (created_at, id) > ($2, $3) ORDER BY created_at, id LIMIT n -- becomes an index range scan that starts exactly at the cursor. CREATE INDEX messages_chat_keyset ON messages (chat_id, created_at, id); -- Sessions for SESSION_STORE=postgres (the default store is Valkey; see docs/DATA_MODEL.md). CREATE TABLE sessions ( token_hash bytea PRIMARY KEY, -- SHA-256 of the token; the token is not stored user_id uuid NOT NULL REFERENCES users (id), created_at timestamptz NOT NULL DEFAULT clock_timestamp(), expires_at timestamptz NOT NULL, CONSTRAINT sessions_token_hash_len CHECK (octet_length(token_hash) = 32) ); CREATE INDEX sessions_expires_at ON sessions (expires_at);