# Pulse

**Repository Path**: jiyuzz/pulse

## Basic Information

- **Project Name**: Pulse
- **Description**: 脉搏
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-13
- **Last Updated**: 2026-08-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Pulse - 项目经理效能系统

> 一款面向项目经理的全流程效能管理工具，覆盖项目全生命周期管理。
> 当前版本：`v0.8.14`（2026-08-08）

## 项目概述

Pulse 是一个前后端分离的项目管理原型系统，基于 Vue 3 + Element Plus + Pinia 构建前端，FastAPI + SQLite 构建后端。系统涵盖项目管理、任务跟踪、需求管理、变更管理、问题管理、风险管理、日报周报等核心功能，并集成了 AI 辅助能力。

## 技术栈

### 前端

| 技术 | 用途 |
|------|------|
| **Vue 3** (Composition API + `<script setup>`) | 前端框架 |
| **Element Plus** 2.8+ | UI 组件库 |
| **Pinia** 2.2+ | 状态管理 |
| **Vue Router** 4.4+ | 路由管理（`createWebHistory` + `base: '/pulse/'`） |
| **Vue I18n** 9.14+ | 国际化（中/英，36 个模块文件） |
| **Chart.js** 4.5+ | 数据可视化图表 |
| **html2canvas** | 图表导出为图片 |
| **xlsx** | Excel 导入导出 |
| **marked** | Markdown 渲染 |
| **vuedraggable** | 拖拽排序 |
| **axios** | HTTP 请求（统一拦截器） |
| **Vite** 5.4+ | 构建工具 |

### 后端

| 技术 | 用途 |
|------|------|
| **Python 3.14+** | 运行环境 |
| **FastAPI** | Web 框架 |
| **Uvicorn** | ASGI 服务器（`--reload` 热重载） |
| **SQLite** | 数据库（`backend/pulse.db`） |
| **loguru** | 日志框架（控制台+文件双重输出） |
| **httpx** | AI API 调用 |
| **pycryptodome** | AES 加密（API 密钥存储） |
| **Pydantic** | 请求体验证 |

## 快速启动

### 一键启动器（最省事）

项目根目录提供统一入口 `pulse.bat`，常用操作只需 2 个字母，也是推荐方式：

```bash
pulse rd    # 重启开发环境（停止 8003/5173 + 重新启动，最常用）
pulse d     # 仅启动开发环境
pulse sd    # 仅停止开发环境
pulse rp    # 重启生产双环境（8004/5174）
pulse p     # 仅启动生产双环境
pulse sp    # 仅停止生产双环境
pulse clr   # 清空生产演示数据（需输入 YES 确认）
pulse dep   # 旧 Nginx 方案部署
pulse upd   # 旧 Nginx 方案增量更新
pulse rl    # 旧方案重载
```

> - 把项目根目录加入系统 `PATH` 后，可在任意目录直接敲 `pulse rd`，无需先 `cd` 进项目。
> - 长命令（`pulse restart-dev` 等）同样可用；子命令参数（如 `nopause`）会原样透传。
> - 实际动作仍在 `scripts/{dev,prod,legacy}/` 下执行，`pulse.bat` 仅做转发。

### 开发环境

使用 `scripts/dev/` 下的一键脚本（开发环境）：

```bash
scripts/dev/start-dev-single.bat
```

该脚本会：
1. 停止已运行的前后端服务
2. 启动后端（`http://localhost:8003`）
3. 启动前端（`http://localhost:5173/pulse/`）

### 手动启动

```bash
# 后端
cd backend
pip install -r requirements.txt
python -m uvicorn main:app --host 0.0.0.0 --port 8003 --reload

# 前端（新终端）
cd frontend
npm install
npm run dev
```

### 生产部署

两套部署方案（详见 `docs/deployment-dual-env.md`）：

```bash
# 新双环境方案（推荐）：后端 8004 + pulse_prod.db，前端 5174，首次启动自动建库填演示数据
scripts/prod/start-prod-single.bat

# 旧 Nginx 方案（保留待确认）：build + xcopy 到 D:\environment\Website\pulse + 注册后端服务 + 重启 Nginx（8000/8888）
scripts/legacy/deploy-prod.bat
```

### 默认账号

- **账号**：`admin`
- **密码**：`123456`
- **角色**：超级管理员（拥有所有权限）

## 功能模块

### 驾驶舱与工作台
- **驾驶舱**：顶层概览卡片（6 张）、项目健康度矩阵、变更/需求/问题/风险/里程碑/范围核对概览图表（里程碑与范围核对概览支持状态/项目/趋势（或负责人）多维切换 + 可折叠温馨提示 + 导出图片 + 点击联动详情弹窗）
- **个人工作台**：今日焦点、我的任务、待我审批、快速笔记、日报周报快捷入口

