积分账户、商城与流水

更新日期：2026-08-04（基线 v1.155.1）

一、功能简介

积分是这套系统里的"内部货币"：成员完成任务、按时填日报、登录打卡……都会攒下积分，攒够了可以在积分商城里换东西。这一篇讲的是管理员这一侧的三张表：

• 积分账号管理（/score/account）——账本的"余额页"。一人一个账号，看每个人一共攒了多少（总积分）、还剩多少能花（可用积分）、已经花掉多少（累计消费积分）。还能切到「图表」看每个人的积分随时间怎么涨的。
• 积分商品管理（/score/goods）——商城的"货架"。维护可以拿积分换的商品：叫什么、需要多少分、有多少库存、上不上架。
• 积分流水管理（/score/water）——账本的"明细页"。每一笔积分是哪来的（哪个项目的哪个任务、什么行为）、加了多少分、什么时候加的，逐条留痕。发错了、算错了，管理员可以在这里改数字，并且必须写清楚为什么改。

一句话记住三者关系：流水是一笔笔的账，账号是这些账算出来的余额，商城是花掉余额的地方。

二、什么时候用它

• 月底盘点：想知道全公司谁攒了多少分、这个月总共发出去多少分 → 看积分账号管理，必要时点「导出」拿表格；
• 有人反馈"我的分不对"：去积分流水管理按他的账号名搜，一笔笔核对来源，找到错的那一笔改掉并写明原因；
• 要上新的兑换品（比如"半天调休"、"定制水杯"）→ 去积分商品管理新增商品、定分值和库存；
• 某个商品换完了 / 活动结束了：把它的状态改成「失效」下架，而不是删掉；
• 要给某人手工补分或扣分：先看流水里有没有对应的错账可以改；确实要直接动余额，就在积分账号管理里编辑这个人的「当前积分」；
• 想看激励效果：积分账号管理切到「图表」页签，看各人积分曲线涨得快不快。

三、开始之前（前置条件）

项	说明
从哪进	左侧菜单点「积分管理」，直接进「积分账号管理」；再从页面顶部的一排页签切到「积分商品管理」「积分流水管理」。这三页都在个人中心/系统这一侧，不在某个项目里面。
查看权限	积分管理是管理员用的页面。没有权限时按钮不显示（或菜单里根本没有这一项），请联系项目管理员开通。
一次只能选一条	「编辑」「删除」都是对选中的那一行操作。一行都没选的时候，这两个按钮是灰的、点不动；点了会提示"请选择一条数据"。选行的方式是点行首的圆点（或直接点这一行）。
翻页 / 查询后选中会清空	每次重新查数据都会把选中状态清掉，避免你对着已经不在屏幕上的那条记录误操作。
积分怎么"生出来"不在这三页配	任务完成发多少分、登录填日报发多少分，是在「积分类别管理」和「日常积分管理」两页配的（同一排顶部页签里）。这三页只管账本和货架。
状态只有两种	账号、商品、流水的状态都只有「激活」和「失效」两种，没有中间态。

四、操作步骤

A. 查看和维护积分账号（余额）

第 1 步　进入积分账号管理 左侧菜单点「积分管理」，默认落在这一页。上面一排是筛选条件和按钮，下面是「表格」「图表」两个页签。

第 2 步　筛选出你要看的人

• 姓名：输入关键词，按回车即查；
• 状态：下拉选「激活 / 失效」；
• 时间区间：常驻三档「近7日 / 近30日 / 近90日」，点「自定义」还能选今日 / 昨日 / 本周 / 上周 / 本月 / 上月，或直接挑起止日期。

选完点「查询」；想清空全部条件点「重置」。

⚠️ 页面刚打开时，时间区间按钮虽然显示着「近30日」，但列表其实是不带时间过滤的全量数据。想真的按时间段看，手动点一下档位（哪怕还是点「近30日」），列表才会按这个区间重查。

〔待补截图 2：积分账号管理「表格」页签的全景，列表里至少有 5–8 行人。重点框住上方的筛选区（姓名、状态、时间区间、查询、重置）和右边的新增/编辑/删除/导出四个按钮。〕

