gouki
2a68eae999
1. 修复swiper箭头点击动画丢失问题 - 改用固定7天窗口，滑动到边缘时整体滚动数据 - 保持dayIndex连续，确保swiper平滑动画 2. 修复宜忌两行显示压在一起 - 设置item固定高度32rpx和行距12rpx - 超出2行显示...省略号 3. 修复月历数字竖向排列问题 - 修正wxml嵌套结构，让42个格子正确排成6行7列 - 压缩格子高度，放大数字字体 4. 节日速查功能优化 - 默认显示3条，右侧添加更多
115 lines
3.1 KiB
Markdown
115 lines
3.1 KiB
Markdown
# 祈福小助手后端服务
|
|
|
|
基于 Go + Gin + Inertia.js 的后端服务。
|
|
|
|
## 功能模块
|
|
|
|
- **用户模块** — 微信登录、资料修改、授权管理
|
|
- **支付模块** — 微信支付集成、订单管理
|
|
- **许愿树** — 许愿发布、付费许愿、机器人自动许愿
|
|
- **百科/历史上的今天** — 百科条目后台维护；从中文维基百科同步 366 天「历史上的今天」数据，定时刷新
|
|
- **管理后台** — 基于 Inertia.js 的前后端分离管理界面
|
|
|
|
## 技术栈
|
|
|
|
- **后端**: Go 1.22 + Gin + GORM
|
|
- **前端**: Inertia.js + React/Vue（待选择）
|
|
- **数据库**: MySQL
|
|
- **缓存**: Redis
|
|
|
|
## 快速开始
|
|
|
|
### 开发环境
|
|
|
|
```bash
|
|
# 安装依赖
|
|
go mod download
|
|
|
|
# 启动开发服务器
|
|
./scripts/dev.sh
|
|
```
|
|
|
|
### 生产构建
|
|
|
|
```bash
|
|
# 构建
|
|
./scripts/build.sh
|
|
|
|
# 运行
|
|
./bin/lunar-server
|
|
```
|
|
|
|
## 项目结构
|
|
|
|
```
|
|
server/
|
|
├── cmd/ # 入口文件
|
|
│ └── main.go
|
|
├── internal/ # 内部包
|
|
│ ├── config/ # 配置
|
|
│ ├── handler/ # 处理器
|
|
│ ├── middleware/ # 中间件
|
|
│ ├── model/ # 数据模型
|
|
│ └── service/ # 业务逻辑
|
|
├── web/ # Inertia.js 前端
|
|
│ ├── src/
|
|
│ └── public/
|
|
├── migrations/ # 数据库迁移
|
|
├── scripts/ # 脚本
|
|
└── go.mod
|
|
```
|
|
|
|
## API 接口
|
|
|
|
### 用户接口
|
|
|
|
- `POST /api/user/login` — 用户登录
|
|
- `POST /api/user/logout` — 用户登出
|
|
- `GET /api/user/profile` — 获取用户资料
|
|
- `PUT /api/user/profile` — 更新用户资料
|
|
- `POST /api/user/auth` — 微信授权
|
|
|
|
### 支付接口
|
|
|
|
- `POST /api/pay/create` — 创建订单
|
|
- `POST /api/pay/notify` — 支付回调
|
|
- `GET /api/pay/status/:orderId` — 查询支付状态
|
|
|
|
### 订单接口
|
|
|
|
- `GET /api/order/list` — 订单列表
|
|
- `GET /api/order/detail/:id` — 订单详情
|
|
- `POST /api/order/cancel/:id` — 取消订单
|
|
|
|
### 许愿接口
|
|
|
|
- `GET /api/wish/tree` — 获取许愿树
|
|
- `POST /api/wish/create` — 创建许愿
|
|
- `GET /api/wish/list` — 许愿列表
|
|
- `DELETE /api/wish/:id` — 删除许愿
|
|
|
|
### 百科接口
|
|
|
|
- `GET /api/wiki/entries` — 百科条目列表（支持 category/keyword 过滤）
|
|
- `GET /api/wiki/on-this-day?month=&day=` — 历史上的今天（大事记/出生/逝世/节假日习俗）
|
|
|
|
### 管理后台接口（/admin，需管理员认证）
|
|
|
|
- `GET/POST /admin/api/wiki/entries` — 百科条目列表/新增
|
|
- `PUT/DELETE /admin/api/wiki/entries/:id` — 更新/删除条目
|
|
- `GET /admin/api/wiki/sync-status` — 维基同步状态
|
|
- `POST /admin/api/wiki/sync` — 手动触发全量同步
|
|
|
|
## 环境变量
|
|
|
|
参考 `.env.local` 文件配置。维基同步相关：
|
|
|
|
- `WIKI_SYNC_INTERVAL_DAYS` — 自动同步间隔（天），默认 7
|
|
- `WIKI_SYNC_HOUR` — 自动同步执行的小时点（0-23），默认 4
|
|
|
|
同步策略：服务启动时若数据缺失自动补齐；之后每天在指定小时点检查，距上次成功超过间隔天数才全量刷新（共 366 页，只抓中文版）。
|
|
|
|
## 数据库
|
|
|
|
执行 `migrations/001_init.sql` 初始化数据库。
|