wms/nflg-wms-auth/CLAUDE.md

68 lines
1.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[根目录](../CLAUDE.md) > **nflg-wms-auth**
# nflg-wms-auth - 认证服务
## 模块职责
SSO 单点登录认证服务,负责:
- Sa-Token SSO Server 端实现
- 用户登录/登出/Token 签发
- LDAP 域账号集成验证
- H5 移动端认证接口
## 入口与启动
| 项 | 值 |
|----|-----|
| 入口类 | `com.nflg.wms.auth.AuthApplication` |
| 端口 | 8101 |
| 服务名 | auth-local |
## 关键依赖
- nflg-wms-common
- nflg-wms-starter
- Spring LDAP Core
- Redisson
- Loki Logback Appender
## 对外接口
| Controller | 路由 | 说明 |
|-----------|------|------|
| `SsoServerController` | SSO 相关路由 | SSO 单点登录服务端接口ticket 签发/校验/登出等) |
| `H5Controller` | H5 相关路由 | H5 移动端认证接口 |
## 关键目录说明
| 路径 | 说明 |
|------|------|
| `AuthApplication.java` | 启动入口 |
| `controller/SsoServerController.java` | SSO 服务端控制器 |
| `controller/H5Controller.java` | H5 移动端控制器 |
| `service/LdapService.java` | LDAP 域账号验证服务 |
## 配置
- Sa-Token SSO 配置token-name 为 `authorization`,有效期 30 天
- SSO Server 模式二Ticket 有效期 300 秒,允许所有回调地址
- JWT 秘钥配置
## 测试
- `DeployDevTest.java` - 开发环境部署测试
- `DeploySitTest.java` - SIT 环境部署测试
## 相关文件清单
- `src/main/java/com/nflg/wms/auth/` - 全部源码4 个文件)
- `src/main/resources/application*.yml` - 配置文件4 个环境)
- `src/main/resources/logback-spring.xml` - 日志配置
- `pom.xml` - 模块依赖定义
## 变更记录 (Changelog)
| 时间 | 操作 | 说明 |
|------|------|------|
| 2026-05-23 14:16:58 | 初始化 | 首次生成模块文档 |