订阅管理系统 (Subscription Management System)

一个现代化的订阅管理系统，帮助用户轻松管理和追踪各种订阅服务的费用和续费情况。

项目暂时没有开源，使用完全免费（但是有大量订阅的用户需要许可密钥才可）

• 🚀 快速开始
• 📊 功能特性
• 🛠 技术栈
• 📚 文档
• 🤝 贡献指南
• 📄 许可证

智能仪表板展示月度/年度支出统计、即将到期的订阅提醒和分类费用分析

完整的订阅生命周期管理，支持添加、编辑、状态管理和批量导入

完整的支付历史记录，支持搜索，以及订单的增删改查

月度支出订单，直观展示支出详情

强大的费用分析功能，包含趋势图表、分类统计和多维度数据展示

支持深色主题

• 智能订阅管理 - 全面的订阅生命周期管理，支持自动/手动续费，智能到期提醒
• 多币种支持 - 支持8种主要货币（USD, EUR, GBP, CAD, AUD, JPY, CNY, TRY），实时汇率自动更新
• 费用分析报告 - 强大的数据分析和可视化图表功能，支持趋势分析和分类统计
• 响应式设计 - 完美适配桌面和移动端，提供一致的用户体验
• 本地优先 - 基于SQLite的本地数据存储，保护用户隐私，无需云端依赖
• Docker部署 - 一键部署，开箱即用，支持容器化部署
• 🌍 国际化支持 - 完整的中英文双语支持，支持语言切换，提供本地化用户体验
• 数据导入导出 - 支持CSV和JSON格式的数据导入导出，便于数据迁移和备份
• 智能费用分析 - 支持月度、季度、年度费用分析，自动计算日均支出和支付次数
• 实时汇率更新 - 集成天行数据API，支持自动汇率更新和货币转换
• 🔐 许可证系统 - 集成完整的许可证验证系统，支持免费版、专业版、荣誉终生版
• 智能限制管理 - 基于许可证类型的智能功能限制和订阅数量管理

• ✅ 订阅管理 - 添加、编辑、删除订阅服务，支持批量操作
• ✅ 智能仪表板 - 支出概览和即将到期提醒，实时数据更新
• ✅ 分类统计 - 按类别、支付方式统计费用，支持自定义分类
• ✅ 搜索筛选 - 多维度搜索和状态筛选，快速定位订阅
• ✅ 自定义配置 - 自定义分类和支付方式，灵活配置

• ✅ 自动续费处理 - 智能检测到期订阅并自动更新，支持定时任务
• ✅ 多币种支持 - 8种主要货币实时转换，集成天行数据API自动更新汇率
• ✅ 汇率自动更新 - 每日自动更新汇率数据，确保汇率准确性
• ✅ 费用报告仪表板 - 全面的费用分析和可视化，支持多种图表类型
• ✅ 支付历史追踪 - 完整的支付记录和历史分析，支持搜索和筛选
• ✅ 数据导入导出 - CSV、JSON格式数据导入导出，支持数据迁移
• ✅ 主题切换 - 支持浅色/深色/系统主题，个性化界面
• ✅ 国际化界面 - 完整的中英文双语支持，支持语言切换
• ✅ 定时任务 - 自动续费处理、汇率更新、数据统计等定时任务
• ✅ 许可证验证 - 完整的许可证验证系统，支持远程验证和本地缓存
• ✅ 智能限制管理 - 基于许可证类型的订阅数量限制和功能访问控制
• ✅ 宽限期机制 - 服务器不可用时的智能降级和宽限期处理

• ✅ RESTful API - 完整的API接口，支持前端和后端分离
• ✅ 数据库迁移 - 支持数据库结构升级和迁移
• ✅ 错误处理 - 完善的错误处理和日志记录
• ✅ 健康检查 - 内置健康检查端点，支持容器化部署
• ✅ API认证 - 基于API Key的安全认证机制

• 框架: React 18 + TypeScript
• 构建工具: Vite 6.3.1
• 样式: Tailwind CSS + shadcn/ui
• 状态管理: Zustand 4.5.0
• 路由: React Router DOM 6.22.1
• 图表: Recharts 2.15.3
• UI组件: Radix UI
• 表单: React Hook Form 7.56.1
• 主题: next-themes 0.4.6
• 工具库:
  • date-fns 3.6.0 (日期处理)
  • axios 1.10.0 (HTTP客户端)
  • uuid 9.0.1 (唯一标识符)

• 运行时: Node.js 20+
• 框架: Express 5.1.0
• 数据库: SQLite + better-sqlite3 12.1.1
• 定时任务: node-cron 3.0.3
• API认证: API Key
• CORS: cors 2.8.5
• HTTP客户端: axios 1.6.0

• 容器化: Docker + Docker Compose
• 进程管理: dumb-init
• 健康检查: 内置健康检查端点
• 多阶段构建: 前端构建 + 后端部署

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   前端 (React)   │    │   后端 (Node.js) │    │   数据库 (SQLite) │
│                 │    │                 │    │                 │
│ - TypeScript    │◄──►│ - Express 5     │◄──►│ - better-sqlite3 │
│ - Vite          │    │ - RESTful API   │    │ - 本地存储       │
│ - Tailwind CSS  │    │ - 中间件        │    │ - 事务支持       │
│ - Zustand       │    │ - 定时任务      │    │ - 外键约束       │
└─────────────────┘    └─────────────────┘    └─────────────────┘

