# 社区、协作与市场架构

## 1. 领域边界

```mermaid
flowchart LR
  ID[Identity] --> COMMUNITY[Community]
  ID --> WORKSPACE[Collaboration]
  COMMUNITY --> CATALOG[Marketplace Catalog]
  WORKSPACE --> CATALOG
  CATALOG --> ORDER[Order]
  ORDER --> PAYMENT[Payment]
  PAYMENT --> LEDGER[Ledger and Settlement]
  COMMUNITY --> MOD[Moderation]
  CATALOG --> MOD
  PLUGIN[Plugin Registry] --> CATALOG
  CHARACTER[Character Releases] --> CATALOG
```

社区互动、协作权限、商品目录、订单支付和不可变账务分开建模。点赞数、销量、推荐分数不能成为支付账或许可事实源。

## 2. 社区

### 2.1 内容与互动

- 用户主页、关注关系和可见性；
- 动态、文章、图片、音视频和作品集合；
- 评论、回复、点赞、收藏、标签和分享；
- 搜索、话题、推荐流、趋势和通知；
- 屏蔽、静音、举报、审核、申诉和处置历史。

### 2.2 角色社区

角色、世界设定、知识库、工作流、Prompt、Live2D、3D、声音和插件都以**发布版本**进入社区：

- 草稿与已发布版本分离；
- 每版保存来源、作者、许可证、兼容版本和变更说明；
- Fork 创建谱系边，不冒充原作者或同一角色身份；
- 下架阻止新分发，但既有许可副本按许可与安全处置规则处理；
- 角色私密记忆、关系和会话永不随公开角色版本发布。

## 3. 搜索与推荐

- 搜索索引是派生数据，可从公开内容和许可元数据重建。
- 推荐使用显式互动、内容特征和用户可控偏好；私密消息、敏感记忆、精确位置和诊断内容不作为特征。
- 用户可以查看主要推荐原因、关闭个性化和重置推荐数据。
- 反指标包括成瘾诱导、付费偏置未披露、未成年人不当内容和小创作者系统性不可见。

## 4. 内容治理

```mermaid
stateDiagram-v2
  [*] --> draft
  draft --> published
  published --> limited
  published --> removed
  limited --> published
  limited --> removed
  removed --> appealed
  appealed --> published
  appealed --> removed
```

Policy 覆盖：违法内容、现实人物冒充、声音/肖像许可、成人内容、骚扰、隐私、恶意插件、版权和交易欺诈。自动模型只能产生信号或临时限流，高影响永久处置需要可审阅规则和申诉。

## 5. 协作空间

Workspace 包含：

- owner、admin、editor、reviewer、viewer 等 RBAC；
- 邀请、移除、权限变更和外部链接；
- 角色、世界、知识、工作流和资产的版本分支；
- 评审、评论、批准、合并和活动记录；
- 协同编辑 presence、乐观并发或 CRDT；
- 发布权限与市场上架权限分离。

协作者能编辑项目不等于能读取成员私密记忆、个人对话、支付账户或诊断内容。

## 6. 插件注册与分发

插件发布物包含 Manifest、包摘要、签名、权限、依赖、兼容版本、配置 Schema、隐私说明、源代码/许可证信息和安全扫描结果。

状态：draft → submitted → review → published → suspended/removed。更新产生新不可变版本；安全撤架可阻止安装和执行，但不能静默删除历史 Run 的 PluginSnapshot。

## 7. 市场商品与许可

商品类型：角色发布版、角色卡、世界设定、知识库、Prompt/工作流、Live2D、3D、声音、媒体包和插件。

每个 Listing 绑定：

- seller 与可验证发布版本；
- 价格、货币、地区、税类和可售状态；
- 许可证、允许的用途、席位/设备范围、更新政策和退款政策；
- 审核状态、年龄分级、交付对象摘要和内容哈希。

订单成功创建 `entitlement`；下载 URL 只是短期交付方式，不是许可本身。

## 8. 支付、退款与账务

```mermaid
sequenceDiagram
  participant U as Buyer
  participant O as Order Service
  participant P as Payment Provider
  participant W as Webhook Consumer
  participant L as Ledger
  participant E as Entitlement

  U->>O: create order with idempotency key
  O->>P: create payment
  P-->>U: payment confirmation flow
  P-->>W: signed webhook
  W->>W: verify and deduplicate
  W->>L: append payment entries
  L->>E: grant entitlement
  E-->>U: deliver purchased version
```

- 金额使用最小货币单位或 Decimal；
- Ledger 采用复式或等价不可变分录，修正使用反向分录；
- 订单、Provider payment、退款、拒付、平台费、创作者应付和税费分别记录；
- Webhook 不依赖到达顺序，按 Provider event ID 幂等；
- 每日自动对账 Provider 报表、订单和 Ledger；
- 退款更新 entitlement 的后续更新/下载策略，不能删除审计账。

## 9. 创作者结算

- 创作者账户记录 KYC/主体状态、地区、结算币种、税务资料引用和 Provider account；
- 收益先进入 pending，经过退款/拒付准备期后转 available；
- SettlementBatch 生成应付、费用、税款和净额；
- Provider payout 失败可重试，但同一结算批次不能重复付款；
- 提供对账单、发票/税务数据导出、结算历史和争议工单。

敏感 KYC 和银行数据优先由支付 Provider 托管；Hunjing 只保存引用、状态和必要的脱敏信息。