chore: 初始化项目结构与登录鉴权模块

后端 FastAPI 六层结构（api/services/repositories/models/schemas/core），统一响应信封、全局异常、日志脱敏；6 张表经 Alembic 迁移建库，SQL 留存 db/migration；登录鉴权含图形验证码（Redis GETDEL 防重放）、JWT、登录限流、登出黑名单（TTL=令牌剩余有效期）、登录日志。前端 Vue3 + TS + Element Plus 骨架，含登录页、路由守卫、请求封装与 Vite 代理。工程配置：uv 锁定 Python 3.12、ruff 检查与格式化、editorconfig、gitattributes。测试 184 项（单元 155 / 集成 29）全绿，浏览器端到端 8 项通过。 Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-09 18:46:36 +08:00
commit 273ebf4657
@@ -0,0 +1,108 @@
+"""命令行管理工具。
+
+用法（在 backend/ 目录下执行）::
+
+    uv run python -m app.cli create-admin --username admin
+
+密码优先**交互式输入**而非命令行参数：命令行参数会进入 shell 历史，
+在多用户机器上还能被 `ps` 看到。`--password` 仅为自动化脚本保留。
+"""
+
+import argparse
+import getpass
+import sys
+
+from sqlalchemy import select
+
+from app.core.constants import PASSWORD_MAX_BYTES, PASSWORD_MIN_BYTES, ROLE_ADMIN
+from app.core.db import dispose_engine, get_session_factory
+from app.core.security import hash_password
+from app.models import Role, User, UserRole
+
+
+def _prompt_password() -> str:
+    """交互式读取并二次确认密码，循环直到符合策略。"""
+    while True:
+        password = getpass.getpass(
+            f"请输入密码（{PASSWORD_MIN_BYTES}-{PASSWORD_MAX_BYTES} 字节）: "
+        )
+        length = len(password.encode("utf-8"))
+        if length < PASSWORD_MIN_BYTES:
+            print(f"  密码不足 {PASSWORD_MIN_BYTES} 字节，请重新输入。")
+            continue
+        if length > PASSWORD_MAX_BYTES:
+            print(f"  密码超过 {PASSWORD_MAX_BYTES} 字节上限（中文一字占 3 字节），请重新输入。")
+            continue
+        if password != getpass.getpass("请再次输入以确认: "):
+            print("  两次输入不一致，请重新输入。")
+            continue
+        return password
+
+
+def _create_admin(args: argparse.Namespace) -> int:
+    """幂等创建管理员账号。
+
+    已存在时**不覆盖密码** —— 意外重跑脚本不应把已有账号的密码改掉。
+    """
+    factory = get_session_factory()
+    with factory() as session:
+        existing = session.execute(
+            select(User).where(User.username == args.username)
+        ).scalar_one_or_none()
+        if existing is not None:
+            print(f"用户 {args.username!r} 已存在（id={existing.id}），未做任何修改。")
+            return 0
+
+        role = session.execute(
+            select(Role).where(Role.role_code == ROLE_ADMIN)
+        ).scalar_one_or_none()
+        if role is None:
+            print(
+                "错误：未找到 admin 角色，请先执行数据库迁移（uv run alembic upgrade head）。",
+                file=sys.stderr,
+            )
+            return 1
+
+        password = args.password or _prompt_password()
+        user = User(
+            username=args.username,
+            password=hash_password(password),
+            real_name=args.real_name,
+            status=1,
+        )
+        session.add(user)
+        session.flush()  # 取得自增 id 后才能建关联
+        session.add(UserRole(user_id=user.id, role_id=role.id))
+        session.commit()
+
+        print(f"已创建管理员 {args.username!r}（id={user.id}），角色：{role.role_name}。")
+        print("首次登录后请立即修改密码。")
+        return 0
+
+
+def main() -> int:
+    """命令行入口。"""
+    parser = argparse.ArgumentParser(
+        prog="app.cli", description="衍水集团营销人员工资管理系统 - 命令行工具"
+    )
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    p_admin = sub.add_parser("create-admin", help="创建初始管理员账号（幂等）")
+    p_admin.add_argument("--username", default="admin", help="登录用户名，默认 admin")
+    p_admin.add_argument("--real-name", default="系统管理员", help="真实姓名")
+    p_admin.add_argument(
+        "--password",
+        default=None,
+        help="密码。不传则交互式输入（推荐）——命令行传参会留在 shell 历史中",
+    )
+
+    args = parser.parse_args()
+
+    try:
+        return _create_admin(args)
+    finally:
+        dispose_engine()
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())