项目维护在 GitLab 的 main 分支，通过 origin 远程手动更新，没有配置自动上游同步。

更新前准备

先保存本地修改，在 PostgreSQL 运行时备份数据库：

mkdir -p ../wrdo-backups
docker compose exec -T postgres pg_dump -U wrdo wrdo > ../wrdo-backups/wrdo-backup-$(date +%Y%m%d-%H%M%S).sql

.env 和数据库备份均应保密。更新时保留原 .env，如需新增配置再单独补充，不要用模板覆盖。

拉取并重新构建

git switch main
git pull --ff-only origin main
docker compose up -d --build
docker compose ps -a
docker compose logs --tail=100 app migrate

--ff-only 在本地与远程历史分叉时会停止，需要处理差异后再继续。migrate 应用新增数据库迁移，正常退出码是 0，成功后 app 才启动。

修改 NEXT_PUBLIC_* 后需重新构建。调整端口时同步修改 APP_PORT、NEXT_PUBLIC_APP_URL、AUTH_URL。首次部署见 部署指南。