feat(phase4): 全部业务模块迁移到 modules/（结构迁移）

- 21 个模块目录（auth/system/dictionary/configuration/cms/member/region/link/notice/job/log/upload/index）
- 每个模块 router.py（合并模块导出多个 router）/schemas.py/service.py/repository.py/models.py
- routers/v1.py 与 routers/__init__.py 改为直接引用 modules，前缀与权限串原样保留
- core/middleware.py 懒加载指向 modules.system.menu / modules.log；core/redis_client.py 指向 modules.job.scheduler
- apps/views|services|forms 全部改为 re-export 垫片
- 迁移后 grep 守门通过：modules/core 无 apps/extensions 残留引用
- 实测登录、27+ 模块接口、写操作 commit、操作日志落库均正常

Co-Authored-By: Claude <noreply@anthropic.com>

modules/cms/ad/repository.py

@@ -0,0 +1,9 @@
+# +========== 迁移新增：本模块 Repository 层
+"""modules/cms/ad 数据访问层。"""
+from modules.cms.ad.models import Ad
+from shared.base_repository import BaseRepository
+
+class AdRepository(BaseRepository[Ad]):
+    pass
+
+ad_repo = AdRepository(Ad)

modules/cms/ad/router.py

@@ -0,0 +1,95 @@
+import asyncio
+
+from fastapi import APIRouter, Request
+
+from modules.cms.ad.schemas import AdForm, AdStatusForm
+from core.middleware import check_demo
+from core.middleware import permission_required
+from modules.cms.ad import service as ad
+
+from core import R
+from utils.request import parse_batch_ids
+
+# 创建路由
+router = APIRouter()
+
+
+# 查询分页数据
+@router.get('/page', summary='查询广告分页数据')
+@permission_required("sys:ad:page")
+def page(request: Request):
+    # 调用查询分页数据服务方法
+    result = ad.get_ad_page(request)
+    # 返回结果
+    return result
+
+
+# 查询广告详情
+@router.get('/detail/{id}', summary='查询广告详情')
+@permission_required("sys:ad:detail")
+def detail(request: Request, id):
+    # 调用查询广告详情服务方法
+    data = ad.get_ad_detail(id)
+    # 返回结果
+    return R.ok(data=data)
+
+
+# 添加广告
+@router.post('/add', summary='添加广告')
+@permission_required("sys:ad:add")
+@check_demo
+def add(request: Request, data: AdForm):
+    # 调用添加广告服务
+    result = ad.add_ad(request, data)
+    # 返回结果
+    return result
+
+
+# 更新广告
+@router.put('/update', summary='更新广告')
+@permission_required("sys:ad:update")
+@check_demo
+def update(request: Request, data: AdForm):
+    # 调用更新广告服务方法
+    result = ad.update_ad(request, data)
+    # 返回结果
+    return result
+
+
+# 删除广告
+@router.delete('/delete/{id}', summary='删除广告')
+@permission_required("sys:ad:delete")
+@check_demo
+def delete(request: Request, id):
+    # 调用删除广告服务方法
+    result = ad.delete_ad(id)
+    # 返回结果
+    return result
+
+
+# 设置广告状态
+@router.put('/status', summary='设置广告状态')
+@permission_required("sys:ad:status")
+@check_demo
+def status(request: Request, data: AdStatusForm):
+    # 调用设置广告状态服务方法
+    result = ad.update_ad_status(request, data)
+    # 返回结果
+    return result
+
+
+# 批量删除广告
+@router.delete('/batchDelete', summary='批量删除广告')
+@permission_required("sys:ad:batch_delete")
+@check_demo
+async def batch_delete(request: Request):
+    """
+    批量删除广告
+
+    Request Body:
+        [1, 2, 3]  # 广告ID数组
+    """
+    id_str, err = await parse_batch_ids(request)
+    if err:
+        return err
+    return await asyncio.to_thread(ad.delete_ad, id_str)

modules/cms/ad/schemas.py

@@ -0,0 +1,44 @@
+from datetime import datetime
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+# 广告表单验证
+class AdForm(BaseModel):
+    # 广告ID
+    id: Optional[int] = Field(None, description="广告ID")
+    # 广告标题
+    title: str = Field(..., min_length=1, max_length=255, description="广告标题")
+    # 广告位ID
+    sort_id: int = Field(..., ge=0, description="广告位ID")
+    # 广告类型：1-图片 2-文字 3-视频 4-推荐
+    type: int = Field(..., ge=1, le=4, description="广告类型")
+    # 广告封面
+    cover: Optional[str] = Field(None, max_length=255, description="广告封面")
+    # 广告URL
+    url: str = Field(..., min_length=1, max_length=255, description="广告URL")
+    # 广告宽度
+    width: int = Field(..., ge=0, description="广告宽度")
+    # 广告高度
+    height: int = Field(..., ge=0, description="广告高度")
+    # 开始时间
+    start_time: datetime = Field(..., description="开始时间")
+    # 结束时间
+    end_time: datetime = Field(..., description="结束时间")
+    # 广告状态
+    status: int = Field(..., ge=1, le=2, description="广告状态")
+    # 广告排序
+    sort: int = Field(..., ge=0, le=99999, description="广告排序")
+    # 广告备注
+    note: Optional[str] = Field(None, max_length=255, description="广告备注")
+    # 广告内容
+    content: Optional[str] = Field(None, description="广告内容")
+
+
+# 设置状态表单
+class AdStatusForm(BaseModel):
+    # 广告ID
+    id: int = Field(..., gt=0, description="广告ID")
+    # 广告状态
+    status: int = Field(..., ge=1, le=2, description="广告状态")

