Author SHA1 Message Date
dariam 5e361e3f84 Обновить REPORT.md 2026-11-12 13:27:29 +03:00
pampixz ab766a5b5b Lab3 2026-11-12 13:06:36 +03:00
14 changed files with 560 additions and 36 deletions
+3 -12
View File
@@ -1,13 +1,4 @@
# Copy to .env for your LOCAL synthetic test environment; never commit .env.
# These are logical interface suggestions; map actual framework names in REPORT.md.
APP_HOST=0.0.0.0
APP_PORT=8080
APP_ENV=lab
SESSION_TTL_SECONDS=3600
# Choose credentials locally. File paths contain no secret values.
DATABASE_URL_FILE=/run/secrets/database_url
# Optional on 3, required use on 4 in lab2; Redis OR Valkey:
SESSION_STORE=postgres
CACHE_URL_FILE=/run/secrets/cache_url
POSTGRES_USER=messenger
POSTGRES_PASSWORD=change_me_local
POSTGRES_DB=messenger
API_REPLICAS=2
IDEMPOTENCY_TTL_SECONDS=86400
+8
View File
@@ -0,0 +1,8 @@
FROM python:3.12.9-slim
WORKDIR /app
COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt
COPY main.py migrate.py ./
COPY migrations/ ./migrations/
EXPOSE 8080
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8080", "--timeout-graceful-shutdown", "8"]
+118 -24
View File
@@ -1,37 +1,131 @@
# Отчёт — лабораторная 3
# Лабораторная работа №3
- Автор, группа: TODO
- Целевая оценка; выбранный трек 5, если нужен: TODO
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: TODO
**Автор:** Магазейщикова Дарья
**Группа:** БПИ2304
**Целевая оценка:** 3
**Commit / PR:** https://gitea.privcloud.tech/dariam/mtusi2026lab3.git.
## Запуск из чистого clone
## 1. Цель работы
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
Развернуть не менее двух взаимозаменяемых API-реплик за одной публичной точкой входа, обеспечить общее хранение данных и сессий, идемпотентную отправку сообщений и продолжение работы при остановке одной реплики.
## Архитектура и решения
## 2. Архитектура
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab2, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
```text
Клиент → Nginx (:8080) → API-1 / API-2 (FastAPI) → PostgreSQL 16.8
```
## Доказательства критериев
Обе реплики используют общую PostgreSQL для пользователей, чатов, сообщений, сессий и ключей идемпотентности. Sticky sessions не применяются. Nginx балансирует запросы между `api1` и `api2` по round-robin. Заголовок `X-Instance-Id` показывает обработавшую запрос реплику.
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
| --- | --- | --- | --- |
| Публичный smoke | make test | TODO | TODO |
| Остальные пункты уровня 3 | TODO | TODO | TODO |
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
## 3. Реализация
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
- **Инфраструктура:** Docker Compose, Nginx 1.27.5-alpine, две API-реплики FastAPI/Uvicorn, PostgreSQL 16.8-alpine.
- **Миграции:** отдельный сервис `migrate` запускает `001_initial.sql` и `002_idempotency.sql` до API; применяются advisory lock и таблица `schema_migrations`.
- **Сессии:** общие в PostgreSQL; один Bearer-токен действителен на обеих репликах.
- **Идемпотентность:** обязательный `Idempotency-Key`; уникальность в пределах `(user_id, chat_id, key)`. Повтор с тем же содержимым возвращает прежний результат, несовпадающее содержимое — HTTP 409. Конкурентные повторы согласуются ограничением уникальности и транзакцией PostgreSQL.
- **Отказ:** Nginx использует пассивную проверку upstream (`max_fails=1`, `fail_timeout=2s`); API предоставляет health/readiness endpoints; предусмотрено graceful shutdown.
- **Скрипты:** `scripts/restart.sh` и `scripts/stop-one.sh` для Linux; `scripts/restart.cmd` и `scripts/stop-one.cmd` для Windows. Остановка выбирается через `TARGET_INSTANCE_ID` (`api1` или `api2`).
## Эксперименты и отказы
## 4. Запуск из чистого clone
Требуются Docker Desktop / Docker Engine с Compose и Python 3.9+ для тестов. В корне проекта создать `.env` на основе `.env.example` и заполнить `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB`.
```powershell
Copy-Item .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
docker compose --env-file .env ps -a
curl.exe -i http://localhost:8080/health/live
```
На Linux вместо `Copy-Item` использовать `cp .env.example .env`. Для повторного запуска **не использовать** `docker compose down -v`: том `postgres_data` должен сохраняться. Контейнер `migrate` штатно завершается с кодом 0.
## 5. Проведённые проверки
Тестирование выполнено локально в Windows PowerShell с Docker Desktop. Для корректного чтения UTF-8 в Windows использовалось:
```powershell
$env:PYTHONUTF8 = "1"
```
### 5.1. Smoke-тест
```powershell
python tests/smoke.py --base-url http://localhost:8080
```
Результат:
```text
PASS: lab3 public API scenario; infrastructure and grading evidence remain separate.
```
### 5.2. Балансировка
```powershell
1..10 | ForEach-Object {
(curl.exe -s -D - -o NUL http://localhost:8080/health/live) |
Select-String "X-Instance-Id"
}
```
Последовательность: `api2, api1, api2, api1, api2, api1, api2, api1, api2, api1`. Наблюдались **две** разные реплики через одну публичную точку входа. `docker compose ps -a` также показывал два отдельных здоровых API-контейнера.
### 5.3. Persistence
```powershell
python tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://localhost:8080
```
```text
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
```
`restart.cmd` выполняет `docker compose --env-file .env restart postgres api1 api2 lb`, не удаляя тома. После перезапуска подтверждённые данные и исходный токен сохранились.
### 5.4. Failover
```powershell
python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url http://localhost:8080
```
**Первый запуск:**
```json
{"observed_instances_before": 2, "successful_writes": 97, "failed_attempts": 0, "first_recovery_seconds": 0.69}
```
**Второй запуск:**
```json
{"observed_instances_before": 2, "successful_writes": 96, "failed_attempts": 0, "first_recovery_seconds": 0.654}
```
Оба запуска завершились `PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence.`
Во втором запуске остановка **api2** подтверждена фактическим состоянием контейнеров:
```text
mtusi2026lab3-api1-1 Up (healthy)
mtusi2026lab3-api2-1 Exited (0)
```
Вторая реплика была восстановлена командой `docker compose up -d api1 api2`; обе вернулись в `healthy`. В обоих тестах наблюдалось по две реплики до отказа, ошибок записи не было, время до первой успешной записи составило менее 10 секунд. Для первого запуска отдельный снимок остановленного контейнера не сохранён, поэтому его идентификатор не утверждается как доказанный.
### 5.5. Сводка
| Проверка | Результат |
|---|---|
| PostgreSQL | Healthy |
| Миграции | Exited (0) |
| API-1 и API-2 | Healthy |
| Nginx | Порт `localhost:8080` доступен |
| Smoke | PASS |
| Две наблюдаемые реплики | PASS (`api1`, `api2`) |
| Persistence | PASS |
| Failover, запуск 1 | PASS; 97 записей, 0 ошибок, 0,69 с |
| Failover, запуск 2 | PASS; 96 записей, 0 ошибок, 0,654 с |
TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
| --- | --- | --- | --- |
| TODO | TODO | TODO | TODO |
## Ограничения и следующие шаги
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
+62
View File
@@ -0,0 +1,62 @@
x-api: &api
build: .
environment:
DATABASE_URL: postgresql://${POSTGRES_USER:-messenger}:${POSTGRES_PASSWORD:-messenger_local_only}@postgres:5432/${POSTGRES_DB:-messenger}
depends_on:
migrate:
condition: service_completed_successfully
restart: unless-stopped
stop_grace_period: 12s
healthcheck:
test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8080/health/ready',timeout=2)"]
interval: 3s
timeout: 3s
retries: 5
start_period: 5s
services:
postgres:
image: postgres:16.8-alpine
environment:
POSTGRES_USER: ${POSTGRES_USER:-messenger}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-messenger_local_only}
POSTGRES_DB: ${POSTGRES_DB:-messenger}
volumes:
- postgres_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"]
interval: 3s
timeout: 3s
retries: 20
migrate:
build: .
command: ["python", "migrate.py"]
environment:
DATABASE_URL: postgresql://${POSTGRES_USER:-messenger}:${POSTGRES_PASSWORD:-messenger_local_only}@postgres:5432/${POSTGRES_DB:-messenger}
depends_on:
postgres:
condition: service_healthy
restart: "no"
api1:
<<: *api
environment:
DATABASE_URL: postgresql://${POSTGRES_USER:-messenger}:${POSTGRES_PASSWORD:-messenger_local_only}@postgres:5432/${POSTGRES_DB:-messenger}
INSTANCE_ID: api1
api2:
<<: *api
environment:
DATABASE_URL: postgresql://${POSTGRES_USER:-messenger}:${POSTGRES_PASSWORD:-messenger_local_only}@postgres:5432/${POSTGRES_DB:-messenger}
INSTANCE_ID: api2
lb:
image: nginx:1.27.5-alpine
ports:
- "8080:8080"
volumes:
- ./infra/nginx.conf:/etc/nginx/nginx.conf:ro
depends_on:
api1:
condition: service_healthy
api2:
condition: service_healthy
restart: unless-stopped
volumes:
postgres_data:
+20
View File
@@ -0,0 +1,20 @@
events { worker_connections 1024; }
http {
upstream api_backend {
server api1:8080 max_fails=1 fail_timeout=2s;
server api2:8080 max_fails=1 fail_timeout=2s;
}
server {
listen 8080;
location / {
proxy_pass http://api_backend;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_connect_timeout 1s;
proxy_read_timeout 15s;
proxy_next_upstream error timeout http_502 http_503 http_504;
proxy_next_upstream_tries 2;
}
}
}
+264
View File
@@ -0,0 +1,264 @@
import base64
import hashlib
import hmac
import json
import os
import re
import secrets
import uuid
from datetime import datetime, timezone, timedelta
from contextlib import contextmanager
import psycopg
from psycopg.rows import dict_row
from fastapi import FastAPI, Request
from fastapi.exceptions import RequestValidationError
from fastapi.responses import JSONResponse, Response
from pydantic import BaseModel, ConfigDict, Field, field_validator
DATABASE_URL = os.environ.get('DATABASE_URL', 'postgresql://messenger:messenger@localhost:5432/messenger')
INSTANCE_ID = os.environ.get('INSTANCE_ID', 'api-local')
app = FastAPI(title='Messenger PostgreSQL', version='1.3.0')
def utc(value):
return value.astimezone(timezone.utc).isoformat(timespec='milliseconds').replace('+00:00','Z')
def db():
return psycopg.connect(DATABASE_URL, row_factory=dict_row)
@contextmanager
def transaction():
with db() as conn:
with conn.transaction():
yield conn
def public_user(row):
return {k:(utc(row[k]) if k=='created_at' else str(row[k]) if k=='id' else row[k]) for k in ('id','username','display_name','created_at')}
def public_chat(conn, row):
members=conn.execute('SELECT user_id FROM chat_members WHERE chat_id=%s ORDER BY user_id',(row['id'],)).fetchall()
return {'id':str(row['id']),'title':row['title'],'member_ids':[str(x['user_id']) for x in members],'created_at':utc(row['created_at'])}
def public_message(row):
return {k:(utc(row[k]) if k=='created_at' else str(row[k]) if k in ('id','chat_id','sender_id') else row[k]) for k in ('id','chat_id','sender_id','text','created_at')}
def err(request,status,code='invalid_request',message='Некорректный запрос',challenge=None):
headers={'WWW-Authenticate':challenge} if challenge else {}
return JSONResponse(status_code=status,headers=headers,content={'error':{'code':code,'message':message,'request_id':request.state.request_id}})
@app.middleware('http')
async def middleware(request:Request, call_next):
request.state.request_id=str(uuid.uuid4())
try:
response=await call_next(request)
except Exception:
response=err(request,500,'internal_error','Внутренняя ошибка сервера')
response.headers['X-Request-Id']=request.state.request_id
response.headers['X-Instance-Id']=INSTANCE_ID
return response
@app.exception_handler(RequestValidationError)
async def validation(request,exc):
return err(request,400)
class Strict(BaseModel):
model_config=ConfigDict(extra='forbid')
class CreateUser(Strict):
username:str=Field(min_length=3,max_length=32,pattern=r'^[a-z0-9_]{3,32}$')
display_name:str=Field(min_length=1,max_length=100)
password:str=Field(min_length=8,max_length=128)
@field_validator('display_name')
@classmethod
def nonblank(cls,v):
if not v.strip(): raise ValueError('blank')
return v
class CreateChat(Strict):
title:str=Field(min_length=1,max_length=100)
member_ids:list[uuid.UUID]=Field(min_length=1,max_length=100)
@field_validator('title')
@classmethod
def nonblank(cls,v):
if not v.strip(): raise ValueError('blank')
return v
class CreateMessage(Strict):
text:str=Field(min_length=1,max_length=4000)
@field_validator('text')
@classmethod
def nonblank(cls,v):
if not v.strip(): raise ValueError('blank')
return v
def password_hash(password):
salt=secrets.token_bytes(16)
result=hashlib.scrypt(password.encode(),salt=salt,n=16384,r=8,p=1)
return 'scrypt$'+salt.hex()+'$'+result.hex()
def verify(password,encoded):
try:
_,salt,digest=encoded.split('$')
candidate=hashlib.scrypt(password.encode(),salt=bytes.fromhex(salt),n=16384,r=8,p=1)
return hmac.compare_digest(candidate,bytes.fromhex(digest))
except (ValueError,TypeError): return False
def actor(request,conn):
header=request.headers.get('authorization','')
if not header.startswith('Bearer '): return None
token=header[7:]
if not token: return None
digest=hashlib.sha256(token.encode()).hexdigest()
return conn.execute('SELECT u.* FROM sessions s JOIN users u ON u.id=s.user_id WHERE s.token_hash=%s AND s.expires_at>now() AND s.revoked_at IS NULL',(digest,)).fetchone()
def require(request,conn):
user=actor(request,conn)
return user, None if user else err(request,401,'unauthorized','Требуется Bearer-сессия','Bearer')
def parse_uuid(value):
try: return uuid.UUID(value)
except (ValueError,TypeError): return None
def encode_cursor(resource,row):
payload=json.dumps({'resource':resource,'created_at':row['created_at'].astimezone(timezone.utc).isoformat(timespec='microseconds'),'id':str(row['id'])},separators=(',',':'))
return base64.urlsafe_b64encode(payload.encode()).decode().rstrip('=')
def decode_cursor(cursor,resource):
if cursor is None: return None
try:
d=json.loads(base64.urlsafe_b64decode(cursor+'='*(-len(cursor)%4)))
if set(d)!={'resource','created_at','id'} or d['resource']!=resource: return False
return (datetime.fromisoformat(d['created_at'].replace('Z','+00:00')),uuid.UUID(d['id']))
except Exception: return False
@app.get('/health/live')
def live(): return {'status':'ok'}
@app.get('/health/ready')
def ready():
with db() as conn: conn.execute('SELECT 1')
return {'status':'ok'}
@app.post('/api/v1/users',status_code=201)
def register(body:CreateUser,request:Request):
with transaction() as conn:
if conn.execute('SELECT 1 FROM users WHERE username=%s',(body.username,)).fetchone():
return err(request,409,'conflict','Имя пользователя занято')
row=conn.execute('INSERT INTO users(username,display_name,password_hash) VALUES (%s,%s,%s) RETURNING *',(body.username,body.display_name,password_hash(body.password))).fetchone()
return public_user(row)
@app.post('/api/v1/auth/sessions',status_code=201)
def login(request:Request):
auth=request.headers.get('authorization','')
try:
if not auth.startswith('Basic '): raise ValueError()
credentials=base64.b64decode(auth[6:],validate=True).decode('utf-8')
username,password=credentials.split(':',1)
except (ValueError,UnicodeError): return err(request,401,'unauthorized','Неверные учётные данные','Basic')
with transaction() as conn:
user=conn.execute('SELECT * FROM users WHERE username=%s',(username,)).fetchone()
if not user or not verify(password,user['password_hash']): return err(request,401,'unauthorized','Неверные учётные данные','Basic')
token=secrets.token_urlsafe(48)
expires=datetime.now(timezone.utc)+timedelta(hours=24)
conn.execute('INSERT INTO sessions(user_id,token_hash,expires_at) VALUES (%s,%s,%s)',(user['id'],hashlib.sha256(token.encode()).hexdigest(),expires))
return {'token':token,'token_type':'Bearer','expires_at':utc(expires),'user':public_user(user)}
@app.delete('/api/v1/auth/sessions/current',status_code=204)
def logout(request:Request):
with transaction() as conn:
user,e=require(request,conn)
if e:return e
digest=hashlib.sha256(request.headers['authorization'][7:].encode()).hexdigest()
conn.execute('UPDATE sessions SET revoked_at=now() WHERE token_hash=%s',(digest,))
return Response(status_code=204)
@app.get('/api/v1/users/me')
def me(request:Request):
with db() as conn:
user,e=require(request,conn)
return e or public_user(user)
@app.post('/api/v1/chats',status_code=201)
def create_chat(body:CreateChat,request:Request):
with transaction() as conn:
user,e=require(request,conn)
if e:return e
members=body.member_ids
if len(set(members))!=len(members) or user['id'] not in members:
return err(request,400)
found=conn.execute('SELECT count(*) AS n FROM users WHERE id=ANY(%s)',(members,)).fetchone()['n']
if found!=len(members):return err(request,400)
row=conn.execute('INSERT INTO chats(title) VALUES (%s) RETURNING *',(body.title,)).fetchone()
for member in members: conn.execute('INSERT INTO chat_members(chat_id,user_id) VALUES (%s,%s)',(row['id'],member))
return public_chat(conn,row)
def member_chat(conn,chat_id,user_id):
return conn.execute('SELECT c.* FROM chats c JOIN chat_members cm ON cm.chat_id=c.id WHERE c.id=%s AND cm.user_id=%s',(chat_id,user_id)).fetchone()
@app.get('/api/v1/chats')
def list_chats(request:Request,limit:int=50,cursor:str|None=None):
if not 1<=limit<=100:return err(request,400)
with db() as conn:
user,e=require(request,conn)
if e:return e
marker=decode_cursor(cursor,'chats:'+str(user['id']))
if marker is False:return err(request,400)
query='SELECT c.* FROM chats c JOIN chat_members cm ON cm.chat_id=c.id WHERE cm.user_id=%s'
params=[user['id']]
if marker:
query+=' AND (c.created_at,c.id)>(%s,%s)';params.extend(marker)
rows=conn.execute(query+' ORDER BY c.created_at,c.id LIMIT %s',(*params,limit+1)).fetchall()
page=rows[:limit]
return {'items':[public_chat(conn,r) for r in page],'next_cursor':encode_cursor('chats:'+str(user['id']),page[-1]) if len(rows)>limit else None}
@app.get('/api/v1/chats/{chat_id}')
def get_chat(chat_id:str,request:Request):
with db() as conn:
user,e=require(request,conn)
if e:return e
cid=parse_uuid(chat_id)
if cid is None:return err(request,400)
row=member_chat(conn,cid,user['id'])
return public_chat(conn,row) if row else err(request,404,'not_found','Чат не найден')
@app.post('/api/v1/chats/{chat_id}/messages',status_code=201)
def send(chat_id:str,body:CreateMessage,request:Request):
key=request.headers.get('Idempotency-Key','')
if not re.fullmatch(r'[A-Za-z0-9._:-]{1,128}',key,flags=re.ASCII):
return err(request,400,'invalid_request','Требуется корректный Idempotency-Key')
with transaction() as conn:
user,e=require(request,conn)
if e:return e
cid=parse_uuid(chat_id)
if cid is None:return err(request,400)
if not member_chat(conn,cid,user['id']):return err(request,404,'not_found','Чат не найден')
# UNIQUE constraint serializes concurrent calls on all replicas.
# The message and idempotency record commit atomically.
fingerprint=hashlib.sha256(json.dumps({'text':body.text,'attachment_ids':[]},sort_keys=True,separators=(',',':'),ensure_ascii=False).encode()).hexdigest()
conn.execute("""INSERT INTO message_idempotency(user_id,chat_id,key,fingerprint,message_id)
VALUES (%s,%s,%s,%s,NULL) ON CONFLICT DO NOTHING""",(user['id'],cid,key,fingerprint))
record=conn.execute("""SELECT fingerprint,message_id FROM message_idempotency
WHERE user_id=%s AND chat_id=%s AND key=%s FOR UPDATE""",(user['id'],cid,key)).fetchone()
if record['fingerprint']!=fingerprint:
return err(request,409,'conflict','Ключ уже использован для другого сообщения')
if record['message_id'] is not None:
row=conn.execute('SELECT * FROM messages WHERE id=%s',(record['message_id'],)).fetchone()
return public_message(row)
row=conn.execute('INSERT INTO messages(chat_id,sender_id,text) VALUES (%s,%s,%s) RETURNING *',(cid,user['id'],body.text)).fetchone()
conn.execute("""UPDATE message_idempotency SET message_id=%s
WHERE user_id=%s AND chat_id=%s AND key=%s""",(row['id'],user['id'],cid,key))
return public_message(row)
@app.get('/api/v1/chats/{chat_id}/messages')
def list_messages(chat_id:str,request:Request,limit:int=50,cursor:str|None=None):
if not 1<=limit<=100:return err(request,400)
with db() as conn:
user,e=require(request,conn)
if e:return e
cid=parse_uuid(chat_id)
if cid is None:return err(request,400)
marker=decode_cursor(cursor,'messages:'+str(cid))
if marker is False:return err(request,400)
if not member_chat(conn,cid,user['id']):return err(request,404,'not_found','Чат не найден')
query='SELECT * FROM messages WHERE chat_id=%s';params=[cid]
if marker:
query+=' AND (created_at,id)>(%s,%s)';params.extend(marker)
rows=conn.execute(query+' ORDER BY created_at,id LIMIT %s',(*params,limit+1)).fetchall()
page=rows[:limit]
return {'items':[public_message(r) for r in page],'next_cursor':encode_cursor('messages:'+str(cid),page[-1]) if len(rows)>limit else None}
+14
View File
@@ -0,0 +1,14 @@
import os
from pathlib import Path
import psycopg
url=os.environ['DATABASE_URL']
with psycopg.connect(url) as conn:
with conn.transaction():
conn.execute('CREATE TABLE IF NOT EXISTS schema_migrations(version text PRIMARY KEY, applied_at timestamptz NOT NULL DEFAULT now())')
conn.execute('SELECT pg_advisory_xact_lock(18202602)')
for path in sorted(Path(__file__).parent.joinpath('migrations').glob('*.sql')):
if not conn.execute('SELECT 1 FROM schema_migrations WHERE version=%s',(path.name,)).fetchone():
conn.execute(path.read_text())
conn.execute('INSERT INTO schema_migrations(version) VALUES (%s)',(path.name,))
print('Applied',path.name)
print('Migrations complete')
+37
View File
@@ -0,0 +1,37 @@
CREATE TABLE IF NOT EXISTS users (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
username varchar(32) NOT NULL UNIQUE CHECK (username ~ '^[a-z0-9_]{3,32}$'),
display_name varchar(100) NOT NULL CHECK (length(trim(display_name)) > 0),
password_hash text NOT NULL,
created_at timestamptz NOT NULL DEFAULT now()
);
CREATE TABLE IF NOT EXISTS chats (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
title varchar(100) NOT NULL CHECK (length(trim(title)) > 0),
created_at timestamptz NOT NULL DEFAULT now()
);
CREATE TABLE IF NOT EXISTS chat_members (
chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE,
user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE,
PRIMARY KEY (chat_id,user_id)
);
CREATE INDEX IF NOT EXISTS idx_chat_members_user ON chat_members(user_id,chat_id);
CREATE TABLE IF NOT EXISTS messages (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE,
sender_id uuid NOT NULL REFERENCES users(id),
text varchar(4000) NOT NULL CHECK (length(trim(text)) > 0),
created_at timestamptz NOT NULL DEFAULT now(),
FOREIGN KEY (chat_id,sender_id) REFERENCES chat_members(chat_id,user_id)
);
CREATE INDEX IF NOT EXISTS idx_messages_page ON messages(chat_id,created_at,id);
CREATE INDEX IF NOT EXISTS idx_chats_page ON chats(created_at,id);
CREATE TABLE IF NOT EXISTS sessions (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE,
token_hash char(64) NOT NULL UNIQUE,
expires_at timestamptz NOT NULL,
revoked_at timestamptz,
created_at timestamptz NOT NULL DEFAULT now()
);
CREATE INDEX IF NOT EXISTS idx_sessions_user ON sessions(user_id);
+9
View File
@@ -0,0 +1,9 @@
CREATE TABLE IF NOT EXISTS message_idempotency (
user_id uuid NOT NULL REFERENCES users(id),
chat_id uuid NOT NULL REFERENCES chats(id),
key varchar(128) NOT NULL,
fingerprint char(64) NOT NULL,
message_id uuid REFERENCES messages(id),
created_at timestamptz NOT NULL DEFAULT now(),
PRIMARY KEY (user_id, chat_id, key)
);
+4
View File
@@ -0,0 +1,4 @@
fastapi==0.115.12
uvicorn==0.34.2
pydantic==2.11.4
psycopg[binary]==3.2.6
+3
View File
@@ -0,0 +1,3 @@
@echo off
cd /d "%~dp0.."
docker compose --env-file .env restart postgres api1 api2 lb
+4
View File
@@ -0,0 +1,4 @@
#!/bin/sh
set -eu
cd "$(dirname "$0")/.."
docker compose --env-file .env restart postgres api1 api2 lb
+7
View File
@@ -0,0 +1,7 @@
@echo off
cd /d "%~dp0.."
if "%TARGET_INSTANCE_ID%"=="api1" goto stop
if "%TARGET_INSTANCE_ID%"=="api2" goto stop
exit /b 2
:stop
docker compose --env-file .env stop -t 2 %TARGET_INSTANCE_ID%
+7
View File
@@ -0,0 +1,7 @@
#!/bin/sh
set -eu
cd "$(dirname "$0")/.."
case "${TARGET_INSTANCE_ID:-}" in
api1|api2) docker compose --env-file .env stop -t 2 "$TARGET_INSTANCE_ID" ;;
*) echo "Unknown TARGET_INSTANCE_ID" >&2; exit 2 ;;
esac