README.md

# 分支机构活动管理系统

这是一个基于Django开发的分支机构活动管理系统，用于管理公司各分支机构的活动、人员、设备和预算等信息。

## 功能特点

- **分支机构管理**：维护分支机构的基本信息、联系方式、分类和状态
- **活动管理**：记录分支机构的新建、搬迁、装修、撤销等活动信息
- **联系人管理**：管理各分支机构的联系人信息及分类
- **设备间图片管理**：上传和管理分支机构设备间的图片
- **图纸管理**：上传和管理分支机构相关图纸
- **预算管理**：管理活动预算、设备预算和基础设施预算
- **终端设备管理**：管理视频终端等设备信息
- **公共屏幕管理**：管理分支机构的公共屏幕信息

## 技术栈

- **后端框架**：Django
- **数据库**：SQLite
- **前端技术**：HTML、CSS、Tailwind CSS
- **表单处理**：Django Forms
- **模板引擎**：Django Templates

## 项目结构

```
fzjgact/
├── fzjgact/           # 项目配置目录
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── huodong/           # 主应用目录
│   ├── migrations/    # 数据库迁移文件
│   ├── static/        # 静态资源
│   ├── templates/     # 模板文件
│   ├── templatetags/  # 自定义模板标签
│   ├── __init__.py
│   ├── admin.py       # 后台管理配置
│   ├── apps.py        # 应用配置
│   ├── models.py      # 数据模型
│   ├── serializers.py # 序列化器
│   ├── tests.py       # 测试文件
│   ├── urls.py        # 应用路由
│   └── views.py       # 视图函数
├── db.sqlite3         # 数据库文件
├── manage.py          # Django管理脚本
├── tailwind.config.js # Tailwind CSS配置
└── requirements.txt   # 依赖文件（需创建）
```

## 安装和运行

### 1. 环境要求

- Python 3.7+
- Django 3.2+
- 其他依赖（见requirements.txt）

### 2. 安装步骤

1. **克隆项目**

   ```bash
   git clone <项目地址>
   cd 分支机构活动
   ```

2. **创建虚拟环境**

   ```bash
   python -m venv venv
   ```

3. **激活虚拟环境**

   - Windows:
     ```bash
     venv\Scripts\activate
     ```
   - Linux/Mac:
     ```bash
     source venv/bin/activate
     ```

4. **安装依赖**

   ```bash
   pip install -r requirements.txt
   ```

5. **初始化数据库**

   ```bash
   cd fzjgact
   python manage.py migrate
   ```

6. **创建超级用户**

   ```bash
   python manage.py createsuperuser
   ```

7. **启动开发服务器**

   ```bash
   python manage.py runserver
   ```

### 3. 访问系统

- 后台管理：http://localhost:8000/admin
- 前端页面：http://localhost:8000

## 使用说明

### 后台管理

1. 使用超级用户登录后台管理界面
2. 可以管理以下模块：
   - 分支机构信息
   - 联系人管理
   - 活动记录
   - 设备间图片
   - 图纸管理
   - 预算信息
   - 公共屏幕
   - 视频终端

### 前端功能

1. **分支机构列表**：查看所有分支机构信息
2. **分支机构详情**：查看分支机构的详细信息、联系人、活动等
3. **设备间图片**：查看分支机构设备间的图片
4. **公共屏幕**：查看公共屏幕信息
5. **视频终端**：查看视频终端信息
6. **统计信息**：查看系统统计数据

## 自定义命令

- `randomize_background_color`：为分支机构随机生成背景颜色

## 开发说明

### Tailwind CSS

项目使用Tailwind CSS进行样式开发：

1. 配置文件：`tailwind.config.js`
2. 启动Tailwind开发服务器：
   ```bash
   ./tailwindcss-windows-x64.exe -i ./huodong/static/huodong/input.css -o ./huodong/static/huodong/output.css --watch
   ```

### 数据模型

主要数据模型包括：
- Branch（分支机构）
- Contact（联系人）
- Activity（活动）
- EquipmentImage（设备间图片）
- Drawing（图纸）
- Budget（预算）
- PublicScreen（公共屏幕）
- VideoTerminal（视频终端）

## 许可证

[MIT License](LICENSE)

## 更新日志

### v1.0
- 初始版本
- 实现基本的分支机构和活动管理功能

### v1.1
- 增加联系人管理功能
- 增加设备间图片管理

### v1.2
- 增加图纸管理功能
- 增加预算管理功能

### v1.3
- 增加公共屏幕和视频终端管理
- 优化界面样式