신뢰 점수
신뢰 점수는 참여 품질과 의사결정 이력을 추적하는 OpenPR의 사용자별 평판 지표입니다. 가중 투표가 활성화되면 신뢰 점수가 투표 권한에 직접 영향을 미칩니다.
신뢰 점수 작동 방식
각 워크스페이스 멤버는 거버넌스 참여를 반영하는 신뢰 점수를 가집니다:
| 요소 | 영향 | 설명 |
|---|---|---|
| 제안 품질 | 긍정적 | 승인된 제안은 점수를 높임 |
| 투표 참여 | 긍정적 | 정기적인 투표는 점수를 높임 |
| 결정 일치 | 긍정적 | 최종 다수결과 함께 투표 |
| 거부된 제안 | 부정적 | 거부된 제안은 점수를 낮춤 |
| 거부된 결정 | 부정적 | 거부된 제안 보유 |
| 이의 신청 | 가변적 | 성공적인 이의 신청은 점수 복원 |
점수 범위
신뢰 점수는 숫자 범위로 정규화됩니다. 높은 점수는 더 신뢰할 수 있는 거버넌스 참여를 나타냅니다:
| 범위 | 레벨 | 투표 가중치 |
|---|---|---|
| 80-100 | 높은 신뢰 | 1.5x 가중치 |
| 50-79 | 보통 | 1.0x 가중치 |
| 20-49 | 낮은 신뢰 | 0.75x 가중치 |
| 0-19 | 최소 | 0.5x 가중치 |
가중 투표
신뢰 점수 가중치는 워크스페이스 거버넌스 설정에서 가중 투표가 활성화된 경우에만 적용됩니다. 그렇지 않으면 모든 투표가 동일한 가중치를 가집니다.
신뢰 점수 보기
웹 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": "Score decreased due to a test proposal that was not meant for production."}'영향 검토
신뢰 점수는 영향 검토 -- 제안이나 결정이 프로젝트에 미치는 영향의 평가 -- 의 입력값 중 하나입니다. 영향 검토에는 다음이 포함됩니다:
- 정량적 지표 (예상 노력, 위험 수준, 범위)
- 검토 참여자의 정성적 평가
- 유사한 결정의 역사 데이터