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

frontend/README.md

@@ -0,0 +1,23 @@
+# Frontend
+
+React + TypeScript 前端代码位于本目录。构建产物由 Nginx 提供，并由同一入口反向代理 `/api` 与 SSE。
+
+规划边界：
+
+```text
+frontend/
+├── src/
+│   ├── api/               类型安全的后端客户端
+│   ├── components/        通用展示组件
+│   ├── features/          chat、documents、retrieval、evaluation
+│   ├── hooks/
+│   ├── pages/
+│   ├── routes/
+│   ├── styles/
+│   └── types/
+└── tests/
+    ├── unit/
+    └── e2e/
+```
+
+前端只展示后端返回的脱敏模型状态，不提供读取、编辑或回显真实模型密钥的页面。

frontend/src/api/.gitkeep

@@ -0,0 +1 @@
+

frontend/src/components/.gitkeep

@@ -0,0 +1 @@
+

frontend/src/features/.gitkeep

@@ -0,0 +1 @@
+

frontend/src/features/chat/.gitkeep

@@ -0,0 +1 @@
+

frontend/src/features/documents/.gitkeep

@@ -0,0 +1 @@
+

frontend/src/features/evaluation/.gitkeep

@@ -0,0 +1 @@
+

frontend/src/features/retrieval/.gitkeep

@@ -0,0 +1 @@
+

frontend/src/hooks/.gitkeep

@@ -0,0 +1 @@
+

frontend/src/pages/.gitkeep

@@ -0,0 +1 @@
+

frontend/src/routes/.gitkeep

@@ -0,0 +1 @@
+

frontend/src/styles/.gitkeep

@@ -0,0 +1 @@
+

frontend/src/types/.gitkeep

@@ -0,0 +1 @@
+

frontend/tests/e2e/.gitkeep

@@ -0,0 +1 @@
+

frontend/tests/unit/.gitkeep

@@ -0,0 +1 @@
+