# card

**Repository Path**: linjunbin0101/card

## Basic Information

- **Project Name**: card
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-06
- **Last Updated**: 2026-03-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 卡包 - Card Wallet

一个简约风格的Android卡包管理应用，使用Kotlin + Jetpack Compose开发。

## 功能特性

- 📋 **卡片管理** - 支持银行卡、会员卡、身份证、社保卡、驾驶证、护照等多种卡片类型
- 🔍 **快速搜索** - 按名称、卡号、备注快速查找卡片
- 🏷️ **分类筛选** - 按卡片类型分类浏览
- ⭐ **收藏功能** - 标记常用卡片，新收藏的排在前面
- 📷 **照片管理** - 支持上传多张卡片照片，点击预览查看大图，支持双指缩放
- 📝 **备注功能** - 为卡片添加备注信息
- 🔒 **本地存储** - 数据完全存储在本地，保护隐私安全
- 📊 **智能排序** - 新增卡片排在前面，收藏按收藏时间排序，编辑不影响位置

## 技术栈

- **语言**: Kotlin
- **UI框架**: Jetpack Compose + Material3
- **数据库**: Room
- **导航**: Navigation Compose
- **图片加载**: Coil
- **架构**: MVVM

## 项目结构

```
app/src/main/java/com/lins/card/
├── CardApplication.kt          # Application类
├── MainActivity.kt             # 主Activity
├── data/
│   ├── model/                  # 数据模型
│   │   ├── Card.kt            # 卡片实体
│   │   └── CardCategory.kt    # 分类枚举
│   ├── local/                  # 本地数据
│   │   ├── CardDao.kt         # 数据访问对象
│   │   └── CardDatabase.kt    # Room数据库
│   └── repository/             # 数据仓库
│       └── CardRepository.kt
└── ui/
    ├── theme/                   # 主题配置
    │   ├── Color.kt
    │   ├── Theme.kt
    │   └── Typography.kt
    ├── components/              # UI组件
    │   ├── CardItem.kt
    │   ├── CategoryFilter.kt
    │   ├── SearchBar.kt
    │   └── EmptyState.kt
    ├── screens/                 # 页面
    │   ├── HomeScreen.kt
    │   └── CardEditScreen.kt
    ├── viewmodel/               # 视图模型
    │   └── CardViewModel.kt
    └── navigation/              # 导航
        └── Navigation.kt
```

## 环境要求

- Android Studio Hedgehog 或更高版本
- JDK 11+
- Android SDK 35
- Min SDK 28 (Android 9.0)

## 构建运行

1. 克隆项目
```bash
git clone <repository-url>
cd linsCard
```

2. 使用Android Studio打开项目

3. 等待Gradle同步完成

4. 连接Android设备或启动模拟器

5. 点击运行按钮或执行：
```bash
./gradlew installDebug
```

## 截图

| 主页面 | 编辑页面 |
|--------|----------|
| 卡片列表展示 | 添加/编辑卡片 |

## 支持的卡片类型

| 类型 | 说明 |
|------|------|
| 银行卡 | 借记卡、信用卡等 |
| 会员卡 | 商家会员卡、积分卡等 |
| 身份证 | 居民身份证 |
| 社保卡 | 社会保障卡 |
| 驾驶证 | 机动车驾驶证 |
| 护照 | 出入境证件 |
| 其他 | 其他类型卡片 |

## 后续计划

- [ ] 数据备份与恢复
- [ ] 指纹/密码保护
- [ ] 卡片到期提醒
- [ ] 卡片模板功能
- [ ] 快捷复制卡号

## 许可证

MIT License

## 作者

lins

最后更新：2026-03-07