Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -140,3 +140,4 @@ vite.config.ts.timestamp-*
/.astro
/.vscode
.claude/settings.local.json
.mcp.json
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
50 changes: 4 additions & 46 deletions src/content/docs/architecture/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,16 +99,7 @@ OrchCLI automatically selects the correct Docker Compose file based on which rep

All three services run inside Docker using pre-built images from GHCR.

```
┌───────────────── Docker Network ─────────────────┐
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ MongoDB │◄──│ Core │◄──│ UI │ │
│ │ :27017 │ │ :3000 │ │ :3001 │ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ mongo:8.0 ghcr.io/... ghcr.io/... │
└──────────────────────────────────────────────────┘
```
![Production Mode Architecture](../../../assets/images/architecture/cli/production-mode.png)

### Full Development Mode

Expand All @@ -117,16 +108,7 @@ All three services run inside Docker using pre-built images from GHCR.

Only MongoDB runs in Docker. UI and Core run on the host with hot reload.

```
┌──────── Host Machine ────────┐ ┌── Docker ──┐
│ │ │ │
│ ┌────────┐ ┌────────┐ │ │ ┌────────┐│
│ │ UI │───►│ Core │───┼──►│ │MongoDB ││
│ │ :3001 │ │ :3000 │ │ │ │ :27017 ││
│ └────────┘ └────────┘ │ │ └────────┘│
│ npm run dev air │ │ │
└──────────────────────────────┘ └────────────┘
```
![Full Development Mode Architecture](../../../assets/images/architecture/cli/full-dev-mode.png)

### Frontend-Only Development

Expand All @@ -135,16 +117,7 @@ Only MongoDB runs in Docker. UI and Core run on the host with hot reload.

UI runs on host, backend services in Docker. Frontend devs don't need Go.

```
┌─── Host ───┐ ┌────────── Docker Network ──────────┐
│ │ │ │
│ ┌────────┐ │ │ ┌──────────┐ ┌──────────┐ │
│ │ UI │─┼──►│ │ Core │◄──│ MongoDB │ │
│ │ :3001 │ │ │ │ :3000 │ │ :27017 │ │
│ └────────┘ │ │ └──────────┘ └──────────┘ │
│ npm run dev│ │ ghcr.io/... mongo:8.0 │
└────────────┘ └─────────────────────────────────────┘
```
![Frontend-Only Development Mode](../../../assets/images/architecture/cli/frontend-dev-mode.png)

### Backend-Only Development

Expand All @@ -153,22 +126,7 @@ UI runs on host, backend services in Docker. Frontend devs don't need Go.

Everything runs in Docker, but the Core source code is volume-mounted for hot reload via Air. Backend devs don't need Go installed locally.

```
┌────────────────── Docker Network ──────────────────┐
│ │
│ ┌──────────┐ ┌───────────────┐ ┌──────────┐ │
│ │ MongoDB │◄─│ Core │◄─│ UI │ │
│ │ :27017 │ │ :3000 │ │ :3001 │ │
│ └──────────┘ │ (mounted vol) │ └──────────┘ │
│ │ cosmtrek/air │ ghcr.io/... │
│ └───────┬───────┘ │
└────────────────────────┼───────────────────────────┘
│ volume mount
┌────┴────┐
│ Host │
│ ./core/ │
└─────────┘
```
![Backend-Only Development Mode](../../../assets/images/architecture/cli/backend-dev-mode.png)

## Configuration System

Expand Down
25 changes: 1 addition & 24 deletions src/content/docs/architecture/core-backend.md
Original file line number Diff line number Diff line change
Expand Up @@ -131,30 +131,7 @@ core/

## Layered Architecture

```
┌──────────────────────────────────────────────────┐
│ HTTP Layer │
│ routes/routes.go → handlers/*_handler.go │
│ (Gin router) (request/response) │
├──────────────────────────────────────────────────┤
│ Middleware Layer │
│ auth_middleware.go workflow_middleware.go │
│ (JWT validation) (ownership checks) │
├──────────────────────────────────────────────────┤
│ Service Layer │
│ services/*_service.go │
│ (Business logic, orchestration) │
├──────────────────────────────────────────────────┤
│ Repository Layer │
│ repositories/*_repository.go │
│ (MongoDB CRUD operations) │
├──────────────────────────────────────────────────┤
│ Infrastructure Layer │
│ database/mongodb.go pkg/kubernetes/* │
│ pkg/encryption/* pkg/template/* │
│ (DB, K8s, crypto) (Template engine) │
└──────────────────────────────────────────────────┘
```
![Layered Backend Architecture](../../../assets/images/architecture/core-backend/layered-architecture.png)

## Key Design Patterns

Expand Down
Loading