modules/cms/ad/service.py

@@ -0,0 +1,184 @@
+from datetime import datetime, timezone
+
+from fastapi.logger import logger
+from sqlalchemy import and_
+
+
+from shared.enums import AD_TYPE_LIST
+from shared.constants import PAGE_SIZE
+from modules.cms.ad.schemas import AdForm, AdStatusForm
+from modules.cms.ad.models import Ad
+from modules.cms.ad_sort.models import AdSort
+from config import FASTAPI_IMAGE_URL
+from core.database import get_db_session
+from core import R
+from utils.rich_text import get_file_url, save_file, save_content
+from utils.request import like_contains
+from core.security import get_user_id
+
+
+# 查询广告分页数据
+
+def get_ad_page(request):
+    db = get_db_session()
+    # 页码
+    page = int(request.query_params.get("pageNo", 1))
+    # 每页数
+    limit = int(request.query_params.get("pageSize", PAGE_SIZE))
+    # 实例化查询对象
+    query = db.query(Ad).filter(Ad.is_delete == 0)
+    # 广告标题
+    title = request.query_params.get('title')
+    if title:
+        query = query.filter(Ad.title.like(like_contains(title), escape='\\'))
+    # 广告类型：1-图片 2-文字 3-视频 4-推荐
+    type = request.query_params.get('type')
+    if type:
+        query = query.filter(Ad.type == type)
+    # 广告状态
+    status = request.query_params.get('status')
+    if status:
+        query = query.filter(Ad.status == status)
+    # 排序
+    query = query.order_by(Ad.sort.desc())
+    # 记录总数
+    count = query.count()
+    # 分页查询
+    ad_list = query.limit(limit).offset((page - 1) * limit).all()
+    # 若当前页超出末页（数据被并发删除），自动回退到第一页
+    if page > 1 and not ad_list:
+        page = 1
+        count = query.count()
+        ad_list = query.limit(limit).offset(0).all()
+    # 实例化结果
+    result = []
+    # 遍历数据源
+    if len(ad_list) > 0:
+        for item in ad_list:
+            # 对象转字典
+            data = item.to_dict()
+            # 广告类型
+            data['type_name'] = AD_TYPE_LIST.get(item.type)
+            # 广告封面
+            data['cover'] = get_file_url(item.cover) if item.cover else None
+            # 查询广告位信息
+            ad_sort = db.query(AdSort).filter(and_(AdSort.id == item.sort_id, AdSort.is_delete == 0)).first()
+            # 广告位描述
+            data['sort_desc'] = ad_sort.name + "=>" + str(ad_sort.loc_id) if ad_sort else None
+            # 加入列表
+            result.append(data)
+    # 返回结果
+    return R.ok(data=result, count=count)
+# 根据广告ID查询详情
+
+def get_ad_detail(ad_id):
+    db = get_db_session()
+    # 根据广告ID查询信息
+    ad = db.query(Ad).filter(and_(Ad.id == ad_id, Ad.is_delete == 0)).first()
+    # 查询结果为空判断
+    if not ad:
+        return None
+    # 对象转字典
+    data = ad.to_dict()
+    # 广告类型描述
+    data['type_name'] = AD_TYPE_LIST.get(ad.type)
+    # 广告封面
+    data['cover'] = get_file_url(ad.cover) if ad.cover else ""
+    # # 富文本内容
+    # content = ad.content.replace("[IMG_URL]", FASTAPI_IMAGE_URL)
+    # data['content'] = content
+    # 返回结果
+    return data
+# 添加广告
+
+def add_ad(request, data: AdForm):
+    db = get_db_session()
+    # 广告封面
+    cover = data.cover
+    if data.type == 1 and cover:
+        cover = save_file(cover, "ad")
+    else:
+        cover = None
+
+    # # 广告标题
+    # title = data.title
+    # # 广告内容
+    # content = data.content
+    # # 处理富文本内容
+    # content = save_content(content, title, "ad")
+
+    # 表单数据赋值给对象
+    ad = Ad(**data.model_dump(exclude={'id'}))
+    ad.cover = cover
+    ad.create_user = get_user_id(request)
+    # 插入数据
+    ad.save()
+    # 返回结果
+    return R.ok(msg="添加成功")
+
+
+# 更新广告
+
+def update_ad(request, data: AdForm):
+    db = get_db_session()
+    # 记录ID判空
+    if not data.id or data.id <= 0:
+        return R.failed("记录ID不能为空")
+    # 根据ID查询记录
+    ad = db.query(Ad).filter(and_(Ad.id == data.id, Ad.is_delete == 0)).first()
+    # 查询结果判空
+    if not ad:
+        return R.failed("记录不存在")
+
+    # 广告封面
+    cover = data.cover
+    if data.type == 1 and cover:
+        cover = save_file(cover, "ad")
+    else:
+        cover = None
+
+    # # 广告标题
+    # title = data.title
+    # # 广告内容
+    # content = data.content
+    # # 处理富文本内容
+    # content = save_content(content, title, "ad")
+
+    # 构造更新数据（排除 id）
+    updData = data.model_dump(exclude={'id'})
+    updData['cover'] = cover
+    updData['update_user'] = get_user_id(request)
+    updData['update_time'] = datetime.now(tz=timezone.utc)
+    # 更新记录
+    result = db.query(Ad).filter_by(id=data.id).update(updData)
+    # 提交数据
+    # 返回结果
+    if not result:
+        return R.failed("更新失败")
+    # 返回结果
+    return R.ok(msg="更新成功")
+# 删除广告
+
+def delete_ad(ad_id):
+    return Ad.batch_delete_r(ad_id)
+# 设置状态
+
+def update_ad_status(request, data: AdStatusForm):
+    db = get_db_session()
+    # 根据ID查询记录
+    ad = db.query(Ad).filter(and_(Ad.id == data.id, Ad.is_delete == 0)).first()
+    # 查询结果判空
+    if not ad:
+        return R.failed("记录不存在")
+
+    # 更新记录
+    result = db.query(Ad).filter_by(id=data.id).update({
+        "status": data.status,
+        "update_user": get_user_id(request),
+        "update_time": datetime.now(tz=timezone.utc)
+    })
+    # 提交数据
+    if not result:
+        return R.failed("设置失败")
+    # 返回结果
+    return R.ok(msg="设置成功")

