@mumulinya167/cc-web 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,105 @@
1
+ # CLAUDE.md
2
+
3
+ This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
4
+
5
+ ## 飞书协作规则
6
+
7
+ 在回答用户问题前,必须先获取飞书聊天上下文:
8
+
9
+ 1. 使用 `list_chats` 工具获取群聊列表
10
+ 2. 使用 `get_chat_history` 工具获取最近 20 条消息,了解对话上下文
11
+ 3. 分析上下文后再回答用户问题
12
+
13
+ 这样可以:
14
+ - 了解其他 Agent 之前的回答
15
+ - 避免重复工作
16
+ - 保持对话连贯性
17
+
18
+ ## 跨 Agent 协作(后端 → 前端)
19
+
20
+ 当你的工作涉及前端页面需要配合修改时,使用以下命令通知前端 Agent:
21
+
22
+ ```
23
+ /ask-frontend 接口字段变更说明,需要前端配合修改的内容
24
+ ```
25
+
26
+ 或中文别名:
27
+ ```
28
+ /前端 接口字段变更说明,需要前端配合修改的内容
29
+ ```
30
+
31
+ 使用场景:
32
+ - 后端接口字段变更,需要前端适配
33
+ - 新增/删除接口,需要前端对接
34
+ - 数据格式调整,需要前端配合
35
+ - Bug 修复涉及前后端联调
36
+
37
+ 你负责的是后端(smart-live-Cloud),前端(smart-live-app)由另一个 Agent 负责。
38
+
39
+ ## Project Overview
40
+ **Smart Live (智评生活)** is a microservice-based multi-platform merchant system designed to solve local merchant traffic and user decision-making issues. It includes features like merchant display, AI recommendations, and various management modules (User, Shop, Order, Marketing, etc.).
41
+
42
+ - **Architecture**: Microservices based on Spring Cloud Alibaba & Spring Boot 3.2.2.
43
+ - **Service Discovery/Config**: Nacos (Port 8848)
44
+ - **Gateway**: Spring Cloud Gateway (Port 8080)
45
+ - **Auth**: JWT + Spring Security (Port 9200)
46
+
47
+ ## Build & Test
48
+
49
+ ### Core Commands
50
+ - **Build Entire Project**: `mvn clean install`
51
+ - **Run Specific Service**: `mvn spring-boot:run -pl smartLive-modules/smartLive-[module_name]`
52
+ - **Run Tests**: `mvn test`
53
+ - **Run Single Test Class**: `mvn -Dtest=ClassName test`
54
+
55
+ ### Key Ports
56
+ | Service | Module | Port |
57
+ |---------|--------|------|
58
+ | Gateway | `smartLive-gateway` | 8080 |
59
+ | Auth | `smartLive-auth` | 9200 |
60
+ | User | `smartLive-modules/smartLive-user` | 9201 |
61
+ | System | `smartLive-modules/smartLive-system` | 9202 |
62
+ | Shop | `smartLive-modules/smartLive-shop` | 9203 |
63
+ | Search | `smartLive-modules/smartLive-search` | 9204 |
64
+ | Order | `smartLive-modules/smartLive-order` | 9205 |
65
+ | Marketing | `smartLive-modules/smartLive-marketing` | 9206 |
66
+ | AI | `smartLive-modules/smartLive-ai` | 9215 |
67
+ | Monitor | `smartLive-visual/smartLive-monitor` | 9100 |
68
+
69
+ ## Code Architecture
70
+
71
+ ### Module Structure
72
+ - `smartLive-api`: Public API definitions (Feign Clients, DTOs, VOs).
73
+ - `smartLive-common`: Shared components (Core, Redis, Security, Datasource, Log, RabbitMQ).
74
+ - `smartLive-gateway`: API Gateway handling routing and rate limiting (Sentinel).
75
+ - `smartLive-auth`: Authentication center (JWT issuance).
76
+ - `smartLive-modules`: Business logic implementations.
77
+
78
+ ### Key Technologies
79
+ - **Framework**: Spring Boot 3.2.2, Spring Cloud 2023.0.0, Spring Cloud Alibaba 2023.0.1.0
80
+ - **Database**: MySQL, MyBatis Plus 3.5.5
81
+ - **Middleware**:
82
+ - **Redis**: Caching
83
+ - **RabbitMQ**: Async messaging
84
+ - **Elasticsearch**: Search engine
85
+ - **MinIO**: Object storage
86
+ - **Seata**: Distributed transactions
87
+ - **Sentinel**: Flow control & circuit breaking
88
+ - **Tools**: Lombok, MapStruct, Knife4j (Swagger), Arthas
89
+
90
+ ## Development Conventions
91
+
92
+ ### Coding Style
93
+ - **Naming**: CamelCase for Java classes/methods.
94
+ - **Response Format**: Use `R<T>` or `AjaxResult` for API responses.
95
+ - **Exception Handling**: Global exception handlers in `smartLive-common`.
96
+ - **Annotations**: Extensive use of Spring (`@Autowired`, `@Service`, `@RestController`) and Lombok (`@Data`, `@Slf4j`).
97
+
98
+ ### Commit Messages
99
+ Format: `type(scope): subject`
100
+ - `feat`: New features
101
+ - `fix`: Bug fixes
102
+ - `docs`: Documentation changes
103
+ - `refactor`: Code restructuring
104
+ - `test`: Adding tests
105
+ - `chore`: Build/tool updates
@@ -0,0 +1,61 @@
1
+ # CLAUDE.md
2
+
3
+ This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
4
+
5
+ ## 飞书协作规则
6
+
7
+ 在回答用户问题前,必须先获取飞书聊天上下文:
8
+
9
+ 1. 使用 `list_chats` 工具获取群聊列表
10
+ 2. 使用 `get_chat_history` 工具获取最近 20 条消息,了解对话上下文
11
+ 3. 分析上下文后再回答用户问题
12
+
13
+ 这样可以:
14
+ - 了解其他 Agent 之前的回答
15
+ - 避免重复工作
16
+ - 保持对话连贯性
17
+
18
+ ## 跨 Agent 协作(前端 → 后端)
19
+
20
+ 当你的工作涉及后端接口需要配合修改时,使用以下命令通知后端 Agent:
21
+
22
+ ```
23
+ /ask-backend 接口问题说明,需要后端配合修改的内容
24
+ ```
25
+
26
+ 或中文别名:
27
+ ```
28
+ /后端 接口问题说明,需要后端配合修改的内容
29
+ ```
30
+
31
+ 使用场景:
32
+ - 前端调接口报错,需要后端排查
33
+ - 需要新增/修改接口
34
+ - 接口返回数据格式不符合预期
35
+ - 前后端联调问题
36
+
37
+ 你负责的是前端(smart-live-app),后端(smart-live-Cloud)由另一个 Agent 负责。
38
+
39
+ ## Commands
40
+
41
+ - **Start Development Server**: `npm run dev` (Runs Vite)
42
+ - **Build for Production**: `npm run build`
43
+ - **Preview Build**: `npm run preview`
44
+ - **Install Dependencies**: `npm install`
45
+
46
+ ## Architecture & Structure
47
+
48
+ - **Framework**: Vue 3 (using `<script setup>` syntax) with Vite.
49
+ - **UI Libraries**:
50
+ - **Element Plus**: Primary UI component library (configured globally).
51
+ - **Vant**: Mobile UI component library (configured globally).
52
+ - **Project Structure**:
53
+ - `src/api/`: API service modules grouped by domain (user, shop, blog, etc.).
54
+ - `src/views/`: Application page views.
55
+ - `src/components/`: Reusable Vue components.
56
+ - `src/router/`: Routing configuration.
57
+ - `src/store/`: State management modules.
58
+ - `src/utils/`: Shared utilities (contains `request.js` for Axios configuration).
59
+ - `src/assets/css/`: Global and legacy stylesheets.
60
+ - **Entry Point**: `src/main.js` - initializes Vue, Router, and global UI libraries.
61
+ - **Styling**: Standard CSS imports; Element Plus and Vant styles are imported in `main.js`.