Multi-module Maven project (server-core + server-app) with Spring Boot 3.4.3, Gitea CI workflow, and dependency on cameleer3-common from Gitea Maven registry. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
42
CLAUDE.md
Normal file
42
CLAUDE.md
Normal file
@@ -0,0 +1,42 @@
|
||||
# CLAUDE.md
|
||||
|
||||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||||
|
||||
## Project
|
||||
|
||||
Cameleer3 Server — observability server that receives, stores, and serves Camel route execution data and route diagrams from Cameleer3 agents. Pushes config and commands to agents via SSE.
|
||||
|
||||
## Related Project
|
||||
|
||||
- **cameleer3** (`https://gitea.siegeln.net/claude/cameleer3`) — the Java agent that instruments Camel applications
|
||||
- Protocol defined in `cameleer3-common/PROTOCOL.md` in the agent repo
|
||||
- This server depends on `com.cameleer3:cameleer3-common` (shared models and graph API)
|
||||
|
||||
## Modules
|
||||
|
||||
- `cameleer3-server-core` — domain logic, storage, agent registry
|
||||
- `cameleer3-server-app` — Spring Boot web app, REST controllers, SSE, static resources
|
||||
|
||||
## Build Commands
|
||||
|
||||
```bash
|
||||
mvn clean compile # Compile all modules
|
||||
mvn clean verify # Full build with tests
|
||||
```
|
||||
|
||||
## Run
|
||||
|
||||
```bash
|
||||
java -jar cameleer3-server-app/target/cameleer3-server-app-1.0-SNAPSHOT.jar
|
||||
```
|
||||
|
||||
## Key Conventions
|
||||
|
||||
- Java 17+ required
|
||||
- Spring Boot 3.4.3 parent POM
|
||||
- Depends on `com.cameleer3:cameleer3-common` from Gitea Maven registry
|
||||
- Jackson `JavaTimeModule` for `Instant` deserialization
|
||||
- Communication: receives HTTP POST data from agents, serves SSE event streams for config push/commands
|
||||
- Maintains agent instance registry with states: LIVE → STALE → DEAD
|
||||
- Storage: ClickHouse for structured data, text index for full-text search
|
||||
- Security: JWT auth, Ed25519 config signing, bootstrap token for registration
|
||||
Reference in New Issue
Block a user