# ZIP部署与维护

版本：IB-1.1。部署包为已构建的纯静态站，不需要Node、Java、Python、数据库或在线CDN。正文使用UTF-8中文，所有服务器目录、文件名和引用路径只含ASCII。

## 宝塔或Nginx部署

1. 新建站点目录，绑定你选择的新域名。旧域名不作为本包依赖。
2. 上传ZIP，将包内全部内容解压到站点目录。站点根应直接出现index.html，不要遗漏assets、docs、ui、downloads、database等目录。
3. 默认首页设为index.html，以静态文件方式提供；不需要SPA history重写。
4. 域名根目录部署时访问域名首页；子目录部署时访问该子目录的index.html。链接均为相对路径，同一包兼容两种方式。
5. 检查首页、全文、数据字典、玩家登录画板、长牌画板、后台样稿、流程图和CSV下载；对照release.json确认版本IB-1.1。

## Nginx位置配置示例

以下为站点server块中的配置片段，需要把root替换为实际解压目录。域名、证书由服务器现有站点配置负责；示例尚未在你的服务器执行。

```nginx
root /var/www/storm-baseline;
index index.html;
charset utf-8;
location / {
    try_files $uri $uri/ =404;
}
location = /index.html {
    add_header Cache-Control "no-cache";
}
location = /release.json {
    add_header Cache-Control "no-cache";
}
```

子目录部署直接保留目录结构并由父站点静态服务提供，不将所有请求改写到首页。更新时建议新目录完整解压后切换站点根，避免混用旧资源。

## 完整性和内容

外部SHA256文件校验ZIP；manifest.json记录每个站点文件的大小和SHA256（清单自身除外）。readme.txt提供简要说明，llms.txt和llms-full.txt供AI读取。downloads/master-baseline.md是合并阅读稿，downloads/source/保存可编辑的分篇源稿和表格，build脚本可在维护目录重建。

## 访问地址

本次只交付ZIP，由你自行绑定新域名和部署，因此不提供虚构的在线地址。部署后使用你的域名首页或子目录index.html；站点不写死任何业务域名。

## 更新和权限

修改对应源稿并记录变更影响，重新构建、验证、打包，再发布整个新版本。本包无业务凭据、玩家数据、数据库转储或真实日志。静态站不自带登录，若需要限制查阅，应在服务器或网关保护整个目录及下载资源。


## 2026-10-27 设计评审更新包

本次文件名为 `storm-poker-implementation-baseline-ib-1.1-review-20261027.zip`。解压后 `index.html` 直接位于站点根目录，无额外外层文件夹。首页主按钮进入本轮设计评审 `ui/review/index.html?screen=redo-review`，原实施基线文档、数据库和玩家／后台原型完整保留。支持站点根目录与任意子目录部署。

静态托管即可，无需安装 Node、Python 或数据库。Nginx 使用包内 `nginx.conf.example` 并按实际目录调整 root。配置 UTF-8，尤其为 Markdown 返回 `text/plain; charset=utf-8`；修改记录同时提供带 UTF-8 声明的 HTML 阅读页。上传全部文件后刷新浏览器缓存，切勿只覆盖 index.html。已有站点请先备份，再将新包完整解压到新目录并切换站点目录。

包内 maintenance 为本地维护与校验脚本，公开评审站可按包内 Nginx 示例限制访问；业务验收及 PostgreSQL 运行验收不包含在此静态部署检查中。