modules/cms/ad_sort/repository.py

@@ -0,0 +1,9 @@
+# +========== 迁移新增：本模块 Repository 层
+"""modules/cms/ad_sort 数据访问层。"""
+from modules.cms.ad_sort.models import AdSort
+from shared.base_repository import BaseRepository
+
+class AdSortRepository(BaseRepository[AdSort]):
+    pass
+
+adsort_repo = AdSortRepository(AdSort)

modules/cms/ad_sort/router.py

@@ -0,0 +1,93 @@
+import asyncio
+
+from fastapi import APIRouter, Request
+
+from modules.cms.ad_sort.schemas import AdSortForm
+from core.middleware import check_demo
+from core.middleware import permission_required
+from modules.cms.ad_sort import service as ad_sort
+
+from core import R
+from utils.request import parse_batch_ids
+
+# 创建路由
+router = APIRouter()
+
+
+# 查询分页数据
+@router.get('/page', summary='查询广告位分页数据')
+@permission_required("sys:adsort:page")
+def page(request: Request):
+    # 调用查询分页数据服务方法
+    result = ad_sort.get_ad_sort_page(request)
+    # 返回结果
+    return result
+
+
+# 查询广告位详情
+@router.get('/detail/{id}', summary='查询广告位详情')
+@permission_required("sys:adsort:detail")
+def detail(request: Request, id):
+    # 调用查询广告位详情服务方法
+    data = ad_sort.get_ad_sort_detail(id)
+    # 返回结果
+    return R.ok(data=data)
+
+
+# 添加广告位
+@router.post('/add', summary='添加广告位')
+@permission_required("sys:adsort:add")
+@check_demo
+def add(request: Request, data: AdSortForm):
+    # 调用添加广告位服务
+    result = ad_sort.add_ad_sort(request, data)
+    # 返回结果
+    return result
+
+
+# 更新广告位
+@router.put('/update', summary='更新广告位')
+@permission_required("sys:adsort:update")
+@check_demo
+def update(request: Request, data: AdSortForm):
+    # 调用更新广告位服务方法
+    result = ad_sort.update_ad_sort(request, data)
+    # 返回结果
+    return result
+
+
+# 删除广告位
+@router.delete('/delete/{id}', summary='删除广告位')
+@permission_required("sys:adsort:delete")
+@check_demo
+def delete(request: Request, id):
+    # 调用删除广告位服务方法
+    result = ad_sort.delete_ad_sort(id)
+    # 返回结果
+    return result
+
+
+# 获取广告位列表
+@router.get('/getAdSortList', summary='获取广告位列表')
+def get_ad_sort_list():
+    # 调用广告位服务方法
+    result = ad_sort.get_ad_sort_list()
+    # 返回结果
+    return R.ok(result)
+
+
+# 批量删除广告位
+@router.delete('/batchDelete', summary='批量删除广告位')
+@permission_required("sys:adsort:batch_delete")
+@check_demo
+async def batch_delete(request: Request):
+    """
+    批量删除广告位
+
+    Request Body:
+        [1, 2, 3]  # 广告位ID数组
+    """
+    id_str, err = await parse_batch_ids(request)
+    if err:
+        return err
+    return await asyncio.to_thread(ad_sort.delete_ad_sort, id_str)

