系统运行环境及系统配置说明

当前时间： 2026-08-11 04:11:47 分类：办公文件评论(0)

系统运行环境及系统配置说明

文末有惊喜

经过最早发布的合同管理系统开始，到目前发布的证照管理系统，很多便宜都在询问，我发布的系统的运行环境是怎么样的，今天在此就统一回复下。以下内容涉及到准备发布的统一管理平台的内容，就不再单独分割发布了。

1、系统运行环境

Python 环境

项目	值
解释器路径	`C:\Users\Administrator\AppData\Local\Programs\Python\Python314\python.exe`
版本	Python 3.14.3

各系统 requirements（显式依赖）

系统	依赖
Portal	`flask>=3.0.0` , `flask-cors>=4.0.0`, `werkzeug>=3.0.0`
合同管理	`flask==3.0.0` , `flask-cors==4.0.0`, `openpyxl>=3.1.0`
项目管理	`Flask>=3.0.0` , `werkzeug>=3.0.0`
证照管理	`Flask>=3.0.0` , `werkzeug>=3.0.0`, `openpyxl>=3.1.0`, `APScheduler>=3.10.0`

实际运行时 Import（差异分析）

包	Portal	合同	项目	证照	说明
flask	✅	✅	✅	✅	Web 框架
werkzeug	✅	✅	✅	✅	Flask 底层
flask-cors	✅ req	✅ req	✗	✗	跨域支持
openpyxl	✗	✅ req	✗	✅ req	Excel 读写
APScheduler	✗	✗	✗	✅ req	定时任务
sqlite3	✅	✅	✅	✅	标准库，无需安装
hashlib	✅	✅	✅	✅	标准库，SSO 签名
threading	✅	✅	✅	✅	标准库
collections	✅	✅	✅	✅	标准库
concurrent.futures	✅	✗	✗	✗	Portal SSO 线程池
urllib	✅	✗	✗	✗	Portal SSO 请求

✅ = 代码中 import, ✅ req = 在 requirements.txt 中

2、系统配置

四个系统环境配置清单

2.1. 端口 & Cookie

系统	端口	Cookie 名	工作目录
Portal 门户	`5000`	`portal_session`	`portal\`
合同管理	`5001`	`contract_session`	`合同管理系统\`
项目管理	`5002`	`project_session`	`项目管理系统\`
证照管理	`5003`	`license_session`	`证照管理系统\`

2.2. 密钥（`run_all.py` 注入值）

环境变量	值	用途
`SSO_SECRET`	`EnterprisePlatformSSOSecretKey2026`	四系统共享，签名 SSO token
`PORTAL_SECRET_KEY`	`PortalFlaskSecretKey2026`	Portal session 签名
`CONTRACT_SECRET_KEY`	`ContractFlaskSecretKey2026`	合同系统 session 签名
`PROJECT_SECRET_KEY`	`ProjectFlaskSecretKey2026`	项目系统 session 签名
`LICENSE_SECRET_KEY`	`LicenseFlaskSecretKey2026`	证照系统 session 签名

未设置环境变量时，各系统会自动回退到 secrets.token_hex(32) 随机密钥（重启后所有 session 失效）。

2.3. Session 配置（所有系统一致）

配置	值
`PERMANENT_SESSION_LIFETIME`	7 天
`SESSION_COOKIE_HTTPONLY`	`True`
`SESSION_COOKIE_SECURE`	`False` （本地开发）
`SESSION_COOKIE_SAMESITE`	`Lax`

2.4. 数据库

系统	数据库文件	路径
Portal	`contract_management.db`	`合同管理系统\` （复用）
合同	`contract_management.db`	`合同管理系统\`
项目	`contract_management.db` + `project_data.db`	共享合同库 + 自有库
证照	license_manager.db	`证照管理系统\`

2.5. 其他配置

系统	配置项	值
合同	上传大小限制	100 MB
合同	允许文件类型	`txt, pdf, doc, docx, xls, xlsx, csv, png, jpg, jpeg, gif, zip, rar`
合同	CORS 允许来源	`localhost:5000, 5001, 5002`
Portal	SSO 线程池	`ThreadPoolExecutor(max_workers=2)`
证照	使用 `app.secret_key =` 而非 `app.config['SECRET_KEY']`	两写法等效，但风格不一致

2、系统如何启动的

各个系统文件目录里面都有一个run.bat文件，点击即可启动

每个bat文件内都加入了环境检测命令，自动检查当前电脑的运行环境是否满足需要，如果缺失会提示下载和安装对应文件。

针对统一管理平台，特别优化了bat文件的内容，包含无窗口模式和有窗口模式

有窗口模式会启动5个CMD窗口

无窗口模式就只有一个CMD窗口

至于喜欢哪个，有朋友们自己选择，bat文件设置了stop或者restart都会关闭之前已经打开的CMD窗口和端口，选择start启动时，会有一个比较干净的环境。

另外对于不确定的情况，还可以点击“一键清理端口.bat”，一键清理端口占用

号外：明天早上9点准时发布统一管理平台，敬请期待。