# Android 智能图书管理系统

## 概述

这是智能图书管理系统（SLMS）的Android客户端实现，提供完整的图书管理功能和AI智能助手。

## 主要功能

### 📚 核心功能
- **图书管理**：浏览、搜索图书
- **借阅管理**：借阅、归还、续借图书
- **用户管理**：用户信息管理
- **数据持久化**：本地数据存储和同步

### 🤖 AI智能功能
- **AI智能助手**：自然语言对话，解答使用问题
- **AI智能搜索**：智能理解搜索意图，提供精准建议
- **AI个性化推荐**：基于用户偏好推荐图书

### 📊 系统功能
- **UML图查看**：查看系统架构和流程图
- **离线运行**：所有AI功能完全离线，无需网络
- **Mock数据**：自动生成演示数据

## 架构设计

### 模块结构

```
android/
├── src/main/java/com/smartlibrary/android/
│   ├── ai/                    # AI服务
│   │   └── SimpleAIService.java
│   ├── data/                  # 数据管理
│   │   └── DataManager.java
│   ├── factory/               # 对象工厂
│   │   └── LibraryObjectFactory.java
│   ├── mock/                  # Mock数据生成
│   │   └── MockDataGenerator.java
│   ├── model/                 # 数据模型
│   │   ├── Book.java
│   │   ├── Loan.java
│   │   └── User.java
│   ├── network/               # 网络服务
│   │   └── ApiService.java
│   ├── ui/                    # UI组件
│   │   ├── AIAssistantFragment.java
│   │   ├── AISearchFragment.java
│   │   ├── AIRecommendFragment.java
│   │   └── UMLViewerActivity.java
│   └── MainActivity.java      # 主Activity
```

### 设计模式

1. **单例模式**
   - `SimpleAIService`：AI服务单例
   - `DataManager`：数据管理器单例

2. **工厂模式**
   - `LibraryObjectFactory`：统一对象创建

3. **观察者模式**
   - `DataManager`：数据变化通知

## 快速开始

### 环境要求

- Android Studio 4.0+
- Android SDK 21+
- Gradle 7.0+

### 构建步骤

1. 克隆项目
```bash
git clone <repository-url>
cd smart-library-management-system
```

2. 打开Android Studio
```
File -> Open -> 选择项目根目录
```

3. 构建项目
```bash
./gradlew :android:build
```

4. 运行应用
```bash
./gradlew :android:installDebug
```

或在Android Studio中点击运行按钮。

## 使用说明

### 首次启动

应用首次启动时会自动：
1. 初始化DataManager
2. 生成Mock数据（50本图书、20个用户、100条借阅记录）
3. 保存数据到本地存储

### AI功能使用

#### AI智能助手
1. 点击主界面的"AI智能助手"按钮
2. 在输入框中输入问题
3. 点击"发送"按钮
4. AI会分析意图并提供相关回答

支持的问题类型：
- 借阅相关："如何借书？"
- 归还相关："怎么还书？"
- 搜索相关："如何搜索图书？"
- 推荐相关："有什么好书推荐？"
- 帮助相关："帮助"

#### AI智能搜索
1. 点击"AI智能搜索"按钮
2. 输入搜索关键词（支持自然语言）
3. 点击"智能搜索"
4. 查看搜索建议和结果

#### AI个性化推荐
1. 点击"AI个性化推荐"按钮
2. 自动加载推荐列表
3. 点击"刷新推荐"获取新推荐

### UML图查看

1. 点击"查看系统UML图"按钮
2. 选择要查看的UML图类型
3. 查看图表信息
4. 如有网络，可点击"打开Web端查看"

## 核心组件说明

### SimpleAIService

AI服务提供者，负责处理所有AI相关功能。

**主要方法**：
- `chat(String message)`：AI对话
- `smartSearch(String query)`：智能搜索
- `getRecommendation(String userId)`：个性化推荐

**特点**：
- 完全离线运行
- 基于规则的意图识别
- 上下文相关的响应生成

### DataManager

数据管理器，负责所有数据的CRUD操作和持久化。

**主要方法**：
- `getBooks()`：获取所有图书
- `addBook(Book book)`：添加图书
- `initializeMockData()`：初始化Mock数据
- `hasMockData()`：检查是否有数据

**特点**：
- 单例模式
- 观察者模式支持
- SharedPreferences持久化
- 自动Mock数据生成

### MockDataGenerator

Mock数据生成器，生成演示数据。

**主要方法**：
- `generateBooks(int count)`：生成图书
- `generateUsers(int count)`：生成用户
- `generateLoans(int count, List<Book>, List<User>)`：生成借阅记录

**特点**：
- 多样化的数据模板
- 真实的数据格式
- 可配置的生成数量

### LibraryObjectFactory

对象工厂，统一创建各种对象。

**主要方法**：
- `createBook(...)`：创建图书对象
- `createUser(...)`：创建用户对象
- `createLoan(...)`：创建借阅记录对象

**特点**：
- 参数验证
- 自动生成ID
- 设置默认值

## 数据模型

### Book（图书）
- `id`：图书ID
- `title`：标题
- `author`：作者
- `isbn`：ISBN号
- `category`：分类
- `status`：状态（available/borrowed/reserved）

### User（用户）
- `id`：用户ID
- `name`：姓名
- `email`：邮箱
- `phone`：电话

### Loan（借阅记录）
- `id`：借阅ID
- `bookId`：图书ID
- `userId`：用户ID
- `loanDate`：借阅日期
- `dueDate`：归还日期
- `returnDate`：实际归还日期
- `status`：状态（active/returned/overdue）

## 离线功能

所有AI功能都是完全离线的：
- ✅ 无需网络连接
- ✅ 无需后端服务
- ✅ 数据本地存储
- ✅ 即时响应

这使得应用可以在任何环境下运行，非常适合演示和测试。

## 错误处理

应用实现了全面的错误处理：

1. **数据层**：捕获存储异常，提供降级方案
2. **AI服务**：验证输入，提供友好错误消息
3. **UI层**：处理生命周期问题，防止崩溃
4. **网络层**：检查连接状态，优雅降级

## 性能优化

1. **懒加载**：单例模式延迟初始化
2. **异步处理**：使用Handler避免阻塞UI
3. **数据缓存**：内存缓存减少IO操作
4. **限制数据量**：Mock数据数量适中

## 测试

### 单元测试

运行单元测试：
```bash
./gradlew :android:test
```

### UI测试

运行UI测试：
```bash
./gradlew :android:connectedAndroidTest
```

## 已知限制

1. **图片展示**：UML图暂不支持直接在移动端展示
2. **网络同步**：需要后端服务支持（可选）
3. **真实AI**：当前使用规则引擎，未集成真实AI模型

## 未来增强

1. **真实AI集成**：接入GPT等AI服务
2. **图片查看**：支持UML图直接展示
3. **数据同步**：完整的后端同步功能
4. **推送通知**：到期提醒等
5. **语音输入**：支持语音与AI对话

## 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork项目
2. 创建特性分支
3. 提交更改
4. 推送到分支
5. 创建Pull Request

## 许可证

[项目许可证信息]

## 联系方式

如有问题或建议，请联系：
- 项目主页：[项目URL]
- 问题追踪：[Issues URL]

---

**注意**：本应用使用Mock数据进行演示，所有AI功能均为模拟实现。