modules/cms/ad_sort/schemas.py

@@ -0,0 +1,23 @@
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+# 广告位表单验证
+class AdSortForm(BaseModel):
+    # 广告位ID
+    id: Optional[int] = Field(None, description="广告位ID")
+    # 广告位名称
+    name: str = Field(..., min_length=1, max_length=255, description="广告位名称")
+    # 站点ID
+    item_id: Optional[int] = Field(None, description="站点ID")
+    # 栏目ID
+    cate_id: Optional[int] = Field(None, description="栏目ID")
+    # 广告位置
+    loc_id: int = Field(..., ge=0, description="广告位置")
+    # 投放平台：1-PC站 2-WAP站 3-微信小程序 4-APP应用
+    platform: int = Field(..., ge=1, le=4, description="投放平台")
+    # 广告位描述
+    description: str = Field(..., min_length=1, max_length=255, description="广告位描述")
+    # 广告位排序
+    sort: int = Field(..., ge=0, le=99999, description="广告位排序")

modules/cms/ad_sort/service.py

@@ -0,0 +1,141 @@
+from datetime import datetime, timezone
+
+from fastapi.logger import logger
+from sqlalchemy import and_
+
+
+from shared.enums import AD_SORT_PLATFORM_LIST
+from shared.constants import PAGE_SIZE
+from modules.cms.ad_sort.schemas import AdSortForm
+from modules.cms.ad_sort.models import AdSort
+from modules.cms.item.models import Item
+from modules.cms.item_cate.models import ItemCate
+from core.database import get_db_session
+from core import R
+from core.security import get_user_id
+from utils.request import like_contains
+
+
+# 获取广告位分页数据
+
+def get_ad_sort_page(request):
+    db = get_db_session()
+    # 页码
+    page = int(request.query_params.get("pageNo", 1))
+    # 每页数
+    limit = int(request.query_params.get("pageSize", PAGE_SIZE))
+    # 实例化查询对象
+    query = db.query(AdSort).filter(AdSort.is_delete == 0)
+    # 名称
+    name = request.query_params.get('name')
+    if name:
+        query = query.filter(AdSort.name.like(like_contains(name), escape='\\'))
+    # 投放平台：1PC站 2WAP站 3微信小程序 4APP应用
+    platform = request.query_params.get('platform')
+    if platform:
+        query = query.filter(AdSort.platform == platform)
+    # 栏目状态筛选
+    status = request.query_params.get('status')
+    if status:
+        query = query.filter(AdSort.status == status)
+    # 排序
+    query = query.order_by(AdSort.sort.asc())
+    # 记录总数
+    count = query.count()
+    # 分页查询
+    ad_sort_list = query.limit(limit).offset((page - 1) * limit).all()
+    # 若当前页超出末页（数据被并发删除），自动回退到第一页
+    if page > 1 and not ad_sort_list:
+        page = 1
+        count = query.count()
+        ad_sort_list = query.limit(limit).offset(0).all()
+    # 实例化结果
+    result = []
+    # 遍历数据源
+    if len(ad_sort_list) > 0:
+        for v in ad_sort_list:
+            # 对象转字典
+            data = v.to_dict()
+            # 投放平台
+            data['platform_name'] = AD_SORT_PLATFORM_LIST.get(v.platform)
+            # 站点信息
+            item_info = db.query(Item).filter(and_(Item.id == v.item_id, Item.is_delete == 0)).first()
+            data['item_name'] = item_info.name if item_info else None
+            # 栏目信息
+            cate_info = db.query(ItemCate).filter(and_(ItemCate.id == v.cate_id, ItemCate.is_delete == 0)).first()
+            data['cate_name'] = cate_info.name if cate_info else None
+            # 加入列表
+            result.append(data)
+    # 返回结果
+    return R.ok(data=result, count=count)
+# 根据ID查询广告位详情
+
+def get_ad_sort_detail(adsort_id):
+    db = get_db_session()
+    # 根据ID查询广告位
+    adsort = db.query(AdSort).filter(and_(AdSort.id == adsort_id, AdSort.is_delete == 0)).first()
+    # 查询结果为空判断
+    if not adsort:
+        return None
+    # 对象转字典
+    data = adsort.to_dict()
+    # 返回结果
+    return data
+# 添加广告位
+
+def add_ad_sort(request, data: AdSortForm):
+    db = get_db_session()
+    # 表单数据赋值给对象
+    adsort = AdSort(**data.model_dump(exclude={'id'}))
+    adsort.create_user = get_user_id(request)
+    # 插入数据
+    adsort.save()
+    # 返回结果
+    return R.ok(msg="添加成功")
+
+
+# 更新广告位
+
+def update_ad_sort(request, data: AdSortForm):
+    db = get_db_session()
+    # 记录ID判空
+    if not data.id or data.id <= 0:
+        return R.failed("记录ID不能为空")
+
+    # 根据ID查询记录
+    adsort = db.query(AdSort).filter(and_(AdSort.id == data.id, AdSort.is_delete == 0)).first()
+    # 查询结果判空
+    if not adsort:
+        return R.failed("记录不存在")
+    # 构造更新数据（排除 id）
+    updData = data.model_dump(exclude={'id'})
+    updData['update_user'] = get_user_id(request)
+    updData['update_time'] = datetime.now(tz=timezone.utc)
+    result = db.query(AdSort).filter_by(id=data.id).update(updData)
+    # 提交数据
+    if not result:
+        return R.failed("更新失败")
+    # 返回结果
+    return R.ok(msg="更新成功")
+# 删除广告位
+
+def delete_ad_sort(adsort_id):
+    return AdSort.batch_delete_r(adsort_id)
+# 查询广告位列表
+
+def get_ad_sort_list():
+    db = get_db_session()
+    # 查询全部广告位列表
+    ad_sort_list = db.query(AdSort).filter(AdSort.is_delete == 0).all()
+    # 实例化广告位对象列表
+    sortList = []
+    if ad_sort_list:
+        for v in ad_sort_list:
+            item = {
+                'id': v.id,
+                'description': v.description + "=>" + str(v.loc_id)
+            }
+            # 加入列表
+            sortList.append(item)
+    # 返回结果
+    return sortList

