初始化项目

This commit is contained in:
2025-12-06 09:10:24 +08:00
parent d730752f01
commit c9fcfc761e
35 changed files with 4283 additions and 295 deletions

99
README.md Normal file
View 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用于数据持久化。