docs: 添加项目文档和图表文件

添加游戏设计文档、技术架构文档、数值经济文档等内容
新增Mermaid图表文件描述系统架构和流程
包含README说明文档结构和阅读顺序

docs/diagrams/architecture-client.mmd

@@ -0,0 +1,8 @@
+flowchart TB
+  UI[UI: React/Canvas/纯DOM均可] --> APP[Application: 用例与指令]
+  APP --> DOM[Domain: 规则引擎与模型]
+  DOM --> RNG[RNG: 可注入种子]
+  APP --> DATA[Data: 配置/存档/API]
+  DATA --> CT[Content: 表与包]
+  DATA --> SAV[Save: 本地/云端]
+  DATA --> NET[Net: 后端API]

docs/diagrams/architecture-core-loop.mmd

@@ -0,0 +1,19 @@
+sequenceDiagram
+  participant P as 玩家
+  participant UI as 客户端UI
+  participant SIM as Simulation(时间/状态)
+  participant CT as Content(配置与表)
+  participant EVT as Event(事件引擎)
+  participant CMB as Combat(战斗引擎)
+  participant SAV as Save(存档)
+
+  P->>UI: 选择地点/动作
+  UI->>SIM: 请求推进时间(Δt)
+  SIM->>CT: 读取状态消耗/刷新规则
+  SIM->>EVT: 抽取事件(按地点/权重/条件)
+  EVT-->>UI: 返回事件(文本/选项/结果预览)
+  alt 触发战斗
+    UI->>CMB: 初始化战斗(玩家/敌人/距离/武器)
+    CMB-->>UI: 回合结果/日志
+  end
+  UI->>SAV: 自动存档/快速保存

docs/diagrams/combat-state.mmd

@@ -0,0 +1,14 @@
+stateDiagram-v2
+  [*] --> Init
+  Init --> PlayerTurn
+  PlayerTurn --> Resolve
+  Resolve --> EnemyTurn
+  EnemyTurn --> Resolve
+  Resolve --> CheckEnd
+  CheckEnd --> PlayerTurn: 未结束
+  CheckEnd --> Escape: 逃跑成功
+  CheckEnd --> Win: 敌人死亡
+  CheckEnd --> Lose: 玩家死亡/崩溃
+  Escape --> [*]
+  Win --> [*]
+  Lose --> [*]

docs/diagrams/core-loop.mmd

@@ -0,0 +1,11 @@
+flowchart LR
+  A[基地：整理与制作] --> B[准备：补给与装备]
+  B --> C[出行：移动到地点]
+  C --> D[探索：资源/事件/任务]
+  D --> E{遭遇？}
+  E -->|战斗| F[战斗与消耗]
+  E -->|非战斗事件| G[选择与结果]
+  F --> H[回收：战利品/伤病/污染]
+  G --> H
+  H --> I[发展：科技/工具/基地能力]
+  I --> A

docs/diagrams/economy-loop.mmd

@@ -0,0 +1,9 @@
+flowchart LR
+  T[时间] --> C1[状态消耗]
+  C1 -->|逼迫补给| S[补给消耗品]
+  T --> A[行动：探索/采集/制作/战斗]
+  A --> R[产出：资源/线索/装备]
+  R --> U[发展：设施/科技/工具]
+  U -->|效率提升| A
+  A -->|风险| D[伤病/辐射/损耗]
+  D -->|治疗/修理| S

docs/diagrams/map-topology.mmd

@@ -0,0 +1,9 @@
+flowchart TB
+  H[基地] --- A[低风险补给点]
+  H --- B[教学废墟]
+  A --- C[村庄/交易点]
+  B --- D[城市废墟]
+  C --- E[森林边缘]
+  D --- F[地铁入口]
+  E --- G[避难所外围]
+  F --- G

docs/diagrams/save-flow.mmd

@@ -0,0 +1,9 @@
+sequenceDiagram
+  participant C as Client
+  participant API as Save API
+  participant DB as Database
+  C->>API: PUT /saves/{slotId} (save, If-Match)
+  API->>API: 校验Schema/引用/数值
+  API->>DB: 写入(事务)
+  DB-->>API: ok
+  API-->>C: 200 (new etag)

docs/diagrams/time-pipeline.mmd

@@ -0,0 +1,8 @@
+flowchart TD
+  A[advanceTime Δt] --> B[状态消耗]
+  B --> C[Buff结算]
+  C --> D[资源生长]
+  D --> E[遭遇/敌人刷新]
+  E --> F[灾害结算]
+  F --> G[任务/事件检查]
+  G --> H[日志与提示]

docs/diagrams/ui-ia.mmd

@@ -0,0 +1,7 @@
+flowchart TB
+  A[顶部栏：时间/地点/灾害] --> B[状态区：生存状态]
+  B --> C[主操作区：地点动作/事件/战斗]
+  C --> D[信息区：日志/提示/详情]
+  B --> E[背包/仓库面板]
+  C --> F[制作/科技面板]
+  C --> G[任务面板]