# Практикум Android: заметка и подтверждённое сохранение

Авторское учебное условие; это модель данных, не запуск Android.

## Практикум: заметка после поворота и нового запуска

Начальные данные: заметка с идентификатором 7, в базе текст A, revision равен 0. Пользователь вводит B. Есть команда Save; до её подтверждённой записи B остаётся черновиком. Поворот в модели подключает новый экран к тому же объекту состояния. Завершение процесса моделируется уничтожением объекта, закрытием и повторным открытием файла SQLite, затем созданием нового объекта. Сам Python-процесс и Android-процесс здесь не завершаются.

Условия одноредакторные. Одновременно разрешён только один незавершённый Save; второй запрос тикета до завершения текущего отклоняется. Пользователь может продолжать ввод и выполнить следующее Save после завершения или ошибки первого. Сохранение не поддерживает разрешение конфликтов нескольких устройств. Идентификатор заметки известен при новом открытии. Большие данные в saved state не передаются. Несохранённый черновик после создания нового объекта разрешено потерять; подтверждённый Save должен читаться из базы. Ошибка после UPDATE, но до commit, не должна оставлять половину результата.

Перед решением уточни три вещи: что считается подтверждением, требуется ли долговечность черновика и может ли пользователь продолжать ввод во время Save. Здесь подтверждение — завершённая транзакция; черновик не долговечен; ввод разрешён. Именно последнее условие делает недостаточным простое присваивание dirty=false после любого Save.

## Решение: владелец, поколение и подтверждённая запись

У модели есть уникальный токен экземпляра, счётчик поколения, текущий текст и dirty. Каждый ввод увеличивает поколение и устанавливает dirty. Тикет загрузки содержит владельца, поколение на старте и считанные данные. Применять его можно только тому же владельцу, при неизменном поколении и отсутствии нового черновика. Проверка нужна до присваивания текста.

Тикет сохранения фиксирует владельца, поколение и конкретный текст. Если началось сохранение B, а затем появился C, транзакция вправе сохранить B. Но подтверждение этого сохранения не имеет права объявить C сохранённым. После commit база содержит B, экран — C, dirty остаётся true. Следующее Save должно отдельно записать C. Модель хранит единственный незавершённый тикет и отклоняет новый Save до его завершения. Commit принимается только для текущего тикета; повтор старого commit не делает ещё одну запись. Ошибка освобождает слот для повторной попытки. Это два разных факта, а не ошибка асинхронности сама по себе.

Счётчик revision увеличивается вместе с записью. В упражнении он помогает проверить исход транзакции; он не используется как полноценный протокол optimistic locking между устройствами. Для такого протокола понадобились бы ожидаемая версия, условное обновление и определённый исход конфликта. Добавить слово «версия» недостаточно, чтобы получить эти свойства.

При ошибке запись откатывается. На экране остаётся B с dirty=true, в базе — A и revision=0. Сообщение об ошибке не должно превращаться в успех после повторного подключения экрана. В реальном приложении также нужно согласовать доступность повторного Save и способ отображения ошибки; в модели проверяется состояние данных.

## Семь проверяемых сценариев

| Сценарий | Текст экрана после событий | Текст в базе | dirty |
|---|---|---|---|
| Ввод B, поворот, новый экземпляр без Save | A | A | false |
| Ввод B, успешный Save, новый экземпляр | B | B | false |
| Загрузка A началась до ввода B и пришла после него | B | A | true |
| Save B начался, затем введён C, Save B завершился | C | B | true |
| Save B завершился ошибкой до commit | B | A | true |
| Callback прежнего владельца пришёл новому после сохранения B | B | B | false |
| Второй Save до commit B отклонён; затем B и C сохранены последовательно | C | C | false |

Первый сценарий не разрешает терять B при самом повороте: до создания нового объекта новый экран получает прежнюю модель и B остаётся в памяти. Потеря разрешена только на следующем шаге, соответствующем новому экземпляру после моделируемого завершения процесса. Во втором сценарии новый объект читает B из повторно открытой SQLite, а не из прежнего объекта.

Негативный контроль намеренно снимает защиту от старой загрузки. После ввода B применяется старый A; проверка ожидаемого B завершается ошибкой с ненулевым кодом. Такой контроль показывает, что проверка замечает конкретную регрессию. Просто вывести шесть строк «успех» без сравнения состояний было бы недостаточно.

## Файлы, запуск и границы результата

Скачай [архив практикума](practice.zip), открой [условие и решение с копированием](copy.html) или [Markdown](practice.md). В архиве есть check.py, expectations.csv, README и журнал выполнения. После распаковки запусти `python3 check.py`; для намеренно сломанного варианта — `python3 check.py --negative`. Второй запуск должен закончиться кодом 2. Проверки также выполнены при PYTHONOPTIMIZE=1: они не зависят от отключаемого assert.

Обычные запуски прошли в Python 3.9.6 с SQLite стандартной библиотеки. Реально проверены семь конечных состояний, откат транзакции после UPDATE и чтение файла после закрытия соединения. Не проверены Android SDK, Kotlin, Activity, Compose, системный saved state, реальное завершение процесса и поведение при аварии питания. Для переноса решения в приложение добавь эти проверки в соответствующей среде.

На репетиции сначала проговори контракт, затем вручную пройди сценарий «B сохраняется, C уже введён». Если можешь объяснить, почему база B и экран C одновременно корректны, почему dirty остаётся true и какой следующий шаг нужен пользователю, ответ раскрывает профессиональное решение лучше списка библиотек.
