9.17/1

backend/doc/同步文档.md

@@ -1,6 +1,6 @@
 ## 前后端数据库状态说明
 
-**更新日期**: 2025-09-16
+**更新日期**: 2025-09-17
 
 ### 概要
 - 数据库已落地：已在远程 MySQL `mysql.tonaspace.com` 的 `partsinquiry` 库完成初始化（表结构与触发器已创建）。
@@ -27,12 +27,15 @@
 - 关闭：不设置/置为 `false` 即可停用（生产环境默认关闭）。
 - 完全移除：删除 `frontend/common/config.js` 中默认用户配置与 `frontend/common/http.js` 中注入逻辑。
 
-### 后端（Spring Boot）数据库状态
-- 依赖：`pom.xml` 未包含 `spring-boot-starter-web`、`spring-boot-starter-data-jpa`、`mysql-connector-j` 等数据库相关依赖。
-- 配置：`src/main/resources/application.properties` 仅有 `spring.application.name=demo`；未配置 `spring.datasource.*`、`spring.jpa.*`。
-- 数据模型：`src/main/java` 未发现 `@Entity`、Repository、Service；存在 `backend/db/db.sql` 脚本，已执行至远程库。
-- 迁移：未发现 Flyway/Liquibase 配置与脚本（当前通过 MysqlMCP 手工执行）。
-- 结论：数据库已初始化，但后端未配置运行时数据源与接口，暂不可用。
+### 后端（Spring Boot）状态
+- 依赖：`pom.xml` 已包含 `spring-boot-starter-web`、`spring-boot-starter-data-jpa`、`mysql-connector-j`。
+- 配置：`application.properties` 使用环境变量注入数据源，已补充 Hikari/JPA；新增附件占位图配置：
+  - `attachments.placeholder.image-path`（env: `ATTACHMENTS_PLACEHOLDER_IMAGE`）
+  - `attachments.placeholder.url-path`（env: `ATTACHMENTS_PLACEHOLDER_URL`，默认 `/api/attachments/placeholder`）
+- 接口：新增附件相关接口（占位方案）：
+  - POST `/api/attachments`：忽略内容，返回 `{ url: "/api/attachments/placeholder" }`
+  - GET `/api/attachments/placeholder`：返回本地占位图二进制
+- 迁移：仍建议引入 Flyway/Liquibase；结构变更继续通过 MysqlMCP 并同步 `/doc/database_documentation.md`。
 
 ### 前端（uni-app）数据库状态
 - 数据持久化：未见 IndexedDB/WebSQL/SQLite/云数据库使用；页面数据为内置静态数据。
@@ -49,5 +52,26 @@
 - 引入迁移工具（Flyway/Liquibase）管理 DDL；后续所有变更继续通过 MysqlMCP 执行，并同步 `/doc/database_documentation.md`。
 - 增加健康检查与基础 CRUD 接口；在 `/doc/openapi.yaml` 按规范登记并标注实现状态（❌/✅）。
 
+### 前端默认连接策略
+- 默认后端地址：`http://192.168.31.193:8080`（可被环境变量/Storage 覆盖）
+- 多地址重试：按顺序尝试（去重处理）：`[ENV, Storage, 192.168.31.193:8080, 127.0.0.1:8080, localhost:8080]`
+- 默认用户：开启（可被环境变量/Storage 关闭），请求自动附带 `X-User-Id`（默认 `2`）。
+- 如需关闭：在 Storage 或构建环境中设置 `ENABLE_DEFAULT_USER=false`。
+
+
+### 占位图策略（当前阶段）
+- 说明：所有图片上传与展示均统一使用占位图，实际文件存储暂不开发。
+- 本地占位图：`C:\Users\21826\Desktop\Wj\PartsInquiry\backend\picture\屏幕截图 2025-08-14 134657.png`
+- 配置方式：
+  - PowerShell（当前用户持久化）
+    ```powershell
+    setx ATTACHMENTS_PLACEHOLDER_IMAGE "C:\\Users\\21826\\Desktop\\Wj\\PartsInquiry\\backend\\picture\\屏幕截图 2025-08-14 134657.png"
+    setx ATTACHMENTS_PLACEHOLDER_URL "/api/attachments/placeholder"
+    ```
+  - 应用重启后生效；也可在运行环境变量中注入。
+- 前端影响：
+  - `components/ImageUploader.vue` 上传始终得到 `{ url: '/api/attachments/placeholder' }`
+  - 商品列表/详情展示该占位图地址
+