book-hi/CLAUDE.md

Book-Hi 项目开发指南 (Project Instructions)

Tech Stack

• Framework: uni-app
• UI Library: uView UI v1
• Language: JavaScript (ES6+), Vue 2, SCSS
• State Management: Vuex
• Platform: 微信小程序 (WeChat Mini Program), 支付宝小程序 (Alipay Mini Program)

Code Style

• File Naming:
  • 组件 (Components): kebab-case.vue (例如: address-card.vue) 或 PascalCase.vue (例如: BookItem.vue)
  • 页面 (Pages): kebab-case.vue
  • JS 文件: camelCase.js
• CSS:
  • 必须使用 <style lang="scss" scoped>
  • 单位统一使用 rpx 以保证响应式布局
  • 优先使用 theme.scss 中的全局变量
• UI Component Usage:
  • uView 组件前缀为 u- (例如 <u-button>)，已通过 easycom 全局注册，无需手动引入。

Project Structure

• pages/ → 主包页面（仅包含底部的 Tabbar 页面：首页、卖书、购物车、我的）
• pages-sell/ → 买书/商城子包（商品详情、搜索、热门推荐等）
• pages-home/ → 卖书子包（扫码卖书、确认订单、协议等）
• pages-car/ → 购物车与订单子包（购物车列表、结算台、退款售后等）
• pages-mine/ → 个人中心子包（收货地址、钱包、合伙人、设置等）
• api/ → 接口请求定义 (config.js 包含请求拦截器)
• components/ → 全局公共组件
• store/ → Vuex 状态管理
• static/ → 全局静态资源（子包静态资源在各自子包内的 static/ 目录下）

API Conventions

• 接口封装:
  • 所有模块化接口位于 api/modules/ 下（如 mall.js, user.js）
  • 命名规范: 接口方法统一以 Ajax 结尾（例如 getGoodsListAjax）
  • 挂载方式: 通过 vm.$u.api 全局挂载
• 接口调用:
  • 标准方式: this.$u.api.methodName(params).then(...)
  • 直接调用: uni.$u.http.post('/path', params).then(...)
• 拦截与错误处理:
  • 全局拦截器位于 api/config.js
  • 401 状态码会自动触发 silentLogin (静默登录)
  • 其他非 200 错误码会自动 showToast 提示

Build & Run

• 微信开发版: npm run dev
• 微信正式版: npm run prod
• 环境配置: 通过 .env.js, .env.dev.js, .env.prod.js 区分环境。

Conventions

• 代码注释: 所有复杂的业务逻辑和代码注释必须使用简体中文。
• 页面路由:
  • Tabbar 页面跳转使用 uni.switchTab
  • 子包页面跳转使用 uni.navigateTo，并且 必须使用绝对路径 (例如: /pages-sell/pages/detail)。
• 重构原则: 优先使用 uView 组件替代原生 HTML/Vue 标签，以保持项目整体一致性。