Перейти к содержимому

Строим публично

Переписываю Financy на Seed, часть 1: настоящий продукт на SaaS-стартере

Опубликовано · 4 мин чтения·

Другие языки: العربية, Deutsch, English, Español, Français, 日本語, Português (Brasil) и 简体中文

Молодое фиолетовое растение пересаживают из треснувшего серого глиняного горшка в новый фиолетовый, а большое фиолетовое растение рядом делится с ним трубкой полива.

Коротко

  • Financy, мой open-source трекер финансов, начинается заново как копия Seed. Старая версия заморожена в отдельной ветке и служит справочником того, что она умела.
  • Первый коммит — это файлы Seed плюс 19 своих: лицензия, README, правила для агентов, документы о продукте и два файла .seed.
  • Первая синхронизация через день после копии, уже после ребрендинга, принесла 19 коммитов Seed и 616 изменённых файлов без единого конфликта.
  • Финансовых функций пока нет. То, что нужно любому продукту, сначала делается в Seed, а Financy забирает это синхронизацией.

Можно ли построить настоящий продукт на SaaS-стартере и продолжать получать его обновления? Именно это я сейчас и делаю с Financy — моим бесплатным open-source (AGPL-3.0) трекером финансов для человека или семьи. 3 ноября 2026 года Financy начался заново как копия Seed, а 4 ноября получил первую порцию изменений Seed: 19 коммитов, 616 файлов, ноль конфликтов. Эта серия постов идёт следом за переписыванием.

Пост для разработчиков, которые выбирают SaaS-стартер и хотят увидеть его в деле, а не в демо, и для всех, кому интересен Financy. Всё здесь публично: каждая цифра взята из двух репозиториев на GitHub, и любую можно пересчитать самому через git.

Почему переписывать Financy, а не чинить?

Первый Financy появился в апреле 2025 года и дорос до 157 коммитов. Он вёл счета в разных валютах, пересчитывал между ними и был покрыт end-to-end тестами. Но в нём было и много кода, которому я больше не доверяю: значительную часть я писал быстро, с ИИ-моделями того времени, и его структуру, работу с состоянием и синхронизацию всё равно пришлось бы менять, чтобы получить нужный продукт.

Вторая половина ответа — то, чего Financy не хватало. Семейному трекеру финансов нужен вход с двухфакторной аутентификацией, группы с ролями, живые обновления на всех устройствах, офлайн-режим, админка и публичный сайт. Это водопровод любого SaaS, а не финансы, и почти всё это я как раз строил в Seed в октябре (что появилось в октябре). Писать всё это второй раз внутри Financy — ровно та ошибка, от которой Seed и спасает.

Поэтому старый Financy заморожен в ветке legacy. Он подсказывает, что Financy делает (функции, правила работы с деньгами, крайние случаи), и никогда — как: оттуда не переносится даже вспомогательная функция. Правило про деньги из старого кода — это гипотеза: сначала оно становится тестом, потом новым кодом.

Как Financy начался с Seed?

Одним пул-реквестом, financy#83: файлы Seed плюс 19 файлов, которые делают копию Financy. Я посчитал их, сравнив первый коммит Financy с коммитом Seed, который в нём записан:

git fetch https://github.com/spy4x/seed main
git diff --stat "$(git show 3d267c6f:.seed/commit)" 3d267c6f

Эти 19 файлов: лицензия AGPL-3.0 (уведомление MIT от Seed лежит в отдельном файле); README, где честно сказано, что приложение ещё не готово; AGENTS.md Financy — правила для всех агентов и людей, которые над ним работают; документы о продукте; имя образа в пайплайне релиза, чтобы тег Financy никогда не перезаписал образы Seed; удалённые четыре зашифрованных файла настроек сервера Seed; и два файла, на которых держится синхронизация.

