Michael Chus
184f54b663
- 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>
32 lines
1.3 KiB
Markdown
32 lines
1.3 KiB
Markdown
# QuoteForge Bible
|
|
|
|
Project-specific architecture and operational contracts.
|
|
|
|
## Files
|
|
|
|
| File | Scope |
|
|
| --- | --- |
|
|
| [01-overview.md](01-overview.md) | Product scope, runtime model, repository map |
|
|
| [02-architecture.md](02-architecture.md) | Local-first rules, sync, pricing, versioning |
|
|
| [03-database.md](03-database.md) | SQLite and MariaDB data model, permissions, migrations |
|
|
| [04-api.md](04-api.md) | HTTP routes and API contract |
|
|
| [05-config.md](05-config.md) | Runtime config, paths, env vars, startup behavior |
|
|
| [06-backup.md](06-backup.md) | Backup contract and restore workflow |
|
|
| [07-dev.md](07-dev.md) | Development commands and guardrails |
|
|
| [09-vendor-spec.md](09-vendor-spec.md) | Vendor BOM and CFXML import contract |
|
|
| [10-agent-api-guide.md](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](05-config.md)
|
|
- Runtime bind: loopback only
|
|
- Local backups: see [06-backup.md](06-backup.md)
|
|
- Release notes: `releases/<version>/RELEASE_NOTES.md`
|