Local Architecture Analyzer

Geliştiricilerin terminal üzerinden kendi projelerinin kök dizininde çalıştırabileceği; pnpm monorepo yapılarını, Docker konfigürasyonlarını ve Kubernetes manifestlerini otomatik analiz eden bir Node.js CLI aracı ve MCP (Model Context Protocol) sunucusu.

Özellikler

• Monorepo Analizi: pnpm workspace yapısını otomatik tespit eder
• Docker Analizi: docker-compose.yml dosyalarını parse eder
• Kubernetes Analizi: Deployment, Service, Ingress, ConfigMap, Secret manifestlerini parse eder
• Bağımlılık Grafiği: Paketler ve servisler arasındaki bağımlılıkları görselleştirir
• MCP Sunucusu: AI asistanları için 40 tool sunar
• Web Dashboard: React Flow ile interaktif grafik görünümü
• Cache Mekanizması: TTL tabanlı scan cache ile performans optimizasyonu
• Structured Logging: JSON formatında loglama desteği
• Port Çakışma Tespiti: Docker servislerindeki port çakışmalarını tespit eder
• CI/CD Pipeline Analizi: GitHub Actions, GitLab CI, Jenkins, CircleCI yapılandırmalarını parse eder
• Git Geçmiş Zaman Yolculuğu: Mimari evrimi commit geçmişinden analiz eder
• AI Mimari İnceleme: LLM ile otomatik mimari inceleme ve öneriler
• Veritabanı Şema Analizi: Prisma, TypeORM, Drizzle, Sequelize, SQLAlchemy desteği
• Proxy Yapılandırması: Traefik, Nginx, Caddy reverse proxy analizi
• Gateway Tespiti: API gateway ve reverse proxy tespiti
• Güvenlik Denetimi: Docker güvenlik denetimi ve volume analizi
• Ortam Değişkeni Kapsamı: .env dosyaları ile kaynak kod arasındaki env değişken eşleşmesi
• AI Model Profilleme: AI model VRAM gereksinimleri hesaplama
• Donanım Tespiti: Serial, USB, GPIO cihaz tespiti

Kurulum

# npm ile
npm install -g local-architecturer

# veya doğrudan
npx local-architecturer analyze -p /path/to/project

Kullanım

Proje Analizi

# JSON çıktısı
arch-viz analyze -p /path/to/project -f json

# Metin çıktısı
arch-viz analyze -p /path/to/project -f text

Web Dashboard

# Sunucuyu başlat ve browser'ı aç
arch-viz serve -p /path/to/project

# Özel port ile
arch-viz serve -p . -port 3000

MCP Sunucusu (AI Asistanları İçin)

# MCP sunucusunu başlat
arch-viz mcp -p /path/to/project

# HTTP transport ile
arch-viz mcp -p . -t http -port 3001

AI Mimari İnceleme

# Ollama ile
arch-viz review -p /path/to/project --provider ollama --model qwen2.5

# OpenRouter ile
arch-viz review -p /path/to/project --provider openrouter --model meta-llama/llama-3-8b --api-key YOUR_KEY

Git Geçmiş Zaman Yolculuğu

# Son 50 commit'i analiz et
arch-viz time-travel -p /path/to/project -c 50

API Endpoint'leri

| Endpoint | Yöntem | Açıklama | |----------|--------|----------| | /api/health | GET | Sağlık kontrolü | | /api/graph | GET | Bağımlılık grafiği | | /api/packages | GET | Workspace paketleri | | /api/docker | GET | Docker servisleri | | /api/analyze | GET | Tam proje analizi | | /api/circular | GET | Döngüsel bağımlılık tespiti | | /api/docker-audit | GET | Docker güvenlik denetimi | | /api/env-coverage | GET | Env değişken eşleşmesi | | /api/ai-profile | GET | AI model profili | | /api/history | GET | Git geçmişi | | /api/history/:commit | GET | Tek commit anlık görüntüsü | | /api/pipelines | GET | CI/CD pipeline'ları | | /api/database | GET | Veritabanı şemaları | | /api/proxy | GET | Reverse proxy yapılandırmaları | | /api/dataflow | GET | Data flow pipeline'ları | | /api/security-boundaries | GET | Güvenlik sınırları | | /api/kubernetes | GET | Kubernetes manifest analizi | | POST /api/cache/invalidate | POST | Cache temizleme |

MCP Araçları (40 Tool)

Çekirdek Analiz

| Araç | Açıklama | |------|----------| | analyze_project | Tam proje analizi | | get_packages | Workspace paketlerini getir | | get_monorepo_graph | Monorepo grafiği (JSON + Mermaid) | | get_dependency_graph | Bağımlılık grafiği (filtrelenmiş) | | get_node_details | Belirli bir node'un detayları | | get_health_score | Proje sağlık skoru | | search_packages | Paket ara | | detect_circular_dependencies | Döngüsel bağımlılık tespiti |

Docker

| Araç | Açıklama | |------|----------| | get_docker_services | Docker servisleri (port conflict analizi) | | analyze_dockerfile | Dockerfile analizi | | audit_docker_security | Docker güvenlik denetimi | | parse_docker_compose_file | Tek Docker Compose dosyası analizi | | detect_port_conflicts | Port çakışması tespiti |

Kubernetes

| Araç | Açıklama | |------|----------| | analyze_kubernetes | Kubernetes manifest analizi (Deployment, Service, Ingress, ConfigMap, Secret) |

Veritabanı ve Proxy

