Story 1.3: 完善社区树洞核心功能

字数

2524 字

阅读时间

11 分钟

Status

Draft

Story

As a 用户, I want 在安全的社区环境中分享我的想法和获得支持, so that 我能够获得同伴支持并减少孤独感。

Acceptance Criteria

1. AC1: 支持匿名发帖，包含文字、图片、标签选择
2. AC2: 实现抱抱、评论等基础互动功能
3. AC3: 集成风险识别算法，自动标记高风险内容
4. AC4: 支持内容举报和审核机制
5. AC5: 实现个性化内容推荐和关注功能

Tasks / Subtasks

• [ ] Task 1: 实现匿名发帖功能 (AC: 1)

  • [ ] 开发发帖编辑器，支持富文本编辑
  • [ ] 实现图片上传和管理功能
  • [ ] 添加标签选择和自定义标签功能
  • [ ] 实现匿名/化名切换机制
  • [ ] 开发草稿保存和续写功能

• [ ] Task 2: 构建风险识别系统 (AC: 3)

  • [ ] 集成AI内容风险分析算法
  • [ ] 实现情绪温度条和风险评估
  • [ ] 开发风险等级分类（R1-R4）
  • [ ] 添加实时风险扫描和预警
  • [ ] 实现高风险内容的自动干预

• [ ] Task 3: 开发互动功能模块 (AC: 2)

  • [ ] 实现抱抱功能和计数统计
  • [ ] 开发评论系统，支持嵌套回复
  • [ ] 添加收藏功能和收藏管理
  • [ ] 实现点赞和分享功能
  • [ ] 开发互动通知系统

• [ ] Task 4: 建立内容审核机制 (AC: 4)

  • [ ] 实现用户举报功能
  • [ ] 开发审核工作台和流程
  • [ ] 添加内容状态管理（草稿/审核中/已发布/已归档）
  • [ ] 实现违规内容处理机制
  • [ ] 建立审核记录和审计日志

• [ ] Task 5: 实现个性化推荐系统 (AC: 5)

  • [ ] 开发用户兴趣分析算法
  • [ ] 实现基于标签的内容推荐
  • [ ] 添加关注功能和关注管理
  • [ ] 开发热门话题和趋势展示
  • [ ] 实现个性化内容流

• [ ] Task 6: 完善数据模型和服务层 (AC: 1, 2, 3, 4, 5)

  • [ ] 设计和实现forum_posts数据库集合
  • [ ] 创建forum_reactions互动数据集合
  • [ ] 扩展forum.js服务，支持完整社区功能
  • [ ] 实现数据归一化和缓存机制
  • [ ] 完善Mock数据和测试场景

• [ ] Task 7: 实现treeholeModeration云函数 (AC: 3, 4)

  • [ ] 实现主要内容审核逻辑
  • [ ] 集成风险识别算法
  • [ ] 添加举报处理和状态管理
  • [ ] 实现审核工作台API
  • [ ] 添加错误处理和日志记录

• [ ] Task 8: 集成现有功能验证 (Integration Verification)

  • [ ] 验证与treeholeModeration云函数的协作
  • [ ] 测试与今天页社区动态卡的集成
  • [ ] 确认论坛数据正确写入forum_posts数据库集合
  • [ ] 测试高并发情况下的系统稳定性
  • [ ] 验证风险识别的准确性和及时性

• [ ] Task 9: 编写单元测试和集成测试

  • [ ] 为发帖功能编写测试用例
  • [ ] 为风险识别算法编写测试
  • [ ] 编写互动功能测试
  • [ ] 创建审核机制测试
  • [ ] 添加性能和负载测试

Dev Notes

Previous Story Insights

基于前两个故事的情绪打卡和AI建议系统，本故事需要将社区功能与情绪状态深度集成，实现完整的心理健康支持闭环。

Data Models

