OpenCollective项目中的会计类别可见性控制设计

在OpenCollective平台的财务托管功能中，会计类别的可见性控制是一个重要的设计考量。本文将深入分析该功能的业务背景、技术实现思路以及相关注意事项。

业务背景

OpenCollective的财务托管系统允许托管方为支出创建会计分类体系。这些分类主要用于财务核算目的，但同时也需要与支出提交者及集体管理员共享。然而，某些会计分类具有专业财务属性，不适合向非财务人员展示。

核心需求

系统需要区分两类会计分类：

1. 通用分类：可供支出提交者和集体管理员使用
2. 财务专用分类：仅限财务托管方内部使用

技术实现方案

数据模型扩展

建议在会计分类模型中新增布尔型字段hostOnly，默认值为false。该字段控制分类是否仅对财务托管方可见。

接口层调整

API需要针对不同用户角色进行数据过滤：

• 财务托管方管理员：可查看所有分类
• 集体管理员/支出提交者：仅能查看hostOnly=false的分类

前端实现

在会计分类管理界面添加"仅限财务托管方使用"的复选框控件，供财务托管方管理员设置分类可见性。

注意事项

1. 通知系统需要配合调整：当财务托管方选择了不可见的分类时，不应触发相关通知
2. 数据迁移：需要考虑现有分类的默认值设置
3. 权限校验：确保前端和后端都进行了严格的权限验证

用户体验考量

该设计在保证财务专业性的同时，也简化了普通用户的操作界面。财务托管方可以灵活控制哪些分类需要专业知识处理，哪些可以开放给集体自主管理。

这种分层可见性设计既满足了专业财务需求，又保持了平台的易用性，是OpenCollective财务功能演进的重要一步。