# CampusResourceShare

**Repository Path**: chzb034/CampusResourceShare

## Basic Information

- **Project Name**: CampusResourceShare
- **Description**: 组长+一成员
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-08
- **Last Updated**: 2026-01-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Campus Resource Share (校园资源共享平台)

这是一个基于 Android 的校园闲置资源共享与交易平台，旨在方便学生之间的物品流通与互助。

## 📋 项目功能简介 (Introduction)

| 功能模块 | 功能描述 |
| :--- | :--- |
| **用户认证 (Auth)** | 支持学生身份认证（学号、手机号），提供注册与登录功能，确保用户身份真实可靠。 |
| **资源发布 (Publish)** | 用户可便捷发布闲置物品，支持上传图片、选择分类（书籍、电子、生活用品等）、填写描述与价格。 |
| **资源浏览 (Market)** | 首页列表展示所有在售物品，支持按类别筛选；详情页使用 NestedScrollView 适配长内容与小屏设备。 |
| **地图模式 (Map)** | 集成 **高德地图 (AMap)**，以地图标记点（Marker）形式直观展示校园内不同地点的资源分布。 |
| **实时聊天 (Chat)** | 基于 **Firebase Realtime Database** 实现的即时通讯功能，支持买卖双方发送文本消息。 |
| **信用体系 (Credit)** | 内置信用积分系统，通过自定义 View (`RingProgressView`) 展示信用分，规范用户行为。 |
| **后台管理 (Admin)** | 管理员可查看全平台物品，支持“违规下架”功能，操作后 App 端实时同步隐藏违规物品。 |

## 🛠️ 技术栈 (Tech Stack)

*   **语言**: [Kotlin](https://kotlinlang.org/)
*   **架构模式**: MVVM (Model-View-ViewModel) + Repository Pattern
*   **依赖注入**: [Hilt](https://dagger.dev/hilt/)
*   **本地数据库**: [Room](https://developer.android.com/training/data-storage/room)
*   **云端/实时数据库**: [Firebase Realtime Database](https://firebase.google.com/docs/database)
*   **地图服务**: [高德地图 Android SDK (AMap)](https://lbs.amap.com/)
*   **图片加载**: [Glide](https://github.com/bumptech/glide)
*   **异步处理**: Coroutines & Flow
*   **UI 组件**: Material Design 3, ViewBinding, NestedScrollView

## 🚀 运行步骤 (Setup Guide)

### 1. 替换高德地图 Key (Replace AMap Key)

本项目使用了高德地图 SDK，需要配置你自己的 API Key 才能正常显示地图。

1.  前往 [高德开放平台](https://lbs.amap.com/) 注册账号并创建应用。
2.  获取 Android 平台的 **Key**。
3.  打开项目文件 `app/src/main/AndroidManifest.xml`。
4.  找到 `<meta-data>` 标签，将 `android:value` 替换为你的 Key：

```xml
<meta-data
    android:name="com.amap.api.v2.apikey"
    android:value="你的高德地图Key" />
```

### 2. 配置 Firebase (Configure Firebase)

本项目使用 Firebase 进行实时聊天和数据同步。

1.  前往 [Firebase Console](https://console.firebase.google.com/) 创建一个新项目。
2.  在 Firebase 项目设置中添加 Android 应用，包名为 `com.hft.campusresourceshare`。
3.  下载生成的 `google-services.json` 配置文件。
4.  将该文件复制到本项目的 `app/` 根目录下（即 `d:\AS\CampusResourceShare\app\google-services.json`）。
5.  在 Firebase Console 中启用 **Realtime Database**，并设置规则（开发测试建议）：

```json
{
  "rules": {
    ".read": true,
    ".write": true
  }
}
```

### 3. 构建与运行

在 Android Studio 中：
1.  点击 `Sync Project with Gradle Files`。
2.  连接 Android 设备或启动模拟器。
3.  运行 `Run 'app'`。

## 📸 项目截图 (Screenshots)

> *此处为占位符，请在 `screenshots` 文件夹放入实际截图并更新路径*

| 登录/注册 | 资源列表 | 地图模式 |
| :---: | :---: | :---: |
| ![Login](screenshots/login_placeholder.png) | ![List](screenshots/list_placeholder.png) | ![Map](screenshots/map_placeholder.png) |

| 物品详情 | 实时聊天 | 个人中心 |
| :---: | :---: | :---: |
| ![Detail](screenshots/detail_placeholder.png) | ![Chat](screenshots/chat_placeholder.png) | ![Profile](screenshots/profile_placeholder.png) |

---
**Note**: 这是一个示例项目，仅供学习与交流使用。