cingulara/openrmf-msg-score

openrmf-msg-score

镜像概述和主要用途

openrmf-msg-score是OpenRMF工具的消息微服务，专注于处理清单（checklist）的保存、更新和删除事件以生成评分。该服务监听特定的NATS消息主题，根据事件类型执行相应操作，并基于类中的Linq查询逻辑完成评分数据的保存或更新。

核心功能和特性

• 监听并处理以下NATS主题消息：
  • openrmf.checklist.save.new
  • openrmf.checklist.save.update
  • openrmf.checklist.delete
  • openrmf.score.read
  • openrmf.scores.system
• 基于.NET Core 3.1构建，支持跨平台运行
• 集成NATS客户端库实现高效消息通信
• 通过Linq查询逻辑处理评分计算与数据更新
• 与MongoDB数据库交互实现评分数据持久化

使用场景和适用范围

适用于OpenRMF工具生态中需要实时响应清单事件并自动生成评分的场景，例如：

• 安全合规检查清单的实时评分更新
• 多团队协作环境下的清单变更同步与评分管理
• 自动化安全评估流程中的评分数据生成与存储

使用方法和配置说明

前置要求

• .NET Core 3.1运行时环境
• NATS服务器（2.x版本及以上）
• MongoDB数据库
• C# NATS客户端库（https://github.com/nats-io/csharp-nats%EF%BC%89

依赖库安装：

bash
dotnet add package NATS.Client
dotnet restore  # 拉取所有依赖库

运行NATS服务器

使用Docker启动NATS服务器（2.1.2版本）：

bash
docker run --rm --name nats-main -p 4222:4222 -p 6222:6222 -p 8222:8222 nats:2.1.2-linux

说明：默认配置为内存运行模式，不包含流处理功能（需单独部署）。

数据库配置

1. 连接MongoDB创建管理员用户：

bash
~/mongodb/bin/mongo 'mongodb://root:myp2ssw0rd@localhost'

2. 切换到admin数据库并创建评分数据库用户：

javascript
use admin
db.createUser({ user: "openrmfscore", pwd: "openrmf1234!", roles: ["readWriteAnyDatabase"] });

3. 创建评分数据库和集合：

javascript
use openrmfscore
db.createCollection("Scores");

构建本地Docker镜像

bash
make build   # 构建镜像
make latest  # 标记为latest版本

数据库操作

连接评分数据库：

bash
~/mongodb/bin/mongo 'mongodb://openrmfscore:openrmf1234!@localhost/openrmfscore?authSource=admin'

查看所有评分数据：

javascript
db.Scores.find();