UFH Shanghai

重庆国宾妇产医院官网项目，使用 Next.js App Router、TypeScript、Tailwind CSS、shadcn/ui 风格组件与 SQLite3 构建。

功能概览

前台

• 首页：Hero、24 小时预约热线、快捷入口、促销与新闻预览
• 找医生：科室 / 语言 / 关键词筛选
• 科室、健康套餐、新闻活动、关于我们
• 新闻详情页、移动端右上角汉堡菜单
• 预约表单（Server Action 写入数据库）
• 中英双语切换（Cookie 持久化）

后台 /admin

• 登录保护（proxy.ts 路由守卫）
• Dashboard 数据统计
• 网站设置（/admin/settings）：标题、Logo、Favicon、Banner、电话、首页与关于页面文案（图片支持点击上传，自动转 WebP 并压缩）
• 医生 / 套餐 / 新闻 / 促销：封面与头像同样支持上传（见各模块表单的尺寸提示）
• 医生 / 科室 / 套餐 / 新闻 / 促销：新增、编辑、删除、发布 / 下架
• 预约记录查看与状态处理

技术栈

• Next.js 14+ App Router
• TypeScript
• Tailwind CSS + shadcn/ui 风格组件
• SQLite3 + Drizzle ORM
• Server Components + Server Actions

本地开发

1. 安装依赖

npm install

如需代理（国内网络）：

export https_proxy=http://127.0.0.1:7897 http_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:7897
npm install

2. 环境变量

cp .env.example .env

DATABASE_URL="./data/guobin-index.db"
ADMIN_USERNAME="admin"
ADMIN_PASSWORD="change-me"
NEXT_PUBLIC_SITE_URL="http://localhost:3000"
ICP_NUMBER="渝ICP备00000000号"
PUBLIC_SECURITY_NUMBER="渝公网安备00000000000000号"

ICP_NUMBER / PUBLIC_SECURITY_NUMBER 为页脚备案号（可选，留空则不显示）。

3. 初始化数据库

npm run db:generate
npm run db:migrate
npm run db:seed

4. 启动

npm run dev

访问地址：

页面	地址
前台首页	http://localhost:3000
后台登录	http://localhost:3000/admin/login
后台控制台	http://localhost:3000/admin

后台默认账号：admin / change-me（可在 .env 修改，需重新 db:seed 同步密码哈希）

常用命令

npm run dev      # 开发
npm run build    # 生产构建
npm run start    # 生产运行
npm run lint     # 代码检查
npm run db:seed  # 重置并填充演示数据

部署说明

Windows Server 部署请参阅 WindowsINSTALL.md。推荐在本机打好 zip 再上传（服务器无需编译）；Mac 用户可运行 ./scripts/package-deploy-mac.sh 生成 Windows 发布包。

Vercel（推荐演示部署）

1. 将项目推送到 Git 仓库
2. 在 Vercel 导入项目
3. 配置环境变量（与 .env.example 一致）
4. 注意：Vercel 无持久化磁盘，SQLite 文件在 Serverless 环境不适用生产。演示可部署，生产建议换 PostgreSQL / Turso 等持久化数据库

Docker（linux/amd64）

不在本机运行应用：在 Mac（含 Apple Silicon）或 CI 上用 buildx 交叉编译 amd64 镜像，拷贝到 amd64 Linux 服务器 再 compose up。

1. 构建机（Mac / CI）

先启动 Docker Desktop，在项目根目录执行：

docker buildx build --platform linux/amd64 -t ufh-shanghai:latest \
  --provenance=false --sbom=false \
  -o type=docker,dest=ufh-shanghai-amd64.tar .

生成 ufh-shanghai-amd64.tar。推送到仓库时把 -o type=docker,dest=... 换成 --push，并改用你的镜像名，例如 -t your.registry/ufh-shanghai:v1。

2. 服务器（amd64 Linux）

docker load -i ufh-shanghai-amd64.tar
cp .env.example i.env   # 编辑 ADMIN_PASSWORD、NEXT_PUBLIC_SITE_URL
docker compose up -d

项	说明
访问	http://<服务器IP>:3001（宿主机端口，可用 APP_PORT 覆盖）
数据卷	ufh_data（SQLite）、ufh_uploads（上传图片）
首次启动	自动 db:migrate + db:seed（仅数据库文件不存在时 seed）
改密	登录后台 → 账号安全

docker compose logs -f app
docker compose down
docker compose down -v   # 删除数据卷（清空库与上传）

Node 服务器

npm run build
npm run start

• 确保 data/ 目录可写，用于 SQLite 文件
• 首次部署执行 db:migrate 与 db:seed
• 将 NEXT_PUBLIC_SITE_URL 设为正式域名（用于 sitemap）

生产检查清单

• [ ] 修改 ADMIN_PASSWORD 为强密码
• [ ] 配置正式 NEXT_PUBLIC_SITE_URL
• [ ] 上传真实图片到 public/images/（当前使用渐变占位）
• [ ] 评估数据库持久化方案（SQLite 仅适合单机）

项目结构

app/
  (site)/          # 前台页面
  admin/           # 后台 CMS
  robots.ts
  sitemap.ts
components/        # UI 与布局组件
lib/
  db/              # schema、查询
  actions/         # Server Actions
  i18n/            # 双语词典
  auth/            # 管理员与密码
proxy.ts           # 后台路由保护
scripts/seed.ts    # 演示数据
data/              # SQLite 数据库文件

维护说明

• 重置演示数据：npm run db:seed（会清空业务表后重新写入）
• 新增迁移：修改 lib/db/schema.ts 后执行 npm run db:generate 与 npm run db:migrate
• 后台内容变更：前台相关页面会自动 revalidate（见 lib/actions/admin-content-actions.ts）

开发进度

• [x] P0 项目骨架
• [x] P1 设计系统与全局布局
• [x] P2 数据模型与基础内容
• [x] P3 核心前台页面
• [x] P4 后台管理
• [x] P5 联调、优化与交付

免责声明

本项目为重庆国宾妇产医院官网项目。