lxq/docs/acceptance-week1.md

职来 (mydreamjob) Week 1 验收文档

日期: 2026-08-04 | 范围: 第 1 周后端基线 | 状态: ✅ 通过

验收标准

A. 工程与质量基线

验收项	状态	说明
Maven 项目结构	✅	Java 17, Spring Boot 3.5.16
分层目录	✅	config, common/api, common/exception, common/logging, common/health, auth, audit
依赖配置	✅	JPA, Redis, AMQP, Flyway, OpenAPI, JWT, Validation, Actuator
统一响应格式	✅	ApiResponse 包装，code/message/data/requestId/timestamp
全局异常处理	✅	GlobalExceptionHandler
请求 ID	✅	RequestIdFilter (X-Request-Id)
结构化日志	✅	含 requestId 的日志模式
环境变量配置	✅	application.yml 使用 ${ENV_VAR} 读取敏感配置
配置模板	✅	application-dev.example.yml
.gitignore	✅	排除 .env, target, IDE 文件

B. 数据与安全基线

验收项	状态	说明
ERD 文档	✅	docs/ERD.md
Flyway V1 迁移	✅	base_schema.sql + seed_data.sql
JWT 鉴权	✅	JwtTokenProvider, JwtAuthenticationFilter
安全配置	✅	SecurityConfig (CORS, CSRF 关闭, 状态less)
角色枚举	✅	STUDENT, COMPANY, ADMIN
审计事件骨架	✅	AuditService
Mock 验证码	✅	SmsVerificationService (限流/锁定/过期)
Mock 登录	✅	AuthController + AuthService

C. 本地基础设施

验收项	状态	说明
MySQL (3307)	✅	compose.yaml 配置
Redis (6379)	✅	compose.yaml 配置
RabbitMQ (5672/15672)	✅	compose.yaml 配置 + 管理界面
端口绑定	✅	所有端口绑定 127.0.0.1

D. 文档

验收项	状态	说明
README.md	✅	项目说明、启动步骤、环境变量
docs/ERD.md	✅	数据库实体关系设计
docs/api-v0.1.md	✅	API 接口清单、错误码、请求/响应示例
docs/acceptance-week1.md	✅	本文件

测试报告

mvn clean verify 结果

[INFO] Tests run: 21, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

测试类	数量	状态
ApiResponseTest	10	✅
AuthServiceTest	3	✅
ErrorCodeTest	2	✅
JwtTokenProviderTest	4	✅
SmsVerificationServiceTest	2	✅

接口实测结果

接口	方法	预期	实际
/api/v1/health	GET	200 OK	✅
/api/v1/info	GET	200 OK	✅
/api/v1/auth/sms/send	POST	200 OK	✅
/api/v1/auth/login	POST	201 Created	✅
/api/v1/auth/me	GET	403 (无token) / 200 (有token)	✅
/api/v1/v3/api-docs	GET	200 OK	✅
/api/v1/swagger-ui/index.html	GET	200 OK	✅
/actuator/health	GET	200 OK	✅

实测命令

# 健康检查
curl http://localhost:8080/api/v1/health

# 应用信息
curl http://localhost:8080/api/v1/info

# 发送验证码
curl -X POST "http://localhost:8080/api/v1/auth/sms/send?phone=13800000001&purpose=login"

# Mock 登录（验证码不输出到日志；本地按 docs/frontend-integration.md §3 受控取得）
curl -X POST http://localhost:8080/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"phone":"13800000001","code":"<验证码>"}'

# 当前用户信息
curl http://localhost:8080/api/v1/auth/me \
  -H "Authorization: Bearer <accessToken>"

# Swagger UI
http://localhost:8080/api/v1/swagger-ui/index.html

基础设施状态

服务	地址	状态
MySQL 8.4	127.0.0.1:3307	✅ healthy
Redis 7.4	127.0.0.1:6379	✅ healthy
RabbitMQ 3.13	127.0.0.1:5672	✅ healthy
RabbitMQ Management	127.0.0.1:15672	✅ healthy

启动步骤

1. 启动基础设施

cd C:/Users/15642/Desktop/zhilai/backend-infra
docker compose up -d

2. 编译与测试

cd C:/Users/15642/Desktop/zhilai/mydreamjob-server
mvn clean verify

3. 启动应用

mvn spring-boot:run -Dspring-boot.run.profiles=dev \
  -Dspring-boot.run.jvmArguments="\
    -Dspring.datasource.password=<DB_PASSWORD> \
    -Dspring.datasource.username=mydreamjob \
    -Dspring.datasource.url=jdbc:mysql://127.0.0.1:3307/mydreamjob?... \
    -Dapp.jwt.secret=<JWT_SECRET>"

测试账号

角色	手机号	用途
ADMIN	13800000001	管理员测试
STUDENT	13800000002	学生测试
COMPANY	13800000003	企业测试

注: 使用 Mock 短信验证码登录。应用日志不再输出验证码，本地按 docs/frontend-integration.md §3 的受控方式取得（需 SMS_MOCK_ENABLED=true 且 ALLOW_TEST_OTP_DB_READ=true）；生产环境禁止查询验证码表。

已知限制

1. 短信验证码 Mock: 应用日志不输出验证码，不发送真实短信；本地取码见 docs/frontend-integration.md §3（验证码当前仍为数据库明文存储）
2. 业务模块: 岗位、投递、聊天、评分等模块仅定义接口骨架
3. RabbitMQ 监听: 队列已定义但未实现消费者（Week 2+）
4. Actuator 健康: RabbitMQ 健康检查未配置（仅 ping）
5. Swagger UI 路径: 需访问 /api/v1/swagger-ui/index.html（含 context path）
6. Testcontainers: 未引入（Docker 环境限制），Spring Boot 上下文测试被 @Disabled

风险项

风险	等级	说明
Docker Desktop 未启动	高	需先启动 Docker Desktop 才能运行 compose
MySQL 3306 端口冲突	中	本地已有 MySQL 服务占用 3306，compose 使用 3307
Redis 未安装	中	需依赖 Docker 或手动安装 Redis
Spring Boot 3.5.16 新特性	低	@MockBean 在 WebMvcTest 中与 SecurityFilterChain 有兼容性问题

待办事项 (Week 2+)

• 企业模块: companies 表及 CRUD
• 岗位模块: jobs 表、搜索、筛选
• 投递模块: applications 表、状态流转
• 聊天模块: conversations 表、WebSocket/STOMP
• 评分模块: ratings 表、证据上传
• Token 刷新接口
• 密码重置功能
• RabbitMQ 消费者实现
• Testcontainers 集成测试