cameleer/cameleer-server
1
0
Fork 0
Code Issues 41 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
7b73b5c9c5d1e84b13fabf2cc89c4524c2fc87b6
cameleer-server/ui/README.md

41 lines
1.1 KiB
Markdown
Raw Normal View History

docs: add UI dev instructions and configurable API proxy target Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:42:17 +01:00
# Cameleer3 UI
Contract-first API with DTOs, validation, and server-side OpenAPI post-processing Add dedicated request/response DTOs for all controllers, replacing raw JsonNode parameters with validated types. Move OpenAPI path-prefix stripping and ProcessorNode children injection into OpenApiCustomizer beans so the spec served at /api/v1/api-docs is already clean — eliminating the need for the ui/scripts/process-openapi.mjs post-processing script. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 15:33:37 +01:00
fix: update ITs to use consolidated init.sql, remove dead code - All 7 ClickHouse integration tests now load init.sql via shared ClickHouseTestHelper instead of deleted V1-V11 migration files - Remove unused useScope exports (setApp, setRoute, setExchange, clearScope) - Remove unused CSS classes (monoCell, punchcardStack) - Update ui/README.md DS version to v0.1.28 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-03 17:03:54 +02:00
React SPA built with [@cameleer/design-system](https://gitea.siegeln.net/cameleer/design-system) v0.1.28, TanStack Query, and Zustand.
Contract-first API with DTOs, validation, and server-side OpenAPI post-processing Add dedicated request/response DTOs for all controllers, replacing raw JsonNode parameters with validated types. Move OpenAPI path-prefix stripping and ProcessorNode children injection into OpenApiCustomizer beans so the spec served at /api/v1/api-docs is already clean — eliminating the need for the ui/scripts/process-openapi.mjs post-processing script. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 15:33:37 +01:00
docs: add UI dev instructions and configurable API proxy target Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:42:17 +01:00
## Development
Contract-first API with DTOs, validation, and server-side OpenAPI post-processing Add dedicated request/response DTOs for all controllers, replacing raw JsonNode parameters with validated types. Move OpenAPI path-prefix stripping and ProcessorNode children injection into OpenApiCustomizer beans so the spec served at /api/v1/api-docs is already clean — eliminating the need for the ui/scripts/process-openapi.mjs post-processing script. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 15:33:37 +01:00
docs: add UI dev instructions and configurable API proxy target Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:42:17 +01:00
```bash
npm install
npm run dev
```
Contract-first API with DTOs, validation, and server-side OpenAPI post-processing Add dedicated request/response DTOs for all controllers, replacing raw JsonNode parameters with validated types. Move OpenAPI path-prefix stripping and ProcessorNode children injection into OpenApiCustomizer beans so the spec served at /api/v1/api-docs is already clean — eliminating the need for the ui/scripts/process-openapi.mjs post-processing script. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 15:33:37 +01:00
docs: add UI dev instructions and configurable API proxy target Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:42:17 +01:00
By default the dev server proxies `/api/*` to `http://localhost:8081`. To proxy to a remote server instead:
Contract-first API with DTOs, validation, and server-side OpenAPI post-processing Add dedicated request/response DTOs for all controllers, replacing raw JsonNode parameters with validated types. Move OpenAPI path-prefix stripping and ProcessorNode children injection into OpenApiCustomizer beans so the spec served at /api/v1/api-docs is already clean — eliminating the need for the ui/scripts/process-openapi.mjs post-processing script. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 15:33:37 +01:00
docs: add UI dev instructions and configurable API proxy target Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:42:17 +01:00
```bash
docs: update all documentation for session changes CLAUDE.md: - Agent registry auto-heal note (in-memory, JWT fallback) - Usage analytics (ClickHouse usage_events table) HOWTO.md: - Architecture diagram: added deploy-demo (NodePort 30092) and cameleer-demo namespace - Access URLs: added Deploy Demo - Agent registry: server restart resilience documentation - Route control: CommandGroupResponse note ui/README.md: - Fixed outdated generate-api command - Added DS version (v0.1.26) - Fixed VITE_API_TARGET (30081 not 30090) - Added key features section (cmd-k, LIVE mode, route control, event icons) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-03 11:22:44 +02:00
VITE_API_TARGET=http://192.168.50.86:30081 npm run dev
docs: add UI dev instructions and configurable API proxy target Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:42:17 +01:00
```
Contract-first API with DTOs, validation, and server-side OpenAPI post-processing Add dedicated request/response DTOs for all controllers, replacing raw JsonNode parameters with validated types. Move OpenAPI path-prefix stripping and ProcessorNode children injection into OpenApiCustomizer beans so the spec served at /api/v1/api-docs is already clean — eliminating the need for the ui/scripts/process-openapi.mjs post-processing script. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 15:33:37 +01:00
docs: add UI dev instructions and configurable API proxy target Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:42:17 +01:00
No CORS issues — Vite's proxy makes API calls server-side.
Contract-first API with DTOs, validation, and server-side OpenAPI post-processing Add dedicated request/response DTOs for all controllers, replacing raw JsonNode parameters with validated types. Move OpenAPI path-prefix stripping and ProcessorNode children injection into OpenApiCustomizer beans so the spec served at /api/v1/api-docs is already clean — eliminating the need for the ui/scripts/process-openapi.mjs post-processing script. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 15:33:37 +01:00
docs: add UI dev instructions and configurable API proxy target Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:42:17 +01:00
## Build
Contract-first API with DTOs, validation, and server-side OpenAPI post-processing Add dedicated request/response DTOs for all controllers, replacing raw JsonNode parameters with validated types. Move OpenAPI path-prefix stripping and ProcessorNode children injection into OpenApiCustomizer beans so the spec served at /api/v1/api-docs is already clean — eliminating the need for the ui/scripts/process-openapi.mjs post-processing script. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 15:33:37 +01:00
docs: add UI dev instructions and configurable API proxy target Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:42:17 +01:00
```bash
npm run build
Contract-first API with DTOs, validation, and server-side OpenAPI post-processing Add dedicated request/response DTOs for all controllers, replacing raw JsonNode parameters with validated types. Move OpenAPI path-prefix stripping and ProcessorNode children injection into OpenApiCustomizer beans so the spec served at /api/v1/api-docs is already clean — eliminating the need for the ui/scripts/process-openapi.mjs post-processing script. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 15:33:37 +01:00
```
docs: add UI dev instructions and configurable API proxy target Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:42:17 +01:00
## API Types
Contract-first API with DTOs, validation, and server-side OpenAPI post-processing Add dedicated request/response DTOs for all controllers, replacing raw JsonNode parameters with validated types. Move OpenAPI path-prefix stripping and ProcessorNode children injection into OpenApiCustomizer beans so the spec served at /api/v1/api-docs is already clean — eliminating the need for the ui/scripts/process-openapi.mjs post-processing script. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 15:33:37 +01:00
docs: add UI dev instructions and configurable API proxy target Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:42:17 +01:00
Regenerate TypeScript types from a running backend:
Contract-first API with DTOs, validation, and server-side OpenAPI post-processing Add dedicated request/response DTOs for all controllers, replacing raw JsonNode parameters with validated types. Move OpenAPI path-prefix stripping and ProcessorNode children injection into OpenApiCustomizer beans so the spec served at /api/v1/api-docs is already clean — eliminating the need for the ui/scripts/process-openapi.mjs post-processing script. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 15:33:37 +01:00
docs: add UI dev instructions and configurable API proxy target Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 17:42:17 +01:00
```bash
docs: update all documentation for session changes CLAUDE.md: - Agent registry auto-heal note (in-memory, JWT fallback) - Usage analytics (ClickHouse usage_events table) HOWTO.md: - Architecture diagram: added deploy-demo (NodePort 30092) and cameleer-demo namespace - Access URLs: added Deploy Demo - Agent registry: server restart resilience documentation - Route control: CommandGroupResponse note ui/README.md: - Fixed outdated generate-api command - Added DS version (v0.1.26) - Fixed VITE_API_TARGET (30081 not 30090) - Added key features section (cmd-k, LIVE mode, route control, event icons) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-03 11:22:44 +02:00
npm run generate-api # Requires backend running on :8081
Contract-first API with DTOs, validation, and server-side OpenAPI post-processing Add dedicated request/response DTOs for all controllers, replacing raw JsonNode parameters with validated types. Move OpenAPI path-prefix stripping and ProcessorNode children injection into OpenApiCustomizer beans so the spec served at /api/v1/api-docs is already clean — eliminating the need for the ui/scripts/process-openapi.mjs post-processing script. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 15:33:37 +01:00
```
docs: update all documentation for session changes CLAUDE.md: - Agent registry auto-heal note (in-memory, JWT fallback) - Usage analytics (ClickHouse usage_events table) HOWTO.md: - Architecture diagram: added deploy-demo (NodePort 30092) and cameleer-demo namespace - Access URLs: added Deploy Demo - Agent registry: server restart resilience documentation - Route control: CommandGroupResponse note ui/README.md: - Fixed outdated generate-api command - Added DS version (v0.1.26) - Fixed VITE_API_TARGET (30081 not 30090) - Added key features section (cmd-k, LIVE mode, route control, event icons) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-03 11:22:44 +02:00
## Key Features
- **Composable sidebar** with accordion behavior (Applications / Starred / Admin sections)
- **Context-aware cmd-k search**: shows apps/routes/exchanges on operational pages, users/groups/roles on admin pages
- **LIVE mode toggle**: when ON, queries poll at intervals (5s-30s); when OFF, sidebar clicks trigger manual refresh
- **Route control bar** with state-aware buttons (start/stop/suspend/resume) and confirmation dialogs
- **Event-type icons** in agent timeline with severity-based coloring
Reference in New Issue Copy Permalink