From a81b373b8b389da6d8693a39decb8e84cec0a1f2 Mon Sep 17 00:00:00 2001
From: xiaji <xiaji@local>
Date: Sun, 14 Jun 2026 21:12:36 +0800
Subject: [PATCH] =?UTF-8?q?chore(tz):=20=E6=97=B6=E5=8C=BA=E7=BB=9F?=
 =?UTF-8?q?=E4=B8=80=E4=B8=BA=20Asia/Shanghai?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

仓库里有两处时区声明写成 Asia/Hong_Kong,虽然跟 Shanghai
都是 UTC+8 在 C 库时区行为上一致(无夏令时),但:
- VPS 物理位置虽然在香港,本机 /etc/localtime 已指向 Shanghai
- 配置文件/默认值/示例 env 写成 Shanghai 更准确反映项目
  实际部署位置
- /etc/timezone 文件本机之前是 Etc/UTC 跟 timedatectl 不一致
  (本次单独在服务器上同步,不入 commit — 是运维状态)

改动:
- .env.example: TZ Asia/Hong_Kong -> Asia/Shanghai
- backend/app/config.py: settings.tz 默认值 Asia/Hong_Kong
  -> Asia/Shanghai(只有日志打了一下,不影响实际行为)

不影响:
- 生产 .env 文件没动(里面有 JWT_SECRET 等真实值,不该入库;
  新机器按 .env.example 复制出来就是 Shanghai)
- docker-compose.yml 不动 — api/worker service 用 env_file: .env
  模式,TZ 已经自动注入容器(验证过 TZ=Asia/Hong_Kong 在容器内可见)
- 应用代码所有 datetime.now() 都是 naive datetime,实际行为
  不变(数据库存的是 UTC 绝对时刻,PG TIMESTAMPTZ 转换正确)
- 文档/README 不动 — line 4 写"香港 VPS"是物理位置描述,
  时区是上海,两者并存(都是 UTC+8)不矛盾
---
 .env.example          | 2 +-
 backend/app/config.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.env.example b/.env.example
index dfae5f3..98f3b25 100644
--- a/.env.example
+++ b/.env.example
@@ -1,5 +1,5 @@
 # ===== 通用 =====
-TZ=Asia/Hong_Kong
+TZ=Asia/Shanghai
 LOG_LEVEL=INFO
 
 # ===== 数据库 =====
diff --git a/backend/app/config.py b/backend/app/config.py
index 4bff1d4..b9eb9dc 100644
--- a/backend/app/config.py
+++ b/backend/app/config.py
@@ -17,7 +17,7 @@ class Settings(BaseSettings):
     )
 
     # ===== 通用 =====
-    tz: str = "Asia/Hong_Kong"
+    tz: str = "Asia/Shanghai"
     log_level: str = "INFO"
 
     # ===== 数据库 =====