Post

03_进销存系统_接口功能

本项目进销存系统*"接口实现详细如下： 11模块及功能概： ： * **通用返回结构**：：业务操作结果应统一的包含代码、提示及数据。 " * **例子**： " "code": " " " "，操作成功" " " } */ **1登录模块 (**:包含用户身份验证相关接口。 * **示例登录 **"适用于创建建立-session " " " "code": " " "登录成功" " " " " " " " " " " " " "管理员" " " " " " " " " 。 " " " " " " " " " " " " ** **示例登出** " �清除 session " " " " "退出成功" " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " ** **仪表盘模块 ( "提供获取展示在 dashboard 关关重要的经营数据 * **示例获取统计数据 " " " " "经营数据如 " " " " " 1 " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " ** **商品分类模块 ( "包含创建、修改、删除关键词关接口操作" " **示例获取分类列表 " " " " " 数码" " " " " " �电品" " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " ** **购买商品模块 ( "包含查询、创建、修改、删关商品接口操行)" **示例添加商品 " " " " "家用电器" " " " " " "1 " " " " " " " ** **客户管理模块 ( "与客户相关信息操作的接口" " **示例添加客户 " " " " "李四" " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " ** **订单管理模块 ( 有序相关接口集 " **示例创建订单 " " " " " "北京大家" " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " " ** 上述接口实现贴近实际业务需求，覆盖主要模块功能，使得用户操作的数据交互流明且条理。 。

进销存项目 阅读 1 点赞 0 评论 0

· 03_进销存系统_接口功能介绍

[TOC]

一、接口概述

本项目遵循 RESTful 风格设计 API。所有接口返回数据格式统一为 Result<T> 对象。

统一返回结构：

{
  "code": 200,          // 业务状态码：200成功，其他失败
  "message": "操作成功", // 提示信息
  "data": { ... }       // 业务数据
}

二、模块接口详解

1. 登录模块 (Login)

1.1 用户登录

  • 描述：校验用户名密码，成功后返回用户信息并建立 Session。
  • 请求方式：POST
  • 请求路径：/api/login
  • 请求参数 (Body JSON)：
    {
  "username": "admin",
  "password": "123"
}
  • 响应数据：
    {
  "code": 200,
  "message": "登录成功",
  "data": {
    "id": 1,
    "username": "admin",
    "nickname": "管理员",
    "avatar": "..."
  }
}

1.2 用户登出

  • 描述：清除当前用户的 Session 信息。
  • 请求方式：GET
  • 请求路径：/api/logout
  • 请求参数：无
  • 响应数据：
    { "code": 200, "message": "退出成功", "data": null }

2. 仪表盘模块 (Dashboard)

2.1 获取统计数据

  • 描述：获取首页顶部展示的核心经营数据。
  • 请求方式：GET
  • 请求路径：/api/dashboard/stats
  • 请求参数：无
  • 响应数据：
    {
  "code": 200,
  "data": {
    "totalProducts": 150,     // 商品总数
    "todayOrders": 12,        // 今日订单数
    "totalSales": 5600.00     // 今日销售额
  }
}

3. 商品分类模块 (Category)

3.1 获取分类列表

  • 描述：查询所有商品分类，用于下拉筛选或列表展示。
  • 请求方式：GET
  • 请求路径：/api/categories
  • 请求参数：无
  • 响应数据：
    {
  "code": 200,
  "data": [
    { "id": 1, "name": "电子数码", "sortOrder": 1 },
    { "id": 2, "name": "办公用品", "sortOrder": 2 }
  ]
}

3.2 添加分类

  • 描述：新增一个商品分类。
  • 请求方式：POST
  • 请求路径：/api/categories
  • 请求参数 (Body JSON)：
    {
  "name": "家用电器",
  "description": "冰箱洗衣机等",
  "sortOrder": 5
}
  • 响应数据：{ "code": 200, "message": "操作成功" }

3.3 更新分类

  • 描述：修改商品分类信息。
  • 请求方式：PUT
  • 请求路径：/api/categories
  • 请求参数 (Body JSON)：
    {
  "id": 1,
  "name": "新电子数码",
  "sortOrder": 10
}
  • 响应数据：{ "code": 200, "message": "操作成功" }

3.4 删除分类

  • 描述：逻辑删除指定分类。
  • 请求方式：DELETE
  • 请求路径：/api/categories/{id}
  • 请求参数 (Path)：id (分类ID)
  • 响应数据：{ "code": 200, "message": "操作成功" }

4. 商品管理模块 (Product)

4.1 获取商品列表 (分页)

  • 描述：分页查询商品，支持按名称模糊搜索和按分类筛选。
  • 请求方式：GET
  • 请求路径：/api/products
  • 请求参数 (Query)：
    参数名 必填 类型 说明 示例
    page 否 int 页码 1
    size 否 int 每页条数 10
    name 否 string 商品名称(模糊) “手机”
    categoryId 否 long 分类ID 1
  • 响应数据：
    {
  "code": 200,
  "data": {
    "records": [
      {
        "id": 10,
        "name": "iPhone 15",
        "price": 5999.00,
        "stock": 100,
        "categoryName": "电子数码"
      }
    ],
    "total": 50,
    "current": 1,
    "size": 10
  }
}

4.2 添加商品

  • 描述：新增一个商品。
  • 请求方式：POST
  • 请求路径：/api/products
  • 请求参数 (Body JSON)：
    {
  "categoryId": 1,
  "name": "MacBook Pro",
  "price": 12999.00,
  "stock": 20,
  "status": 1
}
  • 响应数据：{ "code": 200, "message": "操作成功" }

4.3 更新商品

  • 描述：修改商品信息（如调整价格或库存）。
  • 请求方式：PUT
  • 请求路径：/api/products
  • 请求参数 (Body JSON)：
    {
  "id": 10,
  "name": "MacBook Pro M3",
  "price": 13999.00
}
  • 响应数据：{ "code": 200, "message": "操作成功" }

4.4 删除商品

  • 描述：逻辑删除指定商品。
  • 请求方式：DELETE
  • 请求路径：/api/products/{id}
  • 请求参数 (Path)：id (商品ID)
  • 响应数据：{ "code": 200, "message": "操作成功" }

5. 客户管理模块 (Customer)

5.1 获取客户列表

  • 描述：查询所有客户，支持返回客户ID、姓名、电话等信息，用于在销售开单时进行选择。
  • 请求方式：GET
  • 请求路径：/api/customers
  • 请求参数：无
  • 响应数据：
    {
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 1,
      "name": "张三",
      "phone": "13800138000",
      "address": "北京市海淀区",
      "email": "zhangsan@atguigu.com"
    }
  ]
}

