Кейс

Движок двойной записи и база знаний по исламским финансам

Главная книга и бухгалтерский движок на правилах, инварианты которых обеспечивает сама база данных, плюс двуязычный RAG по стандартам исламских финансов со ссылками на страницу и пункт.

Клиент: Собственная разработка (R&D)
Роль: Архитектор и инженер
Сроки: Слои 1–2 из плана в 10 слоёв
Стек: PythonFastAPIPostgreSQLSQLAlchemyAlembicOpenAIReactTypeScript

Задача

Финансовому ПО можно доверять ровно настолько, насколько надёжна его главная книга. Прежде чем строить что-либо специфичное для исламских финансов, мне нужен был фундамент, где баланс не может разойтись — ни из-за бага, ни из-за повторного запроса, ни из-за параллельной записи.

Подход и архитектура

Каждый слой сначала спроектирован на бумаге: доменная модель, полный DDL, миграции, API, решения и план по коммитам — 25 ADR на два слоя.
Главная книга: журнал двойной записи, сторно, идемпотентные проводки и оборотно-сальдовая ведомость, инварианты — на триггерах БД. Учёт: бизнес-события превращаются в проводки по правилам, закрываемые периоды, амортизация и отчёт о движении денежных средств.
База знаний: 7 352 фрагмента из четырёх книг стандартов на английском и русском, гибридный поиск по ключевым словам и эмбеддингам с межъязыковым расширением запроса.

Результат

Точность межъязыкового поиска (top-1) выросла с 11/20 до 18/20 после расширения запроса.
Оба слоя проходят сценарии приёмки; ответы ссылаются на страницу и пункт.

Что обеспечило надёжность

110+ тестов, включая тесты отката миграций.
Инварианты живут в базе данных, а не только в коде приложения.

Похожая задача?

Расскажите о ней — честно оценю объём, подход и то, каким может быть первый этап.