forked from mtusi2026/mtusi2026lab6
25 lines
3.3 KiB
Markdown
25 lines
3.3 KiB
Markdown
# Проверка обязательных контрактов
|
||
|
||
Источники: неизменённые README, COURSE, contracts/README.md, OpenAPI и observability.md. Проверка не сводится к публичному smoke. Унаследованные требования проверяются на текущем коде; результаты предыдущих репозиториев не выдаются за результаты lab6.
|
||
|
||
| Контракт | Реализация и проверка |
|
||
| --- | --- |
|
||
| Строгий JSON, UUID, Unicode, pagination, общая ошибка | strictjson, service/production, controller/http/fiber; Go regression tests и публичный smoke |
|
||
| Basic только при login, Bearer, expiry/revoke, игнорирование X-User-Id | service/authentication, postgres/sessions; session tests, smoke и persistence |
|
||
| X-Request-Id и X-Instance-Id, включая 413 | controller/http/fiber/errors.go; tests ранних transport errors |
|
||
| Две API, видимость записи, атомарная идемпотентность 24h | PostgreSQL unique key + транзакция; TestMessageRetryRace/Conflict/Expiry/Rollback, failover |
|
||
| 10 MiB / 40M pixels, MIME и filename, приватные bytes | media/validation, ограниченное чтение, objectstore; validation/ACL/private bucket tests |
|
||
| 202 только после S3 staging + durable SQL intent | QueueAttachment; fault matrix и реальный restart при остановленном worker |
|
||
| queued/processing можно прикреплять; failed запрещён; content до ready — 409 | media и PostgreSQL message transaction; attachments/pipeline tests, smoke |
|
||
| Неизменный original, JPEG fit256, alpha/EXIF, crop128, WebP fit1280 | imageprocessor tests + checksum/размеры в smoke и durable |
|
||
| At-least-once, bounded retry, fencing, replay, retention | pipeline, streamqueue, jobs/retention tests с настоящими SQL/S3 |
|
||
| OTLP API/worker, три backend, provisioning и PVC | charts/messenger; сохранённые live metric names, trace, logs, dashboard API |
|
||
| Parent chain и retry | trace-probe.sh, trace-retry.sh, OTLP tests; JSON traces в evidence/current |
|
||
| Histogram percentiles, bounded labels, queue/pool/CPU/RAM | telemetry + dashboard; histogram границы проверены по живому Prometheus |
|
||
| Multiwindow SLO, DB/worker/backend incidents | observability-incidents.sh, ready-slo.sh; raw evidence и разбор REPORT |
|
||
| Graceful lifecycle и ≥90% каждого Go-файла | coverage.sh: race tests + инструментированный настоящий процесс |
|
||
|
||
## Формальная граница
|
||
|
||
В infrastructure.json требуется Compose/Swarm. Реализован Helm/Kubernetes по принятому направлению проекта; эквивалентные роли и bootstrap доступны, но разрешение преподавателя на замену не подтверждено. Это открытое расхождение задания, а не доказанный пункт соответствия. Обязательные контракты и публичные tests не изменялись.
|