产品/服务目录

产品/服务目录Mewayz

产品/服务附加组件是会计、CRM、POS、EcomStore 和 Bookings 使用的共享库存目录。

Mewayz-原始模块 — 没有 Mewayz 上游。文档由包源编写，位于 packages/mewayz/ProductService/。

演示网址

简介

产品/服务附加组件是 单一事实来源 对于 Mewayz 平台上的每件可销售商品。所有模块都从一个共享目录中读取和写入，而不是每个模块（销售、POS、EcomStore、预订）维护自己的产品列表。这意味着当操作员在产品/服务中创建新产品时，该产品可以立即在每个销售平台上使用，并具有同步的库存计数和税收规则。

该模块涵盖具有库存跟踪功能的实物商品、按小时或每次会话定价的非库存服务、多仓库库存、分层类别、每行税收规则和计量单位。

如何启用该模块

要设置产品/服务附加组件，您可以点击以下链接： 设置附加组件。

该附加组件的门控是 PlanModuleCheck:ProductService。大多数面向销售的计划默认将其捆绑在一起——POS、Account、EcomStore 和 Bookings 都依赖于它的活动。

项目

浏览商品

• 导航至 产品与服务 → 项目 在侧边栏中。
• 列表视图显示操作员可以管理的所有项目，并带有过滤器 名称, 类型 （产品或服务）， 类别, 和 活跃状态。
• 每行显示 SKU、销售价格、采购价格、当前仓库库存总数和快速操作按钮（查看、编辑、删除）。

创建一个新项目

• 点击 + 新项目 在项目列表的右上角。
• 该表单具有以下字段：
• 名称 — 在整个平台的下拉列表中显示的显示名称
• 类型 — 产品（库存跟踪）或服务（无库存）
• 存货单位 — 可选的库存单位（每个租户都是唯一的）
• 类别 — 从现有类别中选择，或创建一个新的内联类别
• 单位 — 计量单位（每、公斤、小时、平方米等）
• 销售价格 — 此商品出现在发票或订单上时的默认价格
• 购买价格 — 接收库存时的默认成本
• 税收 — 多选适用于该项目的税率
• 图片 — EcoStore + POS 使用的产品图片
• 描述 ——长篇描述；由 EcoStore 详细信息页面使用
• 点击 保存 创建该项目。一个事件（CreateProductServiceItem) 被调度，以便其他模块中的侦听器可以做出反应（例如，搜索索引重新索引）。

编辑/删除项目

• 从项目列表中，单击该行的编辑按钮以打开填充有该项目数据的同一表单。
• 删除发货项目 DestroyProductServiceItem。如果该项目由现有发票、订单或 POS 销售引用，则基础行为 软删除 因此历史记录可以保持数据完整。

库存管理

• 导航至 产品与服务 → 库存 在侧边栏中。
• 库存视图按以下方式对项目进行分组 仓库 因此，拥有多个物理位置的操作员可以看到每个位置的准确数量。
• 每行显示物料、仓库、当前数量和最后移动日期。

添加或调整库存

• 点击 添加库存 记录股票走势。
• 选择 项目, 的 仓库, 的 数量 （入站为正，出站为负），以及 注意事项。
• 每个动作都会被记录；目录不仅仅是“更新一些数字”——每项更改都是可审核的。

类别

• 导航至 产品与服务 → 类别。
• 类别是扁平的或分层的（父→子）。每个类别可以有一个 颜色标签 这反映在商品列表和 EcoStore 列表页面上。
• 创建/编辑/删除操作遵循标准的 CRUD 模式。

税收

• 导航至 产品与服务 → 税收。
• 添加运营商业务所需的税率（例如增值税 15%、销售税 7.25% 等）。
• 每个税种都有一个 姓名, 率 （百分比），以及可选的 描述。
• 然后通过项目表单上的多项选择将税费附加到项目上。

单位

• 导航至 产品与服务 → 单位。
• 单位是购物车/发票行中显示的标签 - “每个”、“公斤”、“小时”、“会话”、“平方米”等。
• Mewayz 运送入门套件；添加或重命名以匹配运营商的行业词汇。

跨模块行为

其他Mewayz模块 消费 产品/服务目录：

• 账户 模块 — 销售发票和采购发票从此目录中选取行项目。
• 客户关系管理/销售 — 交易订单项和提案参考项。
• 销售点 模块——POS销售直接拉取商品列表。
• 生态商店 模块 - 店面产品通过基于类别的浏览从此目录呈现。
• 预订 模块 - 可预订服务的服务目录。
• Api文档生成器 模块 — 记录用于编程访问的公共 API 端点（/api/products， ETC。）。

权限

该包定义了细粒度的权限：

• manage-product-service-item — 全面管理
• create-product-service-item — 创建新项目
• manage-any-product-service-item — 编辑任何租户项目
• manage-own-product-service-item — 仅编辑自己创建的项目

通过分配这些 设置 → 角色和权限。

API访问

包里还暴露了 GET /api/product-service/items 作为其他模块和 API 文档生成器表面的内部经过身份验证的端点 GET /api/products。

操作员注意事项

• 股票走势是一成不变的 — 要“反转”运动，请记录相反方向的新运动，而不是编辑原始行。
• 删除现有库存的商品时，系统会在允许操作之前发出警告。
• 项目图像存储在 storage/app/public/product-service/ 并通过 storage 符号链接。上传新图像后，它会被标准化为数据库中的单个文件名；公共 URL 在渲染时计算。