update docs

Author: wu-clan

docs/.vuepress/bulletin.ts

@@ -1,40 +1,27 @@
 import { BulletinOptions } from "vuepress-theme-plume";
 
 export const myBulletin: BulletinOptions = {
-    layout: 'center',
+    // layout: 'center',
     border: true,
     enablePage: true,
     lifetime: 'session',
     contentType: 'markdown',
     title: '公告',
     content: `\
 ::: center
-📣📣📣 号外号外 📣📣📣
+🎉 v1.8.0 已发布 🎉
 :::
 
-我们正在为 ==v1.8.0=={.tip} 做最后的准备，为后端响应信息提供 ==i18n=={.important} 支持
+此版本为==重大更新=={.warning}，我们为大家带来了：
 
-此功能向后兼容并已准备就绪：[PR #753](https://github.com/fastapi-practices/fastapi_best_architecture/pull/753) 
+- 计划任务分布式锁
+- 身份验证白名单正则表达式配置
+- 优化树节点的数据排序逻辑
+- 通过队列优化 Opera 日志存储逻辑
+- 优化时区日期时间返回编码器
+- 为响应消息添加 i18n 支持
+- ...
 
-::: chat title="群聊"
-{:2025-08-14 22:53:00}
-
-{.}
-i18n ==PR== 已经准备好了，如果没有问题，让我们合并它
-
-{downdawn}
-这个改版有点大，我们是否要考虑一下做分支，或者发起投票征求一下意见
-
-{.}
-这个 PR 目前是向后兼容的，理论上没有什么问题，我的想法是在本周的 v1.8.0 版本中提供，稍后我在 discord 上面发个投票看看
-
-{.}
-我们暂时先不要合并，等待社区反馈结果
-
-{.}
-==欢迎参与=={.important}：[投票链接](https://discord.com/channels/1185035164577972344/1322545989239832617/1405572816363065536)
-:::
-
-这是一个重大变更，非常期待大家的参与 🤗🤗🤗
+为大家带来以上惊喜的同时，前端实施也在悄悄推进中，==代码生成页面已完成=={.important}，快快[本地部署](https://fastapi-practices.github.io/fastapi_best_architecture_docs/frontend/summary/quick-start.html)尝鲜吧~
 `,
 }

docs/.vuepress/styles/custom.css

@@ -32,7 +32,7 @@
 
 /* 公告板 */
 .vp-bulletin {
-    width: 30%
+    width: 20%
 }
 
 /* 首页文字说明 */

docs/backend/reference/config.md

@@ -4,64 +4,11 @@ title: 配置
 
 配置文件位于 `backend/core/conf.py`，fba 内的所有应用和插件配置都应统一放置在此文件内
 
-## 环境变量配置
+## 环境配置
 
-### `ENVIRONMENT` <Badge type="info" text="Literal['dev', 'pro']" />
+### `ENVIRONMENT` <Badge type="info" text="Literal['dev', 'pro']" /> <Badge type="warning" text="env" />
 
-指定环境模式，仅允许 `dev` 和 `pro`。当设置为 `pro` 时，openapi 相关在线文档将被禁止访问
-
-### `DATABASE_TYPE` <Badge type="info" text="Literal['mysql', 'postgresql']" />
-
-指定数据库类型，仅支持 `mysql` 和 `postgresql`，需注意第三方插件兼容性
-
-### `DATABASE_HOST` <Badge type="info" text="str" />
-
-提供数据库的主机地址
-
-### `DATABASE_PORT` <Badge type="info" text="int" />
-
-提供数据库的主机端口号
-
-### `DATABASE_USER` <Badge type="info" text="str" />
-
-连接数据库所使用的用户名
-
-### `DATABASE_PASSWORD` <Badge type="info" text="str" />
-
-连接数据库所使用的密码
-
-### `REDIS_HOST` <Badge type="info" text="int" />
-
-连接 Redis 数据库的主机地址
-
-### `REDIS_PORT` <Badge type="info" text="str" />
-
-连接 Redis 数据库的主机端口号
-
-### `REDIS_PASSWORD` <Badge type="info" text="int" />
-
-连接 Redis 数据库的密码
-
-### `REDIS_DATABASE` <Badge type="info" text="str" />
-
-全局默认使用的 Redis 逻辑数据库（0 - 15）
-
-### `TOKEN_SECRET_KEY` <Badge type="info" text="str" />
-
-token 生成和解析密钥，用于防止 token 被恶意篡改，密钥生成：`secrets.token_urlsafe(32)`
-
-::: danger
-请妥善保管此值，以免遭受恶意攻击
-:::
-
-### `OPERA_LOG_ENCRYPT_SECRET_KEY` <Badge type="info" text="" />
-
-操作日志加密密钥，当使用对称加密算法加密操作日志时，将十分重要，密钥生成：
-`os.urandom(32).hex()`
-
-::: danger
-请妥善保管此值，以免遭受恶意攻击
-:::
+指定环境模式，当设置为 `pro` 时，openapi 相关在线文档将被禁止访问
 
 ## FastAPI 配置
 
