diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..c9fe31a --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "项目源码/smart-parking-platform"] + path = 项目源码/smart-parking-platform + url = https://code.xinmi.cloud/depei/smart-parking-platform.git diff --git a/README.md b/README.md index e1cd445..2a1f397 100644 --- a/README.md +++ b/README.md @@ -25,9 +25,23 @@ | 交付物核查脚本 | 技能内 `scripts/deliverables_check.py` | 交付前阻断式核查(7 项交付物齐全性) | | 面板 UI 审计脚本 | 技能内 `scripts/panel_ui_audit.py` | 阻断式视觉审计(0 violations 才放行) | +## 项目源码子模块 + +真实交付项目以子模块方式纳入(交付物第 1 项): + +- 平台:[depei/smart-parking-platform](https://code.xinmi.cloud/depei/smart-parking-platform) +- 挂载路径:`项目源码/smart-parking-platform` +- 当前锁定提交:`3c99299` +- 克隆请加 `--recurse-submodules`,详见 [`项目源码/README.md`](./项目源码/README.md) + ## 标准交付包目录树 ```text +# 交付包根(含项目源码子模块) +项目源码/ +└── smart-parking-platform/ # git submodule → depei/smart-parking-platform @ 3c99299 + +# 交付物资产树 交付包模板/ ├── README.md # 包根唯一一份:标准化商用 README(12 项必备内容) ├── docs/ @@ -55,7 +69,7 @@ ## 七项交付物对照 -1. 可稳定运行的完整项目源码 —— 随项目仓库交付(不在本模板内) +1. 可稳定运行的完整项目源码 —— 已以 **git submodule** 挂载于 `项目源码/smart-parking-platform`(见上表) 2. 改造前后高清界面对比截图 —— `截图/界面截图/`(全覆盖) 3. 全功能操作演示录屏 —— `录屏/full-feature-demo.mp4` 4. 网盘素材归档链接 —— `网盘归档/归档清单.md` diff --git a/metadata.json b/metadata.json index 5f913fa..d2457bd 100644 --- a/metadata.json +++ b/metadata.json @@ -23,5 +23,15 @@ "环境依赖清单与部署注意事项" ], "acceptance_criteria_count": 7, - "tree_root": "交付包模板" + "tree_root": "交付包模板", + "submodules": [ + { + "name": "smart-parking-platform", + "title": "智慧停车综合管理平台", + "path": "项目源码/smart-parking-platform", + "url": "https://code.xinmi.cloud/depei/smart-parking-platform", + "commit": "3c9929938166d0ce6533afc4c1b3446225953d65", + "shallow": true + } + ] } \ No newline at end of file diff --git a/项目源码/README.md b/项目源码/README.md new file mode 100644 index 0000000..324fde8 --- /dev/null +++ b/项目源码/README.md @@ -0,0 +1,35 @@ +# 项目源码(交付物第 1 项) + +本目录以 **Git 子模块(submodule)** 挂载真实交付项目,保持交付树轻量的同时, +把「可稳定运行的完整项目源码」作为版本化引用纳入本交付包。 + +## 子模块清单 + +| 项目 | 路径 | 远程仓库 | 锁定提交 | +| --- | --- | --- | --- | +| 智慧停车综合管理平台 | `smart-parking-platform` | | `3c99299` | + +## 克隆方式 + +```bash +# 递归克隆(自动拉取子模块,浅克隆节省空间) +git clone --recurse-submodules --depth 1 <交付树仓库地址> + +# 若已普通克隆,补拉子模块: +git submodule update --init --recursive --depth 1 +``` + +## 子模块更新 + +当上游项目发布新版本并需要在交付树中固定时: + +```bash +cd 项目源码/smart-parking-platform +git fetch origin && git checkout <新提交> +cd ../.. +git add 项目源码/smart-parking-platform +git commit -m "升级子模块:smart-parking-platform 到 <新提交>" +``` + +> 子模块只记录「提交指针」,不复制源码内容;具体源码、Docker 部署、面板 UI 改造 +> 均在子模块仓库内维护。 diff --git a/项目源码/smart-parking-platform b/项目源码/smart-parking-platform new file mode 160000 index 0000000..3c99299 --- /dev/null +++ b/项目源码/smart-parking-platform @@ -0,0 +1 @@ +Subproject commit 3c9929938166d0ce6533afc4c1b3446225953d65