From f87ce86307056f63f79312178037cc8714eb2b13 Mon Sep 17 00:00:00 2001 From: 云 <2163098428@qq.com> Date: 星期二, 29 九月 2026 14:17:52 +0800 Subject: [PATCH] feat(docs): 添加档案管理模块业务流程文档 --- docs/project-business/README.md | 13 +++++++------ 1 files changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/project-business/README.md b/docs/project-business/README.md index f9b19a7..e133ada 100644 --- a/docs/project-business/README.md +++ b/docs/project-business/README.md @@ -8,19 +8,19 @@ - **涓氬姟瀹氫綅**锛氱鏁ｅ埗閫犲伐鍘備骇渚涢攢浜鸿储鐗╀竴浣撳寲锛氳鐩栥�庨攢鍞帴鍗� 鈫� 閲囪喘/鐢熶骇 鈫� 璐ㄦ 鈫� 浠撳偍 鈫� 鍙戣揣 鈫� 鍥炴 鈫� 鍞悗銆忓叏閾捐矾闂幆 - **鎶�鏈簳搴�**锛歽udao锛坮uoyi-vue-pro锛変簩寮�锛孲pring Boot + MyBatis + Flowable + Redis + MySQL 8.4 + Milvus + 閫氫箟鍗冮棶锛涘墠绔� mom-pro2-before锛圴ue3锛� - **鏍稿績涓荤嚎**锛欳RM 鍚堝悓 鈫� ERP 閿�鍞鍗� 鈫� MES 涓昏鍒�/宸ュ崟/鎶ュ伐 鈫� 璐ㄦ涓庝粨鍌� 鈫� 閿�鍞嚭搴� 鈫� 寮�绁ㄥ洖娆� 鈫� 鍞悗闂幆 -- **鐙珛妯″潡**锛氳储鍔℃姤閿�锛坄yudao-module-finance`锛屾姤閿�鍗�/鏄庣粏/鍙戠エ闄勪欢/瀹℃壒/褰掓。锛屽澶栨彁渚� `yudao-module-finance-api` 渚涗粬妯″潡寤哄崟锛変笌浼氬憳绠＄悊锛坄yudao-module-ums`锛屽叆浼氱敵璇�/绉樹功澶勪笌鐞嗕簨浼氫袱绾у鎵�/浼氬憳/閫氳褰曪級鍚勮嚜鎴愪竴鏉￠摼璺紙UMS 渚嬪锛氬鎵归�氳繃浼氱粡 AdminUserApi 鍒涘缓绯荤粺鐧诲綍璐﹀彿锛夛紱璇鹃绠＄悊锛坄yudao-module-research`锛岃棰樻寚鍗�/鍦ㄧ嚎鐢虫姤/涓撳璇勫/涓夌骇绔嬮」瀹℃壒/绔嬮」閫氱煡/缁忚垂鎷ㄤ粯锛変负鍙︿竴鏉＄嫭绔嬬鐮斾富绾匡紝鍚戝鍙� `ums_member` 浣滀负鐢虫姤浜恒�佸啓 `system_notice` 绔嬮」鍏憡锛�**骞跺凡瀵规帴璐㈠姟**锛氱粡璐规嫧浠� 1:1 鑷姩鐢熸垚璐㈠姟鎶ラ攢鍗曞苟鎻愪氦瀹℃壒锛屽鎵圭粨鏋滅粡 BPM 鐩戝惉鍣ㄥ洖鍐欒棰樹晶鎷ㄦ鍙拌处 +- **鐙珛妯″潡**锛氳储鍔℃姤閿�锛坄yudao-module-finance`锛屾姤閿�鍗�/鏄庣粏/鍙戠エ闄勪欢/瀹℃壒/褰掓。锛屽澶栨彁渚� `yudao-module-finance-api` 渚涗粬妯″潡寤哄崟锛変笌浼氬憳绠＄悊锛坄yudao-module-ums`锛屽叆浼氱敵璇�/绉樹功澶勪笌鐞嗕簨浼氫袱绾у鎵�/浼氬憳/閫氳褰曪級鍚勮嚜鎴愪竴鏉￠摼璺紙UMS 渚嬪锛氬鎵归�氳繃浼氱粡 AdminUserApi 鍒涘缓绯荤粺鐧诲綍璐﹀彿锛夛紱璇鹃绠＄悊锛坄yudao-module-research`锛岃棰樻寚鍗�/鍦ㄧ嚎鐢虫姤/涓撳璇勫/涓夌骇绔嬮」瀹℃壒/绔嬮」閫氱煡/缁忚垂鎷ㄤ粯锛変负鍙︿竴鏉＄嫭绔嬬鐮斾富绾匡紝鍚戝鍙� `ums_member` 浣滀负鐢虫姤浜恒�佸啓 `system_notice` 绔嬮」鍏憡锛�**骞跺凡瀵规帴璐㈠姟**锛氱粡璐规嫧浠� 1:1 鑷姩鐢熸垚璐㈠姟鎶ラ攢鍗曞苟鎻愪氦瀹℃壒锛屽鎵圭粨鏋滅粡 BPM 鐩戝惉鍣ㄥ洖鍐欒棰樹晶鎷ㄦ鍙拌处锛涙。妗堢鐞嗭紙`yudao-module-archive`锛屽垎绫讳功鏋�/妗ｆ鐧昏涓庢绱�/鍊熼槄涓ょ骇瀹℃壒/褰掕繕闂幆/閫炬湡瀹炴椂鎻愰啋/缁熻锛変负绗洓鏉＄嫭绔嬩富绾匡紝**瀵瑰鎻愪緵 `yudao-module-archive-api` 渚涜棰樸�佷細鍛樸�佽储鍔′笁鏂瑰悜鍏跺綊妗�**锛堝垪琛ㄩ〉鎵嬪姩銆屽綊妗ｃ�嶆寜閽紝褰掓。涓嶅洖鍐欐潵婧愪笟鍔＄姸鎬侊級锛岃嚜韬涓夋柟**鏃犲弽鍚戜緷璧�** ## 2. 鐩綍缁撴瀯 ```text docs/project-business/ 鈹溾攢鈹� index.html # 鍙鍖栭〉闈細鍙屽嚮鐩存帴鎵撳紑锛坒ile:// 鍗冲彲锛屾棤闇�浠讳綍鏈嶅姟锛� -鈹溾攢鈹� mermaid/ # 14 寮� Mermaid 涓氬姟鍥撅紙鏉冨▉婧愶紝鏀硅繖閲岋級 +鈹溾攢鈹� mermaid/ # 15 寮� Mermaid 涓氬姟鍥撅紙鏉冨▉婧愶紝鏀硅繖閲岋級 鈹溾攢鈹� data/ # 涓氬姟鏁版嵁锛堟潈濞佹簮锛屾敼杩欓噷锛� 鈹� 鈹溾攢鈹� business.json # 椤圭洰鍏冧俊鎭�/涓氬姟鍗侀棶/AI鑳藉姏/寰呯‘璁や簨椤� -鈹� 鈹溾攢鈹� modules.json # 16 涓笟鍔℃ā鍧楀畾涔� +鈹� 鈹溾攢鈹� modules.json # 17 涓笟鍔℃ā鍧楀畾涔� 鈹� 鈹溾攢鈹� objects.json # 鏍稿績涓氬姟瀵硅薄锛堜綔鐢�/涓婃父/涓嬫父/琛ㄥ悕锛� -鈹� 鈹溾攢鈹� flows.json # 9 鏉℃祦绋嬶紙鎽樿+姝ラ+瑙掕壊锛� +鈹� 鈹溾攢鈹� flows.json # 10 鏉℃祦绋嬶紙鎽樿+姝ラ+瑙掕壊锛� 鈹� 鈹斺攢鈹� roles.json # 瑙掕壊鏉冮檺 鈹斺攢鈹� README.md ``` @@ -49,6 +49,7 @@ | 12-finance-flow | 璐㈠姟鎶ラ攢锛堢嫭绔嬫ā鍧楋級锛氭姤閿�鍗�+鏄庣粏+鍙戠エ闄勪欢 鈫� 鎻愪氦 BPM 瀹℃壒 鈫� 閫氳繃/椹冲洖 鈫� 褰掓。缁堟�侊紱鍗曟嵁鏉ユ簮鍚墜宸ユ柊寤轰笌銆岃棰樼粡璐规嫧浠樿嚜鍔ㄧ敓鎴愩�嶄袱绫� | | 13-ums-membership-flow | 浼氬憳鍏ヤ細锛堢嫭绔嬫ā鍧楋級锛氬叆浼氱敵璇� + 鏉愭枡闄勪欢 鈫� 鎻愪氦 BPM 涓ょ骇瀹℃壒锛堢涔﹀鍒濆鈫掔悊浜嬩細瀹¤锛夆啋 閫氳繃鑷姩寤轰細鍛樹笌鐧诲綍璐﹀彿 鈫� 浼氬憳鍒楄〃/閫氳褰曟绱� | | 14-research-flow | 璇鹃绠＄悊锛堢嫭绔嬫ā鍧楋級锛氭寚鍗楀彂甯�(閲嶇偣/涓�鑸�)鈫掑湪绾跨敵鎶�(閫変細鍛樺甫鍑虹敵鎶ヤ汉)鈫掍笓瀹惰瘎鍒嗘槑缁嗗姞鏉冩帓鍚嶁啋BPM 涓夌骇瀹℃壒(绉樹功澶勫舰寮忓鏌モ啋涓撳璇勫鈫掑浼氱珛椤瑰鎵�)鈫掔珛椤圭紪鍙蜂笌鍏憡鈫掔粡璐规嫧浠橈紙鍑瘉蹇呭～鈫�1:1 鑷姩鐢熸垚骞舵彁浜よ储鍔℃姤閿�鍗曗啋璐㈠姟瀹℃牳/璐㈠姟涓荤涓ょ骇瀹℃壒鈫掔粨鏋滅粡鐩戝惉鍣ㄥ洖鍐欏彴璐︼細閫氳繃宸叉嫧浠�/椹冲洖宸查┏鍥炲彲閲嶅彂/鎾ゅ洖鍥炲緟鎷ㄤ粯锛墊 +| 15-archive-flow | 妗ｆ绠＄悊锛堢嫭绔嬫ā鍧楋級锛氬垎绫讳功鏋�(鏍戝舰路榛樿瀵嗙骇鈫掓柊澧炴。妗堣嚜鍔ㄥ甫鍑�)鈫掓。妗堢櫥璁�(瀵嗙骇涓夋。/杞戒綋涓夊瀷/瀹炰綋浣嶇疆鍥涘瓧娈�/鐢靛瓙闄勪欢/DA 缂栧彿)鈫掍笁鏂瑰綊妗ｈ仈鍔�(璇鹃宸茬珛椤�/浼氬憳姝ｅ父/璐㈠姟宸查�氳繃 鍚勫垪琛ㄦ墜鍔ㄣ�屽綊妗ｃ�嶁啋缁� `archive-api` 鐢熸垚妗ｆ骞跺洖鍐� `archive_document_id`)鈫掑�熼槄鐧昏(浠呫�屽湪搴撱�嶅彲閫壜峰悓妗ｆ涓嶅緱鏈夊湪閫斿�熼槄鍗�)鈫払PM 涓ょ骇瀹℃壒(妗ｆ绠＄悊鍛樺鏍糕啋鍒嗙棰嗗瀹℃壒路閫氳繃鍚庢。妗堟潯浠舵洿鏂颁负鍊熷嚭涓�)鈫掑綊杩樼櫥璁�(鍥炲湪搴�)鈫掗�炬湡瀹炴椂璁＄畻(涓嶅缓瀹氭椂浠诲姟)鈫掑瓨閲忔祦杞粺璁� | 鍥句腑鐘舵�佹暟瀛楀潎涓烘簮鐮佹灇涓剧湡瀹炲�硷紙濡傚伐鍗� 0鑽夌/1宸茬‘璁�/2瀹屾垚/3鍙栨秷锛汦RP 瀹℃壒 15瀹℃壒涓�/20宸插鏍革級銆� @@ -69,8 +70,8 @@ - 鏈洰褰曠敱椤圭洰鎶�鑳� **project-business-analysis** 绠＄悊锛坄.claude/skills/project-business-analysis/`锛夛紝骞舵湁瑙勫垯 `.claude/rules/business-visualization-maintenance.md` 寮哄埗锛氫笟鍔℃ā鍧�/娴佺▼/鐘舵��/瀵硅薄/瑙掕壊/AI 鍙樻洿鍚庨渶鍚屾缁存姢鏈洰褰曘�� - 澧為噺缁存姢锛氭敼瀵瑰簲鐨� `mermaid/*.mmd` + `data/*.json` 鈫� 杩愯涓婇潰鐨� sync 鑴氭湰 鈫� 娴忚鍣ㄩ獙璇佸彈褰卞搷鍥俱�� - 鍏ㄩ噺閲嶅仛锛堝亸宸繃澶ф椂锛夛細瀵� Claude 璇淬�岄噸鏂扮敓鎴愪笟鍔″叏鏅�嶏紝鎶�鑳戒細閲嶆柊璧拌婧愮爜骞舵寜鐢熸垚妯″紡閲嶅缓銆� -- 鐢熸垚鍩虹嚎锛歞ev_business @ 87bf4a99锛�2026-09-10锛�2026-09-28 澧為噺琛ュ厖璐㈠姟鎶ラ攢妯″潡锛坄yudao-module-finance`锛夈�佷細鍛樼鐞嗘ā鍧楋紙`yudao-module-ums`锛変笌璇鹃绠＄悊妯″潡锛坄yudao-module-research`锛屼竴鏈熼」 1~5锛涗簩鏈熺粨椤归獙鏀朵笌鎴愭灉褰掓。灏氭湭鍋氾紝鍥句腑宸叉爣娉ㄦ湭瑕嗙洊鑼冨洿锛夛紱**2026-09-29 澧為噺**锛氳棰樼粡璐规嫧浠樺鎺ヨ储鍔℃姤閿�鈥斺�旀柊寤� `yudao-module-finance-api`锛坄FinanceReimbursementApi` 鏈湴 Bean 璋冪敤锛氬缓鍗�+鎻愪氦/鏀瑰崟+閲嶆彁/鍒犻櫎/鏌ヨ锛夛紝鐧昏鎷ㄦ鏃� 1:1 鑷姩鐢熸垚 `finance_reimbursement`锛堢郴缁熺敓鎴� 1 琛屾槑缁嗭級骞惰嚜鍔ㄦ彁浜� `finance_reimbursement_approve` 涓ょ骇瀹℃壒锛屾柊澧炵 15 涓笟鍔＄洃鍚櫒 `ResearchFundStatusListener` 鎸夊鎵圭粨鏋滃洖鍐欒棰樻嫧娆惧彴璐︼紙閫氳繃 20 / 椹冲洖 30 / 鎾ゅ洖 0锛夛紝褰卞搷鍥� 08 / 09 / 10 / 14 涓� data 鍏ㄩ儴鍥涗唤 json銆� +- 鐢熸垚鍩虹嚎锛歞ev_business @ 87bf4a99锛�2026-09-10锛�2026-09-28 澧為噺琛ュ厖璐㈠姟鎶ラ攢妯″潡锛坄yudao-module-finance`锛夈�佷細鍛樼鐞嗘ā鍧楋紙`yudao-module-ums`锛変笌璇鹃绠＄悊妯″潡锛坄yudao-module-research`锛屼竴鏈熼」 1~5锛涗簩鏈熺粨椤归獙鏀朵笌鎴愭灉褰掓。灏氭湭鍋氾紝鍥句腑宸叉爣娉ㄦ湭瑕嗙洊鑼冨洿锛夛紱**2026-09-29 澧為噺**锛氳棰樼粡璐规嫧浠樺鎺ヨ储鍔℃姤閿�鈥斺�旀柊寤� `yudao-module-finance-api`锛坄FinanceReimbursementApi` 鏈湴 Bean 璋冪敤锛氬缓鍗�+鎻愪氦/鏀瑰崟+閲嶆彁/鍒犻櫎/鏌ヨ锛夛紝鐧昏鎷ㄦ鏃� 1:1 鑷姩鐢熸垚 `finance_reimbursement`锛堢郴缁熺敓鎴� 1 琛屾槑缁嗭級骞惰嚜鍔ㄦ彁浜� `finance_reimbursement_approve` 涓ょ骇瀹℃壒锛屾柊澧炵 15 涓笟鍔＄洃鍚櫒 `ResearchFundStatusListener` 鎸夊鎵圭粨鏋滃洖鍐欒棰樻嫧娆惧彴璐︼紙閫氳繃 20 / 椹冲洖 30 / 鎾ゅ洖 0锛夛紝褰卞搷鍥� 08 / 09 / 10 / 14 涓� data 鍏ㄩ儴鍥涗唤 json锛�**2026-09-29 鍐嶅閲�**锛氭柊澧炴。妗堢鐞嗙嫭绔嬫ā鍧� `yudao-module-archive` + `yudao-module-archive-api`锛坄ArchiveDocumentApi`锛歚archiveBySource` 骞傜瓑褰掓。 / `isArchived` / `getBySource`锛夛紝3 寮犺〃 `archive_category`/`archive_document`/`archive_borrow`銆�6 涓瓧鍏革紙82000~82005锛夈�乣bpm_category(8003)` + 鎵嬪啓 `archive_borrow_approve.bpmn`锛堝凡鍦� mom-jssm 閮ㄧ讲涓虹増鏈� 1锛宖orm_type=20锛屽垱寤鸿矾寰� `/archive/borrow/index`銆佹煡鐪嬭矾寰� `/archive/borrow/detail/approve/index.vue`锛夈�佽彍鍗� 1075600~1075699锛涙柊澧炰笟鍔＄洃鍚櫒 `ArchiveBorrowStatusListener`锛屽叏搴撲笟鍔＄姸鎬佺洃鍚櫒璁℃暟淇涓� **24 涓�** `*StatusListener`锛�14 涓户鎵� `BpmProcessInstanceStatusEventListener`锛夛紱涓夋柟褰掓。鍥炲啓 `archive_document_id` 鍒� `research_application`/`ums_member`/`finance_reimbursement`锛屽叏搴撹〃鏁� 427鈫�430锛涙柊澧炲浘 **15-archive-flow**锛屽閲忎慨璁㈠浘 01 / 08 / 09 / 10 涓� data 鍏ㄩ儴浜斾唤 json锛堟柊澧� `arc` 妯″潡銆�3 涓笟鍔″璞°�乣archive` 娴佺▼銆�4 涓笟鍔¤鑹诧級銆� ## 7. 宸茬煡寰呯‘璁や笟鍔� -瑙� `data/business.json` 鐨� `pendingConfirm`锛堥〉闈€�屽緟纭浜嬮」銆嶆爮锛夛紝瑕佺偣锛氫粨搴撶被鍨�/鍚堟牸浠撴敼閫犳湭钀藉湴銆丠RM 浜ゆ帴 expandUserIds 灏氭湭琚笟鍔℃煡璇㈡帴鍏ャ�佸洖娆句笌鏀舵鍗曟湭璧� BPM銆佽储鍔″嬀绋藉洖鍐欐柟娉曚负绌恒�丯CR 澶勭疆涓嶅洖鍐欐簮鍗曘�佽储鍔℃姤閿�鐨� BPM 娴佺▼瀹氫箟鏈彂甯冧笌鏅�氳鑹叉湭鎺堣彍鍗曘�佷細鍛樼鐞嗙殑 BPM 娴佺▼鏈彂甯冧笖缂哄鎵硅嚜瀹氫箟琛ㄥ崟椤点�佽嚜鍔ㄥ缓璐﹀彿鐢ㄦ墜鏈哄彿浣滃垵濮嬪瘑鐮佸瓨鍦ㄥ急鍙ｄ护椋庨櫓銆佽棰樼鐞嗙殑璇勫垎鏉冮噸涓庨�氳繃闃堝�间负鍗犱綅瑙勫垯寰呭浼氱‘璁ゃ�佽棰樼粡璐规嫧浠樿櫧宸插鎺ヨ储鍔℃姤閿�浣嗗彴璐︿笌鎶ラ攢鍗曚负杞叧鑱旓紙璐㈠姟渚у垹鍗曚細鐣欐偓绌� `reimbursement_id`锛夈�佹柊寤虹殑璐㈠姟鎶ラ攢瀹℃壒娴佺▼鑺傜偣瀹℃壒浜洪渶涓婄嚎鍓嶅湪 BPM 璁捐鍣ㄦ寜瀹為檯缁勭粐璋冩暣銆佺敵鎶ュ崟涓庝細鍛樹负杞叧鑱斿彲鑳芥偓绌虹瓑銆� +瑙� `data/business.json` 鐨� `pendingConfirm`锛堥〉闈€�屽緟纭浜嬮」銆嶆爮锛夛紝瑕佺偣锛氫粨搴撶被鍨�/鍚堟牸浠撴敼閫犳湭钀藉湴銆丠RM 浜ゆ帴 expandUserIds 灏氭湭琚笟鍔℃煡璇㈡帴鍏ャ�佸洖娆句笌鏀舵鍗曟湭璧� BPM銆佽储鍔″嬀绋藉洖鍐欐柟娉曚负绌恒�丯CR 澶勭疆涓嶅洖鍐欐簮鍗曘�佽储鍔℃姤閿�鐨� BPM 娴佺▼瀹氫箟鏈彂甯冧笌鏅�氳鑹叉湭鎺堣彍鍗曘�佷細鍛樼鐞嗙殑 BPM 娴佺▼鏈彂甯冧笖缂哄鎵硅嚜瀹氫箟琛ㄥ崟椤点�佽嚜鍔ㄥ缓璐﹀彿鐢ㄦ墜鏈哄彿浣滃垵濮嬪瘑鐮佸瓨鍦ㄥ急鍙ｄ护椋庨櫓銆佽棰樼鐞嗙殑璇勫垎鏉冮噸涓庨�氳繃闃堝�间负鍗犱綅瑙勫垯寰呭浼氱‘璁ゃ�佽棰樼粡璐规嫧浠樿櫧宸插鎺ヨ储鍔℃姤閿�浣嗗彴璐︿笌鎶ラ攢鍗曚负杞叧鑱旓紙璐㈠姟渚у垹鍗曚細鐣欐偓绌� `reimbursement_id`锛夈�佹柊寤虹殑璐㈠姟鎶ラ攢瀹℃壒娴佺▼鑺傜偣瀹℃壒浜洪渶涓婄嚎鍓嶅湪 BPM 璁捐鍣ㄦ寜瀹為檯缁勭粐璋冩暣銆佺敵鎶ュ崟涓庝細鍛樹负杞叧鑱斿彲鑳芥偓绌猴紱妗ｆ绠＄悊鐨� BPM 閮ㄧ讲浜х墿涓烘墜宸ュ鍑洪渶涓ュ畧銆屽厛閮ㄧ讲鍐嶅鍑哄啀鍚堝苟銆嶉『搴忋�佽彍鍗曚笌鏉冮檺浠呭湪鍚勫綊妗ｈ剼鏈腑鏅�氳鑹叉湭鎺堟潈銆佹。妗堜笌鏉ユ簮鍗曟嵁锛堣棰樼敵鎶ヤ功/浼氬憳/鎶ラ攢鍗曪級涓鸿蒋鍏宠仈鏉ユ簮鍒犲崟鍚庝細鐣欐偓绌哄揩鐓с�併�屾枃涔︽。妗堛�嶇瓑鏃犳潵婧愭ā鍧椾粎鎵嬪伐褰曞叆涓斿悎鍚屾。妗堟湭绾冲叆鑷姩褰掓。銆侀�炬湡浠呮煡璇㈡椂瀹炴椂璁＄畻涓嶅缓瀹氭椂浠诲姟涓嶅彂绔欏唴淇°�併�屽悓涓�妗ｆ浠呬竴鏉℃湭褰掕繕鍊熼槄鍗曘�嶇敱搴旂敤灞傛牎楠� + 鏉′欢鏇存柊鍏卞悓淇濊瘉銆佺粺璁′负 `GROUP BY` 鑱氬悎杩囦竾鍚庨渶鏀归�犮�佷笁鏂规潵婧愯〃鍚勫姞鍙┖鍒� `archive_document_id` 灞炶法妯″潡鏀硅〃闇�纭鍙樻洿绐楀彛绛夈�� -- Gitblit v1.9.3