接入与交付 / 实施与运维
部署、客户实施与运维
独立运行产品资料站，启动业务实例，并明确生产接入和备份要求。
运行与更新官网
npm run build:site
npm run dev:site产品资料站在 http://127.0.0.1:4174 独立预览，静态产物位于 website/dist。操作手册从 website/content/articles.mjs 生成，与网页和 Markdown 下载保持一致。更新后重新构建，不能把业务数据库或 .env 放入站点产物。
本站产品名称为当前通用描述名。正式品牌、企业主体、商务联系信息、域名及客户案例公开授权应在对外正式上线前确认。静态官网没有收集咨询信息，也没有连接业务数据库。
运行客户业务实例
npm ci
npm run dev该命令使用项目专用 Hardhat 18545 端口，必要时部署资产与 ERC-1056 DID 注册合约，随后启动 API 和 uni-app H5。新部署使用独立 deploymentId 和对应数据库；已有文件保留，但不能视作新链记录。
| 组件 | 当前实现 |
|---|---|
| 消费者端 | uni-app + Vue 3，H5，端口 5173 |
| API | Node.js + Express，端口 3000，单进程写操作协调 |
| 数据 | node:sqlite，.runtime 下的实例数据库 |
| 链 | 本地 Hardhat，受控 ERC-721 资产与 ERC-1056 DID |
| 官网 | 静态 HTML/CSS/JS，与业务实例独立 |
配置真实服务
- 将 .env.example 复制为本地 .env，真实值通过部署秘密配置维护。
- 阿里实名/短信：开通具体产品、场景、签名与模板，并验证 H5 完整流程。
- 票务：配置已批准的域名、合作身份和服务端私钥文件，按实际合同验证接口。
- 机构服务：登记身份、回调白名单、服务端密钥，完成业务及契约确认后启用。
- 正式支付/退款、分账和发票尚未实现渠道级接入，需要独立开发验收。
- 生产必须设置数据加密密钥并显式初始化管理员。当前 Hardhat 公开测试密钥不适用于生产资产。
NODE_ENV=production
DATA_KEY=<由运维安全注入的32字节十六进制值>
ADMIN_PHONE=<管理员手机号>
ADMIN_PASSWORD=<强密码，仅通过环境注入>
npm run bootstrap备份与恢复
- 同时保存对应的链状态、chain.json 部署信息、实例数据库、上传文件以及数据加密密钥。仅有数据库不能恢复链上归属和加密身份资料。
- 停止或协调业务写入后再制作一致性备份；密钥与备份文件按秘密信息保存，不提交代码库。
- 恢复到隔离环境，核对 deploymentId、合约地址、订单、资产编号和持有人，验证加密资料可读。
- 当前单进程 SQLite 模型不能直接多副本共享同一数据库文件；规模化、故障恢复目标和压力验收需要另行实施。
检查与发布验收
npm test
npm run test:chain
npm run test:browser
npm run build
npm run check:site业务、真实链和浏览器验证分别记录，不能相互替代。test:chain 与 test:browser 需要业务实例及本地链运行；浏览器测试会留下本地测试订单与票务记录。正式项目还需要真实支付、实名、票务、机构服务和运维验收。