@@ -97,7 +44,27 @@ openapi JSON 数据在线地址
 
 是否开启 FastAPI 静态文件服务
 
-## 数据库基础配置
+## 数据库配置
+
+### `DATABASE_TYPE` <Badge type="info" text="Literal['mysql', 'postgresql']" /> <Badge type="warning" text="env" />
+
+指定数据库类型，仅支持 `mysql` 和 `postgresql`，需注意第三方插件兼容性
+
+### `DATABASE_HOST` <Badge type="info" text="str" /> <Badge type="warning" text="env" />
+
+提供数据库的主机地址
+
+### `DATABASE_PORT` <Badge type="info" text="int" /> <Badge type="warning" text="env" />
+
+提供数据库的主机端口号
+
+### `DATABASE_USER` <Badge type="info" text="str" /> <Badge type="warning" text="env" />
+
+连接数据库所使用的用户名
+
+### `DATABASE_PASSWORD` <Badge type="info" text="str" /> <Badge type="warning" text="env" />
+
+连接数据库所使用的密码
 
 ### `DATABASE_ECHO` <Badge type="info" text="bool | Literal['debug']" />
 
@@ -115,25 +82,49 @@ openapi JSON 数据在线地址
 
 数据库字符集，仅用于 mysql
 
-## Redis 基础配置
+## Redis 配置
 
-### `REDIS_TIMEOUT` <Badge type="info" text="int" />
+### `REDIS_TIMEOUT` <Badge type="info" text="int" /> <Badge type="warning" text="env" />
 
 连接 Redis 数据库超时时长
 
-## Token 基础配置
+### `REDIS_HOST` <Badge type="info" text="int" />
+
+连接 Redis 数据库的主机地址
+
+### `REDIS_PORT` <Badge type="info" text="str" />
+
+连接 Redis 数据库的主机端口号
+
+### `REDIS_PASSWORD` <Badge type="info" text="int" />
+
+连接 Redis 数据库的密码
+
+### `REDIS_DATABASE` <Badge type="info" text="str" />
+
+全局默认使用的 Redis 逻辑数据库（0 - 15）
+
+## Token 配置
+
+### `TOKEN_SECRET_KEY` <Badge type="info" text="str" /> <Badge type="warning" text="env" />
+
+token 生成和解析密钥，用于防止 token 被恶意篡改，密钥生成：`secrets.token_urlsafe(32)`
+
+::: danger
+请妥善保管此值，以免遭受恶意攻击
+:::
 
 ### `TOKEN_ALGORITHM` <Badge type="info" text="str" />
 
 token 加密算法
 
 ### `TOKEN_EXPIRE_SECONDS` <Badge type="info" text="int" />
 
-token 过期秒数
+token 过期时长
 
 ### `TOKEN_REFRESH_EXPIRE_SECONDS` <Badge type="info" text="int" />
 
-刷新 token 过期秒数
+刷新 token 过期时长
 
 ### `TOKEN_REDIS_PREFIX` <Badge type="info" text="str" />
 
@@ -190,7 +181,17 @@ JWT 中间件存储用户信息到 Redis 时的前缀
 
 ### `COOKIE_REFRESH_TOKEN_EXPIRE_SECONDS` <Badge type="info" text="int" />
 
-将刷新 token 存储到 cookie 时的过期时间
+将刷新 token 存储到 cookie 时的过期时长
+
+## 验证码配置
+
+### `CAPTCHA_LOGIN_REDIS_PREFIX` <Badge type="info" text="str" />
+
+验证码登录时，验证码存储到 Redis 时的前缀
+
+### `CAPTCHA_LOGIN_EXPIRE_SECONDS` <Badge type="info" text="int" />
+
+验证码登录时，验证码过期时长
 
 ## 数据权限配置
 
@@ -342,6 +343,15 @@ JWT 中间件存储用户信息到 Redis 时的前缀
 
 ## 操作日志
 
+### `OPERA_LOG_ENCRYPT_SECRET_KEY` <Badge type="info" text="str" /> <Badge type="warning" text="env" />
+
+操作日志加密密钥，当使用对称加密算法加密操作日志时，将十分重要，密钥生成：
+`os.urandom(32).hex()`
+
+::: danger
+请妥善保管此值，以免遭受恶意攻击
+:::
+
 ### `OPERA_LOG_PATH_EXCLUDE` <Badge type="info" text="list[str]" />
 
 操作日志路径排除，在此配置内的请求地址不会记录操作日志
@@ -382,84 +392,94 @@ JWT 中间件存储用户信息到 Redis 时的前缀
 
 插件信息存储到 Redis 时的前缀
 
-## 验证码配置
-
-### `CAPTCHA_LOGIN_REDIS_PREFIX` <Badge type="info" text="str" />
-
-验证码登录时，验证码存储到 Redis 时的前缀
-
-### `CAPTCHA_LOGIN_EXPIRE_SECONDS` <Badge type="info" text="int" />
-
-验证码登录时，验证码过期时间
-
 ## 应用：Task
 
