pear-admin-flask

437 Commits 3 Branches 6 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
bwstudio	98edfdaf2d	feat(deploy): 个人 NAS 单机 Docker 部署方案适用：内网 / 家庭 / 小团队（≤50 并发），无 K8s 需求。特性：单容器 + SQLite + 端口暴露，最小维护成本。新增： - deploy/nas/Dockerfile: python:3.11-slim 基础镜像 + 非 root + HEALTHCHECK - deploy/nas/start.sh: flask db upgrade 幂等迁移 + gunicorn (2 workers × 4 threads) - deploy/nas/docker-compose.yaml: 单服务 + 4 个命名卷 (db/logs/session/upload) + 资源限制 - docs/deployment-nas.md: 完整部署/备份/升级/排障指南完善： - .env.example: 改为生产环境导向 (PEAR_ENV=pro，SECRET_KEY 必填) - .dockerignore: 排除 deploy/dev (开发用容器配置)、tests/截图、一次性脚本 - applications/view/public/__init__.py: 注释说明 /healthz 已在 applications/view/health.py 注册复用现有： - /healthz 接口 (applications/view/health.py) 含 DB 探活，DB 不可达返回 503 → 容器 HEALTHCHECK 直接用 /healthz 即可 ⚠️ 本机无 docker，未执行 docker build 验证；已静态校验 YAML/bash 语法、文件路径、.env 字段消费、ProConfig 严格性、/healthz 端点可用性。首次 NAS 上部署时跑一遍文档步骤即可。	2026-09-06 18:35:31 +08:00
bwstudio	1214bfdf4a	feat(ops): 环境变量化配置 + 健康检查 + 启动脚本 + 部署/安全文档主要变更： config - 引入 python-dotenv，从 .env 加载 SECRET_KEY / MAIL_* / SQLALCHEMY_DATABASE_URI - 拆分 BaseConfig / DevConfig / ProConfig，PEAR_ENV 控制切换 - ProConfig 在 init_app() 校验 SECRET_KEY，禁止使用默认值 ops - 新增 /healthz 端点：DB 探活 + 环境名 + 时间戳，失败返回 503 - 新增 start.bat (Windows) / Makefile (跨平台) 一键启动 / 初始化 - 新增 .env.example 模板；.gitignore 排除 .env / logs / vscode 等 - 新增 docs/DEPLOY.md（部署指南）和 docs/SECURITY.md（安全清单） - app.py 不再硬编码 debug=False，交给配置类决定本提交不包含上一次会话的其它工作树修改（模板/导航相关），后续单独 PR。	2026-09-05 20:46:12 +08:00

Author

SHA1

Message

Date

bwstudio

98edfdaf2d

feat(deploy): 个人 NAS 单机 Docker 部署方案

适用：内网 / 家庭 / 小团队（≤50 并发），无 K8s 需求。
特性：单容器 + SQLite + 端口暴露，最小维护成本。

新增：
- deploy/nas/Dockerfile: python:3.11-slim 基础镜像 + 非 root + HEALTHCHECK
- deploy/nas/start.sh: flask db upgrade 幂等迁移 + gunicorn (2 workers × 4 threads)
- deploy/nas/docker-compose.yaml: 单服务 + 4 个命名卷 (db/logs/session/upload) + 资源限制
- docs/deployment-nas.md: 完整部署/备份/升级/排障指南

完善：
- .env.example: 改为生产环境导向 (PEAR_ENV=pro，SECRET_KEY 必填)
- .dockerignore: 排除 deploy/dev (开发用容器配置)、tests/截图、一次性脚本
- applications/view/public/__init__.py: 注释说明 /healthz 已在 applications/view/health.py 注册

复用现有：
- /healthz 接口 (applications/view/health.py) 含 DB 探活，DB 不可达返回 503
  → 容器 HEALTHCHECK 直接用 /healthz 即可

⚠️ 本机无 docker，未执行 docker build 验证；已静态校验 YAML/bash 语法、
   文件路径、.env 字段消费、ProConfig 严格性、/healthz 端点可用性。
   首次 NAS 上部署时跑一遍文档步骤即可。

2026-09-06 18:35:31 +08:00

bwstudio

1214bfdf4a

feat(ops): 环境变量化配置 + 健康检查 + 启动脚本 + 部署/安全文档

主要变更：

config
- 引入 python-dotenv，从 .env 加载 SECRET_KEY / MAIL_* / SQLALCHEMY_DATABASE_URI
- 拆分 BaseConfig / DevConfig / ProConfig，PEAR_ENV 控制切换
- ProConfig 在 init_app() 校验 SECRET_KEY，禁止使用默认值

ops
- 新增 /healthz 端点：DB 探活 + 环境名 + 时间戳，失败返回 503
- 新增 start.bat (Windows) / Makefile (跨平台) 一键启动 / 初始化
- 新增 .env.example 模板；.gitignore 排除 .env / logs / vscode 等
- 新增 docs/DEPLOY.md（部署指南）和 docs/SECURITY.md（安全清单）
- app.py 不再硬编码 debug=False，交给配置类决定

本提交不包含上一次会话的其它工作树修改（模板/导航相关），后续单独 PR。

2026-09-05 20:46:12 +08:00