1.9 KiB
统一门户适配（2026-09-22）
分支 feature/portal-integration，基于 main 6eccbe9。代码完成但尚未替换外网测试实例；部署方向等待用户决定。
PORTAL_SSO_ENABLED=1 开启门户模式；必须配置独立的 PORTAL_SSO_SECRET、PORTAL_INTERNAL_URL、PORTAL_PUBLIC_URL。若使用 HTTPS，部署时还需相应安全 Cookie 配置。门户配置 FINANCE_SSO_ENABLED、FINANCE_SSO_SECRET、FINANCE_SSO_CALLBACK_URL，回调固定为 /portal-sso。
员工在门户中绑定已有财务用户的数字 ID；本地角色及 company_id 继续决定业务权限，不读取门户 admin 作为业务角色。每名员工应有独立本地账号，同一公司可有多名员工；不将多人映射到共享公司登录身份。账户停用及财务本地停用均拒绝访问。门户模式不允许原生登录、登出、改密、创建凭证或重置密码；管理员/出纳页面仍分开。
初始化会增量创建 portal_identity、portal_sessions 两表，不改银行流水、业务计算或原会话表。已有银行数据迁移不包含在本次工作中。全新实例须先配置测试公司和测试业务身份，再绑定门户员工；不会默认生成管理员密码。
候选内网部署 overlay 为 deploy/portal-integration.compose.yml，应叠加现有门户/OA融合 Compose，使用独立 FINANCE_DATA 目录并赋予容器用户 10001 写权限。健康检查使用 /healthz，原主页在门户模式跳回门户。FINANCE_IMAGE 应为已准备好依赖的 Python 3.12 财务镜像，代码目录通过 FINANCE_SOURCE 只读挂载。不得把候选测试实例数据路径指向现有正式或独立测试库。
验证命令：PYTHONPATH=src python -m unittest discover -s tests。本轮 395 项：391 通过、4 跳过，其中新增 6 项 SSO 回调/权限/隔离测试。外网到内网门户目前不可达，实际财务跨系统端到端部署验收待完成。