Penny Lens 项目总览
最后更新：2026-06-25
版本：v1.0
定位：基于复式记账法的跨平台个人财务管理系统
一、核心价值
| 价值 | 描述 |
|---|---|
| 科学记账 | 基于借贷平衡的复式记账法，自动数据校验和平衡检查 |
| 多端同步 | 微信小程序、支付宝小程序、H5、App、PC 五端数据实时同步 |
| 游戏化储蓄 | 存钱罐功能、虚拟交易、目标管理、成就系统 |
| 智能分析 | 收支统计、趋势分析、预算提醒、财务报表生成 |
二、目标用户
- 个人用户：需要科学管理个人收支、养成储蓄习惯
- 家庭用户：需要管理家庭共同账户、多成员财务协同
- 小微企业：需要简单的复式记账和财务报表
三、系统架构概览
┌─────────────────────────────────────────────────────────────┐│ Penny Lens 系统架构 │├─────────────────────────────────────────────────────────────┤│ ││ ┌───────────────────┐ ┌───────────────────┐ ││ │ 小程序端 │ │ PC 端 │ ││ │ (UniApp + Vue3) │ │ (Nuxt 4 + Vue3) │ ││ │ │ │ │ ││ │ • 微信小程序 │ │ • Web 应用 │ ││ │ • 支付宝小程序 │ │ • 数据可视化 │ ││ │ • H5 应用 │ │ • 复杂报表 │ ││ │ • 移动 App │ │ • 多窗口操作 │ ││ └─────────┬─────────┘ └─────────┬─────────┘ ││ │ │ ││ └─────────────┬───────────────┘ ││ │ ││ ▼ ││ ┌─────────────────────────┐ ││ │ 服务端 │ ││ │ (支付宝小程序云) │ ││ │ │ ││ │ • Serverless 函数 │ ││ │ • MongoDB 数据库 │ ││ │ • OSS 文件存储 │ ││ └─────────────────────────┘ ││ │└─────────────────────────────────────────────────────────────┘详细的架构设计请参考：
四、核心功能模块
| 模块 | 功能 | 文档链接 |
|---|---|---|
| 记账模块 | 快速记账、智能分类、批量操作、离线记账 | 详细文档 |
| 资产管理 | 多账户管理、余额跟踪、转账功能 | 详细文档 |
| 储蓄游戏 | 存钱罐、虚拟交易、目标管理、成就系统 | 详细文档 |
| 认证系统 | 多平台登录、QR 码登录、JWT 会话管理 | 详细文档 |
| 文件管理 | 文件上传、OSS 存储、文件预览 | 详细文档 |
| 短链接 | URL 缩短、访问统计、链接管理 | 详细文档 |
五、技术栈总览
| 组件 | 技术栈 | 用途 |
|---|---|---|
| 小程序端 | UniApp + Vue 3 + TypeScript | 跨平台移动端开发 |
| PC 端 | Nuxt 4 + Vue 3 + TypeScript | 现代化 Web 应用 |
| 服务端 | Node.js + TypeScript + MongoDB | Serverless 后端服务 |
| UI 框架 | wot-design-uni + Ant Design Vue | 组件库 |
| 样式引擎 | UnoCSS | 原子化 CSS |
| 状态管理 | Pinia | 状态管理 |
| 构建工具 | Vite | 快速构建 |
详细的技术栈配置请参考 开发指南
六、数据流与同步
小程序/PC 端 ──────┐ │小程序/PC 端 ──────┼──→ 云端 MongoDB ──→ 多端实时同步 │小程序/PC 端 ──────┘- 数据同步：多端数据实时同步至云端 MongoDB
- 离线记账：支持无网络环境下记账，恢复网络后自动同步
- 云端备份：数据安全备份和恢复
- 设备切换：无缝切换设备使用
七、游戏化特色
存钱罐系统
- 设定储蓄目标，视觉化展示进度
- 每周/每月目标追踪
- 达成目标获得成就奖励
虚拟交易系统
- 模拟投资和理财
- 虚拟余额计算
- 宠物等级成长系统
成就系统
- 完成储蓄目标获得徽章
- 连续记账奖励
- 消费控制成就
详细的游戏化设计请参考 储蓄游戏模块文档
八、安全特性
| 特性 | 说明 |
|---|---|
| JWT 认证 | 基于 JWT 的用户认证和授权 |
| 数据加密 | 敏感数据加密存储 |
| 多因素认证 | 支持小程序授权 + QR 码跨设备登录 |
| 审计日志 | 关键操作记录与追踪 |
详细的安全机制请参考 认证系统文档
九、部署与运维
部署方式
- 小程序端：编译发布至微信/支付宝小程序平台
- PC 端：静态资源部署至 CDN/对象存储
- 服务端：Serverless 函数自动部署至支付宝小程序云
运维优势
| 优势 | 说明 |
|---|---|
| 自动扩缩容 | Serverless 根据负载自动调整资源 |
| 零运维 | 无需服务器管理和维护 |
| 成本优化 | 按使用量付费，降低运营成本 |
| 高可用性 | 99.9% 的服务可用性保证 |
十、相关文档
Penny Lens - 让财务管理变得简单、有趣且高效