Files
mtusi2026lab3/openspec/changes/fix-known-issues/specs/student-tests/spec.md
T
2026-10-13 16:13:04 +03:00

4.3 KiB

Spec Delta

ADDED Requirements

Requirement: Доказательства исключений сверки в репозитории

Если способ проверки сценария из списка исключений сверки покрытия ссылается на файл в evidence/, этот файл SHALL лежать в репозитории текущей лабы. В нём SHALL быть результат, снятый на стенде этой лабы, команда, дата и commit. Если способ проверки — команда, которая сама снимает доказательство на стенде, исключение SHALL её называть.

Сверка покрытия SHALL падать, если файла по ссылке исключения нет, и называть сценарий и путь.

Такое доказательство MUST NOT содержать токенов, паролей и их хэшей целиком — только факты, счётчики и префиксы.

Scenario: Ссылка на отсутствующий файл

  • WHEN исключение ссылается на файл evidence/…, которого нет в репозитории
  • THEN make student_test завершается с ненулевым кодом, а сообщение называет сценарий и путь

Scenario: Кэш и хранение секретов на стенде лабы

  • WHEN проверяющий открывает файлы, на которые ссылаются исключения chat-cache «Чтение из кэша», «Срок записи», «Временная база», sessions «Токена нет в хранилище» и users «Хэш в БД»
  • THEN в них вывод названной в исключении команды на стенде с балансировщиком и двумя репликами, дата и commit, а токенов, паролей и полных хэшей нет

Requirement: PostgreSQL стенда отказов без аварийных перезапусков

Проверки отказов MUST NOT приводить к аварийному перезапуску PostgreSQL своего стенда. Процессы, которые проверки запускают в его контейнере (сессии psql, занимающие слоты соединений), после завершения MUST NOT восприниматься сервером PostgreSQL как его собственные процессы.

make failure_checks SHALL после проверок и до уборки читать журнал PostgreSQL стенда отказов и искать признаки аварийного перезапуска:

  • неизвестный дочерний процесс сервера;
  • завершение всех процессов сервера и повторная инициализация;
  • восстановление после сбоя.

Сводку журнала команда SHALL печатать после каждого прогона проверок, с признаками и без. Если признаки есть, команда SHALL выводить найденные строки и завершаться с ненулевым кодом.

Scenario: Заполнение и освобождение слотов

  • WHEN проверка «Соединения исчерпаны» заняла все слоты соединений PostgreSQL стенда отказов, а затем освободила их
  • THEN в журнале PostgreSQL стенда нет «untracked child process» и «reinitializing», а сводка журнала в выводе команды называет ноль признаков аварии

Scenario: PostgreSQL перезапустился аварийно

  • WHEN во время make failure_checks PostgreSQL стенда отказов перезапустился аварийно
  • THEN код выхода команды ненулевой, найденные строки журнала выведены, а стенд отказов удалён