### 核心业务管理
- **项目全景看板**：项目列表（新建/编辑共用 `ProjectFormDialog`，含项目经理/商务/产品负责人、项目成员及角色、整体进度、立项/中标/合同/验收等多日期字段）、详情页改为**吸顶锚点导航**（基本信息/里程碑/任务/范围核对/项目文件/问题/需求/风险/变更/干系人/工作日志 11 区块，点击平滑滚动、滚动反向高亮），各区块内嵌对应子视图并锁定当前项目；顶部**英雄区健康度仪表盘**（双 SVG 环形进度：任务完成度/项目进度，按阈值着色），信息卡片分基本信息/摘要/时间详情（时间默认收起）；嵌入的 10 个重模块采用 **`IntersectionObserver` 懒加载 + 骨架屏**（滚动到才挂载，首屏仅发 2 个请求）
- **项目文件管理**：范围核对、项目文件已提升为独立菜单页（路由 `/scope-check`、`/project-files`），既可独立使用也可内嵌项目详情；多文件批量上传 / 下载 / 内联预览（图片·PDF·文本）/ 批量删除 / Excel 导入导出，按文件分类组织
- **范围核对管理**：核对项 13 字段登记 + 截图真实上传 / 查看 / 删除 + 统计 + Excel 导入导出
- **任务与待办**：列表/看板/树形/甘特图四视图，子任务管理，批量删除（`taskStore.batchDelete` 级联删子任务、跨页选中）
  - 甘特图支持依赖关系管理（拖边缘调期、右侧圆点拉依赖、点连线删除）、任务时间拖拽调整、导出图片
  - 负责人统一改用 `UserSelect` 选择器（自研 `TreeSelect` 树形下拉，按姓名/账号/部门过滤、搜索自动展开定位、键盘 Esc/输入法友好）
- **客户需求池**：需求全生命周期管理（沟通中→已上线），提出者可由内部用户或外部干系人（新增 `StakeholderSelect`）
- **变更管理**：变更申请、审批流转、执行追踪，审批人改用 `StakeholderSelect`、支持查看/修改已有审批
- **问题管理**：问题记录、升级处理、解决跟踪
- **风险管理**：风险识别、矩阵热度图、按等级/类型/项目/趋势多维度分析，责任人改用 `UserSelect`
- **干系人通讯录**：项目干系人信息管理，支持按单位分组组织与筛选；对接人改用 `StakeholderSelect`
- **里程碑与日程**：里程碑设置、日历视图（新增**全屏日历**、事件详情弹窗、图例、取消达成）；列表按目标日期升序；**里程碑名称改字典驱动**（数据管理模块维护 `milestone_names` 字典，名称从清单选择，兼容历史自由输入）

### 运维与商机

- **运维管理**：工单管理与值班管理一体化
  - 工单管理：工单列表（筛选 / 分页 / 编辑 / 删除）、关联值班、状态流转
  - 值班管理：月历视图、批量排班（值班人员逗号分隔）、导入 / 导出
- **商机管理**：商机列表与详情，含阶段 / 金额 / 负责人等字段，配套商机概览图表

### 业务数据批量录入
- **模板下载 + 导入**：干系人 / 问题 / 风险 / 需求 / 变更 / 里程碑 / 项目 / 日志 八个模块均提供「下载模板（含完整业务字段）」与「Excel 批量导入」，导入按名称/编号映射外键、枚举默认值兜底、自动生成 ID 与时间戳；各列表页操作栏套用全局导入/导出样式（左新增/批量删除、右导入/导出）。
- **任务与待办批量录入**：任务模块同样提供「下载模板（含项目 ID / 父任务 ID / 类型 / 标题 / 描述 / 优先级 / 负责人 / 状态 / 进度 / 工时 / 计划起止日期等字段）」「Excel 批量导入」「按筛选项导出」；模板首行为 `#63B3ED` 蓝色表头并带示例行，与商机等模块一致。
- **组织批量录入（三级部门）**：组织架构-用户导入模板将「所属部门」拆为「一级/二级/三级部门」三列，后端按层级匹配或**自动新建部门**并挂到三级部门（`POST /users/import` 返回导入/跳过/新建部门数）；角色支持独立批量导入与导出。
- **导入失败诊断**：`ImportDialog` 在无有效数据时展示详细诊断（解析表头/前端列/期望模板列/样本行/逐行跳过原因），成功提示补充跳过条数与新建部门数，便于排查列名不一致等问题。

