From 51998ca88b0c4f4c6b124971dec7a262a9d32aab Mon Sep 17 00:00:00 2001
From: zhou zhou <3272660260@qq.com>
Date: 星期二, 17 三月 2026 09:50:29 +0800
Subject: [PATCH] #

---
 docs/flutter_ai_dev_guide.md |  768 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 768 insertions(+), 0 deletions(-)

diff --git a/docs/flutter_ai_dev_guide.md b/docs/flutter_ai_dev_guide.md
new file mode 100644
index 0000000..d8c2bc7
--- /dev/null
+++ b/docs/flutter_ai_dev_guide.md
@@ -0,0 +1,768 @@
+# WMS Flutter AI 寮�鍙戞枃妗�
+
+## 1. 鏂囨。鐩爣
+
+鏈枃妗ｇ敤浜庢寚瀵煎綋鍓� WMS PDA 椤圭洰浠� `uni-app` 杩佺Щ鍒� `Flutter`锛屽苟寤虹珛涓�濂楅�傚悎 AI 鍗忎綔寮�鍙戠殑宸ョ▼浣撶郴銆�
+
+鏍稿績鐩爣锛�
+
+- 浠� 0 寮�濮嬫惌寤轰竴濂楀彲闀挎湡婕旇繘鐨� Flutter 瀹㈡埛绔伐绋�
+- 棣栨湡瑕嗙洊褰撳墠鏍稿績涓氬姟锛氱櫥褰曘�侀椤点�佽缃�侀潪璁㈠崟缁勬墭銆佽鍗曠粍鎵�
+- 涓棿浠朵竴娆¤璁″埌浣嶏紝鍏煎鍚庢湡涓氬姟澶嶆潅鍖栥�佸浜哄崗浣溿�佺伆搴﹀彂甯冦�佺绾胯ˉ鍋裤�佸璁¤拷韪�
+- 寤虹珛 AI 鍙ǔ瀹氬弬涓庣殑寮�鍙戞祦绋嬶紝闄嶄綆鍚庣画鏂板闇�姹傜殑娌熼�氬拰杩斿伐鎴愭湰
+
+---
+
+## 2. 褰撳墠椤圭洰鑳屾櫙
+
+褰撳墠椤圭洰鏄竴涓熀浜� `uni-app + Vue2 + uView UI` 鐨� PDA 浠撳偍瀹㈡埛绔紝鏍稿績閾捐矾濡備笅锛�
+
+1. 鐧诲綍
+2. 鏉冮檺鑿滃崟棣栭〉
+3. 璁剧疆椤�
+4. 闈炶鍗曠粍鎵�
+5. 璁㈠崟缁勬墭
+6. 澶氳瑷�鏀寔
+
+鐜版湁绯荤粺鐗圭偣锛�
+
+- 鐧诲綍鎬併�佹湇鍔＄鍦板潃銆佷笟鍔″紑鍏充緷璧栨湰鍦扮紦瀛�
+- 璇锋眰灞傚凡鏈夌粺涓�鎷︽埅鍣�
+- 椤甸潰缁撴瀯鍋忊�滀笟鍔￠〉鐩磋繛鎺ュ彛鈥�
+- `Main / NoMain` 瀛樺湪閲嶅椤甸潰
+- 宸茬粡鍑虹幇鈥滀笟鍔￠厤缃┍鍔ㄩ〉闈㈣涓衡�濈殑瓒嬪娍
+
+杩欐剰鍛崇潃 Flutter 杩佺Щ涓嶈兘鍙仛椤甸潰缈昏瘧锛岃�岃椤烘墜瀹屾垚鏋舵瀯鍗囩骇銆�
+
+---
+
+## 3. 杩佺Щ鍘熷垯
+
+### 3.1 涓氬姟鍘熷垯
+
+- 棣栨湡鍙縼绉诲綋鍓嶇ǔ瀹氭牳蹇冧笟鍔★紝涓嶅悓鏃堕噸鏋勫悗绔�
+- 杩佺Щ鏈熼棿淇濊瘉鏃х増鍙洖閫�
+- 浼樺厛淇濊瘉 PDA 鎵爜銆佸綍鍏ャ�佹彁浜ら摼璺ǔ瀹�
+
+### 3.2 鎶�鏈師鍒�
+
+- 鍏堝缓鍩虹璁炬柦锛屽啀寮�鍙戜笟鍔￠〉闈�
+- 鍏堢粺涓�鏁版嵁妯″瀷锛屽啀寮�鍙戜氦浜掗�昏緫
+- 鍏堝畾涔変腑闂翠欢閾捐矾锛屽啀寮�鍙戝鏉傛祦绋�
+- 閬垮厤鎶� `uni-app` 鐨勯〉闈㈠鍒堕�昏緫鍘熸牱鎼埌 Flutter
+
+### 3.3 AI 鍗忎綔鍘熷垯
+
+- 鎵�鏈夐渶姹傚繀椤诲厛褰㈡垚缁撴瀯鍖栦换鍔″崱
+- 鎵�鏈� AI 鐢熸垚浠ｇ爜蹇呴』缁忚繃瑙勫垯鏍￠獙鍜屼汉宸ラ獙鏀�
+- 鎵�鏈夋ā鍧楅兘蹇呴』鏈夋槑纭緭鍏ャ�佽緭鍑恒�佽竟鐣�
+- AI 鍙湪绋冲畾杈圭晫鍐呭閲忓紑鍙戯紝涓嶇洿鎺ヨ法灞備贡鏀�
+
+---
+
+## 4. 鐩爣鎶�鏈爤
+
+## 4.1 鍩虹鏍�
+
+- `Flutter 3.x`
+- `Dart 3.x`
+- 鐩爣骞冲彴锛歚Android`
+- 鍚庣画鍙墿灞曪細`iOS`
+
+## 4.2 鎺ㄨ崘搴�
+
+- 鐘舵�佺鐞嗭細`flutter_riverpod`
+- 璺敱锛歚go_router`
+- 缃戠粶璇锋眰锛歚dio`
+- 鏁版嵁妯″瀷锛歚freezed` + `json_serializable`
+- 鏈湴瀛樺偍锛歚shared_preferences`
+- 瀹夊叏瀛樺偍锛歚flutter_secure_storage`
+- 鍥介檯鍖栵細`intl`
+- 鏃ュ織锛歚logger`
+- 宕╂簝涓庣洃鎺э細`sentry_flutter`
+- 浜岀淮鐮�/鎵爜锛氭寜 PDA 纭欢鏂规鎺ュ叆锛屼紭鍏堜繚鐣欓敭鐩樿緭鍏ュ吋瀹规ā寮�
+
+## 4.3 涓嶅缓璁殑鍋氭硶
+
+- 涓嶅缓璁鏈熺洿鎺ヤ笂杩囬噸鐨勫井鍓嶇寮忔媶鍒�
+- 涓嶅缓璁彧闈犲崟涓�鍏ㄥ眬 Provider 绠℃暣涓簲鐢�
+- 涓嶅缓璁墍鏈変笟鍔￠�昏緫閮藉啓鍦� Widget / Controller 涓�
+- 涓嶅缓璁烦杩囦腑闂翠欢灞傜洿鎺ユ妸 Dio 褰撳敮涓�鍩虹璁炬柦
+
+---
+
+## 5. 鎬讳綋鏋舵瀯
+
+鎺ㄨ崘閲囩敤鍒嗗眰鏋舵瀯锛�
+
+```text
+Presentation
+  鈹溾攢 Pages
+  鈹溾攢 Widgets
+  鈹溾攢 ViewModels / Notifiers
+Application
+  鈹溾攢 UseCases
+  鈹溾攢 DTO Mappers
+  鈹溾攢 Workflow Coordinators
+Domain
+  鈹溾攢 Entities
+  鈹溾攢 Value Objects
+  鈹溾攢 Repository Contracts
+Infrastructure
+  鈹溾攢 API Clients
+  鈹溾攢 Local Storage
+  鈹溾攢 Device Services
+  鈹溾攢 Repositories
+Middleware
+  鈹溾攢 Request Middleware
+  鈹溾攢 Auth Middleware
+  鈹溾攢 Route Middleware
+  鈹溾攢 Action Middleware
+  鈹溾攢 Sync Middleware
+  鈹溾攢 Audit Middleware
+```
+
+璇存槑锛�
+
+- `Presentation` 鍙礋璐ｅ睍绀恒�佽緭鍏ャ�侀〉闈㈢姸鎬�
+- `Application` 璐熻矗娴佺▼缂栨帓锛屼笉鐩存帴渚濊禆椤甸潰
+- `Domain` 璐熻矗涓氬姟瑙勫垯鎶借薄
+- `Infrastructure` 璐熻矗鎺ュ彛銆佸瓨鍌ㄣ�佽澶囥�佹棩蹇楃瓑瀹炵幇
+- `Middleware` 璐熻矗璺ㄦā鍧楁í鍒囪兘鍔�
+
+---
+
+## 6. 涓�姝ュ埌浣嶇殑涓棿浠惰璁�
+
+涓棿浠朵笉鏄彧鎸囩綉缁滄嫤鎴櫒锛岃�屾槸鏁翠釜瀹㈡埛绔殑鈥滄í鍒囪兘鍔涙�荤嚎鈥濄��
+
+### 6.1 蹇呴』棣栨湡钀藉湴鐨勪腑闂翠欢
+
+#### 6.1.1 Request Middleware
+
+浣滅敤锛�
+
+- 缁熶竴杩藉姞 baseUrl
+- token 娉ㄥ叆
+- header 娉ㄥ叆
+- 璇锋眰瓒呮椂鎺у埗
+- 鎺ュ彛閲嶈瘯绛栫暐
+- 骞傜瓑鎺у埗
+- 璇锋眰鏃ュ織杈撳嚭
+
+寤鸿钀藉湴鏂瑰紡锛�
+
+- 鍩轰簬 `dio` 鐨� `Interceptors`
+
+#### 6.1.2 Auth Middleware
+
+浣滅敤锛�
+
+- 鐧诲綍鎬佹牎楠�
+- token 澶辨晥鑷姩璺崇櫥褰�
+- 鍒锋柊 token 棰勭暀
+- 鍖垮悕璺敱鐧藉悕鍗�
+
+寤鸿钀藉湴鏂瑰紡锛�
+
+- 璇锋眰鎷︽埅 + 璺敱瀹堝崼鍙屽眰鎺у埗
+
+#### 6.1.3 Route Middleware
+
+浣滅敤锛�
+
+- 椤甸潰璁块棶閴存潈
+- 棣栭〉鍔ㄦ�佽彍鍗曟潈闄愯繃婊�
+- 鐜妫�鏌�
+- 蹇呭～鍓嶇疆鏉′欢妫�鏌�
+
+绀轰緥锛�
+
+- 鏈櫥褰曚笉鍙繘鍏ヤ笟鍔￠〉
+- 鏈厤缃湇鍔＄鍦板潃涓嶅彲鍙戣捣涓氬姟璇锋眰
+- 鏈�夋嫨璁㈠崟涓嶅彲杩涘叆璁㈠崟缁勬墭璇︽儏椤�
+
+#### 6.1.4 Action Middleware
+
+浣滅敤锛�
+
+- 瀵瑰叧閿笟鍔″姩浣滅粺涓�澧炲己
+- 閫傚悎鍚庢湡澶嶆潅娴佺▼鎺ュ叆瀹℃壒銆佹牎楠屻�佽ˉ鍋�
+
+闇�瑕佽鐩栫殑鍔ㄤ綔锛�
+
+- 鐧诲綍
+- 鎵爜鍏ュ簱
+- 鏌ヨ鐗╂枡
+- 鏌ヨ璁㈠崟
+- 鎻愪氦缁勬墭
+- 閲嶇疆鎿嶄綔
+- 璁剧疆淇濆瓨
+
+缁熶竴鑳藉姏锛�
+
+- 鍙傛暟鏍￠獙
+- 鍩嬬偣
+- 鏃ュ織
+- 闃叉姈
+- 鏉冮檺鍒ゅ畾
+- 瑙勫垯鏍￠獙
+- 澶辫触琛ュ伩鍏ュ彛
+
+#### 6.1.5 Config Middleware
+
+浣滅敤锛�
+
+- 绠＄悊鏈嶅姟绔厤缃�
+- 绠＄悊涓氬姟寮�鍏�
+- 绠＄悊椤甸潰瀛楁鏄剧ず閰嶇疆
+- 绠＄悊鐏板害寮�鍏�
+- 绠＄悊澶氱鎴峰樊寮傞厤缃�
+
+寤鸿灏嗗綋鍓嶄互涓嬫暟鎹粺涓�绾冲叆閰嶇疆鍩燂細
+
+- 鏈嶅姟鍦板潃
+- 绔彛
+- 椤圭洰鏍囪瘑
+- 鏄惁澶嶆牳
+- 鏄惁澶氶��
+- 鏉＄爜鍒囧垎瑙勫垯
+- 瀛楁鏄剧ず閰嶇疆
+- 瀛楁缂栬緫閰嶇疆
+
+#### 6.1.6 Audit Middleware
+
+浣滅敤锛�
+
+- 璁板綍鍏抽敭鍔ㄤ綔鏃ュ織
+- 鏀寔闂杩借釜
+- 鍏煎鍚庢湡瀹¤瑕佹眰
+
+寤鸿棣栨湡璁板綍锛�
+
+- 鐧诲綍
+- 鑿滃崟鍔犺浇
+- 鍏抽敭鏌ヨ
+- 缁勬墭鎻愪氦
+- 璁剧疆淇敼
+
+鏃ュ織瀛楁寤鸿锛�
+
+- `traceId`
+- `userId`
+- `deviceId`
+- `action`
+- `requestTime`
+- `responseTime`
+- `status`
+- `errorCode`
+- `errorMessage`
+
+#### 6.1.7 Sync Middleware
+
+浣滅敤锛�
+
+- 涓哄悗鏈熺绾垮満鏅鐣�
+- 涓哄急缃戦噸璇曘�佸け璐ヨˉ鍋裤�佸欢杩熸彁浜ら鐣�
+
+棣栨湡鏃犻渶瀹屾暣绂荤嚎鍖栵紝浣嗘灦鏋勫繀椤婚鐣欙細
+
+- 鏈湴浠诲姟闃熷垪
+- 鎻愪氦鐘舵�佹爣璁�
+- 閲嶈瘯鏈哄埗
+- 鍐茬獊澶勭悊绛栫暐
+
+### 6.2 鍚庢湡鍙墿灞曚腑闂翠欢
+
+- Feature Flag Middleware
+- Workflow Middleware
+- Approval Middleware
+- Rule Engine Middleware
+- Notification Middleware
+- Device Capability Middleware
+
+---
+
+## 7. 妯″潡鎷嗗垎鏂规
+
+```text
+lib/
+  app/
+    bootstrap/
+    router/
+    theme/
+    l10n/
+  core/
+    constants/
+    errors/
+    middleware/
+    network/
+    storage/
+    logging/
+    utils/
+    widgets/
+  domain/
+    auth/
+    menu/
+    settings/
+    container_binding/
+    order_binding/
+  application/
+    auth/
+    menu/
+    settings/
+    container_binding/
+    order_binding/
+  infrastructure/
+    auth/
+    menu/
+    settings/
+    container_binding/
+    order_binding/
+    device/
+  presentation/
+    auth/
+    home/
+    settings/
+    container_binding/
+    order_binding/
+```
+
+妯″潡杈圭晫瑕佹眰锛�
+
+- 姣忎釜涓氬姟鍩熼兘蹇呴』鏈夎嚜宸辩殑 `domain / application / infrastructure / presentation`
+- 璺ㄥ煙鍏变韩鑳藉姏蹇呴』鏀� `core`
+- 绂佹椤甸潰鐩存帴璋冪敤 `dio`
+- 绂佹椤甸潰鐩存帴璇诲啓 `shared_preferences`
+
+---
+
+## 8. 褰撳墠涓氬姟鍒� Flutter 鐨勬槧灏�
+
+### 8.1 auth
+
+鍔熻兘锛�
+
+- 鐧诲綍
+- 璁颁綇璐﹀彿
+- 璇█鍒囨崲
+- 鏈嶅姟绔湴鍧�閰嶇疆
+
+鎷嗗垎锛�
+
+- `AuthPage`
+- `LoginUseCase`
+- `AuthRepository`
+- `ServerConfigRepository`
+
+### 8.2 home
+
+鍔熻兘锛�
+
+- 鍔ㄦ�佽彍鍗�
+- 鏉冮檺杩囨护
+- 榛樿鑿滃崟鍏滃簳
+
+鎷嗗垎锛�
+
+- `HomePage`
+- `FetchMenuUseCase`
+- `MenuRepository`
+- `PermissionGuard`
+
+### 8.3 settings
+
+鍔熻兘锛�
+
+- 涓氬姟寮�鍏�
+- 鏉＄爜鎴彇瑙勫垯
+- 瀛楁鏄剧ず閰嶇疆
+- 瀛楁缂栬緫閰嶇疆
+
+鎷嗗垎锛�
+
+- `SettingsPage`
+- `LoadSettingsUseCase`
+- `SaveSettingsUseCase`
+- `SettingsRepository`
+
+### 8.4 container_binding
+
+鍔熻兘锛�
+
+- 鎵樼洏鎵爜
+- 鐗╂枡鎵爜
+- 鐗╂枡璇︽儏缂栬緫
+- 缁勬墭鎻愪氦
+
+鎷嗗垎锛�
+
+- `ContainerBindingPage`
+- `MaterialSelectPage`
+- `ScanContainerCodeUseCase`
+- `QueryMaterialUseCase`
+- `SubmitContainerBindingUseCase`
+
+### 8.5 order_binding
+
+鍔熻兘锛�
+
+- 璁㈠崟鍒楄〃妯″紡
+- 鍏ㄩ儴鏄庣粏妯″紡
+- 澶氶��
+- 澶嶆牳
+- 缁勬墭鎻愪氦
+
+閲嶆瀯鍘熷垯锛�
+
+- 涓嶄繚鐣� `Main / NoMain` 鍙岄〉闈㈠鍒剁粨鏋�
+- 缁熶竴涓轰竴涓鍗曠粍鎵樻ā鍧楋紝閫氳繃妯″紡鍙傛暟鎺у埗
+
+鎺ㄨ崘妯″瀷锛�
+
+- `OrderBindingEntryMode.withOrderList`
+- `OrderBindingEntryMode.directDetailList`
+
+---
+
+## 9. AI 鍗忎綔寮�鍙戣鑼�
+
+### 9.1 AI 鐨勮亴璐�
+
+AI 閫傚悎璐熻矗锛�
+
+- 椤甸潰楠ㄦ灦鐢熸垚
+- DTO / Entity / Mapper 鐢熸垚
+- UseCase 妯℃澘鐢熸垚
+- Riverpod Provider 妯℃澘鐢熸垚
+- 娴嬭瘯鏍锋澘鐢熸垚
+- 鏂囨。鍚屾鏇存柊
+
+AI 涓嶇洿鎺ヨ礋璐ｆ渶缁堟媿鏉匡細
+
+- 涓氬姟瑙勫垯鐪熷��
+- 瀹夊叏绛栫暐鐪熷��
+- 鍙戝竷鍐崇瓥
+- 澶嶆潅寮傚父娴佺▼楠屾敹
+
+### 9.2 AI 浠诲姟鍗℃ā鏉�
+
+姣忔寮�鍙戝墠蹇呴』鍏堢敓鎴愪换鍔″崱锛�
+
+```md
+## Task
+- 妯″潡锛�
+- 椤甸潰锛�
+- 鐩爣锛�
+
+## Input
+- 鎺ュ彛锛�
+- 瀛楁锛�
+- 閰嶇疆椤癸細
+
+## Output
+- 鏂囦欢鍒楄〃锛�
+- 浜や簰缁撴灉锛�
+- 楠屾敹鏍囧噯锛�
+
+## Constraints
+- 涓嶅厑璁告敼鍔細
+- 渚濊禆杈圭晫锛�
+- 娴嬭瘯瑕佹眰锛�
+```
+
+### 9.3 AI 寮�鍙戞祦绋�
+
+1. 鍏堣妯″潡鏂囨。
+2. 鍐嶈浠诲姟鍗�
+3. 鍐嶈鎺ュ彛濂戠害
+4. 鍐嶇敓鎴愪唬鐮�
+5. 鐢熸垚浜哄伐楠屾敹娓呭崟
+6. 鏇存柊鏂囨。鍜屾祴璇�
+
+### 9.4 AI 浠ｇ爜楠屾敹闂ㄦ
+
+- 鑳界紪璇�
+- 鏈夌┖瀹夊叏
+- 涓嶈法灞傝皟鐢�
+- 涓嶆妸涓氬姟閫昏緫鍫嗗埌 Widget
+- Provider 鐢熷懡鍛ㄦ湡娓呮櫚
+- DTO 涓庡疄浣撹竟鐣屾竻鏅�
+- 鑷冲皯鏈夊熀鏈祴璇曟垨楠屾敹姝ラ
+
+---
+
+## 10. 寮�鍙戦樁娈佃鍒�
+
+### 闃舵 0锛氬熀纭�鍑嗗
+
+杈撳嚭鐗╋細
+
+- Flutter 宸ョ▼鍒濆鍖�
+- lint 瑙勫垯
+- 鐩綍缁撴瀯
+- 璺敱楠ㄦ灦
+- 涓婚鍜屽浗闄呭寲楠ㄦ灦
+- 涓棿浠堕鏋�
+
+### 闃舵 1锛氬熀纭�璁炬柦
+
+杈撳嚭鐗╋細
+
+- Dio 缃戠粶灞�
+- 璇锋眰涓棿浠�
+- Auth 涓棿浠�
+- 閰嶇疆浠撳簱
+- 瀹夊叏瀛樺偍
+- 鏃ュ織绯荤粺
+
+### 闃舵 2锛氬熀纭�妯″潡
+
+杈撳嚭鐗╋細
+
+- 鐧诲綍妯″潡
+- 棣栭〉妯″潡
+- 璁剧疆妯″潡
+
+### 闃舵 3锛氭牳蹇冧笟鍔�
+
+杈撳嚭鐗╋細
+
+- 闈炶鍗曠粍鎵�
+- 璁㈠崟缁勬墭缁熶竴妯″潡
+- 澶氶�変笌澶嶆牳
+
+### 闃舵 4锛氬寮鸿兘鍔�
+
+杈撳嚭鐗╋細
+
+- 鍩嬬偣
+- 瀹¤鏃ュ織
+- 闊虫晥鍜岄渿鍔�
+- 澶辫触閲嶈瘯
+- 寮辩綉鎻愮ず
+
+### 闃舵 5锛氭祴璇曚笌涓婄嚎
+
+杈撳嚭鐗╋細
+
+- 鍥炲綊娴嬭瘯娓呭崟
+- PDA 璁惧娴嬭瘯娓呭崟
+- 鐏板害鍙戝竷鏂规
+- 鍥炴粴鏂规
+
+---
+
+## 11. 涓棿浠舵帴鍙ｅ缓璁�
+
+### 11.1 RequestMiddleware
+
+```dart
+abstract class RequestMiddleware {
+  Future<RequestContext> onRequest(RequestContext context);
+  Future<ResponseContext> onResponse(ResponseContext context);
+  Future<ErrorContext> onError(ErrorContext context);
+}
+```
+
+### 11.2 ActionMiddleware
+
+```dart
+abstract class ActionMiddleware<TInput, TOutput> {
+  Future<TInput> before(TInput input);
+  Future<TOutput> after(TOutput output);
+  Future<void> onError(Object error, StackTrace stackTrace);
+}
+```
+
+### 11.3 RouteGuard
+
+```dart
+abstract class RouteGuard {
+  Future<bool> canActivate(RouteContext context);
+}
+```
+
+### 11.4 SyncTask
+
+```dart
+class SyncTask {
+  final String id;
+  final String type;
+  final Map<String, dynamic> payload;
+  final int retryCount;
+  final String status;
+}
+```
+
+璇存槑锛�
+
+- 涓棿浠舵帴鍙ｅ繀椤昏交閲忋�佺ǔ瀹氥�佸皯涓氬姟璇箟
+- 涓氬姟鐗规湁瑙勫垯鍐欏湪 UseCase 鎴� Rule 灞傦紝涓嶇洿鎺ュ啓姝诲埌涓棿浠�
+
+---
+
+## 12. 鏁版嵁涓庨厤缃瓥鐣�
+
+### 12.1 瀛樺偍鍒嗗眰
+
+- `SecureStorage`锛歵oken銆佹晱鎰熸爣璇�
+- `SharedPreferences`锛氫笟鍔¤缃�乁I 鍋忓ソ銆佹湇鍔″櫒閰嶇疆
+- `LocalDb`锛氬悗鏈熺绾夸换鍔°�佸璁℃棩蹇椼�佺紦瀛樻槑缁�
+
+### 12.2 閰嶇疆妯″瀷缁熶竴
+
+蹇呴』鍚堝苟鐜版湁椤圭洰涓垎瑁傜殑閰嶇疆姒傚康锛�
+
+- 鏈嶅姟绔厤缃細`serverConfig`
+- 涓氬姟閰嶇疆锛歚businessConfig`
+- 鍔熻兘寮�鍏筹細`featureFlags`
+- 璁惧閰嶇疆锛歚deviceConfig`
+
+绂佹缁х画鍑虹幇锛�
+
+- 澶氬鍛藉悕鎺ヨ繎浣嗗惈涔夐噸鍙犵殑缂撳瓨 key
+
+---
+
+## 13. 娴嬭瘯绛栫暐
+
+### 13.1 鍗曞厓娴嬭瘯
+
+瑕嗙洊鑼冨洿锛�
+
+- UseCase
+- Repository
+- Mapper
+- 涓棿浠�
+
+### 13.2 缁勪欢娴嬭瘯
+
+瑕嗙洊鑼冨洿锛�
+
+- 鐧诲綍琛ㄥ崟
+- 璁剧疆椤规覆鏌�
+- 鏄庣粏鍗＄墖
+- 搴曢儴鎿嶄綔鏍�
+
+### 13.3 闆嗘垚娴嬭瘯
+
+瑕嗙洊鑼冨洿锛�
+
+- 鐧诲綍鍒伴椤�
+- 鎵樼洏鎵爜鍒扮粍鎵樻彁浜�
+- 璁㈠崟鏄庣粏鍒扮粍鎵樻彁浜�
+- 澶氶�夋祦绋�
+- 閰嶇疆鍒囨崲鍚庤涓哄彉鍖�
+
+### 13.4 鐪熸満娴嬭瘯
+
+蹇呴』楠岃瘉锛�
+
+- PDA 鎵爜鏋緭鍏�
+- 杞敭鐩樺吋瀹�
+- 寮辩綉瓒呮椂
+- 杩炵画鎵爜
+- 澶氳瑷�鍒囨崲
+- 灞忓箷閫傞厤
+
+---
+
+## 14. 鍙戝竷涓庤繍缁村缓璁�
+
+### 14.1 鐜鍒掑垎
+
+- `dev`
+- `test`
+- `staging`
+- `prod`
+
+### 14.2 鍙戝竷瑕佹眰
+
+- 鏀寔鐜鍒囨崲
+- 鏀寔鐏板害鐢ㄦ埛
+- 鏀寔鏃ュ織杩借釜
+- 鏀寔蹇�熷洖婊�
+
+### 14.3 鐩戞帶寤鸿
+
+- 鎺ュ彛閿欒鐜�
+- 鐧诲綍澶辫触鐜�
+- 缁勬墭鎻愪氦澶辫触鐜�
+- 椤甸潰宕╂簝鐜�
+- 璁惧鍨嬪彿鍒嗗竷
+
+---
+
+## 15. 椋庨櫓涓庤閬�
+
+### 椋庨櫓 1锛氱洿鎺ョ収鎼棫椤甸潰锛屽鑷� Flutter 椤圭洰缁х画閲嶅
+
+瑙勯伩锛�
+
+- 鍏堝仛缁熶竴妯″潡璁捐锛屽啀寮�濮嬪紑鍙�
+
+### 椋庨櫓 2锛氫腑闂翠欢鍙仛缃戠粶鎷︽埅锛屽悗鏈熷鏉備笟鍔℃帴涓嶄綇
+
+瑙勯伩锛�
+
+- 棣栨湡鍚屾椂钀藉湴 Request銆丄uth銆丷oute銆丄ction銆丆onfig銆丄udit銆丼ync 涓冪被涓棿浠�
+
+### 椋庨櫓 3锛欰I 涓�娆＄敓鎴愯繃澶氫唬鐮侊紝璐ㄩ噺涓嶅彲鎺�
+
+瑙勯伩锛�
+
+- 灏忎换鍔″崱寮�鍙�
+- 妯″潡鍐呴棴鐜獙鏀�
+- 鍒嗗眰鏍￠獙
+
+### 椋庨櫓 4锛氶厤缃」瓒婃潵瓒婂锛屾渶缁堝け鎺�
+
+瑙勯伩锛�
+
+- 浠庣涓�澶╁紑濮嬪缓绔嬬粺涓�閰嶇疆妯″瀷鍜岀増鏈寲杩佺Щ绛栫暐
+
+---
+
+## 16. 绗竴鐗堣惤鍦版竻鍗�
+
+棣栨壒蹇呴』瀹屾垚锛�
+
+- Flutter 宸ョ▼鍒濆鍖�
+- 璺敱涓庝富棰�
+- 鍥介檯鍖栭鏋�
+- Dio + 璇锋眰涓棿浠�
+- 鐧诲綍鎬佺鐞�
+- 閰嶇疆涓績
+- 鏃ュ織涓� traceId
+- 鐧诲綍椤�
+- 棣栭〉
+- 璁剧疆椤�
+
+绗簩鎵瑰畬鎴愶細
+
+- 闈炶鍗曠粍鎵�
+- 璁㈠崟缁勬墭缁熶竴妯″潡
+- 澶氶��
+- 澶嶆牳
+- 鎻愪氦缁勬墭
+
+绗笁鎵瑰畬鎴愶細
+
+- 瀹¤鏃ュ織
+- 鍚屾浠诲姟闃熷垪
+- 鐏板害寮�鍏�
+- 宕╂簝鐩戞帶
+
+---
+
+## 17. 缁撹
+
+杩欐杩佺Щ鐨勬纭柟鍚戜笉鏄�滄妸鐜版湁 uni-app 椤甸潰鏀瑰啓鎴� Flutter鈥濓紝鑰屾槸锛�
+
+- 鐢� Flutter 閲嶅缓瀹㈡埛绔熀纭�璁炬柦
+- 鐢ㄤ腑闂翠欢鎶婂鏉備笟鍔＄殑妯垏鑳藉姏鎻愬墠璁捐濂�
+- 鐢ㄦā鍧楀寲鍒嗗眰鎵挎帴闀挎湡婕旇繘
+- 鐢� AI 鍗忎綔娴佺▼鎻愬崌寮�鍙戦�熷害锛屼絾涓嶇壓鐗插伐绋嬭竟鐣�
+
+鍙棣栨湡鎶婃灦鏋勩�佷腑闂翠欢銆侀厤缃腑蹇冦�佹棩蹇楅摼璺墦绋筹紝鍚庣画鏂板鍑哄叆搴撱�佺洏鐐广�佷笂鏋躲�佷笅鏋躲�丄GV銆佸鎵规祦銆佸浠撱�佸绉熸埛锛岄兘鍙互鍦ㄧ幇鏈夊熀纭�涓婄户缁墿灞曪紝鑰屼笉闇�瑕佸啀娆℃帹鍊掗噸鏉ャ��

--
Gitblit v1.9.1