第 3 步　读懂这张表 每行一个人，从左到右是：姓名、总积分、可用积分、累计消费积分、新增积分、新消费积分、积分变化、计算日期、状态。其中「总积分」这一列的表头可以点，按总积分排序（找出攒分最多的人）。

第 4 步　（可选）新增一个积分账号 点右侧「新增」，弹出「新增积分账号」窗口，填四项：

• 积分账号名称（必填）——一般填这个人的姓名；
• 当前积分（必填）——初始可用积分，默认 0；
• 使用积分——已消费掉的积分，默认 0；
• 状态（必填）——默认「激活」。

点「确定」，提示"创建成功"。

⚠️ 新建账号会沿用当前列表里已有账号的组织。所以列表是空的时候（比如筛选后一条都没有）不要直接点新增，先点「重置」让列表有数据再建。（待核实：某个组织第一次建积分账号、列表本来就空时的正确做法）

第 5 步　（可选）编辑 / 删除账号 点行首圆点选中某人 → 点「编辑」，能改的还是上面那四项（名称、当前积分、使用积分、状态），改完点「确定」提示"修改成功"。 删除：选中 → 点红色「删除」→ 确认框「确定删除该积分账号？」→ 确定，提示"删除成功"。

⚠️ 删除账号会连人带余额一起没掉，且不可恢复。 人离职了建议把状态改成「失效」保留记录，而不是删。

第 6 步　（可选）看积分走势图 点「图表」页签，每个人一条折线，横轴是日期，纵轴是累计积分，越往右越高。

• 图表必须有时间范围才能画。你没选区间的话，系统会自己按最近 90 天来画；
• 为了让图不乱，这段时间里一分没动的账号不会画出来；
• 图例（顶部的人名）可以左右滚动，点人名可以单独隐藏/显示某条线。

〔待补截图 3：积分账号管理切到「图表」页签、已经画出多条折线的样子。重点框住顶部的图例和左上角的时间区间选择器。〕

第 7 步　（可选）导出 点「导出」，系统按你当前设置的筛选条件导出一份积分账号表格（在新窗口下载）。想导全量就先点「重置」。

B. 维护积分商城的商品

第 1 步　切到积分商品管理 在顶部那排页签里点「积分商品管理」。

第 2 步　筛选商品 上面四个筛选框：商品名称、商品描述、商品类型（这三个都是输入关键词，按回车即查）、状态（下拉选激活 / 失效）。点「查询」或「重置」。

第 3 步　新增商品 点「新增」，弹出「新增商品」窗口：

• 商品名称（必填）——比如"星巴克券"、"半天调休"；
• 商品描述——多行文本，写清楚兑换说明、使用规则；
• 商品类型——自己手打的一段文字（比如"实物"、"权益"），不是下拉选项，所以同一类请统一写法，否则按类型筛选时搜不全；
• 需要积分（必填）——兑换要花多少分，不能小于 0；
• 折扣(最大1.00)——最大只能填 1.00，每次加减 0.1。1 表示原价；
• 库存——还有几件，不能小于 0；
• 状态（必填）——默认「激活」（= 上架）。

点「确定」，提示"创建成功"。

〔待补截图 4：「新增商品」弹窗的完整表单（空白状态）。重点框住「折扣(最大1.00)」这一栏。〕

第 4 步　编辑 / 下架 / 删除商品

• 编辑：选中一行 → 点「编辑」→ 改完点确定，提示"修改成功"。注意列表里的「上架时间」「创建时间」两列是系统记录的，编辑窗口里没有这两项、改不了；
• 下架：不要删，把状态改成「失效」即可，历史兑换记录还在；
• 删除：选中 → 点红色「删除」→ 确认框「确定删除该商品？」→ 确定，提示"删除成功"。不可恢复。

💡 这一页只是"货架"，不是"收银台"。 成员实际怎么下单兑换、兑换后怎么核销，不在这个页面里操作。（待核实：成员端的兑换/下单入口在哪，是否已开放）

C. 查账与修正积分流水

第 1 步　切到积分流水管理 在顶部那排页签里点「积分流水管理」。

第 2 步　按账号 / 状态 / 时间捞记录

