refactor(announcements,messaging,notifications): V1+V2 审计重构 — i18n 命名空间独立 + 通知标题 i18n 化 + 服务端过滤 + 编排下沉 + 表单错误展示 + 架构图同步
V1 改进(已完成): - P0-4/P1-4/P1-5: 通知组件和 CRUD Action 从 messaging 迁移至 notifications 模块 - P1-5: 新增 getMessagesPageData / getAdminAnnouncementsPageData 编排函数 - P1-6: announcements schema 添加 superRefine 条件校验 - P1-7: 新增 useMessageSearch hook(防抖 + 请求竞态取消)+ 客户端分页 UI - P1-9: deleteMessage 事务化 - P2-11: 全模块 trackEvent 埋点 - 全模块 i18n 接入 + Error Boundary + a11y 改进 V2 改进(本次完成): - V2-P0-1: 通知 i18n 命名空间独立(notifications.json),useTranslations 从 "messages" 切换到 "notifications" - V2-P0-2: 公告/消息通知标题 i18n 化,Server Action 中使用 getTranslations 生成通知标题 - V2-P1-1: AnnouncementList 纯服务端过滤,移除客户端 useState/useMemo - V2-P1-2: MessageList 客户端过滤仅在初始数据时执行,搜索结果由服务端按 tab 过滤 - V2-P1-3: 消息详情页编排下沉,新增 getMessageDetailPageData 编排函数 - V2-P1-4: 表单服务端校验错误展示(fieldErrors + aria-invalid) - V2-P2-1: 轮询间隔常量化(POLL_INTERVAL_MS) - V2-P2-2: 架构图同步(004 + 005)
This commit is contained in:
@@ -180,14 +180,17 @@ export async function markMessageAsRead(id: string, userId: string): Promise<voi
|
||||
export async function deleteMessage(id: string, userId: string): Promise<void> {
|
||||
const now = new Date()
|
||||
// 软删除:发送方删除设置 senderDeletedAt,接收方删除设置 receiverDeletedAt,互不影响
|
||||
await db
|
||||
.update(messages)
|
||||
.set({ senderDeletedAt: now })
|
||||
.where(and(eq(messages.id, id), eq(messages.senderId, userId)))
|
||||
await db
|
||||
.update(messages)
|
||||
.set({ receiverDeletedAt: now })
|
||||
.where(and(eq(messages.id, id), eq(messages.receiverId, userId)))
|
||||
// 使用事务保证两次 UPDATE 的原子性,避免部分失败导致数据不一致
|
||||
await db.transaction(async (tx) => {
|
||||
await tx
|
||||
.update(messages)
|
||||
.set({ senderDeletedAt: now })
|
||||
.where(and(eq(messages.id, id), eq(messages.senderId, userId)))
|
||||
await tx
|
||||
.update(messages)
|
||||
.set({ receiverDeletedAt: now })
|
||||
.where(and(eq(messages.id, id), eq(messages.receiverId, userId)))
|
||||
})
|
||||
}
|
||||
|
||||
export const getUnreadMessageCount = cache(async (userId: string): Promise<number> => {
|
||||
@@ -244,3 +247,44 @@ export const getRecipients = cache(
|
||||
return []
|
||||
}
|
||||
)
|
||||
|
||||
/**
|
||||
* 消息首页编排函数:一次性获取消息列表和通知列表。
|
||||
* 将原本散落在 page.tsx 中的多模块编排逻辑下沉到 data-access 层,
|
||||
* 页面层只需调用单一函数,提升可复用性与可测试性。
|
||||
*/
|
||||
export async function getMessagesPageData(userId: string): Promise<{
|
||||
messages: { items: Message[]; total: number; page: number; pageSize: number; totalPages: number }
|
||||
notifications: { items: import("@/modules/notifications/types").Notification[]; total: number; page: number; pageSize: number; totalPages: number }
|
||||
}> {
|
||||
const { getNotifications } = await import("@/modules/notifications/data-access")
|
||||
|
||||
const [messagesResult, notificationsResult] = await Promise.all([
|
||||
getMessages({ userId, type: "all", page: 1, pageSize: 50 }),
|
||||
getNotifications(userId, { page: 1, pageSize: 20 }),
|
||||
])
|
||||
|
||||
return {
|
||||
messages: messagesResult,
|
||||
notifications: notificationsResult,
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 消息详情页编排函数:获取消息详情,并自动标记为已读(若当前用户为接收方且未读)。
|
||||
* 使用 next/server 的 after() 实现非阻塞标记,避免阻塞页面渲染。
|
||||
*/
|
||||
export async function getMessageDetailPageData(
|
||||
id: string,
|
||||
userId: string
|
||||
): Promise<Message | null> {
|
||||
const message = await getMessageById(id, userId)
|
||||
if (!message) return null
|
||||
|
||||
// 自动标记已读:仅当当前用户为接收方且消息未读时
|
||||
if (!message.isRead && message.receiverId === userId) {
|
||||
await markMessageAsRead(id, userId)
|
||||
}
|
||||
|
||||
return message
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user