ClawHub

Teamgram Biz Service

Documents the biz_service core business layer in Teamgram Server with 6 RPC helpers covering user, chat, dialog, message, updates, and verification code management.

Audits

Pass
ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install teamgram-biz-service

业务逻辑层：biz_service（6 个 helper）

概述

biz_service 是一个"组合服务"，在一个 gRPC server 中注册 6 个子服务：

  • RPCChat — 群组/频道管理
  • RPCCode — 验证码管理
  • RPCDialog — 对话管理
  • RPCMessage — 消息构造/权限校验/写DB
  • RPCUpdates — Updates 构造
  • RPCUser — 用户读取/搜索

etcd 注册

它们都以 service.biz_service 注册到 etcd，供 BFF/msg/sync 等发现调用。

典型调用关系

调用方目标 helper场景
BFF.messagesbiz_service.message构造消息/权限校验/写DB
BFF.usersbiz_service.user用户读取/搜索
BFF.contactsbiz_service.user + biz_service.dialog联系人与对话
BFF.chatsbiz_service.chat群/频道管理
BFF.updatesbiz_service.updatesupdates 构造
BFF.authorizationbiz_service.code + biz_service.user登录注册流程

配置

Name: service.biz_service
ListenOn: 127.0.0.1:20500
Etcd:
  Key: service.biz_service
  Hosts:
    - 127.0.0.1:2379
Mysql:
  DSN: root:@tcp(127.0.0.1:3306)/teamgram?charset=utf8mb4&parseTime=true
Cache:
  - Host: 127.0.0.1:6379

6 个 helper 详解

RPCUser

  • 用户注册、查询、搜索
  • 手机号→用户映射
  • 用户资料读写（名字、头像、简介等）
  • 在线状态查询
  • 被调用最频繁的 helper，几乎所有 BFF 模块都依赖

RPCChat

  • 创建/删除群组
  • 群成员管理（添加/删除/设管理员）
  • 群标题/头像/权限设置
  • 群迁移到超级群
  • 群禁言/封禁权限管理

RPCDialog

  • 对话列表查询（分页、筛选）
  • 对话置顶/归档/标记未读
  • 对话未读数管理（read_inbox_max_id / unread_count）
  • 会话 TTL 设置
  • 对话文件夹管理

RPCMessage

  • 消息构造与入库（inbox/outbox 双写模型）
  • 消息权限校验（是否被禁言、是否被屏蔽等）
  • 消息 ID 生成（依赖 idgen 服务的 Snowflake ID）
  • 消息编辑/删除/转发
  • 消息搜索（全文、hashtag）

RPCUpdates

  • Updates 序列号管理（pts/qts/seq）
  • 差异更新构造（getDifference）
  • 状态查询（getState）
  • 确保客户端与服务端状态同步

RPCCode

  • 验证码生成与校验
  • 短信/App code 管理
  • 验证码过期与重试逻辑
  • 支持自定义验证码发送插件（VerifyCodeInterface）

关键代码路径

  • 主服务入口：app/service/biz/
  • 各 helper 实现：app/service/biz/internal/core/
  • DAO 层：app/service/biz/internal/dao/
  • 配置文件：teamgramd/etc/biz_service.yaml

Source Code References