4-2、快速看懂公司项目架构

1. 项目是做什么的（业务背景）
2. 用了哪些技术（技术栈）
3. 怎么启动（环境要求、启动步骤）
4. 项目结构（模块划分）
5. 配置说明（数据库、Redis、中间件）

<!-- 框架 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- → SpringBoot Web项目 -->

<!-- 数据库 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
</dependency>
<!-- → MySQL + MyBatis-Plus -->

<!-- 缓存 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<!-- → Redis -->

<!-- 消息队列 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-amqp</artifactId>
</dependency>
<!-- → RabbitMQ -->

<!-- 权限 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>
<!-- → Spring Security -->

<!-- API文档 -->
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-spring-boot-starter</artifactId>
</dependency>
<!-- → Knife4j接口文档 -->

my-project/
  src/
    main/
      java/
        com/company/project/
          ProjectApplication.java    (启动类)
          controller/                 (控制器层)
          service/                    (业务逻辑层)
            impl/                     (实现类)
          mapper/ 或 dao/             (数据访问层)
          entity/ 或 model/           (实体类)
          dto/                        (数据传输对象)
          vo/                         (视图对象)
          config/                     (配置类)
          utils/                      (工具类)
          interceptor/                (拦截器)
          exception/                  (异常处理)
      resources/
        application.yml               (主配置)
        application-dev.yml            (环境配置)
        mapper/                       (MyBatis XML)
        static/                       (静态资源)
  pom.xml                             (依赖管理)

my-project/
  pom.xml                             (父pom)
  common/                             (公共模块：工具类、常量、异常)
  model/                              (数据模型：实体、DTO、VO)
  dao/                                (数据访问：Mapper、XML)
  service/                            (业务逻辑)
  admin/                              (管理后台API)
    src/main/java/.../AdminApplication.java
  api/                                (对外API)
    src/main/java/.../ApiApplication.java
  job/                                (定时任务)
  gateway/                            (网关)

请求流向：

前端请求
  ↓
Controller（控制器）— 接收请求、参数校验、返回结果
  ↓
Service（业务逻辑）— 核心业务处理
  ↓
Mapper/DAO（数据访问）— 数据库操作
  ↓
Database（数据库）

@SpringBootApplication
@MapperScan("com.company.project.mapper")
@EnableScheduling
public class ProjectApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProjectApplication.class, args);
    }
}

server:
  port: 8080                    # 端口
  servlet:
    context-path: /api          # 路径前缀

spring:
  application:
    name: my-project            # 服务名
  datasource:                   # 数据源配置
    ...
  redis:                        # Redis配置
    ...
  cloud:
    nacos:                      # Nacos配置
      ...

Controller → Service → Mapper → 数据库 → 返回

@RestController
@RequestMapping("/user")
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping("/list")
    public Result<List<UserVO>> list() {
        return Result.success(userService.list());
    }
}

public interface UserService {
    List<UserVO> list();
}

@Service
public class UserServiceImpl implements UserService {

    @Autowired
    private UserMapper userMapper;

    @Override
    public List<UserVO> list() {
        List<User> users = userMapper.selectList(null);
        return users.stream()
            .map(this::convertToVO)
            .collect(Collectors.toList());
    }
}

@Mapper
public interface UserMapper extends BaseMapper<User> {
    // MyBatis-Plus自带CRUD
}

@Data
@TableName("user")
public class User {
    @TableId(type = IdType.AUTO)
    private Long id;
    private String username;
    private String password;
    private String email;
    private Date createTime;
}

@Configuration
public class RedisConfig {

    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);
        // Key用String序列化
        template.setKeySerializer(new StringRedisSerializer());
        // Value用JSON序列化
        template.setValueSerializer(new GenericJackson2JsonRedisSerializer());
        return template;
    }
}

@Data
@TableName("sys_user")
public class SysUser {
    @TableId(type = IdType.AUTO)
    private Long userId;        // → user_id 主键自增
    
    private String username;   // → username 用户名
    private String password;   // → password 密码
    private Long deptId;       // → dept_id 部门ID
    
    @TableField("phone_number")
    private String phone;      // → phone_number 手机号
    
    @TableLogic
    private Integer deleted;   // → deleted 逻辑删除字段
    
    @TableField(fill = FieldFill.INSERT)
    private Date createTime;   // → create_time 创建时间
    
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Date updateTime;   // → update_time 更新时间
}

http://localhost:8080/doc.html        (Knife4j)
http://localhost:8080/swagger-ui.html (Swagger)

用户服务 → 独立进程 + 独立数据库
订单服务 → 独立进程 + 独立数据库
商品服务 → 独立进程 + 独立数据库