初始化项目
This commit is contained in:
99
README.md
Normal file
99
README.md
Normal file
@@ -0,0 +1,99 @@
|
||||
# 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用于数据持久化。
|
||||
Reference in New Issue
Block a user