信任分
信任分是 OpenPR 中的用户信誉指标,跟踪参与质量和决策历史。启用加权投票后,信任分直接影响投票权重。
信任分工作原理
每个工作区成员都有反映其治理参与的信任分:
| 因素 | 影响 | 说明 |
|---|---|---|
| 提案质量 | 正面 | 通过的提案增加评分 |
| 投票参与 | 正面 | 定期投票增加评分 |
| 与多数一致 | 正面 | 投票与最终多数一致 |
| 被拒绝的提案 | 负面 | 被拒绝的提案降低评分 |
| 被否决的决策 | 负面 | 提案被否决 |
| 申诉 | 可变 | 成功的申诉恢复评分 |
评分范围
信任分归一化到数值范围。较高分数表示更可靠的治理参与:
| 范围 | 等级 | 投票权重 |
|---|---|---|
| 80-100 | 高信任 | 1.5 倍权重 |
| 50-79 | 正常 | 1.0 倍权重 |
| 20-49 | 低信任 | 0.75 倍权重 |
| 0-19 | 最低 | 0.5 倍权重 |
加权投票
信任分权重仅在工作区治理配置中启用 加权投票 时生效。否则所有投票权重相等。
查看信任分
通过网页 UI
进入 工作区设置 > 治理 > 信任分 查看所有成员评分和历史。
通过 API
bash
# 获取工作区信任分
curl -H "Authorization: Bearer <token>" \
http://localhost:8080/api/trust-scores
# 获取特定用户的信任分历史
curl -H "Authorization: Bearer <token>" \
http://localhost:8080/api/trust-scores/<user_id>/history信任分历史
信任分的每次变更都记录在 trust_score_logs 表中,包含:
- 受影响的用户
- 变更前后的分数
- 变更原因
- 时间戳
- 相关提案或决策(如适用)
历史记录提供了评分如何随时间演变的透明度。
申诉
如果成员认为其信任分受到不公平影响,可以提出申诉:
- 进入其信任分历史。
- 点击特定评分变更的 申诉。
- 提供申诉理由。
- 工作区管理员审查并决定申诉。
成功的申诉恢复评分变更。申诉记录保留在审计日志中。
bash
# 提出申诉
curl -X POST http://localhost:8080/api/trust-scores/<user_id>/appeals \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <token>" \
-d '{"reason": "评分下降是由于测试提案,并非用于生产。"}'影响评审
信任分是 影响评审 的输入之一——评估提案或决策对项目的影响。影响评审包括:
- 定量指标(预估工作量、风险等级、范围)
- 评审参与者的定性评估
- 类似决策的历史数据