### 作业管理与定时推送
- **作业管理**：可视化配置定时任务，分「邮件作业」与「系统作业」两类（菜单「作业管理」）；操作栏位于卡片外标准区（左新增/批量删除、右导入/导出）
  - 邮件作业：按 cron 定时生成 AI 日报 / 周报并推送到指定邮箱（需先在「系统参数 - 邮件通知」配置 SMTP）
  - 系统作业：如清理过期日志、数据库自动备份（默认停用，启用后按 cron 周期执行）
- **调度引擎**：基于 APScheduler（时区 `Asia/Shanghai`），文件锁防止重复调度；作业执行记录写入 `job_logs`，可在作业详情查看成功率与耗时

### 辅助管理
- **干系人通讯录**：项目干系人信息管理，支持按客户分组组织与筛选
- **里程碑与日程**：里程碑设置、日历视图
- **项目日志**：Markdown 日志记录
- **日报/周报**：日报撰写、历史引用的相关模板
- **收尾管理**：检查清单、结项报告

### 通用功能
- **全局搜索**：跨模块模糊搜索，支持项目、任务、需求、变更等内容的快速定位
- **快捷键**：支持自定义快捷键，`Ctrl+Enter` 快速添加日报条目，`Ctrl+Shift+Enter` 快速添加子任务
- **中英文切换**：登录页和顶栏语言切换器，支持中文/英文界面，模块化 i18n 架构（36 个独立模块文件）
- **温馨提示**：全局统一的折叠提示组件，内容从系统参数管理可配置，支持中英文

### AI 辅助（AI 中心）
- **AI 中心**：从单轮对话升级为「AI 中心」，后端 `routers/ai.py` 接入 FastGPT 真实能力，支持多模型与多 Agent 协作；前端 `views/ai/` 拆分为 6 个子模块，支持会话管理、人工介入回写、会话暂停/打断、引用来源展示、对话驱动自动建项目等。
- **智能日报/周报生成**：基于项目数据自动生成报告草稿
- **风险智能预警**：分析项目风险数据，输出预警列表和建议措施
- **需求智能分类**：自动推荐需求类型和优先级
- **项目健康度评估**：从进度、风险、问题、变更、需求五个维度评分
- **调用日志**：每次 AI 调用自动记录完整请求/响应日志，超管可查看（会话级 + 步骤级）

