chore: 初始化平台管理端

src/api/announcement.ts

@@ -0,0 +1,254 @@
+/**
+ * 文件用途：公告模块 API 封装
+ * 说明：统一对接平台/租户/应用端公告接口
+ * 日期：2025-12-20
+ */
+
+import request from '@/utils/http'
+import type {
+  AnnouncementCommand,
+  AnnouncementFormData,
+  AnnouncementQueryParams,
+  TenantAnnouncementDto
+} from '@/types/announcement'
+import type { PagedResult } from '@/types/common/response'
+
+/** 发布/撤销命令体（仅包含 RowVersion） */
+type RowVersionCommand = Pick<AnnouncementCommand, 'rowVersion'>
+
+const withTenantHeader = (tenantId: string) => ({
+  headers: {
+    'X-Tenant-Id': tenantId
+  }
+})
+
+const normalizeQueryParams = (params: AnnouncementQueryParams) => {
+  const { dateFrom, dateTo, ...rest } = params
+  return {
+    ...rest,
+    effectiveFrom: params.effectiveFrom ?? dateFrom,
+    effectiveTo: params.effectiveTo ?? dateTo
+  }
+}
+
+/**
+ * 平台公告 API
+ * 路由前缀：/api/platform/announcements
+ */
+export const platformAnnouncementApi = {
+  /**
+   * 创建平台公告
+   * @param data 创建参数
+   */
+  create: (data: AnnouncementFormData) => {
+    return request.post<TenantAnnouncementDto>({
+      url: '/api/platform/announcements',
+      data
+    })
+  },
+
+  /**
+   * 查询平台公告列表
+   * @param params 查询参数
+   */
+  list: (params: AnnouncementQueryParams) => {
+    return request.get<PagedResult<TenantAnnouncementDto>>({
+      url: '/api/platform/announcements',
+      params: normalizeQueryParams(params)
+    })
+  },
+
+  /**
+   * 获取平台公告详情
+   * @param announcementId 公告ID
+   */
+  detail: (announcementId: string) => {
+    return request.get<TenantAnnouncementDto>({
+      url: `/api/platform/announcements/${announcementId}`
+    })
+  },
+
+  /**
+   * 更新平台公告（仅草稿）
+   * @param announcementId 公告ID
+   * @param data 更新参数
+   */
+  update: (announcementId: string, data: AnnouncementFormData) => {
+    return request.put<TenantAnnouncementDto>({
+      url: `/api/platform/announcements/${announcementId}`,
+      data
+    })
+  },
+
+  /**
+   * 发布平台公告
+   * @param announcementId 公告ID
+   * @param command 命令体（包含 rowVersion）
+   */
+  publish: (announcementId: string, command: RowVersionCommand) => {
+    return request.post<TenantAnnouncementDto>({
+      url: `/api/platform/announcements/${announcementId}/publish`,
+      data: command
+    })
+  },
+
+  /**
+   * 撤销平台公告
+   * @param announcementId 公告ID
+   * @param command 命令体（包含 rowVersion）
+   */
+  revoke: (announcementId: string, command: RowVersionCommand) => {
+    return request.post<TenantAnnouncementDto>({
+      url: `/api/platform/announcements/${announcementId}/revoke`,
+      data: command
+    })
+  }
+}
+
+/**
+ * 租户公告 API
+ * 路由前缀：/api/admin/v1/tenants/{tenantId}/announcements
+ */
+export const tenantAnnouncementApi = {
+  /**
+   * 分页查询租户公告
+   * @param tenantId 租户ID
+   * @param params 查询参数
+   */
+  list: (tenantId: string, params: AnnouncementQueryParams) => {
+    return request.get<PagedResult<TenantAnnouncementDto>>({
+      url: `/api/admin/v1/tenants/${tenantId}/announcements`,
+      params: normalizeQueryParams(params),
+      ...withTenantHeader(tenantId)
+    })
+  },
+
+  /**
+   * 获取租户公告详情
+   * @param tenantId 租户ID
+   * @param announcementId 公告ID
+   */
+  detail: (tenantId: string, announcementId: string) => {
+    return request.get<TenantAnnouncementDto>({
+      url: `/api/admin/v1/tenants/${tenantId}/announcements/${announcementId}`,
+      ...withTenantHeader(tenantId)
+    })
+  },
+
+  /**
+   * 创建租户公告
+   * @param tenantId 租户ID
+   * @param data 创建参数
+   */
+  create: (tenantId: string, data: AnnouncementFormData) => {
+    return request.post<TenantAnnouncementDto>({
+      url: `/api/admin/v1/tenants/${tenantId}/announcements`,
+      data,
+      ...withTenantHeader(tenantId)
+    })
+  },
+
+  /**
+   * 更新租户公告（仅草稿）
+   * @param tenantId 租户ID
+   * @param announcementId 公告ID
+   * @param data 更新参数
+   */
+  update: (tenantId: string, announcementId: string, data: AnnouncementFormData) => {
+    return request.put<TenantAnnouncementDto>({
+      url: `/api/admin/v1/tenants/${tenantId}/announcements/${announcementId}`,
+      data,
+      ...withTenantHeader(tenantId)
+    })
+  },
+
+  /**
+   * 发布租户公告
+   * @param tenantId 租户ID
+   * @param announcementId 公告ID
+   * @param command 命令体（包含 rowVersion）
+   */
+  publish: (tenantId: string, announcementId: string, command: RowVersionCommand) => {
+    return request.post<TenantAnnouncementDto>({
+      url: `/api/admin/v1/tenants/${tenantId}/announcements/${announcementId}/publish`,
+      data: command,
+      ...withTenantHeader(tenantId)
+    })
+  },
+
+  /**
+   * 撤销租户公告
+   * @param tenantId 租户ID
+   * @param announcementId 公告ID
+   * @param command 命令体（包含 rowVersion）
+   */
+  revoke: (tenantId: string, announcementId: string, command: RowVersionCommand) => {
+    return request.post<TenantAnnouncementDto>({
+      url: `/api/admin/v1/tenants/${tenantId}/announcements/${announcementId}/revoke`,
+      data: command,
+      ...withTenantHeader(tenantId)
+    })
+  },
+
+  /**
+   * 删除租户公告
+   * @param tenantId 租户ID
+   * @param announcementId 公告ID
+   */
+  delete: (tenantId: string, announcementId: string) => {
+    return request.del<boolean>({
+      url: `/api/admin/v1/tenants/${tenantId}/announcements/${announcementId}`,
+      ...withTenantHeader(tenantId)
+    })
+  },
+
+  /**
+   * 标记公告已读（兼容旧路径）
+   * @param tenantId 租户ID
+   * @param announcementId 公告ID
+   */
+  markRead: (tenantId: string, announcementId: string) => {
+    return request.post<TenantAnnouncementDto>({
+      url: `/api/admin/v1/tenants/${tenantId}/announcements/${announcementId}/read`,
+      ...withTenantHeader(tenantId)
+    })
+  }
+}
+
+/**
+ * 应用端公告 API
+ * 路由前缀：/api/app/announcements
+ */
+export const appAnnouncementApi = {
+  /**
+   * 获取可见公告列表（已发布且有效期内）
+   * @param params 查询参数
+   */
+  list: (params: AnnouncementQueryParams) => {
+    return request.get<PagedResult<TenantAnnouncementDto>>({
+      url: '/api/app/announcements',
+      params: normalizeQueryParams(params)
+    })
+  },
+
+  /**
+   * 获取未读公告列表
+   * @param params 查询参数
+   */
+  unread: (params: AnnouncementQueryParams) => {
+    return request.get<PagedResult<TenantAnnouncementDto>>({
+      url: '/api/app/announcements/unread',
+      params: normalizeQueryParams(params)
+    })
+  },
+
+  /**
+   * 标记公告已读
+   * @param announcementId 公告ID
+   */
+  markRead: (announcementId: string) => {
+    return request.post<TenantAnnouncementDto>({
+      url: `/api/app/announcements/${announcementId}/mark-read`
+    })
+  }
+}