# admin 相关接口
POST /admin/user/login 管理员登录

GET  /admin/platform 平台列表获取
GET  /admin/platform/{id} 平台指定数据获取
POST /admin/platform/create 平台创建与更新
POST /admin/platform/update/{id} 指定平台更新

GET  /admin/channel 第三方列表获取
GET  /admin/channel/{id} 第三方指定数据获取
POST /admin/channel/create 第三方创建
POST /admin/channel/update/{id} 指定第三方更新

GET  /admin/app 获取所有的应用列表, 管理员是获取全部
GET  /admin/app/{id} 获取指定的应用id信息
POST /admin/app/verify/{id} 审核指定应用


# business 相关接口
POST /business/user/login 使用方登录

GET  /business/platform 平台列表获取, 用来提供上架筛选处理
GET  /business/channel 第三方列表获取, 用来提供上架筛选处理

GET  /business/app 获取所属使用方的应用
GET  /business/app/{id} 具体应用数据获取
POST /business/app/create 应用创建
POST /business/app/update/{id} 应用更新

GET /business/page/{app_code} 生成的应用广告落地页地址链接, 用于放置第三方广告平台落地页地址


# api 相关接口
POST|GET /api/event/push 事件上报地址, 这里可以是接入的SDK推送, 也可以是落地页推送浏览玩家事件返回

package com.app.cloud.controllers.business;

import jakarta.servlet.http.HttpServletRequest;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.*;

import java.util.Enumeration;
import java.util.HashMap;
import java.util.Map;

@RestController
@RequestMapping("/business/page")
public class BusinessPage {

    /**
     * 日志句柄
     */
    final Logger logger = LoggerFactory.getLogger(getClass());

    /**
     * 请求句柄
     */
    final HttpServletRequest request;

    public BusinessPage(HttpServletRequest request) {
        this.request = request;
    }

    @ResponseBody
    @GetMapping("/{code}")
    public Object show(@PathVariable String code) {
        // todo: 数据库检索是否有对应 app:code 唯一标识码匹配


        // 检索出所有的GET参数准备匹配
        Enumeration<String> names = request.getParameterNames();
        Map<String, String> params = new HashMap<>();
        while (names.hasMoreElements()) {
            String name = names.nextElement();
            String value = request.getParameter(name);
            params.put(name, value);
        }

        // 这里实际上渲染落地下载页面, 有两种方式处理
        // 1. 页面监听JS点击下载事件, 然后推送事件到 /event/push 接口访问量+1(下载才算访问+1)
        // 2. 页面进来直接读取链接的GET参数, 这时候内部渲染完成也代表了访问量+1(渲染完成才算访问+1)
        // 按照上面方式不同浏览量的统计也相应有所不同


        // 以下是提交落地页访问涵盖参数入库, 访问进来也结算为访问量+1
        logger.info("提交参数: {}", params);

        // 数据入库, 注意这里的页面做好限流, 但是要求比如将参数完整入库不要怕浪费数据库空间
        // todo: 这里后续是要做对比跟踪广告链条, 所以数据库需要将 app_id/ip/params(json) 写入数据库

        return String.format("这是应用:%s的落地渲染模板页面", code);
    }

}

package com.app.cloud.controllers.api;


import jakarta.servlet.http.HttpServletRequest;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.Map;

@RestController
@RequestMapping("/api/event")
public class ApiEvent {

    /**
     * 日志句柄
     */
    final Logger logger = LoggerFactory.getLogger(getClass());


    /**
     * 请求句柄
     */
    final HttpServletRequest request;

    public ApiEvent(HttpServletRequest request) {
        this.request = request;
    }


    /**
     * 事件上报必须以POST方式提交, 同时相应传统Rest方式
     * 同时这里要求必须以JSON原生数据提交, 也就是直接提交 { 'xxx':'yyy',... } 方式(contentType: 'application/json;charset=UTF-8')推送上来
     *
     * @return JSON
     */
    @PostMapping("/push")
    public Object push(@RequestBody Map<String, Object> data) {
        // 注意: 虽然空间很宝贵, 但是不要舍不得写入数据库, 广告系统很多都没有调试模式, 在后续排查问题的时候必须不断对比日志来排查问题.
        // 所以建议将本身提交的数据直接入库处理, 在加上IP请求次数限流从而保证数据完整性.
        logger.debug("data: {}", data);

        // todo: 数据库入库保存, 后续就是匹配数据关联出应用数据然后完成用户注册, 这种情况叫做数据归因(用户已经完成注册转化链条)
        // 数据表当中默认 app_id 字段相关留空, 当推送事件的时候插入事件并且尝试对其事件匹配 app_id 和广告计划id

        // todo: 这里需要对数据进行清洗, 方便给事件数据归因到指定应用
        // 内部提交的设备识别码等可以被识别的唯一标识和落地页识别出来唯一标识匹配, 那么就代表这个用户是广告转化用户
        // 如果没有匹配则代表这个用户是自然量用户, 也就是不走第三方广告直接进来的用户, 也就不进行广告成效统计

        // todo: 还有需要注意, 不可能点击之后无限时间的记录都可以被触发为归因玩家, 所以需要设定浏览|下载之后到达N天才被计算归因玩家  
        // 所以需要归因天数的区间, 最好是 CP 方可以灵活配置, 天数为 N > 1 的情况.
        
        // 响应返回JSON
        return "{}";
    }
    
}

package com.app.cloud.controllers.admin;

import jakarta.servlet.http.HttpServletRequest;
import jakarta.validation.Valid;
import lombok.Getter;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.HashMap;


@RestController
@RequestMapping("/admin/user")
public class AdminUser {


    /**
     * 日志句柄
     */
    final Logger logger = LoggerFactory.getLogger(getClass());

    /**
     * 请求句柄
     */
    final HttpServletRequest request;

    public AdminUser(HttpServletRequest request) {
        this.request = request;
    }


    /**
     * 玩家信息结构
     */
    @Getter
    public static class UserForm {

        private String username;

        private String password;
    }


    /**
     * 登录接口, 颁发 token 授权对象
     *
     * @param userForm 提交玩家数据
     * @return JSON
     */
    @PostMapping("/login")
    public Object login(@Valid UserForm userForm) {
        // todo:数据库认证出 `is_supper=1` 的最高管理员即可, 这里后续访问拦截器可以网上查询下 SpringBoot 访问拦截认证
        logger.debug("Login User:{}", userForm);

        // 注意这里响应的 Token 需要在 `Header` 上面加上 `Authoritarian: Token xxx` 做认证处理
        // 拦截器去判断玩家头信息之后认证即可
        String username = userForm.username;
        return new HashMap<>() {{
            put("status", 200);
            put("message", "Ok");
            put("data", new HashMap<>() {{
                put("username", username);
                put("token", "login_token");
            }});
        }};
    }
}