4.3 KiB

Raw Permalink Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

这是一个基于 Tauri 2.x + Vue 3 的工单监测桌面应用，用于监测 CRM 系统（crm.yunvip123.com）的待处理工单并发送系统通知。

常用命令

项目使用 pnpm 作为包管理器。

# 启动开发模式（前端 + Tauri）
pnpm run tauri-dev

# 仅启动前端开发服务器
pnpm run dev

# 前端类型检查 + 构建
pnpm run build

# 构建 Tauri 生产版本（含签名/安装包）
pnpm run tauri-build

# 构建并发布
pnpm run deploy

# 版本号管理（默认 patch）
pnpm run version          # patch
pnpm run version:minor
pnpm run version:major

# 代码检查
pnpm run lint
pnpm run lint:fix

# 规范提交（commitizen + cz-git）
pnpm run commit

# Rust 后端检查
cd src-tauri && cargo check
cd src-tauri && cargo clippy

架构概述

前端驱动架构：所有业务逻辑（API 调用、定时任务、通知）都在 Vue 前端实现，Rust 后端仅负责系统级功能（窗口管理、插件注册）。

前端分层（src/）

Stores（Pinia）：

stores/monitor.ts — 核心业务：登录、轮询检查工单、推迟/暂停逻辑、托盘联动
stores/app.ts — 全局配置（轮询间隔、自启动、静默启动等），配置持久化到 localStorage（key: crm_config）
stores/log.ts — 运行日志管理
stores/network.ts — 网络状态检测

Composables：

composables/useNotification.ts — 系统通知封装（tauri-plugin-notification）
composables/useTray.ts — 系统托盘创建、图标/菜单动态更新
composables/useUpdater.ts — 应用自动更新（tauri-plugin-updater）
composables/useMonitor.ts — 监测相关辅助逻辑

Constants：

constants/api.ts — 所有 API URL 集中定义（LOGIN_URL、CHECK_URL、WORK_ORDER_URL）
constants/app.ts — 应用级常量

Utils：

utils/storage.ts — localStorage 读写封装
utils/common.ts — 通用工具函数（formatTime 等）

Rust 后端（src-tauri/src/）

lib.rs — 应用初始化、插件注册、窗口关闭事件处理（关闭→隐藏到托盘，发出 close-requested 事件）

关键数据流

App.vue 初始化：加载配置 → 加载凭据 → 初始化托盘 → 监听通知动作事件 + 关闭事件
monitorStore.startMonitoring() 执行登录（密码或 Token 模式），成功后启动 setInterval 轮询
工单有待处理项时调用 useNotification.notify()，通知动作（推迟/去处理）通过 Tauri 事件回传
托盘图标/菜单通过 watch([isMonitoring, isPostponed, ticketCounts]) 自动同步

API 集成

登录：POST https://crm.yunvip123.com/api/SystemUser/Login
工单查询：GET https://crm.yunvip123.com/api/DemandManage/QueryIndexCount
认证方式：登录响应 set-cookie 中提取 ASP.NET_SessionId，后续请求携带
HTTP 白名单配置在 src-tauri/capabilities/default.json

通知触发条件

当 PendingCount（待处理）、StaycloseCount（待关闭）、ConfirmCount（待确认）任意 > 0 时触发。

代码规范

Vue 组件使用 <script setup lang="ts"> + <style lang="scss" scoped>
方法定义优先使用 function 关键字（而非箭头函数赋值）
props 尽量提供 default 默认值；在 script 中使用 props 时通过 toRefs(props) 解构
新增成员变量和方法须加注释

关键配置文件

src-tauri/capabilities/default.json — Tauri 权限配置（HTTP 白名单、插件权限）
src-tauri/tauri.conf.json — 应用配置（窗口、图标、bundle、updater 端点）
.env / .env.development / .env.production — 环境变量
vite.config.ts — Vite 配置，开发服务器端口 1420，HMR 端口 1421

依赖的 Tauri 插件

tauri-plugin-http — HTTP 请求
tauri-plugin-notification — 系统通知
tauri-plugin-autostart — 开机自启动
tauri-plugin-opener — 打开外部链接
tauri-plugin-updater — 应用自动更新
tauri-plugin-store — 持久化存储
tauri-plugin-process — 进程控制

Windows 编译要求

需要安装 Visual Studio Build Tools（包含 C++ 工具链）才能编译 Rust 后端。

4.3 KiB Raw Permalink Blame History Unescape Escape