# seec-analysis-backend

这是 Seecoder 统计与可视化的后端服务，提供日志检索、日志统计以及 D4 指标聚合能力。

## 本地启动

```bash
./mvnw spring-boot:run
```

Windows:

```powershell
mvnw.cmd spring-boot:run
```

## D4 指标能力

- D4-1：协作任务完成率、按时完成率
- D4-2：沟通平均响应耗时、有效协作次数、冲突解决次数与解决率

指标数据来源于 `biz_name` 为以下值的日志事件：

- `D4_TASK_ASSIGNED`
- `D4_TASK_COMPLETED`
- `D4_COLLAB_EFFECTIVE`
- `D4_COLLAB_CONFLICT_CREATED`
- `D4_COLLAB_CONFLICT_RESOLVED`
- `D4_COMM_MESSAGE_SENT`
- `D4_COMM_MESSAGE_RESPONSE`

## PaaS 部署（Elastic 仅云端可发现）

部署时通过环境变量配置 Elastic 连接，不要把云端地址和凭据写在代码仓库中。

```properties
ELASTICSEARCH_URIS=http://<cloud-es-service>:9200
ELASTICSEARCH_USERNAME=<optional>
ELASTICSEARCH_PASSWORD=<optional>
ELASTICSEARCH_CONNECTION_TIMEOUT=5s
ELASTICSEARCH_SOCKET_TIMEOUT=10s
```

应用默认使用：

- `spring.elasticsearch.uris=${ELASTICSEARCH_URIS:http://localhost:9200}`
- `spring.elasticsearch.username=${ELASTICSEARCH_USERNAME:}`
- `spring.elasticsearch.password=${ELASTICSEARCH_PASSWORD:}`

### 最小可运行镜像（建议）

```bash
docker build -t seec-analysis-backend:latest .
docker run --rm -p 8080:8080 \
	-e ELASTICSEARCH_URIS=http://<cloud-es-service>:9200 \
	-e ELASTICSEARCH_USERNAME=<optional> \
	-e ELASTICSEARCH_PASSWORD=<optional> \
	-e JAVA_OPTS="-Xms128m -Xmx256m" \
	seec-analysis-backend:latest
```

### PaaS 必填配置清单

- `ELASTICSEARCH_URIS`：云端 Elasticsearch 内网地址（必填）
- `ELASTICSEARCH_USERNAME`：开启鉴权时必填
- `ELASTICSEARCH_PASSWORD`：开启鉴权时必填

### PaaS 可选配置

- `JAVA_OPTS`：JVM 参数，默认 `-Xms128m -Xmx256m`
- `ELASTICSEARCH_CONNECTION_TIMEOUT`：默认 `5s`
- `ELASTICSEARCH_SOCKET_TIMEOUT`：默认 `10s`
- `SERVER_PORT`：如果平台要求非 8080，可在平台里映射或额外覆盖