| Araç | Açıklama | |------|----------| | get_database_schemas | Veritabanı şemaları (Prisma/TypeORM/Drizzle/Sequelize/SQLAlchemy) | | get_proxy_configurations | Reverse proxy yapılandırmaları | | parse_nginx_config | Nginx konfigürasyon parse | | detect_gateways | API gateway tespiti | | get_routes_edges | Proxy routing bağımlılık kenarları |

CI/CD ve Git

| Araç | Açıklama | |------|----------| | get_ci_cd_pipelines | CI/CD pipeline'ları | | get_build_edges | CI build bağımlılık kenarları | | time_travel | Git geçmişi ile mimari evrim |

Ortam ve Güvenlik

| Araç | Açıklama | |------|----------| | get_env_coverage | Env değişken eşleşmesi | | analyze_env_file | Tek .env dosyası analizi | | get_security_boundaries | Güvenlik sınırları |

AI ve Donanım

| Araç | Açıklama | |------|----------| | review_architecture | AI destekli mimari inceleme | | get_ai_profile | AI model profili | | lookup_ai_model | AI model VRAM gereksinimleri | | get_hardware_devices | Donanım cihaz tespiti |

Veri Akışı ve Görselleştirme

| Araç | Açıklama | |------|----------| | get_data_flows | Data flow pipeline'ları | | analyze_dataflow_bottlenecks | DataFlow darboğaz analizi | | get_mermaid_diagram | Mermaid diyagram üretimi |

Dil Desteği

| Araç | Açıklama | |------|----------| | parse_python_dependencies | Python bağımlılık parse | | parse_composer_packages | PHP/Composer bağımlılık parse | | parse_workspace_config | Monorepo workspace tespiti | | parse_sequelize_models | Sequelize ORM model parse | | parse_sqlalchemy_models | SQLAlchemy ORM model parse |

Örnek Çıktı

{
  "nodes": [
    { "id": "@app/core", "type": "package", "name": "@app/core" },
    { "id": "@app/ui", "type": "package", "name": "@app/ui" },
    { "id": "web", "type": "service", "name": "web" }
  ],
  "edges": [
    { "source": "@app/ui", "target": "@app/core", "type": "depends" },
    { "source": "web", "target": "api", "type": "network" }
  ]
}

Geliştirme

# Bağımlılıkları kur
npm install
cd frontend && npm install

# Geliştirme modunda çalıştır
npm run dev

# Testleri çalıştır (132 test)
npm test

# Build al
npm run build
cd frontend && npm run build

Proje Yapısı

local-architecturer/
├── src/
│   ├── cli.ts                    # Ana CLI giriş noktası (5 komut)
│   ├── commands/                 # CLI komutları (analyze, serve, mcp, review, time-travel)
│   ├── core/                     # Çekirdek modüller
│   │   ├── scanner.ts            # Merkez orkestratör (cache mekanizmalı)
│   │   ├── path-resolver.ts      # Dosya sistemi soyutlama
│   │   ├── docker-scanner.ts     # Docker konfigürasyon tespiti
│   │   ├── circular-detector.ts  # Döngüsel bağımlılık tespiti
│   │   ├── docker-auditor.ts     # Docker güvenlik denetimi
│   │   ├── env-analyzer.ts       # Env değişken analizi
│   │   ├── git-history-scanner.ts # Git geçmişi tarama
│   │   ├── gateway-detector.ts   # API gateway tespiti
│   │   ├── dataflow-analyzer.ts  # DataFlow darboğaz analizi
│   │   ├── build-edge-generator.ts # CI build kenar üretimi
│   │   └── routes-edge-generator.ts # Proxy routes kenar üretimi
│   ├── parsers/                  # 28 config parser
│   │   ├── workspace-parser.ts   # pnpm-workspace.yaml
│   │   ├── package-parser.ts     # package.json
│   │   ├── docker-compose-parser.ts
│   │   ├── dockerfile-parser.ts
│   │   ├── kubernetes-parser.ts  # Kubernetes manifestleri
│   │   ├── prisma-parser.ts, typeorm-parser.ts, drizzle-parser.ts
│   │   ├── sequelize-parser.ts, sqlalchemy-parser.ts
│   │   ├── nginx-parser.ts, traefik-parser.ts, caddy-parser.ts
│   │   ├── github-actions-parser.ts, gitlab-ci-parser.ts, jenkins-parser.ts, circleci-parser.ts
│   │   ├── composer-parser.ts, python-parser.ts
│   │   └── ... (ai-model, hardware, dataflow, proxy, db-schema, env, ci-cd, dependency)
│   ├── mcp/                      # MCP sunucu ve 40 tool
│   ├── server/                   # Express sunucu (18+ REST endpoint)
│   ├── ai/                       # LLM review engine (Ollama/OpenRouter/LMStudio)
│   ├── types/                    # TypeScript tip tanımları
│   └── utils/                    # Yardımcı modüller (structured logging destekli)
├── frontend/                     # React 18 + Vite 5 + @xyflow/react + dagre
├── tests/                        # 132 Vitest test
└── dist/                         # Build çıktıları

Testler

Proje 132 test ile kapsamlı bir test kapsamına sahiptir:

• Parser Testleri: workspace, package, dependency, docker-compose, dockerfile, prisma, github-actions, hardware, traefik, nginx, db-schema, kubernetes, python, composer, env
• Core Testleri: scanner, circular-detector, docker-scanner, docker-auditor, path-resolver
• MCP Testleri: server, mermaid-builder, port-conflict-detector
• Server Testleri: express-server

# Tüm testleri çalıştır
npm test

# İzleme modunda
npm run test:watch

Lisans

MIT