99 lines
2.7 KiB
Markdown
99 lines
2.7 KiB
Markdown
# CID广告管理系统
|
||
|
||
## 项目简介
|
||
|
||
CID广告管理系统是一个完整的广告投放和管理平台，支持广告主管理、广告管理、广告位管理和数据统计分析等功能。
|
||
|
||
## 功能模块
|
||
|
||
### 1. 广告管理
|
||
- 广告创建、编辑、删除
|
||
- 广告审核流程
|
||
- 广告状态管理
|
||
- 广告投放设置
|
||
- 广告定向设置
|
||
- 广告统计数据
|
||
|
||
### 2. 广告主管理
|
||
- 广告主注册、审核
|
||
- 广告主信息维护
|
||
- 广告主账户管理
|
||
- 充值和授信额度管理
|
||
- 广告主状态管理
|
||
|
||
### 3. 广告位管理
|
||
- 广告位创建、编辑
|
||
- 广告位状态管理
|
||
- 广告位定价设置
|
||
- 广告位展示规则
|
||
- 广告位统计数据
|
||
|
||
### 4. 广告统计与报表
|
||
- 广告效果统计
|
||
- 数据可视化仪表盘
|
||
- 自定义报表生成
|
||
- 报表导出功能
|
||
- 数据趋势分析
|
||
|
||
### 5. 广告匹配与投放
|
||
- 基于用户画像的广告匹配
|
||
- 实时广告投放
|
||
- 广告频次控制
|
||
- 广告预算控制
|
||
|
||
## 技术架构
|
||
|
||
### 技术栈
|
||
- Go语言 + GoFrame框架
|
||
- MongoDB 数据库
|
||
- Redis 缓存
|
||
- RESTful API设计
|
||
|
||
### 项目结构
|
||
```
|
||
cidservice/
|
||
├── consts/ # 常量定义
|
||
├── controller/ # 控制器层
|
||
│ ├── advertisement_controller.go
|
||
│ ├── advertiser_controller.go
|
||
│ ├── ad_position_controller.go
|
||
│ └── ad_statistics_controller.go
|
||
├── dao/ # 数据访问层
|
||
│ ├── advertisement_dao.go
|
||
│ ├── advertiser_dao.go
|
||
│ ├── ad_position_dao.go
|
||
│ └── ad_statistics_dao.go
|
||
├── model/ # 模型定义
|
||
│ ├── dto/ # 数据传输对象
|
||
│ └── entity/ # 实体对象
|
||
└── service/ # 服务层
|
||
├── advertisement_service.go
|
||
├── advertiser_service.go
|
||
├── ad_position_service.go
|
||
└── ad_statistics_service.go
|
||
```
|
||
|
||
## 部署说明
|
||
|
||
1. 配置MongoDB和Redis连接
|
||
2. 修改config.yml配置文件
|
||
3. 执行`go run main.go`启动服务
|
||
4. 服务默认运行在3002端口
|
||
|
||
## API文档
|
||
|
||
API文档可以通过Swagger或Postman查看，主要接口包括：
|
||
|
||
- 广告管理：/advertisement/add, /advertisement/update, /advertisement/list等
|
||
- 广告主管理：/advertiser/add, /advertiser/update, /advertiser/list等
|
||
- 广告位管理：/adposition/add, /adposition/update, /adposition/list等
|
||
- 广告统计：/statistics/list, /dashboard等
|
||
- 报表管理：/report/create, /report/list, /report/download等
|
||
|
||
## 开发规范
|
||
|
||
项目遵循原customerservice项目的开发规范，包括分层架构、命名规范和错误处理等。
|
||
|
||
## 扩展说明
|
||
|
||
系统支持水平扩展，可以通过增加广告服务实例来提高处理能力，Redis用于缓存和队列，MongoDB用于数据持久化。 |