### 系统配置
- **数据管理**：字典管理（分组+项，字典项「编码」为必填英文名且组内唯一，后端 `^[A-Za-z_][A-Za-z0-9_]*$` 校验 + 唯一性校验）、字段配置（输入形式/校验规则/提示文案）；系统字段与代码生成器关联字典时 key/value 统一使用「编码/名称」；字典与字段配置均支持分组/项/字段关键词搜索，全局搜索时显示「所属分组」列
- **字典·字段配置驱动（改法B 统一入口）**：字典分组的「消费模块」与「已绑字段」两列均由后端 `GET /dict-groups/used-by` 自动推导（扫描 `useDict` + 路由 + 菜单表，**以字段配置驱动为主**）；业务下拉统一走 `useDictByFieldConfig`（前端 `composables/useFieldConfigs.js`），先反查字段配置确认已登记才返回选项，未登记为空——强制「系统使用基础配置必须引用字段」；系统内置字典分组/字典项/字段配置不可删除（后端 `is_system` 保护 + 前端禁用删除按钮），消费模块真实菜单名实时展示
- **菜单管理**：菜单 CRUD、权限配置、批量导入导出，支持配置「上级菜单」(`parent_id`) 搭建一级/二级树形菜单（菜单列表以树形表格展示，新增/编辑可选上级，选项过滤自身及后代防循环）；菜单与权限两个 tab 的操作栏位于卡片外标准区（左新增、右导入导出），按钮套用全局样式
- **代码生成器**（系统管理 > 代码生成器）：可视化配置（字段/筛选/功能按钮，三种布局：列表页 §17.1 / 多 Tab 页 §17.4 / 分组侧栏 §17.6）+ **实时预览** + **实时生成代码** + 一键生成代码；字段可绑定数据管理模块字段并自动填充锁定；多 Tab 布局逐 Tab 配置标题/名称/字段/筛选/按钮，字段与筛选均继承自上方配置面板；**多 Tab 布局每个 Tab 使用独立表/API/Store**（由 `tab.tableName` 派生，避免多 Tab 串表），各 Tab 高度独立计算顶满容器
  - **预览区 iframe 沙盒直跑生成代码（所见即所得）**：预览由 `components/CodePreview.vue` 用 iframe 沙盒（importmap + blob URL）运行时编译 `generateView` 真实产物并挂载，替代早期手写渲染器；内部注入 Element Plus 中文 locale、全局样式 `src/styles/global.css` 与项目真实 i18n 实例，mock 了 store/api/字典，保证预览与正式页面一致；生成即**自动接入**——后端自动写入主文件、patch `router/index.js`/`i18n/index.js`/`backend/main.py`、写入菜单，无需手动合并；生成记录支持撤销（删除文件 + 按路由名逆向清理整合文件 + 删菜单 + 删数据表）。模块名/路由须唯一，避免同名互相覆盖。生成后端代码已对齐 `database.py` 真实签名（Pydantic v2、去除 `conn` 参数、SQL 参数化），并在 `write_files` 入口对 `name`/`tableName`/`route` 做白名单校验（`^[a-z][a-z0-9_]{0,49}$`、路径穿越/SQL 注入拦截），前端 `ConfigPanel.vue` 同步实时校验拦截
  - **表单校验与提示文案落盘**：生成的弹窗表单字段自动写入数据管理字段配置的 `hints.error`（校验规则提示）、`hints.placeholder`（占位文案，缺省回退「请选择/请输入」）与 `hints.help`（字段下方 `.field-help` 灰色说明）；三种布局（列表/多 Tab/分组侧栏）统一生成 select/date/datetime/number/textarea 等类型控件
  - **覆盖与同步**：生成面板提供「覆盖已存在文件」勾选（默认不勾），用于在不删表的前提下重新生成、同步数据管理后续变更的校验/提示文案；**撤销会删除数据库表，仅同步规则请用覆盖**，生成前弹确认框（提示将写入的文件数、自动挂载路由/i18n/后端路由/菜单、生成后需重启 dev 后端），生成/撤销成功后合并弹窗提示「已自动挂载、无需手动合并，请重启 dev 后端」使新接口生效
  - **生成记录可查**：「生成历史」支持按模块名/状态/布局/操作人筛选，可查看每次生成/撤销的请求与响应日志（含后端 `request_log`/`response_log`/`revert_request_log`/`revert_response_log`）
  - **实时生成代码**：左侧配置变更即时刷新「生成代码」tab 的文件清单（无需点「生成代码」按钮），配置不完整时显示空态；「生成代码」tab 内文件标签支持换行显示
  - **后端路由自带建表**：生成的后端模块含 `_ensure_table()`（`CREATE TABLE IF NOT EXISTS`，含 `id`+各字段+`created_at`/`updated_at`），`import` 即建表；开启批量删除时自动生成 `POST /{name}/batch-delete` 端点
- **组织架构**：部门树（支持三级部门，满三级后禁止再加子级）、用户管理（支持搜索）、角色管理、权限分配、Excel 批量导入导出
- **系统参数管理**：AI 配置、国际化开关等系统参数；左侧分组树支持「新建/重命名/删除分组」与排序号（`sort_order`）内联排序，分组显示图标、排序号与参数数量徽标；「日志配置」分组集中维护操作日志与接口日志参数（如接口日志开关 `api_log.enabled`、记录模式 `api_log.mode` 全量/仅异常）；支持 **JSON 导出与 JSON 导入**（按分组 `name`、参数 `param_key` upsert，加密字段走 `encrypt_aes`）
- **操作日志**：用户操作审计记录，由前端全局拦截器自动记录写操作（含 before/after 快照，可按需开启）；提供 **Excel 模板下载、批量导入与筛选导出**（按模块/动作/用户/状态/时间范围）
- **接口日志**：HTTP 请求日志（请求参数/请求头/响应数据），支持开关与全量/仅异常模式，由后端中间件实时读取系统参数生效

## 前后端通信

前端通过 axios 实例（`frontend/src/api/index.js`）与后端通信：
- `baseURL`: `/api`（开发环境通过 Vite proxy 转发到 `localhost:8003`）
- 请求拦截器自动从 `localStorage/sessionStorage` 读取 token 注入 `Authorization` header
- 响应拦截器统一提取 `response.data.data`，401 自动跳转登录页
- 响应拦截器统一全局错误提示（`utils/notify.js`）：按状态码分类提示（401/403/5xx/网络超时），其余使用后端 `detail`/`message`；2 秒内同内容去重，避免重复弹窗。某次请求需自行处理错误时传 `{ noGlobalError: true }` 豁免

## 项目结构

