Case study: photoframe 3.0.0

Описание и применение

Форк проекта photoframe был обновлён до версии 3.0.0, добавлена поддержка Immich, совместимость с новыми версиями Raspberry Pi OS, создан образ SD‑карты и внедрён контрольный шлюз, требующий тестирования на реальном устройстве перед выпуском.

Задача

Google’s Photos Library API change removed the photo source, the original project was stuck on an outdated Python 3 branch and missing support for newer Raspberry Pi OS releases, and the author lacked time to port, test, and ship a stable release.

Результат

The fork reached its first stable release (v3.0.0) in just over a year, adding Immich support, modern OS compatibility, an SD‑card image, and a hardware‑gate release workflow that prevented buggy releases.

Рабочий процесс

• Fork photoframe and add Immich handlers
• Create AI agent roles (architect, product manager, developer, QA)
• Implement Python 3 branch and Immich routes
• Build pi‑gen SD‑card image and test on Pi Zero W and Pi 3B+
• Add hardware gate: nothing is pushed, tagged, or released until Pi testing passes
• Iterate through rc1 and rc2, fix bugs found on Pi 4 (login, shutdown button, log credentials, config.txt fsync)
• Merge remediation PRs, run final QA on Pi 4
• Tag v3.0.0 and release
• Provide migration script and documentation

Доказательства

Google cut the Photos Library API down to photos an app uploaded itself, and the frame had nothing left to read.

Источник

The release discipline was not optional, and it came from one bad morning in April: nothing gets pushed, tagged, released, or sent upstream until it has run on Pi hardware.

Источник

Between the last release candidate and the stable release, nothing changed but the image builder's branch and the release notes.

Источник