117 lines
5.7 KiB
Markdown
117 lines
5.7 KiB
Markdown
# 开源软件改造交付包标准目录树
|
||
|
||
面向「开源项目改造 + 面板风格 UI + Docker 部署」外包交付的**标准交付包目录树模板**。
|
||
本仓库把交付要求固化为可直接导航的目录结构与节点说明，根 README 记录元数据并引用相关技能、合同规范与构建脚本。
|
||
|
||
## 元数据
|
||
|
||
| 项 | 值 |
|
||
| --- | --- |
|
||
| 名称 | panel-delivery-tree |
|
||
| 版本 | 1.0.0 |
|
||
| 标准依据 | 《开源软件改造部署外包服务合同》交付物与验收标准 |
|
||
| 创建日期 | 2026-10-10 |
|
||
| 维护组织 | depei |
|
||
| 机器可读元数据 | [`metadata.json`](./metadata.json) |
|
||
| 交付登记 | [`交付登记.md`](./交付登记.md) · [`registry.json`](./registry.json) |
|
||
| 正式交付包 | [`交付包/`](./交付包/) |
|
||
|
||
## 交付包与 Git 地址登记
|
||
|
||
本仓库同时承担**交付登记中心**职责：保存每个项目的正式交付压缩包，并登记其 Git 地址与锁定提交。
|
||
|
||
- 人类可读：[`交付登记.md`](./交付登记.md)
|
||
- 机器可读：[`registry.json`](./registry.json)
|
||
- 交付包存档：[`交付包/`](./交付包/)（zip + 交付清单 + sidecar 元数据，含 SHA256）
|
||
|
||
当前已登记：
|
||
|
||
| 项目 | 交付包 | Git | 提交 |
|
||
| --- | --- | --- | --- |
|
||
| 智慧停车综合管理平台 | [smart-parking-delivery-20261010.zip](./交付包/smart-parking-delivery-20261010.zip)（29.62 MB） | [depei/smart-parking-platform](https://code.xinmi.cloud/depei/smart-parking-platform) | `3c99299` |
|
||
|
||
## 引用的技能与规范
|
||
|
||
| 资源 | 链接 / 路径 | 用途 |
|
||
| --- | --- | --- |
|
||
| 执行技能仓库 | [depei/panel-project-deploy](https://code.xinmi.cloud/depei/panel-project-deploy) | 18 步初始化、面板 UI 改造、Docker 部署工作流 |
|
||
| 合同交付规范 | 技能内 `references/delivery-contract.md` | 7 项交付物、7 条验收标准、痕迹清理与合规 |
|
||
| 面板 UI 规范 | 技能内 `references/panel-ui.md` | 科技感玻璃面板风格与对比度/浮层约束 |
|
||
| 交付包构建脚本 | 技能内 `scripts/build_delivery_package.py` | 解析 README 配图并自动收拢、打包、校验 |
|
||
| 交付物核查脚本 | 技能内 `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/
|
||
│ └── screenshots/ # README 通过相对路径引用的配图（架构拓扑图/功能图）
|
||
├── 截图/
|
||
│ └── 界面截图/ # 改造后产品界面高清截图，按模块分组，全覆盖
|
||
│ ├── 首页/
|
||
│ ├── 园区态势/
|
||
│ ├── 监控大屏/
|
||
│ ├── 报警中心/
|
||
│ ├── AI对话/
|
||
│ ├── 系统管理/
|
||
│ └── 登录页/
|
||
├── 录屏/ # 全功能操作演示录屏 full-feature-demo.mp4
|
||
├── 文档/
|
||
│ ├── 环境依赖清单.md
|
||
│ └── 部署注意事项.md
|
||
├── docker/ # Docker 一键部署脚本/部署包（compose / Dockerfile 示例）
|
||
└── 网盘归档/
|
||
└── 归档清单.md # 百度网盘链接、提取码、有效期、目录结构
|
||
```
|
||
|
||
> 各节点目录内都有一份说明 `README.md`（交付时可删除或保留），描述该节点的内容与要求；
|
||
> 二进制产物（zip/mp4/ts/m3u8）已通过 [.gitignore](./.gitignore) 排除，本仓库只承载结构与规范。
|
||
|
||
## 七项交付物对照
|
||
|
||
1. 可稳定运行的完整项目源码 —— 已以 **git submodule** 挂载于 `项目源码/smart-parking-platform`（见上表）
|
||
2. 改造前后高清界面对比截图 —— `截图/界面截图/`（全覆盖）
|
||
3. 全功能操作演示录屏 —— `录屏/full-feature-demo.mp4`
|
||
4. 网盘素材归档链接 —— `网盘归档/归档清单.md`
|
||
5. 标准化完整版 README —— 包根 `README.md`
|
||
6. Docker 一键部署脚本 —— `docker/`
|
||
7. 环境依赖清单 + 部署注意事项 —— `文档/`
|
||
|
||
## 如何用于一个真实项目
|
||
|
||
```bash
|
||
# 1. 在目标项目内用技能工作流完成改造、部署与面板 UI 审计（0 violations）
|
||
# 2. 用技能脚本构建真实交付包（README 配图会自动收拢、打包后自动校验）
|
||
python scripts/build_delivery_package.py \
|
||
--project-dir <项目目录> \
|
||
--readme README.md \
|
||
--out-dir .Codex/delivery
|
||
|
||
# 3. 交付前执行阻断式核查
|
||
python scripts/deliverables_check.py --project-dir <项目目录>
|
||
```
|
||
|
||
## 规范要点（合同对齐）
|
||
|
||
- README 必备 12 项：简介、功能（逐条配图）、痛点、技术优势、场景、目标人群、商业价值、
|
||
技术架构（含拓扑图）、环境依赖、快速开始、完整部署教程（优先 Docker 一键）、开源协议合规说明。
|
||
- 痕迹清理：清除第三方公司名/LOGO/水印/联系方式，但**保留 LICENSE 与法定版权声明**。
|
||
- 截图/录屏须清晰、完整、可溯源；录屏无卡顿、无黑屏、覆盖全功能。
|
||
- Docker 一键部署无故障；不支持 Docker 的手动步骤须 100% 可复现。
|