feat 完善注释

src/api/contract.ts

@@ -3,15 +3,12 @@ import type { Contract, ContractQuery } from '@/types/business/contract'
 
 // TODO(api): 待接口文档到位后，将以下 mock 替换为 request<T> 调用
 
-/** 构造 mock 文件信息 */
 function mockFile(name: string, size: number, uploadTime: string): FileInfo {
   return { name, size, uploadTime, url: '' }
 }
 
-/** 详情 mock 所属合同 id */
 const DETAIL_ID = 'contract-001'
 
-/** 合同列表 mock（3 条，覆盖全部签署状态） */
 const MOCK_CONTRACTS: Contract[] = [
   {
     id: 'contract-001',
@@ -56,7 +53,6 @@ const MOCK_CONTRACTS: Contract[] = [
   },
 ]
 
-/** 合同详情 mock */
 const CONTRACT_DETAIL: Contract = {
   id: DETAIL_ID,
   contractNo: 'C8K2M202408001',
@@ -72,7 +68,6 @@ const CONTRACT_DETAIL: Contract = {
   files: [mockFile('项目需求规格说明书.pdf', 2516582, '2024-10-15')],
 }
 
-/** 合同列表（keyword 筛选 + 分页） */
 export function getContractList(query: ContractQuery): Promise<PageResult<Contract>> {
   const filtered = MOCK_CONTRACTS.filter((item) => {
     if (
@@ -92,19 +87,16 @@ export function getContractList(query: ContractQuery): Promise<PageResult<Contra
   })
 }
 
-/** 合同详情（不存在返回 null） */
 export function getContractDetail(id: string): Promise<Contract | null> {
   if (id === DETAIL_ID) return Promise.resolve({ ...CONTRACT_DETAIL, files: [...CONTRACT_DETAIL.files] })
   const found = MOCK_CONTRACTS.find((item) => item.id === id) ?? null
   return Promise.resolve(found ? { ...found, files: [...found.files] } : null)
 }
 
-/** 获取签署二维码（返回有效期） */
 export function getSignQr(_id: string): Promise<{ expiresInSeconds: number }> {
   return Promise.resolve({ expiresInSeconds: 272 })
 }
 
-/** 刷新签署二维码（返回有效期） */
 export function refreshSignQr(_id: string): Promise<{ expiresInSeconds: number }> {
   return Promise.resolve({ expiresInSeconds: 272 })
 }