• 账号名称：输入关键词，按回车即查（"张三说他的分不对"就从这里开始）；
• 状态：下拉选激活 / 失效；
• 时间区间：和账号页一样，三档常用 + 自定义。

⚠️ 这一页改完时间区间不会自动刷新——选完区间必须再点一下「查询」才会按新区间捞数据。（账号管理页是选完就自动刷的，两页行为不一样，别被绕进去。）

第 3 步　读懂一条流水 一行就是一笔加分/减分，字段依次是：账号名称、积分类别、积分数量、流水时间、来源详情、修改原因、状态、任务名称、任务完成日期、项目名称、修改时间。

也就是说，一笔任务积分能直接看到它是哪个项目、哪个任务、什么时候完成的，对账很方便。

〔待补截图 5：积分流水管理的列表全景，最好有几条带「任务名称 / 项目名称」的记录。重点框住「来源详情」「任务名称」「项目名称」这几列。〕

第 4 步　修正一笔算错的积分 选中这一行 → 点「编辑」，弹出「编辑积分流水」窗口，里面只有四项：

• 账号名称——灰的、改不了（不能把一笔积分挪到别人头上）；
• 积分数量——改成正确的分值；
• 状态——激活 / 失效；
• 修改原因——多行文本，写清楚为什么改。

点「确定」，提示"修改成功"。改完之后，「修改原因」和「修改时间」会显示在列表里，谁都能看到这笔账被动过、为什么动。

💡 改流水是有痕迹的操作，请务必把「修改原因」写清楚（比如"任务重复计分，扣回 20 分"）。虽然系统没强制要求填，但空着会让后面查账的人完全看不懂。

第 5 步　删除一笔流水（谨慎） 选中 → 点红色「删除」→ 确认框「确定删除该流水记录？」→ 确定，提示"删除成功"。

⚠️ 删除是真删、不可恢复，而且账本上会直接"少一笔"，事后无从追溯。 除非是明显的垃圾数据，否则优先用"编辑改成 0 分 + 写明原因"或把状态改成「失效」，把痕迹留下来。

第 6 步　（重要）改完流水后回去看账号余额 （待核实：修改或删除流水之后，积分账号页的「总积分 / 可用积分」是当场重算，还是要等系统下一次统计。稳妥做法是改完隔一会儿回账号页对一下数，不对就找管理员。）

D. 三页共用的翻页操作

三张表底部都是同一套翻页条：左边显示「共 N 条」，右边是页码。每页默认 20 条，可以切换成 10 / 20 / 50 / 100，也可以直接在「跳至」框里输入页码。

五、字段与选项说明

积分账号列表的列

列	含义
姓名	积分账号名称，一般就是人名
总积分	累计一共获得多少分（这一列可点表头排序）
可用积分	现在还能花多少分（= 商城兑换时看的那个数）
累计消费积分	一共花掉了多少分
新增积分	所选时间段内新增了多少分
新消费积分	所选时间段内花掉了多少分
积分变化	所选时间段内的净变化
计算日期	这行数据是系统什么时候统计出来的
状态	激活（绿色）/ 失效（灰色）

新增 / 编辑积分账号的字段

字段	是否必填	说明
积分账号名称	必填	一般填姓名
当前积分	必填	即"可用积分"，默认 0，可加可减
使用积分	选填	即"累计消费积分"，默认 0
状态	必填	默认「激活」

表单里没有「总积分 / 新增积分 / 积分变化 / 计算日期」——这几个是系统按流水统计出来的，手工改不了。

积分商品的字段

字段	是否必填	说明
商品名称	必填	兑换品的名字
商品描述	选填	多行，写兑换说明
商品类型	选填	手工输入的文字，不是下拉；同类请统一写法
需要积分	必填	兑换所需分值，最小 0
折扣(最大1.00)	选填	上限就是 1.00，每次加减 0.1，默认 1
库存	选填	最小 0，默认 0
状态	必填	激活 = 上架，失效 = 下架；默认「激活」
上架时间 / 创建时间	系统记录	只在列表里显示，表单里没有、改不了

积分流水的列与可改项

