diff --git a/.gitignore b/.gitignore index 8669884..c6a4806 100644 --- a/.gitignore +++ b/.gitignore @@ -1,7 +1,9 @@ -# 真实交付产物（二进制/大文件）不入库，仅保留目录树模板与说明 -*.zip +# 构建中间产物不入库 *.mp4 *.ts *.m3u8 -交付包实际产物/ -!**/.gitkeep +# 默认忽略压缩包，但放行正式交付目录中的交付包 +*.zip +!交付包/ +!交付包/**/ +!交付包/**/*.zip diff --git a/README.md b/README.md index 2a1f397..b91263a 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,22 @@ | 创建日期 | 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` | ## 引用的技能与规范 diff --git a/metadata.json b/metadata.json index d2457bd..7cdae71 100644 --- a/metadata.json +++ b/metadata.json @@ -33,5 +33,10 @@ "commit": "3c9929938166d0ce6533afc4c1b3446225953d65", "shallow": true } - ] + ], + "deliveriesIndex": { + "markdown": "交付登记.md", + "json": "registry.json", + "packagesDir": "交付包" + } } \ No newline at end of file diff --git a/registry.json b/registry.json new file mode 100644 index 0000000..d0ac24a --- /dev/null +++ b/registry.json @@ -0,0 +1,28 @@ +{ + "updatedAt": "2026-10-13", + "deliveries": [ + { + "project": "智慧停车综合管理平台", + "projectKey": "smart-parking-platform", + "deliveryDate": "2026-10-10", + "package": "交付包/smart-parking-delivery-20261010.zip", + "packageSizeMB": 29.62, + "sha256": "d56fd66ea69d41628b9092003a7db50c4275596c7f50dc57a08f8598ed83eda1", + "git": { + "primary": "https://code.xinmi.cloud/depei/smart-parking-platform.git", + "web": "https://code.xinmi.cloud/depei/smart-parking-platform", + "upstream": "https://www.gitcc.com/parking/project0716gvv9170809.git", + "submodulePath": "项目源码/smart-parking-platform", + "pinnedCommit": "3c9929938166d0ce6533afc4c1b3446225953d65", + "branch": "main" + }, + "deploy": { + "method": "docker-compose", + "verifyUrl": "http://localhost:4010/", + "status": "healthy" + }, + "manifest": "交付包/smart-parking-交付清单.md", + "sidecar": "交付包/smart-parking-delivery-20261010.json" + } + ] +} \ No newline at end of file diff --git a/交付包/README.md b/交付包/README.md new file mode 100644 index 0000000..94908cd --- /dev/null +++ b/交付包/README.md @@ -0,0 +1,15 @@ +# 交付包存档 + +本目录保存各项目的**正式交付压缩包**及对应清单、校验元数据（sidecar JSON）。 +交付登记总索引见根目录 [`交付登记.md`](../交付登记.md) 与 [`registry.json`](../registry.json)。 + +## 文件 + +| 文件 | 说明 | +| --- | --- | +| `smart-parking-delivery-20261010.zip` | 智慧停车综合管理平台正式交付包（约 29.62 MB） | +| `smart-parking-交付清单.md` | 交付物对照、素材明细、默认账号、验收记录 | +| `smart-parking-delivery-20261010.json` | 机器可读元数据：Git 地址、锁定提交、SHA256、部署信息 | + +> 校验：`Get-FileHash smart-parking-delivery-20261010.zip -Algorithm SHA256` +> 应等于 `d56fd66ea69d41628b9092003a7db50c4275596c7f50dc57a08f8598ed83eda1`。 diff --git a/交付包/smart-parking-delivery-20261010.json b/交付包/smart-parking-delivery-20261010.json new file mode 100644 index 0000000..b74f536 --- /dev/null +++ b/交付包/smart-parking-delivery-20261010.json @@ -0,0 +1,30 @@ +{ + "project": "智慧停车综合管理平台", + "projectKey": "smart-parking-platform", + "deliveryDate": "2026-10-10", + "package": "交付包/smart-parking-delivery-20261010.zip", + "packageSizeBytes": 31061895, + "sha256": "d56fd66ea69d41628b9092003a7db50c4275596c7f50dc57a08f8598ed83eda1", + "git": { + "primary": "https://code.xinmi.cloud/depei/smart-parking-platform.git", + "web": "https://code.xinmi.cloud/depei/smart-parking-platform", + "upstream": "https://www.gitcc.com/parking/project0716gvv9170809.git", + "submodulePath": "项目源码/smart-parking-platform", + "pinnedCommit": "3c9929938166d0ce6533afc4c1b3446225953d65", + "branch": "main" + }, + "deploy": { + "method": "docker-compose", + "verifyUrl": "http://localhost:4010/", + "status": "healthy" + }, + "manifest": "交付包/smart-parking-交付清单.md", + "contains": [ + "README(12项)", + "界面截图x12", + "全功能录屏 full-feature-demo.mp4", + "环境依赖清单", + "部署注意事项", + "Docker部署" + ] +} \ No newline at end of file diff --git a/交付包/smart-parking-delivery-20261010.zip b/交付包/smart-parking-delivery-20261010.zip new file mode 100644 index 0000000..fed80c4 Binary files /dev/null and b/交付包/smart-parking-delivery-20261010.zip differ diff --git a/交付包/smart-parking-交付清单.md b/交付包/smart-parking-交付清单.md new file mode 100644 index 0000000..8da3bab --- /dev/null +++ b/交付包/smart-parking-交付清单.md @@ -0,0 +1,73 @@ +# 交付清单 + +- 项目名称：智慧停车综合管理平台（Smart Parking Platform） +- 交付日期：2026-10-10 +- 部署方式：Docker Compose 私有化部署 +- 在线验证：http://localhost:4010/（应用容器状态 healthy） + +## 一、交付物对照 + +| # | 交付物 | 包内路径/说明 | 状态 | +|---:|---|---|---| +| 1 | 可稳定运行的完整项目源码 | 源码目录单独交付（`frontend/`、`backend/`、`ai-end/`、`docker-compose.yml`） | ✅ | +| 2 | 当前产品全页面高清界面截图 | `截图/界面截图/`；README 配图位于 `docs/screenshots/` | ✅ | +| 3 | 全功能操作演示录屏 | `录屏/full-feature-demo.mp4` | ✅ | +| 4 | 素材归档分享链接（长期有效） | 上传约定网盘后在本清单回填 | ⏳ 待回填 | +| 5 | 完整版 README（含架构说明、部署教程、场景说明） | 交付包根目录 `README.md` | ✅ | +| 6 | Docker 一键部署脚本/部署包 | `docker-compose.yml`、`.env.example`、`front-backend.Dockerfile` | ✅ | +| 7 | 环境依赖清单、部署注意事项 | `文档/环境依赖清单.md`、`文档/部署注意事项.md` | ✅ | + +## 二、素材明细 + +### 界面截图（共 12 张） + +`截图/界面截图/`： + +- `login.png`：登录页 +- `overview.png`：概览大屏 +- `campus-state.png`：园区态势 +- `monitoring-screen.png`：视频监控大屏 +- `alarms.png`：报警事件 +- `ai-chat.png`：AI 对话 +- `ai-settings.png`：AI 接口配置教程 +- `user-info.png`：个人中心 +- `map-management.png`：园区地图管理 +- `camera-management.png`：摄像头管理 +- `alarm-rule-management.png`：报警规则管理 +- `user-management.png`：用户管理 + +### 演示视频 + +- `录屏/full-feature-demo.mp4`：1600×900，H.264，时长约 75.84 秒。 +- 演示流程：登录 → 概览大屏 → 园区态势 → 视频监控 → 报警事件 → AI 对话/接口配置 → 个人中心 → 系统管理。 +- 视频监控段已按“打开页面后静置不少于 10 秒、逐路校验、离开前末帧确认”的流程复核；可见 6 路 HLS 均为真实动态画面，不是空白占位画面。 + +## 三、素材归档 + +交付包已按「截图 / 录屏 / 文档」分类整理。上传至约定网盘后，请在此回填长期有效链接： + +- 分享链接：`<上传后回填>` +- 提取码：`<如需提取码则回填>` + +## 四、默认账号 + +系统初始化后提供以下默认账号，首次上线前请及时修改： + +| 角色 | 账号 | 密码 | +| --- | --- | --- | +| 管理员 | `admin` | `admin123` | +| 操作员 | `operator` | `123456` | + +## 五、验收记录 + +- 部署验证：MySQL、应用容器均为 healthy；Web 服务可正常访问。 +- 面板 UI 审计：覆盖核心路由，结果为 0 violations。 +- 全功能走查：登录、概览大屏、园区态势、视频监控、报警、AI 对话、个人中心和系统管理操作正常。 +- README 配图：12 张图片均等待页面 loading 消失、核心内容渲染完成并稳定后重新截取，引用路径完整，解压后可正常显示。 +- 视频核验：监控页可见 6 路 HLS 瓦片均通过帧尺寸、播放状态、时间推进、画面能量校验；输出截图已直接读取 PNG 逐路复核，录屏监控段 22s/25s/28s 抽帧均正常。 + +## 六、售后说明 + +- 基础质保范围、响应时限和质保期以合同正文为准。 +- 一般包括功能缺陷、部署问题、文档答疑、使用指导和基础技术咨询。 +- 新增功能、深度定制或第三方平台策略变更，可另行协商。 diff --git a/交付登记.md b/交付登记.md new file mode 100644 index 0000000..7f9c4ca --- /dev/null +++ b/交付登记.md @@ -0,0 +1,27 @@ +# 交付登记 + +记录每个已交付项目的**交付包位置**与 **Git 地址 / 版本提交**。机器可读版见 [`registry.json`](./registry.json)。 + +## 登记总表 + +| 项目 | 交付日期 | 交付包 | Git 仓库 | 锁定提交 | 部署校验 | +| --- | --- | --- | --- | --- | --- | +| 智慧停车综合管理平台 | 2026-10-10 | [`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` | docker-compose · http://localhost:4010/ · healthy | + +## 智慧停车综合管理平台 + +- 交付包：[`交付包/smart-parking-delivery-20261010.zip`](./交付包/smart-parking-delivery-20261010.zip) +- SHA256：`d56fd66ea69d41628b9092003a7db50c4275596c7f50dc57a08f8598ed83eda1` +- 交付清单：[`交付包/smart-parking-交付清单.md`](./交付包/smart-parking-交付清单.md) +- 主 Git 地址：（分支 `main`） +- 上游来源： +- 本仓库内源码：子模块 [`项目源码/smart-parking-platform`](./项目源码/smart-parking-platform)（固定在 `3c99299`） +- 部署方式：Docker Compose 一键部署；在线验证 http://localhost:4010/ ，容器 healthy +- 内容：标准化 README（12 项）、12 张界面截图、全功能录屏、环境依赖清单、部署注意事项、Docker 部署脚本 + +## 新增交付项目时 + +1. 把正式交付 zip 放入 `交付包/`，命名 `-delivery-.zip`； +2. 同目录放置交付清单与 `.json` 元数据（Git 地址、提交、SHA256、部署信息）； +3. 在本文件登记总表追加一行，并在 `registry.json` 的 `deliveries` 数组追加一项； +4. 源码以子模块挂到 `项目源码/` 并固定提交。