# city-life

**Repository Path**: creative-space_2/city-life

## Basic Information

- **Project Name**: city-life
- **Description**: city-life
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-27
- **Last Updated**: 2026-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# City Life 城市生活服务平台

City Life 是一个综合性的城市生活服务平台，采用微服务架构设计，提供社区服务、客户关系管理、用户管理等多种功能。

## 技术栈

- **Java 版本**: 21
- **构建工具**: Maven
- **项目编码**: UTF-8
- **GroupId**: com.sea.life
- **Version**: 1.0.0

## 项目结构

```
city-life/
├── life-common/          # 公共组件模块
│   ├── life-common-core/     # 核心组件
│   ├── life-common-mybatis/  # MyBatis 组件
│   ├── life-common-rpc/      # RPC 组件
│   ├── life-common-security/ # 安全组件
│   └── life-common-web/      # Web 组件
── life-dependencies/    # 公共依赖管理
├── life-basic/           # 基础服务模块
│   ├── life-basic-config/    # 配置服务
│   ├── life-basic-file/      # 文件服务
│   ├── life-basic-id/        # ID 生成服务
│   ├── life-basic-pay/       # 支付服务
│   ├── life-basic-search/    # 搜索服务
│   ── life-basic-sms/       # 短信服务
├── life-micro/           # 微服务能力模块
├── life-user/            # 用户服务模块
├── life-admin/           # 后台管理模块
├── life-buss/            # 业务服务模块
│   ├── life-buss-blind/      # 盲盒业务
│   ├── life-buss-buddy/      # 伙伴业务
│   ├── life-buss-carpool/    # 拼车业务
│   ├── life-buss-help/       # 帮助业务
│   ├── life-buss-house/      # 房屋业务
│   ├── life-buss-job/        # 工作业务
│   ├── life-buss-local/      # 本地业务
│   ├── life-buss-print/      # 打印业务
│   ── life-buss-thrifting/  # 二手闲置业务
├── life-community/       # 社区服务模块
├── life-crm/             # 客户关系服务模块
── life-plat/            # 平台服务模块
│   ├── life-plat-dispatch/   # 调度服务
│   └── life-plat-report/     # 报表服务
├── life-interact/        # 互动服务模块
├── life-market/          # 营销服务模块
── life-ai/              # 人工智能服务模块
```

## 模块说明

### 核心模块
- **life-common**: 提供通用组件和工具类，包含核心、MyBatis、RPC、安全、Web 等子模块
- **life-dependencies**: 统一管理项目依赖版本，通过 Maven 的 dependencyManagement 进行版本控制
- **life-admin**: 后台管理系统，提供管理功能

### 基础服务模块
- **life-basic**: 基础服务集合
  - `life-basic-config`: 配置服务
  - `life-basic-file`: 文件服务
  - `life-basic-id`: ID 生成服务
  - `life-basic-pay`: 支付服务
  - `life-basic-search`: 搜索服务
  - `life-basic-sms`: 短信服务

### 业务服务模块
- **life-buss**: 多样化业务服务集合
  - `life-buss-blind`: 盲盒业务
  - `life-buss-buddy`: 伙伴/社交业务
  - `life-buss-carpool`: 拼车业务
  - `life-buss-help`: 帮助服务
  - `life-buss-house`: 房屋相关业务
  - `life-buss-job`: 工作招聘业务
  - `life-buss-local`: 本地生活服务
  - `life-buss-print`: 打印服务
  - `life-buss-thrifting`: 二手闲置交易

### 用户与社区模块
- **life-user**: 用户管理相关服务
- **life-community**: 社区服务
- **life-crm**: 客户关系管理
- **life-interact**: 用户互动功能

### 平台与营销模块
- **life-micro**: 微服务能力支持
- **life-plat**: 平台级服务
  - `life-plat-dispatch`: 调度服务
  - `life-plat-report`: 报表服务
- **life-market**: 营销服务
- **life-ai**: 人工智能相关服务

## 快速开始

### 环境要求
- JDK 21+
- Maven 3.6+

### 构建项目
```bash
# 清理并安装所有模块
mvn clean install

# 编译项目
mvn compile

# 打包项目
mvn package

# 跳过测试打包
mvn package -DskipTests
```

### 常用 Maven 命令
```bash
# 查看项目依赖树
mvn dependency:tree

# 查看项目结构
mvn help:effective-pom

# 安装到本地仓库
mvn install

# 部署到远程仓库
mvn deploy
```

## 开发指南

### 模块依赖管理
- 所有模块的版本依赖在 `life-dependencies` 模块中统一管理
- 通过 `<dependencyManagement>` 进行依赖版本控制
- 遵循模块职责分离原则，避免循环依赖

### 添加新模块
1. 在项目根目录的 pom.xml 的 `<modules>` 中添加新模块
2. 在 `life-dependencies/pom.xml` 中添加版本管理
3. 确保新模块遵循项目的包结构和命名规范

### 代码规范
- 项目编码：UTF-8
- Java 版本：21
- 遵循 Maven 标准目录结构
- 使用统一的代码格式化规范

## 架构特点

- **模块化设计**: 采用 Maven 多模块架构，职责清晰
- **微服务支持**: 提供微服务能力模块，支持服务拆分
- **统一管理**: 通过 life-dependencies 统一管理依赖版本
- **高扩展性**: 各模块独立，便于扩展和维护
- **功能完善**: 涵盖用户、社区、业务、平台等多个维度

## 注意事项

- 确保 JDK 版本为 21 或以上
- 修改依赖版本时需在 life-dependencies 模块中统一修改
- 各模块间通过依赖管理进行协作，注意依赖传递
- 建议定期执行 `mvn dependency:analyze` 分析依赖使用情况

## 版本信息

- **当前版本**: 1.0.0
- **GroupId**: com.sea.life
- **ArtifactId**: city-life

## 联系方式

如有问题或建议，请联系项目维护人员。