# CommunitySmartSystem

**Repository Path**: aaabackup/community-smart-system

## Basic Information

- **Project Name**: CommunitySmartSystem
- **Description**: 社区智能事件预测与管理平台，目前为：完整、可运行、具备 GIS 能力的全栈 MVP（最小可行性产品），正在完善

完整项目功能：后端重数据处理与 AI 调度，前端重可视化交互，AI 部分兼顾调用 API 与本地模型部署。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 社区智能系统

这是一个全栈项目，包含后端和前端两部分。后端使用 Python 和 FastAPI 构建，前端使用 Vue 3、TypeScript 和 Vite 构建。

## 后端

后端使用 Python 和 FastAPI 构建，包含以下主要功能：

- 用户注册
- 事件管理（创建和读取）

### 技术栈

- Python 3.13
- FastAPI
- SQLAlchemy (异步)
- Pydantic (数据验证)
- JWT (用户认证)

### 文件结构

```
backend/
├── Dockerfile
├── app/
│   ├── main.py          # FastAPI 主文件
│   ├── api/
│   │   ├── endpoints/
│   │   │   ├── users.py # 用户注册端点
│   │   │   └── events.py # 事件管理端点
│   │   └── deps.py       # 依赖项 (如数据库会话)
│   ├── crud/             # 数据库操作
│   │   ├── user.py       # 用户相关数据库操作
│   │   └── event.py      # 事件相关数据库操作
│   ├── models/           # 数据库模型
│   │   ├── user.py
│   │   └── event.py
│   └── schemas/          # 数据验证模型
│       ├── user.py
│       └── event.py
└── requirements.txt     # Python 依赖列表
```

### 数据库迁移

项目包含使用 Alembic 进行数据库迁移的配置。

```
backend/
└── alembic/
    ├── env.py           # 迁移环境配置
    └── versions/
        └── afaaa750a372_init_tables.py # 初始化表迁移脚本
```

## 前端

前端使用 Vue 3、TypeScript 和 Vite 构建。

### 技术栈

- Vue 3
- TypeScript
- Vite (构建工具)
- Tailwind CSS (样式框架)

### 文件结构

```
frontend/
├── index.html           # 主 HTML 文件
├── package.json         # 项目依赖和脚本
├── src/
│   ├── main.ts          # Vue 应用入口文件
│   ├── router/
│   │   └── index.ts     # Vue Router 配置
│   ├── views/
│   │   ├── Dashboard.vue # 仪表盘视图
│   │   └── Login.vue     # 登录视图
│   └── components/
│       └── HelloWorld.vue # 示例组件
└── vite.config.ts       # Vite 配置文件
```

## 运行项目

项目包含 Dockerfile 和 docker-compose.yml 文件，可以使用 Docker 快速启动。

### 构建和运行

1. 构建 Docker 镜像

   ```bash
   docker-compose build
   ```

2. 运行 Docker 容器

   ```bash
   docker-compose up
   ```

3. 访问 API 文档

   打开浏览器，访问 `http://localhost:8000/docs` 查看 FastAPI 自动生成的 API 文档。

## 贡献

如果你有兴趣贡献代码，请先 fork 项目，然后提交 pull request。在贡献代码之前，请确保已经运行过测试，并且代码风格符合项目要求。