forked from mtusi2026/mtusi2026lab3
Compare commits
2
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
5e361e3f84 | ||
|
|
ab766a5b5b |
+3
-12
@@ -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
|
||||
|
||||
@@ -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"]
|
||||
@@ -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: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
|
||||
|
||||
@@ -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:
|
||||
@@ -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;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -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
@@ -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')
|
||||
@@ -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);
|
||||
@@ -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)
|
||||
);
|
||||
@@ -0,0 +1,4 @@
|
||||
fastapi==0.115.12
|
||||
uvicorn==0.34.2
|
||||
pydantic==2.11.4
|
||||
psycopg[binary]==3.2.6
|
||||
@@ -0,0 +1,3 @@
|
||||
@echo off
|
||||
cd /d "%~dp0.."
|
||||
docker compose --env-file .env restart postgres api1 api2 lb
|
||||
@@ -0,0 +1,4 @@
|
||||
#!/bin/sh
|
||||
set -eu
|
||||
cd "$(dirname "$0")/.."
|
||||
docker compose --env-file .env restart postgres api1 api2 lb
|
||||
@@ -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%
|
||||
@@ -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
|
||||
Reference in New Issue
Block a user