QShop开源项目教程

1. 项目目录结构及介绍

QShop项目的目录结构如下：

QShop/
├── 1_Api             # API服务层目录
├── 2_UniApp          # 前端uni-app项目目录
├── 3_PcAdmin         # 后台管理系统目录
├── 8_数据库脚本       # 数据库脚本和SQL文件
├── .gitignore        # git忽略文件
├── LICENSE           # 开源许可证文件
├── README.en.md      # 英文项目说明文件
├── README.md         # 项目说明文件

1.1 API服务层（1_Api）

该目录包含了后端API接口的代码，使用.NET 6开发。

1.2 前端uni-app项目（2_UniApp）

这是uni-app框架开发的移动端代码，可以编译为微信小程序、H5应用等。

1.3 后台管理系统（3_PcAdmin）

该目录包含了后台管理系统的前端代码，使用Vue.js框架开发。

1.4 数据库脚本（8_数据库脚本）

包含数据库初始化和更新的SQL脚本，适用于MySQL或SqlServer。

1.5 其他文件

• .gitignore: 指定Git版本控制时需要忽略的文件和目录。
• LICENSE: 项目使用的开源许可证，本项目采用LGPL-2.1许可证。
• README.md: 项目说明文件，包含项目的基本信息和使用说明。

2. 项目的启动文件介绍

2.1 API服务层启动

API服务层通常使用.NET 6的命令行工具来启动。在1_Api目录下，执行以下命令：

dotnet run

这将启动.NET 6内置的Web服务器，并开始监听HTTP请求。

2.2 前端uni-app项目启动

前端uni-app项目需要使用HBuilderX或命令行工具启动。在2_UniApp目录下，执行以下命令：

npm run dev

这将启动uni-app的模拟器，用于开发调试。

2.3 后台管理系统启动

后台管理系统通常需要构建前端代码，并在Web服务器上部署。在3_PcAdmin目录下，执行以下命令：

npm install
npm run serve

这将启动Vue.js的开发服务器。

3. 项目的配置文件介绍

3.1 API服务层配置

API服务层使用appsettings.json文件进行配置，该文件通常位于1_Api目录下的Properties文件夹中。以下是配置文件的基本结构：

{
  "ConnectionStrings": {
    "DefaultConnection": "Your Connection String Here"
  },
  "Logging": {
    // 日志配置
  }
  // 其他配置项
}

在此文件中，可以配置数据库连接字符串、日志记录等信息。

3.2 前端uni-app项目配置

uni-app项目的配置文件位于2_UniApp目录中，主要包括manifest.json（项目配置文件）和pages.json（页面配置文件）等。

manifest.json文件定义了项目的名称、应用图标、权限声明等信息。

pages.json文件定义了应用的页面结构、窗口表现等。

3.3 后台管理系统配置

后台管理系统使用Vue.js框架，其配置文件主要包括：

• vue.config.js: Vue.js项目的配置文件，可以配置Webpack等相关选项。
• .env.development: 开发环境的变量配置文件。

在.vue.config.js文件中，可以配置代理来解决开发环境下的跨域问题，以及其他构建相关的配置。