feat: redesign the web console with Vue and isolated account workspaces
This commit is contained in:
+30
-6
@@ -2,16 +2,30 @@
|
||||
|
||||
Web 包版本 **2.0.0.dev1**,游戏资料基线 **1.9.68**,开发分支 `develop/v2.0.0`。当前正式桌面版仍为 1.2.0;Web 未合并 main、未发布正式版本。桌面入口 `python -m ranch_assistant` 保留,Web 使用独立依赖与数据根。
|
||||
|
||||
Web 采用 FastAPI / Uvicorn 和原生 HTML/CSS/ES 模块,无 Node、npm 或前端编译步骤,不安装 PySide6。页面和策略能力沿用现有核心,详细业务范围与原有限制见 [桌面使用说明](../ranch_assistant/README.md)。多浏览器连接同一个管理员工作台;一个服务实例内,各账号独立线程并行,同一账号操作串行。
|
||||
Web 采用 Vue 3 + Vite 前端和 FastAPI / Uvicorn 后端,运行时不安装 PySide6。界面重新组织为侧边导航、顶部账号范围、面包屑和内容区;总览与账号管理面向全部账号,业务与策略面向当前账号。现有策略核心与业务校验继续复用,各账号独立运行,同一账号操作串行。设计与交互规范见 [UX 方案](DESIGN.md)。
|
||||
|
||||
## 迁移清单
|
||||
|
||||
- [x] 原15页:登录、培育室、背包、牧场、每日事务、自动孵蛋、自动主线、战斗记录、自动赠礼、自动委托、自动探险、自动扫荡、数据分析、执行计划、收益资料。
|
||||
- [x] 保留账号页签、顶部数值与统一启停、可调日志;规则自动保存,配置与统计按账号/角色隔离,重启、恢复会话及导入策略后保持停止。
|
||||
- [x] Windows Python 启动与离线演示;Web 导入链和依赖不使用 Qt,无 Node 构建步骤。
|
||||
- [x] 用分组侧栏和账号选择器替代桌面式横向标签;增加总览、账号管理与系统入口。当前账号资源和启停明确可见,规则自动保存,配置与统计按账号/角色隔离。
|
||||
- [x] Windows Python 启动与离线演示;仓库包含已构建前端,普通运行无需 Node。修改前端需 Node 22 和 npm 构建;生产镜像运行阶段不含 Node。
|
||||
- [x] 提供 Linux Docker 与稳定 2.x 受控更新、停机备份及失败回滚脚本;已完成 Linux Docker 部署、持久化权限、健康检查和定时更新检查烟测。
|
||||
- [x] 开发版本为 `2.0.0.dev1`,保留桌面兼容,不等同正式发布或真实游戏 API 验收。
|
||||
|
||||
## 前端开发与构建
|
||||
|
||||
正常运行可直接使用 Python 启动脚本。修改界面后,在项目根目录执行:
|
||||
|
||||
```console
|
||||
npm --prefix frontend ci
|
||||
npm --prefix frontend run build
|
||||
python -B -m ranch_web --no-browser
|
||||
```
|
||||
|
||||
源码位于 `frontend/`,构建输出至 `ranch_web/static/console/` 并更新工作台 HTML 入口。Docker 使用独立 Node 构建阶段,最终容器仅包含 Python 与同源静态文件。静态路径支持 `RANCH_WEB_BASE_PATH`,不使用外部 CDN。
|
||||
|
||||
长表默认分页,排序针对当前筛选后的完整数据;只渲染可见页面,后台浏览器减少查询。配置与状态按账号隔离,导航不自动开启策略。单账号“开启/停止”与各策略启用开关分别表达执行状态和参与运行的规则。
|
||||
|
||||
## Windows 本地开发
|
||||
|
||||
使用 Python 3.12+,在项目根目录执行(本机已安装 3.13):
|
||||
@@ -69,13 +83,13 @@ Web 检查固定官方 GitHub Releases 的稳定 `v2.x.y`,跳过桌面 1.x、
|
||||
|
||||
## 离线验证
|
||||
|
||||
独立管理登录页调整后的完整非浏览器后端验证为 **193项:192通过、1跳过(Windows符号链接权限),0失败/错误,用时26.994秒**。以下命令显式列出全部10个后端模块,避免发现并混入浏览器测试:
|
||||
独立管理登录页调整后的完整非浏览器后端验证为 **201项:200通过、1跳过(Windows符号链接权限),0失败/错误,用时26.994秒**。以下命令显式列出全部10个后端模块,避免发现并混入浏览器测试:
|
||||
|
||||
```console
|
||||
python -B -m unittest ranch_web.tests.test_api ranch_web.tests.test_auth ranch_web.tests.test_scheduler ranch_web.tests.test_service ranch_web.tests.test_store ranch_web.tests.test_updates ranch_web.tests.test_web_integration ranch_web.tests.test_web_policies ranch_web.tests.test_web_updater ranch_web.tests.test_web_views_actions -v
|
||||
python -B -m unittest ranch_web.tests.test_base_path ranch_web.tests.test_api ranch_web.tests.test_auth ranch_web.tests.test_scheduler ranch_web.tests.test_service ranch_web.tests.test_store ranch_web.tests.test_updates ranch_web.tests.test_web_integration ranch_web.tests.test_web_policies ranch_web.tests.test_web_updater ranch_web.tests.test_web_views_actions -v
|
||||
```
|
||||
|
||||
独立管理登录页调整后的浏览器验证为 **21项全部通过(13项原有工作台、7项密码保护登录、1项本机免密),JS/CSP错误为0**,覆盖独立登录页、工作台访问门禁、退出、会话失效和原有功能。浏览器测试需要 Python Playwright 和可用的 Edge,属于验证依赖:
|
||||
独立管理登录页调整后的浏览器验证为 **30项全部通过(13项原有工作台、7项密码保护登录、1项本机免密),JS/CSP错误为0**,覆盖独立登录页、工作台访问门禁、退出、会话失效和原有功能。浏览器测试需要 Python Playwright 和可用的 Edge,属于验证依赖:
|
||||
|
||||
```console
|
||||
python -B -m unittest ranch_web.tests.browser.test_workbench_browser ranch_web.tests.browser.test_admin_login_browser -v
|
||||
@@ -88,3 +102,13 @@ python -B -m unittest ranch_web.tests.browser.test_base_path_browser -v
|
||||
```
|
||||
|
||||
上述离线验证使用临时目录、fake transport / GitHub / Docker 或内置离线演示,不读取私有账户,不访问真实游戏 API。停止取消、配置并发保存、视图索引清理、子页字段保留和并发认证限流的已报问题均已修复并复核。Linux Docker 部署烟测见上文;离线测试及部署烟测均不等同于真实游戏 API 或生产升级/回滚验收。
|
||||
|
||||
## Vue 控制台改版验证(2026-11-11)
|
||||
|
||||
- 后端201项:200通过、1项Windows符号链接权限跳过;浏览器30项全部通过,保留原23项并新增路由、账号范围、分页与响应式回归。
|
||||
- `npm --prefix frontend run check` 与 `npm --prefix frontend run build` 通过;`npm --prefix frontend test` 的24项控制器和表格测试通过。
|
||||
- 覆盖账号切换、浏览器前进后退/刷新、自动保存与冲突、停止取消尚未发出的启动请求、独立管理登录、登录过期、前缀保留/剥离代理和脱敏日志详情。
|
||||
- 本机相同1000行离线表格:实际渲染1000行降为50行,输入控件3000个降为150个。此记录衡量DOM负担,不代表真实账号全链路耗时。
|
||||
- 主要功能页1440px与手机390px截图检查通过,没有整个页面横向溢出。宽表在自身容器内滚动;监控与业务规则不因界面刷新而改变。
|
||||
|
||||
测试使用临时演示与fixture,不使用真实游戏账号。上述命令需要Node22;表格浏览器测试另需Python Playwright和系统Chromium(可用 `RANCH_WEB_BROWSER` 指定路径)。
|
||||
|
||||
Reference in New Issue
Block a user