公司客户通信管理系统

项目概述

本系统旨在对公司的客户通讯录以及与客户的通信情况进行全面管理。通过该系统，可以高效地管理客户信息、客户联络员信息、公司业务员信息，并记录业务员与客户联络员之间的通信情况。

背景说明

公司 A 有多个客户，每个客户也是一个公司。每个客户有多名联络员与 A 公司进行联络。A 公司有多名业务员负责与客户进行联络，每名业务员负责联络的客户可能是不同的，例如业务员 p 负责与客户 X、Y 联络，而业务员 q 负责与客户 Y、Z 联络。

系统管理以下信息：

• 客户信息：客户名称、客户所在区域（如东北、华北等）、客户地址、客户公司法人、客户规模（大、中、小，这个可以自行定义）、与本公司业务联系程度（高、中、低等，这个可以自行定义）、客户公司邮箱、客户公司联络电话等。
• 客户联络员信息：姓名、性别、生日、电子邮箱、电话等。
• 业务员信息：姓名、性别、生日、电子邮箱、电话等。
• 通信记录：客户公司名称、客户联络员名称、通信时间（年、月、日、时、分、秒）、通信时长（按分钟计）、通信内容（文字记录）等。

项目原理

本项目采用三层架构：前端、Web 服务器（Flask）和后端（C 程序）。

1. 后端（C 语言）

• 功能：
  • 管理客户信息（增、删、改、查）。
  • 管理客户联络员信息（增、删、改、查）。
  • 管理业务员信息（增、删、改、查）。
  • 记录和管理通信记录。
  • 数据存储在文本文件中（如 data/client.txt、data/contact.txt、data/sales.txt、data/communication.txt）。
• 实现方式：
  • 使用链表结构在内存中管理客户、联络员、业务员和通信记录数据。
  • 通过命令行参数接收操作指令，例如 ./main add_client 添加客户，./main list_clients 显示客户列表。
  • 从标准输入（stdin）读取数据，输出结果到标准输出（stdout）。

2. Web 服务器（Flask）

• 功能：
  • 提供 RESTful API 接口，接收前端请求并与 C 程序交互。
  • 服务前端静态文件（如 index.html、styles.css 和 scripts.js 等）。
• 实现方式：
  • 使用 Python 的 subprocess 模块调用 C 程序（main.exe），传递数据并接收结果。
  • 将前端的 JSON 请求转换为 C 程序所需的输入格式。
• API 示例：
  • 添加客户：/api/add_client（POST）
  • 显示客户列表：/api/list_clients（GET）

3. 前端

• 功能：
  • 提供用户友好的界面，用于输入和管理客户、联络员、业务员信息以及通信记录。
• 实现方式：
  • 使用 HTML 构建表单和展示区域。
  • 使用 CSS 美化界面。
  • 使用 JavaScript 通过 AJAX 与 Flask API 通信，实现动态交互。
• 交互流程：
  • 用户填写表单并提交，数据通过 POST 请求发送到 Flask。
  • Flask 返回操作结果，前端解析并显示。

项目架构图

+-----------------+       +-----------------+       +-----------------+
|     前端        | <-->  |    Flask API    | <-->  |    C 后端       |
| (HTML/CSS/JS)   |       |    (Python)     |       |   (数据管理)    |
+-----------------+       +-----------------+       +-----------------+

安装与运行

1. 环境要求

• 操作系统：Windows（也可适配 Linux/macOS）
• 工具：
  • GCC（用于编译 C 代码，例如 MinGW）
  • Python 3.x
  • Flask（Python 包）

2. 安装步骤

• 编译 C 代码：

  cd backend
  gcc -o main src/main.c src/client_manager.c src/user_manager.c src/sales_manager.c src/communication_manager.c src/file_manager.c src/group_manager.c src/backup_manager.c -I include

  • 生成 main.exe（Windows）或 main（Linux/macOS）。
  • 确保包含所有相关的 .c 文件。

• 安装 Python 依赖：

  pip install flask

• 目录结构：

  Communication-Management-System/
  ├── LICENSE
  ├── README.md
  ├── run.bat
  ├── run.sh
  ├── backend/
  │   ├── main.exe
  │   ├── server.py
  │   ├── backups/
  │   ├── data/
  │   │   ├── client.txt
  │   │   ├── communication.txt
  │   │   ├── group.txt
  │   │   ├── sales.txt
  │   │   └── user.txt
  │   ├── include/
  │   │   ├── backup_manager.h
  │   │   ├── client.h
  │   │   ├── client_manager.h
  │   │   ├── communication.h
  │   │   ├── communication_manager.h
  │   │   ├── file_manager.h
  │   │   ├── group.h
  │   │   ├── group_manager.h
  │   │   ├── sales.h
  │   │   ├── sales_manager.h
  │   │   ├── user.h
  │   │   ├── user_manager.h
  │   │   └── utils.h
  │   └── src/
  │       ├── backup_manager.c
  │       ├── client_manager.c
  │       ├── communication_manager.c
  │       ├── file_manager.c
  │       ├── group_manager.c
  │       ├── main.c
  │       ├── sales_manager.c
  │       ├── user_manager.c
  │       └── utils.c
  └── frontend/
  	├── index.html
  	├── css/
  	│   ├── login.css
  	│   └── manager.css
  	├── js/
  	│   ├── admin.js
  	│   ├── client.js
  	│   ├── communication.js
  	│   ├── global.js
  	│   ├── group.js
  	│   ├── login.js
  	│   ├── sales.js
  	│   └── user.js
  	└── pages/
  		└── manager.html
  

3. 运行项目

• 启动 Flask 服务器：

  cd backend
  python server.py

  • 默认运行在 http://127.0.0.1:5000。

• 访问网页： 在浏览器中打开 http://127.0.0.1:5000/。

---