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%)
6.9 KiB
6.9 KiB
2025-11-14 浠诲姟19瀹屾垚鎬荤粨
*浠诲姟锛? 鍚庣<E98D9A>浠g爜鍒嗗眰锛圔ackend Code Layering锛? *鏃堕棿锛? 2025-11-14
鐘舵€侊細 鉁?瀹屾垚
*绛栫暐锛? 澧為噺婕旇繘锛屾柊鏃у苟瀛?
馃幆 浠诲姟鐩<E5A79F>爣
鍩轰簬銆婂墠鍚庣<EFBFBD>妯″潡鍖栨灦鏋勮<EFBFBD>璁?V2.md銆嬪拰銆婂悗绔<E68297>灦鏋勫<E98F8B>閲忔紨杩涙柟妗?md銆嬶紝瀵瑰悗绔<E68297>唬鐮佽繘琛屽垎灞傛敼閫狅紝涓烘湭鏉ユā鍧楃嫭绔嬮儴缃叉墦涓嬪熀纭€銆?
鉁?瀹屾垚鍐呭<E98D90>
1. 鏋舵瀯绛栫暐鍒跺畾
- 鉁?閲囩敤"缁炴潃鑰呮ā寮?锛圫trangler Fig Pattern锛?
- 鉁?鏂版棫浠g爜骞跺瓨锛岄浂椋庨櫓鏀归€?
- 鉁?鐜版湁妯″潡淇濇寔涓嶅彉锛屾柊妯″潡鎸夋爣鍑嗗紑鍙?
2. 鐩<EFBFBD>綍缁撴瀯閲嶇粍
**閲嶇粍鍓?*锛堝钩閾虹粨鏋勶級锛?
backend/src/
鈹溾攢鈹€ routes/
鈹溾攢鈹€ controllers/
鈹溾攢鈹€ services/
鈹溾攢鈹€ adapters/
鈹溾攢鈹€ clients/
鈹溾攢鈹€ utils/
鈹溾攢鈹€ middleware/
鈹斺攢鈹€ config/
**閲嶇粍鍚?*锛堜笁灞傛灦鏋勶級锛?
backend/src/
鈹溾攢鈹€ legacy/ # 馃敻 鐜版湁涓氬姟浠g爜锛堜繚鎸佷笉鍙橈級
鈹? 鈹溾攢鈹€ routes/
鈹? 鈹溾攢鈹€ controllers/
鈹? 鈹溾攢鈹€ services/
鈹? 鈹斺攢鈹€ templates/
鈹?
鈹溾攢鈹€ common/ # 馃敡 閫氱敤鑳藉姏灞?
鈹? 鈹溾攢鈹€ llm/adapters/ # LLM閫傞厤鍣<E58EA4>紙DeepSeek, Qwen锛?
鈹? 鈹溾攢鈹€ rag/ # RAG鑳藉姏锛圖ify锛?
鈹? 鈹溾攢鈹€ document/ # 鏂囨。澶勭悊
鈹? 鈹溾攢鈹€ utils/ # 宸ュ叿鍑芥暟
鈹? 鈹斺攢鈹€ middleware/ # 涓<>棿浠?
鈹?
鈹溾攢鈹€ modules/ # 馃専 鏂版灦鏋勬ā鍧?
鈹? 鈹斺攢鈹€ asl/ # ASL妯″潡鍗犱綅锛堟爣鍑嗗寲锛?
鈹?
鈹斺攢鈹€ config/ # 鈿欙笍 閰嶇疆灞?
3. 浠g爜杩佺Щ
鏂囦欢杩佺Щ娓呭崟锛?
- 鉁?7涓<37>矾鐢辨枃浠?鈫?
legacy/routes/ - 鉁?8涓<38>帶鍒跺櫒鏂囦欢 鈫?
legacy/controllers/ - 鉁?8涓<38>湇鍔℃枃浠?鈫?
legacy/services/ - 鉁?1涓<31>ā鏉挎枃浠?鈫?
legacy/templates/ - 鉁?4涓狶LM閫傞厤鍣?鈫?
common/llm/adapters/ - 鉁?2涓猂AG瀹㈡埛绔?鈫?
common/rag/ - 鉁?1涓<31>枃妗e<E5A697>鐞嗗<E9909E>鎴风<E98EB4> 鈫?
common/document/ - 鉁?1涓<31>伐鍏锋枃浠?鈫?
common/utils/ - 鉁?1涓<31>腑闂翠欢鏂囦欢 鈫?
common/middleware/
*鎬昏<EFBFBD>锛?3涓<33>枃浠讹紝闆堕<E99786>闄╄縼绉?
4. 瀵煎叆璺<EFBFBD>緞鏇存柊
鏇存柊绫诲瀷锛?
- 鉁?
index.ts锛?澶勮矾鐢卞<E990A2>鍏ヨ矾寰? - 鉁?Legacy灞傚唴閮<E594B4>細15澶勫<E6BEB6>鍏ヨ矾寰勬洿鏂?
config鐩稿<E990A9>璺<EFBFBD>緞锛歚../config/鈫?../../config/`adapters鐩稿<E990A9>璺<EFBFBD>緞锛歚../adapters/鈫?../../common/llm/adapters/`clients鐩稿<E990A9>璺<EFBFBD>緞锛歚../clients/xxx鈫?../../common/rag|document/xxx`utils鐩稿<E990A9>璺<EFBFBD>緞锛歚../utils/鈫?../../common/utils/`middleware鐩稿<E990A9>璺<EFBFBD>緞锛歚../middleware/鈫?../../common/middleware/`
- 鉁?Common灞傚唴閮<E594B4>細3澶勫<E6BEB6>鍏ヨ矾寰勬洿鏂?
config鐩稿<E990A9>璺<EFBFBD>緞锛歚../config/鈫?../../config/鎴?../../../config/`
- 鉁?
__dirname璺<>緞锛?澶勬洿鏂?agentService.ts: 2澶勶紙config/agents.yaml, prompts/锛?reviewService.ts: 2澶勶紙prompts/review_*.txt锛?
鎬昏<EFBFBD>锛?9澶勮矾寰勬洿鏂帮紝閫愪釜鎵嬪姩淇<E5A7A9>敼锛屾棤涔辩爜
5. 鍏抽敭闂<EFBFBD><EFBFBD>瑙e喅
*闂<EFBFBD><EFBFBD>1锛氫腑鏂囦贡鐮侀<EFBFBD>闄?
- 棰勯槻鎺<EFBFBD>柦锛氶€愪釜鏂囦欢鎵嬪姩淇<EFBFBD>敼锛屾嫆缁濇壒閲忚剼鏈?
- 缁撴灉锛氣渽 闆朵贡鐮侊紝鎵€鏈変腑鏂囨敞閲婂畬濂?
闂<EFBFBD><EFBFBD>2锛氭壒澶勭悊鍔熻兘500閿欒<EFBFBD>
- **閿欒<E996BF>**锛歚rawOutput` 瀛楁<E7809B>涓嶅瓨鍦?
- 鏍瑰洜锛歅risma Schema 缂哄皯
@map("raw_output") - 瑙e喅锛氭坊鍔犳槧灏勶紝閲嶆柊鐢熸垚 Prisma Client
- 缁撴灉锛氣渽 鎵瑰<E98EB5>鐞嗗姛鑳芥<E991B3>甯歌繍琛?
*闂<EFBFBD><EFBFBD>3锛氶厤缃<EFBFBD>枃浠惰矾寰?
- **闂<><E99782>**锛歚agents.yaml
,prompts/` 璺<>緞閿欒<E996BF> - 瑙e喅锛氫慨姝?
__dirname鐩稿<E990A9>璺<EFBFBD>緞璁$畻 - 缁撴灉锛氣渽 閰嶇疆鏂囦欢姝g‘鍔犺浇
馃И 娴嬭瘯楠岃瘉
鍔熻兘娴嬭瘯锛團rontend + Backend锛?
- 鉁?鏅鸿兘闂<EFBFBD>瓟 - 瀵硅瘽妯″紡锛氭<EFBFBD>甯歌繍琛?
- 鉁?**鏅鸿兘闂<E58598>瓟 - 鐭ヨ瘑搴撴ā寮?*锛氭<E9949B>甯歌繍琛?
- 鉁?**鏅鸿兘闂<E58598>瓟 - 鎵瑰<E98EB5>鐞嗘ā寮?*锛氣渽 淇<><E6B787>鍚庢<E98D9A>甯?
- 鉁?**鐭ヨ瘑搴撶<E690B4>鐞?*锛氭<E9949B>甯歌繍琛?
- 鉁?鏂囨。涓婁紶锛氭<EFBFBD>甯歌繍琛?
- 鉁?椤圭洰绠$悊锛氭<EFBFBD>甯歌繍琛?
鏈嶅姟鍚<EFBFBD>姩娴嬭瘯
# 鍚庣<E98D9A>鏈嶅姟
鉁?npm run dev - 姝e父鍚<E788B6>姩
鉁?http://localhost:3001/health - 鍋ュ悍妫€鏌ラ€氳繃
# 鍓嶇<E98D93>鏈嶅姟
鉁?npm run dev - 姝e父鍚<E788B6>姩
鉁?http://localhost:3000 - 鍓嶇<E98D93>椤甸潰姝e父
馃搳 鏋舵瀯瀵规瘮
| 缁村害 | 閲嶇粍鍓? | 閲嶇粍鍚? |
|---|---|---|
| 浠g爜缁勭粐 | 骞抽摵锛屾棤灞傛<EFBFBD> | 涓夊眰鏋舵瀯锛屾竻鏅版槑纭? |
| 鑱岃矗鍒掑垎 | 娣锋潅 | Legacy/Common/Modules 鍒嗙<E98D92> |
| *鏂版ā鍧楀紑鍙? | 鏃犳爣鍑? | 鏍囧噯鍖栫洰褰曠粨鏋? |
| 鐙<EFBFBD>珛閮ㄧ讲 | 涓嶆敮鎸? | 鏀<EFBFBD>寔锛坢odules/asl/锛? |
| 浠g爜澶嶇敤 | 鍥伴毦 | 閫氱敤鑳藉姏灞傜粺涓€绠$悊 |
| 鏋舵瀯婕旇繘 | 涓€娆℃€ч噸鍐欓<EFBFBD>闄╅珮 | 澧為噺婕旇繘锛岄<EFBFBD>闄╁彲鎺? |
馃幆 鏍稿績浠峰€?
1. *闆堕<EFBFBD>闄╂敼閫? 猸愨瓙猸?
- 鐜版湁鍔熻兘100%杩愯<E69DA9>
- 鏃犻渶澶ц<EFBFBD>妯¢噸鏋?
- 闅忔椂鍙<EFBFBD>洖婊?
2. *娓呮櫚鐨勬灦鏋勮竟鐣?
legacy/ 鈫?鏃т唬鐮侊紝鏄庣‘鏍囪瘑锛屼笉涓诲姩鏀?
common/ 鈫?閫氱敤鑳藉姏锛屽悇妯″潡鍏变韩
modules/ 鈫?鏂版ā鍧楋紝鏍囧噯鍖栧紑鍙?
3. *ASL妯″潡寮€鍙戝氨缁?
modules/asl/鐩<>綍宸插垱寤?- 鍙<EFBFBD>洿鎺ユ寜鏍囧噯鏋舵瀯寮€鍙?
- 涓嶅彈鏃т唬鐮佺害鏉?
4. 骞虫粦婕旇繘璺<EFBFBD>緞
鐜板湪锛? 7涓<37>棫妯″潡锛坙egacy锛?+ 0涓<30>柊妯″潡
鏈<>潵锛? 7涓<37>棫妯″潡 + 1涓<31>柊妯″潡锛圓SL锛?
鏇磋繙锛? 7涓<37>棫妯″潡 + N涓<4E>柊妯″潡
鏈€缁堬細 鎸夐渶閫愭<E996AB>杩佺Щ鏃фā鍧楋紙鍙<E7B499>€夛級
馃摑 缁忛獙鎬荤粨
鉁?鍋氬緱濂界殑
- **璋ㄦ厧鐨勭瓥鐣?*锛氶€夋嫨澧為噺婕旇繘鑰岄潪涓€娆℃€ч噸鍐?
- 鎵嬪姩淇<EFBFBD>敼锛氶€愪釜鏂囦欢淇<EFBFBD>敼锛岄伩鍏嶆壒閲忚剼鏈<EFBFBD>贡鐮?
- 鍏呭垎娴嬭瘯锛氭瘡涓<EFBFBD>姛鑳介兘瀹為檯娴嬭瘯楠岃瘉
- 闂<EFBFBD><EFBFBD>娣辨寲锛氭壒澶勭悊闂<EFBFBD><EFBFBD>杩芥牴婧<EFBFBD>簮鍒版暟鎹<EFBFBD>簱瀛楁<EFBFBD>
- 鏂囨。瀹屽杽锛氳<EFBFBD>缁嗚<EFBFBD>褰曞疄鏂借繃绋嬪拰鍐崇瓥
鈿狅笍 闇€瑕佹敞鎰忕殑
- 璺<EFBFBD>緞渚濊禆锛氬<EFBFBD>鍏ヨ矾寰勯渶浠旂粏璁$畻锛坄../
vs../../vs../../../`锛? - 鐩稿<EFBFBD>璺<EFBFBD>緞闄烽槺锛歚__dirname` 鍦ㄧ洰褰曠Щ鍔ㄥ悗闇€瑕佽皟鏁?
- Prisma鏄犲皠锛氭暟鎹<EFBFBD>簱瀛楁<EFBFBD>涓庝唬鐮佸瓧娈甸渶瑕?
@map鏄犲皠 - 娴嬭瘯瑕嗙洊锛氭煇浜涘姛鑳斤紙濡傛壒澶勭悊锛変箣鍓嶅彲鑳芥祴璇曚笉瓒?
馃搨 鐩稿叧鏂囨。
-
**鏋舵瀯璁捐<E79281>**锛?
docs/00-绯荤粺鎬讳綋璁捐<E79281>/鍓嶅悗绔<E68297>ā鍧楀寲鏋舵瀯璁捐<E79281>-V2.mddocs/09-鏋舵瀯瀹炴柦/鍚庣<E98D9A>鏋舵瀯澧為噺婕旇繘鏂规<E98F82>.md
-
瀹炴柦璁板綍锛?
docs/08-椤圭洰绠$悊/涓嬩竴闃舵<E99783>琛屽姩璁″垝-V2.2-瀹屾暣鐗?md
-
缂栫爜瑙勮寖锛?
docs/09-鏋舵瀯瀹炴柦/缂栫爜瑙勮寖-UTF8鏈€浣冲疄璺?md.editorconfig.gitattributes
馃殌 涓嬩竴姝ヨ<E5A79D>鍔?
绔嬪嵆寮€濮嬶細浠诲姟20 - Week 2 楠屾敹
- 楠屾敹鍓嶇<EFBFBD>缁熶竴鏋舵瀯
- 楠屾敹鍚庣<EFBFBD>浠g爜鍒嗗眰
- 缂栧啓 Week 2 鎬荤粨鎶ュ憡
- 鍑嗗<EFBFBD> ASL 寮€鍙?
*Week 3-4锛欰SL 妯″潡寮€鍙?
- 鍦ㄦ柊鏋舵瀯涓嬪紑鍙?ASL 妯″潡
- 楠岃瘉鏍囧噯鍖栧紑鍙戞祦绋?
- 绉<EFBFBD>疮鏂版灦鏋勫疄璺电粡楠?
*瀹屾垚鏃堕棿锛? 2025-11-14
*鑰楁椂锛? 绾?灏忔椂锛堝惈闂<E68388><E99782>鎺掓煡锛?
*鏂囦欢淇<EFBFBD>敼锛? 33涓<33>枃浠剁Щ鍔?+ 29澶勮矾寰勬洿鏂?+ 1澶凱risma淇<61><E6B787>
娴嬭瘯鐘舵€侊細 鉁?鎵€鏈夊姛鑳介€氳繃
*椋庨櫓绛夌骇锛? 鏋佷綆锛堝<E9949B>閲忔紨杩涳級
*鎴愭灉璇勪环锛? 猸愨瓙猸?瓒呭嚭棰勬湡锛屾灦鏋勬竻鏅帮紝鍔熻兘绋冲畾