9.16/1

doc/requirements.md

@@ -0,0 +1,167 @@
+* ### **配件查询App需求规格说明书**
+
+  #### 1.0 项目概述
+  本项目旨在开发一款面向小微商户的移动端进销存管理应用，命名为“配件查询”。该应用核心功能是帮助用户高效管理商品、库存、销售、采购、客户、供应商及财务收支，并通过数据报表提供经营状况分析，助力商户实现数字化经营。
+  参考的小程序“智慧记进销存”，但是多了一个配件查询功能，以下所罗列的内容大多也参考至该小程序，如有歧义可优先参照这个小程序，拿不准优先问。
+  
+  #### 2.0 功能模块需求
+  
+  **2.1 首页 (Dashboard)**
+  
+  *   **2.1.1 核心数据概览:** 首页需直观展示当日、当月的核心经营数据。
+      
+      *   今日销售额
+      *   本月销售额
+      *   本月利润
+      *   库存商品数量
+      
+      **2.1.2 广告位:** 在首页区域提供一个展示广告的区域。
+      
+  *   **2.1.3 快捷功能入口:** 提供一个快捷功能区域，方便用户快速访问常用功能。
+      
+      *   默认应包含：客户管理、销售开单、账户管理、供应商管理、进货开单、其他支出、VIP会员、报表统计等。
+      
+  *   **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 用户信息:** 显示用户头像、店铺名称、注册手机号及“老板”身份标识。
+  *   **2.6.2 会员与订单:**
+      *   提供**VIP会员**入口，展示会员特权。
+      *   提供**我的订单**入口，可能用于查看应用内服务订单。
+  *   **2.6.3 基础管理:**
+      *   **供应商管理**
+      *   **客户管理**
+      *   **客户报价**
+      *   **店铺管理**
+  *   **2.6.4 设置中心:**
+      *   **账号与安全:**
+          *   修改个人信息（头像、姓名）。
+          *   修改登录密码。
+      *   **商品设置:**
+      *   **系统参数:**
+          *   提供多种业务逻辑开关，如：“销售价低于进货价时提示”、“销售单默认全部收款”、“启用单行折扣”、“启用客户/供应商双身份”。
+      *   **关于与协议:** 包含“关于我们”、“隐私协议”、“个人信息安全投诉”等静态页面。
+      *   **账号操作:** 提供“账号注销”和“退出登录”功能。
+  
+  #### 3.0 全局性需求
+  
+  *   **3.1 导航:** 采用底部Tab栏导航，包含“首页”、“货品”、“开单”、“明细”、“我的”五个主要模块。
+  *   **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与小程序；小程序不支持商品条形码扫描功能。
+  
+  * **3.9 多列销售价格：** 销售价格分四列，即同一种商品有四个销售价格
+  
+    ### 配件查询
+  
+  1. **数据查询功能**
+     - 多参数组合查询（分类、尺寸、型号等）
+     - 模糊匹配关键字
+     - 分页展示查询结果
+     - 一键导出Excel数据
+  2. **数据提交系统**
+     - 用户提交新配件数据
+     - 型号为唯一必填项
+     - 支持图片上传
+     - 提交后等待管理员审核
+  3. **审核管理系统**
+     - 管理员查看待审核列表
+     - 可编辑所有字段
+     - 支持图片更新和删除
+     - 一键批准或拒绝提交
+  4. **图片管理系统**
+     - 每条数据可关联多张图片
+     - 点击图片可放大查看
+     - 管理员可管理所有图片
+     - 自动处理文件名冲突
+  
+  ## 全局说明（必看）
+  
+  由于这个文档写的还不是很完善，目前有存疑的部分先行参考小程序小程序“智慧记进销存”（功能和按钮可以参考，界面样式除外），管理端文档目前待定。
+  
+  客户要求的是做双端应用（app端+小程序端），需要考虑兼容性相关问题。
+  
+  本程序和“智慧记进销存”大多一致，主要的区别在于客户有配件查询要求，即在产品页面中要额外加一个配件查询按钮或入口，且要求一个产品要有四个销售价格（先按零售价 分销价 批发价  大客户价），且要求能自定义添加各种规格（尺寸，孔径等）。
+  
+  有疑惑的部分一定要及时沟通（如未提及的页面和功能需要确认的时候）
+