update docs

Author: wu-clan

docs/changelog.md

@@ -9,25 +9,34 @@ title: 更新日志
 的成熟与稳定，更意味着它已完全通过验证，可以安心投入生产环境使用。在未来的版本迭代中，我们将持续为开发者带来更优质的产品体验。敬请期待！🤗
 :::
 
-## [v1.0.3](https://github.com/fastapi-practices/fastapi_best_architecture/releases/tag/v1.0.3) - 2025-03-11
+<a id="v1.0.4"></a>
+
+## [v1.0.4](https://github.com/fastapi-practices/fastapi_best_architecture/releases/tag/v1.0.4) - 2025-03-28
 
 ### What's Changed
 
-* Update the changelog for v1.0.2 by [@wu-clan](https://github.com/wu-clan)
-  in [#536](https://github.com/fastapi-practices/fastapi_best_architecture/pull/536)
-* Update docker scripts in backend README by [@wu-clan](https://github.com/wu-clan)
-  in [#537](https://github.com/fastapi-practices/fastapi_best_architecture/pull/537)
-* Refactor toml and dependencies file dir by [@wu-clan](https://github.com/wu-clan)
-  in [#538](https://github.com/fastapi-practices/fastapi_best_architecture/pull/538)
-* Fix typos in Dockerfile comments by [@huyuwei1996](https://github.com/huyuwei1996)
-  in [#539](https://github.com/fastapi-practices/fastapi_best_architecture/pull/539)
-* Fix Dockerfile mounts for dependency installation by [@huyuwei1996](https://github.com/huyuwei1996)
-  in [#540](https://github.com/fastapi-practices/fastapi_best_architecture/pull/540)
-* Add Aliyun mirror to PyPI index in pyproject.toml by [@huyuwei1996](https://github.com/huyuwei1996)
-  in [#541](https://github.com/fastapi-practices/fastapi_best_architecture/pull/541)
-* Update docker scripts and nginx conf by [@wu-clan](https://github.com/wu-clan)
-  in [#542](https://github.com/fastapi-practices/fastapi_best_architecture/pull/542)
+- Update the changelog for v1.0.3 by [@wu-clan](https://github.com/wu-clan) in [#543](https://github.com/fastapi-practices/fastapi_best_architecture/pull/543)
+- Updated the backend contribution guide by [@wu-clan](https://github.com/wu-clan) in [#544](https://github.com/fastapi-practices/fastapi_best_architecture/pull/544)
+- Optimize the return of relationship interfaces by [@wu-clan](https://github.com/wu-clan) in [#545](https://github.com/fastapi-practices/fastapi_best_architecture/pull/545)
+- Optimize the dynamic import of data models by [@wu-clan](https://github.com/wu-clan) in [#546](https://github.com/fastapi-practices/fastapi_best_architecture/pull/546)
+- Update git and docker ignore files by [@wu-clan](https://github.com/wu-clan) in [#547](https://github.com/fastapi-practices/fastapi_best_architecture/pull/547)
+- Optimize dependencies to reduce package size by [@wu-clan](https://github.com/wu-clan) in [#548](https://github.com/fastapi-practices/fastapi_best_architecture/pull/548)
+- Fix async install plugin dependencies for windows by [@wu-clan](https://github.com/wu-clan) in [#549](https://github.com/fastapi-practices/fastapi_best_architecture/pull/549)
+- Fix return schema of the config api by [@wu-clan](https://github.com/wu-clan) in [#551](https://github.com/fastapi-practices/fastapi_best_architecture/pull/551)
+- Optimize schemas with model relationships by [@wu-clan](https://github.com/wu-clan) in [#552](https://github.com/fastapi-practices/fastapi_best_architecture/pull/552)
+- Fix filters for opera log query list by [@ThankCat](https://github.com/ThankCat) in [#554](https://github.com/fastapi-practices/fastapi_best_architecture/pull/554)
+- Fix the celery env in docker compose by [@wu-clan](https://github.com/wu-clan) in [#555](https://github.com/fastapi-practices/fastapi_best_architecture/pull/555)
+- Update volumes of redis in docker compose by [@wu-clan](https://github.com/wu-clan) in [#556](https://github.com/fastapi-practices/fastapi_best_architecture/pull/556)
+- Fix the query for the sub department by [@PoetryL](https://github.com/PoetryL) in [#557](https://github.com/fastapi-practices/fastapi_best_architecture/pull/557)
+- Optimize codes and comments with cursor by [@wu-clan](https://github.com/wu-clan) in [#550](https://github.com/fastapi-practices/fastapi_best_architecture/pull/550)
+
+### New Contributors
+
+- [@ThankCat](https://github.com/ThankCat) made their first contribution in [#554](https://github.com/fastapi-practices/fastapi_best_architecture/pull/554)
+- [@PoetryL](https://github.com/PoetryL) made their first contribution in [#557](https://github.com/fastapi-practices/fastapi_best_architecture/pull/557)
+
+## 完整日志
 
 ::: demo-wrapper title="Full Changelog"
-完整版日志请查看：[CHANGELOG.md](https://github.com/fastapi-practices/fastapi_best_architecture/blob/master/CHANGELOG.md)
+完整日志请查看：[CHANGELOG.md](https://github.com/fastapi-practices/fastapi_best_architecture/blob/master/CHANGELOG.md)
 :::

docs/guide/deploy/Docker.md

@@ -12,11 +12,11 @@ title: Docker 部署
 
 ### 后端
 
-::: steps
+:::: steps
 
 1. env
 
-   在 `backend` 目录中，创建环境变量文件
+   在 `backend` 目录打开终端，创建环境变量文件
 
    ```shell:no-line-numbers
    touch .env
@@ -29,24 +29,27 @@ title: Docker 部署
    ```
 
 2. 按需修改配置文件 `backend/core/conf.py` 和 `.env`
-3. 务必在 `Dockerfile` 所在目录打开终端
-4. 运行以下命令构建容器
+3. 构建容器
+
+   在项目根目录中打开终端，执行以下命令
 
+   ::: note
    如果容器要在本地启动，需要将 `.env` 中的 `127.0.0.1` 更改为 `host.docker.internal`
+   :::
 
    ```shell:no-line-numbers
    docker build -f Dockerfile -t fba_backend_independent .
    ```
 
-5. 启动容器
+4. 启动容器
 
    由于构建不包含数据库，请确保本地已安装并启动相关数据库（mysql / postgresql、redis）
 
    ```shell:no-line-numbers
    docker run -d -p 8000:8000 --name fba_server fba_backend_independent
    ```
 
-:::
+::::
 
 ## 服务器部署
 
@@ -70,7 +73,7 @@ title: Docker 部署
 
 2. env
 
-   在 `backend` 目录中，创建环境变量文件
+   在 `backend` 目录打开终端，创建环境变量文件
 
    ```shell:no-line-numbers
    touch .env
@@ -103,8 +106,9 @@ title: Docker 部署
 
    @[code yml :collapsed-lines=6](../../code/docker-compose.yml)
 
-5. 务必在 `docker-compose.yml` 所在目录打开终端
-6. 执行一键启动命令
+5. 执行一键启动命令
+
+   在项目根目录中打开终端，执行以下命令
 
    ::: warning
    命令执行期间遇到镜像拉取问题请自行 Google
@@ -114,7 +118,7 @@ title: Docker 部署
    docker-compose up -d --build
    ```
 
-7. 等待命令执行完成
+6. 等待命令执行完成
    ::::
 
 ### 前端

docs/guide/summary/quick-start.md

@@ -50,7 +50,7 @@ title: 快速开始
 
     - 架构依赖
 
-      拉取项目到本地后，在项目根目录，执行以下命令安装架构依赖
+      拉取项目到本地后，在项目根目录打开终端，执行以下命令安装架构依赖
 
       ::: code-tabs
       @tab <Icon name="material-icon-theme:uv" />uv - pip
@@ -281,7 +281,7 @@ title: 快速开始
 1. 创建测试数据库 `fba_test`，选择 utf8mb4 编码，postgres 用户可忽略编码
 2. 创建数据库表，执行 `backend/sql/` 目录下对应数据库的 `create_tables.sql` 脚本
 3. 初始化测试数据，执行 `backend/sql/` 目录下对应数据库的 `init_test_data.sql` 脚本
-4. 在项目根目录，执行单元测试命令
+4. 在项目根目录打开终端，执行以下单元测试命令
 
    ```shell:no-line-numbers
    pytest -vs --disable-warnings