Files
core/bible-local
Mikhail Chusavitin 96aefc0eb4 Hardware ingest contract v2.1: sensors, MAC addresses, device_class expansion
- Add HardwareSensors to JSON contract: fans, power, temperatures, other
- Add machine_sensor_readings table (migration 0022) with upsert in ingest service
- Add mac_addresses []string to HardwarePCIeDevice
- Expand device_class examples: VideoController, ProcessingAccelerator,
  EthernetController, FibreChannelController, StorageController
- Add distributable hardware-ingest-contract.md v2.1 with versioning,
  changelog, field tables, and canonical URL
- Add governance rule: contract doc must be updated with every parser change
- Update data-model.md to document machine_sensor_readings projection
- Update both import-example-full.json files with sensors and new PCIe entries

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-15 16:15:16 +03:00
..

Project Bible

The Bible is the single source of truth for this project's architecture.

Documentation Rules

  • All architecture decisions must be recorded in this Bible.
  • The documentation language is English only.
  • If a decision is superseded, update the Bible immediately and remove or mark obsolete content.
  • Do not duplicate architecture documentation in README.md, claude.md, or other files.

Structure

  • governance/documentation-policy.md - mandatory rules for maintaining architecture docs.
  • architecture/system-overview.md - current scope, boundaries, and high-level system composition.
  • architecture/api-surface.md - HTTP API and UI route contracts.
  • architecture/runtime-flows.md - ingest, timeline, status, and failure invariants.
  • architecture/ui-information-architecture.md - required UI structure and semantics.
  • architecture/data-model.md - domain language, core tables, and migration boundaries.
  • docs/ - migrated operational and implementation documentation (formerly /docs).
  • decisions/README.md - how to capture new and updated architecture decisions.