Establish a safe foundation before implementing the geology RAG system

The project begins with architecture, data governance, reproducible evaluation, deployment boundaries, and secret-handling contracts so later code has measurable acceptance criteria.

Constraint: Real provider credentials, workspace identities, and restricted geological data must never enter Git

Rejected: Add placeholder runnable services in the design commit | would imply unverified implementation readiness

Confidence: high

Scope-risk: narrow

Reversibility: clean

Directive: Run make verify before every commit and update ADRs when architecture boundaries change

Tested: Secret scan, Markdown links, YAML parse, shell syntax, and staged diff validation

Not-tested: Application runtime is intentionally deferred to the implementation stage

docs/adr/0003-text-first-scope.md

@@ -0,0 +1,17 @@
+# ADR-0003：第一版采用文本优先范围
+
+- Status: accepted
+- Date: 2026-07-11
+
+## Context
+
+选定的向量和重排模型是纯文本模型。地质资料中的图件、剖面和图例包含空间关系，仅靠 OCR 不能可靠恢复这些关系。
+
+## Decision
+
+第一版支持数字文本、扫描 OCR、表格结构化文本、图题和人工复核的图件摘要。依赖整幅图几何关系的问题单列为挑战集，不计入纯文本主指标。
+
+## Consequences
+
+- 系统不宣称完成矿体建模、图件空间推理、储量计算或找矿概率预测。
+- 后续引入多模态模型时必须新增 ADR、数据格式与独立评测集。