纳入正式交付包：smart-parking-delivery-20261010.zip，新增交付登记（Git地址/锁定提交/SHA256）

2026-10-13 13:41:16 +08:00
parent fae735af97
commit 85219b8ee3
9 changed files with 201 additions and 5 deletions
@@ -1,7 +1,9 @@
-# 真实交付产物（二进制/大文件）不入库，仅保留目录树模板与说明
-*.zip
+# 构建中间产物不入库
 *.mp4
 *.ts
 *.m3u8
-交付包实际产物/
-!**/.gitkeep
+# 默认忽略压缩包，但放行正式交付目录中的交付包
+*.zip
+!交付包/
+!交付包/**/
+!交付包/**/*.zip
@@ -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` |

 ## 引用的技能与规范

@@ -33,5 +33,10 @@
      "commit": "3c9929938166d0ce6533afc4c1b3446225953d65",
      "shallow": true
    }
-  ]
+  ],
+  "deliveriesIndex": {
+    "markdown": "交付登记.md",
+    "json": "registry.json",
+    "packagesDir": "交付包"
+  }
 }
@@ -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"
+    }
+  ]
+}
@@ -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`。
@@ -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部署"
+  ]
+}
@@ -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 抽帧均正常。
+
+## 六、售后说明
+
+- 基础质保范围、响应时限和质保期以合同正文为准。
+- 一般包括功能缺陷、部署问题、文档答疑、使用指导和基础技术咨询。
+- 新增功能、深度定制或第三方平台策略变更，可另行协商。
@@ -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 地址：<https://code.xinmi.cloud/depei/smart-parking-platform>（分支 `main`）
+- 上游来源：<https://www.gitcc.com/parking/project0716gvv9170809.git>
+- 本仓库内源码：子模块 [`项目源码/smart-parking-platform`](./项目源码/smart-parking-platform)（固定在 `3c99299`）
+- 部署方式：Docker Compose 一键部署；在线验证 http://localhost:4010/ ，容器 healthy
+- 内容：标准化 README（12 项）、12 张界面截图、全功能录屏、环境依赖清单、部署注意事项、Docker 部署脚本
+
+## 新增交付项目时
+
+1. 把正式交付 zip 放入 `交付包/`，命名 `<key>-delivery-<YYYYMMDD>.zip`；
+2. 同目录放置交付清单与 `<zip>.json` 元数据（Git 地址、提交、SHA256、部署信息）；
+3. 在本文件登记总表追加一行，并在 `registry.json` 的 `deliveries` 数组追加一项；
+4. 源码以子模块挂到 `项目源码/<key>` 并固定提交。