GuideVelinScript Entscheidungshilfe

Wann nutze ich was?

Die VelinScript-Toolchain bietet für jede Phase des Software-Lebenszyklus das passende Werkzeug. Dieser Guide hilft dir, die richtige Wahl für dein aktuelles Problem zu treffen.

Entscheidungsfluss-Diagramm

Ein visueller Leitfaden zur Auswahl des richtigen Werkzeugs.

VELINSCRIPT TOOLCHAIN

Was möchten Sie tun?

Code schreiben

LSPHot ReloadREPLDebugger

Code prüfen

LinterFormatterDeps GraphBundle

Generieren

API/CRUDClientLib Gen

Test & Profiling

Test Runner, Benchmarks

Security

Scanner, Audit

Package Management

Velin PM, Registry

Entwicklung & Code-Qualität

Linter (velin-lint)

Nutzen Sie den Linter, wenn Sie Code-Qualität sicherstellen und ungenutzte Variablen finden möchten.

Wann?

  • ✅ Vor jedem Commit
  • ✅ CI/CD-Pipelines
  • ✅ Analyse von Code-Komplexität

Wann NICHT?

  • ❌ Während des aktiven Schreibens
  • ❌ Experimentelle Skripte

Dependency Graph (velin-deps)

Visualisierung von Modul-Abhängigkeiten und Identifizierung zirkulärer Imports.

Szenarien

  • ✅ Refactoring-Planung
  • ✅ Onboarding neuer Teammitglieder
  • ✅ Struktur-Analyse komplexer Projekte

Architektur & Compiler

Verstehen Sie die innere Mechanik und Systemstrukturen.

Compiler Passes

Kern-System

Optimieren Sie eigene Makros und verstehen Sie Fehlermeldungen durch tiefes Wissen über AutoFix, Parser, TypeCheck und Codegen.

Zur Architektur-Dokumentation

Dependency Graphing

Analyse

Visualisieren Sie zirkuläre Abhängigkeiten und Modul-Hierarchien. Unverzichtbar für Refactorings und Architektur-Audits.

velin-deps --graph

Intelligence Features

VelinAutoDoc

Automatische Generierung von Dokumentation aus /// Kommentaren. Perfekt für öffentliche APIs und LLM-Kontext.

VelinPipeline

Automatische Parallelisierung von unabhängigen async-Operationen. Nutzt @VelinPipeline für maximalen Durchsatz.

VelinFlow (@Flow)

Management von transaktionalen Abläufen mit automatischem Rollback und Self-Healing-Logik.

API-Entwicklung

Sichere und skalierbare Backend-Systeme entwerfen.

@Auth

JWT-Validierung & Endpunkt-Schutz für sichere Kommunikation.

@Role

Rollenbasierte Zugriffskontrolle (RBAC) auf Methodenebene.

@RateLimit

DDoS-Schutz & Fair Usage mit konfigurierbaren Windows.

@Validate

Eingabevalidierung & Typsicherheit zur Laufzeit.

KI & Machine Learning

Native KI-Integrationen für moderne Applikationen.

LLMClient

Native Integration von OpenAI, Anthropic & Gemini Modellen.

VectorDB

Optimierte semantische Suche für Pinecone und Qdrant.

ModelLoader

Performantes Laden von lokalen ONNX & TensorFlow Modellen.

Spickzettel

Quick Reference: Tool-Übersicht

Der ultimative Leitfaden für Ihren täglichen Workflow.

WerkzeugAnwendungsfallZyklus
Linter
Statische Analyse & Clean Code ArchitekturPre-Commit
Hot Reload
Echtzeit-Vorschau & Schnelle IterationszyklenEntwicklung
Security Scanner
Schwachstellen- & Dependency-AuditsReview
Benchmark Runner
Performance-Regressions-TestingWöchentlich
API Generator
Automatisierung von Boilerplate & CRUDPlanung

Workflow-Empfehlungen

Tagestrip

  1. VS Code Extension aktiv
  2. Hot Reload läuft
  3. REPL für Prototypen
  4. Linter-Checks

Vor Commit

  1. velin-test run
  2. velin-lint check
  3. velin format
  4. velin-security scan

Vor Release

  1. Coverage-Berichte
  2. Bundle-Analyse
  3. Benchmarks
  4. API-Docs generieren

Häufige Szenarien

"Ich möchte eine neue API entwickeln"

Nutze velin generate api für Boilerplate, starte velin-hot-reload für schnelles Feedback und generiere am Ende die Dokumentation mit velin-api-doc.

"Ich habe einen Bug, den ich nicht verstehe"

Verwende den velin-debugger für Breakpoints oder den Runtime Inspector, um Variablen live zu überwachen.

"Ich möchte Performance optimieren"

Messe die Baseline mit dem Benchmark Runner und identifiziere Hotspots mit dem Profiler (Flame Graphs).

🆕 Neue Standard Library Module (v2.6)

Path & URL

Cross-platform Pfad-Manipulation und API-URL-Konstruktion.

Stream processing

Reaktive Verarbeitung großer Datenmengen in Echtzeit.

Redis Integration

Hochperformantes Caching, Pub/Sub und Rate Limiting.

Distributed Tracing

Microservices-Tracing und Observability für komplexe Systeme.