docs: 添加 Git Tag 日期版本号规范

This commit is contained in:
aiyimickey 2026-05-18 14:58:55 +08:00
parent 0351dba617
commit 561ab6d177
1 changed files with 19 additions and 13 deletions

View File

@ -33,7 +33,10 @@ npm run build # 生产构建
| `src/middleware.ts` | 全局路由守卫:检查 `tlyq_session` cookie未认证跳转 /login |
| `src/lib/jwt.ts` | 共享 JWT 签发/验证HS256与 assets/issue 共用密钥和格式) |
| `src/lib/ldap.ts` | LLDAP 认证ldapAuth+ 密码修改ldapChangePassword+ 用户存在性检查 |
| `src/lib/email.ts` | 邮件发送nodemailer163 企业邮箱,创建用户时发送凭证) |
| `src/lib/email.ts` | 邮件发送Resend API创建用户时发送密码设置链接不含明文密码 |
| `src/lib/setup-token.ts` | 一次性密码设置 token 签发/验证JWT24 小时有效) |
| `src/app/setup-password/page.tsx` | 密码设置页(公开,通过邮件链接 token 访问) |
| `src/app/api/auth/setup-password/route.ts` | 密码设置 API验证 token + 调用 lldap_set_password |
| `src/app/page.tsx` | 门户首页:站点卡片导航(核心系统 + 其他站点) |
| `src/app/login/page.tsx` | 登录页LLDAP 认证) |
| `src/app/profile/page.tsx` | 个人信息页(账户信息 + 修改密码) |
@ -71,14 +74,10 @@ OA 本身**不存储用户数据**(无本地 users 表),纯 LLDAP 认证
| `LDAP_URL` | `ldap://localhost:3890` | `ldap://lldap:3890` |
| `LDAP_BASE_DN` | `dc=tlyq,dc=ai` | 同 |
| `LDAP_ADMIN_DN` | `uid=admin,ou=people,dc=tlyq,dc=ai` | 同 |
| `LDAP_ADMIN_PASS` | `admin123` | LLDAP admin 密码 |
| — | 运行时动态读取 | LLDAP admin 密码通过 `docker exec lldap printenv` 获取,不存本地 |
| `JWT_SECRET` | `dev-secret-key-local` | 强随机值(与 assets/issue 相同) |
| `COOKIE_DOMAIN` | `""`(空) | `.tlyq.ai` |
| `SMTP_HOST` | `smtphz.qiye.163.com` | 163 企业邮箱 |
| `SMTP_PORT` | `465` | SSL 端口 |
| `SMTP_USER` | `gxp@qx002575.com` | 发件邮箱 |
| `SMTP_PASS` | 见 .env | 邮箱密码 |
| `SMTP_FROM` | `gxp@qx002575.com` | 发件人地址 |
| `RESEND_API_KEY` | `re_xxxxxxxxxxxx` | Resend API KeySending Access 权限) |
### `.env` 示例
@ -86,15 +85,10 @@ OA 本身**不存储用户数据**(无本地 users 表),纯 LLDAP 认证
LDAP_URL=ldap://localhost:3890
LDAP_BASE_DN=dc=tlyq,dc=ai
LDAP_ADMIN_DN=uid=admin,ou=people,dc=tlyq,dc=ai
LDAP_ADMIN_PASS=admin123
JWT_SECRET=dev-secret-key-local
COOKIE_DOMAIN=
NODE_ENV=development
SMTP_HOST=smtphz.qiye.163.com
SMTP_PORT=465
SMTP_USER=gxp@qx002575.com
SMTP_PASS=
SMTP_FROM=gxp@qx002575.com
RESEND_API_KEY=re_xxxxxxxxxxxx
```
---
@ -136,6 +130,18 @@ txjp 服务器
---
## Git Tag 规范
使用日期版本号 `vYYYY.MM.DD`(如 `v2026.05.18`)。提交后打 tag 再推送:
```bash
git tag v$(date +%Y.%m.%d) && git push origin main && git push origin v$(date +%Y.%m.%d)
```
同一天多次提交只打一个 tag。详见根目录 `CLAUDE.md`
---
## 故障排查
### OA 502 Bad Gateway