SpendSmart 开源项目教程

1. 项目介绍

SpendSmart 是一个开源的 iOS 应用，它利用人工智能技术使收据管理变得轻松简单。用户只需拍摄一张或几张收据的照片，SpendSmart 就能自动提取所有关键信息，如商店名称、位置、商品、总价、支付方式等。

2. 项目快速启动

要开始使用 SpendSmart，请按照以下步骤操作：

# 克隆项目
git clone https://github.com/yourusername/SpendSmart.git
# 进入项目目录
cd SpendSmart

在开始构建项目之前，你需要在项目根目录下创建一个名为 APIKeys.swift 的文件，并填入以下内容（替换为你的实际 API 密钥）：

let supabaseURL = "YOUR_SUPABASE_URL"
let supabaseAnonKey = "YOUR_SUPABASE_ANON_KEY"
let supabaseServiceRoleKey = "YOUR_SUPABASE_SERVICE_ROLE_KEY"
let geminiAPIKey = "YOUR_GEMINI_API_KEY"
let secretKey = "YOUR_SECRET_BACKEND_KEY"
let imgBBAPIKey = "YOUR_IMGBB_API_KEY"

请注意，不要将这个文件提交到版本控制中。

3. 应用案例和最佳实践

应用案例

• 个人财务管理：用户可以通过 SpendSmart 跟踪他们的支出，自动分类并生成支出报告。
• 家庭预算管理：家庭成员可以共享一个账户，共同管理家庭预算，跟踪家庭支出。

最佳实践

• 代码规范：保持代码清晰、简洁，遵循 Swift 和 SwiftUI 的编码规范。
• 模块化设计：将功能划分为独立的模块，便于维护和测试。
• 测试覆盖：编写单元测试和 UI 测试，确保代码的质量和稳定性。
• 文档完善：为代码和项目提供详细的文档，方便其他开发者理解和贡献。

4. 典型生态项目

SpendSmart 可以与以下生态项目结合使用，以增强其功能和用户体验：

• Supabase：用于数据同步和存储的 backend-as-a-service 平台。
• Gemini 2.0 Flash：用于收据识别的 AI OCR 服务。
• imgBB：用于图片上传和分享的服务。

通过这些典型的生态项目，SpendSmart 能够提供更加完善和强大的财务管理解决方案。