Subscription-Management/
├── src/                    # 前端源码
│   ├── components/        # React组件
│   │   ├── ui/           # 基础UI组件
│   │   ├── subscription/ # 订阅相关组件
│   │   ├── dashboard/    # 仪表板组件
│   │   ├── charts/       # 图表组件
│   │   └── layouts/      # 布局组件
│   ├── pages/            # 页面组件
│   ├── store/            # 状态管理
│   ├── services/         # API服务
│   ├── utils/            # 工具函数
│   ├── types/            # TypeScript类型
│   └── locales/          # 国际化文件
├── server/               # 后端源码
│   ├── controllers/      # 控制器层
│   ├── services/         # 服务层
│   ├── routes/           # 路由层
│   ├── middleware/       # 中间件
│   ├── db/              # 数据库相关
│   ├── config/          # 配置文件
│   └── utils/           # 工具函数
├── docs/                # 文档目录
└── docker-compose.yml   # Docker配置

• 订阅管理服务 - 处理订阅的CRUD操作和生命周期管理
• 汇率服务 - 管理多币种汇率转换和自动更新
• 分析服务 - 提供费用分析和统计功能
• 定时任务服务 - 处理自动续费和汇率更新
• 支付历史服务 - 管理支付记录和历史追踪

• Docker: 20.10.0 或更高版本（推荐）
• Node.js: 20+ 版本（本地开发）
• 内存: 至少 512MB
• 存储: 至少 100MB 可用空间
• 网络: 需要互联网连接（用于汇率更新和许可证验证）

数据目录准备

# 创建数据目录并设置权限
mkdir -p ${PWD}/subscription-manager/data
chown -R 1001:1001 ${PWD}/subscription-manager/data
chmod 755 ${PWD}/subscription-manager/data

停止并删除老的容器

# 停止并删除老的容器
docker stop subscription-manager
docker rm subscription-manager

部署应用

# 部署
docker run -d \
  --name subscription-manager \
  --restart unless-stopped \
  --user 0 \
  -p 3001:3001 \
  -v ${PWD}/subscription-manager/data:/app/data \
  -e API_KEY="your_secret_api_key_here" \
  -e TIANAPI_KEY="your_tianapi_key_here" \
  -e PORT="3001" \
  -e BASE_CURRENCY="CNY" \
  -e NODE_ENV="production" \
  -e VITE_API_URL="/api" \
  -e DATABASE_PATH="/app/data/database.sqlite" \
  zhoujie218/subscription-manager:latest

访问应用

• 前端界面: http://localhost:5173

1. 设置API密钥

   • 配置API密钥 API_KEY，就是你的管理订阅的密码
   • 配置货币汇率API TIANAPI_KEY（可选，用于自动汇率更新）

2. 配置基础货币

   • 在设置页面选择基础货币
   • 默认支持 CNY, USD, EUR, GBP, CAD, AUD, JPY, TRY

3. 添加订阅

   • 点击"添加订阅"按钮
   • 填写订阅信息（名称、金额、币种、计费周期等）
   • 选择分类和支付方式

4. 导入数据（可选）

   • 支持CSV和JSON格式数据导入
   • 在设置页面使用导入功能

• 免费版 - 限制7个订阅，基础功能
• 专业版 - 无限制订阅，1年有效期
• 荣誉终生版 - 无限制订阅，永久有效

1. 访问设置页面
2. 点击"许可证管理"
3. 输入许可证密钥
4. 点击"验证许可证"

# 通过Web界面导出
# 设置 -> 数据管理 -> 导出数据

# 或直接备份数据库文件
cp server/database.sqlite backup.sqlite

# 通过Web界面导入
# 设置 -> 数据管理 -> 导入数据

# 或直接恢复数据库文件
cp backup.sqlite server/database.sqlite

• Docker 部署：数据库位于 DATABASE_PATH 环境变量指定的路径（默认：/app/data/database.sqlite）

配置以下变量（可选）：

# API安全密钥 (必需)
API_KEY=your_secret_api_key_here

# 服务端口 (可选，默认3001)
PORT=3001

# 基础货币 (可选，默认CNY)
BASE_CURRENCY=CNY

# 天行数据API密钥 (可选，用于汇率更新)
TIANAPI_KEY=your_tianapi_key_here

# 数据库路径 (Docker部署时使用)
DATABASE_PATH=/app/data/database.sqlite

# 环境模式 (可选，默认production)
NODE_ENV=production

# 时区设置 (可选，默认Asia/Shanghai)
TZ=Asia/Shanghai

