From 2dfa836acb23da299a6b056603f40bbfca1989a3 Mon Sep 17 00:00:00 2001 From: chakcy <947105045@qq.com> Date: Wed, 29 Apr 2026 11:24:19 +0800 Subject: [PATCH] =?UTF-8?q?modify:=20=E5=8A=9F=E8=83=BDtongbu?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- {{ cookiecutter.project_name }}/.gitignore | 10 +- {{ cookiecutter.project_name }}/Dockerfile | 57 ++ {{ cookiecutter.project_name }}/README.md | 36 +- {{ cookiecutter.project_name }}/config.toml | 70 ++- {{ cookiecutter.project_name }}/deploy.sh | 95 +++ .../public/config.toml | 71 ++- .../public/main.py | 65 +- .../public/server.py | 10 +- .../public/utils/config.py | 114 +++- .../public/utils/launch.py | 32 +- .../pyproject.toml | 13 +- .../pyrightconfig.json | 2 +- .../requirements.txt | 27 +- .../src/plugins/jwt/__init__.py | 0 .../app/core => plugins/jwt}/jwt_cache.py | 347 ++++++----- .../src/plugins/scheduler/__init__.py | 0 .../src/plugins/scheduler/scheduler.py | 560 ++++++++++++++++++ .../.gitignore | 39 ++ .../.prettierrc.json | 6 + .../env.d.ts | 1 + .../index.html | 13 + .../package.json | 38 ++ .../public/favicon.ico | Bin 0 -> 16958 bytes .../src/App.vue | 16 + .../src/assets/chongming64x64.png | Bin 0 -> 9813 bytes .../src/assets/logo.png | Bin 0 -> 233758 bytes .../src/assets/logo.svg | 175 ++++++ .../src/main.ts | 31 + .../src/router/index.ts | 44 ++ .../src/stores/auth.ts | 77 +++ .../src/stores/todo.ts | 69 +++ .../src/views/LoginView.vue | 58 ++ .../src/views/RegisterView.vue | 61 ++ .../src/views/TodoView.vue | 245 ++++++++ .../tsconfig.app.json | 24 + .../tsconfig.json | 11 + .../tsconfig.node.json | 26 + .../vite.config.ts | 22 + .../__init__.py | 51 +- .../app/__init__.py | 168 +++++- .../app/api/__init__.py | 3 +- .../app/api/deps.py | 18 +- .../app/api/routers/auth.py | 209 +++++-- .../app/api/routers/todo.py | 78 ++- .../app/api/routers/upload.py | 67 +++ .../app/core/cache.py | 397 +++++++++++++ .../app/core/config.py | 1 - .../app/core/constant.py | 46 ++ .../app/core/logger.py | 166 +++++- .../app/core/security.py | 44 +- .../app/core/static_file.py | 100 ++++ .../app/model/__init__.py | 15 + .../app/model/http_error.py | 31 + .../app/model/permission.py | 36 ++ .../app/model/relationship_table.py | 35 ++ .../app/model/role.py | 52 ++ .../app/model/todo.py | 47 ++ .../app/model/user.py | 107 +++- .../app/service/auth.py | 111 +++- .../app/service/permission.py | 193 ++++++ .../app/service/role.py | 187 ++++++ .../app/service/todo.py | 56 ++ .../app/service/uploads.py | 81 +++ .../app/service/user.py | 43 +- .../app/task/__init__.py | 31 + .../app/task/dev_init_db.py | 92 +++ .../scripts/build.py | 390 +++++++++--- .../scripts/clean_pycache.py | 1 + .../scripts/code_content.py | 14 +- 69 files changed, 4817 insertions(+), 518 deletions(-) create mode 100644 {{ cookiecutter.project_name }}/Dockerfile create mode 100644 {{ cookiecutter.project_name }}/deploy.sh create mode 100644 {{ cookiecutter.project_name }}/src/plugins/jwt/__init__.py rename {{ cookiecutter.project_name }}/src/{{{ cookiecutter.project_name }}/app/core => plugins/jwt}/jwt_cache.py (54%) create mode 100644 {{ cookiecutter.project_name }}/src/plugins/scheduler/__init__.py create mode 100644 {{ cookiecutter.project_name }}/src/plugins/scheduler/scheduler.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/.gitignore create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/.prettierrc.json create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/env.d.ts create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/index.html create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/package.json create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/public/favicon.ico create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/App.vue create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/assets/chongming64x64.png create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/assets/logo.png create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/assets/logo.svg create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/main.ts create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/router/index.ts create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/stores/auth.ts create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/stores/todo.ts create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/views/LoginView.vue create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/views/RegisterView.vue create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/views/TodoView.vue create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/tsconfig.app.json create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/tsconfig.json create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/tsconfig.node.json create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/vite.config.ts create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/routers/upload.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/cache.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/constant.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/static_file.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/http_error.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/permission.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/relationship_table.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/role.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/permission.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/role.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/uploads.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/task/__init__.py create mode 100644 {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/task/dev_init_db.py diff --git a/{{ cookiecutter.project_name }}/.gitignore b/{{ cookiecutter.project_name }}/.gitignore index f19c072..8d21926 100644 --- a/{{ cookiecutter.project_name }}/.gitignore +++ b/{{ cookiecutter.project_name }}/.gitignore @@ -10,4 +10,12 @@ wheels/ .venv logs/ resources/ -output.md \ No newline at end of file +output.md +*.db +*.svfs + +# resources +uploads/ + +# docker +*.tar diff --git a/{{ cookiecutter.project_name }}/Dockerfile b/{{ cookiecutter.project_name }}/Dockerfile new file mode 100644 index 0000000..19d7b69 --- /dev/null +++ b/{{ cookiecutter.project_name }}/Dockerfile @@ -0,0 +1,57 @@ +FROM debian:bookworm-slim AS builder + +RUN apt-get update && \ + apt-get install -y --no-install-recommends ca-certificates && \ + rm -rf /var/lib/apt/lists/* + +COPY build/{{ cookiecutter.project_name }} /tmp/{{ cookiecutter.project_name }} + +RUN mkdir -p /tmp/rootfs/app && \ + # === 临时目录 === + mkdir -p /tmp/rootfs/tmp && \ + chmod 1777 /tmp/rootfs/tmp && \ + # === 数据目录 === + mkdir -p /tmp/rootfs/app/data && \ + chmod 777 /tmp/rootfs/app/data && \ + # === 解释器目录 === + mkdir -p /tmp/rootfs/lib64 && \ + mkdir -p /tmp/rootfs/lib/x86_64-linux-gnu && \ + cp /lib/x86_64-linux-gnu/ld-linux-x86-64.so.2 /tmp/rootfs/lib/x86_64-linux-gnu/ && \ + ln -s /lib/x86_64-linux-gnu/ld-linux-x86-64.so.2 /tmp/rootfs/lib64/ld-linux-x86-64.so.2 && \ + # === 依赖库 === + cp /lib/x86_64-linux-gnu/libdl.so.2 /tmp/rootfs/lib/x86_64-linux-gnu/ && \ + cp /lib/x86_64-linux-gnu/libz.so.1 /tmp/rootfs/lib/x86_64-linux-gnu/ && \ + cp /lib/x86_64-linux-gnu/libpthread.so.0 /tmp/rootfs/lib/x86_64-linux-gnu/ && \ + cp /lib/x86_64-linux-gnu/libc.so.6 /tmp/rootfs/lib/x86_64-linux-gnu/ && \ + cp /lib/x86_64-linux-gnu/librt.so.1 /tmp/rootfs/lib/x86_64-linux-gnu/ && \ + cp /lib/x86_64-linux-gnu/libm.so.6 /tmp/rootfs/lib/x86_64-linux-gnu/ && \ + cp /lib/x86_64-linux-gnu/libutil.so.1 /tmp/rootfs/lib/x86_64-linux-gnu/ && \ + cp /lib/x86_64-linux-gnu/libnss_dns.so.2 /tmp/rootfs/lib/x86_64-linux-gnu/ 2>/dev/null || true && \ + cp /lib/x86_64-linux-gnu/libnss_files.so.2 /tmp/rootfs/lib/x86_64-linux-gnu/ 2>/dev/null || true && \ + cp /lib/x86_64-linux-gnu/libresolv.so.2 /tmp/rootfs/lib/x86_64-linux-gnu/ 2>/dev/null || true && \ + # === 时区数据 === + mkdir -p /tmp/rootfs/usr/share/zoneinfo && \ + cp -r /usr/share/zoneinfo/Asia /tmp/rootfs/usr/share/zoneinfo/ && \ + cp /usr/share/zoneinfo/UTC /tmp/rootfs/usr/share/zoneinfo/ && \ + # === 证书和 DNS === + mkdir -p /tmp/rootfs/etc/ssl/certs && \ + cp /etc/ssl/certs/ca-certificates.crt /tmp/rootfs/etc/ssl/certs/ && \ + echo "hosts: files dns" > /tmp/rootfs/etc/nsswitch.conf && \ + # === /proc /sys /dev === + mkdir -p /tmp/rootfs/proc /tmp/rootfs/sys /tmp/rootfs/dev + +FROM scratch + +COPY --from=builder /tmp/rootfs/ / + +COPY build/{{ cookiecutter.project_name }} /app/{{ cookiecutter.project_name }} +COPY build/config.toml /app/config.toml +COPY build/resources/ /app/resources/ +COPY build/static.svfs /app/static.svfs +COPY build/data /app/data + +WORKDIR /app + +EXPOSE 8000 + +CMD ["./{{ cookiecutter.project_name }}"] \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/README.md b/{{ cookiecutter.project_name }}/README.md index c67ae07..12e4165 100644 --- a/{{ cookiecutter.project_name }}/README.md +++ b/{{ cookiecutter.project_name }}/README.md @@ -42,13 +42,12 @@ build ```text build -├── resources -│   ├── {{ cookiecutter.project_name }}.ico -│   ├── plugins.mbank -│   └── app.mbank -├── config.toml -├── db.sqlite3 -└── {{ cookiecutter.project_name }} # windows {{ cookiecutter.project_name }}.exe +build/ +├── {{ cookiecutter.project_name }} # 单文件可执行程序 (Linux) 或 {{ cookiecutter.project_name }}.exe (Windows) +├── config.toml # 生产配置（密钥已注入） +├── resources/ # 加密的模块银行 (.mbank) 和图标 +├── static.svfs # Vue 前端虚拟文件系统 +└── data/ # 初始 SQLite 数据库 ``` 运行打包后的项目 @@ -56,3 +55,26 @@ build cd build {{ cookiecutter.project_name }} # windows {{ cookiecutter.project_name }}.exe ``` + +## Docker 部署 + +Docker 镜像采用多角度构建 + `scratch` 基础镜像，真正做到最小化。 + +### 构建镜像 + +```bash +docker build -t {{ cookiecutter.project_name }}:latest . +``` + +### 执行部署脚本 +```bash +sudo chmod +x deploy.sh +./deploy.sh +``` +部署脚本会： + +- 在 `$HOME/{{ cookiecutter.project_name }}-data` 下创建 `data/`, `uploads/`, `logs/` 目录 +- 若首次运行，从镜像提取初始数据库 +- 启动容器并挂载上述目录，端口 `8000` 映射 +- 自动设置 `--restart unless-stopped` + diff --git a/{{ cookiecutter.project_name }}/config.toml b/{{ cookiecutter.project_name }}/config.toml index 97471bd..dfb8b9f 100644 --- a/{{ cookiecutter.project_name }}/config.toml +++ b/{{ cookiecutter.project_name }}/config.toml @@ -1,80 +1,90 @@ [default] +app.debug = false +app.description = "基于 FastAPI 的 {{ cookiecutter.project_name }} 打包脚手架" app.name = "{{ cookiecutter.project_name }}" app.version = "{{ cookiecutter.project_name }}" -app.description = "基于 FastAPI 和 Tortoise-ORM 的 chongming 打包脚手架" -app.debug = false env = "development" +prefix = "/api/v1" +upload_path = "uploads" [database] +database_path = "./data/database.db" type = "sqlite" -url = "sqlite+aiosqlite:///./database.db" -generate_schemas = true # 生产环境使用迁移工具 +url = "sqlite+aiosqlite:///./data/database.db" [database.sqlite] -echo = true -pool_size = 20 -max_overflow = 10 -pool_timeout = 30 -pool_recycle = 300 -pool_pre_ping = true -connect_args.timeout = 15 connect_args.check_same_thread = false +connect_args.timeout = 15 +echo = true +echo_pool = true +max_overflow = 10 +pool_pre_ping = true +pool_recycle = 300 +pool_size = 20 +pool_timeout = 30 + +[scheduler] +job_store_path = "scheduler_jobs.db" + +[cache] +cache_store_path = "./" [security] -secret_key = "your-secret-key-change-in-production" -algorithm = "HS256" access_token_expire_minutes = 30 -refresh_token_expire_days = 7 -jwt_cache_db_path = "jwt_cache" +algorithm = "HS256" max_sessions_per_user = 5 +refresh_token_expire_days = 7 +secret_key = "your-secret-key-change-in-production" [development] -env = "development" debug = true +env = "development" [development.server] +access_log = false host = "127.0.0.1" port = 8000 reload = true [development.logging] -level = "DEBUG" -file = "logs/dev.log" +file = "logs" format = "%(asctime)s - %(name)s - %(levelname)s - %(message)s" +level = "DEBUG" [development.cors] -allow_origins = ["*"] allow_credentials = true -allow_methods = ["*"] allow_headers = ["*"] +allow_methods = ["*"] +allow_origins = ["*"] [production] -env = "production" debug = false +env = "production" [production.server] +access_log = false host = "0.0.0.0" port = 8000 reload = false workers = 4 [production.logging] -level = "INFO" -file = "logs/prod.log" -format = "%(asctime)s - %(name)s - %(levelname)s - %(message)s" -max_size = 10485760 # 10MB -backup_count = 5 # 最多保存 10 个日志文件 +backup_count = 5 # 最多保存 10 个日志文件 +file = "logs" +format = "%(asctime)s - %(name)s - %(levelname)s - %(message)s" +level = "INFO" +max_size = 10485760 # 10MB [production.cors] -allow_origins = ["https://yourdomain.com", "http://localhost:8000", "http://127.0.0.1:8000"] allow_credentials = true -allow_methods = ["GET", "POST", "PUT", "DELETE"] allow_headers = ["Authorization", "Content-Type"] +allow_methods = ["GET", "POST", "PUT", "DELETE"] +allow_origins = ["https://yourdomain.com", "http://localhost:8000", "http://127.0.0.1:8000"] [production.module_system] -type = "module-bank" path = ["resources/app.mbank", "resources/plugins.mbank"] +type = "module-bank" [production.file_system] +path = "static.svfs" type = "svfs" -path = "resources/application.vfs" diff --git a/{{ cookiecutter.project_name }}/deploy.sh b/{{ cookiecutter.project_name }}/deploy.sh new file mode 100644 index 0000000..fb34dde --- /dev/null +++ b/{{ cookiecutter.project_name }}/deploy.sh @@ -0,0 +1,95 @@ +#!/bin/bash +# deploy.sh - {{ cookiecutter.project_name }} 快速部署脚本 +set -e + +# 颜色输出 +RED='\033[0;31m' +GREEN='\033[0;32m' +YELLOW='\033[1;33m' +NC='\033[0m' + +log_info() { echo -e "${GREEN}[INFO]${NC} $1"; } +log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; } +log_error() { echo -e "${RED}[ERROR]${NC} $1"; } + +# 配置 +IMAGE="{{ cookiecutter.project_name }}:latest" +CONTAINER="{{ cookiecutter.project_name }}" +PORT=8000 +DATA_DIR="${HOME}/{{ cookiecutter.project_name }}-data" + +# 检查 docker +if ! command -v docker &> /dev/null; then + log_error "Docker 未安装，请先安装 Docker" + exit 1 +fi + +# 检查镜像 +if ! docker image inspect "$IMAGE" &> /dev/null; then + log_error "镜像 $IMAGE 不存在，请先构建: docker build -t $IMAGE ." + exit 1 +fi + +# 1. 停止并删除旧容器 +if docker ps -a --format '{{.Names}}' | grep -q "^${CONTAINER}$"; then + log_warn "发现旧容器，正在停止并删除..." + docker stop "$CONTAINER" 2>/dev/null || true + docker rm "$CONTAINER" 2>/dev/null || true +fi + +# 2. 创建目录 +log_info "创建数据目录..." +mkdir -p "$DATA_DIR"/{data,uploads,logs} +chmod 755 "$DATA_DIR"/{data,uploads,logs} + +# 3. 复制初始数据（仅在目录为空时） +if [ -z "$(ls -A $DATA_DIR/data 2>/dev/null)" ]; then + log_info "首次部署，从镜像中提取初始数据库..." + TMP_CONTAINER="{{ cookiecutter.project_name }}-tmp-$$" + docker create --name "$TMP_CONTAINER" "$IMAGE" &> /dev/null + docker cp "$TMP_CONTAINER:/app/data/." "$DATA_DIR/data/" &> /dev/null + docker rm "$TMP_CONTAINER" &> /dev/null + log_info "初始数据库已就绪" +else + log_info "数据库已存在，跳过初始化" +fi + +# 检查端口是否被占用 +if ss -tlnp | grep -q ":${PORT}"; then + log_error "端口 ${PORT} 已被占用，请修改 PORT 变量或释放端口" + exit 1 +fi + +# 4. 启动容器 +log_info "启动容器..." +docker run -d \ + -p "$PORT:8000" \ + -v "$DATA_DIR/data:/app/data" \ + -v "$DATA_DIR/uploads:/app/uploads" \ + -v "$DATA_DIR/logs:/app/logs" \ + --restart unless-stopped \ + --name "$CONTAINER" \ + "$IMAGE" + +# 5. 等待启动 +log_info "等待应用启动..." +sleep 3 + +# 6. 检查状态 +if docker ps --format '{{.Names}}' | grep -q "^${CONTAINER}$"; then + log_info "==========================================" + log_info "✅ 部署成功！" + log_info "==========================================" + log_info "应用地址: http://localhost:$PORT" + log_info "API 文档: http://localhost:$PORT/docs" + log_info "数据目录: $DATA_DIR" + log_info "" + log_info "查看日志: docker logs -f $CONTAINER" + log_info "停止服务: docker stop $CONTAINER" + log_info "重启服务: docker restart $CONTAINER" + log_info "==========================================" +else + log_error "容器启动失败，查看日志:" + docker logs "$CONTAINER" 2>/dev/null || true + exit 1 +fi \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/public/config.toml b/{{ cookiecutter.project_name }}/public/config.toml index c65335a..f28c07b 100644 --- a/{{ cookiecutter.project_name }}/public/config.toml +++ b/{{ cookiecutter.project_name }}/public/config.toml @@ -1,78 +1,91 @@ [default] +app.debug = false +app.description = "基于 FastAPI 的 {{ cookiecutter.project_name }} 打包脚手架" app.name = "{{ cookiecutter.project_name }}" app.version = "0.1.0" -app.description = "基于 FastAPI 的 chongming 打包脚手架" -app.debug = false env = "production" +prefix = "/api/v1" +upload_path = "uploads" [database] -type = "sqlite" -url = "sqlite+aiosqlite:///./database.db" -generate_schemas = true # 生产环境使用迁移工具 +generate_schemas = true # 生产环境使用迁移工具 +type = "sqlite" +url = "sqlite+aiosqlite:///./data/database.db" [database.sqlite] -echo = true -pool_size = 20 -max_overflow = 10 -pool_timeout = 30 -pool_recycle = 300 -pool_pre_ping = true -connect_args.timeout = 15 connect_args.check_same_thread = false +connect_args.timeout = 15 +echo = false +echo_pool = false +max_overflow = 10 +pool_pre_ping = true +pool_recycle = 300 +pool_size = 20 +pool_timeout = 30 + +[scheduler] +job_store_path = "scheduler_jobs.db" + +[cache] +cache_store_path = "./" [security] -secret_key = "your-secret-key-change-in-production" -algorithm = "HS256" access_token_expire_minutes = 30 -refresh_token_expire_days = 7 -jwt_cache_db_path = "jwt_cache" +algorithm = "HS256" max_sessions_per_user = 5 +refresh_token_expire_days = 7 +secret_key = "your-secret-key-change-in-production" [development] -env = "development" debug = true +env = "development" [development.server] +access_log = false host = "127.0.0.1" port = 8001 reload = true [development.logging] -level = "DEBUG" -file = "logs/dev.log" +file = "logs" format = "%(asctime)s - %(name)s - %(levelname)s - %(message)s" +level = "DEBUG" [development.cors] -allow_origins = ["*"] allow_credentials = true -allow_methods = ["*"] allow_headers = ["*"] +allow_methods = ["*"] +allow_origins = ["*"] [production] -env = "production" debug = false +env = "production" [production.server] +access_log = false host = "0.0.0.0" port = 8000 reload = false +timeout_keep_alive = 65 workers = 4 [production.logging] -level = "INFO" -file = "logs/prod.log" -format = "%(asctime)s - %(name)s - %(levelname)s - %(message)s" +backup_count = 5 # 最多保存 10 个日志文件 +file = "logs" +format = "%(asctime)s - %(name)s - %(levelname)s - %(message)s" +level = "INFO" +max_size = 10485760 # 10MB [production.cors] -allow_origins = ["https://yourdomain.com", "http://localhost:8000", "http://127.0.0.1:8000"] allow_credentials = true -allow_methods = ["GET", "POST", "PUT", "DELETE"] allow_headers = ["Authorization", "Content-Type"] +allow_methods = ["GET", "POST", "PUT", "DELETE"] +allow_origins = ["https://yourdomain.com", "http://localhost:8000", "http://127.0.0.1:8000"] [production.module_system] -type = "module-bank" path = ["resources/app.mbank", "resources/plugins.mbank"] +type = "module-bank" [production.file_system] +path = "static.svfs" type = "svfs" -path = "resources/application.vfs" diff --git a/{{ cookiecutter.project_name }}/public/main.py b/{{ cookiecutter.project_name }}/public/main.py index 6250102..3603467 100644 --- a/{{ cookiecutter.project_name }}/public/main.py +++ b/{{ cookiecutter.project_name }}/public/main.py @@ -1,33 +1,39 @@ # main.py - 修复 reload 问题 #!/usr/bin/env python3 """ -FastAPI + Tortoise-ORM + {{ cookiecutter.project_name }} 示例 -主入口文件，适配 {{ cookiecutter.project_name }} 打包系统 +FastAPI chongming 示例 +主入口文件，适配 chongming 打包系统 """ + import sys +import platform from utils.launch import launch from multiprocessing import freeze_support import server +use_shell = platform.system() == "Windows" + def app_run(app_config: dict, default_config: dict): """ 应用运行函数 - 适配模块银行环境 Args: - app_config: 应用配置 - default_config: 默认配置 - """ - import uvicorn - from app.core.logger import setup_logging, get_logger # type: ignore + app_config: 应用配置字典，包含服务器配置、环境设置等 + default_config: 默认配置字典，包含应用名称、版本等基础信息 + + Returns: + None: 此函数不返回值，直接启动服务器并阻塞运行 + """ + from app.core.logger import get_logger # type: ignore - setup_logging(app_config["logging"]) logger = get_logger("app") # 获取服务器配置 server_config = app_config.get("server", {}) host = server_config.get("host", "0.0.0.0") port = server_config.get("port", 8000) + timeout_keep_alive = server_config.get("timeout_keep_alive", 5) # 打包环境强制禁用重载 is_frozen = getattr(sys, "frozen", False) @@ -47,18 +53,43 @@ def app_run(app_config: dict, default_config: dict): logger.info(f"👥 Workers: {workers}") logger.info("=" * 50) - uvicorn.run( - "server:app", - host=host, - port=port, - reload=reload, - workers=workers, - log_level="debug" if app_config.get("debug", False) else "info", - access_log=True, - ) + # 根据操作系统选择不同的服务器启动方式 + if use_shell: + import uvicorn + + uvicorn.run( + "server:app", + host=host, + port=port, + reload=reload, + workers=workers, + log_level="debug" if app_config.get("debug", False) else "info", + access_log=False, + timeout_keep_alive=timeout_keep_alive, + ) + else: + from gunicorn.app.wsgiapp import run + + sys.argv = [ + "gunicorn", + "server:app", + "-k", + "uvicorn.workers.UvicornWorker", + "-w", + str(workers), + "-b", + f"{host}:{port}", + ] + run() def main(): + """ + 主函数入口 - 初始化多进程支持并启动应用 + + Returns: + None: 此函数不返回值，调用launch函数启动应用 + """ freeze_support() launch(app_run, "production") diff --git a/{{ cookiecutter.project_name }}/public/server.py b/{{ cookiecutter.project_name }}/public/server.py index 022f923..6e586ec 100644 --- a/{{ cookiecutter.project_name }}/public/server.py +++ b/{{ cookiecutter.project_name }}/public/server.py @@ -3,17 +3,19 @@ import sys from utils.launch import init_module_bank from utils.config import ConfigLoader +# 加载配置文件并初始化模块银行 config = ConfigLoader("config.toml") init_module_bank(config) -# 从数据库导入真正的 app 模块 +# 从数据库动态导入 app 模块 +# 该模块存储在 SQLite 数据库中，通过自定义导入机制加载 try: - import app # type: ignore # 此时会从 SQLite 数据库加载 + import app # type: ignore - app_instance = app.app # 获取 FastAPI 实例 + app_instance = app.app except ImportError as e: print(f"无法从数据库导入 app 模块: {e}") sys.exit(1) -# 暴露 ASGI 应用变量，供 uvicorn 使用 +# 暴露 ASGI 应用实例，供 uvicorn 服务器使用 app = app_instance diff --git a/{{ cookiecutter.project_name }}/public/utils/config.py b/{{ cookiecutter.project_name }}/public/utils/config.py index 0e3d837..bef1306 100644 --- a/{{ cookiecutter.project_name }}/public/utils/config.py +++ b/{{ cookiecutter.project_name }}/public/utils/config.py @@ -6,6 +6,7 @@ import sys from pathlib import Path from typing import Any, Dict, Optional +# 根据Python版本选择合适的TOML解析库 if sys.version_info >= (3, 11): import tomllib else: @@ -13,7 +14,15 @@ else: class ConfigLoader: - """TOML配置文件加载器""" + """TOML配置文件加载器 + + 提供配置文件的加载、访问和管理功能。支持自动查找配置文件、 + 点号分隔的嵌套键访问、配置节获取以及配置重载等功能。 + + Attributes: + config_path: 配置文件的路径 + _config: 存储解析后的配置数据 + """ def __init__(self, config_path: Optional[str] = None): """ @@ -21,6 +30,9 @@ class ConfigLoader: Args: config_path: 配置文件路径，如果为None则自动查找 + + Raises: + FileNotFoundError: 当无法找到配置文件时抛出异常 """ if config_path is None: # 自动查找配置文件 @@ -31,7 +43,21 @@ class ConfigLoader: self.load() def _find_config_file(self) -> str: - """自动查找配置文件""" + """ + 自动查找配置文件 + + 按照预定义的优先级顺序搜索配置文件： + 1. 当前目录下的config.toml + 2. config子目录下的config.toml + 3. 用户配置目录~/.config/myapp/config.toml + 4. 系统配置目录/etc/myapp/config.toml + + Returns: + str: 找到的第一个配置文件路径 + + Raises: + FileNotFoundError: 当所有可能的位置都未找到配置文件时抛出异常 + """ possible_paths = [ "config.toml", "config/config.toml", @@ -47,7 +73,15 @@ class ConfigLoader: raise FileNotFoundError("未找到配置文件") def load(self) -> None: - """加载配置文件""" + """ + 加载配置文件 + + 读取并解析TOML格式的配置文件，将配置数据存储到内部字典中。 + + Raises: + FileNotFoundError: 当配置文件不存在时抛出异常 + tomllib.TOMLDecodeError: 当配置文件格式不正确时抛出异常 + """ if not self.config_path.exists(): raise FileNotFoundError(f"配置文件不存在: {self.config_path}") @@ -55,7 +89,20 @@ class ConfigLoader: self._config = tomllib.loads(f.read()) def get(self, key: str, default: Any = None) -> Any: - """获取配置值，支持点号分隔的路径""" + """ + 获取配置值，支持点号分隔的路径 + + 通过点号分隔的键路径访问嵌套的配置值。例如： + - "database.host" 访问 {"database": {"host": "localhost"}} + - "server.port" 访问 {"server": {"port": 8080}} + + Args: + key: 配置键，支持点号分隔的嵌套路径 + default: 当键不存在时返回的默认值，默认为None + + Returns: + Any: 配置值，如果键不存在则返回默认值 + """ keys = key.split(".") value = self._config @@ -67,22 +114,71 @@ class ConfigLoader: return default def get_section(self, section: str) -> Dict[str, Any]: - """获取整个配置节""" + """ + 获取整个配置节 + + 返回指定配置节的完整字典内容，适用于需要访问某个配置节下 + 所有配置项的场景。 + + Args: + section: 配置节名称 + + Returns: + Dict[str, Any]: 配置节的内容字典，如果节不存在则返回空字典 + """ return self._config.get(section, {}) def reload(self) -> None: - """重新加载配置文件""" + """ + 重新加载配置文件 + + 从磁盘重新读取配置文件并更新内部配置数据。 + 适用于配置文件在运行时被修改的场景。 + + Raises: + FileNotFoundError: 当配置文件不存在时抛出异常 + """ self.load() def __getitem__(self, key: str) -> Any: - """支持字典式访问""" + """ + 支持字典式访问 + + 允许使用方括号语法访问配置值，如：config["database.host"] + + Args: + key: 配置键 + + Returns: + Any: 配置值 + + Raises: + KeyError: 当键不存在且无默认值时抛出异常（通过get方法处理） + """ return self.get(key) def __contains__(self, key: str) -> bool: - """检查配置是否存在""" + """ + 检查配置是否存在 + + 支持使用in操作符检查配置键是否存在，如："database.host" in config + + Args: + key: 要检查的配置键 + + Returns: + bool: 如果配置键存在且值不为None则返回True，否则返回False + """ return self.get(key) is not None @property def all(self) -> Dict[str, Any]: - """获取所有配置""" + """ + 获取所有配置 + + 返回完整的配置字典，适用于需要遍历或导出所有配置的场景。 + + Returns: + Dict[str, Any]: 包含所有配置的字典 + """ return self._config diff --git a/{{ cookiecutter.project_name }}/public/utils/launch.py b/{{ cookiecutter.project_name }}/public/utils/launch.py index d18e7c9..27be687 100644 --- a/{{ cookiecutter.project_name }}/public/utils/launch.py +++ b/{{ cookiecutter.project_name }}/public/utils/launch.py @@ -7,14 +7,29 @@ key = None def init_module_bank(config): + """ + 初始化模块银行系统，将指定路径下的Python模块打包并安装导入器。 + + 该函数会验证所有模块路径的有效性，创建PythonToSQLite打包器实例， + 列出所有可用模块，并为每个打包器安装导入器以支持模块的动态加载。 + + Args: + config (dict): 配置字典，必须包含 'production' -> 'module_system' -> 'path' 键， + 其值为模块路径列表 + + Raises: + ValueError: 当配置的模块路径中有任何一个不存在时抛出异常 + """ MODULE_BANK_PATH_LIST = config["production"]["module_system"]["path"] for module_path in MODULE_BANK_PATH_LIST: - if os.path.exists(module_path) == False: + if not os.path.exists(module_path): raise ValueError(f"模块路径不存在: {module_path}") + # 为每个模块路径创建PythonToSQLite打包器实例 packer_list = [ PythonToSQLite(module_path, key=key) for module_path in MODULE_BANK_PATH_LIST ] + # 遍历所有打包器，列出模块信息并安装导入器 for packer in packer_list: modules = packer.list_modules() for module in modules: @@ -23,6 +38,21 @@ def init_module_bank(config): def launch(run_fun: Callable[[dict, dict], None], run_mode: str): + """ + 启动应用程序，加载配置并执行指定的运行函数。 + + 该函数从config.toml文件中加载配置，根据运行模式获取对应的应用配置和默认配置， + 然后调用传入的运行函数执行应用程序逻辑。 + + Args: + run_fun (Callable[[dict, dict], None]): 运行函数，接收两个参数： + - app_config (dict): 当前运行模式的配置 + - default_config (dict): 默认配置 + run_mode (str): 运行模式，用于从配置文件中获取对应模式的配置项 + + Returns: + None + """ config = ConfigLoader("config.toml") # 获取对应运行模式的配置 diff --git a/{{ cookiecutter.project_name }}/pyproject.toml b/{{ cookiecutter.project_name }}/pyproject.toml index 66dfcb6..3c978c7 100644 --- a/{{ cookiecutter.project_name }}/pyproject.toml +++ b/{{ cookiecutter.project_name }}/pyproject.toml @@ -9,14 +9,17 @@ description = "基于 modules-bank 的 fastapi 打包脚手架" readme = "README.md" requires-python = ">=3.8" dependencies = [ + "aiofiles", "aiosqlite", - "bcrypt==4.0.1", + "apscheduler", + "bcrypt", + "diskcache", "fastapi[uvicorn]", + "gunicorn", "module-bank", - "passlib[bcrypt]", "pyjwt", + "python-multipart", "sqlite-vfs", - "sqlitedict", "sqlmodel[aiosqlite]", "tomli", "typing-extensions", @@ -35,6 +38,7 @@ url = "https://mirrors.ustc.edu.cn/pypi/web/simple/" dev = [ "pyarmor", "pyinstaller", + "ruff>=0.15.10", ] [tool.hatch.build.targets.wheel] @@ -42,4 +46,5 @@ packages = ["src/{{ cookiecutter.project_name }}"] [project.scripts] build = "{{ cookiecutter.project_name }}.scripts.build:build" -serve = "{{ cookiecutter.project_name }}:serve" \ No newline at end of file +serve = "{{ cookiecutter.project_name }}:serve" +gunicorn = "{{ cookiecutter.project_name }}:gunicorn_serve" diff --git a/{{ cookiecutter.project_name }}/pyrightconfig.json b/{{ cookiecutter.project_name }}/pyrightconfig.json index a499e3b..2f5d117 100644 --- a/{{ cookiecutter.project_name }}/pyrightconfig.json +++ b/{{ cookiecutter.project_name }}/pyrightconfig.json @@ -4,6 +4,6 @@ "pythonVersion": "{{ cookiecutter.python_version }}", "extraPaths": [ "./", - "./.venv/lib/python3.12/site-packages" + "./.venv/lib/python{{ cookiecutter.python_version }}/site-packages" ] } \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/requirements.txt b/{{ cookiecutter.project_name }}/requirements.txt index 528d3f4..3516563 100644 --- a/{{ cookiecutter.project_name }}/requirements.txt +++ b/{{ cookiecutter.project_name }}/requirements.txt @@ -1,16 +1,15 @@ -aerich +aiofiles +aiosqlite +apscheduler +bcrypt +diskcache fastapi[uvicorn] -module-bank==0.1.1 -passlib -pydantic-settings -pydantic[email] -sqlite-vfs -toml -tortoise-orm -uvicorn[standard] -sqlitedict +gunicorn +module-bank pyjwt -bcrypt==4.0.1 -pyinstaller -aerich -requests \ No newline at end of file +python-multipart +sqlite-vfs +sqlmodel[aiosqlite] +tomli +typing-extensions +uvicorn \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/src/plugins/jwt/__init__.py b/{{ cookiecutter.project_name }}/src/plugins/jwt/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/jwt_cache.py b/{{ cookiecutter.project_name }}/src/plugins/jwt/jwt_cache.py similarity index 54% rename from {{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/jwt_cache.py rename to {{ cookiecutter.project_name }}/src/plugins/jwt/jwt_cache.py index 756ff4e..318cd1e 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/jwt_cache.py +++ b/{{ cookiecutter.project_name }}/src/plugins/jwt/jwt_cache.py @@ -1,17 +1,12 @@ -import jwt import json from datetime import datetime, timedelta -from typing import Optional, Dict, Any, List, TypedDict -from sqlitedict import SqliteDict +from typing import Optional, Dict, Any, List from pydantic import BaseModel from dataclasses import dataclass, asdict - -# from pydantic import BaseModel import hashlib import threading -from pathlib import Path -from .config import get_config +import jwt @dataclass @@ -31,6 +26,7 @@ class TokenCacheData: token_type: str = "access" # access 或 refresh def __post_init__(self): + """初始化后处理，设置默认时间戳""" if self.created_at is None: self.created_at = datetime.utcnow().isoformat() if self.last_used is None: @@ -38,54 +34,37 @@ class TokenCacheData: class JWTCache: - """JWT Token 缓存管理器""" + """JWT Token 缓存管理器 - def __init__(self, db_path: Optional[str] = None): - self.config = get_config() + 负责 JWT Token 的创建、验证、失效和会话管理。 + 使用 Redis 缓存存储 Token 哈希和用户会话索引，支持多设备登录和会话限制。 + """ - if db_path is None: - db_path = self.config["security"]["jwt_cache_db_path"] + def __init__(self, config, cache): + """初始化 JWT 缓存管理器 - db_file_path = Path(db_path) - db_file_path.mkdir(parents=True, exist_ok=True) + Args: + config: 配置字典，包含 security 相关配置项 + cache: 缓存实例，提供 get/set/delete/exists/keys 等方法 + """ + self.config = config self.lock = threading.RLock() - # 主 Token 缓存 - self.token_db = SqliteDict( - rf"{db_path}/tokens.cache", - tablename="tokens", - autocommit=True, - encode=self._json_encode, - decode=self._json_decode, - journal_mode="WAL", - ) - - # 黑名单缓存 - self.blacklist_db = SqliteDict( - rf"{db_path}/blacklist.cache", - tablename="blacklist", - autocommit=True, - encode=json.dumps, - decode=json.loads, - journal_mode="WAL", - ) - - # 用户会话索引 - self.user_sessions_db = SqliteDict( - rf"{db_path}/user_sessions.cache", - tablename="user_sessions", - autocommit=True, - encode=json.dumps, - decode=json.loads, - journal_mode="WAL", - ) + self.cache = cache self.secret_key = self.config["security"]["secret_key"] self.algorithm = self.config["security"]["algorithm"] def _json_encode(self, obj): - """自定义 JSON 编码器，处理 datetime 对象""" + """自定义 JSON 编码器，处理 datetime 对象 + + Args: + obj: 需要序列化的对象 + + Returns: + JSON 字符串 + """ def convert_datetime(o): if isinstance(o, datetime): @@ -97,11 +76,25 @@ class JWTCache: return json.dumps(obj, default=convert_datetime) def _json_decode(self, s): - """自定义 JSON 解码器""" + """自定义 JSON 解码器 + + Args: + s: JSON 字符串 + + Returns: + 解码后的 Python 对象 + """ return json.loads(s) def _hash_token(self, token: str) -> str: - """Token 哈希化（避免存储明文 Token）""" + """Token 哈希化（避免存储明文 Token） + + Args: + token: 原始 JWT Token 字符串 + + Returns: + SHA256 哈希值（十六进制字符串） + """ return hashlib.sha256(token.encode()).hexdigest() def create_token( @@ -113,16 +106,18 @@ class JWTCache: user_agent: Optional[str] = None, ip_address: Optional[str] = None, ) -> str: - """ - 创建并缓存 JWT Token + """创建并缓存 JWT Token + + 生成新的 JWT Token，将其哈希值和元数据存储到缓存中， + 并更新用户会话索引。如果超出会话限制，会自动清理最早的会话。 Args: user_id: 用户ID - user_data: 用户数据 + user_data: 用户数据，将嵌入到 Token payload 中 token_type: Token 类型（access 或 refresh） - device_id: 设备ID - user_agent: 用户代理 - ip_address: IP地址 + device_id: 设备ID，用于标识登录设备 + user_agent: 用户代理字符串，记录客户端信息 + ip_address: IP地址，记录登录来源 Returns: JWT Token 字符串 @@ -168,7 +163,7 @@ class JWTCache: ) # 存储到缓存 - self.token_db[token_hash] = asdict(cache_data) + self.cache.set(f"token:{token_hash}", asdict(cache_data)) # 更新用户会话索引 self._update_user_session_index(user_id, token_hash, token_type) @@ -179,7 +174,11 @@ class JWTCache: return token def _generate_jti(self) -> str: - """生成唯一的 JWT ID""" + """生成唯一的 JWT ID + + Returns: + UUID v4 字符串，用作 Token 的唯一标识符 + """ import uuid return str(uuid.uuid4()) @@ -187,10 +186,19 @@ class JWTCache: def _update_user_session_index( self, user_id: str, token_hash: str, token_type: str ): - """更新用户会话索引""" + """更新用户会话索引 + + 维护每个用户每种 Token 类型的会话列表，限制最大数量为 100。 + 当超过限制时，保留最新的 100 个会话。 + + Args: + user_id: 用户ID + token_hash: Token 的 SHA256 哈希值 + token_type: Token 类型（access 或 refresh） + """ with self.lock: - key = f"{user_id}:{token_type}" - user_tokens = self.user_sessions_db.get(key, []) + key = f"user:{user_id}:{token_type}" + user_tokens = self.cache.get(key, []) # 添加新 token user_tokens.append(token_hash) @@ -200,49 +208,63 @@ class JWTCache: if len(user_tokens) > max_tokens: user_tokens = user_tokens[-max_tokens:] - self.user_sessions_db[key] = user_tokens + self.cache.set(key, user_tokens) def _enforce_session_limit(self, user_id: str): - """强制用户会话限制""" + """强制用户会话限制 + + 检查用户的 access 和 refresh token 数量，如果超过配置的最大会话数， + 则删除最早的会话以维持限制。 + + Args: + user_id: 用户ID + """ max_sessions = self.config["security"]["max_sessions_per_user"] - access_key = f"{user_id}:access" - refresh_key = f"{user_id}:refresh" + access_key = f"user:{user_id}:access" + refresh_key = f"user:{user_id}:refresh" # 检查 access token 数量 - access_tokens = self.user_sessions_db.get(access_key, []) + access_tokens = self.cache.get(access_key, []) if len(access_tokens) > max_sessions: # 删除最早的 token tokens_to_remove = access_tokens[:-max_sessions] for token_hash in tokens_to_remove: - if token_hash in self.token_db: - del self.token_db[token_hash] + if self.cache.exists(f"token:{token_hash}"): + self.cache.delete(f"token:{token_hash}") # 更新索引 - self.user_sessions_db[access_key] = access_tokens[-max_sessions:] + self.cache.set(access_key, access_tokens[-max_sessions:]) # 检查 refresh token 数量 - refresh_tokens = self.user_sessions_db.get(refresh_key, []) + refresh_tokens = self.cache.get(refresh_key, []) if len(refresh_tokens) > max_sessions: tokens_to_remove = refresh_tokens[:-max_sessions] for token_hash in tokens_to_remove: - if token_hash in self.token_db: - del self.token_db[token_hash] + if self.cache.exists(f"token:{token_hash}"): + self.cache.delete(f"token:{token_hash}") - self.user_sessions_db[refresh_key] = refresh_tokens[-max_sessions:] + self.cache.set(refresh_key, refresh_tokens[-max_sessions:]) def validate_token( self, token: str, token_type: str = "access" ) -> Optional[Dict[str, Any]]: - """ - 验证 JWT Token + """验证 JWT Token + + 执行多层验证：JWT 签名验证、类型检查、缓存存在性检查、 + 活跃状态检查和过期时间检查。验证成功后更新最后使用时间。 Args: - token: JWT Token - token_type: 期望的 Token 类型 + token: JWT Token 字符串 + token_type: 期望的 Token 类型（access 或 refresh） Returns: - 验证成功返回用户数据，失败返回 None + 验证成功返回包含用户信息的字典，包含以下字段： + - user_id: 用户ID + - device_id: 设备ID + - payload: JWT payload 数据 + - cache_data: 缓存中的完整会话数据 + 验证失败返回 None """ try: # 解码验证 Token @@ -259,14 +281,11 @@ class JWTCache: if not user_id or not jti: return None - # 检查黑名单 token_hash = self._hash_token(token) - if self._is_blacklisted(token_hash): - return None # 检查缓存 with self.lock: - cache_data = self.token_db.get(token_hash) + cache_data = self.cache.get(f"token:{token_hash}") if not cache_data: return None @@ -279,12 +298,12 @@ class JWTCache: if datetime.utcnow() > expires_at: # 标记为不活跃 cache_data["is_active"] = False - self.token_db[token_hash] = cache_data + self.cache.set(f"token:{token_hash}", cache_data) return None # 更新最后使用时间 cache_data["last_used"] = datetime.utcnow().isoformat() - self.token_db[token_hash] = cache_data + self.cache.set(f"token:{token_hash}", cache_data) return { "user_id": user_id, @@ -300,81 +319,84 @@ class JWTCache: except Exception: return None - def add_to_blacklist(self, token: str, reason: str = "logout"): - """添加 Token 到黑名单""" - token_hash = self._hash_token(token) - expire_time = datetime.utcnow() + timedelta(days=7) # 黑名单保留7天 - - self.blacklist_db[token_hash] = { - "reason": reason, - "blacklisted_at": datetime.utcnow().isoformat(), - "expires_at": expire_time.isoformat(), - } - - def _is_blacklisted(self, token_hash: str) -> bool: - """检查 Token 是否在黑名单中""" - with self.lock: - if token_hash not in self.blacklist_db: - return False - - blacklist_data = self.blacklist_db[token_hash] - expires_at = datetime.fromisoformat(blacklist_data["expires_at"]) - - # 如果黑名单条目已过期，删除它 - if datetime.utcnow() > expires_at: - del self.blacklist_db[token_hash] - return False - - return True - def invalidate_token(self, token: str): - """使单个 Token 失效""" + """使单个 Token 失效 + + 通过标记缓存中的 Token 为非活跃状态来实现失效， + 而不是直接删除，以便保留审计信息。 + + Args: + token: 需要失效的 JWT Token 字符串 + """ with self.lock: token_hash = self._hash_token(token) - # 添加到黑名单 - self.add_to_blacklist(token) - # 标记为不活跃 - if token_hash in self.token_db: - cache_data = self.token_db[token_hash] + if self.cache.exists(f"token:{token_hash}"): + cache_data = self.cache.get(f"token:{token_hash}") cache_data["is_active"] = False - self.token_db[token_hash] = cache_data + self.cache.set(f"token:{token_hash}", cache_data) def invalidate_user_tokens(self, user_id: str, token_type: Optional[str] = None): - """使用户的所有 Token 失效""" + """使用户的所有 Token 失效 + + 批量失效指定用户的所有 Token，可用于用户登出、密码修改等场景。 + 可以指定失效特定类型的 Token，或者同时失效 access 和 refresh token。 + + Args: + user_id: 用户ID + token_type: 可选，指定要失效的 Token 类型（access 或 refresh）。 + 如果不指定，则失效该用户的所有类型 Token + """ with self.lock: if token_type: - keys = [f"{user_id}:{token_type}"] + keys = [f"user:{user_id}:{token_type}"] else: - keys = [f"{user_id}:access", f"{user_id}:refresh"] + keys = [f"user:{user_id}:access", f"user:{user_id}:refresh"] for key in keys: - token_hashes = self.user_sessions_db.get(key, []) + token_hashes = self.cache.get(key, []) for token_hash in token_hashes: # 添加到黑名单 # 注意：这里我们只有 token_hash，没有原始 token # 所以只能标记为不活跃 - if token_hash in self.token_db: - cache_data = self.token_db[token_hash] + if self.cache.exists(f"token:{token_hash}"): + cache_data = self.cache.get(f"token:{token_hash}") cache_data["is_active"] = False - self.token_db[token_hash] = cache_data + self.cache.set(f"token:{token_hash}", cache_data) # 清空用户会话索引 - self.user_sessions_db[key] = [] + self.cache.set(key, []) def get_user_sessions(self, user_id: str) -> List[Dict[str, Any]]: - """获取用户的所有活跃会话""" + """获取用户的所有活跃会话 + + 遍历用户的所有 Token 会话，过滤出当前活跃且未过期的会话， + 返回包含设备信息、时间戳等详细信息的会话列表。 + + Args: + user_id: 用户ID + + Returns: + 活跃会话列表，每个会话包含以下字段： + - token_type: Token 类型 + - device_id: 设备ID + - user_agent: 用户代理 + - ip_address: IP地址 + - created_at: 创建时间 + - last_used: 最后使用时间 + - expires_at: 过期时间 + """ with self.lock: sessions = [] for token_type in ["access", "refresh"]: - key = f"{user_id}:{token_type}" - token_hashes = self.user_sessions_db.get(key, []) + key = f"user:{user_id}:{token_type}" + token_hashes = self.cache.get(key, []) for token_hash in token_hashes: - if token_hash in self.token_db: - cache_data = self.token_db[token_hash] + if self.cache.exists(f"token:{token_hash}"): + cache_data = self.cache.get(f"token:{token_hash}") # 检查是否活跃且未过期 if cache_data.get("is_active", True): @@ -397,50 +419,62 @@ class JWTCache: return sessions def cleanup_expired(self): - """清理过期数据""" + """清理过期数据 + + 扫描所有 Token 缓存，删除已过期的 Token 记录。 + 建议定期调用此方法以释放缓存空间。 + + Returns: + 清理的过期 Token 数量 + """ with self.lock: cleaned_count = 0 current_time = datetime.utcnow() # 清理过期 Token - for token_hash, data in list(self.token_db.items()): - expires_at = datetime.fromisoformat(data["expires_at"]) + for token_hash in self.cache.keys("token:*"): + expires_at = datetime.fromisoformat(self.cache.get(token_hash)) if current_time > expires_at: - del self.token_db[token_hash] - cleaned_count += 1 - - # 清理过期黑名单 - for token_hash, data in list(self.blacklist_db.items()): - expires_at = datetime.fromisoformat(data["expires_at"]) - if current_time > expires_at: - del self.blacklist_db[token_hash] + self.cache.delete(token_hash) cleaned_count += 1 return cleaned_count - def close(self): - with self.lock: - """关闭所有数据库连接""" - self.token_db.close() - self.blacklist_db.close() - self.user_sessions_db.close() - # 全局缓存实例 _jwt_cache = None -def get_jwt_cache() -> JWTCache: - """获取 JWT 缓存实例（单例模式）""" +def get_jwt_cache(config=None, cache=None) -> JWTCache: + """获取 JWT 缓存实例（单例模式） + + 确保整个应用中只有一个 JWTCache 实例，避免重复初始化和资源浪费。 + 首次调用时必须提供 config 和 cache 参数。 + + Args: + config: 配置字典，仅在首次初始化时需要 + cache: 缓存实例，仅在首次初始化时需要 + + Returns: + JWTCache 单例实例 + + Raises: + ValueError: 首次调用时如果 config 或 cache 为空则抛出异常 + """ global _jwt_cache if _jwt_cache is None: - _jwt_cache = JWTCache() + if config is None or cache is None: + raise ValueError("参数 config 和 cache 不能为空") + _jwt_cache = JWTCache(config, cache) return _jwt_cache # Token 响应模型 class TokenResponse(BaseModel): - """Token 响应模型""" + """Token 响应模型 + + 用于登录接口返回 access token 和 refresh token + """ access_token: str refresh_token: str @@ -449,9 +483,22 @@ class TokenResponse(BaseModel): refresh_expires_in: int +class RefreshTokenResponse(BaseModel): + """刷新 Token 响应模型 + + 用于刷新 token 接口，仅返回新的 access token + """ + + access_token: str + token_type: str = "bearer" + + # Token 数据模型 class TokenData(BaseModel): - """Token 数据模型""" + """Token 数据模型 + + 用于从 Token 中提取的用户身份信息 + """ user_id: str username: Optional[str] = None diff --git a/{{ cookiecutter.project_name }}/src/plugins/scheduler/__init__.py b/{{ cookiecutter.project_name }}/src/plugins/scheduler/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/{{ cookiecutter.project_name }}/src/plugins/scheduler/scheduler.py b/{{ cookiecutter.project_name }}/src/plugins/scheduler/scheduler.py new file mode 100644 index 0000000..1cd3d3c --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/plugins/scheduler/scheduler.py @@ -0,0 +1,560 @@ +""" +APScheduler 集成模块 +提供持久化任务调度服务 +""" + +import os +import sys +import tempfile +from contextlib import suppress +from typing import Dict, List, Optional, Callable, AsyncGenerator +from datetime import datetime + +from fastapi import Request +from apscheduler.schedulers.asyncio import AsyncIOScheduler +from apscheduler.jobstores.sqlalchemy import SQLAlchemyJobStore +from apscheduler.executors.asyncio import AsyncIOExecutor +from apscheduler.job import Job +from apscheduler.triggers.interval import IntervalTrigger +from apscheduler.triggers.cron import CronTrigger +from apscheduler.triggers.date import DateTrigger + + +def acquire_scheduler_lock(): + """ + 获取调度器分布式锁，确保只有一个进程实例运行调度器 + + 通过在临时目录创建锁文件并使用文件系统锁机制，防止多个进程同时启动调度器。 + 支持 Windows 和 Unix/Linux 系统的不同锁实现。 + + Returns: + tuple: 包含两个元素的元组 + - lock_file (file object or None): 锁文件对象，如果获取锁失败则为 None + - bool: 是否成功获取锁，成功为 True，失败为 False + """ + lock_path = os.path.join(tempfile.gettempdir(), "chongming_scheduler.lock") + lock_file = open(lock_path, "w") + try: + if sys.platform == "win32": + import msvcrt + + msvcrt.locking(lock_file.fileno(), msvcrt.LK_NBLCK, 1) + else: + import fcntl + + fcntl.flock(lock_file.fileno(), fcntl.LOCK_NB | fcntl.LOCK_EX) + return lock_file, True + except (IOError, OSError): + lock_file.close() + return None, False + + +class TaskService: + """ + 任务调度服务类 + + 基于 APScheduler 实现的异步任务调度服务，支持多种触发器类型（间隔、Cron、一次性）。 + 使用 SQLite 数据库持久化存储任务信息，确保服务重启后任务不丢失。 + 通过文件锁机制保证多进程环境下只有一个实例执行调度任务。 + """ + + def __init__(self, config, logger, async_session_maker=None): + """ + 初始化任务调度服务 + + Args: + config (dict): 配置字典，包含调度器相关配置项 + - scheduler.job_store_path (str): 任务存储数据库路径，默认为 "scheduler_jobs.db" + logger (logging.Logger): 日志记录器实例，用于记录调度器运行日志 + async_session_maker (callable, optional): 异步会话工厂函数，用于数据库操作，默认为 None + + Attributes: + async_session_maker: 异步会话工厂函数 + job_store_db_path: 任务存储数据库文件路径 + scheduler: AsyncIOScheduler 调度器实例 + _started (bool): 调度器是否已启动的标志 + lock_file: 锁文件对象 + is_scheduler_worker (bool): 当前进程是否为调度器工作进程 + logger: 日志记录器实例 + """ + self.async_session_maker = async_session_maker + # 使用独立的 SQLite 数据库存储任务（与业务数据库分开） + self.job_store_db_path = config.get("scheduler", {}).get( + "job_store_path", "scheduler_jobs.db" + ) + job_store_url = f"sqlite:///{self.job_store_db_path}" + + # 配置 job stores 和 executors + jobstores = {"default": SQLAlchemyJobStore(url=job_store_url)} + executors = {"default": AsyncIOExecutor()} + job_defaults = { + "coalesce": True, # 合并错过的任务 + "max_instances": 3, # 最大并发实例数 + "misfire_grace_time": 30, # 错过任务的宽限时间（秒） + } + + self.scheduler = AsyncIOScheduler( + jobstores=jobstores, + executors=executors, + job_defaults=job_defaults, + timezone="Asia/Shanghai", + ) + self._started = False + self.lock_file, self.is_scheduler_worker = acquire_scheduler_lock() + self.logger = logger + + async def start(self, init_tasks_callback: Optional[Callable] = None): + """ + 启动任务调度器 + + 仅在当前进程成功获取调度器锁时启动调度器，避免多进程重复启动。 + 启动后可选择执行初始化任务回调函数。 + + Args: + init_tasks_callback (callable, optional): 初始化任务回调函数，接收 TaskService 实例作为参数。 + 用于在调度器启动后注册初始任务。默认为 None。 + + Note: + - 如果调度器已经启动，不会重复启动 + - 只有成功获取锁的进程才会启动调度器 + """ + if self.is_scheduler_worker: + if not self._started: + self.scheduler.start() + self._started = True + self.logger.info("任务调度器已启动") + if init_tasks_callback: + await init_tasks_callback(self) + + async def shutdown(self, wait: bool = True): + """ + 关闭任务调度器 + + 优雅地关闭调度器，包括暂停所有运行中的任务、关闭调度器、释放文件锁。 + + Args: + wait (bool): 是否等待正在执行的任务完成后再关闭。 + True 表示等待任务完成，False 表示立即关闭。默认为 True。 + + Note: + - 先暂停所有任务，再关闭调度器 + - 释放文件锁以允许其他进程获取锁 + - 使用 suppress 捕获所有异常，确保关闭过程不会抛出异常 + """ + if self.lock_file: + with suppress(Exception): + for job in await self.get_jobs(): + await self.pause_job(job.get("id", "")) + + if self._started: + self.scheduler.shutdown(wait=wait) + self._started = False + self.logger.info("任务调度器已关闭") + if sys.platform == "win32": + import msvcrt + + msvcrt.locking(self.lock_file.fileno(), msvcrt.LK_UNLCK, 1) + else: + import fcntl + + fcntl.flock(self.lock_file.fileno(), fcntl.LOCK_UN) + self.lock_file.close() + + async def add_interval_job( + self, + func: Callable, + seconds: int = 0, + minutes: int = 0, + hours: int = 0, + days: int = 0, + job_id: Optional[str] = None, + args: Optional[List] = None, + kwargs: Optional[Dict] = None, + replace_existing: bool = True, + ) -> Job: + """ + 添加间隔执行任务 + + 创建按照固定时间间隔重复执行的任务。 + + Args: + func (callable): 要执行的任务函数 + seconds (int): 间隔秒数，默认为 0 + minutes (int): 间隔分钟数，默认为 0 + hours (int): 间隔小时数，默认为 0 + days (int): 间隔天数，默认为 0 + job_id (str, optional): 任务唯一标识符，如果未提供则自动生成 + args (list, optional): 传递给任务函数的位置参数列表，默认为空列表 + kwargs (dict, optional): 传递给任务函数的关键字参数字典，默认为空字典 + replace_existing (bool): 如果存在相同 ID 的任务，是否替换它。默认为 True + + Returns: + Job: 创建的任务对象 + + Example: + >>> await service.add_interval_job(my_func, minutes=5, job_id="cleanup_task") + """ + trigger = IntervalTrigger( + seconds=seconds, minutes=minutes, hours=hours, days=days + ) + job = self.scheduler.add_job( + func, + trigger=trigger, + id=job_id, + args=args or [], + kwargs=kwargs or {}, + replace_existing=replace_existing, + ) + self.logger.info(f"添加间隔任务: {job.id}") + return job + + async def add_cron_job( + self, + func: Callable, + job_id: Optional[str] = None, + year: Optional[int] = None, + month: Optional[int] = None, + day: Optional[int] = None, + week: Optional[int] = None, + day_of_week: Optional[int] = None, + hour: Optional[int] = None, + minute: Optional[int] = None, + second: Optional[int] = None, + args: Optional[List] = None, + kwargs: Optional[Dict] = None, + replace_existing: bool = True, + ) -> Job: + """ + 添加 Cron 表达式任务 + + 创建按照 Cron 表达式规则执行的任务，支持精确的时间调度。 + + Args: + func (callable): 要执行的任务函数 + job_id (str, optional): 任务唯一标识符，如果未提供则自动生成 + year (int, optional): 年份，支持通配符和范围 + month (int, optional): 月份 (1-12) + day (int, optional): 日期 (1-31) + week (int, optional): 周数 (1-53) + day_of_week (int, optional): 星期几 (0-6, 0 表示周一) + hour (int, optional): 小时 (0-23) + minute (int, optional): 分钟 (0-59) + second (int, optional): 秒 (0-59) + args (list, optional): 传递给任务函数的位置参数列表，默认为空列表 + kwargs (dict, optional): 传递给任务函数的关键字参数字典，默认为空字典 + replace_existing (bool): 如果存在相同 ID 的任务，是否替换它。默认为 True + + Returns: + Job: 创建的任务对象 + + Example: + >>> # 每天凌晨 2 点执行 + >>> await service.add_cron_job(my_func, hour=2, minute=0, job_id="daily_task") + """ + trigger = CronTrigger( + year=year, + month=month, + day=day, + week=week, + day_of_week=day_of_week, + hour=hour, + minute=minute, + second=second, + ) + job = self.scheduler.add_job( + func, + trigger=trigger, + id=job_id, + args=args or [], + kwargs=kwargs or {}, + replace_existing=replace_existing, + ) + self.logger.info(f"添加 cron 任务: {job.id}") + return job + + async def add_date_job( + self, + func: Callable, + run_date: Optional[datetime] = None, + job_id: Optional[str] = None, + args: Optional[List] = None, + kwargs: Optional[Dict] = None, + replace_existing: bool = True, + ) -> Job: + """ + 添加一次性任务 + + 创建在指定时间点执行一次的任务，执行后自动移除。 + + Args: + func (callable): 要执行的任务函数 + run_date (datetime, optional): 任务执行的具体时间，如果未提供则立即执行 + job_id (str, optional): 任务唯一标识符，如果未提供则自动生成 + args (list, optional): 传递给任务函数的位置参数列表，默认为空列表 + kwargs (dict, optional): 传递给任务函数的关键字参数字典，默认为空字典 + replace_existing (bool): 如果存在相同 ID 的任务，是否替换它。默认为 True + + Returns: + Job: 创建的任务对象 + + Example: + >>> from datetime import datetime + >>> run_time = datetime(2024, 12, 25, 10, 0, 0) + >>> await service.add_date_job(my_func, run_date=run_time, job_id="christmas_task") + """ + trigger = DateTrigger(run_date=run_date) + job = self.scheduler.add_job( + func, + trigger=trigger, + id=job_id, + args=args or [], + kwargs=kwargs or {}, + replace_existing=replace_existing, + ) + self.logger.info(f"添加一次性任务: {job.id}") + return job + + async def remove_job(self, job_id: str) -> bool: + """ + 删除任务 + + 从调度器中移除指定任务，任务将不再执行。 + + Args: + job_id (str): 要删除的任务的唯一标识符 + + Returns: + bool: 删除是否成功，成功返回 True，失败返回 False + + Note: + - 如果任务不存在或删除过程中发生异常，返回 False + - 会记录删除操作的日志 + """ + try: + self.scheduler.remove_job(job_id) + self.logger.info(f"删除任务: {job_id}") + return True + except Exception as e: + self.logger.error(f"删除任务失败 {job_id}: {e}") + return False + + async def pause_job(self, job_id: str) -> bool: + """ + 暂停任务 + + 暂停指定任务的执行，任务保留在调度器中但不会触发。 + + Args: + job_id (str): 要暂停的任务的唯一标识符 + + Returns: + bool: 暂停是否成功，成功返回 True，失败返回 False + + Note: + - 暂停的任务可以通过 resume_job 恢复 + - 如果任务不存在或暂停过程中发生异常，返回 False + """ + try: + self.scheduler.pause_job(job_id) + self.logger.info(f"暂停任务: {job_id}") + return True + except Exception as e: + self.logger.error(f"暂停任务失败 {job_id}: {e}") + return False + + async def resume_job(self, job_id: str) -> bool: + """ + 恢复任务 + + 恢复之前被暂停的任务，使其继续按照原定计划执行。 + + Args: + job_id (str): 要恢复的任务的唯一标识符 + + Returns: + bool: 恢复是否成功，成功返回 True，失败返回 False + + Note: + - 只能恢复已被暂停的任务 + - 如果任务不存在或恢复过程中发生异常，返回 False + """ + try: + self.scheduler.resume_job(job_id) + self.logger.info(f"恢复任务: {job_id}") + return True + except Exception as e: + self.logger.error(f"恢复任务失败 {job_id}: {e}") + return False + + async def get_job(self, job_id: str) -> Optional[Dict]: + """ + 获取单个任务信息 + + 查询指定任务的详细信息，包括下次执行时间、触发器等。 + + Args: + job_id (str): 要查询的任务的唯一标识符 + + Returns: + dict or None: 任务信息字典，如果任务不存在则返回 None。 + 字典包含以下字段： + - id (str): 任务 ID + - name (str): 任务名称 + - next_run_time (str or None): 下次执行时间的 ISO 格式字符串 + - trigger (str): 触发器描述 + - pending (bool): 任务是否处于待处理状态 + - args (list): 任务函数的位置参数 + - kwargs (dict): 任务函数的关键字参数 + """ + job = self.scheduler.get_job(job_id) + if job: + return self._job_to_dict(job) + return None + + async def get_jobs(self) -> List[Dict]: + """ + 获取所有任务信息 + + 查询调度器中所有任务的详细信息列表。 + + Returns: + list[dict]: 任务信息字典列表，每个字典的结构与 get_job 返回的相同。 + 如果没有任务，返回空列表。 + """ + jobs = self.scheduler.get_jobs() + return [self._job_to_dict(job) for job in jobs] + + async def reschedule_job( + self, job_id: str, trigger_type: str, **trigger_args + ) -> Optional[Job]: + """ + 重新调度任务（修改触发时间） + + 修改现有任务的触发器配置，改变任务的执行时间规则。 + + Args: + job_id (str): 要重新调度的任务的唯一标识符 + trigger_type (str): 触发器类型，可选值： + - "interval": 间隔触发器 + - "cron": Cron 表达式触发器 + - "date": 一次性触发器 + **trigger_args: 触发器参数，根据 trigger_type 不同而不同： + - interval: seconds, minutes, hours, days + - cron: year, month, day, week, day_of_week, hour, minute, second + - date: run_date + + Returns: + Job or None: 重新调度后的任务对象，如果任务不存在或重新调度失败则返回 None + + Raises: + ValueError: 当传入不支持的 trigger_type 时抛出 + + Example: + >>> # 将任务改为每 10 分钟执行一次 + >>> await service.reschedule_job("task_id", "interval", minutes=10) + """ + try: + job = self.scheduler.get_job(job_id) + if not job: + return None + + if trigger_type == "interval": + trigger = IntervalTrigger(**trigger_args) + elif trigger_type == "cron": + trigger = CronTrigger(**trigger_args) + elif trigger_type == "date": + trigger = DateTrigger(**trigger_args) + else: + raise ValueError(f"不支持的 trigger 类型: {trigger_type}") + + job.reschedule(trigger=trigger) + self.logger.info(f"重新调度任务: {job_id}") + return job + except Exception as e: + self.logger.error(f"重新调度任务失败 {job_id}: {e}") + return None + + def _job_to_dict(self, job: Job) -> Dict: + """ + 将 Job 对象转换为字典 + + 内部辅助方法，将 APScheduler 的 Job 对象序列化为字典格式， + 便于 API 返回和数据传输。 + + Args: + job (Job): APScheduler 的 Job 对象 + + Returns: + dict: 包含任务信息的字典，字段包括： + - id (str): 任务 ID + - name (str): 任务名称 + - next_run_time (str or None): 下次执行时间的 ISO 8601 格式字符串 + - trigger (str): 触发器的字符串描述 + - pending (bool): 任务是否处于待处理状态 + - args (list): 任务函数的位置参数列表 + - kwargs (dict): 任务函数的关键字参数字典 + """ + return { + "id": job.id, + "name": job.name, + "next_run_time": ( + job.next_run_time.isoformat() if job.next_run_time else None + ), + "trigger": str(job.trigger), + "pending": job.pending, + "args": job.args, + "kwargs": job.kwargs, + } + + +_task_service: Optional[TaskService] = None + + +def get_task_service_instance(config=None, logger=None, async_session_maker=None): + """ + 获取任务调度服务单例实例 + + 使用全局变量实现单例模式，确保整个应用中只有一个 TaskService 实例。 + 首次调用时创建实例，后续调用直接返回已创建的实例。 + + Args: + config (dict, optional): 配置字典，仅在首次创建实例时需要 + logger (logging.Logger, optional): 日志记录器，仅在首次创建实例时需要 + async_session_maker (callable, optional): 异步会话工厂函数，仅在首次创建实例时需要 + + Returns: + TaskService: 任务调度服务单例实例 + + Raises: + ValueError: 如果首次调用时未提供 config 或 logger 参数 + + Note: + - 这是一个单例模式实现，确保全局只有一个调度器实例 + - 首次调用必须提供 config 和 logger 参数 + - 后续调用可以不提供参数，直接返回已创建的实例 + """ + global _task_service + if _task_service is None: + if config is None or logger is None: + raise ValueError("请传入 config 和 logger") + _task_service = TaskService(config, logger, async_session_maker) + return _task_service + + +async def get_task_service(request: Request) -> AsyncGenerator: + """ + FastAPI 依赖注入函数，获取任务调度服务实例 + + 用于 FastAPI 路由函数的依赖注入，从应用状态中获取已初始化的任务调度服务。 + + Args: + request (Request): FastAPI 请求对象，从中获取应用实例 + + Returns: + TaskService: 从 request.app.state.task_service 获取的任务调度服务实例 + + Note: + - 此函数应在应用启动时通过 startup 事件初始化 task_service + - 适用于 FastAPI 的 Depends 依赖注入机制 + """ + return request.app.state.task_service diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/.gitignore b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/.gitignore new file mode 100644 index 0000000..cd68f14 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/.gitignore @@ -0,0 +1,39 @@ +# Logs +logs +*.log +npm-debug.log* +yarn-debug.log* +yarn-error.log* +pnpm-debug.log* +lerna-debug.log* + +node_modules +.DS_Store +dist +dist-ssr +coverage +*.local + +# Editor directories and files +.vscode/* +!.vscode/extensions.json +.idea +*.suo +*.ntvs* +*.njsproj +*.sln +*.sw? + +*.tsbuildinfo + +.eslintcache + +# Cypress +/cypress/videos/ +/cypress/screenshots/ + +# Vitest +__screenshots__/ + +# Vite +*.timestamp-*-*.mjs diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/.prettierrc.json b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/.prettierrc.json new file mode 100644 index 0000000..29a2402 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/.prettierrc.json @@ -0,0 +1,6 @@ +{ + "$schema": "https://json.schemastore.org/prettierrc", + "semi": false, + "singleQuote": true, + "printWidth": 100 +} diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/env.d.ts b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/env.d.ts new file mode 100644 index 0000000..11f02fe --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/env.d.ts @@ -0,0 +1 @@ +/// diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/index.html b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/index.html new file mode 100644 index 0000000..9e5fc8f --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/index.html @@ -0,0 +1,13 @@ + + + + + + + Vite App + + +
+ + + diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/package.json b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/package.json new file mode 100644 index 0000000..fa19196 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/package.json @@ -0,0 +1,38 @@ +{ + "name": "{{ cookiecutter.project_name }}-web", + "version": "0.0.0", + "private": true, + "type": "module", + "scripts": { + "dev": "vite", + "build": "run-p type-check \"build-only {@}\" --", + "preview": "vite preview", + "build-only": "vite build", + "type-check": "vue-tsc --build", + "format": "prettier --write --experimental-cli src/", + "openapi": "npx @hey-api/openapi-ts --input http://127.0.0.1:8000/openapi.json --output ./src/api/generated/" + }, + "dependencies": { + "@element-plus/icons-vue": "^2.3.2", + "element-plus": "^2.13.7", + "pinia": "^3.0.4", + "vue": "^3.5.31", + "vue-router": "^5.0.4" + }, + "devDependencies": { + "@hey-api/openapi-ts": "^0.96.1", + "@tsconfig/node24": "^24.0.4", + "@types/node": "^24.12.0", + "@vitejs/plugin-vue": "^6.0.5", + "@vue/tsconfig": "^0.9.1", + "npm-run-all2": "^8.0.4", + "prettier": "3.8.1", + "typescript": "~6.0.0", + "vite": "^8.0.3", + "vite-plugin-vue-devtools": "^8.1.1", + "vue-tsc": "^3.2.6" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + } +} \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/public/favicon.ico b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/public/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..79a6135f42447e47839d3a4486c3943402f11f32 GIT binary patch literal 16958 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 W^BoSD{@&l||GxnK|MCBO4E%4m@I5F1 literal 0 HcmV?d00001 diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/App.vue b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/App.vue new file mode 100644 index 0000000..5e07a41 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/App.vue @@ -0,0 +1,16 @@ + + + + + + \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/assets/chongming64x64.png b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/assets/chongming64x64.png new file mode 100644 index 0000000000000000000000000000000000000000..827ca419961c68ccd4fad4d5982ec171ff8769af GIT binary patch literal 9813 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

aZyt77m6;MT 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

    yjoO&vldh z?Rn6dsA-lM#}^OkYZBJXWMY}V8>A(HP_i05YF?wJH4mJ)EX^AM^=`n zpKv(GUvdR^EIS6#YBaHVXgz0g`V}CvVod8->Wk3nPoD@SbFkzQ5 z4_Uv8SDt?g5C5l6@sD5n9;#I)NOoHXBolfahL;?3Y~a-ys%);wbvQR>^*EFgc3vQ? znQW7>D?$}&Z}bantu;-oJEoa6ellTA>XD3bGEUDbDG)p0moK@3a%nRcKIRa_Ei`B$ z_^6a|%P;NUKRp(_Yki1xulENt&++HRnhmbj1>i5Q_*4Rh_O3a}8F+NpHeNRAiVH5_S~JvU-oIP zxbYU8u{|i+c0cM(8RJWRtf|*<+GSjGc_`+AZ=28C&$hv2=;3gdjamgp*GJ%va*oOB zp{Xc`ao+u~PF?UD8Yw0I{KY6yS_I$*H-^QQG@mkm!ByiR-a6!bv-?<>D8e%xk}LBS-!HWmH;)HDzZABtB&FtONF? z5%!ZTjj_cPo|&Q%g#AUS{CSrj$}ut_T71I$Rhk;BubMjC!iwA0OYO^V2qoJ5s9L7A z37(Kb3o_v=YS-=lh@>^<1n4Qk+3-VA?9=C0_d`G56Z%ljVv5BW)h%BGRa` zH1$ADCi$@bTyvo}LAmvI>hdXiR@rZQO$=KNg-&YA(UjrXqD-Pa8HwJ%=B z+rRMxO6_-Z)X3g$YDNTpbDp}RD!K&KF6LB*3{X!y@Brp+eb%K&SL-NK@}h1_Mn3L` z!o-|=3ufg|UrE$MUa@LNaSHQ~;lb0P>zNYha^f!Qc*Bzq=g#3O_Wj!ruv|4u<8=04 zeZKJnHmnclg=v|NI$xT8EL_29d+&|ao;BSvFpH87{kDZBACt+I!rWce(&RJ%0^?bi z@B0$N%}dLi`R>aYFK*)lFMT%ZOoIGOx8>^ z(yo%!GnF*@UWktVaF1nIqBO8Ijjmc1Kl;o z6Xx{UM;w{~Oz2GSn-)SYBqm8JJk7x_rUVg8;ey${J2?xGw3|snhqW5y)QLLDy)D+r z4hR2?+uA>bB)6mg+npd%))t%C z|H%V;(!8hMLEs~da_d(NyDkv%RX%kE=>Pr}ibKV8;SFUs<9A(_!nV-j;^TUJ?&0UY z>1vwXWsbq+61f!qV~Q4|mMk$#w^^*w!N}Mf48AGhMJ>I#7+m(+z9Bj<1SC!pO=Jq< z>vna4YdpN5W2K8@b5&=L%I|A$ET5=F8q#k2_dHA8G@3Vk;+}CEX)>IMs%|s(5N6-I z@f%hHRjgXh-)C2bb{Sc<$m#F@1mloFFItZJHezh08b)F{W#ekj|M2Jd)SdUnyj#hi zXVoR&cs*N9!7Mi?xvY<3EJHgEr%_iwe6VpN%Tmk%o5B<%aqQb9heaPKCs;=S4TBsH&6|&bAnC3e}AMX9?8~)obcjd>#i0Nk&wK z>&6u?y7W^Vy?TL+$4rhlT9dLqDt@h<`QiU&NlI4PidP)*NK{Qg^sg)jKup-;RIyl` zbO$xJu`^CrhG6ePyr(fq$Q~B}pA(=p6_y;y>ZSyZe99T$9D`@vUMO}UVnoBoQkRsS z%&D>>Ej=L7(INt3=Ck4DVgnRy8tA_I)d2j%g5X@Y8MyM%bQdmGmWhkU#oj6pR?ueBjdLJqf zS}xnQ{p!Zdf6%O?O{4M8>RoMjMpr-DmY<;r-}(J#;IRD3C$D2!Cf9d^UcgI_KFS~7 znx_bEJv-BsM1&J|+rtA^v;8wo11?-#=e5}|x`mtw*AERBUi4}H{u!su1YtF4;|1sv z_`<#Sajz>FqrB?ThofPi=KB?xTh%s514I{_6Ni&-cgDP{Ay2H;byqu&Lf3o)KB>d^CLOF0>`9W;X4#w~|@R zgq-11;tQve-1riJp)6ltxx{Hek9O(9-teu?_s0p18Sz|W;pPiZ!s6B7Kb*E{EE)n4 zy5If8-F9YZ{jjfh18&DlqkZSw#Mk0S{nTC8VM@aVmwlS0qQF_x&@4Tow&^dA{TVx` zGCzz9^eeEu^vENV^`(@>3BP>8qc9QZ*)hfm5K`)=KkHJyIVWr> z;koblFN#$Khc60MQP(i9)Mr05QOk2N4N9H)(E%f=_}$N516r_J4L^6#{#0Sl8Z9td z1YxuYQ8N94Up!J3H!W%_(XffXnRkk#|9rkOt9{STw{E0wf^YTt)|FbQi613w#Js?U zkJ$1R=4>$Q&*lrBJ^5#;y4mZ$i=ju5ToV-ZO{bYlyR_~0-;BKYbtI5ij%PTzAKMjcLs=Uwy>4>X#y`F@uSt>H-r>`Wn!7k=z>P%2}i z^GWLxgrNYEt9_e>{RU8~?Pi?DyMol1WYJ2ODJgp5%}+aHf@!ulO3c|lb8gk3JsQ${ za(Z*+O~mNNxuVz+HLV`@Y6EHgBsB)RsSdQfpEQ z48L^r!R#^I%HMqEdYsr^Q>+4uK%teVZk{NryK{&djvOvxJLW3_HRq+>sC2yQ>({aD z4CfxYFXBp!D^i8DiT;Llo}Q~p=^S6*QZYs-oMC_Q^#*DhfyWm0gggbNRyrtC_GM)= z1Gf7VP&3CeHy%Tq>vC3`h0z%Hcp^Im$siD+ZQ+Ok@!>eTFYUHqVat1&@@tEJZd)^-;3hk?y*t$=(W)wyl8E`NM} z08BCdda1Dy@)b4b@EjzBfi?Zmd1kd(x^?Z8P_DdRo-%b7{N}Y?!duS>!s7ActbOP% zq+m_&41FCsVUG=K`TBiJ3~UQvgQ77a0l{dAaV46nn3$xUI4pm1`eP{7VgznmT#qd+ z6;18GpTSAW-1Umb98V?6bq{Rf_NW0lubJluW#2}3F@`r>IuM}{IB+nm^R6eeYEfHz zT-exBWWYQxxi3^>)`sI-;v5^Lj2~$hs}Z9iM%?*-JJx|ntwE$s8&v!W+|HEd*K_On znU8hW`kS}Sd(T6XR3vDYt3ZEpXusDxCMJZ$kLk5AH&x z;P;O`+@s}l^Zpc_FySwZ@;e{70^=;E8uQX44#c|J5$UADGM;2|nd!ZdI(f}Nl&vCs z=YdTO&1C3p*Y6swcpa13UZ1Ku>DrtF_1=ybcj6dC%VB5qiUC)ED-bOcBhQ6#ZEZH^ z0&{nvP6yF76E*Ij9k(|s_2m+<5t1?9S@3pHb5+PNn zncK6Uh}G~LOuHlZcl2Hqi8Wo?i{WcE*kNS?g#^ZknmWtaRD`u>`r=?G(>iQ2?IKSw zF)htvU!smahBl9eR3~Av>|ZFqbIDcwz*fE2=YwlLKUh$lVK0dwK0|@_ja9HEJB=lwdFNSP4!%zjV;({X&O~=$q&WZTWd!*ok|N1Pa zuV0)?pzMZW#tXu8lPl7mn&H%@#S}1nOuUlgFMKjD{jaZcr-Fu5hK=~rkRYcr?dJthhWHJ%Q&E8^BZ0sF+*j}k4XS2H z2~F44By`nq)`17027b6@D{2OTfj7rLi;>5E#%mt6^F~T_9`Ye|ENTNq8fj)tDxf#0 zEPr;&V!PsL2bP#PIYFUCA4sema#gNB}E$jV02$ z=|d0Cf{=8l$2Brz4Yd<%lr_S)J&6?DIx1!ZN_W47`wCJNlG-}g${MyKKw32KeM#s$+zX5{@EW2)0%2r zjL|2bCo(ZLa6~enNPBfP2bVotF&0+Mxt^viys598IzH|FH)rY=IB?+D?C$5>|Gt`~ zV%+I(t>ZJBMGNwu58G*hLX?5R5AMDjs}@TXeE)vx1BAt&XC9DK zq6Fq`vtsO5+U9+ZagKL9^9d|&-^$i?>p1#N@58k;q%Oe;h20G7UK&K*)c0)=D4lH{ zX;I(Pwu}{=VJX;kzmQaiWJZ zh#ER1UwG{6gI%jTzE?c5e!|o)GKm9g5-{cKkDB_*ayYcFn>??Xczd7UeCkW*LymWW z(I!mgxpANed^PDuH|aK=9MSBtw6!s9e#qd`qQZjPPLz{HWa@&B*Ywk5Qo7Y7VEC{K zZ$j6A$?j+3ZAL7B5yvk*<{0jB%RJ@7pM#Lh!byc|n2;ugxcnV^uU(H*LDaEq4TTPp zb!66Zv>IY{jn9`pFp4P+Z~W5NaH42y&COioTKn96{w>Sv&U^wI(ag4IEe2DV7s`bH zdfu}eeUI6&+H=E zu@|IbOr2{2z%uUip%>1Cze5GQ`YYdHn=N?s&TCM0h_g-XQOFdR{IKCsMZnxU@nUy8 z(@eks(?hYgtYj&uKi#*ylGYFU%FUzkyMAd$Lz0uc zj|q6;rsPzYjSBu^lz=uoXa9pxS7V-IX~Gx+wj*tVArsB~QTn#L=iA@IFkORf zgCv%n@bo=)W4Ri06D1$L{cgH!lznEm*mhf3q;!EnIp;&Hw3ykChAB{e4x596YuZ+-!PB&(Ix_)y5_lW9MjtFrQuf(-yNagEkC@MTSwId zuy9&``o8yqt?=h3K5BBGJ1;Z~Fi_=Ld+zO(jvh1cEVOrIPvb(kamlZXmman+rWM;g z?HPGeDLDs0h$Pv3SwT2=hfX^#Qwb=d~h#%EZ3S!M6uF?`?$ zcQDkL3U^w+A40c{2roPNM2rtFdT5^6q)v@;>xr4K$5iLm$4K3smM$7Drd@(rx(Y=B zG6iqYx!$5sGqHX`HcZv*M2V6_%<>jeK5Cq?)M@C>iM- zAG+X~3>0up9YNGJOt_6=fDPbD)20!ZQz2gdHl|Bx3X4f<<{Xz-gduxOLbD)CN-`2m zk|yO;2+w_p&bq#XIA-&!eZ`*Oc_#0>M-`i#Hz&4Z{sD{R2d#q~I8x#-$65v*6J;K~B0-WBwc zBM$O)8dQ?cIkxCJi27RY*0)lD4tVCVM*Uvo!I^r7EF_P9cYQ+M6f zyRA@Wg&Pz0GYx*)Wfl)SC1SrIbH6sV^}M$U+3u+8l&dr>m10R@W+n)X`TA&#Q=`?o zt#tbLIC0I~D=s8LbK>)ESl7XG1rtlW3C(9WHp2ajpVY{^*IPQiU=B^z=gmu(GRf zYpW4YKX79ZILLft&BLxwJDN0C`lR7xN~MnWxRlme}r-pFe*buOAvNy!4CQVe7p4 zE6V_=42^Qx(@$kAC3gW6)KJ`s?=s-|2!)r|G`e2JeP4flDRXG>+mHe~ zjo2#?(|m{XfaO}(M6+2I+b0@gsiz^)+i`iFpOv*>WNN-6YE3OH)x<%mf;wScHKNQ> z(^-pY6H~708r>lWy{CY%``R^pzbe>Nb_-W&1BEz6Zx;2n zzE6Mnft~@Ya>b8+ib{o*89t(P2sv)Pe=|6XI^ne4cJZ0>dSb^@xLWJ`SVwxG1ODQO zBiMEADn_O|msB4ENG9zptDM7|q>U^1`9t>cFSgp8BkK=CLHLg|PE4rd$#=KcRuodZ z*QvL@m=@!%5gij@g_&L}iLocp2=!qxnRp@z8EB(gm55Bu824aXyOupf?MhPLhiZ8D zxsTlovt;2%E!HJFnh^kENb+6n*fv{QUITGZqS z35TrXn6+zz^429Jbe}oNr=9^c1z1oRRKnk%esowp8Y)LNE22qI$s_+UndQ=iJPO0{ zh>fLTCaCrWg@3@ntQN_qstTl>rFwn{URX8XoWGrQwf-l{+ ziDUNO6E)-3dab(<&$=j76!>a$OV;m(zVoiVrsDTriP2DCXPLNn1JIyn5oBlJgr_y| zuZFoiOJN<*>`BPVL9F6w95r;ABV~EIH712|O{U(|%q19(Yj?{uIyJB~u4t9}wv(Ju z)c6I}en8`elLPJ?P*P`R`HWWfw|+}NZ7FD@5H*?bJ527=!sLP`f^)p~jMHXA+H-6qv8iM(qLt57iI-_AIZ<#E4Xa2C)he`gG1yK{Lw$poS`#wx3q z$2@!gy`~)6UE_~QeFE@==tjvY-837<^gMlluG_|fqjr77gECf@?+Rt?8+RX_ceM4n zak^U&lSNr9;OMnOj(Y2-*gi!do2IoH5&rvmPo@;%->$kgFoOBDyiTh?0MI@4puJhB zVuG2NC)=anf4ICn*L%8h62w+0ln97pU$d1H*R9H|I8AV*4_yj4pq?ae0NWfq_u#!K zN>C|qB1lgP&@LC;#ozuu+ufMTI*!?E_X#09qOu+ zSACtr^jj^v1gM503H-y^XG}dO^Y<}>p8hPb30Npp2-W01ngh2{*AJN^|B5ojsvPGm z2pv&?n8*<4-{omGCB3f?CHF;7L}#ZTO@&x9Uwbl#)814yu|2)>1u)HoGG*hdW1<#2 zxk)7ZQ}9D1sjUTANTyhN7G{v>ohk!0Jo|usP=X&j^s%m3)H9jlC1@)iz;#Du@ugc^ z6QMDK(InlS!XNkYZoGdfX!70RF3q_ySP@3! z5*<4}^1|oTn!VK5O*^PvE7V5t%jWMAzF$Sabi`0Lynyuf zr#zN{Xyah>CxD~dZB)}ah6tG{zPv_tz?OgzvkY2m`G>2%gY&w5!jAa2&1bQQ*GA3x zL7O+Tcl2i4f;!3~7T*y6ok1uO-f`}kROOg`|LsziU57R|?*bZ{y8c9aaG? zLM6J%^;YLD?aJR$)ZfmMqLVZg)_5!^kOr?7A`HJScSipFX?~Vz3v?E(eE*6@jp8OP zyy;m|U+3_n=Sy!5z-vlh!B7a%(OF{!1uC16z_5l~<~2xdo_QD*ME zcH4HWk&eCR5T~rIw)3pLb|*N1vO_z+*mO$2JKnvf^+bWc`N|JC=cxTDTMM->w!Qsb ze*Ht`Lr-Q-btLCR&+{j>;QIGfICL~-sWANf<)2A^o5zA6B9!77i16}b_NN*Q!%@5g z?zK+;xANiVpBrR0mr}us6@EAZYs$t%=ipo)UOU5@80L3q0cU+dAvLXM5f18keF>Io z*Xd7k-i z*OFV8$0=fPmR8>GkH={kjuuOu@@oawC{ZvKU1;Y{_eyT5ZTxLgnDcYl&2RdZQB9bv z-oK|70eby(>S~6dZMLNpj~!|Hx>NX3!%rSH_pG8?BA|FQeW%}}JC?R4Sb+MwoB@x4 zrk$vP1PsMk5|K0iV=J=+5lIpKCq%Pnn`Xfj@}JLs8VlajlKkQ^hBKl=O~(cX&x{r2 zC!-O|vcyPgZD&?Sxk#Js&ao_tbrn@nP)*sGH9Z}ouuUB<y=f=4YMp92YPZSkaXt#Y5Q7!N@BQ}`K4DPI zORIpj@#TE_f~OKIK#8m%Y5;`2=LbK;N*Aj&**Vx0 zc4MCb)Cg+4MN9>+@duFBgwMLQrcBQnpp+m5`z$PQ(#~u7?(O$cL}0c^BRNa{4*xw2 zjR_tG$M^5L+m~C7ugc81wQ^SP$MK+KNi5F5JtNoYx{j902DQ|W#|mt!Dz3WaZd?di zZSau}kf&c^;S3F+*+Sr5=ReEG0U(?=wiw@bnjYGxp$)DbinsIj}o~aLV+_rTq zPJIk`9s=GKy3^3C6zsK}?hb7{XGybS zxgU&n8583=b!;vScZ@Y5$s0y2r|gO4*mbLWmT24jRkv6sb@GnBq!?j!by~O#@4W72 zM&pV#_^_EBN$Ao{Dl<9fJL*rj;#gG2%Rl)Yuer8_?K--mX(DXSvGT$r_eby*&YtuB zk7HI)V7><_M5)$dm!dU{m)ITfpH6Xl<;`3{RrGV`v!ca6cK?6rEp9?M&p3Z(9s`}XJ} z2Bv<-oQc#Vgh_`}M<#Nln4W&+#ebsDJ!_G##ZNK{q$YUOEW^XyPPh=+iWDd!?r}4nsm>=UTQ0 z`_*9~ef^1*2t_I|m-}a)X4G3duDkvwDg^7? zgg}-%TQuzZJOPXtWvvlZE7TZ1cmFojqtd2WBzvBdYZX=B9j&hyVgoCnP& z^n^OLmnAojTy_r5Ps{wg%yCR@t5S`-X*Sm(80UUl463))}oL2tziSChw zP)F1F1o}M#+KPab^)=4b;gj{^sIAeBwczn>QJ9&;wV2dbj|toXzx9M^SL)c#6&)%u z#wiZOy3RrUESf)P{G@0qF4NTBMPY3<=DCkNs9`=eJ%{WxdTlYnz1tiML&HLLSk6T+ zb$tHjpCWkE*T7C50G+>!poQUzAOC~_LZ!;l8`exn(+yh>bvnz90t@j#ZfWSb4_eIB z^*@zv@mZc}H_cbgYq|x^N(^7Q>)znQR4;g>!%8`z7_*mnP-2@o#x2*UiBC+!lysHT z_mE>rVT)a45GsFl>BWDo`p~Ie z?Fco(xDc*eTAm0AoyFV*<*Z{51$CGm1pM{k4i*&FjxE?$>0wd+@ME7LCVZ*ynP0(4 zKhw1PthDzN;|<2d(h0wK?9o&2%kMpQ*Y)UNfHSapxCWK7kswAp?m@hvcQ{r`_2TL0 zZr_Z>QAIeU_z+a1Md#q6n`$6Fn&-<~mnMAtvx!iH_tbyVPM>Z4s(3ogFZ{ z(r5Ur#2TEGPi1N@_s)CB1e9h$nC@m8d#3^3PFFN0qT6iHyCM_1TZr{q)wT|*ER1&& zgpgi5DXmPrOA}I1X60CIJx{aR)qWA@X2Z<<5^fWPfwdG?`0%+;2?>Z=elR8xuFW~C z4}uEeAHVZm?6|@izfpXwB~$YsD?T5yh;Z}PWd=?tP>Re1(^m)~BHRlp7?rDVl$^cS z#)g@;i4Dx8>)gK9g*M4sN_qhG`;PM~d z>Yt-^&4Sz-Qv>G6)`Qoi5ctK%90~ZUXs^EN>WTe7O$%1_@yBQEu@i+94b*wNIp-#d zxy))M%7-p^Y5+_6tXmRtKYVw~m?erv$ZM@k_51xJQd-r|b*%2@d4t2!ZLZD*fUfyS z*Chh_V?QY&^;Hv3QB|xJe)+gZcx;oDRN@tvcpO0~|qGD4G zuj9w_5Y%=!s?f!7qYW+bsvVM%JHT{Fi%*j>rOddYuhM6(h0hv`X@K z#_iAK>{$r`A5Vc92TqqCvQ6vBbv$`bl(-`(Lo;7_Drj$sxo~j~rDBX@A1o*Cw9$iG zrW~@bUgA zJCnPjs|K}mZss!^&kcQe^Z|Q8IpBMnwg-RVq&D3djUu%h<~c_^l3_S(zH-a`4U*0p zt2gZn8-~M)_qO|80pGcQYfDR>F<#?1b>~$KU4>)`KSTu;$6LR11EPb}mkH)Nr9X|a ziQ%r%$WuY5@A0;>;9T4EFO6}fnB~w4h8P`8%+==#*eEo&zQ#E{tIc?|j35pm#dh12&@-bYMPQO1&|-07DJl5o@`wdl z#k-$&3X4{8W|EQAhkpRXIR9zWQ8P51N*z{NXT7SEWw>~fNmFR~_B~4simH)+tu|@a zhgcLcqK4#DDO|0+x zwXM6?Po6Z%d&IBfTX)~bD5ea{GriHyYTd21=7Q3)lq`)j0l2#S=%rZ!Hb1+6!9X!A z_@gVn*c_XHb&f(zvQR`{rG#-r+`#(b5GM{Ju*uFYD$;HSLCh@Bpi%+{tXs_)|MGFH z^_dJE<9fYzytiK?2DHeEObLJY z#K(h$!SaCDe)<}3jmi?YG(sygAhNd(Dtng7E(@?ACBO06uc0y-Ezph{i1*h5Y}CXH zj22w+{AWYuD~z@GsE{$^xW~lQKpay9|9D`U$=#ay&VgAPdPpna$0IGcn1Tm!&0Hq6 zg`sggwFi}HHa%f>q9g@*s=nn7(XPA~I{fcXI)T-Z zf3_Zy<}W*#oGK%0_}edjkD=7eDKglVg1Q>(5QozNAdJW3c??Ufao6t_4Bx%?0mjtg z^n>YJ+d?x2>|l{^+_{WtxwcFz`&dL;E*+oY+)_i%`m@vs$1*fL&xehf-S~;?52A{DCVT)C+5l!eDNA@ zS{Fvn@Qx=wnlWR(a5uPEKVpj2L)GBik^~ujBBk zQVh5!ZWZq9sFDNtIK*fkk0`;QDt5q{oN;LI5j8*vQna+Bh}iWK`@mWL>CDH492Ct= zXR%p)40>ZR8cpD?7{~wi8-D_>z{!v|Kjk#cxbSGxsU|r8{1M81GGuHPuxfbK87KS7 zSJKRnY$enz78eRN6bJ*XTFjOqe}BT^!BiVe=RpJSGP6gsrDv|q>(c$1AG%IjS_?*z zvAYlxt}ZeoxarP&_@7(urf}L?^l?7?p%FE6KmBzf7l&uW-`~8IQDLyg1Ub_mUZqvm zjvde4dk-ik_1!4VMg+O4j~rNbV-A1AyZF;n51Z*;$xUvC9Km02P>CpZ5rl$eS7D8E z|I&5}ZCbrn!iW{+s@v~pgyW9o*@YZd(o~fPMv5C0Y#l7(Ox?HK>7-%2lD=;VwS~w2 z78o3(hT!^OLKX9ViUslecG8autW%Ow~fpN9K#pj*Dt^?tpzy58ERwyP}^5VN(BQ#Cf?i{Z<>5(V{mdyh9 z$dD@JR_$|@6>9tkVPKRa7KD8l3yQ&rvp@V94+quB`)aI0Pwj+&@^;4Zj&slU=SNE1 z5Zw|n3MmaCCEIE~E8Y`@`i!ymD4ldYB4Wo<7p3uOlxCH_Pi8)!h!D!H20dqzX6F(H z16Ar?w{5wW_Plo6GuXx?X<)dG2X)@$H$r5%xgd}W8n!8g24*g}z~H06KrIiXN5%I# z2${*6U5EfLFXas?<*OH-@6)FyvefsubeMIFN9$`vh3&v=Km9cp1_NIE*rQnJ5h7!k zV|ttTl!B7Ky!vWJz@j+L-gUh<6=fEaS{JS@235$u_NSly2Je0Pqfmq;8BblSjc4{8 zybi_Yg$AODK566{%uyO-In7dc`hV}-w22R0`#mC>HiD~Wx-OzQO??T13qN=nZA^!M zf64Vf|13->!`KJ9$wL*F9USnFALQEKdLcr;3rDkY_RnNXz)5uSc#RP;YaC|zvp=e=4q~j35meqmKJ~I^upP(2|NLKG#G2;DQqLe?bK1#>R+-6C8HnP{YVNeIXPn*k6>ZJu z7k_*+qssZT&slM%_7RY?uV!Kr&&;P~m7B~95kCf}2CGWt9Hp@=sPL&5p2g?CdkZ!) zQHt=l|cb?xt~< z_O1+_P!__!J>fA(Znpk13q%W**<%c)`x7=ktRkI03LsT>TxWJ zhe-^zMnrd~#+1%A9M`DRSc|)ko6YZcs@M$7qtt#s7v@V8wpYvCvU$5N+EAzTYtW-h z>k*(Zh9M<)EjhLgR?$SsE2wb%+C_E>8hbmF)#T6K4sygBFXhC&Hn6^p7isk=TY584 z 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 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/main.ts b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/main.ts new file mode 100644 index 0000000..a628d07 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/main.ts @@ -0,0 +1,31 @@ +// import './assets/main.css' +import 'element-plus/dist/index.css' + +import { createApp } from 'vue' +import { createPinia } from 'pinia' +import ElementPlus from 'element-plus' +import zhCn from 'element-plus/es/locale/lang/zh-cn' + +import App from './App.vue' +import router from './router' +import { useAuthStore } from './stores/auth' + + +/** + * 打包时取消该注释 + */ +// import { client } from "./api/generated/client.gen" +// client.setConfig({ +// baseUrl: "/" +// }) + +const app = createApp(App) + +app.use(createPinia()) +app.use(router) +app.use(ElementPlus, { locale: zhCn }) + +const authStore = useAuthStore() +authStore.initAuth() + +app.mount('#app') diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/router/index.ts b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/router/index.ts new file mode 100644 index 0000000..63a3c92 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/router/index.ts @@ -0,0 +1,44 @@ +// src/router/index.ts +import { createRouter, createWebHistory } from 'vue-router' +import { useAuthStore } from '@/stores/auth' + +const router = createRouter({ + history: createWebHistory(import.meta.env.BASE_URL), + routes: [ + { path: '/', redirect: '/todos' }, + { + path: '/login', + name: 'login', + component: () => import('@/views/LoginView.vue'), + meta: { requiresGuest: true }, + }, + { + path: '/register', + name: 'register', + component: () => import('@/views/RegisterView.vue'), + meta: { requiresGuest: true }, + }, + { + path: '/todos', + name: 'todos', + component: () => import('@/views/TodoView.vue'), + meta: { requiresAuth: true }, + }, + ], +}) + +// 路由守卫 +router.beforeEach((to, from, next) => { + const authStore = useAuthStore() + const isAuthenticated = !!authStore.accessToken + + if (to.meta.requiresAuth && !isAuthenticated) { + next('/login') + } else if (to.meta.requiresGuest && isAuthenticated) { + next('/todos') + } else { + next() + } +}) + +export default router \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/stores/auth.ts b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/stores/auth.ts new file mode 100644 index 0000000..9ac5acf --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/stores/auth.ts @@ -0,0 +1,77 @@ +import { defineStore } from "pinia" +import { ElMessage } from 'element-plus' +import { client } from "@/api/generated/client.gen" +import { loginApiV1AuthLoginPost, registerApiV1AuthRegisterPost } from "@/api/generated" + + +interface AuthState { + accessToken: string | null + refreshToken: string | null +} + +export const useAuthStore = defineStore("auth", { + state: (): AuthState => ({ + accessToken: localStorage.getItem("access_token"), + refreshToken: localStorage.getItem("refresh_token"), + }), + actions: { + setTokens(access: string, refresh: string) { + this.accessToken = access + this.refreshToken = refresh + localStorage.setItem("access_token", access) + localStorage.setItem("refresh_token", refresh) + client.setConfig({ + auth: () => this.accessToken || '' + }) + }, + clearTokens() { + this.accessToken = null + this.refreshToken = null + localStorage.removeItem("access_token") + localStorage.removeItem("refresh_token") + client.setConfig({ auth: undefined }) + }, + async login(email: string, password: string) { + try { + const { data } = await loginApiV1AuthLoginPost({ + body: { email, password }, + throwOnError: true, + }) + if (data) { + this.setTokens(data.access_token, data.refresh_token) + ElMessage.success("登录成功") + return true + } + return false + } catch (error: any) { + // console.error("登录失败", error) + ElMessage.error(error.message || "登录失败") + return false + } + }, + async register(email: string, password: string, username?: string) { + try { + await registerApiV1AuthRegisterPost({ + body: { email, password, username }, + throwOnError: true, + }) + ElMessage.success("注册成功") + return await this.login(email, password) + } catch (error: any) { + ElMessage.error(error.message || "注册失败") + return false + } + }, + logout() { + this.clearTokens() + ElMessage.info("已退出登录") + }, + initAuth() { + if (this.accessToken) { + client.setConfig({ + auth: () => this.accessToken || '' + }) + } + } + } +}) \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/stores/todo.ts b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/stores/todo.ts new file mode 100644 index 0000000..96b71dc --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/stores/todo.ts @@ -0,0 +1,69 @@ +// src/stores/todo.ts +import { defineStore } from 'pinia' +import { + readTodosApiV1TodosGet, + createTodoApiV1TodosPost, + updateTodoApiV1TodosTodoIdPatch, + deleteTodoApiV1TodosTodoIdDelete, + type TodoRead, + type TodoCreate, + type TodoUpdate, +} from '@/api/generated' + +interface TodoState { + todos: TodoRead[] + loading: boolean +} + +export const useTodoStore = defineStore('todo', { + state: (): TodoState => ({ + todos: [], + loading: false, + }), + actions: { + async fetchTodos() { + this.loading = true + try { + const { data } = await readTodosApiV1TodosGet({ + query: { offset: 0, limit: 100 }, + throwOnError: true, + }) + this.todos = data || [] + } catch (error) { + console.error('获取 Todo 列表失败', error) + throw error + } finally { + this.loading = false + } + }, + async addTodo(todo: TodoCreate) { + const { data } = await createTodoApiV1TodosPost({ + body: todo, + throwOnError: true, + }) + if (data) { + this.todos.unshift(data) + } + return data + }, + async updateTodo(id: number, updates: TodoUpdate) { + const { data } = await updateTodoApiV1TodosTodoIdPatch({ + path: { todo_id: id }, + body: updates, + throwOnError: true, + }) + if (data) { + const index = this.todos.findIndex((t) => t.id === id) + if (index !== -1) this.todos[index] = data + } + return data + }, + async deleteTodo(id: number) { + await deleteTodoApiV1TodosTodoIdDelete({ + path: { todo_id: id }, + throwOnError: true, + }) + this.todos = this.todos.filter((t) => t.id !== id) + }, + }, +}) \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/views/LoginView.vue b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/views/LoginView.vue new file mode 100644 index 0000000..ce44549 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/views/LoginView.vue @@ -0,0 +1,58 @@ + + + + + + \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/views/RegisterView.vue b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/views/RegisterView.vue new file mode 100644 index 0000000..9851f3f --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/views/RegisterView.vue @@ -0,0 +1,61 @@ + + + + + + \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/views/TodoView.vue b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/views/TodoView.vue new file mode 100644 index 0000000..7434a99 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/src/views/TodoView.vue @@ -0,0 +1,245 @@ + + + + + + \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/tsconfig.app.json b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/tsconfig.app.json new file mode 100644 index 0000000..0804c9f --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/tsconfig.app.json @@ -0,0 +1,24 @@ +{ + "extends": "@vue/tsconfig/tsconfig.dom.json", + "include": [ + "env.d.ts", + "src/**/*", + "src/**/*.vue" + ], + "exclude": [ + "src/**/__tests__/*" + ], + "compilerOptions": { + // Extra safety for array and object lookups, but may have false positives. + "noUncheckedIndexedAccess": true, + // Path mapping for cleaner imports. + "paths": { + "@/*": [ + "./src/*" + ] + }, + // `vue-tsc --build` produces a .tsbuildinfo file for incremental type-checking. + // Specified here to keep it out of the root directory. + "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo" + } +} \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/tsconfig.json b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/tsconfig.json new file mode 100644 index 0000000..66b5e57 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/tsconfig.json @@ -0,0 +1,11 @@ +{ + "files": [], + "references": [ + { + "path": "./tsconfig.node.json" + }, + { + "path": "./tsconfig.app.json" + } + ] +} diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/tsconfig.node.json b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/tsconfig.node.json new file mode 100644 index 0000000..93488bb --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/tsconfig.node.json @@ -0,0 +1,26 @@ +// TSConfig for modules that run in Node.js environment via either transpilation or type-stripping. +{ + "extends": "@tsconfig/node24/tsconfig.json", + "include": [ + "vite.config.*", + "vitest.config.*", + "cypress.config.*", + "playwright.config.*", + "eslint.config.*" + ], + "compilerOptions": { + // Most tools use transpilation instead of Node.js's native type-stripping. + // Bundler mode provides a smoother developer experience. + "module": "preserve", + "moduleResolution": "bundler", + // Include Node.js types and avoid accidentally including other `@types/*` packages. + "types": [ + "node" + ], + // Disable emitting output during `vue-tsc --build`, which is used for type-checking only. + "noEmit": true, + // `vue-tsc --build` produces a .tsbuildinfo file for incremental type-checking. + // Specified here to keep it out of the root directory. + "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo" + } +} \ No newline at end of file diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/vite.config.ts b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/vite.config.ts new file mode 100644 index 0000000..24e59ab --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}-web/vite.config.ts @@ -0,0 +1,22 @@ +import { fileURLToPath, URL } from 'node:url' + +import { defineConfig } from 'vite' +import vue from '@vitejs/plugin-vue' +import vueDevTools from 'vite-plugin-vue-devtools' + +// https://vite.dev/config/ +export default defineConfig({ + plugins: [ + vue(), + vueDevTools(), + ], + /** + * 打包开启此配置项 + */ + base: '/static/', + resolve: { + alias: { + '@': fileURLToPath(new URL('./src', import.meta.url)) + }, + }, +}) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/__init__.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/__init__.py index 75020ce..a1db873 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/__init__.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/__init__.py @@ -1,19 +1,60 @@ import uvicorn from .app.core.config import load_config -from .app.core.logger import setup_logging, get_logger +from .app.core.logger import get_logger def serve(): + """ + 使用 uvicorn 启动服务 + + 从配置文件中加载服务器配置和日志配置，然后使用 uvicorn 启动应用服务。 + 该函数适用于开发环境或单进程部署场景。 + + Returns: + None: 该函数不返回值，会阻塞运行直到服务停止 + """ config = load_config() env = config["default"]["env"] server_config = config[env]["server"] log_config = config[env]["logging"] - setup_logging(log_config) - logget = get_logger("app") - logget.info(f"启动服务: {server_config}") - logget.info(f"启动日志: {log_config}") + logger = get_logger("app") + logger.info(f"启动服务: {server_config}") + logger.info(f"启动日志: {log_config}") uvicorn.run("{{ cookiecutter.project_name }}.app:app", **server_config) +def gunicorn_serve(): + """ + 使用 gunicorn 启动服务 + + 通过 gunicorn 作为进程管理器启动应用，使用 UvicornWorker 作为 worker 类型， + 支持多进程部署，适用于生产环境。 + + 从配置文件中读取服务器配置，动态设置 gunicorn 的 worker 数量、绑定地址和端口等参数。 + + Returns: + None: 该函数不返回值，会阻塞运行直到服务停止 + """ + import sys + from gunicorn.app.wsgiapp import run + + config = load_config() + env = config["default"]["env"] + server_config = config[env]["server"] + + # 构建 gunicorn 命令行参数并启动服务 + sys.argv = [ + "gunicorn", + "{{ cookiecutter.project_name }}.app:app", + "-k", + "uvicorn.workers.UvicornWorker", + "-w", + f"{server_config.get('workers', 4)}", + "-b", + f"{server_config.get('host', '0.0.0.0')}:{server_config.get('port', 8000)}", + ] + run() + + if __name__ == "__main__": serve() diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/__init__.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/__init__.py index f111a16..77fa455 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/__init__.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/__init__.py @@ -1,29 +1,61 @@ +import time +from pathlib import Path from contextlib import asynccontextmanager -from fastapi import FastAPI +from fastapi import FastAPI, Request +from fastapi.responses import JSONResponse from fastapi.middleware.cors import CORSMiddleware +from fastapi.staticfiles import StaticFiles from sqlmodel import SQLModel, text from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession, async_sessionmaker from sqlalchemy.exc import OperationalError from .core.config import get_config -from .core.jwt_cache import get_jwt_cache +from .core.cache import get_cache from .core.logger import get_logger +from .core.static_files import SVFSStaticFiles from .api import api_router +from .task import init_tasks_callback + +from plugins.scheduler.scheduler import get_task_service_instance config = get_config() +cache = get_cache() logger = get_logger("app") + try: env = config["default"]["env"] except KeyError: # pragma: no cover raise ValueError("配置不存在") -# 生命周期管理 @asynccontextmanager async def lifespan(app: FastAPI): + """ + 应用生命周期管理函数，负责应用的启动和关闭时的资源初始化与清理。 + + 在应用启动时： + - 初始化JWT缓存 + - 创建异步数据库引擎和会话工厂 + - 在开发环境下创建数据库表 + - 初始化定时任务服务 + + 在应用关闭时： + - 关闭定时任务服务 + - 释放数据库引擎资源 + - 关闭缓存连接 + + 参数: + app: FastAPI应用实例 + + Yields: + None: 应用运行期间保持上下文激活 + """ from plugins import hello + from plugins.jwt.jwt_cache import get_jwt_cache + + get_jwt_cache(config, cache) hello() database = config["database"] @@ -31,18 +63,18 @@ async def lifespan(app: FastAPI): database_config = database.get(database_type, None) if database_config is None: raise ValueError("配置不存在") + database_path = database.get("database_path", None) + if database_path: + Path(database_path).parent.mkdir(parents=True, exist_ok=True) - # 启动时：创建引擎和会话工厂，初始化数据库表 engine = create_async_engine(database["url"], **database_config) async_session_maker = async_sessionmaker( engine, class_=AsyncSession, expire_on_commit=False ) - # 将资源存储到 app.state app.state.engine = engine app.state.async_session_maker = async_session_maker - # 创建表（异步方式） if env == "development": async with engine.begin() as conn: if database_type == "sqlite": @@ -58,16 +90,20 @@ async def lifespan(app: FastAPI): if "already exists" in str(e): raise - yield # 应用运行期间 + task_service = get_task_service_instance( + config, get_logger("scheduler"), async_session_maker + ) + app.state.task_service = task_service + await task_service.start(init_tasks_callback) - # 关闭时：释放引擎 + yield + + await task_service.shutdown(wait=True) await engine.dispose() - get_jwt_cache().close() + cache.close() cors = config[env].get("cors", {}) - -# 创建 FastAPI 应用 app = FastAPI( title=config["default"]["app"]["name"], version=config["default"]["app"]["version"], @@ -77,29 +113,113 @@ app = FastAPI( openapi_url="/openapi.json" if config[env]["debug"] else None, lifespan=lifespan, ) -# 添加 CORS 中间件 + app.add_middleware(CORSMiddleware, **cors) -app.include_router(api_router, prefix="/api/v1") + +app.include_router(api_router, prefix=config["default"]["prefix"]) + + +@app.middleware("http") +async def access_log_middleware(request: Request, call_next): + """ + HTTP访问日志中间件，记录每个请求的详细信息。 + + 记录的信息包括： + - 请求方法和路径 + - 响应状态码 + - 请求处理时长（毫秒） + - 客户端IP地址 + + 参数: + request: FastAPI请求对象 + call_next: 下一个中间件或路由处理函数 + + 返回: + Response: 处理后的响应对象 + """ + start = time.perf_counter() + response = await call_next(request) + duration = (time.perf_counter() - start) * 1000 + client = request.client.host if request.client else "-" + + logger.info( + f"{request.method} {request.url.path} status={response.status_code} " + f"duration={duration:.2f}ms client={client}", + extra={"status_code": response.status_code}, + ) + return response -# 根路由 @app.get("/", summary="根路径") async def root(): - """根路径，返回应用信息""" + """ + 根路径端点，返回应用的基本信息。 + + 返回: + dict: 包含应用名称、版本、文档地址和健康检查地址的字典 + """ return { - "message": f"欢迎使用 {config["default"]["app"]["name"]}", + "message": f"欢迎使用 {config['default']['app']['name']}", "version": config["default"]["app"]["version"], "docs": "/docs" if config[env]["debug"] else None, - "health": "/api/v1/health", + "health": f"{config['default']['prefix']}/health", } -# 全局异常处理器 +# from pydantic import BaseModel + + +# class TaskRequest(BaseModel): +# task_name: str +# interval: int + + +# @app.post("/schedule") +# async def add_task( +# request: TaskRequest, task_service: TaskService = Depends(get_task_service) +# ): +# """添加定时任务接口""" +# job = await task_service.add_interval_job( +# execute_background_task, +# seconds=request.interval, +# args=[request.task_name], +# job_id=request.task_name, +# ) +# return {"status": "success", "job_id": job.id} + +config = get_config() +IMAGE_DIR = Path(f"./{config['default']['upload_path']}/images") +app.mount( + f"{config['default']['prefix']}/images", + StaticFiles(directory=f"./{config['default']['upload_path']}/images"), + name="images", +) + +if vfs_db_path := config[env].get("file_system", {}).get("path", None): + logger.info("静态文件已存在，将使用静态文件服务") + static_files_handler = SVFSStaticFiles(directory="/", vfs_db_path=vfs_db_path) + app.mount("/static", static_files_handler, name="static") + + @app.exception_handler(Exception) -async def global_exception_handler(request, exc): - """全局异常处理器""" +async def global_exception_handler(_: Request, exc: Exception): + """ + 全局异常处理器，捕获并处理应用中未捕获的异常。 + + 在调试模式下返回详细的异常信息，在生产模式下返回通用错误提示。 + + 参数: + _: FastAPI请求对象（未使用） + exc: 捕获到的异常对象 + + 返回: + JSONResponse: 包含错误信息的JSON响应，状态码为500 + """ logger.error(f"全局异常: {exc}") - return { - "error": "内部服务器错误", - "detail": str(exc) if config[env]["debug"] else "请查看服务器日志", - } + return JSONResponse( + status_code=500, + content={ + "error": "内部服务器错误", + "detail": str(exc) if config[env]["debug"] else "请查看服务器日志", + }, + ) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/__init__.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/__init__.py index 7dd6c03..1d0c335 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/__init__.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/__init__.py @@ -4,7 +4,7 @@ API 路由 from fastapi import APIRouter -from .routers import todo, auth +from .routers import todo, auth, upload # 创建主路由 api_router = APIRouter() @@ -12,6 +12,7 @@ api_router = APIRouter() # 注册子路由 api_router.include_router(todo.router, prefix="/todos", tags=["todo"]) api_router.include_router(auth.router, prefix="/auth", tags=["authentication"]) +api_router.include_router(upload.router, prefix="/upload", tags=["upload"]) # 导出路由 diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/deps.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/deps.py index 3fe9b06..d48178e 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/deps.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/deps.py @@ -2,25 +2,35 @@ from fastapi import Depends, HTTPException, status from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials from ..service.auth import get_auth_service -from ..core.jwt_cache import TokenData +from plugins.jwt.jwt_cache import TokenData - -security = HTTPBearer() +access_scheme = HTTPBearer(scheme_name="AccessToken") async def get_current_user( - credentials: HTTPAuthorizationCredentials = Depends(security), + credentials: HTTPAuthorizationCredentials = Depends(access_scheme), ) -> TokenData: """ 获取当前用户依赖项 验证访问令牌并返回用户信息 + + Args: + credentials: HTTP授权凭证，包含Bearer token + + Returns: + TokenData: 验证通过后的用户令牌数据 + + Raises: + HTTPException: 当访问令牌无效时抛出401未授权异常 """ auth_service = get_auth_service() + # 提取并验证访问令牌 token = credentials.credentials token_data = await auth_service.validate_access_token(token) + # 令牌验证失败时抛出未授权异常 if token_data is None: raise HTTPException( status_code=status.HTTP_401_UNAUTHORIZED, diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/routers/auth.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/routers/auth.py index d30942c..65f91a3 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/routers/auth.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/routers/auth.py @@ -1,31 +1,57 @@ +from uuid import UUID + from fastapi import APIRouter, Depends, HTTPException, status, Request from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials from sqlalchemy.ext.asyncio import AsyncSession from ...core.database import get_session -from ...core.jwt_cache import get_jwt_cache, TokenData from ...core.security import verify_password from ...service.user import UserService from ...service.auth import get_auth_service -from ...model.user import UserCreate, UserRead, UserLogin +from ...model.user import UserCreate, UserRead, UserLogin, Userlogout, UserSession +from ...model.http_error import HTTPError, Detail from ..deps import get_current_user +from plugins.jwt.jwt_cache import TokenData, TokenResponse, RefreshTokenResponse router = APIRouter(tags=["authentication"]) -security = HTTPBearer() +access_scheme = HTTPBearer(scheme_name="AccessToken") +refresh_scheme = HTTPBearer(scheme_name="RefreshToken") -@router.post("/register", response_model=UserRead) +@router.post( + "/register", + response_model=UserRead, + responses={400: {"model": HTTPError, "description": "邮箱已被注册"}}, +) async def register( user_data: UserCreate, session: AsyncSession = Depends(get_session), ): - print(user_data.password) + """ + 用户注册接口 + 创建新用户账户，检查邮箱是否已被注册，如果邮箱未被注册则创建新用户。 + + Args: + user_data: 用户注册数据，包含邮箱、密码、用户名和全名等信息 + session: 数据库会话对象，用于执行数据库操作 + + Returns: + UserRead: 创建成功的用户信息，包含用户ID、邮箱、用户名等字段 + + Raises: + HTTPException: 当邮箱已被注册时抛出400错误 + """ existing = await UserService.get_user_by_email(user_data.email, session) if existing: - raise HTTPException(status_code=400, detail="邮箱已被注册") + raise HTTPException( + status_code=status.HTTP_400_BAD_REQUEST, + detail=Detail( + message="邮箱已被注册", code=status.HTTP_400_BAD_REQUEST + ).model_dump(), + ) user = await UserService.create_user( session=session, @@ -37,44 +63,85 @@ async def register( return user -@router.post("/login") +@router.post( + "/login", + response_model=TokenResponse, + responses={ + 400: {"model": HTTPError, "description": "邮箱不存在"}, + 401: {"model": HTTPError, "description": "密码错误"}, + 402: {"model": HTTPError, "description": "用户被禁用"}, + }, +) async def login( user_data: UserLogin, request: Request, session: AsyncSession = Depends(get_session), ): + """ + 用户登录接口 + + 验证用户凭据并生成访问令牌和刷新令牌。依次检查邮箱是否存在、密码是否正确、用户是否被禁用。 + + Args: + user_data: 用户登录数据，包含邮箱和密码 + request: FastAPI请求对象，用于获取客户端信息 + session: 数据库会话对象，用于查询用户信息 + + Returns: + TokenResponse: 包含访问令牌(access_token)、刷新令牌(refresh_token)和令牌类型(token_type)的响应对象 + + Raises: + HTTPException: + - 400错误：当邮箱不存在时 + - 401错误：当密码错误时 + - 402错误：当用户账户被禁用时 + """ user = await UserService.get_user_by_email(user_data.email, session) if not user: - raise HTTPException(status_code=400, detail="邮箱或密码错误") + raise HTTPException( + status_code=400, detail=Detail(message="邮箱不存在", code=400).model_dump() + ) if not verify_password(user_data.password, user.hashed_password): - raise HTTPException(status_code=400, detail="邮箱或密码错误") + raise HTTPException( + status_code=400, detail=Detail(message="密码错误", code=401).model_dump() + ) if not user.is_active: - raise HTTPException(status_code=400, detail="用户被禁用") - - cache = get_jwt_cache() - user_data_dict = { - "sub": str(user.id), - "email": user.email, - "username": user.username, - } - token = cache.create_token( - user_id=str(user.id), - user_data=user_data_dict, - token_type="access", - device_id=None, - user_agent=request.headers.get("user-agent") if request else None, - ip_address=request.client.host if request else None, # type: ignore - ) - - return {"access_token": token, "token_type": "bearer"} + raise HTTPException( + status_code=400, detail=Detail(message="用户被禁用", code=402).model_dump() + ) + auth_service = get_auth_service() + return await auth_service.create_tokens(user, request, device_id=None) -@router.post("/refresh", response_model=dict, summary="刷新访问令牌") +@router.post( + "/refresh", + response_model=RefreshTokenResponse, + responses={ + 401: {"model": HTTPError, "description": "无效的刷新令牌"}, + }, + summary="刷新访问令牌", +) async def refresh_token( request: Request, - credentials: HTTPAuthorizationCredentials = Depends(security), + credentials: HTTPAuthorizationCredentials = Depends(refresh_scheme), session: AsyncSession = Depends(get_session), ): + """ + 刷新访问令牌接口 + + 使用有效的刷新令牌获取新的访问令牌。验证刷新令牌的有效性，如果有效则生成新的访问令牌。 + + Args: + request: FastAPI请求对象，用于获取客户端信息 + credentials: HTTP认证凭证，从请求头中提取的刷新令牌 + session: 数据库会话对象，用于验证令牌状态 + + Returns: + RefreshTokenResponse: 包含新的访问令牌(access_token)和令牌类型(token_type)的响应对象 + + Raises: + HTTPException: 当刷新令牌无效或已过期时抛出401错误 + """ auth_service = get_auth_service() refresh_token = credentials.credentials @@ -84,51 +151,103 @@ async def refresh_token( if not new_access_token: raise HTTPException( status_code=status.HTTP_401_UNAUTHORIZED, - detail="无效的刷新令牌", + detail=Detail(message="无效的刷新令牌", code=401).model_dump(), headers={"WWW-Authenticate": "Bearer"}, ) return {"access_token": new_access_token, "token_type": "bearer"} -@router.post("/logout") +@router.post("/logout", response_model=Userlogout) async def logout( - credentials: HTTPAuthorizationCredentials = Depends(security), + credentials: HTTPAuthorizationCredentials = Depends(access_scheme), ): + """ + 用户登出接口 + + 使当前的访问令牌失效，实现单设备登出功能。 + + Args: + credentials: HTTP认证凭证，从请求头中提取的访问令牌 + + Returns: + Userlogout: 登出成功响应，包含成功消息和状态码200 + """ auth_service = get_auth_service() token = credentials.credentials await auth_service.logout(token) - return {"message": "登出成功"} + return {"message": "登出成功", "code": 200} -@router.post("/logout-all", summary="等出所有设备") +@router.post("/logout-all", summary="登出所有设备", response_model=Userlogout) async def logout_all(current_user: TokenData = Depends(get_current_user)): + """ + 登出所有设备接口 + + 使指定用户的所有活跃会话令牌失效，实现多设备同时登出功能。 + + Args: + current_user: 当前登录用户的令牌数据，包含用户ID等信息 + + Returns: + Userlogout: 登出成功响应，包含成功消息和状态码200 + """ auth_service = get_auth_service() await auth_service.logout_all(current_user.user_id) - return {"message": "所有设备已登出"} + return {"message": "所有设备已登出", "code": 200} @router.get("/sessions", summary="获取用户会话") async def get_sessions(current_user: TokenData = Depends(get_current_user)): - """获取用户的所有活跃会话""" + """ + 获取用户会话列表接口 + + 查询并返回指定用户的所有活跃会话信息，包括每个会话的设备信息和创建时间等。 + + Args: + current_user: 当前登录用户的令牌数据，包含用户ID等信息 + + Returns: + UserSession: 用户会话信息对象，包含用户ID、会话列表和会话总数 + """ auth_service = get_auth_service() sessions = await auth_service.get_user_sessions(current_user.user_id) - return { - "user_id": current_user.user_id, - "sessions": sessions, - "count": len(sessions), - } + return UserSession( + user_id=current_user.user_id, sessions=sessions, count=len(sessions) + ) -@router.get("/me", response_model=UserRead, summary="获取当前用户信息") +@router.get( + "/me", + response_model=UserRead, + summary="获取当前用户信息", + responses={404: {"model": HTTPError, "description": "用户不存在"}}, +) async def get_current_user_info( session: AsyncSession = Depends(get_session), current_user: TokenData = Depends(get_current_user), ): - """获取当前登录用户的信息""" - user = await UserService.get_user_by_id(int(current_user.user_id), session) + """ + 获取当前用户信息接口 + + 根据当前登录用户的令牌信息，从数据库中查询并返回完整的用户资料。 + + Args: + session: 数据库会话对象，用于查询用户信息 + current_user: 当前登录用户的令牌数据，包含用户ID等信息 + + Returns: + UserRead: 用户详细信息，包含用户ID、邮箱、用户名、全名、激活状态等字段 + + Raises: + HTTPException: 当用户不存在时抛出404错误 + """ + user = await UserService.get_user_by_id(UUID(current_user.user_id), session) if not user: - raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="用户不存在") + raise HTTPException( + status_code=status.HTTP_404_NOT_FOUND, + detail=Detail(message="用户不存在", code=404).model_dump(), + ) return user diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/routers/todo.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/routers/todo.py index 1dd1ca7..5967a04 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/routers/todo.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/routers/todo.py @@ -6,53 +6,103 @@ from sqlalchemy.ext.asyncio import AsyncSession from ...model.todo import TodoCreate, TodoUpdate, TodoRead from ...core.database import get_session from ...service.todo import TodoService -from ...model.user import User from ..deps import get_current_user - -router = APIRouter() +router = APIRouter(dependencies=[Depends(get_current_user)]) # -------------------- 路由 -------------------- -@router.post("/", response_model=TodoRead, dependencies=[Depends(get_current_user)]) +@router.post("/", response_model=TodoRead) async def create_todo( todo: TodoCreate, session: AsyncSession = Depends(get_session), ): + """ + 创建新的待办事项 + + Args: + todo: 待办事项创建请求体，包含待办事项的详细信息 + session: 数据库会话对象，用于执行数据库操作 + + Returns: + TodoRead: 创建成功的待办事项对象，包含完整的待办事项信息 + """ return await TodoService.create_todo(todo, session) -@router.get( - "/", response_model=List[TodoRead], dependencies=[Depends(get_current_user)] -) +@router.get("/", response_model=List[TodoRead]) async def read_todos( offset: int = 0, limit: int = 100, session: AsyncSession = Depends(get_session) ): + """ + 获取待办事项列表 + + Args: + offset: 分页偏移量，默认为0，用于指定从第几条记录开始查询 + limit: 每页返回的最大记录数，默认为100，用于限制返回结果的数量 + session: 数据库会话对象，用于执行数据库操作 + + Returns: + List[TodoRead]: 待办事项列表，包含指定范围内的所有待办事项 + """ return await TodoService.get_todos(offset, limit, session) -@router.get( - "/{todo_id}", response_model=TodoRead, dependencies=[Depends(get_current_user)] -) +@router.get("/{todo_id}", response_model=TodoRead) async def read_todo(todo_id: int, session: AsyncSession = Depends(get_session)): + """ + 根据ID获取单个待办事项 + + Args: + todo_id: 待办事项的唯一标识符 + session: 数据库会话对象，用于执行数据库操作 + + Returns: + TodoRead: 查询到的待办事项对象 + + Raises: + HTTPException: 当待办事项不存在时抛出404错误 + """ todo = await TodoService.get_todo_by_id(todo_id, session) if not todo: raise HTTPException(status_code=404, detail="Todo not found") return todo -@router.patch( - "/{todo_id}", response_model=TodoRead, dependencies=[Depends(get_current_user)] -) +@router.patch("/{todo_id}", response_model=TodoRead) async def update_todo( todo_id: int, todo_update: TodoUpdate, session: AsyncSession = Depends(get_session) ): + """ + 更新待办事项信息 + + Args: + todo_id: 待办事项的唯一标识符 + todo_update: 待办事项更新请求体，包含需要更新的字段信息 + session: 数据库会话对象，用于执行数据库操作 + + Returns: + TodoRead: 更新后的待办事项对象，包含最新的待办事项信息 + """ todo = await TodoService.update_todo(todo_id, todo_update, session) return todo -@router.delete("/{todo_id}", dependencies=[Depends(get_current_user)]) +@router.delete("/{todo_id}") async def delete_todo(todo_id: int, session: AsyncSession = Depends(get_session)): + """ + 删除待办事项 + + Args: + todo_id: 待办事项的唯一标识符 + session: 数据库会话对象，用于执行数据库操作 + + Returns: + dict: 包含操作结果的字典，{"ok": True} 表示删除成功 + + Raises: + HTTPException: 当待办事项不存在时抛出404错误 + """ is_deleted = await TodoService.delete_todo(todo_id, session) if not is_deleted: raise HTTPException(status_code=404, detail="Todo not found") diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/routers/upload.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/routers/upload.py new file mode 100644 index 0000000..8449010 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/api/routers/upload.py @@ -0,0 +1,67 @@ +import os + +from fastapi import APIRouter, UploadFile, File, HTTPException, Depends +from pydantic import BaseModel + +from ..deps import get_current_user +from ...service.uploads import UploadService +from ...core.config import get_config + +config = get_config() +router = APIRouter(dependencies=[Depends(get_current_user)]) +upload_image_service = UploadService( + config["default"]["upload_path"], 1024 * 1024, "images" +) + + +class UploadResponse(BaseModel): + """图片上传响应数据模型""" + + url: str + filename: str + file_type: str + + +@router.post("/image", response_model=UploadResponse) +async def upload_image(file: UploadFile = File(...)): + """ + 上传图片文件接口 + + 该接口用于接收用户上传的图片文件，进行格式验证后保存到服务器， + 并返回文件的访问URL、文件名和文件类型信息。 + + Args: + file (UploadFile): 上传的文件对象，必须为图片格式 + + Returns: + UploadResponse: 包含以下字段的响应对象： + - url (str): 上传文件的访问URL + - filename (str): 保存后的文件名 + - file_type (str): 文件扩展名（如 .jpg, .png 等） + + Raises: + HTTPException: + - 400: 当文件类型不是图片格式时 + - 400: 当文件名为空时 + - 400: 当文件扩展名不在允许列表中时 + + Note: + 支持的图片格式包括：.jpg, .jpeg, .png, .gif, .webp + 需要用户认证才能访问此接口 + """ + # 验证文件内容类型是否为图片 + if not file.content_type or not file.content_type.startswith("image/"): + raise HTTPException(status_code=400, detail="Invalid file type") + + # 验证文件名是否存在 + if file.filename is None: + raise HTTPException(status_code=400, detail="Invalid file name") + + # 检查文件扩展名是否在允许的范围内 + ext = os.path.splitext(file.filename)[1].lower() + if ext not in [".jpg", ".jpeg", ".png", ".gif", ".webp"]: + raise HTTPException(status_code=400, detail="Invalid file type") + + # 执行文件上传操作 + url, filename = await upload_image_service.upload(file) + return UploadResponse(url=url, filename=filename, file_type=ext) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/cache.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/cache.py new file mode 100644 index 0000000..acfcc7b --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/cache.py @@ -0,0 +1,397 @@ +""" +磁盘缓存模块 + +基于 diskcache 实现的本地磁盘缓存系统，提供类似 Redis 的 API 接口。 +支持过期时间设置、TTL 查询、键模式匹配等功能。 +""" + +import time +from typing import Any, Optional + +import diskcache + +from ..core.config import get_config + + +class Cache: + """ + 磁盘缓存类 + + 封装 diskcache 提供统一的缓存操作接口，支持： + - 键值对存储与检索 + - 过期时间管理（秒/毫秒） + - TTL 查询 + - 键模式匹配 + - 批量操作 + + Attributes: + _cache: diskcache.Cache 实例，负责实际的磁盘缓存操作 + """ + + def __init__(self): + """ + 初始化缓存实例 + + 从配置中读取缓存存储路径，创建 diskcache.Cache 实例。 + + Raises: + KeyError: 当配置中缺少 cache.cache_store_path 时 + """ + config = get_config() + cache_dir = config["cache"]["cache_store_path"] + self._cache = diskcache.Cache(cache_dir) + + def set( + self, + key: str, + value: Any, + ex: Optional[int] = None, + px: Optional[int] = None, + raw: bool = False, + ) -> bool: + """ + 设置缓存 + + 将键值对存储到缓存中，可选设置过期时间。内部使用元组 (value, expire_at) + 存储，以支持自定义的过期检查逻辑。 + + Args: + key: 缓存键，字符串类型 + value: 缓存值，可以是任意可序列化的 Python 对象 + ex: 过期时间（秒），与 px 互斥，优先使用 ex + px: 过期时间（毫秒），当 ex 为 None 时生效 + raw: 是否原始存储（当前未使用，保留参数兼容性） + + Returns: + bool: 设置成功返回 True，发生异常返回 False + + Note: + - ex 和 px 不能同时设置，ex 优先级更高 + - 过期时间在存储时计算绝对时间戳，便于后续检查 + - 异常会被捕获并打印错误信息，不会抛出异常 + """ + try: + expire_at = None + expire_seconds = None + + if ex is not None: + expire_seconds = ex + expire_at = time.time() + ex + elif px is not None: + expire_seconds = px / 1000.0 + expire_at = time.time() + expire_seconds + + stored_value = (value, expire_at) + + self._cache.set(key, stored_value, expire=expire_seconds) + return True + + except Exception as e: + print(f"[缓存] set 错误: {e}") + return False + + def get(self, key: str, default: Any = None) -> Any: + """ + 获取缓存值 + + 根据键获取缓存值，自动检查并清理已过期的缓存项。 + 如果键不存在或已过期，返回默认值。 + + Args: + key: 缓存键 + default: 当键不存在或已过期时的返回值，默认为 None + + Returns: + Any: 缓存的值，如果key不存在或已过期返回default + + Note: + - 发现过期数据时会主动删除，避免脏数据累积 + - 异常情况下返回 default 值，保证调用安全性 + """ + try: + stored = self._cache.get(key) + if stored is None: + return default + value, expire_at = stored # type: ignore + + if expire_at is not None and time.time() > expire_at: # type: ignore + self._cache.delete(key) + return default + + return value + + except Exception as e: + print(f"[缓存] get 错误: {e}") + return default + + def delete(self, *keys: str) -> int: + """ + 删除一个或多个缓存键 + + 批量删除指定的缓存键，返回成功删除的数量。 + + Args: + *keys: 可变参数，要删除的键列表 + + Returns: + int: 成功删除的键数量 + + Note: + - 逐个删除，某个键删除失败不影响其他键 + - 只统计实际存在的键的删除操作 + """ + deleted = 0 + for key in keys: + if self._cache.delete(key): + deleted += 1 + return deleted + + def exists(self, key: str) -> bool: + """ + 检查键是否存在且未过期 + + 通过尝试获取值来判断键的有效性，比直接检查更可靠， + 因为会触发过期检查和清理逻辑。 + + Args: + key: 要检查的缓存键 + + Returns: + bool: 键存在且未过期返回 True，否则返回 False + """ + return self.get(key, None) is not None + + def expire(self, key: str, _time: int) -> bool: + """ + 更新键的过期时间 + + 重新设置指定键的过期时间，保持原值不变。 + 如果键不存在，操作失败。 + + Args: + key: 缓存键 + _time: 新的过期时间（秒），从当前时间开始计算 + + Returns: + bool: 设置成功返回 True，键不存在或异常返回 False + + Note: + - 需要先读取原值，再重新存储以更新过期时间 + - 原子性不保证，高并发场景可能有问题 + """ + try: + stored = self._cache.get(key) + if stored is None: + return False + value, _ = stored # type: ignore + expire_at = time.time() + _time + new_stored = (value, expire_at) + self._cache.set(key, new_stored, expire=_time) + return True + except Exception as e: + print(f"[缓存] expire 错误: {e}") + return False + + def ttl(self, key: str) -> int: + """ + 获取键的剩余生存时间（Time To Live） + + 计算键距离过期的剩余秒数。 + + Args: + key: 缓存键 + + Returns: + int: 剩余秒数，返回值含义： + - >= 0: 剩余存活秒数 + - -1: 键存在但永不过期 + - -2: 键不存在 + + Note: + - 返回值为整数，向下取整 + - 即使剩余时间为负数也返回 0，表示即将过期 + """ + try: + stored = self._cache.get(key) + if stored is None: + return -2 + + _, expire_at = stored # type: ignore + if expire_at is None: + return -1 + + remaining = expire_at - time.time() # type: ignore + return max(0, int(remaining)) + except Exception as e: + print(f"[缓存] ttl 错误: {e}") + return -2 + + def keys(self, pattern: Optional[str] = None) -> list: + """ + 获取所有缓存键，支持通配符模式匹配 + + 遍历所有缓存键，可根据前缀模式过滤。 + + Args: + pattern: 匹配模式，仅支持前缀通配，如 "user:*" 匹配所有 "user:" 开头的键 + None 或空字符串返回所有键 + + Returns: + list: 匹配的键列表，按迭代顺序排列 + + Note: + - 仅支持简单的 "*" 后缀通配，不支持复杂模式 + - 大量键时性能较差，建议谨慎使用 + - pattern 中的 "*" 会被替换为空字符串作为前缀 + """ + all_keys = list(self._cache.iterkeys()) + + if pattern and "*" in pattern: + prefix = pattern.replace("*", "") + all_keys = [k for k in all_keys if k.startswith(prefix)] # type: ignore + + return all_keys + + def clear(self) -> bool: + """ + 清空所有缓存 + + 删除缓存目录中的所有数据，包括未过期的项。 + + Returns: + bool: 清空成功返回 True，异常返回 False + + Warning: + 此操作不可逆，会删除所有缓存数据 + """ + try: + self._cache.clear() + return True + except Exception as e: + print(f"[缓存] clear 错误: {e}") + return False + + def size(self) -> int: + """ + 获取当前有效缓存项数量 + + 统计当前未过期的缓存键数量。 + + Returns: + int: 有效缓存项的数量 + + Note: + - 不包含已过期但尚未清理的项 + - 需要遍历所有键，大数据量时可能有性能开销 + """ + # diskcache 的 __len__ 会返回当前有效条目数 + return len(list(self._cache.iterkeys())) + + def get_all(self) -> dict: + """ + 获取所有未过期的缓存数据 + + 遍历所有缓存键，返回有效的键值对字典。 + 自动过滤过期数据。 + + Returns: + dict: 所有有效缓存的键值对，格式为 {key: value} + + Note: + - 会触发每个键的过期检查 + - 大数据量时内存占用较高，谨慎使用 + - 返回的是快照，不保证原子性 + """ + result = {} + for key in self._cache.iterkeys(): + value = self.get(str(key)) # get 内部会检查并清理过期 + if value is not None: + result[key] = value + return result + + def close(self): + """ + 关闭缓存连接 + + 释放 diskcache 占用的资源，包括文件句柄等。 + 应在应用退出时调用。 + + Note: + 关闭后不应再使用该实例，除非重新初始化 + """ + self._cache.close() + + +_cache: Optional[Cache] = None + + +def get_cache() -> Cache: + """ + 获取全局缓存单例 + + 使用懒加载模式创建缓存实例，确保整个应用中只有一个 Cache 实例。 + + Returns: + Cache: 全局缓存实例 + + Note: + - 线程不安全，多线程环境需要额外同步 + - 首次调用时初始化，后续调用返回同一实例 + """ + global _cache + if _cache is None: + _cache = Cache() + return _cache + + +# 装饰器：缓存函数结果 +def cached(ttl: Optional[int] = None): + """ + 函数结果缓存装饰器 + + 自动缓存函数的返回值，相同参数的调用直接从缓存返回， + 避免重复计算。适用于纯函数或副作用小的函数。 + + Args: + ttl: 缓存生存时间（秒），None 表示永不过期 + + Returns: + callable: 装饰器函数 + + Example: + >>> @cached(ttl=60) + ... def get_user(user_id: int): + ... return {"id": user_id, "name": "test"} + >>> + >>> # 第一次调用执行函数并缓存 + >>> get_user(1) + >>> # 60秒内再次调用直接返回缓存结果 + >>> get_user(1) + + Note: + - 缓存键由函数名 + 位置参数 + 关键字参数组成 + - 参数必须是可哈希的，否则会导致错误 + - 不适合缓存大型对象或频繁变化的数据 + - 不同参数组合会生成不同的缓存键 + """ + + def decorator(func): + def wrapper(*args, **kwargs): + # 生成缓存key + key = f"{func.__name__}:{str(args)}:{str(kwargs)}" + cache = get_cache() + # 尝试从缓存获取 + result = cache.get(key) + if result is not None: + return result + + # 执行函数 + result = func(*args, **kwargs) + + # 存入缓存 + cache.set(key, result, ex=ttl) + return result + + return wrapper + + return decorator diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/config.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/config.py index ce1b459..b704d5d 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/config.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/config.py @@ -2,7 +2,6 @@ import sys from pathlib import Path from typing import TypedDict, Literal, Optional, cast - if sys.version_info >= (3, 11): import tomllib from typing import Required, NotRequired diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/constant.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/constant.py new file mode 100644 index 0000000..0af4fb8 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/constant.py @@ -0,0 +1,46 @@ +class PermissionConstant: + """ + 权限常量类 - 按业务模块分组管理所有系统权限 + + 该类定义了系统中各个业务模块的权限标识符，采用分层结构组织： + - 每个业务域作为一个内部类（如 Sales, Purchase, Inventory 等） + - 每个权限使用 "资源:操作" 格式定义 + - 支持 CRUD 操作及业务特定操作（如 approve, export 等） + + 使用示例: + >>> Permission.Sales.ORDER_CREATE # 获取销售订单创建权限 + 'sales_order:create' + >>> Permission.get_all() # 获取所有权限列表 + ['sales_order:create', 'sales_order:read', ...] + """ + + class Sales: + """ + 销售域权限常量 + + 包含销售相关的权限定义： + - 销售订单管理（ORDER_*） + - 销售出库管理（OUTBOUND_*） + - 客户管理（CUSTOMER_*） + + 权限格式: sales_order:create, customer:export 等 + """ + + ORDER_CREATE = "sales_order:create" # 创建销售订单 + ORDER_READ = "sales_order:read" # 读取销售订单 + ORDER_UPDATE = "sales_order:update" # 修改销售订单 + ORDER_DELETE = "sales_order:delete" # 删除销售订单 + + OUTBOUND_CREATE = "sales_outbound:create" # 创建销售出库 + OUTBOUND_READ = "sales_outbound:read" # 读取销售出库 + OUTBOUND_UPDATE = "sales_outbound:update" # 修改销售出库 + OUTBOUND_DELETE = "sales_outbound:delete" # 删除销售出库 + OUTBOUND_APPROVE = "sales_outbound:approve" # 审批销售出库 + + CUSTOMER_CREATE = "customer:create" # 创建客户 + CUSTOMER_READ = "customer:read" # 读取客户 + CUSTOMER_UPDATE = "customer:update" # 修改客户 + CUSTOMER_DELETE = "customer:delete" # 删除客户 + CUSTOMER_EXPORT = "customer:export" # 导出客户 + + ... diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/logger.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/logger.py index 22ad3cc..d61db26 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/logger.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/logger.py @@ -1,55 +1,170 @@ +import re import logging +import datetime from pathlib import Path -from .config import Logging from logging.handlers import RotatingFileHandler +from ..core.config import get_config + +config = get_config() +env = config["default"]["env"] +server_config = config[env]["server"] +log_config = config[env]["logging"] + + +class ColoredFormatter(logging.Formatter): + """ + 为 HTTP 状态码添加颜色的日志格式化器 + + 根据 HTTP 状态码的首位数字为日志消息中的状态码添加不同颜色： + - 2xx: 绿色（成功） + - 3xx: 青色（重定向） + - 4xx: 黄色（客户端错误） + - 5xx: 红色（服务器错误） + + Attributes: + COLORS: 状态码首位数字到 ANSI 颜色代码的映射字典 + RESET: ANSI 重置颜色代码 + """ + + COLORS = { + "2": "\033[32m", # 绿色 2xx + "3": "\033[36m", # 青色 3xx + "4": "\033[33m", # 黄色 4xx + "5": "\033[31m", # 红色 5xx + } + RESET = "\033[0m" + + def format(self, record): + """ + 格式化日志记录，为状态码添加颜色 + + 如果日志记录包含 status_code 属性，则查找消息中的 "status=数字" 模式 + 并为其添加对应的颜色代码。格式化完成后恢复原始消息以避免影响其他 handler。 + + Args: + record: 日志记录对象，应包含 msg 属性和可选的 status_code 属性 + + Returns: + str: 格式化后的日志消息字符串，状态码部分可能包含 ANSI 颜色代码 + """ + # 保存原始消息 + original_msg = record.msg + # 如果日志记录包含 status_code 属性，则为其添加颜色 + status_code = getattr(record, "status_code", None) + if status_code and isinstance(status_code, int): + first_digit = str(status_code)[0] + color = self.COLORS.get(first_digit, "") + colored_status = f"{color}{status_code}{self.RESET}" + # 替换消息中的 "status=数字" 为带颜色的版本 + record.msg = re.sub( + rf"status={status_code}\b", f"status={colored_status}", original_msg + ) + result = super().format(record) + # 恢复原始消息，避免影响其他 handler + record.msg = original_msg + return result + class ExcludeWatchFilesFilter(logging.Filter): + """ + 日志过滤器，用于排除第三方库的日志输出 + + 过滤掉来自 watchfiles、aiosqlite、apscheduler、sqlalchemy 等库的日志记录， + 避免这些库的详细日志污染应用日志输出。 + """ + + def __init__(self): + """ + 初始化过滤器，设置需要过滤的日志名称前缀列表 + """ + super().__init__() + self._filter_starts_with_tulpe = ( + "watchfiles", + "aiosqlite", + "apscheduler", + "sqlalchemy", + "sqlitedict", + "sqlalchemy.engine.Engine", + ) + def filter(self, record): - # 如果日志记录来自 watchfiles 模块，则不记录（返回 False） - return not record.name.startswith("watchfiles") + """ + 判断是否应该保留该日志记录 + + Args: + record: 日志记录对象，包含 name 属性表示日志来源 + + Returns: + bool: 如果日志名称不以过滤列表中的任何前缀开头则返回 True（保留）， + 否则返回 False（过滤掉） + """ + return not record.name.startswith(self._filter_starts_with_tulpe) -def setup_logging(log_config: Logging): +_configured_loggers = set() + + +def setup_logging(logger: logging.Logger, log_name: str = "app"): + """ + 配置日志系统，包括文件和控制台输出 + + 为指定的 logger 配置以下功能： + 1. 设置日志级别和格式 + 2. 创建按日期命名的轮转文件处理器（支持文件大小限制和备份数量控制） + 3. 创建带颜色格式化的控制台处理器 + 4. 应用过滤器排除第三方库日志 + + 该函数具有防重复配置机制，同一个 log_name 只会配置一次。 + + Args: + logger: 需要配置的 logging.Logger 实例 + log_name: 日志名称标识，用于区分不同的日志配置和生成日志文件名，默认为 "app" + + Returns: + None + + Raises: + 无显式抛出异常，但可能因文件系统权限问题导致目录创建或文件写入失败 + """ + if log_name in _configured_loggers: + return + _configured_loggers.add(log_name) log_level = getattr(logging, log_config["level"], logging.INFO) log_format = log_config["format"] # 创建文件夹 log_file_path = Path(log_config["file"]) - log_file_dir = log_file_path.parent - if log_file_dir != Path("."): - log_file_dir.mkdir(parents=True, exist_ok=True) - - # 设置特定日志级别的过滤 - logging.getLogger("watchfiles").setLevel(logging.WARNING) + if log_file_path != Path("."): + log_file_path.mkdir(parents=True, exist_ok=True) # 配置根日志记录器 - root_logger = logging.getLogger() - root_logger.setLevel(log_level) + logger.setLevel(log_level) # 创建格式化器 - formatter = logging.Formatter(log_format) + plain_formatter = logging.Formatter(log_format) + color_formatter = ColoredFormatter(log_format) # 创建轮转文件处理器 - 限制文件大小为 10MB，保留 5 个备份文件 max_bytes = log_config.get("max_size", 10 * 1024 * 1024) # 默认 10MB backup_count = log_config.get("backup_count", 5) # 默认保留 5 个备份 file_handler = RotatingFileHandler( - log_config["file"], + f"{log_config['file']}/{log_name}-{datetime.date.today()}.log", encoding="utf-8", maxBytes=max_bytes, backupCount=backup_count, ) - file_handler.setFormatter(formatter) + file_handler.setFormatter(plain_formatter) file_handler.addFilter(ExcludeWatchFilesFilter()) # 创建控制台处理器并添加过滤器 console_handler = logging.StreamHandler() - console_handler.setFormatter(formatter) + console_handler.setFormatter(color_formatter) console_handler.addFilter(ExcludeWatchFilesFilter()) # 添加处理器到根日志记录器 - root_logger.addHandler(file_handler) - root_logger.addHandler(console_handler) + logger.addHandler(file_handler) + logger.addHandler(console_handler) print( f"日志系统已配置 - 级别: {logging.getLevelName(log_level)}, 文件: {log_config['file']} " @@ -58,7 +173,18 @@ def setup_logging(log_config: Logging): def get_logger(name: str) -> logging.Logger: + """ + 获取配置好的日志记录器实例 + + 根据名称获取或创建 logger 实例，并自动调用 setup_logging 进行配置。 + 如果该名称的 logger 已经配置过，则直接返回已配置的实例。 + + Args: + name: 日志记录器名称，通常使用模块名如 __name__ + + Returns: + logging.Logger: 已配置完成的日志记录器实例，可直接用于记录日志 + """ logger = logging.getLogger(name) - # 为每个logger添加过滤器 - logger.addFilter(ExcludeWatchFilesFilter()) + setup_logging(logger, name) return logger diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/security.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/security.py index 36e7f4e..23ce9ca 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/security.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/security.py @@ -1,14 +1,36 @@ -from passlib.context import CryptContext - - -pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto") - - -def verify_password(plain_password: str, hashed_password: str) -> bool: - """验证密码""" - return pwd_context.verify(plain_password, hashed_password) +import bcrypt def get_password_hash(password: str) -> str: - """密码哈希""" - return pwd_context.hash(password) + """ + 对明文密码进行哈希加密 + + 使用bcrypt算法对密码进行加盐哈希处理,确保密码存储的安全性。 + + Args: + password: 需要加密的明文密码字符串 + + Returns: + 加密后的密码哈希字符串,采用UTF-8编码 + """ + salt = bcrypt.gensalt() + hashed = bcrypt.hashpw(password.encode("utf-8"), salt) + return hashed.decode("utf-8") + + +def verify_password(plain_password: str, hashed_password: str) -> bool: + """ + 验证明文密码与哈希密码是否匹配 + + 将明文密码与已存储的哈希密码进行比对,用于用户登录时的密码验证。 + + Args: + plain_password: 用户输入的明文密码 + hashed_password: 数据库中存储的哈希密码 + + Returns: + 密码匹配返回True,否则返回False + """ + return bcrypt.checkpw( + plain_password.encode("utf-8"), hashed_password.encode("utf-8") + ) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/static_file.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/static_file.py new file mode 100644 index 0000000..0880cbe --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/core/static_file.py @@ -0,0 +1,100 @@ +from fastapi import HTTPException +from fastapi.responses import Response +from fastapi.staticfiles import StaticFiles +from sqlite_vfs.core import SQLiteVFS + + +class SVFSStaticFiles(StaticFiles): + """ + 基于 SQLite VFS 的静态文件服务类 + + 该类继承自 FastAPI 的 StaticFiles，使用 SQLite 虚拟文件系统来存储和提供静态文件。 + 支持单页应用（SPA）的路由回退机制，当请求的文件不存在时，会自动返回 index.html。 + """ + + def __init__(self, directory, vfs_db_path="static.svfs"): + """ + 初始化 SVFSStaticFiles 实例 + + 参数: + directory (str): 静态文件的根目录路径 + vfs_db_path (str): SQLite VFS 数据库文件路径，默认为 "static.svfs" + + 返回值: + 无 + """ + vfs_db_path = vfs_db_path + self._vfs = SQLiteVFS(vfs_db_path, compress=False) + super().__init__(directory=directory) + + async def get_response(self, path: str, scope): + """ + 根据请求路径获取对应的静态文件响应 + + 该方法处理静态文件的请求逻辑，包括： + 1. 路径标准化处理 + 2. 文件存在性检查 + 3. SPA 路由回退支持 + 4. 目录索引处理 + 5. MIME 类型自动识别 + + 参数: + path (str): 请求的文件路径 + scope: ASGI 作用域对象，包含请求上下文信息 + + 返回值: + Response: FastAPI 响应对象，包含文件内容和正确的 Content-Type + + 异常: + HTTPException: 当文件不存在且无法回退到 index.html 时，抛出 404 错误 + """ + # 统一路径格式：以 / 开头，并将 Windows 反斜杠转为正斜杠 + normalized_path = "/" + path.replace("\\", "/") + + # 获取文件信息 + file_info = self._vfs.get_file_info(normalized_path) + + # 处理文件不存在的情况，尝试 SPA 回退机制 + if file_info is None: + # SPA 回退：如果不是静态资源扩展名，尝试返回 index.html + if not any( + normalized_path.endswith(ext) + for ext in [ + ".js", + ".css", + ".png", + ".jpg", + ".ico", + ".svg", + ".webp", + ".json", + ] + ): + index_info = self._vfs.get_file_info("/index.html") + if index_info: + content = self._vfs.read_file("/index.html") + return Response(content=content, media_type="text/html") + raise HTTPException(status_code=404, detail="File not found") + + # 处理目录请求，返回目录下的 index.html + if file_info["is_directory"]: + index_info = self._vfs.get_file_info(f"{normalized_path}/index.html") + if index_info: + content = self._vfs.read_file(f"{normalized_path}/index.html") + return Response(content=content, media_type="text/html") + raise HTTPException(status_code=404, detail="Directory index not found") + + # 读取文件内容并确定 MIME 类型 + content = self._vfs.read_file(normalized_path) + content_type = file_info.get("content_type") or "application/octet-stream" + # 简单根据扩展名补充 MIME 类型（可选） + if normalized_path.endswith(".js"): + content_type = "application/javascript" + elif normalized_path.endswith(".css"): + content_type = "text/css" + elif normalized_path.endswith(".html"): + content_type = "text/html" + elif normalized_path.endswith(".ico"): + content_type = "image/x-icon" + + return Response(content=content, media_type=content_type) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/__init__.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/__init__.py index e69de29..f9a7555 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/__init__.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/__init__.py @@ -0,0 +1,15 @@ +from .user import User +from .role import Role, RoleUpdate +from .permission import Permission +from .relationship_table import UserRole, RolePermission +from .todo import Todo + +__all__ = [ + "User", + "Role", + "RoleUpdate", + "Permission", + "UserRole", + "RolePermission", + "Todo", +] diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/http_error.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/http_error.py new file mode 100644 index 0000000..28f7937 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/http_error.py @@ -0,0 +1,31 @@ +from pydantic import BaseModel +from typing import Optional + + +class Detail(BaseModel): + """ + HTTP错误详情模型 + + 用于封装HTTP错误的详细信息，包括错误消息和错误代码。 + + Attributes: + message (str): 错误描述信息 + code (int): 错误状态码或业务错误码 + """ + + message: str + code: int + + +class HTTPError(BaseModel): + """ + HTTP错误响应模型 + + 用于标准化HTTP错误响应的数据结构，符合RESTful API规范。 + + Attributes: + detail (Optional[Detail]): 错误详情对象，包含具体的错误信息和错误码。 + 如果为None，表示没有详细的错误信息。 + """ + + detail: Optional[Detail] = None diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/permission.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/permission.py new file mode 100644 index 0000000..7e1f600 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/permission.py @@ -0,0 +1,36 @@ +from typing import Optional, List, TYPE_CHECKING + +from sqlmodel import SQLModel, Field, Relationship + +from .relationship_table import RolePermission + +if TYPE_CHECKING: + from .role import Role + + +class Permission(SQLModel, table=True): + """ + 权限模型类，用于定义系统中的权限项。 + + 权限采用资源:操作的格式进行标识，例如： + - user:create 表示创建用户的权限 + - order:delete 表示删除订单的权限 + + Attributes: + id: 权限的唯一标识符，主键，自增 + name: 权限标识符，唯一且建立索引，格式为"资源:操作" + description: 权限的描述信息，可选字段 + resource: 资源名称，建立索引，如 user、order、product 等 + action: 操作类型，如 create、read、update、delete 等 + roles: 关联的角色列表，通过 RolePermission 中间表实现多对多关系 + """ + + id: Optional[int] = Field(default=None, primary_key=True) + name: str = Field(unique=True, index=True) + description: Optional[str] = None + resource: str = Field(index=True) + action: str + + roles: List["Role"] = Relationship( + back_populates="permissions", link_model=RolePermission + ) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/relationship_table.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/relationship_table.py new file mode 100644 index 0000000..ba1eb80 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/relationship_table.py @@ -0,0 +1,35 @@ +from uuid import UUID +from sqlmodel import SQLModel, Field + + +# ---------- 关联表 ---------- +class UserRole(SQLModel, table=True): + """ + 用户角色关联表 + + 用于实现用户与角色之间的多对多关系。 + 每个记录表示一个用户拥有的一个角色。 + + Attributes: + user_id: 用户ID，外键关联到user表的id字段，作为复合主键的一部分 + role_id: 角色ID，外键关联到role表的id字段，作为复合主键的一部分 + """ + + user_id: UUID = Field(foreign_key="user.id", primary_key=True) + role_id: int = Field(foreign_key="role.id", primary_key=True) + + +class RolePermission(SQLModel, table=True): + """ + 角色权限关联表 + + 用于实现角色与权限之间的多对多关系。 + 每个记录表示一个角色拥有的一项权限。 + + Attributes: + role_id: 角色ID，外键关联到role表的id字段，作为复合主键的一部分 + permission_id: 权限ID，外键关联到permission表的id字段，作为复合主键的一部分 + """ + + role_id: int = Field(foreign_key="role.id", primary_key=True) + permission_id: int = Field(foreign_key="permission.id", primary_key=True) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/role.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/role.py new file mode 100644 index 0000000..c730f50 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/role.py @@ -0,0 +1,52 @@ +from typing import Optional, List, TYPE_CHECKING + +from sqlmodel import SQLModel, Field, Relationship +from pydantic import BaseModel + +from .relationship_table import UserRole, RolePermission + +if TYPE_CHECKING: + from .user import User + from .permission import Permission + + +# ---------- 角色表 ---------- +class Role(SQLModel, table=True): + """ + 角色模型类，用于定义系统中的用户角色。 + + 该类继承自SQLModel，映射到数据库中的角色表。每个角色可以有多个用户和多个权限， + 通过中间表UserRole和RolePermission实现多对多关系。 + + Attributes: + id: 角色的唯一标识符，主键，自增 + name: 角色名称，具有唯一性约束和索引，例如：admin, manager, operator, viewer + description: 角色的描述信息，可选字段 + is_only_user: 标识该角色是否仅限单个用户使用，默认为False + users: 与该角色关联的用户列表，通过UserRole中间表建立多对多关系 + permissions: 与该角色关联的权限列表，通过RolePermission中间表建立多对多关系 + """ + + id: Optional[int] = Field(default=None, primary_key=True) + name: str = Field(unique=True, index=True) # admin, manager, operator, viewer + description: Optional[str] = None + is_only_user: bool = Field(default=False) + users: List["User"] = Relationship(back_populates="roles", link_model=UserRole) + permissions: List["Permission"] = Relationship( + back_populates="roles", link_model=RolePermission + ) + + +class RoleUpdate(BaseModel): + """ + 角色更新请求模型类，用于接收角色更新时的参数。 + + 该类继承自Pydantic的BaseModel，所有字段均为可选，允许部分更新角色信息。 + + Attributes: + name: 更新后的角色名称，可选字段 + description: 更新后的角色描述信息，可选字段 + """ + + name: Optional[str] = None + description: Optional[str] = None diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/todo.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/todo.py index e53af47..7fa9b3c 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/todo.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/todo.py @@ -5,24 +5,71 @@ from sqlmodel import SQLModel, Field # 定义模型 class TodoBase(SQLModel): + """ + Todo任务的基础模型类，包含任务的通用字段。 + + Attributes: + title: 任务标题，必填字段 + description: 任务描述，可选字段，默认为None + completed: 任务完成状态，布尔值，默认为False + """ + title: str description: Optional[str] = None completed: bool = False class Todo(TodoBase, table=True): + """ + Todo任务的数据库表模型类，继承自TodoBase。 + + 该类对应数据库中的todo表，用于存储和查询任务数据。 + + Attributes: + id: 任务唯一标识符，主键，由数据库自动生成 + """ + id: Optional[int] = Field(default=None, primary_key=True) class TodoCreate(TodoBase): + """ + 创建Todo任务时使用的请求模型类。 + + 继承自TodoBase，用于接收前端传入的新建任务数据。 + 不包含id字段，因为id由数据库自动生成。 + """ + pass class TodoRead(TodoBase): + """ + 读取Todo任务时使用的响应模型类。 + + 继承自TodoBase，用于向客户端返回任务数据。 + 包含完整的任务信息，包括自动生成的id字段。 + + Attributes: + id: 任务唯一标识符，整数类型，必填字段 + """ + id: int class TodoUpdate(SQLModel): + """ + 更新Todo任务时使用的请求模型类。 + + 所有字段均为可选，允许部分更新任务信息。 + 只有提供的字段会被更新，未提供的字段保持原值。 + + Attributes: + title: 任务标题，可选字段 + description: 任务描述，可选字段 + completed: 任务完成状态，可选字段 + """ + title: Optional[str] = None description: Optional[str] = None completed: Optional[bool] = None diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/user.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/user.py index 02cbf3f..4b15444 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/user.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/model/user.py @@ -1,36 +1,127 @@ -from typing import Optional -from sqlmodel import SQLModel, Field +from typing import Optional, List, Dict, TYPE_CHECKING + +from sqlmodel import SQLModel, Field, Relationship from pydantic import BaseModel +from .relationship_table import UserRole +from uuid import uuid4, UUID + +if TYPE_CHECKING: + from .role import Role + class UserBase(SQLModel): + """ + 用户基础模型 + + 定义用户的核心属性，作为其他用户相关模型的基类。 + 包含用户的基本信息和状态标识。 + + Attributes: + email: 用户邮箱地址，唯一且建立索引 + username: 用户名，可选，最大长度50字符 + full_name: 用户全名，可选，最大长度100字符 + is_active: 用户激活状态，默认为True + is_superuser: 是否为超级管理员，默认为False + created_at: 创建时间，可选字段 + """ + email: str = Field(unique=True, index=True) username: Optional[str] = Field(default=None, max_length=50) full_name: Optional[str] = Field(default=None, max_length=100) is_active: bool = Field(default=True) is_superuser: bool = Field(default=False) - created_at: Optional[str] = Field(default=None) # 可自动填充，此处略 + created_at: Optional[str] = Field(default=None) class User(UserBase, table=True): - """用户模型""" + """ + 用户数据库模型 - id: Optional[int] = Field(default=None, primary_key=True) + 继承自UserBase，用于数据库表映射。 + 包含用户的完整信息以及与角色的多对多关系。 + + Attributes: + id: 用户唯一标识符，UUID类型，自动生成 + hashed_password: 加密后的密码 + roles: 用户关联的角色列表，通过UserRole中间表实现多对多关系 + """ + + id: UUID = Field(default_factory=uuid4, primary_key=True) hashed_password: str + roles: List["Role"] = Relationship(back_populates="users", link_model=UserRole) class UserCreate(UserBase): - """用户创建模型""" + """ + 用户创建请求模型 + + 用于创建新用户时的数据验证和传输。 + 在UserBase基础上增加了密码字段。 + + Attributes: + password: 用户明文密码，用于创建时传入 + """ password: str class UserRead(UserBase): - """用户读取模型""" + """ + 用户读取响应模型 - id: int + 用于向客户端返回用户信息。 + 在UserBase基础上增加了用户ID字段。 + + Attributes: + id: 用户唯一标识符，UUID类型 + """ + + id: UUID class UserLogin(BaseModel): + """ + 用户登录请求模型 + + 用于处理用户登录时的数据验证。 + + Attributes: + email: 用户邮箱地址 + password: 用户密码 + """ + email: str password: str + + +class Userlogout(BaseModel): + """ + 用户登出响应模型 + + 用于返回登出操作的结果。 + + Attributes: + code: 响应状态码，默认为200表示成功 + message: 响应消息，默认为"logout success" + """ + + code: int = 200 + message: str = "logout success" + + +class UserSession(BaseModel): + """ + 用户会话信息模型 + + 用于存储和返回用户的会话相关信息。 + + Attributes: + user_id: 用户唯一标识符 + sessions: 会话列表，每个会话为字典类型，键值均为字符串或None + count: 会话总数 + """ + + user_id: str + sessions: List[Dict[str, Optional[str]]] + count: int diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/auth.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/auth.py index 46b4f18..ff0e8ae 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/auth.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/auth.py @@ -4,13 +4,14 @@ from typing import Optional from fastapi import Request -from passlib.context import CryptContext +import bcrypt from sqlalchemy.ext.asyncio import AsyncSession from ..model.user import User -from .user import UserService -from ..core.jwt_cache import get_jwt_cache, TokenResponse, TokenData from ..core.config import get_config +from .user import UserService + +from plugins.jwt.jwt_cache import get_jwt_cache, TokenResponse, TokenData class AuthService: @@ -19,16 +20,29 @@ class AuthService: def __init__(self): self.jwt_cache = get_jwt_cache() self.settings = get_config() - self.pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto") async def authenticate_user( self, email: str, password: str, session: AsyncSession ) -> Optional[User]: - """验证用户凭据""" + """ + 验证用户凭据 + + 通过邮箱和密码验证用户身份，使用 bcrypt 进行密码哈希比对。 + + Args: + email: 用户邮箱地址 + password: 用户明文密码 + session: 数据库异步会话对象 + + Returns: + 验证成功返回 User 对象，失败返回 None + """ user = await UserService.get_user_by_email(email, session) if not user: return None - if not self.pwd_context.verify(password, user.hashed_password): + if not bcrypt.checkpw( + password.encode("utf-8"), user.hashed_password.encode("utf-8") + ): return None return user @@ -39,7 +53,20 @@ class AuthService: request: Optional[Request] = None, device_id: Optional[str] = None, ) -> TokenResponse: - """为用户创建访问和刷新令牌""" + """ + 为用户创建访问和刷新令牌 + + 根据用户信息和请求上下文生成 JWT access token 和 refresh token， + 同时记录设备信息用于安全审计。 + + Args: + user: 已验证的用户对象 + request: FastAPI 请求对象，用于提取客户端信息（可选） + device_id: 设备唯一标识符（可选） + + Returns: + TokenResponse 对象，包含 access_token、refresh_token 及过期时间 + """ # 获取用户数据 user_data = { @@ -86,7 +113,17 @@ class AuthService: ) async def validate_access_token(self, token: str) -> Optional[TokenData]: - """验证访问令牌""" + """ + 验证访问令牌 + + 校验 JWT access token 的有效性和完整性，提取用户身份信息。 + + Args: + token: JWT access token 字符串 + + Returns: + 验证成功返回 TokenData 对象（包含 user_id、username、email），失败返回 None + """ validation = self.jwt_cache.validate_token(token, token_type="access") if not validation: return None @@ -104,15 +141,28 @@ class AuthService: session: AsyncSession, request: Optional[Request] = None, ) -> Optional[str]: - """使用刷新令牌获取新的访问令牌""" - validation = self.jwt_cache.validate_token(refresh_token, token_type="access") + """ + 使用刷新令牌获取新的访问令牌 + + 验证 refresh token 的有效性，确认用户仍然存在，然后生成新的 access token。 + 保持原有的设备信息以确保会话连续性。 + + Args: + refresh_token: JWT refresh token 字符串 + session: 数据库异步会话对象 + request: FastAPI 请求对象，用于提取客户端信息（可选） + + Returns: + 验证成功返回新的 access token 字符串，失败返回 None + """ + validation = self.jwt_cache.validate_token(refresh_token, token_type="refresh") if not validation: return None user_id = validation["user_id"] # 获取用户 - user = await UserService.get_user_by_id(int(user_id), session) + user = await UserService.get_user_by_id(user_id, session) if not user: return None @@ -142,15 +192,39 @@ class AuthService: return new_access_token async def logout(self, token: str): - """用户登出 - 使令牌失效""" + """ + 用户登出 - 使令牌失效 + + 将指定的 token 加入黑名单，使其立即失效。 + + Args: + token: 需要失效的 JWT token 字符串 + """ self.jwt_cache.invalidate_token(token) async def logout_all(self, user_id: str): - """使用户的所有令牌失效""" + """ + 使用户的所有令牌失效 + + 强制注销用户的所有活跃会话，适用于密码修改或安全事件场景。 + + Args: + user_id: 用户 ID 字符串 + """ self.jwt_cache.invalidate_user_tokens(str(user_id)) async def get_user_sessions(self, user_id: str): - """获取用户的活跃会话""" + """ + 获取用户的活跃会话 + + 查询指定用户当前所有有效的 token 会话信息。 + + Args: + user_id: 用户 ID 字符串 + + Returns: + 用户活跃会话列表 + """ return self.jwt_cache.get_user_sessions(str(user_id)) @@ -159,7 +233,14 @@ _auth_service = None def get_auth_service() -> AuthService: - """获取认证服务实例（单例模式）""" + """ + 获取认证服务实例（单例模式） + + 确保整个应用中只有一个 AuthService 实例，避免重复初始化。 + + Returns: + AuthService 单例实例 + """ global _auth_service if _auth_service is None: _auth_service = AuthService() diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/permission.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/permission.py new file mode 100644 index 0000000..e247961 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/permission.py @@ -0,0 +1,193 @@ +from typing import Optional +from uuid import UUID + +from fastapi import HTTPException +from sqlalchemy.ext.asyncio import AsyncSession +from sqlmodel import select + +from ..model import Permission, RolePermission, Role, User +from .user import UserService +from .role import RoleService + + +class PermissionService: + """权限服务类，提供权限的创建、查询、分配和解除绑定等功能""" + + @classmethod + async def create_permission( + cls, + session: AsyncSession, + name: str, + resource: str, + action: str, + description: Optional[str] = None, + ) -> Permission: + """ + 创建新的权限记录 + + :param session: 数据库会话对象 + :param name: 权限名称 + :param resource: 资源标识 + :param action: 操作类型 + :param description: 权限描述，可选 + :return: 创建的权限对象 + """ + permission = Permission( + name=name, resource=resource, action=action, description=description + ) + session.add(permission) + await session.commit() + await session.refresh(permission) + return permission + + @classmethod + async def get_permission_by_id( + cls, session: AsyncSession, permission_id: int + ) -> Optional[Permission]: + """ + 根据ID获取权限 + + :param session: 数据库会话对象 + :param permission_id: 权限ID + :return: 权限对象，如果不存在则返回None + """ + return await session.get(Permission, permission_id) + + @classmethod + async def get_permission_by_name( + cls, session: AsyncSession, name: str + ) -> Optional[Permission]: + """ + 根据名称获取权限 + + :param session: 数据库会话对象 + :param name: 权限名称 + :return: 权限对象，如果不存在则返回None + """ + result = await session.execute( + select(Permission).where(Permission.name == name) + ) + return result.scalar_one_or_none() + + @classmethod + async def assign_permission_to_role( + cls, session: AsyncSession, role_id: int, permission_id: int + ) -> RolePermission: + """ + 将权限分配给角色 + + :param session: 数据库会话对象 + :param role_id: 角色ID + :param permission_id: 权限ID + :return: 创建的角色权限关联对象 + """ + role_permission = RolePermission(role_id=role_id, permission_id=permission_id) + session.add(role_permission) + await session.commit() + await session.refresh(role_permission) + return role_permission + + @classmethod + async def assign_permission_to_user( + cls, + session: AsyncSession, + user_id: UUID, + permission_id: int, + ) -> User: + """ + 将权限分配给用户 + + 如果用户没有专属角色，则会为用户创建一个专属角色，然后将权限分配给该角色 + + :param session: 数据库会话对象 + :param user_id: 用户UUID + :param permission_id: 权限ID + :return: 更新后的用户对象 + :raises HTTPException: 当权限或用户不存在时抛出404错误，当角色或权限ID无效时抛出500错误 + """ + # 验证权限是否存在 + permission = await cls.get_permission_by_id(session, permission_id) + if not permission: + raise HTTPException(status_code=404, detail="Permission not found") + + # 验证用户是否存在 + user = await UserService.get_user_by_id(user_id, session) + if user is None: + raise HTTPException(status_code=404, detail="用户不存在") + + # 获取或创建用户的专属角色 + role = await RoleService.get_role_by_name(session, str(user_id)) + if role is None: + role = await RoleService.create_role( + session, str(user_id), is_only_user=True + ) + + # 验证角色和权限ID的有效性 + if role.id is None: + raise HTTPException(status_code=500, detail="角色ID无效") + if permission.id is None: + raise HTTPException(status_code=500, detail="权限ID无效") + + # 将权限分配给角色 + await cls.assign_permission_to_role(session, role.id, permission.id) + user.roles.append(role) + await session.commit() + await session.refresh(user) + return user + + @classmethod + async def unbind_permission_from_role( + cls, session: AsyncSession, role_id: int, permission_id: int + ) -> Role: + """ + 从角色中解除权限绑定 + + :param session: 数据库会话对象 + :param role_id: 角色ID + :param permission_id: 权限ID + :return: 更新后的角色对象 + :raises HTTPException: 当角色不存在时抛出404错误 + """ + # 验证角色是否存在 + role = await RoleService.get_role_by_id(session, role_id) + if role is None: + raise HTTPException(status_code=404, detail="Role not found") + + # 从角色的权限列表中移除指定权限 + role.permissions = [p for p in role.permissions if p.id != permission_id] + await session.commit() + await session.refresh(role) + return role + + @classmethod + async def unbind_permission_from_user( + cls, session: AsyncSession, user_id: UUID, permission_id: int + ): + """ + 从用户中解除权限绑定 + + 通过找到用户的专属角色，从该角色中移除指定权限 + + :param session: 数据库会话对象 + :param user_id: 用户UUID + :param permission_id: 权限ID + :raises HTTPException: 当用户或角色不存在时抛出404错误 + """ + # 验证用户是否存在 + user = await UserService.get_user_by_id(user_id, session) + if not user: + raise HTTPException(status_code=404, detail="User not found") + + # 获取用户的专属角色 + role = await RoleService.get_role_by_name(session, str(user.id)) + if role is None: + raise HTTPException(status_code=404, detail="Role not found") + + # 从角色权限列表中移除指定权限 + role.permissions = [ + permission + for permission in role.permissions + if permission.id != permission_id + ] + await session.commit() + await session.refresh(role) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/role.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/role.py new file mode 100644 index 0000000..0bb6aad --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/role.py @@ -0,0 +1,187 @@ +from typing import Optional +from uuid import UUID + +from fastapi import HTTPException +from sqlalchemy.ext.asyncio import AsyncSession +from sqlmodel import select + +from ..model import Role, RoleUpdate, UserRole +from ..service.user import UserService + + +class RoleService: + """角色服务类，提供角色管理相关的业务逻辑""" + + @staticmethod + async def create_role( + session: AsyncSession, + name: str, + description: Optional[str] = None, + is_only_user: bool = False, + ) -> Role: + """ + 创建新角色 + + Args: + session: 数据库会话对象 + name: 角色名称 + description: 角色描述，可选 + is_only_user: 是否仅用于用户，默认为False + + Returns: + Role: 创建成功的角色对象 + """ + role = Role(name=name, description=description, is_only_user=is_only_user) + session.add(role) + await session.commit() + await session.refresh(role) + + return role + + @staticmethod + async def assign_role_to_user( + session: AsyncSession, + user_id: UUID, + role_id: int, + ): + """ + 为用户分配角色 + + Args: + session: 数据库会话对象 + user_id: 用户UUID + role_id: 角色ID + """ + user_role = UserRole(user_id=user_id, role_id=role_id) + session.add(user_role) + await session.commit() + await session.refresh(user_role) + + @classmethod + async def get_role_by_name(cls, session: AsyncSession, name: str) -> Optional[Role]: + """ + 根据角色名称查询角色 + + Args: + session: 数据库会话对象 + name: 角色名称 + + Returns: + Optional[Role]: 找到的角色对象，未找到则返回None + """ + result = await session.execute(select(Role).where(Role.name == name)) + return result.scalar_one_or_none() + + @classmethod + async def get_role_by_id( + cls, session: AsyncSession, role_id: int + ) -> Optional[Role]: + """ + 根据角色ID查询角色 + + Args: + session: 数据库会话对象 + role_id: 角色ID + + Returns: + Optional[Role]: 找到的角色对象，未找到则返回None + """ + result = await session.get(Role, role_id) + return result + + @staticmethod + async def unbind_role_from_user( + session: AsyncSession, + user_id: UUID, + role_id: int, + ): + """ + 从用户解绑角色 + + Args: + session: 数据库会话对象 + user_id: 用户UUID + role_id: 角色ID + + Returns: + User: 更新后的用户对象 + + Raises: + HTTPException: 当用户不存在时抛出404错误 + """ + user = await UserService.get_user_by_id(user_id, session) + if user is None: + raise HTTPException(status_code=404, detail="User not found") + + # 过滤掉指定角色，保留其他角色 + user.roles = [role for role in user.roles if role.id != role_id] + await session.commit() + await session.refresh(user) + return user + + @staticmethod + async def delete_role( + role_id: int, + session: AsyncSession, + ) -> bool: + """ + 删除角色 + + Args: + role_id: 角色ID + session: 数据库会话对象 + + Returns: + bool: 删除成功返回True + + Raises: + HTTPException: 当角色被使用时抛出400错误，角色不存在时抛出404错误 + """ + # 检查角色是否被用户使用 + result = await session.execute( + select(UserRole).where(UserRole.role_id == role_id) + ) + if result.scalars().all(): + raise HTTPException(status_code=400, detail="Role is not empty") + + role = await RoleService.get_role_by_id(session, role_id) + if role is None: + raise HTTPException(status_code=404, detail="Role not found") + + await session.delete(role) + await session.commit() + return True + + @classmethod + async def update_role( + cls, + role_id: int, + role_update: RoleUpdate, + session: AsyncSession, + ) -> Optional[Role]: + """ + 更新角色信息 + + Args: + role_id: 角色ID + role_update: 角色更新数据对象 + session: 数据库会话对象 + + Returns: + Optional[Role]: 更新后的角色对象 + + Raises: + HTTPException: 当角色不存在时抛出404错误 + """ + role = await cls.get_role_by_id(session, role_id) + if role is None: + raise HTTPException(status_code=404, detail="Role not found") + + # 只更新提供的字段，保持原有值不变 + role.name = role_update.name if role_update.name else role.name + role.description = ( + role_update.description if role_update.description else role.description + ) + await session.commit() + await session.refresh(role) + return role diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/todo.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/todo.py index 18a29a5..d88fc38 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/todo.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/todo.py @@ -7,8 +7,20 @@ from ..model.todo import TodoCreate, Todo, TodoUpdate class TodoService: + """待办事项服务类，提供待办事项的增删改查操作""" + @staticmethod async def create_todo(todo: TodoCreate, session: AsyncSession) -> Todo: + """ + 创建新的待办事项 + + Args: + todo: 待办事项创建数据对象，包含待办事项的初始信息 + session: 异步数据库会话对象，用于执行数据库操作 + + Returns: + Todo: 创建成功后的待办事项对象，包含生成的ID等信息 + """ db_todo = Todo.model_validate(todo) session.add(db_todo) await session.commit() @@ -21,6 +33,17 @@ class TodoService: limit: int, session: AsyncSession, ) -> Sequence[Todo]: + """ + 获取待办事项列表（支持分页） + + Args: + offset: 查询偏移量，指定从第几条记录开始查询 + limit: 查询限制数量，指定最多返回多少条记录 + session: 异步数据库会话对象，用于执行数据库操作 + + Returns: + Sequence[Todo]: 待办事项对象列表，按查询条件返回的结果集 + """ result = await session.execute(select(Todo).offset(offset).limit(limit)) todos = result.scalars().all() return todos @@ -30,6 +53,16 @@ class TodoService: todo_id: int, session: AsyncSession, ) -> Optional[Todo]: + """ + 根据ID获取单个待办事项 + + Args: + todo_id: 待办事项的唯一标识ID + session: 异步数据库会话对象，用于执行数据库操作 + + Returns: + Optional[Todo]: 如果找到则返回待办事项对象，否则返回None + """ todo = await session.get(Todo, todo_id) return todo @@ -39,9 +72,22 @@ class TodoService: todo_update: TodoUpdate, session: AsyncSession, ) -> Optional[Todo]: + """ + 更新待办事项信息 + + Args: + todo_id: 待办事项的唯一标识ID + todo_update: 待办事项更新数据对象，包含需要更新的字段信息 + session: 异步数据库会话对象，用于执行数据库操作 + + Returns: + Optional[Todo]: 如果更新成功则返回更新后的待办事项对象，如果待办事项不存在则返回None + """ todo = await session.get(Todo, todo_id) if not todo: return None + + # 提取需要更新的字段数据，排除未设置的字段 update_data = todo_update.model_dump(exclude_unset=True) for key, value in update_data.items(): @@ -57,6 +103,16 @@ class TodoService: todo_id: int, session: AsyncSession, ) -> bool: + """ + 删除待办事项 + + Args: + todo_id: 待办事项的唯一标识ID + session: 异步数据库会话对象，用于执行数据库操作 + + Returns: + bool: 如果删除成功返回True，如果待办事项不存在返回False + """ todo = await session.get(Todo, todo_id) if not todo: return False diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/uploads.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/uploads.py new file mode 100644 index 0000000..2b9727c --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/uploads.py @@ -0,0 +1,81 @@ +import os +import uuid +from pathlib import Path + +from fastapi.exceptions import HTTPException +from fastapi import UploadFile +import aiofiles + +from ..core.config import get_config + +config = get_config() + + +class UploadService: + """ + 文件上传服务类 + + 提供文件上传功能，支持将上传的文件保存到指定目录， + 并生成唯一的文件名以避免冲突。 + """ + + def __init__(self, upload_dir: str, chunk_size: int, file_type: str): + """ + 初始化上传服务 + + Args: + upload_dir: 文件上传的根目录路径 + chunk_size: 文件读取的块大小（字节），用于控制内存使用 + file_type: 文件类型标识，用于创建对应的子目录 + """ + self.upload_dir = upload_dir + self.file_type = file_type + self.chunk_size = chunk_size + UPLOAD_DIR = Path(f"{self.upload_dir}/{self.file_type}") + UPLOAD_DIR.mkdir(parents=True, exist_ok=True) + + async def upload(self, file_data: UploadFile): + """ + 异步上传文件 + + 接收上传的文件数据，生成唯一文件名，并将文件分块写入到服务器磁盘。 + 上传成功后返回文件的访问URL和新文件名。 + + Args: + file_data: FastAPI的UploadFile对象，包含上传的文件数据和元信息 + + Returns: + tuple: 包含两个元素的元组 + - str: 文件的完整访问URL路径 + - str: 生成的新文件名（UUID + 原始扩展名） + + Raises: + HTTPException: + - 400: 当文件名为空或无效时抛出 + - 500: 当文件写入过程中发生异常时抛出 + """ + if file_data.filename is None: + raise HTTPException(status_code=400, detail="Invalid file name") + + # 提取文件扩展名并生成唯一的UUID文件名 + ext = os.path.splitext(file_data.filename)[1].lower() + new_filename = f"{uuid.uuid4().hex}{ext}" + file_path = os.path.join(self.upload_dir, self.file_type, new_filename) + + try: + # 分块读取上传文件并异步写入磁盘，避免大文件占用过多内存 + async with aiofiles.open(file_path, "wb") as out_file: + while chunk := await file_data.read(self.chunk_size): + await out_file.write(chunk) + except Exception as e: + raise HTTPException(status_code=500, detail=str(e)) + finally: + await file_data.close() + + # 构建并返回文件的访问URL和新文件名 + return ( + f"{config['default']['prefix']}/{self.file_type}/{new_filename}".replace( + "\\", "/" + ), + new_filename, + ) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/user.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/user.py index e140a78..b751680 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/user.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/service/user.py @@ -1,25 +1,64 @@ +from typing import Optional +from uuid import UUID + from sqlalchemy import select from sqlalchemy.ext.asyncio import AsyncSession -from typing import Optional from ..model.user import User from ..core.security import get_password_hash class UserService: + """用户服务类，提供用户相关的业务逻辑操作""" + @staticmethod async def get_user_by_email(email: str, session: AsyncSession) -> Optional[User]: + """ + 根据邮箱地址查询用户 + + Args: + email: 用户的邮箱地址 + session: 异步数据库会话 + + Returns: + 如果找到则返回用户对象，否则返回None + """ result = await session.execute(select(User).where(User.email == email)) # type: ignore return result.scalar_one_or_none() @staticmethod - async def get_user_by_id(user_id: int, session: AsyncSession) -> Optional[User]: + async def get_user_by_id(user_id: UUID, session: AsyncSession) -> Optional[User]: + """ + 根据用户ID查询用户 + + Args: + user_id: 用户的UUID标识 + session: 异步数据库会话 + + Returns: + 如果找到则返回用户对象，否则返回None + """ return await session.get(User, user_id) @staticmethod async def create_user( session: AsyncSession, email: str, password: str, **kwargs ) -> User: + """ + 创建新用户 + + Args: + session: 异步数据库会话 + email: 用户的邮箱地址 + password: 用户的明文密码，将自动进行哈希加密 + **kwargs: 其他用户属性参数 + + Returns: + 创建成功的用户对象 + + Raises: + IntegrityError: 当邮箱已存在时可能抛出完整性错误 + """ hashed = get_password_hash(password) user = User(email=email, hashed_password=hashed, **kwargs) session.add(user) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/task/__init__.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/task/__init__.py new file mode 100644 index 0000000..f975158 --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/task/__init__.py @@ -0,0 +1,31 @@ +from ..core.config import get_config +from .dev_init_db import init_db + +from plugins.scheduler.scheduler import TaskService + +config = get_config() + + +async def init_tasks_callback(task_service: TaskService): + """ + 初始化任务回调函数 + + 在开发环境下自动添加数据库初始化定时任务。 + + Args: + task_service (TaskService): 任务服务实例，用于管理和调度定时任务 + + Returns: + None: 此函数不返回任何值 + + Note: + 仅在开发环境（env == "development"）下执行数据库初始化任务 + """ + if config["default"]["env"] == "development": + + await task_service.add_date_job( + init_db, + run_date=None, + args=[], + job_id="task_name", + ) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/task/dev_init_db.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/task/dev_init_db.py new file mode 100644 index 0000000..4a86f0e --- /dev/null +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/app/task/dev_init_db.py @@ -0,0 +1,92 @@ +from ..core.logger import get_logger +from ..core.constant import PermissionConstant +from ..service.user import UserService +from ..service.permission import PermissionService + +from plugins.scheduler.scheduler import get_task_service_instance + +logger = get_logger("scheduler") + + +async def dev_init_admin(session): + """ + 初始化系统管理员用户 + + 检查是否存在邮箱为"admin"的管理员用户，如果不存在则创建一个新的超级管理员账户。 + 该函数用于系统首次部署时的管理员账户初始化。 + + Args: + session: 数据库会话对象，用于执行数据库操作 + + Returns: + None + + Note: + - 默认管理员邮箱和密码均为"admin" + - 如果管理员已存在，则跳过创建并记录日志 + - 新创建的用户具有超级管理员权限（is_superuser=True） + """ + admin_user = await UserService.get_user_by_email("admin", session) + if admin_user: # type: ignore + logger.info("管理员用户已存在") # type: ignore + return + await UserService.create_user(session, "admin", "admin", is_superuser=True) # type: ignore + + +async def init_permission(session): + """ + 初始化系统权限数据 + + 遍历所有预定义的权限常量，检查数据库中是否已存在对应权限记录。 + 对于不存在的权限，创建新的权限记录并关联对应的资源和操作类型。 + + Args: + session: 数据库会话对象，用于执行数据库操作 + + Returns: + None + + Note: + - 权限格式为"resource:action"，例如"user:create" + - 使用冒号分隔资源和操作，如果缺少操作部分则默认为空字符串 + - 已存在的权限会被跳过，避免重复创建 + - 每个新创建的权限都会记录到日志中 + """ + for permission in PermissionConstant.get_all(): + parts = permission.split(":", 1) + resource = parts[0] + action = parts[1] if len(parts) > 1 else "" + + existing_permission = await PermissionService.get_permission_by_name( + session, permission + ) + if existing_permission: + logger.debug(f"权限已存在: {permission}") + continue + + await PermissionService.create_permission(session, permission, resource, action) + logger.info(f"创建权限: {permission}") + + +async def init_db(): + """ + 执行数据库初始化流程 + + 协调执行所有数据库初始化任务，包括管理员账户创建和权限数据初始化。 + 该函数是系统启动时数据库初始化的入口点。 + + Returns: + None + + Note: + - 通过任务服务获取异步会话工厂 + - 如果会话工厂未初始化，则直接返回不执行任何操作 + - 按顺序执行：先初始化管理员，再初始化权限 + - 使用异步上下文管理器确保会话正确关闭 + """ + task_service = get_task_service_instance() + if task_service.async_session_maker is None: + return + async with task_service.async_session_maker() as session: + await dev_init_admin(session) + await init_permission(session) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/scripts/build.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/scripts/build.py index bcbfdab..a952fb3 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/scripts/build.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/scripts/build.py @@ -1,54 +1,93 @@ -from module_bank import PythonToSQLite -from module_bank.encryption import Encryption import os -from pathlib import Path +import platform import shutil import subprocess import sys import asyncio +from pathlib import Path + +from module_bank import PythonToSQLite +from module_bank.encryption import Encryption +from sqlite_vfs.core import SQLiteVFS +from sqlite_vfs.folder_packer import FolderPacker + +is_windows = platform.system() == "Windows" -def create_admin(): - try: - cmd = [ - sys.executable, - "../src/{{ cookiecutter.project_name }}/scripts/create_admin.py", - ] - print(f"正在运行 create_admin.py: {' '.join(cmd)}") +def build_vue_web(): + """ + 打包 Vue Web 前端项目 - # 创建包含 UTF-8 编码的环境变量 - env = os.environ.copy() - env["PYTHONIOENCODING"] = "utf-8" - env["PYTHONUTF8"] = "1" + 该函数执行以下操作: + 1. 运行 npm build 命令构建 Vue 项目 + 2. 将构建产物打包到 SQLite VFS 虚拟文件系统中 - result = subprocess.run( - cmd, - cwd="./build", - capture_output=True, - text=True, - encoding="utf-8", # 明确指定编码 - errors="replace", # 替换无法解码的字符 - env=env, # 传递修改后的环境变量 - ) - - if result.returncode == 0: - print("创建管理员用户成功") + Returns: + None: 无返回值,通过打印信息反馈执行结果 + """ + # 构建 Vue Web 命令 + dist_dir = "./src/{{ cookiecutter.project_name }}-web/dist" + output_db = "./build/static.svfs" + fs_name = "frontend" + cmd = [ + "npm", + "run", + "build", + ] + result = subprocess.run( + cmd, + cwd="./src/{{ cookiecutter.project_name }}-web", + capture_output=True, + text=True, + shell=is_windows, + encoding="utf-8", + errors="replace", + ) + if result.returncode != 0: + print("打包 Vue Web 失败") + print("标准输出:", result.stdout) + print("错误输出:", result.stderr) + return + else: + print("Vue Web 打包成功") + if result.stdout: print(result.stdout) - else: - print("创建管理员用户失败") - # 安全地打印错误信息，避免编码问题 - try: - print("错误信息:", result.stderr) - except UnicodeEncodeError: - print( - "错误信息:", result.stderr.encode("ascii", "ignore").decode("ascii") - ) - except Exception as e: - print("创建管理员用户失败") - print(f"异常: {e}") + + # 检查 dist 目录是否存在 + if not os.path.exists(dist_dir): + print(f"错误: dist 目录不存在: {dist_dir}") + return + + vfs = SQLiteVFS(output_db, compress=False) + packer = FolderPacker( + sqlite_vfs=vfs, + exclude_patterns=[], + fs_name=fs_name, + ) + + try: + packer.pack_folder(dist_dir) + print(f"✅ 打包完成,文件保存为 {output_db}") + finally: + vfs.close() def run_pyarmor_obfuscate(): + """ + 使用 PyArmor 对关键 Python 文件进行代码混淆 + + 该函数遍历预定义的文件列表,对每个文件执行 pyarmor gen 命令进行混淆处理, + 以保护源代码不被轻易反编译。 + + 处理的文件包括: + - main.py (主入口文件) + - server.py (服务器文件) + - utils/launch.py (启动工具) + - utils/config.py (配置工具) + + Returns: + None: 无返回值,遇到错误时提前返回 + """ # pyarmor obfuscate --output=obfuscated_script.py original_script.py obfuscate_files = [ ("main.py", "./"), @@ -74,92 +113,207 @@ def run_pyarmor_obfuscate(): def run_pyinstaller(): - """运行 PyInstaller 打包成可执行文件""" + """ + 使用 PyInstaller 将应用打包成单文件可执行程序 + + 该函数根据操作系统平台(Windows/非Windows)构建不同的 PyInstaller 命令, + 包含所有必要的隐藏导入以确保依赖库被正确打包。 + + Windows 和非 Windows 平台的主要区别: + - 非 Windows 平台额外包含 gunicorn 相关模块 + + Returns: + None: 无返回值,通过打印信息反馈执行结果 + """ try: # 构建 PyInstaller 命令 - cmd = [ - sys.executable, - "-m", - "PyInstaller", - "--onefile", - "--name", - "{{ cookiecutter.project_name }}", - "--distpath", - ".", - "--workpath", - "./build_temp", - "--specpath", - "./specs", - "--clean", - # 隐藏导入 - "--hidden-import", - "utils", - "--hidden-import", - "utils.launch", - "--hidden-import", - "utils.config", - "--hidden-import", - "server", - "--hidden-import", - "module_bank", - "--hidden-import", - "fastapi", - "--hidden-import", - "fastapi.middleware.cors", - "--hidden-import", - "uvicorn", - "--hidden-import", - "sqlmodel", - "--hidden-import", - "aiosqlite", - "--hidden-import", - "pyjwt", - "--hidden-import", - "sqlitedict", - "--hidden-import", - "passlib", - "--hidden-import", - "passlib.context", - "--hidden-import", - "passlib.handlers.bcrypt", - "--hidden-import", - "jwt", - # 其他选项 - "--icon", - "../../public/{{ cookiecutter.project_name }}.ico", - "main.py", - ] + if is_windows: + cmd = [ + sys.executable, + "-m", + "PyInstaller", + "--onefile", + "--noconfirm", + "--optimize", + "2", + "--strip", + "--name", + "{{ cookiecutter.project_name }}", + "--distpath", + ".", + "--workpath", + "./build_temp", + "--specpath", + "./specs", + "--clean", + # 隐藏导入 + "--hidden-import", + "utils", + "--hidden-import", + "utils.launch", + "--hidden-import", + "utils.config", + "--hidden-import", + "server", + "--hidden-import", + "module_bank", + "--hidden-import", + "fastapi", + "--hidden-import", + "fastapi.staticfiles", + "--hidden-import", + "fastapi.middleware.cors", + "--hidden-import", + "uvicorn", + "--hidden-import", + "sqlmodel", + "--hidden-import", + "aiosqlite", + "--hidden-import", + "aiofiles", + "--hidden-import", + "apscheduler", + "--hidden-import", + "diskcache", + "--hidden-import", + "bcrypt", + "--hidden-import", + "sqlite_vfs", + "--hidden-import", + "python_multipart", + "--hidden-import", + "sqlite_vfs.core", + "--hidden-import", + "jwt", + # 其他选项 + "--icon", + "../../public/{{ cookiecutter.project_name }}.ico", + "main.py", + ] + else: + cmd = [ + sys.executable, + "-m", + "PyInstaller", + "--onefile", + "--noconfirm", + "--optimize", + "2", + "--strip", + "--name", + "{{ cookiecutter.project_name }}", + "--distpath", + ".", + "--workpath", + "./build_temp", + "--specpath", + "./specs", + "--clean", + # 隐藏导入 + "--hidden-import", + "utils", + "--hidden-import", + "utils.launch", + "--hidden-import", + "utils.config", + "--hidden-import", + "server", + "--hidden-import", + "module_bank", + "--hidden-import", + "fastapi", + "--hidden-import", + "fastapi.staticfiles", + "--hidden-import", + "fastapi.middleware.cors", + "--hidden-import", + "uvicorn", + "--hidden-import", + "sqlmodel", + "--hidden-import", + "aiosqlite", + "--hidden-import", + "aiofiles", + "--hidden-import", + "apscheduler", + "--hidden-import", + "diskcache", + "--hidden-import", + "bcrypt", + "--hidden-import", + "sqlite_vfs", + "--hidden-import", + "python_multipart", + "--hidden-import", + "sqlite_vfs.core", + "--hidden-import", + "jwt", + # gunicorn + "--hidden-import", + "gunicorn.glogging", + "--hidden-import", + "gunicorn.app", + "--hidden-import", + "gunicorn.app.wsgiapp", + # 其他选项 + "--icon", + "../../public/{{ cookiecutter.project_name }}.ico", + "main.py", + ] print(f"正在运行 PyInstaller: {' '.join(cmd)}") result = subprocess.run(cmd, cwd="./build", capture_output=True, text=True) if result.returncode == 0: - print("PyInstaller 打包成功！") + print("PyInstaller 打包成功!") print(result.stdout) else: - print("PyInstaller 打包失败！") + print("PyInstaller 打包失败!") print("错误信息:", result.stderr) except FileNotFoundError: - print("错误：未找到 PyInstaller，请先安装 PyInstaller：pip install pyinstaller") + print("错误:未找到 PyInstaller,请先安装 PyInstaller:pip install pyinstaller") except Exception as e: print(f"PyInstaller 执行出错: {e}") async def init_database(): + """ + 异步初始化数据库 + + 该函数执行以下操作: + 1. 从配置中读取数据库连接信息 + 2. 创建异步数据库引擎和会话工厂 + 3. 设置 SQLite 优化参数(WAL 模式和同步策略) + 4. 创建所有 SQLModel 定义的数据库表 + 5. 初始化权限系统和默认管理员账户 + + Raises: + ValueError: 当数据库配置不存在时抛出 + OperationalError: 当数据库操作出现异常时抛出(已存在表的情况除外) + + Returns: + None: 无返回值 + """ from sqlalchemy.ext.asyncio import create_async_engine - from ..app.core.config import get_config from sqlmodel import SQLModel, text from sqlalchemy.exc import OperationalError + from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker + + from ..app.core.config import get_config + from ..app.task.dev_init_db import init_permission, dev_init_admin database = get_config()["database"] database_type = database["type"] database_config = database.get(database_type, None) if database_config is None: raise ValueError("配置不存在") - + os.makedirs("./build/data", exist_ok=True) engine = create_async_engine( - "sqlite+aiosqlite:///./build/database.db", **database_config + "sqlite+aiosqlite:///./build/data/database.db", **database_config + ) + async_session_maker = async_sessionmaker( + engine, class_=AsyncSession, expire_on_commit=False ) async with engine.begin() as conn: @@ -170,12 +324,35 @@ async def init_database(): await conn.run_sync( lambda conn: SQLModel.metadata.create_all(bind=conn, checkfirst=True) ) + except OperationalError as e: if "already exists" in str(e): raise + # 添加管理员用户 + async with async_session_maker() as session: + # await UserService.create_user(session, "admin", "admin", is_superuser=True) # type: ignore + await init_permission(session) + await dev_init_admin(session) async def main(): + """ + 主构建流程函数 + + 该函数协调整个应用的构建过程,按顺序执行以下步骤: + 1. 加密打包 Python 模块(app 和 plugins)到 SQLite 数据库文件 + 2. 创建并准备 build 目录结构 + 3. 复制必要的源文件和配置文件到 build 目录 + 4. 注入动态生成的加密密钥到配置文件 + 5. 对关键文件进行代码混淆 + 6. 使用 PyInstaller 打包成可执行文件 + 7. 清理临时构建文件 + 8. 初始化数据库 + 9. 构建 Vue 前端项目 + + Returns: + None: 无返回值 + """ # 打包模块 key = Encryption.generate_key() resources_path = Path("resources") @@ -228,6 +405,13 @@ async def main(): with open("./build/utils/launch.py", "w", encoding="utf-8") as f: f.write(context) + jwt_key = Encryption.generate_key() + with open("./build/config.toml", "r", encoding="utf-8") as f: + context = f.read() + context = context.replace("your-secret-key-change-in-production", jwt_key) + with open("build/config.toml", "w", encoding="utf-8") as f: + f.write(context) + # 混淆 run_pyarmor_obfuscate() @@ -241,13 +425,23 @@ async def main(): shutil.rmtree(r"build/pyarmor_runtime_000000", ignore_errors=True) os.remove(r"build/main.py") os.remove(r"build/server.py") - # os.remove(r"build/config.toml") print("构建完成") # 初始化数据库 await init_database() + # 构建 vue 项目 + build_vue_web() + def build(): + """ + 构建入口函数 + + 该函数作为整个构建流程的入口点,通过 asyncio.run() 启动异步主构建流程。 + + Returns: + None: 无返回值 + """ asyncio.run(main()) diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/scripts/clean_pycache.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/scripts/clean_pycache.py index 070343f..d402b80 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/scripts/clean_pycache.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/scripts/clean_pycache.py @@ -1,5 +1,6 @@ import os import shutil + # 需要遍历的目录 root_dir = "./" # 遍历目录 diff --git a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/scripts/code_content.py b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/scripts/code_content.py index fea6ecb..164f79d 100644 --- a/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/scripts/code_content.py +++ b/{{ cookiecutter.project_name }}/src/{{ cookiecutter.project_name }}/scripts/code_content.py @@ -8,20 +8,28 @@ def generate_markdown_from_py_files(directory, output_file): # 排除 venv 目录 dirs[:] = [d for d in dirs if d != ".venv"] dirs[:] = [d for d in dirs if d != ".vscode"] - # dirs[:] = [d for d in dirs if d != "scripts"] + dirs[:] = [d for d in dirs if d != "node_modules"] dirs[:] = [d for d in dirs if d != "build"] + dirs[:] = [d for d in dirs if d != "dist"] for file in files: if ( file.endswith(".py") or file.endswith(".rs") or file.endswith(".toml") or file.endswith(".md") + or file.endswith(".css") + or file.endswith(".vue") + or file.endswith(".ts") + or file.endswith(".json") + or file.endswith(".html") + or file.endswith(".sh") + or file == "Dockerfile" ): file_path = os.path.join(root, file) - if file == "output.md": + if file == "output.md" or file == "package-lock.json": continue md_file.write(f"`{file_path}`\n") - md_file.write("```python\n") + md_file.write("```\n") with open(file_path, "r", encoding="utf-8") as py_file: md_file.write(py_file.read()) md_file.write("\n```\n\n")