Files
QuoteForge/bible-local
Mikhail ChusavitinandClaude Opus 5.5 4e3b43dbd0 feat: фича-флаги конфигурации — клиент не сохраняет то, чего не понимает
Конфигурация хранит feature_flags (JSON-массив, NULL = нет) — какие данные
она использует. Флаги выводятся из содержимого при каждом сохранении
(internal/configfeatures). Если у конфигурации есть флаг, неизвестный этой
версии, клиент отказывается её изменять: все write-пути отдают 409
unsupported_config_features со списком флагов, конфигуратор показывает
баннер «обновите приложение» и блокирует сохранение. Push на сервер тоже
отказывается, если серверная версия несёт неизвестный флаг; такое изменение
остаётся в очереди до обновления.

Первый флаг: sale_row_markups. Серверная миграция 034 добавляет колонку;
до её применения запись идёт без колонки (с warning). Формат имён и реестр
флагов — bible-local/02-architecture.md, ADL 2026-09-24.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 12:10:58 +03:00
..

QuoteForge Bible

Project-specific architecture and operational contracts.

Files

File Scope
01-overview.md Product scope, runtime model, repository map
02-architecture.md Local-first rules, sync, pricing, versioning
03-database.md SQLite and MariaDB data model, permissions, migrations
04-api.md HTTP routes and API contract
05-config.md Runtime config, paths, env vars, startup behavior
06-backup.md Backup contract and restore workflow
07-dev.md Development commands and guardrails
09-vendor-spec.md Vendor BOM and CFXML import contract
10-agent-api-guide.md End-to-end API guide for agents pricing servers from a TZ
11-lot-suggestions.md lot_suggestion column in qt_vendor_partnumber_seen — write/read contract for manual UI mappings
decisions/ Architectural decision log, one file per decision

Rules

  • bible-local/ is the source of truth for QuoteForge-specific behavior.
  • Keep these files in English.
  • Update the matching file in the same commit as any architectural change.
  • Remove stale documentation instead of preserving history in place.

Quick reference

  • Local DB path: see 05-config.md
  • Runtime bind: loopback only
  • Local backups: see 06-backup.md
  • Release notes: releases/<version>/RELEASE_NOTES.md