Skip to content

Feature Notes

Denis Revyagin edited this page Nov 12, 2026 · 2 revisions

F4. Заметки к парам

Это целевая спецификация релиза 1.1, а не перечень уже реализованных возможностей. Фактический статус — на странице Home.

Назад к Requirements.

Назначение

Студент записывает домашнее задание, дедлайн или напоминание прямо к паре, на которой оно прозвучало. Заметка показывается вместе с расписанием, поэтому её не нужно искать в отдельных приложениях или переписке.

Требования

  • FR-9. Заметка добавляется к конкретной паре: пользователь выбирает пару из расписания на день и вводит текст.
  • FR-10. Заметка выводится под парой в расписании на любой день, где есть эта пара (по дате), — см. формат в Feature-Schedule.
  • FR-11. Меню «Заметки» показывает все заметки пользователя, отсортированные по дате пары, с кнопками «Изменить» и «Удалить».
  • Заметка принадлежит пользователю и не видна другим.
  • У одного пользователя для одного занятия хранится одна заметка; повторное добавление предлагает изменить или дополнить её.
  • Длина заметки — до 500 символов.
  • Заметка удаляется при ближайшем плановом запуске очистки, для которого сейчас ≥ время окончания пары + 30 суток. Срок отсчитывается от окончания занятия по Asia/Yekaterinburg, а не от создания или последнего редактирования заметки. Расписание очистки должно быть задокументировано.
  • Заметка привязана к записи о занятии. При отмене или исчезновении занятия после обновления сохраняются заметка и сведения об исходной паре; в личном списке показывается «пара отменена». Каскадное удаление заметки из-за исчезновения пары не допускается. Общий срок хранения продолжает действовать по сохранённому времени окончания исходной пары.
  • После смены группы заметки прежней группы остаются в личном списке до ручного удаления или истечения общего срока хранения.

Хранимые данные

Идентификатор заметки, пользователь, занятие (группа, дата, номер пары, время начала и окончания), текст, дата создания, дата изменения. Способ сохранения связи и сведений об отменённом занятии определяется моделью данных; для пары «пользователь — занятие» обеспечивается уникальность.

Сценарии

UC-08. Добавление заметки к паре

Краткое описание Пользователь прикрепляет текстовую заметку к одной из пар
Актор Пользователь
Предусловия Пользователь зарегистрирован; расписание группы загружено
Постусловия Заметка сохранена и отображается под парой в расписании

Основной сценарий

  1. Пользователь нажимает «Заметки» → «Добавить».
  2. Бот показывает кнопки «Сегодня», «Завтра», «Другая дата» для выбора дня.
  3. Пользователь выбирает день.
  4. Бот показывает пары этого дня кнопками.
  5. Пользователь выбирает пару.
  6. Бот просит ввести текст заметки.
  7. Пользователь вводит текст.
  8. Бот сохраняет заметку, подтверждает и показывает расписание выбранного дня с новой заметкой.

Для стандартного пути на сегодня из главного меню это пять действий пользователя: «Заметки», «Добавить», «Сегодня», выбор пары, отправка текста. Выбор другой даты требует дополнительного ввода даты и не входит в этот предел NFR-16.

Альтернативные сценарии

  • 4а. В выбранный день пар нет: бот сообщает об этом и возвращается к шагу 2.
  • 7а. Текст длиннее 500 символов: бот просит сократить и возвращается к шагу 6.
  • 7б. Пользователь нажимает «Отмена»: заметка не создаётся, возврат в меню «Заметки».
  • 5а. К этой паре уже есть заметка: бот показывает её и предлагает «Изменить» или «Дополнить».

UC-09. Просмотр и удаление заметок

Краткое описание Пользователь просматривает список своих заметок и удаляет неактуальную
Актор Пользователь
Предусловия Пользователь зарегистрирован
Постусловия Выбранная заметка удалена из базы и не отображается в расписании

Основной сценарий

  1. Пользователь нажимает «Заметки».
  2. Бот показывает список заметок: дата, пара, дисциплина, первые 50 символов текста; под каждой — кнопки «Изменить» и «Удалить».
  3. Пользователь нажимает «Удалить» у нужной заметки.
  4. Бот запрашивает подтверждение.
  5. Пользователь подтверждает.
  6. Бот удаляет заметку и обновляет список.

Альтернативные сценарии

  • 2а. Заметок нет: бот сообщает «Заметок пока нет» и показывает кнопку «Добавить».
  • 5а. Пользователь отменяет: заметка остаётся, список не меняется.
  • 3а. Пользователь нажимает «Изменить»: бот просит ввести новый текст, проверяет предел 500 символов, сохраняет текст и дату изменения и возвращает к списку. При отмене текст остаётся прежним; срок хранения не продлевается.

В каждом действии проверяется владелец заметки: переданный идентификатор чужой записи не даёт доступа к её чтению, изменению или удалению.

Clone this wiki locally