5.2 添加客户

  • 描述：录入新的客户档案信息。
  • 请求方式：POST
  • 请求路径：/api/customers
  • 请求参数 (Body JSON)：
    {
  "name": "李四",
  "phone": "13900139000",
  "address": "上海市浦东新区",
  "email": "lisi@atguigu.com"
}
  • 响应数据：{ "code": 200, "message": "操作成功", "data": null }

5.3 更新客户

  • 描述：修改已有客户的联系方式或地址信息。
  • 请求方式：PUT
  • 请求路径：/api/customers
  • 请求参数 (Body JSON)：
    {
  "id": 2,
  "name": "李四",
  "phone": "13912345678",
  "address": "上海市徐汇区"
}
  • 响应数据：{ "code": 200, "message": "操作成功", "data": null }

5.4 删除客户

  • 描述：逻辑删除指定客户（不物理删除数据），删除后该客户将不再出现在列表中。
  • 请求方式：DELETE
  • 请求路径：/api/customers/{id}
  • 请求参数 (Path)：id (客户ID，如 2)
  • 响应数据：{ "code": 200, "message": "操作成功", "data": null }

6. 订单管理模块 (SaleOrder)

6.1 创建订单 (核心)

  • 描述：提交订单信息，包含客户ID和多个商品明细，系统自动扣减库存。
  • 请求方式：POST
  • 请求路径：/api/orders
  • 请求参数 (Body JSON)：
    {
  "customerId": 1,
  "items": [
    { "productId": 10, "quantity": 2 },
    { "productId": 11, "quantity": 1 }
  ]
}
  • 响应数据：{ "code": 200, "message": "订单创建成功" }

6.2 获取订单列表

  • 描述：分页查询历史订单。
  • 请求方式：GET
  • 请求路径：/api/orders
  • 请求参数 (Query)：page, size, orderNo
  • 响应数据：
    {
  "code": 200,
  "data": {
    "records": [
      {
        "id": 1001,
        "orderNo": "202312260001",
        "customerName": "张三",
        "totalAmount": 1200.00,
        "status": 0,
        "createTime": "2023-12-26 10:00:00"
      }
    ],
    "total": 20
  }
}

6.3 更新订单状态

  • 描述：修改订单流转状态（如：发货、完成）。
  • 请求方式：PUT
  • 请求路径：/api/orders/{id}/status
  • 请求参数 (Query)：
    • status: 状态码 (0-待处理, 1-已完成, 2-已取消)
  • 响应数据：{ "code": 200, "message": "操作成功" }
#进销存系统
Administrator

作者

Administrator
↗

继续阅读

全部归档
07_前端开发基础_Vue3实战(前端工程化讲解)
07_前端开发基础_Vue3实战(前端工程化讲解)

本 绹 本篇章内容强调两大前端模块的构建：登录和商品管理。核心在于与后端接口的有效对接，确保交互流畅且准确。关键观点体现在使用 **Vue 3 来实现表单验证与数据交互、Element Plus 提供的组件以简化UI设格，以及通过`Axios" 增强的数据请求功能。。 登录功能涉及验证表单输入、发送 POST 请求至 `/api/login`，并实现成功后的页面路由跳转。商品管理模块则扩展了商品增删改查（CRUD) 的操作，从基本数据获取到包含分页、搜索、新增、编辑、和删除功能的完整实现。 具体而言，通过 Vue 3 的组合式 API 创建响应式数据及事件处理，通过 Element Plus 的表表组件渲染即时数据集，并利用 Element Plus 的对话框实现用户输入验证和数据提交。后代表现和交互处理的整体现示了前端应用的多余层次与动态响应能力。
06_进销存系统_进阶功能
06_进销存系统_进阶功能

该该简要摘要涵盖了 Excel 导出和定时任务的核心内容， .以及相关的关键结论和细节和技术收益: --- 在使用进销存系统中的改进功能。 弳主要有两项： . 一是 1 . . 1 . . . . . . . . . 开` . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 摘要： : 该系统进销存 . 中加入的两项改进功能: 包括使用 .Excel �导出功能和定时任务. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

评论