# mythos

**Repository Path**: jsen/mythos

## Basic Information

- **Project Name**: mythos
- **Description**: 采用Spring Boot 3.3 + Spring Cloud Alibaba微服务架构，DDD领域驱动设计，包含8大核心域。集成AI知识库助手，基于RAG技术实现智能问答、多轮对话，支持技术规范查询与故障排查。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: http://ifarmshop.com/admin/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-17
- **Last Updated**: 2026-02-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 神话商城 (Mythos B2C E-commerce Platform)

一个基于微服务架构、领域驱动设计（DDD）的现代化 B2C 电商平台。

## 项目简介

神话商城是一个企业级 B2C 电商解决方案，采用前后端分离架构，支持商品管理、订单处理、用户体系、营销活动、库存管理等完整电商业务场景。

## 系统架构

### 领域划分（8大核心域）

```
├── 基础设施域：用户中心、SSO中心、权限中心、API网关、组织中心
├── 商品域：商品中心、类目中心、库存中心、价格中心、品牌中心
├── 交易域：购物车、订单中心、支付中心、结算中心
├── 营销域：促销中心、优惠券中心、会员中心、积分中心
├── 内容域：CMS、评价中心、搜索服务、推荐服务
├── 履约域：仓储中心、物流中心、售后中心
├── 运营域：OPS平台、客服系统、工单系统、风控中心
└── 数据域：数据仓库、BI系统、日志分析、监控中心
```

### 技术架构

```
                     Nginx Gateway (网关)
                            ↓
        ┌──────────────────┼──────────────────┐
        ↓                  ↓                   ↓
   前端应用          API Gateway         后端微服务
  ┌────────┐        ┌─────────┐        ┌──────────┐
  │ Admin  │        │ 路由转发 │        │  SSO     │
  │ Mall   │   →    │ 鉴权过滤 │   →    │  Product │
  └────────┘        │ 限流熔断 │        │  Order   │
                    └─────────┘        │  ...     │
                                       └──────────┘
```

## 技术栈

### 后端技术

| 技术 | 版本 | 说明 |
|-----|------|------|
| Java | 17+ | 开发语言 |
| Spring Boot | 3.3.0 | 应用框架 |
| Spring Cloud | 2023.0.2 | 微服务框架 |
| Spring Cloud Alibaba | 2023.0.1.0 | 阿里微服务组件 |
| MyBatis-Plus | 3.5.6 | ORM 框架 |
| MySQL | 8.4.0 | 关系型数据库 |
| Redis | - | 缓存中间件 |
| Nacos | - | 服务注册与配置中心 |
| Dubbo | 3.2.5 | RPC 框架 |
| Maven | 3.6.0+ | 项目构建工具 |

### 前端技术

| 技术 | 版本 | 说明 |
|-----|------|------|
| Vue 3 | 3.5.13 | 渐进式框架 |
| TypeScript | 5.7.2 | 类型系统 |
| Vite | 6.4.1 | 构建工具 |
| Element Plus | 2.9.1 | UI 组件库 (Admin) |
| Vue Router | 4.4.5 | 路由管理 |
| Pinia | 2.2.6 | 状态管理 |
| Axios | 1.7.9 | HTTP 客户端 |

## 项目结构

```
myth-claude/
├── backend/                          # 后端代码
│   ├── mythos-dependence-parent/     # 依赖版本管理
│   ├── mythos-common-parent/         # 通用组件
│   │   ├── mythos-common-base/       # 基础工具类
│   │   └── mythos-common-web/        # Web 通用组件
│   ├── mythos-sso-center/            # SSO 认证中心
│   ├── mythos-permission-center/     # 权限中心
│   ├── mythos-gateway/               # API 网关
│   ├── mythos-user-center/           # 用户中心
│   ├── mythos-organization-center/   # 组织中心
│   └── mythos-product-domain/        # 商品域
│       ├── mythos-product-center/    # 商品中心
│       ├── mythos-category-center/   # 类目中心
│       ├── mythos-inventory-center/  # 库存中心
│       ├── mythos-price-center/      # 价格中心
│       └── mythos-brand-center/      # 品牌中心
├── frontend/                         # 前端代码
│   ├── mythos-admin/                 # 管理后台 (B端)
│   ├── mythos-mall/                  # 商城前台 (C端)
│   └── nginx-gateway/                # Nginx 网关配置
└── design/                           # 设计文档
    └── 神话B2C顶层设计.md
```

## 核心特性

### 后端特性
- **微服务架构**：服务独立部署，易于扩展
- **DDD 设计**：领域驱动，业务边界清晰
- **统一网关**：路由转发、鉴权、限流、熔断
- **多租户支持**：支持多应用、多用户类型
- **分布式事务**：Seata 保证数据一致性
- **服务治理**：Nacos 注册中心、配置中心
- **全链路追踪**：TraceId 贯穿请求全流程

### 前端特性
- **双端应用**：管理后台 + 商城前台
- **TypeScript**：类型安全，代码可维护
- **响应式设计**：适配多种设备
- **组件化开发**：可复用 UI 组件
- **Docker 部署**：容器化部署，环境一致

## 快速开始

### 后端启动

```bash
# 进入后端目录
cd backend

# 构建项目
mvn clean install -DskipTests

# 启动微服务（以 SSO 中心为例）
cd mythos-sso-center/mythos-sso-application
mvn spring-boot:run
```

### 前端启动

```bash
# 管理后台
cd frontend/mythos-admin
npm install
npm run dev
# 访问：http://localhost:5173/admin/

# 商城前台
cd frontend/mythos-mall
npm install
npm run dev
# 访问：http://localhost:5173/mall/
```

### Docker 部署

```bash
# 构建前端镜像
cd frontend/mythos-admin
docker build -t mythos-admin:latest .

cd frontend/mythos-mall
docker build -t mythos-mall:latest .

# 启动容器
docker run -d --name mythos-admin -p 8081:80 mythos-admin:latest
docker run -d --name mythos-mall -p 8082:80 mythos-mall:latest
```

## 开发规范

- **代码风格**：遵循阿里巴巴 Java 开发规范
- **代码格式化**：使用 google-java-format (AOSP 风格，4空格缩进)
- **分层架构**：Controller → Service → Repository → Mapper
- **命名规范**：类名、方法名、变量名遵循统一规范
- **日志规范**：使用 TraceLogger，包含 TraceId
- **异常处理**：统一异常处理，规范错误码

## 在线访问

- **管理后台**: http://ifarmshop.com/admin/
    - admin / Admin@123

## 项目文档

详细开发规范和架构设计请参考：
- [CLAUDE.md](CLAUDE.md) - 开发指南和项目规范
- [design/神话B2C顶层设计.md](design/神话B2C顶层设计.md) - 完整架构设计文档
- [frontend/design/前端Docker部署方案.md](frontend/design/前端Docker部署方案.md) - 前端部署方案

## 许可证

Copyright © 2025 Mythos Team