列	含义	能不能改
账号名称	这笔分记在谁头上	❌ 只读
积分类别	任务积分 / 行为积分等大类	❌ 只读
积分数量	这笔加/减了多少分	✅ 可改
流水时间	这笔分产生的时间	❌ 只读
来源详情	这笔分从哪来的文字说明	❌ 只读
修改原因	为什么改这笔账	✅ 可改（改了就该写）
状态	激活 / 失效	✅ 可改
任务名称 / 任务完成日期 / 项目名称	关联的任务和项目	❌ 只读
修改时间	最后一次被改的时间	系统自动记

「积分类别」显示的是中文名（如"任务积分"）。万一显示成一串数字或代码，说明对应的类别字典没取到，一般是网络/权限问题，刷新页面重试；一直这样就找管理员。

状态（三张表通用）

状态	含义
激活	正常生效（账号可用 / 商品上架 / 流水计入）
失效	停用（账号停用 / 商品下架 / 该笔流水作废）

六、常见问题与注意事项

• 「编辑」「删除」按钮是灰的？ 你还没选中任何一行。点行首的圆点（或直接点这一行）选中就亮了。翻页、点查询之后选中会被清空，需要重选。
• 看不到「积分管理」菜单，或者看不到「新增 / 导出」按钮？ 不是功能没有，是权限没开——积分管理是管理员页面。没有权限时按钮不显示，请联系项目管理员开通。
• 时间区间选了没反应？ 分两种：积分账号管理选完区间会自动重查；积分流水管理选完区间必须再点一次「查询」。另外两页刚打开时虽然显示「近30日」，但首屏其实是不带时间过滤的全量。
• 图表页一片空白 / 提示"所选范围暂无积分变化数据"？ 三个可能：① 这段时间确实没人加减分；② 该时段内所有账号都是 0 变化（0 变化的账号故意不画，避免图上一堆贴着 0 的直线）；③ 时间范围选得太窄，换成「近90日」再看。
• 图表提示加载失败？ 换个时间区间重试；一直失败请把当时选的时间范围告诉管理员。
• 想把某人的积分直接改成 100 分怎么做？ 在积分账号管理里选中他 → 编辑 → 改「当前积分」。但更推荐先去流水里找出错账修正——直接改余额，账本上是查不出原因的。
• 改了流水，余额没跟着变？ （待核实：余额是否即时重算。）先隔一会儿回积分账号页刷新看看，还是对不上就找管理员。
• 商品按"类型"筛不全？ 因为商品类型是手工输入的自由文本，"实物"和"实物类"在系统看来是两种类型。团队内先约定好写法。
• 折扣填不上 1 以上的数？ 对，折扣上限就是 1.00，这里的折扣是"打几折"的系数，不是加价倍率。
• 商品卖完了要不要删？ 不要。把**状态改成「失效」**下架就行，删了历史记录就断了。
• 删除都是真删。 账号、商品、流水的删除都没有回收站、找不回来。能用"失效"解决的，就不要删。
• 一次只能处理一条。 三张表都没有批量选中/批量操作，要处理一批只能一条条来。
• 每页最多 100 条。 数据多的时候建议用筛选条件缩小范围，而不是把每页调到 100 一直翻。
• 导出只有积分账号管理页有，商品和流水页目前没有导出按钮。导出的是当前筛选结果，不是全量。
• 积分的"发放规则"不在这三页。 任务完成发多少分看「积分类别管理」，登录/填日报发多少分看「日常积分管理」——都在同一排顶部页签里。

七、相关功能

• 积分类别管理：定义任务积分的档位（青铜/白银/黄金/钻石这类）和分值，决定任务完成后发多少分。见《积分管理 - 积分类型与日常积分配置》。
• 日常积分管理：给登录、填日报等日常行为配积分值，0 表示不发。同上。
• 我的积分（个人视角）：成员自己看"我攒了多少分、每笔从哪来"，在个人中心。管理员在流水页看到的是全公司的，成员只看得到自己的。
• 我的战绩与勋章墙：积分是六维能力雷达里的一维，也和勋章成就挂钩。
• 任务管理：任务上绑定的积分类型决定了这个任务完成后进多少分到流水里——积分的源头在任务，不在积分页。
• 权限中心：积分管理各页的查看/编辑权限在这里按角色配置（由管理员操作）。