开发TPP方案代码

方案即业务代码，即业务场景需要使用的业务代码，在创建场景前需要完成方案的开发和发布。

创建方案前准备

准备内容

1.新建自己的codeup代码仓库并且设置权限。（目前个性化算法开发平台代码仓库暂时只支持云效代码管理codeup，后续考虑扩展其他仓库类型）

2.下载tpp推荐方案代码模板并且开发业务代码。

3.上传到codeup代码仓库。

新建Codeup仓库

操作步骤

1.登录云效代码管理Codeup控制台（目前可免费使用）。

2.在左侧导航栏，单击“代码库”。

3.在右边页面单击“新建代码库”。

4.在弹出的页面中填写基础信息，基础信息说明参见下表：

5.完成仓库基础信息填写后，单击“确定”完成代码库创建。

授权TPP访问Codeup仓库

操作步骤

1.完成本地Git环境准备；

2.登录云效代码管理Codeup控制台。

3.在个人工作台右上角单击个人信息图标。

4.在弹出的菜单中，单击“个人设置”。

5.在弹出的页面中，设置SSH密钥。

6.配置通过HTTP方式克隆的鉴权账号和密码。

注意：TPP需要使用该方式访问您的代码库，请牢记该账号和密码。

下载TPP方案模版并本地开发代码

操作步骤

2022-03-28 开源代码模板【推荐】具体操作请参考README

# 推荐方案的demo
包含多个demo，可以直接修改使用，上线前请充分测试。
免责声明：本代码只是为了示例，不对任何业务效果负责。

## 环境
* 代码仓库codeup
* jdk使用 1.8
* maven 3.3+
* [maven settings.xml](#本地使用的settings.xml) 

## 目录结构
* src
* main 
* java 包含多个demo，可以直接修改使用
* ABFS使用demo
* BE使用demo
* HTTP使用demo
* Predict使用demo
* Redis使用demo
* hello最简单的demo
* demo完整的推荐demo
* 入口：DemoSolution
* match：BE和redis(x2i)
* feature:user-abfs,context-noting,item-redis
* rank：pai-eas(multi_tower)
* rerank：倒序+过滤+打散
* test 测试用例
非常推荐写测试用例，先在本地测试用例通过后，再发布到tpp
* pom.xml不要修改，加了新的也不会生效

## 关于dependency
总所周知，java依赖包纷繁复杂，一不小心就会出现冲突、漏洞、安全隐患。所以tpp的方案代码不支持用户随便使用jar包，我们会严格控制，尽量保障代码安全可靠。
控制方案：
* 1、采用定制sdk
* 2、采用定制插件
所以pom.xml里写出来的依赖就是可以用的，加了新的dependency最终也不会生效

### 基础的SDK solution-protocol
提供必要的jar
<dependency>
  <groupId>com.aliyun.tpp</groupId>
  <artifactId>solution-protocol</artifactId>
  <version>1.0</version>
</dependency>
比如：context、result、solution

### 常用的服务 ai-service-sdk
提供一些常用的jar，这类jar不是所有人都需要，但比较常用
<dependency>
  <groupId>com.aliyun.tpp</groupId>
  <artifactId>ai-service-sdk</artifactId>
  <version>1.0</version>
</dependency>
比如：abfs、be、eas、redis之类的

### 本地测试 ai-service-sdk-testing
提供一些测试必须的jar
<dependency>
  <groupId>com.aliyun.tpp</groupId>
  <artifactId>ai-service-sdk-testing</artifactId>
  <version>1.0</version>
  <scope>test</scope>
</dependency>

## 常见问题
### 本地使用的settings.xml
修改3个地方mirrors profiles activeProfiles
* mirrors修改
```xml

<mirrors>
  <mirror>
    <id>maven-mirror</id>
    <mirrorOf>central</mirrorOf>
    <name>maven public mirror</name>
    <url>https://repo1.maven.org/maven2/</url>
  </mirror>
</mirrors>

```
* profiles修改
```xml
<profiles>
  <profile>
    <id>aliyun</id>
    <repositories>
      <repository>
        <id>aliyun</id>
        <url>https://maven.aliyun.com/repository/public</url>
        <releases>
          <enabled>true</enabled>
        </releases>
        <snapshots>
          <enabled>false</enabled>
        </snapshots>
      </repository>
      
    </repositories>
    <pluginRepositories>
      <pluginRepository>
        <id>aliyun</id>
        <url>https://maven.aliyun.com/repository/public</url>
        <releases>
          <enabled>true</enabled>
        </releases>
        <snapshots>
          <enabled>false</enabled>
        </snapshots>
      </pluginRepository>
    </pluginRepositories>
  </profile>
</profiles>
```
* activeProfiles修改
```xml
<activeProfiles>
  <activeProfile>aliyun</activeProfile>
</activeProfiles>
```

注意：一定要本地单测，请参考demo中的test例子，单测通过后起码没有逻辑问题。线上环境和本地的差异主要是网络差别，一些用到http/redis/eas之类的远程网络调用需要填写正确的host！

提交代码

操作步骤

1.登录云效代码管理Codeup控制台。

2.在个人工作台单击对应代码库。

3.进行编辑后，单击保存，完成代码提交。

创建方案

操作步骤

1.登录个性化算法开发平台控制台。

2.在左侧导航栏，单击“个性化算法开发平台->实例列表”。

3.在顶部菜单栏，选择要查看的实例所在的目标区域。

4.单击实例ID链接，单击方案管理菜单，在右侧对话框中单击“创建方案”。

5.在弹出的页面中，填充方案基础信息，基础信息说明参见下表：

6.单击确定，完成方案创建。