feat 完善注释

src/api/profile.ts

@@ -14,7 +14,6 @@ import type {
 
 // TODO(api): 待接口文档到位后，将以下 mock 替换为 request<T> 调用（页面 → store → api 数据流不变）
 
-/** 账号资料 mock（可变，昵称/绑定等操作在前端内存中演示） */
 const MOCK_PROFILE: Profile = {
   nickname: '王永志',
   phone: '186****618',
@@ -22,57 +21,48 @@ const MOCK_PROFILE: Profile = {
   passwordModifiedAt: '15天前',
 }
 
-/** 获取账号资料 */
 export function getProfile(): Promise<Profile> {
   return Promise.resolve({ ...MOCK_PROFILE })
 }
 
-/** 修改昵称 */
 export function updateNickname(name: string): Promise<Profile> {
   MOCK_PROFILE.nickname = name
   return Promise.resolve({ ...MOCK_PROFILE })
 }
 
-/** 修改密码（验证码 + 新密码） */
 export function changePassword(params: ChangePasswordParams): Promise<void> {
   MOCK_PROFILE.passwordModifiedAt = '刚刚'
   void params
   return Promise.resolve()
 }
 
-/** 绑定/换绑手机号 */
 export function bindPhone(phone: string, code: string): Promise<Profile> {
   void code
   MOCK_PROFILE.phone = phone
   return Promise.resolve({ ...MOCK_PROFILE })
 }
 
-/** 绑定/换绑邮箱 */
 export function bindEmail(email: string, code: string): Promise<Profile> {
   void code
   MOCK_PROFILE.email = email
   return Promise.resolve({ ...MOCK_PROFILE })
 }
 
-/** 取消绑定邮箱 */
 export function unbindEmail(): Promise<Profile> {
   MOCK_PROFILE.email = ''
   return Promise.resolve({ ...MOCK_PROFILE })
 }
 
-/** 注销前安全身份验证 */
 export function verifyIdentity(phone: string, code: string): Promise<void> {
   void phone
   void code
   return Promise.resolve()
 }
 
-/** 注销账号 */
 export function deleteAccount(): Promise<void> {
   return Promise.resolve()
 }
 
-/** 收货地址 mock（isDefault 混合） */
 const MOCK_ADDRESSES: Address[] = [
   {
     id: 'addr-1',
@@ -116,12 +106,10 @@ function paginate<T>(list: T[], query: ListQuery): PageResult<T> {
   }
 }
 
-/** 收货地址列表（分页） */
 export function getAddresses(query: ListQuery): Promise<PageResult<Address>> {
   return Promise.resolve(paginate(MOCK_ADDRESSES, query))
 }
 
-/** 新增收货地址 */
 export function createAddress(input: Omit<Address, 'id' | 'isDefault'>): Promise<Address> {
   const created: Address = {
     ...input,
@@ -132,7 +120,6 @@ export function createAddress(input: Omit<Address, 'id' | 'isDefault'>): Promise
   return Promise.resolve({ ...created })
 }
 
-/** 编辑收货地址 */
 export function updateAddress(id: string, input: Omit<Address, 'id' | 'isDefault'>): Promise<Address> {
   const found = MOCK_ADDRESSES.find((item) => item.id === id)
   if (!found) return Promise.reject(new Error('地址不存在'))
@@ -140,14 +127,12 @@ export function updateAddress(id: string, input: Omit<Address, 'id' | 'isDefault
   return Promise.resolve({ ...found })
 }
 
-/** 删除收货地址 */
 export function deleteAddress(id: string): Promise<void> {
   const index = MOCK_ADDRESSES.findIndex((item) => item.id === id)
   if (index >= 0) MOCK_ADDRESSES.splice(index, 1)
   return Promise.resolve()
 }
 
-/** 设为默认地址 */
 export function setDefaultAddress(id: string): Promise<Address[]> {
   for (const item of MOCK_ADDRESSES) {
     item.isDefault = item.id === id
@@ -155,7 +140,6 @@ export function setDefaultAddress(id: string): Promise<Address[]> {
   return Promise.resolve(MOCK_ADDRESSES.map((item) => ({ ...item })))
 }
 
-/** 我的收藏 mock（4 条已收藏案例，字段与案例库原型一致） */
 const MOCK_FAVORITES: Case[] = [
   {
     id: 'fav-1',
@@ -243,7 +227,6 @@ const MOCK_FAVORITES: Case[] = [
   },
 ]
 
-/** 我的收藏（关键字/分类筛选 + 分页） */
 export function getFavorites(query: FavoritesQuery): Promise<PageResult<Case>> {
   const filtered = MOCK_FAVORITES.filter((item) => {
     if (query.category !== 'all' && item.category !== query.category) return false
@@ -257,7 +240,6 @@ export function getFavorites(query: FavoritesQuery): Promise<PageResult<Case>> {
   })
 }
 
-/** 收藏分类计数（分类快捷按钮角标） */
 export function getCaseCounts(): Promise<Partial<Record<BusinessType, number>>> {
   const counts: Partial<Record<BusinessType, number>> = {
     internet: 1,
@@ -268,7 +250,6 @@ export function getCaseCounts(): Promise<Partial<Record<BusinessType, number>>>
   return Promise.resolve(counts)
 }
 
-/** 资质 mock（状态混合：已认证/审核中/未通过） */
 const MOCK_QUALIFICATIONS: Qualification[] = [
   {
     id: 'qual-1',
@@ -324,12 +305,10 @@ const MOCK_QUALIFICATIONS: Qualification[] = [
   },
 ]
 
-/** 资质列表（分页） */
 export function getQualifications(query: ListQuery): Promise<PageResult<Qualification>> {
   return Promise.resolve(paginate(MOCK_QUALIFICATIONS, query))
 }
 
-/** 新增资质（提交后进入审核中） */
 export function createQualification(input: QualificationInput): Promise<Qualification> {
   const created: Qualification = {
     ...input,
@@ -340,7 +319,6 @@ export function createQualification(input: QualificationInput): Promise<Qualific
   return Promise.resolve({ ...created })
 }
 
-/** 编辑资质（未通过重新提交后回到审核中） */
 export function updateQualification(id: string, input: QualificationInput): Promise<Qualification> {
   const found = MOCK_QUALIFICATIONS.find((item) => item.id === id)
   if (!found) return Promise.reject(new Error('资质不存在'))
@@ -355,20 +333,17 @@ export function updateQualification(id: string, input: QualificationInput): Prom
   return Promise.resolve({ ...found })
 }
 
-/** 删除资质 */
 export function deleteQualification(id: string): Promise<void> {
   const index = MOCK_QUALIFICATIONS.findIndex((item) => item.id === id)
   if (index >= 0) MOCK_QUALIFICATIONS.splice(index, 1)
   return Promise.resolve()
 }
 
-/** 提交意见反馈 */
 export function submitFeedback(feedback: Feedback): Promise<void> {
   void feedback
   return Promise.resolve()
 }
 
-/** 帮助中心 FAQ */
 export function getHelpFaqs(): Promise<HelpFaqGroup[]> {
   return Promise.resolve([
     {