Operator Integration 开发指南 (AGENTS.md)

1. 快速上手 (Quick Start)

项目根目录下的 project.sh 是主要的操作入口：

构建并运行 (Build & Run)
```
./project.sh -b
```
注意: 此命令会自动将 server/infra/config 下的配置文件覆盖到 /sysvol/config 和 /sysvol/secret，并启动服务。
运行测试 (Test)
```
./project.sh -t
```
运行所有单元测试（自动排除 server/tests 和 server/mocks）。
生成 Mock (Generate Mocks)
```
./project.sh -m
```
基于 go generate 生成 Mock 对象，用于单元测试。
代码检查 (Lint)
```
./project.sh -l
```
运行 golangci-lint，提交前必须通过。
API 文档预览
```
./project.sh -p
```

本项目采用 六边形架构 (Hexagonal Architecture / Ports and Adapters)，核心在于分离业务逻辑与基础设施。

目录	职责 (Role)	说明
`server/interfaces`	Ports	定义入站和出站接口，声明核心业务契约。
`server/logics`	Core	核心业务逻辑实现，纯净的 Go 代码，不依赖具体外部技术。
`server/driveradapters`	Inbound Adapters	驱动层，如 HTTP Handler (Gin)、MQ Consumer。
`server/drivenadapters`	Outbound Adapters	被驱动层，如 DB Client、External API Client。
`server/dbaccess`	DA Layer	数据库访问层具体实现。
`server/infra`	Infrastructure	基础设施，包括配置 (`config`)、日志、可观测性 (`telemetry`)。
`server/main.go`	Entry Point	程序入口，负责依赖注入和启动。

示例: feat:(execution-factory)add operator execution logic

开启 Debug 日志: 修改 server/infra/config/agent-operator-integration.yaml 中的 project.debug 为 true，然后重新运行 ./project.sh -b。

docker build -t agent-operator-integration:latest .

使用 Helm Chart 部署到 Kubernetes：

helm install agent-operator-integration ./helm/agent-operator-integration

本地渲染模板检查：

./project.sh -d

敏感配置:
- 严禁将 API Key、Password 等敏感信息提交到 Git。
- 本地开发请使用 /sysvol/secret 下的配置文件或环境变量。
- 生产环境敏感配置文件权限应设置为 600。
API 认证:
- 内部微服务调用必须携带 x-account-id 和 x-account-type Header。
- 外部接口需遵循统一认证网关规范。
日志脱敏: 禁止在日志中打印 Token、Password 或用户敏感数据。