# 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用于数据持久化。