90 lines
5.0 KiB
Markdown
90 lines
5.0 KiB
Markdown
# 方法地图
|
|
|
|
> 维护者查找入口时先看这里，再进入具体文件。
|
|
|
|
## 应用启动
|
|
|
|
| 文件 | 方法 / 内容 | 说明 |
|
|
| --- | --- | --- |
|
|
| `main.go` | `main()` | 创建 Wails app、注册服务、嵌入资源、启动应用 |
|
|
| `internal/services/appservice.go` | `ConfigureAppService` | 配置窗口、托盘、语言资源和生命周期 |
|
|
| `internal/services/window_state.go` | main window state helpers | 读取和保存主窗口尺寸、最大化状态；第二窗口不参与 |
|
|
|
|
## 存储
|
|
|
|
| 文件 | 方法 / 内容 | 说明 |
|
|
| --- | --- | --- |
|
|
| `internal/services/store.go` | `NewSuiStore` | 打开 SQLite 并执行初始化 |
|
|
| `internal/services/store.go` | migration / CRUD 方法 | 初始化 `hotkeys`、`appconfig` 并提供基础读写 |
|
|
| `internal/services/store_test.go` | store 测试 | 覆盖存储初始化和关键读写 |
|
|
|
|
## 配置
|
|
|
|
| 文件 | 方法 / 内容 | 说明 |
|
|
| --- | --- | --- |
|
|
| `internal/services/appconfig_service.go` | `GetAppConfig` / `SetAppConfig` | 前端配置读写入口 |
|
|
| `internal/services/appconfig_service.go` | `GetLanguage` / `SetLanguage` | 语言配置读写入口 |
|
|
| `internal/services/appconfig_service.go` | `GetSettingsSchema` | 返回设置分组、默认值和当前值 |
|
|
| `internal/services/settings_schema.go` | settings schema | 集中定义主题、语言、窗口、快捷键、数据目录、日志策略和登录配置 |
|
|
| `internal/models/settings.go` | `AppSettingGroup` / `AppSettingDefinition` | 设置 schema 前端绑定模型 |
|
|
|
|
## 登录
|
|
|
|
| 文件 | 方法 / 内容 | 说明 |
|
|
| --- | --- | --- |
|
|
| `internal/services/auth_service.go` | `AuthService` | 登录、退出、当前会话和 auth mode |
|
|
| `internal/services/auth_service.go` | `LocalAuthProvider` | 校验后端初始化的本地固定账号 |
|
|
| `internal/services/auth_service.go` | `RemoteAuthProvider` | 真实后端登录 provider 预留边界 |
|
|
| `internal/models/auth.go` | `AuthSession` / `AuthProviderOption` | 前端绑定模型 |
|
|
| `frontend/src/modules/auth/LoginPage.vue` | 登录页 | 调用后端 AuthService，不写死账号密码 |
|
|
|
|
## 目标模板模块
|
|
|
|
| 模块 | 目标服务 | 说明 |
|
|
| --- | --- | --- |
|
|
| 登录 | `AuthService` | 已实现本地固定账号 provider，真实后端 provider 保留边界 |
|
|
| 审计日志 | `AuditLogService` | 记录登录、设置变更、任务操作、导出等用户动作 |
|
|
| 运行日志 | `AppLogService` | 记录 AI 调用、数据库、文件、热键等错误 |
|
|
| 商品图片 AI 优化 | `ImageOptimizationService` | 创建任务、查询状态、查看结果和失败原因 |
|
|
| 数据统计 | `MetricsService` | 聚合今日处理量、成功率、耗时、失败数和 7 天趋势 |
|
|
|
|
## 热键
|
|
|
|
| 文件 | 方法 / 内容 | 说明 |
|
|
| --- | --- | --- |
|
|
| `internal/services/hotkey_service.go` | `GetHotkeys` | 返回当前热键配置 |
|
|
| `internal/services/hotkey_service.go` | `UpHotkey` | 更新热键并重新注册 |
|
|
| `platform/hotkey_windows.go` | Windows 热键实现 | Windows 平台注册逻辑 |
|
|
| `platform/hotkey_darwin.go` | macOS 热键实现 | macOS 平台注册逻辑 |
|
|
|
|
## 前端
|
|
|
|
| 文件 | 方法 / 内容 | 说明 |
|
|
| --- | --- | --- |
|
|
| `frontend/src/main.ts` | Vue 入口 | 注册应用、路由和国际化 |
|
|
| `frontend/src/router/index.ts` | routes | 登录、主应用模块和第二窗口路由 |
|
|
| `frontend/src/layouts/MainLayout.vue` | 主窗口布局 | 侧边导航、顶部窗口区和 `RouterView` 内容区 |
|
|
| `frontend/src/components/template/ModulePageShell.vue` | 模块页共享壳 | 模块标题、状态和摘要卡片 |
|
|
| `frontend/src/modules/auth/LoginPage.vue` | 登录页 | 调用 AuthService 登录并处理错误 |
|
|
| `frontend/src/modules/dashboard/DashboardPage.vue` | 工作台骨架 | P0 指标和近期任务入口 |
|
|
| `frontend/src/modules/image-optimizer/ImageOptimizerPage.vue` | 主业务骨架 | 商品图片 AI 优化任务入口 |
|
|
| `frontend/src/modules/logs/LogsPage.vue` | 日志页骨架 | 审计日志和运行日志入口 |
|
|
| `frontend/src/modules/statistics/StatisticsPage.vue` | 统计页骨架 | P0 指标和 7 天趋势入口 |
|
|
| `frontend/src/modules/settings/SettingsPage.vue` | 设置页 | 复用存量设置组件，并展示后端统一设置 schema |
|
|
| `frontend/src/modules/components-demo/ComponentsDemoPage.vue` | 组件示例骨架 | 常用表单、筛选、表格和状态标签 |
|
|
| `frontend/src/pages/Home/Index.vue` | 第二窗口入口 | OCR 示例页面 |
|
|
| `frontend/src/utils/ThemeManager.ts` | 主题工具 | 主题切换和持久化协作 |
|
|
| `frontend/src/utils/i18n.ts` | 国际化工具 | 语言资源和切换 |
|
|
|
|
## 目标前端目录
|
|
|
|
| 目录 | 说明 |
|
|
| --- | --- |
|
|
| `frontend/src/layouts/` | 登录布局和主应用布局 |
|
|
| `frontend/src/modules/auth/` | 登录和会话 |
|
|
| `frontend/src/modules/settings/` | 设置中心 |
|
|
| `frontend/src/modules/image-optimizer/` | 商品图片 AI 优化业务样例 |
|
|
| `frontend/src/modules/logs/` | 审计日志和运行日志 |
|
|
| `frontend/src/modules/statistics/` | 数据统计 |
|
|
| `frontend/src/modules/components-demo/` | 常用组件示例 |
|