Вот эти два файла и есть весь фокус. В .seed/commit лежит коммит Seed, которому соответствует копия, а в .seed/skip — пути Seed, изменения в которых Financy не берёт никогда, например README. Синхронизация — это git diff от этого коммита до текущего main Seed, применённый трёхсторонним слиянием. Полный рецепт — в посте Start a product from Seed and keep getting its updates (на английском), а здесь — что случилось, когда я прошёл его по-настоящему.

Первая синхронизация правда сработала?

Да, и я специально подложил ей небольшую ловушку. До синхронизации Financy уже успел поменять файлы Seed: financy#123 дал ему имя, иконку-кошелёк и свой синий цвет вместо фиолетового Seed — в 32 файлах. Синхронизация, которая работает только на нетронутой копии, ничего бы не доказала.

Потом financy#127 перенёс Seed с ec61062b на d9641f03. Это 19 пул-реквестов Seed и 616 изменённых файлов, и git apply --3way применил их без конфликтов. Среди того, что приехало:

  • вход по коду из письма;
  • годовая цена рядом с месячной;
  • часовой пояс для всей группы;
  • API и воркер, которые работают не только на Deno, но и на Node и Bun;
  • настройка, с какого места начинается журнал изменений продукта.

Синхронизация показала и один шаг, который продукт делает руками. В Seed как раз появился AGENTS.seed.md с правилами собственного репозитория Seed; Financy удалил его и добавил в .seed/skip, чтобы следующие синхронизации его не вернули. После синхронизации Financy отличается от Seed в 59 файлах, и каждый из них Financy поменял намеренно.

Что идёт в Seed, а не в Financy?

Всё, что понадобится любому SaaS. Порядок задаёт AGENTS.md Financy: код, полезный любому проекту, идёт в общие библиотеки @spy4x/*, код, нужный любому продукту на Seed, — в Seed, и только то, что нужно финансовому продукту (счета, транзакции, бюджеты, курсы), остаётся в Financy. Никаких локальных заглушек «перенесём потом»: «потом» — это то, как форк уезжает в сторону.

Три пункта из списка выше — ровно такие. Financy нужна годовая оплата, у месяца семьи должен быть один часовой пояс для всех её участников, а журнал изменений не должен начинаться с многолетней истории старого приложения. Ничего из этого не про деньги, поэтому каждое сделано в Seed и попало в Financy через синхронизацию. 3 и 4 ноября в Seed завели 31 новую задачу, где упоминается Financy, и к 5 ноября 8 из них были закрыты.

Ещё переписывание нашло дыры в моём собственном рецепте. Список того, что продукт убирает с сайта Seed, пропускал несколько файлов, а шаг 1 записывал самый новый коммит Seed — он может оказаться новее копии, и тогда первая синхронизация молча пропустила бы коммиты между ними. Оба исправлены в Seed (seed#811), и руководство теперь объясняет, как найти коммит, файлы которого совпадают с вашими. Вам это исправление полезнее, чем мне: следующий продукт на Seed на эти грабли уже не наступит.

Что ещё не готово?

Почти всё. Пока я это пишу, Financy — это Seed с именем, лицензией и цветом Financy. Экранов счетов, транзакций и бюджетов ещё нет, так что пользоваться им пока не надо. Даже имя не окончательное: financy#126 обсуждает, оставить ли его до запуска.

План открыт: задачи Financy разбиты на семь этапов, от фундамента до запуска и того, что после него. Каждую дыру в Seed, на которую они наткнутся, я закрываю в Seed, так что эта серия будет показывать обе стороны: что понадобилось Financy и чему Seed на этом научился.

Следите за процессом

Подпишитесь на репозиторий Financy (кнопка Watch), чтобы видеть каждый пул-реквест, и подпишитесь на этот блог, чтобы получить вторую часть на почту. Если вы сами собираетесь начать продукт, руководство — то самое, по которому идёт Financy, а если какой-то шаг у вас не сработал, откройте задачу: значит, в рецепт нужно дописать строчку.

Следующий пост — на почту

Короткое письмо, когда выходит новый пост или что-то запускается. Подписка подтверждается один раз по почте, отписаться можно в один клик.

Все посты