lovife
9d7a8ca845
技术栈（已在 4.1.1 上实测跑通，非纸面选型）
Java 21 + Spring Boot 4.1.1 + MyBatis-Plus 3.5.17(boot4) + PostgreSQL 16.15
+ Redis 7 + Flyway 12.4 + springdoc 3.1.1；前端定 Vue 3 + Element Plus + uni-app
交付内容
M0-01 基础设施 deploy/docker-compose.yml（PG + Redis + MinIO，容器名与端口避让本机既有项目）
M0-02 后端骨架 xt-common + xt-server；统一响应 / 全局异常 / 58 个错误码 /
多租户拦截 / 软删除 / 字段自动填充 / AES-GCM / HMAC 索引 / RSA / JWT
M0-05 租户 开通租户（一次完成建租户 + 发 6 个内置角色 + 建首个管理员）、列表、详情
M0-06 组织 CRUD + 组织树 + ancestor_path 自动维护 + 占用校验
M0-07 PC 登录 RSA 解密 + 图形验证码 + 失败锁定 + 等时比较防账号枚举 + 审计日志
M0-08 登出/当前用户 Token 黑名单（存 SHA-256，TTL 到自然过期）
M0-01 数据库 Flyway 2 个迁移 → 26 张表（20 业务 + 5 标准 + 1 迁移记录）
安全姿态
· 租户拦截器【默认拒绝】：匿名请求触及租户表直接抛 40101，不做「不加条件放行」
· 权限码定义在代码里（PermissionDef / BuiltinRole），不建 sys_permission 表，杜绝前后端漂移
· 匿名接口只靠 @PublicApi 放行，不做路径白名单，避免两套机制各说各话
· 账号不存在时也跑一次 BCrypt（假哈希），拉平响应时间防枚举
· 登录密码 RSA 传输，防止网关/APM 把明文密码记进日志
脚本
scripts/sync-ddl.py 文档 DDL → Flyway 迁移，带 --check 防漂移
scripts/e2e-m0.py M0 验收 36 项，可进 CI
scripts/verify-docs.py 文档一致性（接口数【逐节】核对、错误码、跨文档数字、表格列数）
scripts/dev-login.py RSA 加密登录助手
scripts/dev-clean-e2e.py 清理 E2E 测试数据
文档修正（实测暴露，非人工审查）
· DDL 缺陷：sys_tenant.contact_phone / sys_user.phone / collect_roster.phone
原 varchar(20) 按明文长度建，装不下 AES-GCM 密文（约 52 字符），改 varchar(128)（PRD V2.4）
· 错误码 40007b/40007c 带字母后缀与「code 为数字」的约定冲突，规范化为 40071/40072
· 07-开发实施计划 新增 §9 版本兼容踩坑记录（10 条实录）与 §10 M0 完成情况
107 lines
3.6 KiB
Python
107 lines
3.6 KiB
Python
#!/usr/bin/env python
|
|
# -*- coding: utf-8 -*-
|
|
"""
|
|
开发辅助：RSA 加密登录并打印 token。
|
|
|
|
为什么需要它
|
|
------------
|
|
登录接口的密码字段是 RSA 加密的（防止明文密码进网关日志），
|
|
所以用 curl / Postman 直接调会很别扭——得先算出一段密文。
|
|
这个脚本把它变成一行命令。
|
|
|
|
用法
|
|
----
|
|
python scripts/dev-login.py # 默认 admin / Admin@123
|
|
python scripts/dev-login.py platform Platform@123
|
|
python scripts/dev-login.py admin Admin@123 --base http://localhost:8080
|
|
|
|
依赖：cryptography (pip install cryptography)
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
import base64
|
|
import json
|
|
import os
|
|
import sys
|
|
import urllib.request
|
|
|
|
if hasattr(sys.stdout, "reconfigure"):
|
|
sys.stdout.reconfigure(encoding="utf-8")
|
|
|
|
ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
|
DEFAULT_PUB_KEY = os.path.join(ROOT, "deploy", "rsa-public-key-dev.pem")
|
|
|
|
|
|
def rsa_encrypt(plain: str, pub_key_path: str) -> str:
|
|
try:
|
|
from cryptography.hazmat.primitives import serialization
|
|
from cryptography.hazmat.primitives.asymmetric import padding
|
|
except ImportError:
|
|
sys.exit("缺少依赖：pip install cryptography")
|
|
|
|
with open(pub_key_path, "rb") as f:
|
|
public_key = serialization.load_pem_public_key(f.read())
|
|
|
|
# 必须与服务端 RsaCipher 的 "RSA/ECB/PKCS1Padding" 一致。
|
|
# 换成 OAEP 会表现为「密码永远错」，两边都改才能换。
|
|
cipher = public_key.encrypt(plain.encode("utf-8"), padding.PKCS1v15())
|
|
return base64.b64encode(cipher).decode("ascii")
|
|
|
|
|
|
def post_json(url: str, payload: dict, timeout: int = 20) -> tuple[int, dict]:
|
|
data = json.dumps(payload).encode("utf-8")
|
|
req = urllib.request.Request(
|
|
url, data=data,
|
|
headers={"Content-Type": "application/json; charset=utf-8"},
|
|
method="POST",
|
|
)
|
|
try:
|
|
with urllib.request.urlopen(req, timeout=timeout) as resp:
|
|
return resp.status, json.loads(resp.read().decode("utf-8"))
|
|
except urllib.error.HTTPError as e:
|
|
body = e.read().decode("utf-8")
|
|
try:
|
|
return e.code, json.loads(body)
|
|
except json.JSONDecodeError:
|
|
return e.code, {"raw": body}
|
|
|
|
|
|
def main() -> int:
|
|
ap = argparse.ArgumentParser(description="RSA 加密登录，打印 token")
|
|
ap.add_argument("username", nargs="?", default="admin")
|
|
ap.add_argument("password", nargs="?", default="Admin@123")
|
|
ap.add_argument("--base", default=os.environ.get("XT_BASE", "http://localhost:8080"))
|
|
ap.add_argument("--tenant-code", default=None, help="账号在多个租户下重名时必填")
|
|
ap.add_argument("--pub-key", default=DEFAULT_PUB_KEY)
|
|
ap.add_argument("--json", action="store_true", help="打印完整响应而非仅 token")
|
|
args = ap.parse_args()
|
|
|
|
if not os.path.exists(args.pub_key):
|
|
sys.exit(f"找不到公钥：{args.pub_key}")
|
|
|
|
payload = {
|
|
"username": args.username,
|
|
"password": rsa_encrypt(args.password, args.pub_key),
|
|
}
|
|
if args.tenant_code:
|
|
payload["tenantCode"] = args.tenant_code
|
|
|
|
status, body = post_json(f"{args.base}/api/v1/auth/login", payload)
|
|
|
|
if args.json:
|
|
print(json.dumps(body, ensure_ascii=False, indent=2))
|
|
elif body.get("code") == 0:
|
|
d = body["data"]
|
|
print(d["token"])
|
|
else:
|
|
print(f"[失败] HTTP {status} code={body.get('code')} msg={body.get('msg')}",
|
|
file=sys.stderr)
|
|
return 1
|
|
|
|
return 0 if body.get("code") == 0 else 1
|
|
|
|
|
|
if __name__ == "__main__":
|
|
raise SystemExit(main())
|