Files
QuoteForge/bible-local
Mikhail ChusavitinandClaude Opus 5.5 a2a1904d91 feat: make migrate — серверные SQL-миграции вместо AutoMigrate
`qfs -migrate` теперь применяет только migrations/*.sql (встроены в бинарник)
с учётом в qt_schema_migrations и завершается, не запуская приложение.
Новые команды: make migrate-status (read-only список applied/pending),
make migrate, make migrate-baseline UPTO=<file> (пометить как применённые
без выполнения). migrate отказывается работать, если в истории нет ни одной
применённой миграции — иначе все файлы пошли бы заново.

Удалён GORM AutoMigrate против MariaDB (models.Migrate, SeedCategories):
устаревший бинарник v1.18 с -migrate прогнал по боевой базе AutoMigrate
своих моделей. Миграции идут через отдельное соединение без read/write
таймаутов — 3s-таймаут sync-соединения обрывал backfill в 032.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 12:21:53 +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