feat: split DA and API layers by domain, add parallel route docs

src/utils/api/address.ts

@@ -0,0 +1,7 @@
+/**
+ * R2 收货地址接口归属文件。
+ * 后端 /api/addresses CRUD 就绪后，在这里补充：
+ *   fetchAddresses / createAddress / updateAddress / deleteAddress / setDefaultAddress
+ * 返回类型优先直接对应 src/types/index.ts 的 AddressItem 契约。
+ */
+export {}

src/utils/api/auth.ts

@@ -0,0 +1,45 @@
+import http, { clearToken, getToken, setToken } from '../request'
+
+export { getToken }
+
+export interface LoginResult {
+  accessToken: string
+  isNewUser: boolean // 首次登录（未设资料）为 true，前端需引导补填头像/姓名
+  nickname: string | null
+  avatar: string | null
+}
+
+/**
+ * 登录：把 wx.login() 的 code 交给后端，后端用 code2Session 换 openid，
+ * 自动注册/续登并签发 accessToken（个人主体无需手机号）。
+ * 返回 isNewUser 供前端判断是否需补全资料。
+ */
+export async function login(code: string): Promise<LoginResult> {
+  const data = await http.post<LoginResult>('/api/auth/login', { code }, { auth: false })
+  if (data?.accessToken) {
+    setToken(data.accessToken)
+  }
+  return data
+}
+
+/**
+ * 首次注册：用 registerTicket + wx.getPhoneNumber 的 code 验证手机号，完成后自动登录
+ */
+export async function registerWithPhone(
+  registerTicket: string,
+  phoneCode: string,
+  profile?: { nickname?: string; avatar?: string },
+): Promise<{ accessToken: string }> {
+  const data = await http.post<{ accessToken: string }>(
+    '/api/auth/register',
+    { registerTicket, phoneCode, ...profile },
+    { auth: false },
+  )
+  setToken(data.accessToken)
+  return data
+}
+
+/** 登出：仅清除本地 token（后端 JWT 无状态，无需撤销） */
+export function logout(): void {
+  clearToken()
+}

src/utils/api/design.ts

@@ -0,0 +1,7 @@
+/**
+ * R2 设计清单接口归属文件。
+ * 后端 /api/design-list CRUD 就绪后，在这里补充：
+ *   fetchDesignList / createDesign / updateDesign / deleteDesign
+ * 设计数据（贴纸、掩膜、分类信息）以 JSON 方式随 items/designData 提交。
+ */
+export {}

src/utils/api/index.ts

@@ -0,0 +1,11 @@
+/**
+ * API 层聚合入口：页面统一从 '../../utils/api' 导入。
+ * 新接口写在 api/<domain>.ts，本文件只负责 re-export，不要往单文件堆代码。
+ */
+export * from './auth'
+export * from './user'
+export * from './product'
+export * from './address'
+export * from './design'
+export * from './order'
+export * from './upload'

src/utils/api/order.ts

@@ -0,0 +1,7 @@
+/**
+ * R3 订单接口归属文件。
+ * 后端 /api/orders 就绪后，在这里补充：
+ *   createOrder / fetchOrders / fetchOrderDetail / payOrder
+ * 金额一律以服务端重算结果为准，前端只提交商品/设计数据与地址快照。
+ */
+export {}

src/utils/api/product.ts

@@ -0,0 +1,16 @@
+import http from '../request'
+
+/** 商品列表 */
+export async function fetchProducts() {
+  return http.get('/api/products', { auth: false })
+}
+
+/** 商品详情 */
+export async function fetchProduct(id: string) {
+  return http.get(`/api/products/${id}`, { auth: false })
+}
+
+/** 分类列表 */
+export async function fetchCategories() {
+  return http.get('/api/categories', { auth: false })
+}

src/utils/api/upload.ts

@@ -0,0 +1,7 @@
+/**
+ * R4 上传接口归属文件。
+ * 后端 COS/wordcloud 适配器就绪后，在这里补充：
+ *   getUploadCredentials / uploadImage / generateWordCloud / getWordCloudJob / sketchImage
+ * 词云任务使用“创建任务 -> 轮询状态 -> 取结果链接”的异步模型。
+ */
+export {}

src/utils/api/user.ts

@@ -0,0 +1,24 @@
+import http from '../request'
+
+/** 后端用户信息（对应 User 模型；openpid 为主标识，openid 可空） */
+export interface UserProfile {
+  id: string
+  openpid?: string | null
+  openid?: string | null
+  unionid?: string | null
+  nickname?: string | null
+  avatar?: string | null
+  phone?: string | null
+  createdAt?: string
+  updatedAt?: string
+}
+
+/** 更新当前用户资料（昵称/头像），新用户在补填后提交到后端持久化 */
+export async function updateProfile(profile: { nickname?: string; avatar?: string }): Promise<UserProfile> {
+  return http.patch<UserProfile>('/api/users/me', profile)
+}
+
+/** 获取当前登录用户信息 */
+export async function getMe(): Promise<UserProfile> {
+  return http.get<UserProfile>('/api/users/me')
+}