modules/cms/item/repository.py

@@ -0,0 +1,9 @@
+# +========== 迁移新增：本模块 Repository 层
+"""modules/cms/item 数据访问层。"""
+from modules.cms.item.models import Item
+from shared.base_repository import BaseRepository
+
+class ItemRepository(BaseRepository[Item]):
+    pass
+
+item_repo = ItemRepository(Item)

modules/cms/item/router.py

@@ -0,0 +1,93 @@
+import asyncio
+
+from fastapi import APIRouter, Request
+
+from modules.cms.item.schemas import ItemForm
+from core.middleware import check_demo
+from core.middleware import permission_required
+from modules.cms.item import service as item
+
+from core import R
+from utils.request import parse_batch_ids
+
+# 创建路由
+router = APIRouter()
+
+
+# 查询分页数据
+@router.get('/page', summary='查询分页数据')
+@permission_required("sys:item:page")
+def page(request: Request):
+    # 调用查询分页数据服务方法
+    result = item.get_item_page(request)
+    # 返回结果
+    return result
+
+
+# 查询站点详情
+@router.get('/detail/{id}', summary='查询站点详情')
+@permission_required("sys:item:detail")
+def detail(request: Request, id):
+    # 调用查询站点详情服务方法
+    data = item.get_item_detail(id)
+    # 返回结果
+    return R.ok(data=data)
+
+
+# 添加站点
+@router.post('/add', summary='添加站点')
+@permission_required("sys:item:add")
+@check_demo
+def add(request: Request, data: ItemForm):
+    # 调用添加站点服务
+    result = item.add_item(request, data)
+    # 返回结果
+    return result
+
+
+# 更新站点
+@router.put('/update', summary='更新站点')
+@permission_required("sys:item:update")
+@check_demo
+def update(request: Request, data: ItemForm):
+    # 调用更新站点服务方法
+    result = item.update_item(request, data)
+    # 返回结果
+    return result
+
+
+# 删除站点
+@router.delete('/delete/{id}', summary='删除站点')
+@permission_required("sys:item:delete")
+@check_demo
+def delete(request: Request, id):
+    # 调用删除站点服务方法
+    result = item.delete_item(id)
+    # 返回结果
+    return result
+
+
+# 获取站点列表
+@router.get('/getItemList', summary='获取站点列表')
+def get_item_list():
+    # 调用查询站点数据列表服务方法
+    data = item.get_item_list()
+    # 返回结果
+    return R.ok(data=data)
+
+
+# 批量删除站点
+@router.delete('/batchDelete', summary='批量删除站点')
+@permission_required("sys:item:batch_delete")
+@check_demo
+async def batch_delete(request: Request):
+    """
+    批量删除站点
+
+    Request Body:
+        [1, 2, 3]  # 站点ID数组
+    """
+    id_str, err = await parse_batch_ids(request)
+    if err:
+        return err
+    return await asyncio.to_thread(item.delete_item, id_str)

modules/cms/item/schemas.py

@@ -0,0 +1,15 @@
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+# 站点表单验证
+class ItemForm(BaseModel):
+    id: Optional[int] = Field(None, description="站点ID")
+    name: str = Field(..., min_length=1, max_length=150, description="站点名称")
+    type: int = Field(..., ge=1, le=2, description="站点类型")
+    url: str = Field(..., min_length=1, max_length=255, description="站点URL")
+    image: str = Field(..., min_length=1, max_length=255, description="站点图片")
+    status: int = Field(..., ge=1, le=2, description="站点状态")
+    sort: int = Field(..., ge=0, le=99999, description="站点排序")
+    note: Optional[str] = Field(None, max_length=255, description="站点备注")
+

modules/cms/item/service.py