```
pulse/
├── backend/                          # 后端（FastAPI + SQLite）
│   ├── main.py                       # 入口：路由注册、CORS、API 日志中间件
│   ├── database.py                   # 数据库连接、CRUD 工具函数（41 张表，每张列带中文注释）
│   ├── migrate_db_comments.py         # 启动期幂等迁移：为已有库补全部表/列中文注释
│   ├── models.py                     # 数据模型
│   ├── seed_data.py                  # 种子数据初始化
│   ├── seed_orchestrator.py           # 种子加载编排器（两类型：系统运行必需 / 演示数据，受 demo.mode 控制）
│   ├── seed_modules.py                # 各模块幂等种子（文件/范围/作业/字段配置等）
│   ├── routers/                      # 路由模块（24 个）
│   │   ├── auth.py                   # 认证（登录/登出/改密）
│   │   ├── projects.py / tasks.py    # 项目/任务
│   │   ├── demands.py / changes.py   # 需求/变更
│   │   ├── issues.py / risks.py      # 问题/风险
│   │   ├── stakeholders.py / milestones.py / logs.py
│   │   ├── reports.py / notes.py / closure.py
│   │   ├── system_params.py          # 系统参数
│   │   ├── data_management.py        # 字典/字段配置
│   │   ├── menu_management.py        # 菜单管理
│   │   ├── organization.py           # 组织架构
│   │   ├── operation_logs.py         # 操作日志
│   │   ├── api_logs.py               # 接口日志
│   │   └── ai.py                     # AI 辅助
│   ├── utils/
│   │   └── crypto.py                 # AES 加解密
│   ├── pulse.db                      # SQLite 数据库文件
│   └── requirements.txt
├── logs/                             # 系统日志目录
│   └── pulse_YYYYMMDD.log            # 按天存储的日志文件
├── frontend/                         # 前端（Vue 3 + Vite）
│   ├── src/
│   │   ├── api/                      # API 层（22 个模块 + index.js）
│   │   │   ├── index.js              # axios 实例（拦截器）
│   │   │   ├── authApi.js            # 认证 API
│   │   │   ├── projectApi.js         # 项目 API
│   │   │   └── ...                   # 其他业务 API
│   │   ├── components/               # 通用组件
│   │   │   ├── charts/               # 图表组件
│   │   │   ├── Layout.vue            # 主布局
│   │   │   ├── Sidebar.vue           # 侧边导航
│   │   │   ├── GlobalSearch.vue      # 全局搜索
│   │   │   ├── TreeSelect.vue        # 自研树形下拉选择器（el-popover + 递归树）
│   │   │   └── ...
│   │   ├── i18n/                     # 国际化（36 个模块文件）
│   │   ├── router/                   # 路由配置（25 个业务路由 + 1 个登录页 + 404）
│   │   ├── composables/              # 组合式函数（useDict / useFieldConfigs / useParam / useUsers / useUserName）
│   │   ├── stores/                   # Pinia 状态管理（16 个 Store + mockData）
│   │   ├── utils/
│   │   │   ├── format.js             # 格式化工具
│   │   │   └── operationLog.js       # 操作日志工具
│   │   ├── views/                    # 页面视图（23 个���务页面 + 登录页）
│   │   ├── styles/global.css         # 全局样式（原 App.vue 全局样式，预览 iframe 复用）
│   │   ├── App.vue                   # 根组件
│   │   └── main.js                   # 入口文件
│   ├── index.html
│   ├── package.json
│   └── vite.config.js
├── pulse.bat                         # 根目录一键启动器（转发到 scripts/，短命令 rd/sd/d/rp/sp/p/clr/dep/upd/rl）
├── scripts/                          # 部署 / 运维脚本
│   ├── dev/                          # 开发环境：start-dev-single / stop-dev / restart-dev
│   ├── prod/                         # 生产环境（新双环境）：start-prod-single / stop-prod / restart-prod / clear-prod-demo
│   └── legacy/                       # 旧 Nginx 部署方案：deploy-prod / update-prod / reload_all（待确认是否弃用）
├── docs/                             # 方案 / 计划类文档
│   ├── deployment-dual-env.md        # 双环境部署方案
│   ├── design-four-modules.md        # 四个新模块设计方案
│   └── Pulse_Project_Plan.md         # 项目计划
└── README.md / CHANGELOG.md / ARCHITECTURE.md / CONVENTIONS.md  # 门面文档
```

## 相关文档

- [ARCHITECTURE.md](./ARCHITECTURE.md) —— 系统架构、技术栈、部署说明
- [CONVENTIONS.md](./CONVENTIONS.md) —— 前端开发规范（按钮、i18n、消息通知、表格、快捷键、路由等约定）
- [docs/deployment-dual-env.md](./docs/deployment-dual-env.md) —— 双环境（测试 / 生产）部署方案

## 许可

MIT