mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-09-30 06:16:37 +08:00
ryan
69 lines
1.7 KiB
Markdown
69 lines
1.7 KiB
Markdown
# ATSFlare 前端改造说明
|
|
|
|
## 1. 当前状态
|
|
|
|
前端改造已完成，`atsf_server/web` 的 Next.js 新版工程已经成为正式管理端基线。
|
|
|
|
当前结论：
|
|
|
|
* 旧版 CRA + Semantic UI 方案已退出基线
|
|
* 新版前端继续由 Go Server 以静态资源方式托管
|
|
* 前端改造过程中的阶段计划、迁移顺序与风险清单不再继续维护
|
|
|
|
---
|
|
|
|
## 2. 当前前端基线
|
|
|
|
新版管理端位于 `atsf_server/web`，当前基线为：
|
|
|
|
* Next.js 15 App Router
|
|
* React 19
|
|
* TypeScript
|
|
* Tailwind CSS 4
|
|
* TanStack Query
|
|
* React Hook Form + Zod
|
|
* Zustand（仅限轻量客户端状态）
|
|
* Vitest + Playwright
|
|
|
|
工程与运行方式：
|
|
|
|
* `next build` 后生成静态导出产物
|
|
* 构建后通过现有流程交由 `atsf_server` 托管
|
|
* 登录态继续兼容现有 Session/Cookie 体系
|
|
|
|
---
|
|
|
|
## 3. 当前结构约束
|
|
|
|
新版前端保持以下结构：
|
|
|
|
* `app/`：路由与布局
|
|
* `features/`：业务模块
|
|
* `components/`：复用组件
|
|
* `lib/`：请求、环境、工具、常量
|
|
* `store/`：少量跨页面 UI 状态
|
|
* `tests/`：前端测试
|
|
|
|
当前已覆盖的主要页面包括：
|
|
|
|
* 首页
|
|
* 反代规则
|
|
* 配置版本
|
|
* 节点管理
|
|
* 应用记录
|
|
* 域名管理
|
|
* TLS 证书
|
|
* 用户管理
|
|
* 设置
|
|
* 登录、注册、重置密码、GitHub OAuth、关于页
|
|
|
|
---
|
|
|
|
## 4. 后续维护原则
|
|
|
|
后续不再按“前端改造专项”推进，而按正式前端工程进行维护：
|
|
|
|
* 新前端开发统一遵循 [docs/frontend-development-guidelines.md](./frontend-development-guidelines.md)
|
|
* 涉及项目级约束时，同时遵循 [docs/development-guidelines.md](./development-guidelines.md)
|
|
* 若后续再次调整前端架构、部署模式或技术基线，再新增专项计划文档
|