sbnews/docs/superpowers/plans/2026-08-02-community-post-channels-and-categories.md

Community Post Channels and Categories Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: 为社区帖子补齐推荐、热门、话题频道管理，并新增独立帖子分类表、管理后台和前台频道筛选。

Architecture: 复用 la_community_post.is_recommend 与 is_hot，只新增 is_topic 和单选 category_id。分类通过独立 la_community_post_category 管理，初始化时复制标签并回填历史帖子；标签多选关系继续保留。后台使用 likeadmin Controller/Logic/Validate/Lists 分层，用户端列表通过现有 /api/community/postLists 参数筛选。

Tech Stack: PHP 8、ThinkPHP/likeadmin、MySQL 8、Vue 3、Element Plus、uni-app、TypeScript

---

Task 1: 数据库结构、初始化数据与菜单权限

Files:

• Create: docs/sql/create_community_post_categories.sql

• Modify: sbnews.sql

• Step 1: 创建独立分类表和帖子字段

SQL 必须幂等创建 la_community_post_category，字段为 id/name/icon/sort/post_count/status/create_time/update_time，并在 la_community_post 增加：

`category_id` int unsigned NOT NULL DEFAULT 0 COMMENT '帖子主分类ID',
`is_topic` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '是否话题 0否 1是'

同时添加 category_id、status + is_recommend、status + is_hot、status + is_topic 查询索引。

• Step 2: 从标签初始化分类并回填历史帖子

分类初始化使用 INSERT IGNORE ... SELECT 保留标签 ID，不覆盖后续独立维护的分类。历史帖子只在 category_id=0 时回填，按标签 sort DESC, community_post_tag.id ASC 选取一个主分类；已有标签的帖子初始化为 is_topic=1 以保持原话题流可见性，最后按实际帖子数重算 post_count。

• Step 3: 初始化管理菜单与按钮权限

新增 community.communityCategory/lists 页面及 detail/add/edit/delete 按钮权限；补充帖子 setRecommend/setTopic/setCategory 权限。所有菜单通过已有社区帖子或标签菜单反查父级，使用 NOT EXISTS 幂等插入，并授权角色 role_id=1。

Task 2: 后端分类管理和帖子管理接口

Files:

• Create: server/app/common/model/community/CommunityCategory.php

• Modify: server/app/common/model/community/CommunityPost.php

• Create: server/app/adminapi/controller/community/CommunityCategoryController.php

• Create: server/app/adminapi/logic/community/CommunityCategoryLogic.php

• Create: server/app/adminapi/validate/community/CommunityCategoryValidate.php

• Create: server/app/adminapi/lists/community/CommunityCategoryLists.php

• Modify: server/app/adminapi/controller/community/CommunityPostController.php

• Modify: server/app/adminapi/logic/community/CommunityPostLogic.php

• Modify: server/app/adminapi/validate/community/CommunityPostValidate.php

• Modify: server/app/adminapi/lists/community/CommunityPostLists.php

• Step 1: 实现分类 CRUD

分类接口沿用标签管理风格：

GET  /adminapi/community.communityCategory/lists
GET  /adminapi/community.communityCategory/all
GET  /adminapi/community.communityCategory/detail
POST /adminapi/community.communityCategory/add
POST /adminapi/community.communityCategory/edit
POST /adminapi/community.communityCategory/delete

分类图标使用 FileService::getFileUrl/setFileUrl；删除前查询 CommunityPost::where('category_id', id)->count()，存在引用时返回“该分类下存在帖子，不能删除”。

• Step 2: 扩展帖子管理字段

帖子列表筛选增加：

'=' => ['status', 'post_type', 'category_id', 'is_top', 'is_hot', 'is_recommend', 'is_topic', 'user_id']

列表和详情批量补充 category_name。新增 setTopic() 与 setCategory()；复用已有 setRecommend()。设置分类和删除帖子后重算受影响分类的 post_count。

• Step 3: 补齐参数校验

is_topic、is_hot、is_recommend 只允许 0/1；category_id 允许 0，大于 0 时必须存在于分类表。控制器继续使用 likeadmin 统一成功/失败响应。

Task 3: 前台帖子频道筛选

Files:

• Modify: server/app/api/lists/community/CommunityPostLists.php

• Modify: uniapp/src/pages/community/community.vue

• Step 1: 后端列表接收频道参数

queryWhere() 对明确传入的值进行过滤：

foreach (['is_recommend', 'is_hot', 'is_topic', 'category_id'] as $field) {
    if (isset($this->params[$field]) && $this->params[$field] !== '') {
        $where[] = [$field, '=', (int) $this->params[$field]];
    }
}

列表字段返回 category_id/is_topic，并批量补充 category_name；排序保持 is_top DESC, is_hot DESC, create_time DESC。

• Step 2: 用户端频道发送真实筛选条件

社区页请求参数调整为：

if (activeFeed.value === 'recommend') params.is_recommend = 1
if (activeFeed.value === 'follow') params.follow = 1
if (activeFeed.value === 'hot') params.is_hot = 1
if (activeFeed.value === 'topic') params.is_topic = 1
if (activeTagId.value > 0) params.tag_id = activeTagId.value

移除仅对当前页进行热门分数排序的 rankHotPosts()，防止分页结果与后台热门开关不一致。

Task 4: 管理端分类页面和帖子字段管理

Files:

• Create: admin/src/views/community/category/index.vue

• Modify: admin/src/api/community.ts

• Modify: admin/src/views/community/post/index.vue

• Step 1: 新增分类 API 和管理页

API 增加分类 lists/all/detail/add/edit/delete。分类页复用标签页布局，支持名称搜索、图标、排序、状态、新增、编辑和受保护删除。

• Step 2: 补齐帖子 API

新增调用：

communityPostSetRecommend({ id, is_recommend })
communityPostSetTopic({ id, is_topic })
communityPostSetCategory({ id, category_id })

• Step 3: 扩展帖子列表管理

搜索区增加分类、推荐、热门、话题筛选；表格增加分类单选框，以及推荐、热门、话题三个开关。接口失败时重新获取列表恢复服务端真实值，详情弹窗展示分类和三个频道状态。

Task 5: Review、静态验证、提交与测试服同步

Files:

• Modify: docs/业务进度管理.md

• Create: docs/superpowers/plans/2026-08-02-community-post-channels-and-categories.md

• Step 1: 静态检查

运行所有修改 PHP 文件的 php -l、git diff --check、SQL 未完成标记扫描，并检查 Controller/Logic/Validate/Lists/Model/Admin API 字段名称一致。项目未授权执行完整构建或自动化测试。

• Step 2: 前端代码 review

检查管理端请求失败回滚、权限标识、选择器数值类型、分页筛选参数和用户端频道切换请求，确认不存在客户端分页内伪排序或未使用导入。

• Step 3: 提交源码

只暂存本任务文件，排除工作区原有 AGENTS.md 和共享文档混合改动，提交信息：

feat: add community post categories and channels

• Step 4: 同步测试服并应用数据库初始化

先执行项目规定部署命令：

Set-Location D:\www\gs-sport-era; powershell -ExecutionPolicy Bypass -File .\scripts\deploy-server.ps1 -Sudo -AutoIncremental -AutoIncrementalCommits 3 -RemoteDir /www/wwwroot/test-server.sbnews.net

随后在测试服运行幂等 SQL docs/sql/create_community_post_categories.sql，复核分类表、帖子新字段和社区分类菜单已经存在。