update docs

Author: wu-clan

docs/.vuepress/components/Pricing.vue

@@ -103,7 +103,7 @@ import { openSponsorLink } from "../data/sponsors";
 
 .pricing-title {
   text-align: center;
-  margin-bottom: 2.5rem;
+  margin: 3rem 0 2rem;
 }
 
 .pricing-cards {

docs/.vuepress/navbar.ts

@@ -44,7 +44,7 @@ export const myNavbar = defineNavbarConfig([
         ]
     },
     {
-        text: 'v1.4.1',
+        text: 'v1.4.2',
         items: [
             {
                 text: '线上演示',

docs/.vuepress/sidebar.ts

@@ -100,6 +100,14 @@ export const mySidebar: ThemeSidebarMulti = {
                 { text: '介绍', link: 'intro' },
                 { text: '快速开始', link: 'quick-start' },
             ]
+        },
+        {
+            text: '部署',
+            collapsed: false,
+            items: [
+                { text: 'Docker', link: 'docker' },
+                { text: '传统', link: 'legacy' },
+            ]
         }
     ]
 }

docs/README.md

@@ -9,7 +9,7 @@ config:
       text: 基于 FastAPI 框架，前后端分离，遵循「伪三层架构」设计，支持 Python 3.10+ 版本
       actions:
         - theme: brand
-          text: 快速开始 ->
+          text: 快速上手 ->
           link: /backend/summary/intro
         - theme: alt
           text: 伪三层架构?

docs/backend/deploy/Docker.md

@@ -10,6 +10,8 @@ title: Docker 部署
 
 本地部署是为了能够快捷的提供本地 API 服务
 
+### 后端
+
 :::: steps
 
 1. env
@@ -71,6 +73,10 @@ title: Docker 部署
 
 ::::
 
+### 前端
+
+[点击跳转](../../frontend/quick-start.md)
+
 ## 服务器部署
 
 ::: tip
@@ -145,91 +151,7 @@ title: Docker 部署
 
 ### 前端
 
-::::: steps
-
-1. 拉取代码到服务器
-
-   ```shell:no-line-numbers
-   git clone https://github.com/fastapi-practices/fastapi_best_architecture_ui_arco.git
-   ```
-
-2. env
-
-   修改 `.env.production` 中的 `VITE_API_BASE_URL` 为域名地址
-
-3. 更新 nginx 配置
-
-   进入 deploy 目录，修改 `nginx.conf` 文件
-
-   @[code nginx :collapsed-lines=6](../../code/nginx.conf)
-
-4. 更新脚本文件
-
-   ::: warning
-   如果你已通过后端 docker-compose 构建前端项目，此步骤和后面的剩余步骤直接跳过即可
-   :::
-
-   ```yaml :collapsed-lines=6
-   networks:
-     fba_network:
-       external: true
-
-   volumes:
-     fba_static:
-       external: true
-
-   services:
-     fba_ui:
-       build:
-         context: ../
-         dockerfile: Dockerfile
-       image: fba_ui:latest
-       ports:
-         - "80:80"
-         - "443:443"
-       container_name: fba_ui
-       restart: always
-       command:
-         - nginx
-         - -g
-         - daemon off;
-       volumes:
-          # nginx https conf
-          # 通过 docker 进行部署时，需要打开此配置项并确保<挂载到容器内的证书文件路径>配置
-          # 与 nginx conf 中的 ssl 证书文件路径配置一致，如果你直接将 ssl 证书文件 cp
-          # 到了 docker 容器内，则无需挂载证书文件，直接将它们注释或删除即可
-          # local_ssl_pem_path：你在服务器存放 ssl pem 证书文件的路径，自行修改
-          # local_ssl_key_path: 你在服务器存放 ssl key 证书文件的路径，自行修改
-          # /etc/ssl/xxx.pem：挂载到容器内 ssl pem 证书文件的路径，自行修改
-          # /etc/ssl/xxx.key：挂载到容器内 ssl key 证书文件的路径，自行修改
-         - local_ssl_pem_path:/etc/ssl/xxx.pem # [!code warning:2]
-         - local_ssl_key_path:/etc/ssl/xxx.key
-         - fba_static:/www/fba_server/backend/static
-       networks:
-         - fba_network
-   ```
-
-5. 构建并启动容器
-
-   创建网络
-
-   ```shell:no-line-numbers
-   docker network create fba_network
-   ```
-
-   构建
-
-   ```shell:no-line-numbers
-   docker-compose build fba_ui
-   ```
-
-   启动
-
-   ```shell:no-line-numbers
-   docker-compose run fba_ui
-   ```
-
-:::::
+[点击跳转](../../frontend/docker.md)
 
 ## 注意事项
 

docs/changelog.md

@@ -9,22 +9,31 @@ title: 更新日志
 的成熟与稳定，更意味着它已完全通过验证，可以安心投入生产环境使用。在未来的版本迭代中，我们将持续为开发者带来更优质的产品体验。敬请期待！🤗
 :::
 
-## [v1.4.1](https://github.com/fastapi-practices/fastapi_best_architecture/releases/tag/v1.4.1) - 2025-05-25
+## [v1.4.2](https://github.com/fastapi-practices/fastapi_best_architecture/releases/tag/v1.4.2) - 2025-05-29
 
 ### What's Changed
 
-* Update changelog for v1.4.0 by [@wu-clan](https://github.com/wu-clan)
-  in [#621](https://github.com/fastapi-practices/fastapi_best_architecture/pull/621)
-* Update the menu path and type columns by [@wu-clan](https://github.com/wu-clan)
-  in [#622](https://github.com/fastapi-practices/fastapi_best_architecture/pull/622)
-* Add the deepwiki badge to README by [@wu-clan](https://github.com/wu-clan)
-  in [#623](https://github.com/fastapi-practices/fastapi_best_architecture/pull/623)
-* Refactor the system token to online users by [@wu-clan](https://github.com/wu-clan)
-  in [#624](https://github.com/fastapi-practices/fastapi_best_architecture/pull/624)
-* Update the token check for logout interface by [@wu-clan](https://github.com/wu-clan)
-  in [#625](https://github.com/fastapi-practices/fastapi_best_architecture/pull/625)
-* Update the token decode for logout interface by [@wu-clan](https://github.com/wu-clan)
-  in [#629](https://github.com/fastapi-practices/fastapi_best_architecture/pull/629)
+* Update changelog for v1.4.1 by [@wu-clan](https://github.com/wu-clan)
+  in [#630](https://github.com/fastapi-practices/fastapi_best_architecture/pull/630)
+* Update non-linked sidebar support by [@wu-clan](https://github.com/wu-clan)
+  in [#633](https://github.com/fastapi-practices/fastapi_best_architecture/pull/633)
+* Update the captcha invalidation error class by [@wu-clan](https://github.com/wu-clan)
+  in [#634](https://github.com/fastapi-practices/fastapi_best_architecture/pull/634)
+* Optimize role-related data processing performance by [@wu-clan](https://github.com/wu-clan)
+  in [#635](https://github.com/fastapi-practices/fastapi_best_architecture/pull/635)
+* Optimize install and build of plugin zip by [@wu-clan](https://github.com/wu-clan)
+  in [#636](https://github.com/fastapi-practices/fastapi_best_architecture/pull/636)
+* Fix auto-increment id for postgres init data by [@huyuwei1996](https://github.com/huyuwei1996)
+  in [#632](https://github.com/fastapi-practices/fastapi_best_architecture/pull/632)
+* Fix: prevent overwriting existing init files in code generator by [@lin-wu-1990](https://github.com/lin-wu-1990)
+  in [#637](https://github.com/fastapi-practices/fastapi_best_architecture/pull/637)
+* Simplify the user info update business by [@wu-clan](https://github.com/wu-clan)
+  in [#638](https://github.com/fastapi-practices/fastapi_best_architecture/pull/638)
+
+## New Contributors
+
+* [@lin-wu-1990](https://github.com/lin-wu-1990) made their first contribution
+  in [#637](https://github.com/fastapi-practices/fastapi_best_architecture/pull/637)
 
 ::: demo-wrapper title="Full Changelog"
 完整日志请查看：[CHANGELOG.md](https://github.com/fastapi-practices/fastapi_best_architecture/blob/master/CHANGELOG.md)

docs/code/docker-compose.yml

@@ -99,7 +99,7 @@ services:
   # 如果你选择单独构建，务必注释或删除此容器脚本
   fba_ui: # [!code warning:30]
     build:
-      context: /root/fastapi_best_architecture_ui  # 根据 Arco Desgin Pro 项目存放目录修改此路径
+      context: /root/fastapi_best_architecture_ui  # 根据 Vben Admin Antd 项目存放目录修改此路径
       dockerfile: Dockerfile
     image: fba_ui:latest
     ports:

docs/code/nginx.conf

@@ -1,20 +1,15 @@
-# For more information on configuration, see:
-#   * Official English Documentation: http://nginx.org/en/docs/
-#   * Official Russian Documentation: http://nginx.org/ru/docs/
-
 worker_processes auto;
-error_log /var/log/nginx/error.log;
 pid /run/nginx.pid;
+error_log /var/log/nginx/error.log;
 
 # Load dynamic modules. See /usr/share/doc/nginx/README.dynamic.
 include /usr/share/nginx/modules/*.conf;
 
 events {
-worker_connections 1024;
+    worker_connections 8192;
 }
 
 http {
-
     include /etc/nginx/mime.types;
     default_type application/octet-stream;
 
@@ -29,6 +24,8 @@ http {
 
     keepalive_timeout 300;
 
+    access_log /var/log/nginx/access.log;
+
     # 添加 https conf
     # server {
     #     listen 80;
@@ -40,9 +37,6 @@ http {
 
     server {
         # 删除下面两行
-
-
-        
         # 更新为与上面 server_name 相同
         server_name  127.0.0.1;
 
@@ -59,23 +53,68 @@ http {
         root /var/www/fba_ui;
 
         location / {
-                try_files $uri $uri/ /index.html;
+            try_files $uri $uri/ /index.html;
         }
 
         location /api/v1/ {
-                proxy_pass http://fba_server:8001;
-
-                proxy_set_header Host $http_host;
-                proxy_set_header X-Real-IP $remote_addr;
-                proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-                proxy_set_header X-Forwarded-Proto $scheme;
-                proxy_connect_timeout 300s;
-                proxy_send_timeout 300s;
-                proxy_read_timeout 300s;
+            proxy_pass http://fba_server:8001;
+
+            proxy_set_header Host $http_host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            proxy_connect_timeout 300s;
+            proxy_send_timeout 300s;
+            proxy_read_timeout 300s;
+        }
+
+        location /ws/socket.io/ {
+            proxy_pass http://fba_server:8001/ws/socket.io/;
+
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            proxy_read_timeout 86400s;
+            proxy_send_timeout 86400s;
+
+            # WebSocket 支持
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection "upgrade";
+            proxy_buffering off;
+        }
+
+        location /flower/ {
+            proxy_pass http://fba_server:8555;
+
+            proxy_set_header Host $http_host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            proxy_connect_timeout 300s;
+            proxy_send_timeout 300s;
+            proxy_read_timeout 300s;
+            proxy_redirect off;
+
+            # WebSocket 支持
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection "upgrade";
         }
 
         location /static/ {
-                alias /var/www/fba_server/backend/static;
+            alias /var/www/fba_server/backend/static;
+        }
+
+        location /static/upload/ {
+            alias /var/www/fba_server/backend/static/upload;
+        }
+
+        error_page 500 502 503 504 /50x.html;
+
+        location = /50x.html {
+            root /usr/share/nginx/html;
         }
     }
 }