# storageRoom

**Repository Path**: stdin2/storage-roo

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-26
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# StorageRoo

一个现代化的物品存储管理系统，帮助您高效管理各种储物空间和物品。

## 功能特点

- 多层级储物空间管理
- 物品信息详细记录（名称、描述、数量、图片、标签等）
- 强大的搜索和过滤功能
- 物品迁移功能
- 数据持久化存储
- 清晰的面包屑导航
- 支持深色/浅色主题

## 技术架构

本项目采用现代Android开发最佳实践：

- **架构组件**：MVVM模式 + Jetpack Compose
- **依赖注入**：Hilt
- **数据持久化**：Room数据库
- **数据流**：Kotlin Flow + Coroutines
- **导航**：Jetpack Navigation
- **状态管理**：ViewModel + StateFlow

## 核心功能模块

1. **储物空间管理**
   - 创建/编辑/删除储物空间
   - 支持多级空间结构
   - 空间详情查看

2. **物品管理**
   - 添加/编辑/删除物品
   - 记录物品详细信息
   - 物品数量管理

3. **搜索功能**
   - 全局物品搜索
   - 支持搜索历史记录
   - 按标签、数量范围等条件过滤

4. **物品迁移**
   - 在不同储物空间之间移动物品
   - 支持批量迁移

5. **数据可视化**
   - 清晰的列表展示
   - 图标化空间表示
   - 完整的路径导航

## 使用说明

1. **添加储物空间**
   - 点击主界面右下角"+"按钮
   - 输入空间名称和描述
   - 选择图标类型

2. **添加物品**
   - 进入任意储物空间
   - 点击右下角"+"按钮
   - 输入物品信息并保存

3. **搜索物品**
   - 在主页点击搜索图标
   - 输入关键词进行搜索
   - 查看搜索结果

4. **迁移物品**
   - 在物品详情页点击"移动"按钮
   - 选择目标储物空间
   - 确认迁移

## 贡献指南

欢迎贡献代码！请遵循以下步骤：
1. Fork项目
2. 创建新分支
3. 提交代码更改
4. 创建Pull Request

## 许可证

本项目采用Apache-2.0 License。详情请查看项目根目录的LICENSE文件。