update docs

Author: wu-clan

docs/.vuepress/bulletin.ts

@@ -1,19 +1,40 @@
 import { BulletinOptions } from "vuepress-theme-plume";
 
 export const myBulletin: BulletinOptions = {
+    layout: 'center',
+    border: true,
     enablePage: true,
-    lifetime: 'session',
+    lifetime: 'always',
     contentType: 'markdown',
     title: '公告',
     content: `\
-v1.7.0 已发布！🤗
+::: center
+📣📣📣 号外号外 📣📣📣
+:::
 
-此版本我们为大家带来了史诗级新功能
+我们正在为 ==v1.8.0=={.tip} 做最后的准备，为后端响应信息提供 ==i18n=={.important} 支持
 
-**celery 动态定时任务**
+此功能向后兼容并已准备就绪：[PR #753](https://github.com/fastapi-practices/fastapi_best_architecture/pull/753) 
 
----
+::: chat title="群聊"
+{:2025-08-14 22:53:00}
 
-您现在可以通过 【导航栏 -> 前端（在线体验）-> 线上演示】 获取全新页面预览
+{.}
+i18n ==PR== 已经准备好了，如果没有问题，让我们合并它
+
+{downdawn}
+这个改版有点大，我们是否要考虑一下做分支，或者发起投票征求一下意见
+
+{.}
+这个 PR 目前是向后兼容的，理论上没有什么问题，我的想法是在本周的 v1.8.0 版本中提供，稍后我在 discord 上面发个投票看看
+
+{.}
+我们暂时先不要合并，等待社区反馈结果
+
+{.}
+==欢迎参与=={.important}：[投票链接](https://discord.com/channels/1185035164577972344/1322545989239832617/1405572816363065536)
+:::
+
+这是一个重大变更，非常期待大家的参与 🤗🤗🤗
 `,
 }

docs/.vuepress/sidebar.ts

@@ -34,15 +34,16 @@ export const mySidebar: ThemeSidebarMulti = {
                 { text: 'Schema', link: 'schema' },
                 { text: '路由', link: 'router' },
                 { text: 'CRUD', link: 'CRUD' },
-                { text: '接口响应', link: 'response' },
                 { text: '分页', link: 'pagination' },
-                { text: '自定义异常', link: '/planet', badge: { text: '专业版', type: 'warning' } },
-                { text: '节流', link: 'limit' },
+                { text: '接口响应', link: 'response' },
+                { text: '国际化', link: 'i18n', badge: 'NEW' },
                 { text: 'JWT', link: 'jwt' },
                 { text: 'RBAC', link: 'RBAC' },
                 { text: 'OAuth 2.0', link: 'oauth2' },
+                { text: '自定义异常', link: '/planet', badge: { text: '专业版', type: 'warning' } },
+                { text: '节流', link: 'limit' },
                 { text: '跨域', link: 'CORS' },
-                { text: '事务', link: 'transaction' },
+                { text: 'SQLA 事务', link: 'transaction' },
                 { text: '切换主键', link: 'pk' },
                 { text: '切换数据库', link: 'db' },
                 { text: '数据权限', link: '/planet', badge: { text: '专业版', type: 'warning' } },

docs/.vuepress/styles/custom.css

@@ -1,6 +1,4 @@
 :root {
-    /* 公告宽度 */
-    --vp-bulletin-width: 350px;
     /* 链接颜色、强调色 */
     --vp-c-brand-1: rgba(0, 148, 133, 1);
     /* 链接、按钮 hover 颜色 */
@@ -32,6 +30,11 @@
     }
 }
 
+/* 公告板 */
+.vp-bulletin {
+    width: 30%
+}
+
 /* 首页文字说明 */
 .hero-text {
     margin: 24px 0 40px !important;

docs/.vuepress/theme.ts

@@ -44,6 +44,7 @@ export const myTheme: Theme = plumeTheme({
     markdown: {
         abbr: true,
         annotation: true,
+        chat: true,
         mermaid: true,
     },
     codeHighlighter: {

docs/backend/reference/i18n.md

@@ -0,0 +1,28 @@
+---
+title: 国际化
+---
+
+::: center
+
+<h2>此功能正在投票中</h2>
+
+:::
+
+::: chat title="群聊"
+{:2025-08-14 22:53:00}
+
+{.}
+i18n ==PR== 已经准备好了，如果没有问题，让我们合并它
+
+{downdawn}
+这个改版有点大，我们是否要考虑一下做分支，或者发起投票征求一下意见
+
+{.}
+这个 PR 目前是向后兼容的，理论上没有什么问题，我的想法是在本周的 v1.8.0 版本中提供，稍后我在 discord 上面发个投票看看
+
+{.}
+我们暂时先不要合并，等待社区反馈结果
+
+{.}
+==欢迎参与=={.important}：[投票链接](https://discord.com/channels/1185035164577972344/1322545989239832617/1405572816363065536)
+:::

docs/backend/reference/transaction.md

@@ -1,5 +1,5 @@
 ---
-title: 事务
+title: SQLA 事务
 ---
 
 默认情况下，如果将数据库引擎参数 `echo` 设置为 True，你将会看到事务总是被开启，即便那是一个查询语句。但这并不是因为我们错误的使用了