@@ -0,0 +1,154 @@
+from datetime import datetime, timezone
+
+from fastapi.logger import logger
+from sqlalchemy import and_
+
+
+from shared.enums import ITEM_TYPE_LIST
+from shared.constants import PAGE_SIZE
+from modules.cms.item.schemas import ItemForm
+from modules.cms.item.models import Item
+from core.database import get_db_session
+from core import R
+from utils.rich_text import get_file_url, save_file
+from utils.request import like_contains
+from core.security import get_user_id
+
+
+# 查询站点分页数据
+
+def get_item_page(request):
+    db = get_db_session()
+    # 页码
+    page = int(request.query_params.get("pageNo", 1))
+    # 每页数
+    limit = int(request.query_params.get("pageSize", PAGE_SIZE))
+    # 实例化查询对象
+    query = db.query(Item).filter(Item.is_delete == 0)
+    # 站点名称
+    name = request.query_params.get('name')
+    if name:
+        query = query.filter(Item.name.like(like_contains(name), escape='\\'))
+    # 站点类型
+    type = request.query_params.get('type')
+    if type:
+        query = query.filter(Item.type == type)
+    # 站点状态筛选
+    status = request.query_params.get('status')
+    if status:
+        query = query.filter(Item.status == status)
+    # 排序
+    query = query.order_by(Item.sort.asc())
+    # 记录总数
+    count = query.count()
+    # 分页查询
+    item_list = query.limit(limit).offset((page - 1) * limit).all()
+    # 若当前页超出末页（数据被并发删除），自动回退到第一页
+    if page > 1 and not item_list:
+        page = 1
+        count = query.count()
+        item_list = query.limit(limit).offset(0).all()
+    # 实例化结果
+    result = []
+    # 遍历数据源
+    if len(item_list) > 0:
+        for item in item_list:
+            # 对象转字典
+            data = item.to_dict()
+            # 站点图片
+            data['image'] = get_file_url(item.image)
+            # 站点类型描述
+            data['type_name'] = ITEM_TYPE_LIST.get(item.type)
+            # 加入列表
+            result.append(data)
+    # 返回结果
+    return R.ok(data=result, count=count)
+# 根据ID查询站点详情
+
+def get_item_detail(item_id):
+    db = get_db_session()
+    # 根据ID查询站点
+    item = db.query(Item).filter(and_(Item.id == item_id, Item.is_delete == 0)).first()
+    # 查询结果判空
+    if not item:
+        return None
+    # 对象转字典
+    data = item.to_dict()
+    # 站点图片
+    data['image'] = get_file_url(item.image)
+    # 返回结果
+    return data
+# 添加站点
+
+def add_item(request, data: ItemForm):
+    db = get_db_session()
+    # 唯一性校验
+    if db.query(Item).filter(and_(Item.name == data.name, Item.is_delete == 0)).first():
+        return R.failed("站点名称不能重复")
+    # 表单数据转字典
+    form_data = data.model_dump(exclude={'id'})
+    # 站点图片
+    image = data.image
+    if image:
+        form_data['image'] = save_file(image, "item")
+
+    # 表单数据赋值给对象
+    item = Item(**form_data)
+    item.create_user = get_user_id(request)
+    # 插入数据
+    item.save()
+    # 返回结果
+    return R.ok(msg="添加成功")
+
+
+# 更新站点
+
+def update_item(request, data: ItemForm):
+    db = get_db_session()
+    # 记录ID判空
+    if not data.id or data.id <= 0:
+        return R.failed("记录ID不能为空")
+    # 唯一性校验（排除自身）
+    if db.query(Item).filter(and_(Item.name == data.name, Item.id != data.id, Item.is_delete == 0)).first():
+        return R.failed("站点名称不能重复")
+
+    # 根据ID查询记录
+    item = db.query(Item).filter(and_(Item.id == data.id, Item.is_delete == 0)).first()
+    # 查询结果判空
+    if not item:
+        return R.failed("记录不存在")
+
+    # 构造更新数据（排除 id）
+    updData = data.model_dump(exclude={'id'})
+    # 站点图片
+    image = data.image
+    if image:
+        updData['image'] = save_file(image, "item")
+    updData['update_user'] = get_user_id(request)
+    updData['update_time'] = datetime.now(tz=timezone.utc)
+    # 更新数据
+    result = db.query(Item).filter_by(id=data.id).update(updData)
+    # 提交数据
+    if not result:
+        return R.failed("更新失败")
+    # 返回结果
+    return R.ok(msg="更新成功")
+# 删除站点
+
+def delete_item(item_id):
+    return Item.batch_delete_r(item_id)
+# 获取站点列表
+
+def get_item_list():
+    db = get_db_session()
+    item_rows = db.query(Item).filter(and_(Item.status == 1, Item.is_delete == 0)).order_by(Item.sort.asc()).all()
+    # 实例化站点列表
+    item_list = []
+    # 遍历数据源
+    for v in item_rows:
+        # 对象转字典
+        item = v.to_dict()
+        # 加入列表
+        item_list.append(item)
+    # 返回结果
+    return item_list

modules/cms/item_cate/repository.py

