HaHafeng
1b53ab9d52
Major Changes: - Add StreamingService with OpenAI Compatible format - Upgrade Chat component V2 with Ant Design X integration - Implement AIA module with 12 intelligent agents - Update API routes to unified /api/v1 prefix - Update system documentation Backend (~1300 lines): - common/streaming: OpenAI Compatible adapter - modules/aia: 12 agents, conversation service, streaming integration - Update route versions (RVW, PKB to v1) Frontend (~3500 lines): - modules/aia: AgentHub + ChatWorkspace (100% prototype restoration) - shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook - Update API endpoints to v1 Documentation: - AIA module status guide - Universal capabilities catalog - System overview updates - All module documentation sync Tested: Stream response verified, authentication working Status: AIA V2.0 core completed (85%)
103 lines
6.9 KiB
Markdown
103 lines
6.9 KiB
Markdown
# **諤ｻ菴<EFBDBB> PRD<52>壼現逍礼ｧ醍<EFBDA7>疲匱閭ｽ謨ｰ謐ｮ貂<EFBDAE>ｴ怜ｹｳ蜿?(The Data Cleaning Platform)**
|
||
|
||
| 譁<>｡｣迚域悽 | V1.0 (蝓ｺ莠主ｷ･蜈ｷ邂ｱ譫ｶ譫? |
|
||
| :---- | :---- |
|
||
| **莠ｧ蜩∝ｽ｢諤?* | 莨∽ｸ夂ｺ?Web SaaS 蟷ｳ蜿ｰ |
|
||
| **譬ｸ蠢<EFBDB8>ｻｷ蛟?* | 荳ｺ荳ｴ蠎雁現逕滓署萓?**窶應ｸ遶吝ｼ鞘?* 逧<>焚謐ｮ豐ｻ逅<EFBDBB><E98085>蜉幢ｼ瑚ｧ｣蜀ｳ螟壽ｺ仙ｼよ桷謨ｰ謐ｮ蜷亥ｹｶ髫ｾ縲∫羅蜴<E7BE85>枚譛ｬ謠仙叙髫ｾ縲∫ｻ溯ｮ｡蜑肴ｸ<E882B4>ｴ礼ｹ∫瑞逧<E7919E>ｸ牙､ｧ逞帷せ縲?|
|
||
| **謚譛ｯ譫ｶ譫?* | Node.js \+ React \+ Python/R (扈溯ｮ｡譛榊苅) \+ LLM |
|
||
|
||
## **荳縲?鬘ｹ逶ｮ閭梧勹荳守岼譬?(Background & Objectives)**
|
||
|
||
### **1.1 譬ｸ蠢<EFBDB8>李轤ｹ**
|
||
|
||
荳ｴ蠎顔ｧ醍<EFBFBD>疲焚謐ｮ逧<EFBFBD>㊥螟<EFBFBD>ｿ<EFBFBD>ｨ具ｼ<EFBFBD>ata Preparation<6F>蛾壼ｸｸ蜊<EFBDB8>謐ｮ謨ｴ荳ｪ遘醍<E98198>泌捉譛溽<E8AD9B>?80% 譌ｶ髣ｴ縲ょ現逕滄擇荳ｴ荳牙､ｧ髦ｻ遒搾ｼ<E690BE>
|
||
|
||
1. **荵?(Messy):** HIS 蟇ｼ蜃ｺ逧<EFBDBA>焚謐ｮ蛻<EFBDAE>淵蝨ｨ螟壻ｸｪ Excel<65>磯葎隸翫∽ｽ城劼縲∵｣鬪鯉ｼ会ｼ栗D 蟇ｹ荳堺ｸ奇ｼ梧慮髣ｴ郤ｿ豺ｷ荵ｱ縲?
|
||
2. **譚?(Unstructured):** 螟ｧ驥丞<E9A9A5>髞ｮ菫｡諱ｯ<E8ABB1>亥ｦら羅逅<E7BE85>ｯ頑妙縲∝<E7B8B2>髯｢蟆冗ｻ難ｼ牙ｭ伜惠莠取枚譛ｬ谿ｵ關ｽ荳ｭ<E88DB3>梧裏豕慕峩謗･扈溯ｮ｡縲?
|
||
3. **髞?(Dirty):** 郛ｺ螟ｱ蛟ｼ縲∝ｼょｸｸ蛟ｼ縲∝ｽ募<EFBDBD>髞呵ｯｯ鬚大書<E5A4A7>御ｸ咲ｬｦ蜷育ｻ溯ｮ｡霓ｯ莉ｶ<E88E89><EFBDB6>PSS/SAS<41>臥噪譬ｼ蠑剰ｦ∵ｱゅ?
|
||
### **1.2 莠ｧ蜩∫岼譬<E5B2BC>**
|
||
|
||
譫<EFBFBD>ｻｺ荳荳?**窶懈ｵ∫ｨ句喧縲∵匱閭ｽ蛹悶∽ｽ朱葎讒帚?* 逧<>焚謐ｮ貂<EFBDAE>ｴ怜ｹｳ蜿ｰ<E89CBF><EFBDB0>
|
||
|
||
* **讓｡蝮怜<E89DAE>?(Modular):** 蟆<>､肴揩豬∫ｨ区究隗｣荳ｺ荳我ｸｪ迢ｬ遶句ｷ･蜈ｷ<E89C88>碁剄菴手ｮ､遏･雍溯差縲?
|
||
* **蜿ｯ菫｡襍?(Trustworthy):** 騾夊ｿ<E5A48A>懷曙讓｡蝙矩ｪ瑚ｯ≫晏柱窶懷<E7AAB6>霑<EFBFBD>ｨ玖ｿｽ貅ｯ窶晢ｼ瑚ｧ｣蜀ｳ蟇?AI 逧<>ｿ｡莉ｻ蜊ｱ譛ｺ縲?
|
||
* **鬮俶ｧ閭ｽ (Performant):** 謾ｯ謖<EFBDAF> 10荳? 陦梧焚謐ｮ逧<EFBDAE>ｵ∝ｼ丞､<E4B89E>炊荳主ｮ樊慮郛冶ｾ代?
|
||
## **莠後?莠ｧ蜩∵ｻ菴捺楔譫<E6A594> (Product Architecture)**
|
||
|
||
蟷ｳ蜿ｰ驥<EFBFBD>畑 **窶? \+ 3窶?* 譫ｶ譫<EFBDB6>ｨ｡蠑擾ｼ?*1 荳ｪ扈滉ｸ蟾･菴懷<E88FB4>?\+ 3 荳ｪ蝙ら峩謨郁<E8ACA8>蟾･蜈?*縲?
|
||
### **2.1 譫ｶ譫<EFBDB6><E8ADAB>?*
|
||
|
||
graph TD
|
||
User\[荳ｴ蠎雁現逕<E78FBE>/遘醍<E98198>比ｺｺ蜻禄] \--\> Portal\[譎ｺ閭ｽ謨ｰ謐ｮ貂<EFBDAE>ｴ怜ｷ･菴懷<E88FB4>?(Portal)\]
|
||
|
||
subgraph The\_Toolkit \[謨郁<E8ACA8>蟾･蜈ｷ邂ｱ\]
|
||
Portal \--\> ToolA\[蟾･蜈ｷ A: 雜<>ｺｧ蜷亥ｹｶ蝎ｨ\]
|
||
Portal \--\> ToolB\[蟾･蜈ｷ B: 逞<>紙扈捺桷蛹匁惻蝎ｨ莠ｺ\]
|
||
Portal \--\> ToolC\[蟾･蜈ｷ C: 遘醍<E98198>疲焚謐ｮ郛冶ｾ大勣\]
|
||
end
|
||
|
||
subgraph Data\_Flow \[謨ｰ謐ｮ豬∬ｽｬ\]
|
||
ToolA \--蜷亥ｹｶ蜷取焚謐?-\> ToolB
|
||
ToolB \--扈捺桷蛹匁焚謐?-\> ToolC
|
||
ToolC \--貂<>ｴ怜錘謨ｰ謐ｮ髮<EFBDAE>--\> Analysis\[譎ｺ閭ｽ謨ｰ謐ｮ蛻<EFBDAE>梵讓｡蝮予]
|
||
end
|
||
|
||
subgraph Core\_Capabilities \[蠎募ｱり<EFBDB1>蜉媾]
|
||
Engine1\[豬∝ｼ丞､<E4B89E>炊蠑墓梼\]
|
||
Engine2\[蜿檎峇螟ｧ讓｡蝙句ｼ墓梼\]
|
||
Engine3\[豬剰ｧ亥勣隶｡邂怜ｼ墓梼\]
|
||
end
|
||
|
||
ToolA \-.-\> Engine1
|
||
ToolB \-.-\> Engine2
|
||
ToolC \-.-\> Engine3
|
||
|
||
### **2.2 讓｡蝮怜ｮ壻ｹ我ｸ手ｾｹ逡?*
|
||
|
||
| 讓｡蝮怜錐遘ｰ | 蟇ｹ蠎泌惻譎ｯ | 譬ｸ蠢<EFBDB8>ｻｻ蜉｡ | 蜈ｳ髞ｮ莠ｧ蜃ｺ | 隸ｦ扈<EFBDA6>枚譯｣ |
|
||
| :---- | :---- | :---- | :---- | :---- |
|
||
| **蟾･菴懷<E88FB4>?(Portal)** | 蜈ｨ螻蜈･蜿｣ | 莉ｻ蜉｡逶第而縲∬ｵ<E288AC>ｺｧ邂｡逅<EFBDA1>∬ｷｨ蟾･蜈ｷ豬∬ｽｬ | 扈滉ｸ莉ｪ陦ｨ逶?| [PRD\_謨ｰ謐ｮ貂<EFBDAE>ｴ怜ｷ･菴懷床](https://www.google.com/search?q=PRD_%E6%95%B0%E6%8D%AE%E6%B8%85%E6%B4%97%E5%B7%A5%E4%BD%9C%E5%8F%B0.md) |
|
||
| **蟾･蜈ｷ A (Merger)** | 螟壽ｺ仙粋蟷ｶ | ID 蟇ｹ鮨舌∬ｮｿ隗<EFBDBF>渕蜃<E6B895>粋蟷ｶ縲∵慮髣ｴ遯玲ｸ<E78EB2>ｴ<EFBFBD> | 螳ｽ陦ｨ (Wide Table) | [PRD\_蟾･蜈ｷA\_雜<5F>ｺｧ蜷亥ｹｶ蝎ｨ\_V2](https://www.google.com/search?q=PRD_%E5%B7%A5%E5%85%B7A_%E8%B6%85%E7%BA%A7%E5%90%88%E5%B9%B6%E5%99%A8_V2.md) |
|
||
| **蟾･蜈ｷ B (AI)** | 譁<>悽謠仙叙 | OCR縲∝ｮ樔ｽ捺署蜿悶<E682B6>嚼遘∬┳謨上∽ｺ､蜿蛾ｪ瑚ｯ?| 扈捺桷蛹門ｭ玲ｮ?| [PRD\_蟾･蜈ｷB\_逞<5F>紙扈捺桷蛹匁惻蝎ｨ莠ｺ\_V2](https://www.google.com/search?q=PRD_%E5%B7%A5%E5%85%B7B_%E7%97%85%E5%8E%86%E7%BB%93%E6%9E%84%E5%8C%96%E6%9C%BA%E5%99%A8%E4%BA%BA_V2.md) |
|
||
| **蟾･蜈ｷ C (Editor)** | 豺ｱ蠎ｦ貂<EFBDA6>ｴ<EFBFBD> | 郛ｺ螟ｱ蝪ｫ陦･縲∝ｼょｸｸ螟<EFBDB8>炊縲∝序驥剰ｮ｡邂励∝<C280>邂?| 譛扈亥<E68988>譫宣寔 | [PRD\_蟾･蜈ｷC\_遘醍<E98198>疲焚謐ｮ郛冶ｾ大勣\_V2](https://www.google.com/search?q=PRD_%E5%B7%A5%E5%85%B7C_%E7%A7%91%E7%A0%94%E6%95%B0%E6%8D%AE%E7%BC%96%E8%BE%91%E5%99%A8_V2.md) |
|
||
|
||
## **荳峨?譬ｸ蠢<EFBDB8>ｸ壼苅豬∫ｨ<E288AB> (Core Workflows)**
|
||
|
||
### **3.1 蜈ｸ蝙句<E89D99>體ｾ霍ｯ蝨ｺ譎?(The "Happy Path")**
|
||
|
||
蝨ｺ譎ｯ<EFBFBD>壼現逕滓噺髮<EFBFBD>ｺ<EFBFBD> 100 莉ｽ謔｣閠<EFBDA3>噪菴城劼 Excel 蜥檎羅逅<E7BE85>冠蜻?PDF<44>碁怙隕∬ｿ幄｡檎函蟄伜<E89F84>譫舌?
|
||
1. **蜷亥ｹｶ (Step 1):** 蝨?**蟾･菴懷<E88FB4>?* 蜷ｯ蜉ｨ **蟾･蜈ｷ A**縲ゆｸ贋ｼ<E8B48B>窶應ｽ城劼隶ｰ蠖補昜ｸｺ荳ｻ陦ｨ<E999A6>娯懈｣鬪悟黒窶昜ｸｺ霎<EFBDBA>｡ｨ縲らｳｻ扈溷渕莠寂懷<C280>髯｢譌･譛?ﾂｱ7螟ｩ窶晉噪譌ｶ髣ｴ遯暦ｼ悟ｰ<E6829F>｣鬪梧焚謐ｮ謖りｽｽ蛻ｰ菴城劼隶ｰ蠖穂ｸ翫?
|
||
2. **謠仙叙 (Step 2):** 蜷亥ｹｶ螳梧<E89EB3>蜷趣ｼ檎せ蜃ｻ窶懈ｵ∬ｽｬ蛻ｰ蟾･蜈ｷ B窶昴?*蟾･蜈ｷ B** 閾ｪ蜉ｨ蜉<EFBDA8>霓ｽ謨ｰ謐ｮ縲ょ現逕滄画叫窶懆ぜ逋檎羅逅<E7BE85>ｨ｡迚遺晢ｼ悟曙讓｡蝙具ｼ<E585B7>eepSeek & Qwen<65>牙ｹｶ蜿第署蜿問懆ち逖､螟ｧ蟆鞘晏柱窶懈ｷ句ｷｴ扈楢ｽｬ遘ｻ窶昴ょ現逕溷惠蜈ｨ譎ｯ鄂第<E98482>ｼ荳ｭ陬∝<E999AC>荳堺ｸ閾ｴ逧<EFBDB4>焚謐ｮ縲?
|
||
3. **貂<>ｴ<EFBFBD> (Step 3):** 謠仙叙螳梧<E89EB3>蜷趣ｼ檎せ蜃ｻ窶懈ｵ∬ｽｬ蛻ｰ蟾･蜈ｷ C窶昴?*蟾･蜈ｷ C** 謇灘ｼ郛冶ｾ大勣縲ょ現逕滄夊ｿ<E5A48A>ｾｧ霎ｹ譬丞書邇ｰ窶懆ち逖､螟ｧ蟆鞘晄怏郛ｺ螟ｱ蛟ｼ<E89B9F>御ｸ髞ｮ逕ｨ蝮<EFBDA8>ｼ蝪ｫ陦･<E999A6>帛ｹｶ譁ｰ蠅櫁ｮ｡邂怜<E98282> BMI縲?
|
||
4. **蛻<>梵 (Step 4):** 謨ｰ謐ｮ貂<EFBDAE>ｴ怜ｮ梧ｯ包ｼ御ｿ晏ｭ倅ｸｺ窶懷<E7AAB6>譫宣寔\_V1窶昴ゆｸ髞ｮ蜿鷹∬<C280>邉ｻ扈溽噪窶懈匱閭ｽ謨ｰ謐ｮ蛻<EFBDAE>梵窶晄ｨ｡蝮苓ｿ幄｡?Kaplan-Meier 逕溷ｭ伜<EFBDAD>譫舌?
|
||
## **蝗帙?蜈ｨ螻髱槫粥閭ｽ髴豎?(Non-Functional Requirements)**
|
||
|
||
### **4.1 逕ｨ謌ｷ菴馴ｪ檎ｭ也払 (UX Strategy)**
|
||
|
||
* **蜴ｻ蜿ｯ隗<EFBDAF>喧 (De-visualization):** 蟇ｹ莠主ｷ･蜈ｷ A 蜥?B<>御ｸ榊ｱ慕､ｺ蜈ｨ驥<EFBDA8> Excel 鄂第<E98482>ｼ<EFBFBD>碁㊦逕?**窶懷髄蟇ｼ驟咲ｽ?\-\> 鮟醍將螟<E5B087>炊 \-\> 鮟<>≡鬚<E289A1>ｧ遺?* 逧<>ｨ｡蠑擾ｼ碁剄菴取ｵ剰ｧ亥勣貂ｲ譟灘視蜉幢ｼ瑚★辟ｦ扈捺棡縲?
|
||
* **蜿埼ｦ郁｡･蛛ｿ (Feedback Loop):** 譌｢辟ｶ逵倶ｸ崎ｧ∬ｿ<E288AC>ｨ具ｼ悟ｿ<E6829F>｡ｻ蠅槫ｼｺ扈捺棡蜿埼ｦ医よｯ丈ｸｪ蟾･蜈ｷ蠢<EFBDB7>｡ｻ謠蝉ｾ幄ｯｦ扈<EFBDA6>噪 **窶懈焚謐ｮ雍ｨ驥乗冠蜻岩?*<2A>亥ｦゑｼ壻ｸ｢蠑<EFBDA2>｡梧焚縲∝<E7B8B2>遯∫紫縲∫ｩｺ蛟ｼ邇<EFBDBC>ｼ峨?
|
||
* **譛ｬ蝨ｰ莨伜<E88EA8> (Local-First):** 蟾･蜈ｷ C 驥<>畑 IndexedDB 蟄伜お<E4BC9C>檎｡ｮ菫晉ｼ冶ｾ第桃菴懶ｼ育ｭ幃峨∵崛謐｢<E8AC90>画裏鄂醍ｻ懷ｻｶ霑溘?
|
||
### **4.2 謨ｰ謐ｮ螳牙<E89EB3>荳朱嚼遘?(Security & Privacy)**
|
||
|
||
* **PII 閼ｱ謨<EFBDB1>:** 謇譛牙書騾∫ｻ<E288AB> LLM (蟾･蜈ｷ B) 逧<>焚謐ｮ<E8AC90><EFBDAE>**蠢<>｡ｻ**蝨ｨ蜷守ｫｯ蜈育ｻ剰ｿ<E589B0>ｭ｣蛻呵┳謨擾ｼ亥ｧ灘錐縲∬ｺｫ莉ｽ隸√∵焔譛ｺ蜿ｷ<E89CBF>峨?
|
||
* **謨ｰ謐ｮ髫皮ｦｻ:** 荳榊酔逕ｨ謌ｷ逧<EFBDB7>焚謐ｮ荳･譬ｼ迚ｩ逅<EFBDA9>囈遖ｻ<E98196><EFBDBB>3 霍ｯ蠕<EFBDAF> / DB Row Level Security<74>峨?
|
||
### **4.3 諤ｧ閭ｽ謖<EFBDBD><E8AC96><EFBFBD> (Performance SLAs)**
|
||
|
||
* **譁<>ｻｶ謾ｯ謖<EFBDAF>:** 蜊穂ｸｪ譁<EFBDAA>ｻｶ謾ｯ謖∵怙螟?**50MB** 謌?**50荳<30>｡<EFBFBD>**縲?
|
||
* **蜩榊ｺ秘溷ｺｦ:**
|
||
* 蟾･蜈ｷ A 蜷亥ｹｶ<EFBDB9>?0荳<30>｡鯉ｼ会ｼ喀< 60遘偵?
|
||
* 蟾･蜈ｷ B 謠仙叙<E4BB99>亥ｹｶ蜿托ｼ会ｼ壼叙蜀ｳ莠<EFBDB3> Token 驥擾ｼ碁怙謠蝉ｾ幄ｿ帛ｺｦ譚｡縲?
|
||
* 蟾･蜈ｷ C 郛冶ｾ大桃蠎費ｼ喀< 100ms縲?
|
||
## **莠斐?謨ｰ謐ｮ譬<EFBDAE>㊥荳取ｵ∬ｽｬ蜊剰ｮ?(Data Standards)**
|
||
|
||
荳ｺ莠<EFBFBD>ｿ晁ｯ∽ｸ我ｸｪ蟾･蜈ｷ閭ｽ鬘ｺ逡<EFBFBD>刻菴懶ｼ悟ｿ<EFBFBD>｡ｻ螳壻ｹ臥ｻ滉ｸ逧<EFBFBD>焚謐ｮ莠､謐｢譬<EFBFBD>㊥<EFBFBD><EFBFBD>
|
||
|
||
1. **譁<>ｻｶ譬ｼ蠑<EFBDBC>:** 蜀<>Κ豬∬ｽｬ扈滉ｸ菴ｿ逕ｨ **CSV (UTF-8 with BOM)** 謌?**JSON Lines**縲?
|
||
2. **譌･譛滓<E8AD9B>ｼ蠑<EFBDBC>:** 謇譛牙ｷ･蜈ｷ莠ｧ蜃ｺ逧<EFBDBA>律譛溷<E8AD9B><E6BAB7>悟ｼｺ蛻ｶ譬<EFBDB6>㊥蛹紋ｸｺ YYYY-MM-DD縲?
|
||
3. **遨ｺ蛟ｼ陦ｨ遉?** 扈滉ｸ菴ｿ逕ｨ null 謌也ｩｺ蟄礼ｬｦ荳?""<22>御ｸ･遖∽ｽｿ逕?"NA", "-" 遲画枚譛ｬ豺ｷ蜈･謨ｰ蛟ｼ蛻励?
|
||
4. **豬∬ｽｬ蜃ｭ隸<EFBDAD>:** 霍ｨ蟾･蜈ｷ霍ｳ霓ｬ譌ｶ<E8AD8C>碁夊ｿ<E5A48A> URL 蜿よ焚莨<E7849A>騾?assetId (襍<>ｺｧID)<29>梧磁謾ｶ譁ｹ騾夊ｿ<E5A48A> API 闔ｷ蜿匁枚莉ｶ豬<EFBDB6>ｼ梧裏髴蜑咲ｫｯ騾丈ｼ<E4B888>螟ｧ譁<EFBDA7>ｻｶ縲?
|
||
## **蜈ｭ縲?髯<>ｽ包ｼ夂沿譛ｬ隗<EFBDAC><E99A97>?(Roadmap)**
|
||
|
||
* **Phase 1 (MVP):** 荳顔ｺｿ蟾･菴懷<E88FB4>?\+ 蟾･蜈ｷ A (蝓ｺ遑蜷亥ｹｶ) \+ 蟾･蜈ｷ C (蝓ｺ遑郛冶ｾ<E586B6>)縲ょｷ･蜈?B 證ゆｸ堺ｸ顔ｺｿ縲?
|
||
* **Phase 2 (Intelligence):** 荳顔ｺｿ 蟾･蜈ｷ B (蜊墓ｨ｡蝙区署蜿?縲ょｷ･蜈?C 蠅槫刈萓ｧ霎ｹ譬冗ｻ溯ｮ｡縲?
|
||
* **Phase 3 (Trust):** 蟾･蜈ｷ B 蜊<>ｺｧ荳ｺ蜿梧ｨ｡蝙倶ｺ､蜿蛾ｪ瑚ｯ√ょｷ･蜈?A 蜊<>ｺｧ荳ｺ譌ｶ髣ｴ遯怜粋蟷ｶ縲 |