docs: 修正 .env.example 默认值并补全 PGADMIN_PASSWORD (#29)

* docs: 修正 .env.example 默认值并补全 PGADMIN_PASSWORD

* fix(.env.example): 移除 SPRING_DATASOURCE_URL=localhost,避免污染 docker compose backend 容器

backend 服务在 compose 里用 ${SPRING_DATASOURCE_URL:-postgres:5432/...} 兜底,
.env 里设 localhost 后会注入容器,容器内 localhost 找不到 postgres 服务,
启动失败。

不设这一行的话两条路径都正常:
- mvnw: application.properties 用 PG* 变量自动拼出 localhost:5432
- docker compose: backend 走默认值 postgres:5432

---------

Co-authored-by: longsizhuo <longsizhuo@gmail.com>

Author: F1sh2712

.env.example

@@ -1,17 +1,40 @@
-# --- 数据库（Neon.tech 或其他 PostgreSQL）---
-PGHOST=ep-xxxx.ap-southeast-2.aws.neon.tech
+# --- 数据库 ---
+# 默认配置指向本地 Docker(配合 docker compose up -d postgres),开箱即用。
+# 如使用 Neon 云数据库,把下面这一组 PG* 变量注释掉,启用底部 Neon 配置块即可。
+PGHOST=localhost
 PGPORT=5432
-PGUSER=neondb_owner
+PGUSER=involution
 PGPASSWORD=change_me
-PGDATABASE=neondb
-PGSSLMODE=require
+PGDATABASE=involution_hell
+PGSSLMODE=disable
+
+# 故意不在这里设 SPRING_DATASOURCE_URL:
+# - mvnw 路径:application.properties 会用上面的 PG* 变量自动拼出
+#   jdbc:postgresql://localhost:5432/involution_hell?sslmode=disable
+# - docker compose 路径:backend 容器走 compose 里的默认值
+#   jdbc:postgresql://postgres:5432/involution_hell(容器网络内的 postgres 服务)
+# 如果在这里设 SPRING_DATASOURCE_URL=...localhost..., 会被 docker compose 注入
+# 进 backend 容器,容器内 localhost 不指向 postgres 服务,会连接失败。
+
+# 首次启动需为 always 以执行 schema.sql 初始化建表,之后可改为 never
+SPRING_SQL_INIT_MODE=always
+
+# --- 数据库（Neon.tech 或其他 PostgreSQL）---
+# PGHOST=ep-xxxx.ap-southeast-2.aws.neon.tech
+# PGPORT=5432
+# PGUSER=neondb_owner
+# PGPASSWORD=change_me
+# PGDATABASE=neondb
+# PGSSLMODE=require
 
 # Spring Boot JDBC 连接（由上面的 PG 变量转换而来）
-SPRING_DATASOURCE_URL=jdbc:postgresql://ep-xxxx.ap-southeast-2.aws.neon.tech/neondb?sslmode=require
+# SPRING_DATASOURCE_URL=jdbc:postgresql://ep-xxxx.ap-southeast-2.aws.neon.tech/neondb?sslmode=require
 # 首次部署时设为 always 以初始化 schema.sql，之后改为 never
-SPRING_SQL_INIT_MODE=never
+# SPRING_SQL_INIT_MODE=never
 
 # --- 本地开发用 Docker PostgreSQL（无 Neon 账号的开发者使用）---
+# 这些变量被 docker-compose.yml 读取,用于创建本地 Postgres 容器。
+# POSTGRES_PASSWORD 没有默认值,必须显式设置,否则容器启动失败。
 POSTGRES_DB=involution_hell
 POSTGRES_USER=involution
 POSTGRES_PASSWORD=change_me
@@ -61,6 +84,13 @@ MANAGEMENT_ENDPOINT_HEALTH_PROBES_ENABLED=true
 # when-authorized 生产推荐；开发时可改为 always
 MANAGEMENT_ENDPOINT_HEALTH_SHOW_DETAILS=when-authorized
 
+# --- pgAdmin(可选的数据库 Web 管理界面)---
+# docker-compose.yml 的 pgadmin 服务用这两个变量。
+# 即使你不启动 pgadmin 服务,docker compose 命令在解析 yml 时也会校验
+# PGADMIN_PASSWORD,所以这个变量必须设置,否则 docker compose ps / up 等命令都会报错。
+PGADMIN_EMAIL=admin@involutionhell.com
+PGADMIN_PASSWORD=change_me
+
 # --- 网关（Caddy）---
 CADDY_HTTP_PORT=80
 CADDY_HTTPS_PORT=443