Initial project import

2026-08-14 09:40:51 +03:00
parent 00040e5ce4
commit d7099bf80d
146 changed files with 30509 additions and 1055 deletions
@@ -0,0 +1,46 @@
+# SQL protocol knowledge base for 1C configuration storage
+
+This directory is the durable, evidence-first record for the 1C SQL adapter.
+It complements [the general format specification](../1c-sql-format-spec.md).
+Do not put all observations into one chronological note: add a fact to the
+document for its layer, object type, codec, operation, or experiment.
+
+## Non-negotiable runtime rule
+
+The adapter works **only through SQL**. It may decode and encode only what was
+observed in the target database and proven by round-trip checks. It must never
+invent a metadata object, physical path, BSL fragment, form element, join,
+codec, or cryptographic value. Unknown or ambiguous work returns an explicit
+unsupported/protocol-incomplete result.
+
+The Configurator remains a human-operated consumer of the saved-state overlay.
+The adapter does not start it, automate it, or claim to change its in-memory
+state.
+
+## Map
+
+- [Rules and evidence discipline](rules/evidence-and-safety.md)
+- [Agent contract: do not invent](rules/agent-contract.md)
+- [Configuration SQL layers](layers/configuration-storage.md)
+- [Extension saved-state overlay](extensions/saved-state-overlay.md)
+- [Common form and BSL module handling](objects/common-form-module.md)
+- [Object component graph and child selectors](objects/component-graph.md)
+- [Report object-module carrier](objects/report-object-module.md)
+- [Payload envelope codec](codecs/payload-envelope.md)
+- [`__configinfo` map and service atom](codecs/configinfo.md)
+- [Configurator refresh behaviour](operations/configurator-cache.md)
+- [Reproducible `upo_test/test2` experiment](experiments/upo-test-test2.md)
+- [Known dead ends and prohibited shortcuts](research/known-dead-ends.md)
+- [Template for the next experiment](templates/experiment-record.md)
+- [Current adapter component map](implementation/adapter-components.md)
+
+## Maintenance rule
+
+After every material protocol investigation, record all three outcomes:
+
+1. proven direction and the exact evidence;
+2. failed direction and why it failed;
+3. remaining unknowns and the next safe experiment.
+
+Keep raw payloads and credentials out of git. Reference private learning
+artifacts by opaque ID or SHA-1 only.