Files

Michael Chus 184f54b663 refactor: привести кодовую базу в соответствие с канонами bible

- 400 → 422 для всех ошибок валидации входных данных (handlers: export, quote, sync, vendor_spec, partnumber_books, pricelist)
- SQL-запросы вынесены из handlers в localdb (partnumber_books, pricelist, support_bundle); ValidateMariaDBConnection перенесён в internal/db/validate.go
- List-ответы унифицированы: ключ items, поля total_count/page/per_page/total_pages (component, pricelist, partnumber_books); шаблоны обновлены
- Молчаливые ошибки заменены на slog.Warn/Error (support_bundle, vendor_spec, component, configuration, local_configuration, localdb)
- N+1 запросы устранены: batch-запросы в export.go и vendor_workspace_import.go
- fmt.Println → slog в cmd/ (qfs, migrate, migrate_ops_projects, migrate_project_updated_at)
- Заголовки recovery/verify добавлены во все 28 SQL-миграций
- Добавлены bible-local/runtime-flows.md и bible-local/decisions/
- Обновлён субмодуль bible до v0.2.0-13

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-06-13 14:38:01 +03:00

1.3 KiB

Raw Permalink Blame History

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

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

1.3 KiB Raw Permalink Blame History

QuoteForge Bible

Files

Rules

Quick reference

1.3 KiB

Raw Permalink Blame History