# AI 全链路校园效率优化智能中枢

**Repository Path**: BDFS_BCS/bigproject

## Basic Information

- **Project Name**: AI 全链路校园效率优化智能中枢
- **Description**: AI中枢打通校园多场景高效协同
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-16
- **Last Updated**: 2026-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# “一语智办”——AI 全链路校园效率优化智能中枢 
## 开发指南

本文章将阐释各个文件的用途和操作，以及一些常见疑难解答。

## 目录

1. 文件结构
2. 协作规范 
3. Issue 任务管理 
4. 仓库空间管理
5. 推荐的IDE

## 1. 文件结构
### 📂 backend 文件夹
后端组代码存放位置，存放Python文件

### 📂 electron 文件夹 (暂未确定)
Electron 软件组代码存放位置，存放软件配置等

### 📂 web 文件夹 (暂未确定)
前端组代码存放位置，存放 HTML、CSS、JS文件

### 📂 docs 文件夹 (⚠️重要)
存放后端同学编写逻辑的api接口文档，在后端组同学实现新功能前，**一定**要过来写接口调用文档。

## 2. 协作规范 ⚖️
### 👥 团队协作原则
为了保证项目开发的有序进行，请各组成员严格遵守以下协作规范：

- 各组成员**仅负责维护自己所在小组的代码文件**，不得随意修改或删除其他组成员的代码文件
- 如发现其他组代码存在问题，应通过正式沟通渠道（如会议、工单系统、代码评审）反馈，由对应负责人进行修改
- 跨组协作需求需提前沟通确认，确保接口定义清晰、职责边界明确
- 任何涉及多组的改动，必须经过相关小组负责人同意后方可实施

### 🌿 分支管理规范
- 所有的新功能开发**必须**拉取 `develop` 分支，不要拉取 `master` 分支
- 不要拉取别人创建好的分支（除非有合作）
- 请在本地开发完成后推送至自己的远程分支，然后通过 Pull Request 合并到 `develop` 分支

### ⚠️ 特别注意
- 后端组：专注于 [backend](./backend/) 目录下的业务逻辑开发
- 前端组：专注于 [web](./web/) 目录下的界面和交互开发
- Electron组：专注于 [electron](./electron/) 目录下的桌面应用开发
- 各组均需共同维护 [docs](./docs/) 目录下的接口文档，但应遵循API文档规范 📚

## 3. Issue 任务管理 📋
### 🚀 创建任务
- 当需要开发新功能或修复 Bug 时，应在 Issue 中创建相应任务
- 选择合适的模板（如 Bug 反馈、前端任务、API 请求等）
- 详细描述任务内容、需求和预期结果

### 🎯 领取任务
- 开发人员可在 Issue 中浏览待处理的任务
- 在任务下方留言表示领取该任务
- 任务领取后应及时更新状态并开始开发
- 完成任务后关闭对应的 Issue

## 4. 仓库空间管理 📦
### ⚠️ 重要提醒
- 仓库空间有限（只有500MB），不要把编译器、解释器、打包后的资源上传到仓库
- 打包后的可执行文件请发布在Release中。
- 图片资源请上传软件对应需要的尺寸，不要重复上传资源
- 请合理控制提交的文件大小，避免影响仓库性能

## 5 推荐的IDE

### 前端开发推荐IDE
- WebStorm: https://download.jetbrains.com/webstorm/WebStorm-2025.3.1.1.exe
- VSCode: https://code.visualstudio.com/sha/download?build=stable&os=win32-x64-user

### 后端开发推荐IDE
- PyCharm: https://download.jetbrains.com/python/pycharm-2025.3.1.1.exe