-### 环境变量配置
-
-#### `CELERY_BROKER_REDIS_DATABASE` <Badge type="info" text="int" />
+### `CELERY_BROKER_REDIS_DATABASE` <Badge type="info" text="int" /> <Badge type="warning" text="env" />
 
 Celery 代理使用的 Redis 逻辑数据库
 
-#### `CELERY_RABBITMQ_HOST` <Badge type="info" text="str" />
+### `CELERY_RABBITMQ_HOST` <Badge type="info" text="str" /> <Badge type="warning" text="env" />
 
 Celery 连接 RabbitMQ 服务的主机地址
 
-#### `CELERY_RABBITMQ_PORT` <Badge type="info" text="int" />
+### `CELERY_RABBITMQ_PORT` <Badge type="info" text="int" /> <Badge type="warning" text="env" />
 
 Celery 连接 RabbitMQ 服务的主机端口号
 
-#### `CELERY_RABBITMQ_USERNAME` <Badge type="info" text="str" />
+### `CELERY_RABBITMQ_USERNAME` <Badge type="info" text="str" /> <Badge type="warning" text="env" />
 
 Celery 连接 RabbitMQ 服务的用户名
 
-#### `CELERY_RABBITMQ_PASSWORD` <Badge type="info" text="str" />
+### `CELERY_RABBITMQ_PASSWORD` <Badge type="info" text="str" /> <Badge type="warning" text="env" />
 
 Celery 连接 RabbitMQ 服务的密码
 
-### 基础配置
-
-#### `CELERY_BROKER` <Badge type="info" text="Literal['rabbitmq', 'redis']" />
+### `CELERY_BROKER` <Badge type="info" text="Literal['rabbitmq', 'redis']" />
 
 Celery 代理模式（开发模式默认使用 Redis，线上模式强制切换为 Rabbitmq）
 
-#### `CELERY_REDIS_PREFIX` <Badge type="info" text="str" />
+### `CELERY_REDIS_PREFIX` <Badge type="info" text="str" />
 
 Celery 数据存储到 Redis 时的前缀
 
-#### `CELERY_TASK_MAX_RETRIES` <Badge type="info" text="int" />
+### `CELERY_TASK_MAX_RETRIES` <Badge type="info" text="int" />
 
 Celery 任务执行失败时的最大重试次数
 
-## 插件：OAuth2
+## 插件：Code Generator
 
-### 环境变量配置
+#### `CODE_GENERATOR_DOWNLOAD_ZIP_FILENAME` <Badge type="info" text="str" />
+
+下载代码时的 ZIP 压缩包文件名
 
-#### `OAUTH2_GITHUB_CLIENT_ID` <Badge type="info" text="str" />
+## 插件：OAuth2
+
+### `OAUTH2_GITHUB_CLIENT_ID` <Badge type="info" text="str" /> <Badge type="warning" text="env" />
 
 GitHub 客户端 ID
 
-#### `OAUTH2_GITHUB_CLIENT_SECRET` <Badge type="info" text="str" />
+### `OAUTH2_GITHUB_CLIENT_SECRET` <Badge type="info" text="str" /> <Badge type="warning" text="env" />
 
 GitHub 客户端密钥
 
-#### `OAUTH2_LINUX_DO_CLIENT_ID` <Badge type="info" text="str" />
+### `OAUTH2_LINUX_DO_CLIENT_ID` <Badge type="info" text="str" /> <Badge type="warning" text="env" />
 
 Linux Do 客户端 ID
 
-#### `OAUTH2_LINUX_DO_CLIENT_SECRET` <Badge type="info" text="str" />
+### `OAUTH2_LINUX_DO_CLIENT_SECRET` <Badge type="info" text="str" /> <Badge type="warning" text="env" />
 
 Linux Do 客户端密钥
 
-### 基础配置
-
-#### `OAUTH2_FRONTEND_REDIRECT_URI` <Badge type="info" text="str" />
+### `OAUTH2_FRONTEND_REDIRECT_URI` <Badge type="info" text="str" />
 
 登陆成功后，重定向到前端的地址
 
-## 插件：Code Generator
+## 插件：Email
 
-### 基础配置
+### `EMAIL_USERNAME` <Badge type="info" text="str" />
 
-#### `CODE_GENERATOR_DOWNLOAD_ZIP_FILENAME` <Badge type="info" text="str" />
+电子邮箱发件用户
 
-下载代码时的 ZIP 压缩包文件名
+### `EMAIL_PASSWORD` <Badge type="info" text="str" />
+
+电子邮箱发件用户密码
+
+### `EMAIL_HOST` <Badge type="info" text="str" />
+
+电子邮箱服务主机地址
+
+### `EMAIL_PORT` <Badge type="info" text="int" />
+
+电子邮箱服务主机端口号
+
+### `EMAIL_SSL` <Badge type="info" text="bool" />
+
+发送电子邮件时，是否开启 SSL
+
+### `EMAIL_CAPTCHA_REDIS_PREFIX` <Badge type="info" text="str" />
+
+电子邮件验证码存储到 Redis 时的前缀
+
+### `EMAIL_CAPTCHA_EXPIRE_SECONDS` <Badge type="info" text="int" />
+
+电子邮件验证码缓存时长