forum_posts集合设计 [Source: docs/页面文档/页面-树洞.md#数据需求]

• 主要字段：
  • post_id: string - 帖子唯一标识
  • user_id: string - 用户标识（匿名化处理）
  • content: string - 帖子内容
  • tags: array - 标签数组
  • mood_thermometer: number - 情绪温度（1-10）
  • risk_level: string - 风险等级（R1-R4）
  • anonymity_mode: string - 匿名模式（anon/pseudonym）
  • status: string - 帖子状态

forum_reactions互动集合 [Source: docs/页面文档/页面-树洞.md#数据需求]

• 主要字段：
  • reaction_id: string - 互动唯一标识
  • post_id: string - 关联帖子ID
  • user_id: string - 用户标识
  • reaction_type: string - 互动类型（hug/comment/favorite/share）
  • content: string - 互动内容（评论时使用）

risk_signals风险信号集合 [Source: docs/功能文档/功能-树洞发帖与草稿自检.md#数据需求]

• 主要字段：
  • signal_id: string - 信号唯一标识
  • target_type: string - 目标类型（post/comment）
  • target_id: string - 目标ID
  • risk_score: number - 风险评分
  • risk_level: string - 风险等级
  • processed: boolean - 是否已处理

API Specifications

服务层接口扩展 [Source: miniprogram/services/forum.js]

• fetchFeed(params) - 获取帖子列表，支持筛选和排序
• publishPost(params) - 发布帖子，包含风险自检
• getPostDetail(postId) - 获取帖子详情
• getPostComments(params) - 获取评论列表
• submitComment(params) - 提交评论
• toggleInteraction(params) - 互动操作（抱抱、收藏）
• moderateContent(params) - 内容审核
• fetchDrafts(params) - 获取草稿列表

云函数接口 [Source: cloudfunctions/treeholeModeration/index.js]

• action: 'assessRisk' - 评估内容风险
• action: 'moderateContent' - 内容审核
• action: 'processReport' - 处理举报
• action: 'getRecommendations' - 获取推荐内容
• action: 'updatePostStatus' - 更新帖子状态

Component Specifications

发帖编辑器组件 [Source: docs/页面文档/页面-树洞.md#核心业务组件]

• 富文本编辑器支持
• 图片上传和预览
• 情绪温度条选择器
• 标签输入和管理
• 风险自检提示

帖子卡片组件 [Source: docs/页面文档/页面-树洞.md#核心业务组件]

• 帖子摘要展示
• 情绪状态可视化
• 互动统计显示
• 风险等级标识
• 快速操作按钮

互动面板组件 [Source: docs/页面文档/页面-树洞.md#核心业务组件]

• 抱抱功能和计数
• 评论输入和显示
• 收藏和分享按钮
• 举报功能入口

File Locations

新增/修改文件位置 [Source: CLAUDE.md#模块结构图]

• 前端页面：miniprogram/pages/treehole/index.js - 树洞Tab主逻辑
• 分包页面：miniprogram/packages/community/ - 社区功能分包
• 服务层：miniprogram/services/forum.js - 社区服务（已存在，需大幅扩展）
• 云函数：cloudfunctions/treeholeModeration/index.js - 树洞审核（需要完整实现）
• 组件：miniprogram/components/post-editor/, miniprogram/components/post-card/ - 社区组件（新增）
• 数据库：forum_posts, forum_reactions, risk_signals 集合（新增）

Testing Requirements

测试策略 [Source: CLAUDE.md#测试策略]

• 风险识别算法测试：各种风险场景的识别准确性
• 发帖功能测试：包括匿名机制和内容安全
• 互动功能测试：抱抱、评论、收藏等功能
• 审核机制测试：举报处理和内容状态管理
• 性能测试：高并发情况下的系统稳定性

Technical Constraints

安全和隐私要求 [Source: docs/prd.md#技术约束和集成要求]

• 所有用户输入必须验证和过滤
• 匿名机制需要确保用户身份安全
• 风险识别需要及时准确，避免误判
• 内容审核需要遵循相关法规要求

性能要求 [Source: docs/prd.md#非功能需求]

• 系统响应时间必须在2秒内完成基础操作
• 支持至少1000并发用户
• 数据库查询响应时间小于500ms
• 风险识别需要在发帖时实时完成

内容安全要求

• 集成微信内容安全接口
• 建立敏感词过滤机制
• 实现人工审核工作流
• 遵循社区规范和法律法规

Integration Strategy

AI风险识别集成 [Source: docs/功能文档/功能-树洞风险提示与温和守护.md]

• 集成Dify工作流进行风险分析
• 实现多级风险评估和响应机制
• 与SOS系统联动，处理高风险事件
• 建立风险信号记录和追踪

情绪数据关联

• 与情绪打卡数据关联，提供个性化支持
• 基于情绪状态推荐相关内容
• 支持从情绪状态快速发帖求助
• 实现情绪趋势分析和预警

Testing

Testing Standards

测试文件位置 [Source: CLAUDE.md#测试策略]

• 单元测试：miniprogram/services/__tests__/forum.test.js
• 云函数测试：cloudfunctions/treeholeModeration/__tests__/index.test.js
• 组件测试：miniprogram/components/__tests__/post-*.test.js
• 集成测试：__tests__/integration/treehole-workflow.test.js
• 风险识别测试：__tests__/integration/risk-detection.test.js

测试框架和模式

• 使用Jest进行单元测试
• 模拟AI风险识别API进行隔离测试
• 使用Mock数据覆盖各种场景
• 性能测试模拟高并发场景

具体测试要求

• 发帖功能的完整流程测试
• 风险识别算法的准确性测试
• 各种互动功能的边界条件测试
• 审核机制的流程完整性测试
• 匿名机制的安全性测试

Change Log

Date	Version	Description	Author
2025-10-18	1.0	初始版本创建	Winston (Architect)

Dev Agent Record

Agent Model Used

(待开发时填写)

Debug Log References

(待开发时填写)

Completion Notes List

(待开发时填写)

File List

(待开发时填写)

QA Results

(待QA测试时填写)

贡献者

Cai Hongyu

文件历史

最后编辑于 11 个月前查看完整历史

8d893-docs(MindGuard): 新增架构文档和用户故事集