Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/trueai-org/module-shop
一个基于 .NET 8.0 构建的简单、跨平台、模块化的商城系统
https://github.com/trueai-org/module-shop
aspnetcore cross-platform csharp dotnetcore ecommerce entity-framework-core modular module net8 net8-web-api netcore shop shopping-cart
Last synced: about 1 month ago
JSON representation
一个基于 .NET 8.0 构建的简单、跨平台、模块化的商城系统
- Host: GitHub
- URL: https://github.com/trueai-org/module-shop
- Owner: trueai-org
- License: mit
- Created: 2019-04-26T09:19:44.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-29T19:38:09.000Z (3 months ago)
- Last Synced: 2024-09-29T22:23:56.081Z (about 1 month ago)
- Topics: aspnetcore, cross-platform, csharp, dotnetcore, ecommerce, entity-framework-core, modular, module, net8, net8-web-api, netcore, shop, shopping-cart
- Language: C#
- Homepage: https://demo.shopapi.circle.ac.cn/swagger
- Size: 13 MB
- Stars: 809
- Watchers: 26
- Forks: 277
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Module Shop
一个基于 .NET 8.0 构建的简单、跨平台、模块化的商城系统
**推荐项目👍👍**
[https://github.com/trueai-org/mdrive](https://github.com/trueai-org/mdrive)
> 使用 .NET 8.0，一个基于阿里云盘官方 API 授权的自动同步和备份工具，支持云盘挂载到本地，多平台、安全、自动化的数据管理方案，欢迎收藏与支持！
[https://github.com/trueai-org/midjourney-proxy](https://github.com/trueai-org/midjourney-proxy)
> 代理 Midjourney 的 Discord 频道，实现 api 形式调用 AI 绘图（C# 版本），公益项目，全球 AI 模型免费使用，欢迎收藏与支持！
**跨平台**
> Docker, Windows, Linux, Mac. Microsoft SQL Server, PostgreSQL, MySQL, SQLite
**模块化**
> 该应用程序分为许多自包含模块
**免费并且开源**
> ModuleShop完全免费并且开源
## 后台服务 / API
项目地址：/src/server
#### 接口文档
> 包含对业务的中文说明和注释。
> 支持 Swagger 免输入 token 在线调用接口（自动记忆），请使用 MockApi 模拟用户登录，在线调试 API。
在线文档：[https://demo.shopapi.circle.ac.cn/swagger](https://demo.shopapi.circle.ac.cn/swagger)
管理后台：[https://demo.shop.circle.ac.cn](https://demo.shop.circle.ac.cn) *admin/123456*
| API 名称 | 描述 |
|-------------------------|----------------------------------------------------------------------------------------|
| MockApi | 模拟 API 控制器，仅用于开发环境和演示站点，用来模拟超管、买家用户、重置样本数据、重置测试账号密码等。 |
| AccountApi | 账户API控制器，提供账号、登录、用户信息等功能。 |
| AppSettingApi | 管理后台控制器用于处理应用程序设置相关操作的 API 请求。 |
| CacheApi | 管理后台控制器用于处理缓存相关操作的 API 请求。 |
| CountryApi | 管理后台控制器用于处理国家和省份相关操作的 API 请求。 |
| SystemApi | 管理后台系统服务相关 API |
| TokenApi | 管理后台令牌服务相关 API |
| UploadApi | 上传服务相关 API |
| UserAddressApi | 用户收货地址相关 API |
| UserApi | 管理后台用户 API 控制器，包含用户相关操作的接口。 |
| WidgetCarouselApi | 小部件轮播 API 控制器，提供轮播部件相关的接口操作。 |
| WidgetHtmlApi | 小部件 Html API 控制器，提供 HTML 部件相关的接口操作。 |
| WidgetInstanceApi | 小部件实例 API 控制器，提供部件实例相关的接口操作。 |
| BrandApi | 品牌管理API控制器，提供品牌的增删改查等功能。 |
| CategoryApi | 商品分类API控制器，负责商品分类的管理操作，如查询、创建、更新和删除。 |
| ProductApi | 商品管理API控制器，负责商品的增删改查等管理操作。 |
| ProductAttributeApi | 商品属性API控制器，负责商品属性的管理操作，如查询、创建、更新和删除。 |
| ProductAttributeGroupApi| 商品属性组API控制器，负责商品属性组的管理操作，如查询、创建、更新和删除。 |
| ProductAttributeTemplateApi| 产品属性模板的API控制器，负责管理产品属性模板的相关操作。 |
| ProductOptionApi | 产品选项API控制器，负责管理产品选项的相关操作。 |
| RecentlyViewedApi | 最近浏览API控制器，负责管理用户的最近浏览商品记录。 |
| UnitApi | 单位API控制器，负责管理商品单位。 |
| WidgetCategoryApi | 管理后台控制器用于处理小部件类别相关操作的 API 请求。 |
| WidgetProductApi | 管理后台控制器用于处理小部件产品相关操作的 API 请求。 |
| WidgetRecentlyViewedApi | 管理后台控制器用于处理最近浏览小部件相关操作的 API 请求。 |
| WidgetSimpleProductApi | 管理后台控制器用于处理简单产品小部件相关操作的 API 请求。 |
| WishlistApi | 控制器用于处理心愿单相关操作的 API 请求。 |
| StockHistoryApi | 库存历史 API 控制器，用于管理和查询库存变更历史记录。 |
| WarehouseApi | 仓库管理API控制器，提供仓库的增删改查等功能。 |
| FreightTemplateApi | 运费模板 API 控制器，负责管理运费模板相关的操作。 |
| PriceAndDestinationApi | 运费价格与目的地 API 控制器，负责管理运费模板内的具体运费规则。 |
| CheckoutApi | 结算 API 控制器，用于处理购物车、单个商品和订单的结算操作。 |
| CustomerOrderApi | 客户订单 API 控制器，用于处理客户订单相关的操作。 |
| OrderApi | 管理员订单 API 控制器，处理订单的管理和操作。 |
| OrderHistoryApi | 订单历史 API 控制器，用于管理和查询订单历史记录。 |
| ShipmentApi | 发货 API 控制器，负责管理发货单相关操作。 |
| CartApi | 购物车 API 控制器，负责处理购物车相关操作。 |
| MPApi | 微信小程序API控制器，用于处理微信小程序相关的请求，如登录。 |
| MpPayApi | 微信支付API控制器，用于处理微信支付相关的通知和请求。 |
| AdminReplyApi | 管理员回复 API 控制器，用于处理管理员对评论的回复操作。 |
| AdminReviewApi | 管理员评论 API 控制器，用于管理商品评论。 |
| ReplyApi | 评论回复 API 控制器，用于处理评论的回复操作。 |
| ReviewApi | 评论 API 控制器，负责处理评论相关操作。 |
| SupportApi | 点赞 API 控制器，负责处理点赞相关操作。 |
| FeedbackApi | 反馈API控制器，用于处理用户反馈相关的请求。 |
| SampleData | 示例数据控制器，用于管理和操作示例数据的重置和生成。 |
| CatalogApi | 商品目录 API 控制器，提供商品目录相关的 API 接口。 |
| GoodsApi | 商品 API 控制器，提供商品相关的 API 接口。 |
| HomeApi | 首页 API 控制器，提供用于处理首页相关内容的 API 接口。 |
#### Visual Studio 2022 和 SQL Server/ MySQL
**先决条件**
- SQL Server / MySQL 服务器
- Visual Studio 2022 和 .NET 8
### 项目结构
## 后台管理
项目地址：/src/client
在线预览：[https://demo.shop.circle.ac.cn](https://demo.shop.circle.ac.cn) *admin/123456*
前端框架：[Ant Design Pro](https://pro.ant.design)
使用文档：http://pro.ant.design/docs/getting-started-cn
### 项目截图
### 功能列表
+ 商品：分类、品牌、单位、选项（销售属性）、属性、属性模板、属性组
+ 销售：订单、物流
+ 内容：首页配置、评论、回复
+ 配置：国家、用户、仓库、运费、高级设置、~~主体化~~、~~本土化~~、~~税~~
+ 系统：样本数据
+ ~~活动：折扣~~
+ ~~首页：首页~~
## 微信小程序
项目地址：/src/mini-program
在线预览（天网商城）：
### 项目截图
### 功能列表
+ 首页
+ 分类首页、分类商品、新品首发、人气推荐、商品页面等、可通过后台配置
+ 商品详情页面，包含加入购物车、收藏商品、商品评论功能
+ 搜索功能
+ 完整的购物流程，商品的加入、编辑、删除、批量选择，收货地址的选择，下单支付
+ 会员中心（订单、收藏、足迹、收货地址、意见反馈）
....
### 项目结构
```
├─config
├─lib
│ └─wxParse
├─pages
│ ├─auth
│ │ ├─login
│ │ ├─register
│ │ └─reset
│ ├─brand
│ ├─brandDetail
│ ├─cart
│ ├─catalog
│ ├─category
│ ├─comment
│ ├─goods
│ ├─hotGoods
│ ├─index
│ ├─logs
│ ├─newGoods
│ ├─pay
│ ├─search
│ ├─shopping
│ │ ├─address
│ │ ├─addressAdd
│ │ └─checkout
│ ├─topic
│ ├─topicDetail
│ └─ucenter
│ ├─address
│ ├─addressAdd
│ ├─collect
│ ├─coupon
│ ├─feedback
│ ├─footprint
│ ├─index
│ ├─order
│ └─orderDetail
├─static
│ └─images
└─utils
```
## 交流
喜欢别忘了 Star，有问题可通过微信、公众号、QQ 群联系我，谢谢您的关注。
[ModuleShop交流群](https://jq.qq.com/?_wv=1027&k=5AUnOw5 "ModuleShop交流群（863275860）")（QQ群：863275860）
## 常见问题
#### 1. 如何初始化数据库？
> 确保安装了 EF Core，使用 EF 更新工具更新数据库。
详细参考：
#### 2. 在线演示站点登录不了怎么办？
> 打开 swagger https://demo.shopapi.circle.ac.cn/swagger 文档，调用 [[重置密码](https://demo.shop.circle.ac.cn/api/mock/reset-admin-password)] 密码接口，然后重新登录。
登录地址：[https://demo.shop.circle.ac.cn](https://demo.shop.circle.ac.cn) *admin/123456*