feat(dashboard): 最近动态改服务端分页
工作台「最近动态」原为聚合端点内嵌、固定截断前 20 条,操作日志变长后 既撑大响应又只能看到头部。改为独立分页端点: - GET /api/v1/dashboard/activities,支持 pageNum/pageSize/module 筛选 - 模块筛选项与列表同源返回(全量模块名,不随翻页变化),前端不必再取一次全量 - 聚合端点去掉内嵌 activities,避免同一份数据两处查询 前端改用 usePagedList + 统一 AppPagination(每页 10/20/50),模块筛选由 本地过滤改为服务端筛选。集成测试 13 例(含翻页不重不漏 / 模块筛选 / 越权 403)。 Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
1 parent
32b7940067
commit
61fe5cca98
7 files changed
+835
-329
No files matched your search
@@ -1,9 +1,13 @@
|
||||
"""工作台的请求/响应模型(M4 ⑧)。
|
||||
|
||||
四区块一次返回(前端一次请求渲染整页,避免 6-10 次往返):
|
||||
经营绩效总览 / 待办事项 / 风险预警 / 最近动态。金额一律 Decimal
|
||||
聚合端点一次返回三区块(前端一次请求渲染整页,避免多次往返):
|
||||
经营绩效总览 / 待办事项 / 风险预警。金额一律 Decimal
|
||||
(序列化为字符串),前端不做数值运算。
|
||||
|
||||
**最近动态独立成分页端点**:它可能有很长(操作日志全量),塞进聚合
|
||||
响应既撑爆页面又只能截断前 20 条;拆开后翻页只重取这张列表,不必
|
||||
重算总览/待办/预警。列表与模块筛选项同源返回(一次请求给全)。
|
||||
|
||||
待办与预警为**查询时实时派生**(不落库、不引调度器,见计划决策);
|
||||
⑥ T+ 同步未建前,同步相关条目用 `sync_available=false` 显式降级,
|
||||
不返回伪造的 0 条。
|
||||
@@ -12,7 +16,9 @@
|
||||
from datetime import date, datetime
|
||||
from decimal import Decimal
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
from pydantic import BaseModel, ConfigDict, Field
|
||||
|
||||
from app.core.response import PageQuery
|
||||
|
||||
|
||||
class TrendPoint(BaseModel):
|
||||
@@ -116,11 +122,42 @@ class ActivityItem(BaseModel):
|
||||
create_time: datetime
|
||||
|
||||
|
||||
class ActivityQuery(PageQuery):
|
||||
"""最近动态查询条件:分页 + 模块筛选。
|
||||
|
||||
只支持模块筛选(工作台只需要这一个维度);其余筛选项见日志查询页。
|
||||
"""
|
||||
|
||||
module: str | None = Field(default=None, max_length=64, description="模块,精确匹配")
|
||||
|
||||
|
||||
class ActivityPageOut(BaseModel):
|
||||
"""最近动态分页结果:当前页 + 总数 + 模块筛选项。
|
||||
|
||||
分页字段名沿用全站规范(list/total/pageNum/pageSize),与
|
||||
`PageResult` 同形;额外带 `modules`(全量模块名),
|
||||
供前端模块下拉使用 —— 不随当前页变化,避免翻页后选项增减。
|
||||
"""
|
||||
|
||||
model_config = ConfigDict(populate_by_name=True)
|
||||
|
||||
records: list[ActivityItem] = Field(
|
||||
default_factory=list, alias="list", serialization_alias="list", description="当前页数据"
|
||||
)
|
||||
total: int = Field(default=0, description="总记录数")
|
||||
page_num: int = Field(
|
||||
default=1, alias="pageNum", serialization_alias="pageNum", description="当前页码"
|
||||
)
|
||||
page_size: int = Field(
|
||||
default=10, alias="pageSize", serialization_alias="pageSize", description="每页条数"
|
||||
)
|
||||
modules: list[str] = Field(default_factory=list, description="全部模块名(筛选项)")
|
||||
|
||||
|
||||
class DashboardOut(BaseModel):
|
||||
"""工作台四区块一次性响应。"""
|
||||
"""工作台三区块一次性响应(最近动态走独立分页端点)。"""
|
||||
|
||||
month: str
|
||||
overview: OverviewBlock
|
||||
todos: TodoBlock
|
||||
warnings: WarningBlock
|
||||
activities: list[ActivityItem] = Field(default_factory=list)
|
||||
Reference in new issue
Block a user