* ### **配件查询App需求规格说明书**

  #### 1.0 项目概述
  本项目旨在开发一款面向小微商户的移动端进销存管理应用，命名为“配件查询”。该应用核心功能是帮助用户高效管理商品、库存、销售、采购、客户、供应商及财务收支，并通过数据报表提供经营状况分析，助力商户实现数字化经营。
  参考的小程序“智慧记进销存”，但是多了一个配件查询功能，以下所罗列的内容大多也参考至该小程序，如有歧义可优先参照这个小程序，拿不准优先问。
  当前交付内容：移动端已实现基础的登录、VIP 开通、用户/客户/供应商管理、下单与报表入口；管理端完成会员、公告、咨询、配件、字典维护模块。

  #### 2.0 功能模块需求

  **2.1 首页 (Dashboard)**

  *   **2.1.1 核心数据概览:** 首页需直观展示当日、当月的核心经营数据。
      > 已实现基础销量/库存统计，利润汇总需依赖真实成本数据完善。

      *   今日销售额
      *   本月销售额
      *   本月利润
      *   库存商品数量

      **2.1.2 广告位:** 在首页区域提供一个展示广告的区域。
      > 待设计，当前保留静态占位图。

  *   **2.1.3 快捷功能入口:** 提供一个快捷功能区域，方便用户快速访问常用功能。
      *   默认应包含：客户管理、销售开单、账户管理、供应商管理、进货开单、其他支出、VIP会员、报表统计等。
      *   现状：移动端 Tab 首页已集成常用入口，后续需根据配置扩展。

  *   **2.1.4 在线客服:** 提供一个悬浮的“咨询”或“在线客服”入口，方便用户随时获取帮助。
      *   当前通过“我的-咨询”入口触达，悬浮入口尚未实现。

  **2.2 货品管理模块**
  
  *   **2.2.1 货品列表与库存:**
      *   展示所有货品的列表，包含名称、库存等基本信息。
      *   支持按“全部类别”或指定类别筛选货品。
      *   提供搜索功能，支持通过货品名称或条形码进行模糊查找。
      *   列表底部显示总货品种类数量。
      *   当库存为空时，应有明显的空状态提示，并引导用户“点击右上角‘+’录入货品信息”。
  *   **2.2.2 新增/编辑货品:**
      *   支持添加商品图片。
      *   App端支持录入或扫描商品条形码；小程序端仅支持手动录入，不支持扫码。
      *   **货品名称**为必填项。
      *   可为货品选择**类别**和**主单位**。
      *   支持自定义扩展货品属性（如品牌、型号、产地、保质期等）。
      *   货品图片支持多图上传，支持拖拽排序，支持图片放大预览。
      *   可录入**当前库存**、**安全库存**（一个数值区间，用于库存预警）。
      *   需分别录入四种价格，**进货价**、**批发价**、**大单报价**和**零售价**。
      *   提供**备注**字段，用于记录额外信息。
      *   保存后，可选择“继续新增”或返回列表。
  *   **2.2.3 货品设置:**
      *   支持自定义**货品类别**管理。
      *   支持自定义**货品单位**管理。
      *   提供开关选项，允许用户选择是否“隐藏零库存商品”和“隐藏进货价”。
  
  **2.3 开单（交易）模块**
  *   **2.3.1 核心功能:** 该模块是应用的核心操作区，整合了销售、进货和财务记账功能。
  *   **2.3.2 销售开单:**
      *   **出货单:**
          *   自动记录开单**时间**，并支持手动修改。
          *   可选择**客户**，默认为“零售客户”。
          *   通过“+”号从货品列表中选择商品，自动计算**合计金额**。
          *   支持在订单中对单个商品进行操作（如修改数量、价格等）。
      *   **退货单:** 用于处理客户退货业务。
      *   **收款单:** 用于处理销售单的后续收款或直接创建收款记录。
  *   **2.3.3 进货开单:** 用于记录从供应商处采购商品的业务流程。
  *   **2.3.4 其他收入/支出:**
      *   **其他收入:**
          *   支持对收入进行分类，如“销售收入”、“经营所得”、“利息收入”等。
          *   可选择**往来单位**和**结算账户**（如现金、银行等）。
          *   可添加备注并选择日期。
      *   **其他支出:**
          *   支持对支出进行分类，如“经营支出”、“办公用品”、“房租”等。
          *   同样支持选择**往来单位**和**结算账户**。
  
  **2.4 明细查询模块**
  *   **2.4.1 维度筛选:**
      *   提供按时间维度（自定义、本周、今日、本月、本年）快速筛选单据。
      *   提供按业务类型（销售、进货、收银、资金、盘点）进行分类查看。
  *   **2.4.2 单据列表:**
      *   在选定维度下，以列表形式展示所有相关单据。
      *   提供搜索功能，支持通过单据号、客户/供应商名、品名、备注等关键字查询。
      *   显示当前筛选条件下的总金额。
      *   当无数据时，提供清晰的空状态提示。
      *   提供“+”号，支持在当前分类下快速新建单据。
  
  **2.5 报表统计模块**
  *   **2.5.1 资金报表:**
      *   **利润统计:** 分析指定时间范围内的收入、支出和利润。
      *   **营业员统计:** 按销售人员维度统计销售业绩。
      *   **经营业绩:** 提供综合性的经营状况分析。
      *   **导入导出模块:** 提供导入导出功能方便用户切换手机或账号后仍能将旧数据导入。
  *   **2.5.2 进销存报表:**
      *   **销售统计:** 按商品、客户、时间等维度分析销售数据。
      *   **进货统计:** 按商品、供应商、时间等维度分析采购数据。
      *   **库存统计:** 提供当前库存成本、数量及分布情况的报告。
      *   **应收/应付对账单:** 生成与客户和供应商的对账单据。
  
  **2.6 “我的”（用户中心）模块**
  *   **2.6.1 用户信息:** 显示用户头像、店铺名称、注册手机号及“老板”身份标识。
      > 个人信息读取 `/api/user/me` 已上线。
  *   **2.6.2 会员与订单:**
      *   提供**VIP会员**入口，展示会员特权。
        > `/pages/my/vip` 已接入 `/api/vip/status`，开通调用 `/api/vip/pay`。
      *   提供**我的订单**入口，可能用于查看应用内服务订单。
        > 入口预留，服务订单接口尚未上线。
  *   **2.6.3 基础管理:**
      *   **供应商管理**
      *   **客户管理**
      *   **客户报价**
      *   **店铺管理**
  *   **2.6.4 设置中心:**
      *   **账号与安全:**
          *   修改个人信息（头像、姓名）。
          *   修改登录密码。
      *   **商品设置:**
      *   **系统参数:**
          *   提供多种业务逻辑开关，如：“销售价低于进货价时提示”、“销售单默认全部收款”、“启用单行折扣”、“启用客户/供应商双身份”。
      *   **关于与协议:** 包含“关于我们”、“隐私协议”、“个人信息安全投诉”等静态页面。
      *   **账号操作:** 提供“账号注销”和“退出登录”功能。
  
  #### 3.0 全局性需求
  
  *   **3.1 导航:** 采用底部Tab栏导航，包含“首页”、“货品”、“开单”、“明细”、“我的”五个主要模块。
      > uni-app 端已实现，管理端采用侧栏导航。
  *   **3.2 统一的UI/UX:** 应用整体风格简洁、清晰，操作流程符合移动端使用习惯。
  *   **3.3 空状态页面:** 在列表、报表等数据为空的页面，需提供友好的空状态提示图和引导性文字。
  *   **3.4 数据同步:** 应用数据应在云端同步，保证用户更换设备或多设备使用时数据一致性。
  *   **3.5 多租户数据隔离:** 所有业务数据按店铺（租户）隔离，用户不可访问他人数据。
      *   所有业务表需包含`user_id`并在读取/写入中强制按`user_id`过滤。
      *   支持租户内角色与权限控制；导出仅限本租户数据。
  *   **3.6 公共SKU（全局商品库）众包与审核:** 全体用户共同补充、纠错SKU，经审核发布为全局可选SKU。
      *   用户可提交“新增SKU/编辑建议”，进入审核流（草稿/待审/驳回/发布/下架）。
      *   全局SKU字段：名称、品牌、规格、条码、主单位、图片、别名、分类标签等。
      *   各用户通过“本地商品”引用全局SKU，并保留本地私有字段（价格、库存、分类、单位换算、条码别名等）。
  *   **3.7 商品模糊查询（增强）:** 在货品列表、开单选品、对账等场景支持多字段模糊匹配。
      *   支持名称/条码/别名/拼音/品牌/规格模糊匹配，并高亮命中片段。
      *   支持全局SKU与本地商品联合检索，优先展示本地商品；结果可分页。
      *   需满足大规模SKU下的性能目标；可通过系统参数配置匹配策略。
  
  * **3.8 客户端平台:** 提供移动App与小程序；小程序不支持商品条形码扫描功能。
    > HBuilderX 打包的 App 版本与微信小程序版本已具备扫描差异处理；条码识别仅用户端调用。

  * **3.9 多列销售价格：** 销售价格分四列，即同一种商品有四个销售价格

    ### 配件查询

  1. **数据查询功能**
     - 多参数组合查询（分类、尺寸、型号等）
     - 模糊匹配关键字
     - 分页展示查询结果
     - 一键导出Excel数据
  2. **数据提交系统**
     - 用户提交新配件数据
     - 型号为唯一必填项
     - 支持图片上传
     - 提交后等待管理员审核
  3. **审核管理系统**
     - 管理员查看待审核列表
     - 可编辑所有字段
     - 支持图片更新和删除
     - 一键批准或拒绝提交
  4. **图片管理系统**
     - 每条数据可关联多张图片
     - 点击图片可放大查看
     - 管理员可管理所有图片
     - 自动处理文件名冲突

  ## 全局说明（必看）

  由于这个文档写的还不是很完善，目前有存疑的部分先行参考小程序小程序“智慧记进销存”（功能和按钮可以参考，界面样式除外），管理端文档目前待定。

  客户要求的是做双端应用（app端+小程序端），需要考虑兼容性相关问题。

  本程序和“智慧记进销存”大多一致，主要的区别在于客户有配件查询要求，即在产品页面中要额外加一个配件查询按钮或入口，且要求一个产品要有四个销售价格（先按零售价 分销价 批发价  大客户价），且要求能自定义添加各种规格（尺寸，孔径等）。

  有疑惑的部分一定要及时沟通（如未提及的页面和功能需要确认的时候）