dingding_hrm/docs/01-vision.md

项目愿景

一、核心目标

Dingding HRM 要解决：现有钉钉组织和人员数据只能通过 Python 脚本导出 JSON，缺少集中浏览、搜索、同步和导出的管理界面。

让内部管理人员能够在一个本地 Web 工具中查看多站点钉钉部门架构和人员信息，并快速搜索、筛选、导出。

它不是完整 HR 系统，也不是钉钉替代品，而是一个围绕钉钉组织通讯录数据的轻量管理工具。

二、目标用户

• 内部管理员：配置站点密钥、触发同步、查看同步状态。
• HR / 行政人员：按站点、部门、姓名、手机号、工号查找人员。
• 开发维护者：维护钉钉 API 适配、数据库迁移、导出逻辑和本地部署。

三、产品原则

• 核心查询优先：先保证部门树、人员列表、搜索筛选可靠。
• 数据真实优先：以钉钉 OpenAPI 返回和 SQLite 入库结果为准，不用演示数据冒充真实数据。
• 本地单体优先：MVP 用单个 Go 服务完成 API、同步、静态前端托管。
• 低依赖优先：不引入前端框架，不引入复杂后台任务系统。
• 密钥安全优先：真实 app_secret、token 不进入代码、文档样例或日志明文。

四、核心价值主张

价值点	说明
集中查看	把梅州、东莞、合肥等站点的组织和人员数据放入统一界面
快速检索	支持按姓名、手机号、工号、部门筛选人员
可控同步	管理员可手动同步钉钉数据，并查看成功或失败状态
简单部署	Go 单体服务托管 API 和静态页面，减少前后端分离复杂度

五、不做什么（非目标）

• 不做人事档案全生命周期管理。
• 不做薪酬、考勤、审批、绩效等 HR 模块。
• 不做复杂权限系统，MVP 默认本地受信环境使用。
• 不做前端框架版本，不引入 Vue / React / Element Plus。
• 不在浏览器端直接调用钉钉 OpenAPI。