@@ -0,0 +1,9 @@
+# +========== 迁移新增：本模块 Repository 层
+"""modules/cms/item_cate 数据访问层。"""
+from modules.cms.item_cate.models import ItemCate
+from shared.base_repository import BaseRepository
+
+class ItemCateRepository(BaseRepository[ItemCate]):
+    pass
+
+itemcate_repo = ItemCateRepository(ItemCate)

modules/cms/item_cate/router.py

@@ -0,0 +1,92 @@
+import asyncio
+
+from fastapi import APIRouter, Request
+
+from modules.cms.item_cate.schemas import ItemCateForm
+from core.middleware import check_demo
+from core.middleware import permission_required
+from modules.cms.item_cate import service as item_cate
+from core import R
+from utils.request import parse_batch_ids
+
+# 创建路由
+router = APIRouter()
+
+
+# 查询分页数据
+@router.get('/page', summary='查询分页数据')
+@permission_required("sys:itemcate:page")
+def page(request: Request):
+    # 调用查询分页数据服务方法
+    result = item_cate.get_item_cate_page(request)
+    # 返回结果
+    return result
+
+
+# 查询栏目详情
+@router.get('/detail/{id}', summary='查询栏目详情')
+@permission_required("sys:itemcate:detail")
+def detail(request: Request, id):
+    # 调用查询栏目详情服务方法
+    data = item_cate.get_item_cate_detail(id)
+    # 返回结果
+    return R.ok(data=data)
+
+
+# 添加栏目
+@router.post('/add', summary='添加栏目')
+@permission_required("sys:itemcate:add")
+@check_demo
+def add(request: Request, data: ItemCateForm):
+    # 调用添加栏目服务
+    result = item_cate.add_item_cate(request, data)
+    # 返回结果
+    return result
+
+
+# 更新栏目
+@router.put('/update', summary='更新栏目')
+@permission_required("sys:itemcate:update")
+@check_demo
+def update(request: Request, data: ItemCateForm):
+    # 调用更新栏目服务方法
+    result = item_cate.update_item_cate(request, data)
+    # 返回结果
+    return result
+
+
+# 删除栏目
+@router.delete('/delete/{id}', summary='删除栏目')
+@permission_required("sys:itemcate:delete")
+@check_demo
+def delete(request: Request, id):
+    # 调用删除栏目服务方法
+    result = item_cate.delete_item_cate(id)
+    # 返回结果
+    return result
+
+
+# 获取栏目列表
+@router.get('/getCateList', summary='获取栏目列表')
+def get_cate_list():
+    # 调用删除栏目服务方法
+    result = item_cate.get_cate_list()
+    # 返回结果
+    return R.ok(result)
+
+
+# 批量删除栏目
+@router.delete('/batchDelete', summary='批量删除栏目')
+@permission_required("sys:itemcate:batch_delete")
+@check_demo
+async def batch_delete(request: Request):
+    """
+    批量删除栏目
+
+    Request Body:
+        [1, 2, 3]  # 栏目ID数组
+    """
+    id_str, err = await parse_batch_ids(request)
+    if err:
+        return err
+    return await asyncio.to_thread(item_cate.delete_item_cate, id_str)

modules/cms/item_cate/schemas.py

@@ -0,0 +1,18 @@
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+# 栏目表单验证
+class ItemCateForm(BaseModel):
+    id: Optional[int] = Field(None, description="栏目ID")
+    name: str = Field(..., min_length=1, max_length=150, description="栏目名称")
+    pid: Optional[int] = Field(None, description="上级ID")
+    item_id: int = Field(..., ge=0, description="站点ID")
+    pinyin: str = Field(..., min_length=1, max_length=150, description="拼音全称")
+    code: str = Field(..., min_length=1, max_length=150, description="拼音简称")
+    is_cover: int = Field(..., ge=1, le=2, description="是否有封面")
+    cover: Optional[str] = Field(None, max_length=255, description="栏目封面")
+    status: int = Field(..., ge=1, le=2, description="栏目状态")
+    sort: int = Field(..., ge=0, le=99999, description="栏目排序")
+    note: Optional[str] = Field(None, max_length=255, description="栏目备注")
+

modules/cms/item_cate/service.py

