# suixing_app

**Repository Path**: cassan_admin/suixing_app

## Basic Information

- **Project Name**: suixing_app
- **Description**: 用AI生成一个轻社交APP，暂定名称：随行，有想法，一起开发的，可以参与进来，QQ群：518289846，尝试用AI替代我们的部分工作，AI时代已经来临，AI不会淘汰所有的人，但一定会淘汰所有不使用AI的人
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-19
- **Last Updated**: 2025-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 随行 (Suixing) - 轻社交效率工具

## 项目介绍

「随行」是一个一体化的轻社交效率工具，帮助用户在生活与工作中快速记录、联络与回溯。应用提供待办事项、随手拍、随手写、随时AI查询与聊天等功能，强调轻量、及时与安全。项目采用多端架构设计，支持移动APP（Android/iOS/Windows）和微信小程序，后端基于Supabase BaaS服务。

### 核心功能

- **待办事项管理**：创建、编辑、完成待办事项，设置时间/地点提醒
- **随手拍**：拍照或上传图片，自动生成时间/地点标签，支持分享到社区广场
- **随手写**：快速文本记录，支持标签和关联其他内容
- **统一搜索**：按关键词、标签、时间、类型进行全局搜索
- **即时聊天**：与联系人或群组进行实时消息发送
- **好友管理**：通过用户名搜索并添加好友，管理好友列表
- **数据同步**：支持多设备间的数据同步

## 技术架构

### 前端技术栈

#### .NET MAUI 移动应用
- **跨平台框架**：.NET MAUI (支持 Android、iOS、Windows)
- **编程语言**：C#
- **UI框架**：XAML
- **设计模式**：MVVM (Model-View-ViewModel)
- **UI组件库**：CommunityToolkit.Maui
- **状态管理**：INotifyPropertyChanged

#### 微信小程序
- **开发语言**：JavaScript
- **框架**：微信小程序原生框架
- **UI组件**：微信小程序内置组件

### 后端技术栈

#### Supabase BaaS
- **认证与授权**：Supabase Auth (基于 PostgreSQL 的 Row Level Security)
- **数据库**：Supabase Database (PostgreSQL)
- **对象存储**：Supabase Storage (用于存储图片、视频等)
- **实时功能**：Supabase Realtime (用于聊天和实时通知)
- **API**：Supabase 提供自动生成的 RESTful API

### 项目结构

```
suixing_app/
├── app/                  # .NET MAUI 移动应用
│   ├── Models/           # 数据模型
│   ├── Views/            # 视图页面
│   ├── ViewModels/       # 视图模型
│   ├── Services/         # 业务服务
│   ├── Converters/       # 数据转换器
│   └── Platforms/        # 平台特定代码
├── miniprogram/          # 微信小程序前端
│   ├── pages/            # 页面目录
│   ├── utils/            # 工具类
│   └── images/           # 图片资源
├── backend/              # 后端配置与脚本
│   └── supabase/         # Supabase 相关脚本
└── doc/                  # 文档目录
```

## 核心实现细节

### 1. 跨平台架构设计
- 使用 .NET MAUI 实现一套代码库支持多个平台
- 采用 MVVM 模式分离业务逻辑与界面展示
- 通过依赖注入管理服务实例

### 2. Supabase 集成
- 用户认证：基于 Supabase Auth 实现邮箱/密码注册登录
- 数据存储：使用 PostgreSQL 数据库存储用户数据
- 文件存储：通过 Supabase Storage 存储图片和视频
- 实时通信：利用 Supabase Realtime 实现消息推送

### 3. 数据模型设计
- **用户信息表**：存储用户基本信息
- **待办事项表**：管理用户待办事项
- **笔记表**：存储用户笔记内容
- **拍摄内容表**：管理用户拍摄的图片/视频
- **消息表**：存储聊天消息
- **好友关系表**：管理用户间的好友关系
- **权限表**：控制数据访问权限

### 4. 安全机制
- 行级安全策略 (RLS)：确保用户只能访问自己的数据
- 认证令牌：使用 JWT 进行用户身份验证
- 数据加密：敏感数据在传输过程中使用 HTTPS 加密

### 5. 实时功能
- 消息推送：使用 Supabase Realtime 实现实时消息通知
- 数据同步：多设备间数据实时同步

## 安装与部署

### 环境要求
- .NET 10 SDK
- Visual Studio 2022 或更高版本（带 .NET MAUI 工作负载）
- 微信开发者工具
- Supabase 账户

### 构建步骤

#### .NET MAUI 应用
```bash
cd app
dotnet build
```

#### 微信小程序
```bash
cd miniprogram
# 使用微信开发者工具打开项目目录
```

## 项目特点

1. **轻量级设计**：界面简洁，操作直观
2. **多端同步**：数据在移动APP和微信小程序间实时同步
3. **社交属性**：通过图片/视频位置信息发现共同经历的好友
4. **安全性**：基于行级安全策略的数据保护
5. **可扩展性**：模块化设计便于功能扩展

## 参与开发

欢迎加入我们的开发团队！如果您有兴趣参与开发，请：

1. Fork 本仓库
2. 创建功能分支
3. 提交代码
4. 发起 Pull Request

如有任何问题或建议，请加入我们的QQ群：518289846

## 许可证

本项目采用 MIT 许可证，详情请见 [LICENSE](LICENSE) 文件。