## Work Log - Docker PostgreSQL 默认端口切换为 5434（2026-04-30）

- 背景：
  - 用户要求将 Docker 镜像构建/部署链路中的 PostgreSQL 默认宿主机端口改为 `5434`。

- 本次改动：
  - `docker-compose.yml`
    - `db.ports` 默认映射从 `${POSTGRES_PORT:-5433}:5432` 改为 `${POSTGRES_PORT:-5434}:5432`。
  - `.env`
    - `POSTGRES_PORT=5434`。
  - `.env.example`
    - `DB_PORT=5434`（本机直连口径）。
    - `POSTGRES_PORT=5434`（容器暴露口径）。
  - `.github/workflows/main.yml`
    - 部署阶段生成的 `docker-compose.prod.yml` 默认映射改为 `${POSTGRES_PORT:-5434}:5432`。
    - 自动生成 `.env` 模板中的 `POSTGRES_PORT=5434`。
  - `api/app/core/config.py`
    - 本机默认 `db_port` 从 `5433` 改为 `5434`，与新口径一致。
  - `README.md`
    - 本地 PostgreSQL 可选端口说明从 `localhost:5433` 更新为 `localhost:5434`。
  - `MEMORY.md`
    - 长期端口口径同步更新为 `5434`。

- 验证：
  - 通过 `rg` 全局检索 `POSTGRES_PORT/5433` 相关配置，确认运行口径已切换到 `5434`。
  - 本次未执行容器重建或运行态联调。

- 风险与影响：
  - 影响范围：Docker 暴露端口与本机直连默认端口。
  - 若已有外部脚本/客户端固定连接 `5433`，需同步改为 `5434` 或显式覆盖 `POSTGRES_PORT/DB_PORT`。