server {
    listen 80;
    server_name your-domain.com;
    
    location / {
        proxy_pass http://localhost:3001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

• 快速开始指南 - 5分钟快速启动项目
• API接口文档 - 完整的API接口说明

添加订阅

1. 点击"添加订阅"按钮
2. 填写订阅信息（名称、金额、计费周期等）
3. 选择分类和支付方式
4. 点击"保存"

管理订阅

• 编辑：点击订阅卡片上的编辑按钮
• 删除：点击订阅卡片上的删除按钮
• 状态管理：可以设置订阅为活跃、试用或已取消

查看报告

• 仪表板：查看总体费用概览
• 费用报告：查看详细的费用分析图表
• 支付历史：查看所有支付记录

数据管理

• 导入数据：支持CSV和JSON格式数据导入
• 导出数据：支持CSV和JSON格式数据导出
• 备份数据：定期备份数据库文件

系统提供完整的RESTful API接口，支持以下功能：

• 订阅管理 - 订阅的增删改查操作
• 支付历史 - 支付记录的管理和查询
• 费用分析 - 费用统计和分析接口
• 汇率管理 - 汇率查询和更新接口
• 设置管理 - 系统配置和用户设置
• 许可证验证 - 许可证验证和管理接口

系统使用API Key进行认证，需要在请求头中包含：

Authorization: Bearer your_api_key_here

所有API响应都遵循统一的JSON格式：

{
  "success": true,
  "data": {},
  "message": "操作成功",
  "timestamp": "2024-12-19T10:30:00Z"
}

健康检查

GET /api/health

订阅管理

GET    /api/subscriptions              # 获取订阅列表
GET    /api/subscriptions/:id          # 获取单个订阅
POST   /api/protected/subscriptions    # 创建订阅
PUT    /api/protected/subscriptions/:id # 更新订阅
DELETE /api/protected/subscriptions/:id # 删除订阅
POST   /api/protected/subscriptions/bulk # 批量导入

支付历史

GET    /api/payment-history            # 获取支付历史
POST   /api/protected/payment-history  # 创建支付记录
PUT    /api/protected/payment-history/:id # 更新支付记录
DELETE /api/protected/payment-history/:id # 删除支付记录

费用分析

GET /api/analytics/expenses            # 获取费用统计
GET /api/analytics/upcoming-renewals   # 获取即将到期的订阅
GET /api/analytics/recently-paid       # 获取最近支付的订阅

设置管理

GET /api/settings                      # 获取设置
PUT /api/protected/settings            # 更新设置

汇率管理

GET  /api/exchange-rates               # 获取汇率列表
PUT  /api/protected/exchange-rates     # 更新汇率
POST /api/protected/exchange-rates/update # 手动更新汇率

分类和支付方式

GET    /api/categories                 # 获取分类列表
POST   /api/protected/categories       # 创建分类
PUT    /api/protected/categories/:value # 更新分类
DELETE /api/protected/categories/:value # 删除分类

GET    /api/payment-methods            # 获取支付方式列表
POST   /api/protected/payment-methods  # 创建支付方式
PUT    /api/protected/payment-methods/:value # 更新支付方式
DELETE /api/protected/payment-methods/:value # 删除支付方式

系统使用SQLite数据库，主要包含以下表结构：

• subscriptions - 订阅信息表
• payment_history - 支付历史表
• categories - 分类表
• payment_methods - 支付方式表
• exchange_rates - 汇率表
• settings - 系统设置表
• monthly_category_summary - 月度分类汇总表

# 检查端口是否被占用
lsof -i :3001

# 检查日志
docker logs subscription-manager

# 重新初始化数据库
cd server
npm run db:reset

• 检查网络连接
• 确认许可证密钥正确
• 查看许可证服务器状态

• 检查 TIANAPI_KEY 是否正确
• 确认网络连接正常
• 查看服务器日志

# 查看容器日志
docker logs subscription-manager

# 实时查看日志
docker logs -f subscription-manager

如果您发现任何问题或有改进建议，请：

1. 查看 Issues 是否已有相关讨论

2. 创建新的 Issue，详细描述问题或建议

3. 如果是 Bug，请提供复现步骤和环境信息

4. 如果是功能请求，请说明使用场景和预期效果

• ✨ 新增: 完整的国际化支持，中英文双语界面
• ✨ 新增: 智能费用分析功能，支持月度、季度、年度分析
• ✨ 新增: 实时汇率更新功能，集成天行数据API
• 🐛 修复: 费用报告页面数据显示问题
• 🐛 修复: 季度和年度卡片排序问题
• 🐛 修复: 月度费用显示最新4个月的问题
• 🔧 优化: 数据库查询性能优化
• 🔧 优化: 前端组件渲染性能优化

• ✨ 新增: 支付历史管理功能
• ✨ 新增: 费用报告和趋势分析
• 🐛 修复: 数据库迁移问题
• 🔧 优化: 用户界面体验改进

• ✨ 新增: 订阅导入导出功能
• ✨ 新增: 多币种支持
• 🐛 修复: 自动续费处理问题
• 🔧 优化: API接口性能优化

感谢所有为这个项目做出贡献的开发者！

• @vbskycn - 项目后续创建者和主要维护者

• @huhusmang - 原始项目创建者

⭐ 如果这个项目对您有帮助，请给我们一个星标！