47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# 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.
|