@@ -0,0 +1,171 @@
+from datetime import datetime, timezone
+
+from fastapi.logger import logger
+from sqlalchemy import and_
+
+
+from shared.constants import PAGE_SIZE
+from modules.cms.item_cate.schemas import ItemCateForm
+from modules.cms.item_cate.models import ItemCate
+from modules.cms.item import service as item
+from core.database import get_db_session
+from core import R
+from utils.rich_text import get_file_url, save_file
+from utils.request import like_contains
+from core.security import get_user_id
+
+
+# 查询栏目数据
+
+def get_item_cate_page(request):
+    db = get_db_session()
+    # 页码
+    page = int(request.query_params.get("pageNo", 1))
+    # 每页数
+    limit = int(request.query_params.get("pageSize", PAGE_SIZE))
+    # 实例化查询对象
+    query = db.query(ItemCate).filter(ItemCate.is_delete == 0)
+    # 栏目名称
+    name = request.query_params.get('name')
+    if name:
+        query = query.filter(ItemCate.name.like(like_contains(name), escape='\\'))
+    # 栏目状态筛选
+    status = request.query_params.get('status')
+    if status:
+        query = query.filter(ItemCate.status == status)
+    # 排序
+    query = query.order_by(ItemCate.sort.asc())
+    # 记录总数
+    count = query.count()
+    # 分页查询
+    item_cate_list = query.limit(limit).offset((page - 1) * limit).all()
+    # 若当前页超出末页（数据被并发删除），自动回退到第一页
+    if page > 1 and not item_cate_list:
+        page = 1
+        count = query.count()
+        item_cate_list = query.limit(limit).offset(0).all()
+    # 实例化结果
+    result = []
+    # 遍历数据源
+    if len(item_cate_list) > 0:
+        for v in item_cate_list:
+            # 对象转字典
+            data = v.to_dict()
+            # 栏目图片
+            data['cover'] = get_file_url(v.cover) if v.cover else None
+            # 查询站点信息
+            item_info = item.get_item_detail(v.id)
+            if item_info:
+                data['item_name'] = item_info.get('name') if item_info else None
+            # 加入列表
+            result.append(data)
+    # 返回结果
+    return R.ok(data=result, count=count)
+# 根据栏目ID查询详情
+
+def get_item_cate_detail(itemcate_id):
+    db = get_db_session()
+    # 根据ID查询栏目
+    cate = db.query(ItemCate).filter(and_(ItemCate.id == itemcate_id, ItemCate.is_delete == 0)).first()
+    # 查询结果判空
+    if not cate:
+        return None
+    # 对象转字典
+    data = cate.to_dict()
+    # 栏目图片
+    if cate.cover:
+        data['cover'] = get_file_url(cate.cover)
+    # 返回结果
+    return data
+# 添加栏目
+
+def add_item_cate(request, data: ItemCateForm):
+    db = get_db_session()
+    # 唯一性校验
+    if db.query(ItemCate).filter(and_(ItemCate.name == data.name, ItemCate.is_delete == 0)).first():
+        return R.failed("栏目名称不能重复")
+    # 表单数据转字典
+    form_data = data.model_dump(exclude={'id'})
+
+    # 是否有封面
+    is_cover = data.is_cover
+    if is_cover == 1:
+        # 栏目图片
+        cover = data.cover
+        # 图片处理
+        if cover:
+            form_data['cover'] = save_file(cover, "item_cate")
+        else:
+            form_data['cover'] = None
+    else:
+        form_data['cover'] = None
+
+    # 表单数据赋值给对象
+    cate = ItemCate(**form_data)
+    cate.create_user = get_user_id(request)
+    # 插入数据
+    cate.save()
+    # 返回结果
+    return R.ok(msg="添加成功")
+
+
+# 更新栏目
+
+def update_item_cate(request, data: ItemCateForm):
+    db = get_db_session()
+    # 记录ID判空
+    if not data.id or data.id <= 0:
+        return R.failed("记录ID不能为空")
+    # 唯一性校验（排除自身）
+    if db.query(ItemCate).filter(and_(ItemCate.name == data.name, ItemCate.id != data.id, ItemCate.is_delete == 0)).first():
+        return R.failed("栏目名称不能重复")
+
+    # 根据ID查询记录
+    cate = db.query(ItemCate).filter(and_(ItemCate.id == data.id, ItemCate.is_delete == 0)).first()
+    # 查询结果判空
+    if not cate:
+        return R.failed("记录不存在")
+
+    # 构造更新数据（排除 id）
+    updData = data.model_dump(exclude={'id'})
+    # 是否有封面
+    is_cover = data.is_cover
+    if is_cover == 1:
+        # 栏目图片
+        cover = data.cover
+        # 图片处理
+        if cover:
+            updData['cover'] = save_file(cover, "item_cate")
+        else:
+            updData['cover'] = None
+    else:
+        updData['cover'] = None
+    updData['update_user'] = get_user_id(request)
+    updData['update_time'] = datetime.now(tz=timezone.utc)
+    # 更新数据
+    result = db.query(ItemCate).filter_by(id=data.id).update(updData)
+    # 提交数据
+    if not result:
+        return R.failed("更新失败")
+    # 返回结果
+    return R.ok(msg="更新成功")
+# 删除栏目
+
+def delete_item_cate(cate_id):
+    return ItemCate.batch_delete_r(cate_id)
+# 获取栏目列表
+
+def get_cate_list():
+    db = get_db_session()
+    cate_rows = db.query(ItemCate).filter(and_(ItemCate.is_delete == 0, ItemCate.status == 1)).order_by(
+        ItemCate.sort.asc()).all()
+    # 实例化栏目列表
+    cate_list = []
+    # 遍历数据源
+    for v in cate_rows:
+        # 对象转字典
+        item = v.to_dict()
+        # 加入列表
+        cate_list.append(item)
+    # 返回结果
+    return cate_list