标准应用首次安装、启动与升级
准备和包校验
取得同一发行号的标准源码 ZIP、SDK wheel/sdist、文档包及包外 SHA256.json。用 PowerShell Get-FileHash -Algorithm SHA256 对照清单;摘要不符停止,不混用不同候选的文件。解压到新目录(允许空格),例如 C:\Apps\New Demo,不要覆盖现有 A/B。包中没有账号、数据库或真实应用密钥。
安装环境:Windows x64、Python3.12 x64、ODBC Driver18、可连接的 SQL Server。准备一个本应用专用空库或尚不存在的新库名,Windows 身份需有建库权限(已有空库需 CONTROL)。平台库不能作为应用库。确认空闲端口与独立文件目录。应用文件目录不是 SQL mdf/ldf 目录。
在解压目录运行下列入口,替换尖括号内参数;所有密码由无回显输入提供,不能写命令行:
.\scripts\Install-Local.ps1 -PythonExe '<Python3.12完整路径>'
.\.venv\Scripts\python.exe -m wsea.install_cli --mode plan --server '<SQL实例>' --database '<应用新库>' --authentication windows --trust-server-certificate
.\.venv\Scripts\python.exe -m wsea.install_cli --mode install --server '<SQL实例>' --database '<应用新库>' --authentication windows --trust-server-certificate --storage '<应用文件目录>' --port 18320 --skip-platform
plan 只盘点,记下 action/目标/confirmation_digest;安装时核对完整库名和摘要再确认。自签开发 SQL 可用 trust-server-certificate;正式环境应配可信证书并不加该参数。SQL 认证时使用 --authentication sql --username,密码提示输入。已有非空库、已有 settings.enc、占用端口或身份不明均拒绝,不自动清库、删文件或停服务。
安装显式创建当前15表/schema历史1,2,3;重复 verify/migrate 不清数据。应用启动不执行 DDL。配置默认 .local/settings.enc,独立加密密钥 .local/.keys/configuration.key。这是软件加密,不是 Windows 账户密码;遗失密钥无法解密配置。把配置、密钥和备份分别受控保管,不打进分发包。
平台准备与绑定
- 在 New 首页自主注册企业并登录企业管理员(不是 root 代建)。应用中心创建本应用,下载连接资料。管理员的登录密码不是应用凭据。
- 在人员管理创建员工并安全交付员工密码;员工不能登录平台后台。
- 在当前应用配置应用权限和角色,至少为安装操作员工配置 runtime.access、settings.manage、directory.view/sync、业务所需权限。完整代码见 使用手册。不能只在本地数据库插入授权。
- 首次绑定:
.\.venv\Scripts\python.exe -m wsea.install_cli --mode platform --platform-url '<New HTTPS地址或回环HTTP>' --client-id '<app_id>' --expected-application-id '<同一app_id>'
.\scripts\Start-Local.ps1 -Port 18320
输入下载资料中的应用凭据。绑定实际换 Token 并读 /me 确认企业应用。失败原有效配置保持;首次绑定成功后不能再用首次入口覆盖身份。后续同身份改密在员工系统设置中“测试→验证→启用”,不同企业/应用迁移不在本发行范围。
通知接入与首次同步
- 部署管理员保证平台能访问应用
/api/platform/notifications(公网平台不能直接访问另一台机器的127.0.0.1)。HTTPS代理或已批准通道由环境维护者提供;本包不会自动开防火墙。
- 企业管理员在平台应用中心“消息接收设置”保存这个应用专属地址,下载消息接收凭据到本机受保护文件。
- 应用停机维护时导入:
.\.venv\Scripts\python.exe -m wsea.cli configure-notifications --credentials-file '<接收凭据JSON>' --instance-id '<唯一稳定实例名>' --poll-seconds 10
文件必须属于已绑定企业应用,导入后正常重启应用。导入不会代替平台配置接收地址,A/B不能串用。保留原凭据文件在受保护位置,不加源码版本库。
4. 用获权员工登录;目录同步执行全量,再增量;审批模板同步下载已发布投影。检查消息页中“收到/下载/SQL/回执”四阶段。只有测试通知不能证明业务更新链成功。
停止、重启、升级与回退
前台启动可 Ctrl+C;后台服务用自己的服务管理器正常停止。只管理确认属于当前目录/端口的进程。重启沿用同一受保护配置、密钥、SQL和文件目录;不要重新 init、注册企业或复制他人配置。运行入口同时支持 -ConfigFile/-KeyFile(见脚本参数)。
升级前停止本实例写入,备份应用 SQL、文件树、配置、密钥、旧源码与依赖,记录 schema。新源码解压新目录,保留外部受保护配置路径;wsea.install_cli --mode upgrade 会核验安装归属、备份目录和版本,再显式前向迁移。已有库缺少 wsea 安装标识需人工审查,不能假称属于本安装。发生错误保留 installation-history 和请求编号。
回退代码需要确认数据库兼容;新迁移不可简单覆盖旧程序。恢复 SQL 与文件/配置需同一已核验备份集和维护授权,禁止删除库重来。SDK降级也须与源码锁版本一起回退。软件包校验不是异机灾备演练。