# black-bird-shopping

**Repository Path**: majian000/black-bird-shopping

## Basic Information

- **Project Name**: black-bird-shopping
- **Description**: 黑鸟电商平台(一款开源免费的电商网站)
采用技术spring cloud、spring config、lombok、eureka、hystrix、elasticsearch、kafka、shardingsphere、redis、mysql
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 3
- **Created**: 2021-01-28
- **Last Updated**: 2025-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 黑鸟商城

    一款开源免费的电商平台,每个人都可以免费使用定制自己的商城

#### 介绍
    采用技术spring cloud、spring config、lombok、eureka、hystrix、elasticsearch、kafka、shardingsphere、redis、mysql

#### 软件架构

##### 公共基础模块
    modules目录下包含订单编号生成、redis分布式锁、各种工具类等

##### 基础服务层
    base目录下包含配置中心、服务注册中心、网关等
    
##### 业务服务层
    services目录下包含商品服务、订单服务、秒杀服务、类别服务等
    export目录下包含商品服务导出类、订单服务导出类等实体以及VO相关
    api目录下包含商品服务、订单服务等feign接口
    center目录下包含用户中心、权限中心等
    starter目录下包含权限中心的插件
    
##### 应用层
    apps目录下包含商城pc端接口、商城管理端等


#### 安装教程

    按顺序依次启动下面项目


##### 依赖第三方
    1.mysql8
    2.redis 3.2
    3.apache-zookeeper-3.6.2
    4.kafka_2.12-2.7.0
    5.elasticsearch-7.10.2

##### 数据库

    
    商城库 resources/ddl/black_bird_shopping.sql
    商城首页、轮播图相关等
    
    订单库 resources/ddl/black_bird_shopping_order.sql
    主订单、子订单等
    
    商品库 resources/ddl/black_bird_shopping_product.sql
    商品SPU、商品SKU等
    
    库存   resources/ddl/black_bird_shopping_stock.sql
    商品库存等
    
    用户中心库 resources/用户中心
    记录用户信息、用户密码等
    
    地区服务库 resources/地区服务
    地区编码、轮播图等
    

##### 基础服务层
    1.base/black-bird-shopping-config-server
    端口号:9090
    配置中心服务

    2.base/black-bird-shopping-eureka
    端口号:8081
    服务中心

    3.base/black-bird-shopping-gateway
    端口号:8089
    服务网关
    
##### 业务服务层
    
    1.services/black-bird-shopping-product
    端口号:8082
    商品服务

    2.services/black-bird-shopping-order
    端口号:8084
    订单服务、支付服务

    3.services/black-bird-shopping-second-kill
    端口号:8085
    秒杀服务,使用请参考该项目目录下的README.MD
    
    4.services/black-bird-shopping-category
    端口号:8090
    类别服务
    
    5.services/black-bird-shopping-stock
    端口号:8093
    库存服务
    
    6.services/black-bird-shopping-area
    端口号:8094
    地区编码、收货地区服务
    
    
    7.services/black-bird-shopping-content
    端口号:8095
    新闻资讯服务
    
    
##### 中心服务层
    
    1.center/services/black-bird-shopping-user-center
    端口号:8087
    用户中心服务,使用请参考该项目目录下的README.MD
    
    2.center/services/black-bird-shopping-app-center
    端口号:8091
    应用中心服务,使用请参考该项目目录下的README.MD


##### 应用层  
    
    1.apps/black-bird-shopping-web
    端口号:8083
    前端界面服务,使用请参考该项目目录下的README.MD



    2.apps/black-bird-shopping-admin
    端口号:8086
    后台管理端,使用请参考该项目目录下的README.MD


    3.apps/black-bird-shopping-user-center-web
    端口号:8088
    用户中心界面

    4.apps/black-bird-shopping-scheduler
    端口号:8092
    商城调度任务端


    
    
    

#### 应用编码

    10001001 商城应用
    10001002 用户中心
    

#### 参与贡献
    1.majian
    2.niuyuxiao