docs: 初始化项目文档和开发指南

- 添加 CLAUDE.md 开发指南，规定 MVP 实现阶段文档阅读优先级 - 添加 MVP 方案文档，定义项目骨架结构和模块划分 - 添加原型文档参考 (xinfra-prototype.v3.html)
2026-07-14 14:48:28 +08:00
parent 18af320914
commit 698dddf5d1
3 changed files with 2209 additions and 0 deletions
@@ -0,0 +1,29 @@
+# CLAUDE.md
+
+## MVP 实现阶段指南
+
+在 MVP 实现阶段，解决问题时请遵循以下阅读优先级：
+
+### 1. 优先阅读文档
+
+1. **MVP 方案文档** (`docs/mvp-skeleton-plan.md`)
+   - 项目骨架结构、模块划分、接口定义
+   - 技术实现要点和代码规范
+
+2. **原型文档** (`docs/ref/xinfra-prototype.v3.html`)
+   - 完整的页面交互流程和 UI 规范
+   - 组件行为、状态管理、API 调用时机
+   - 异常处理和用户体验细节
+
+### 2. 理解优先级
+
+- **先读文档，再看代码**：理解设计意图后再动手实现
+- **原型优先**：当实现细节与原型冲突时，以原型为准
+- **MVP 文档优先**：当架构决策有疑问时，以 MVP 文档为准
+
+### 3. 实现原则
+
+- 严格遵循 MVP 文档中定义的目录结构和模块划分
+- 参考原型文档中的交互流程和状态管理
+- 保持代码简洁，聚焦 MVP 核心功能
+- 遵循项目既定的技术栈和编码规范