🌕 Configuration VSCode Arkalia-LUNA¶

🎯 Vue d'ensemble¶

Configuration complète de VSCode pour le développement Arkalia-LUNA avec ambiance cognitive IA, ergonomie optimisée et productivité maximale.

🚀 Installation Rapide¶

# Configuration automatique complète
./scripts/ark-setup-vscode.sh

# Ou étape par étape
./scripts/ark-setup-shell.sh      # Alias shell
./scripts/ark-install-extensions.sh # Extensions VSCode

🎨 Thème & Ambiance¶

Thème Principal¶

One Dark Pro : Ambiance IA élégante et professionnelle
Material Icon Theme : Icônes claires et modernes
Fira Code : Police avec ligatures pour le code

Extensions UX¶

Error Lens : Erreurs visibles instantanément
Better Comments : Commentaires colorés avec tags Arkalia
Indent Rainbow : Indentation colorée
Bracket Pair Colorizer : Parenthèses colorées

🧩 Snippets Arkalia¶

Logs¶

logia    # logger.info('🌕 [MODULE] message')
logerr   # logger.error('❌ [MODULE] error_message')
logwarn  # logger.warning('⚠️ [MODULE] warning_message')
logok    # logger.info('✅ [MODULE] success_message')

Documentation¶

adoc     # Documentation de fonction style Arkalia
aclass   # Documentation de classe
aheader  # En-tête de module complet
aimp     # Section d'imports avec logging

Développement¶

pytest tests/ -v        # Tests complets
pytest tests/unit/ -v   # Tests rapides
ruff check --fix        # Nettoyage linting
black .                 # Formatage code
mkdocs serve           # Documentation locale
mkdocs build           # Build documentation

⚙️ Configuration VSCode¶

Fichiers de Configuration¶

.vscode/settings.json : Configuration complète Arkalia
.vscode/extensions.json : Extensions recommandées
.vscode/tasks.json : Tâches automatiques
.vscode/arkalia-snippets.code-snippets : Snippets personnalisés
.vscode/welcome.md : Page d'accueil Arkalia

Paramètres Clés¶

{
  "workbench.colorTheme": "One Dark Pro",
  "workbench.iconTheme": "material-icon-theme",
  "editor.fontFamily": "Fira Code, Menlo, monospace",
  "editor.fontLigatures": true,
  "python.analysis.typeCheckingMode": "basic",
  "python.linting.ruffEnabled": true,
  "python.formatting.provider": "black"
}

🚀 Tâches Automatiques¶

Tests¶

🧠 Arkalia: Lancer Tests : Tests complets avec couverture
🧠 Arkalia: Tests Rapides : Tests unitaires rapides
🧪 Arkalia: Tests de Performance : Tests de performance
🔐 Arkalia: Tests de Sécurité : Tests de sécurité

Documentation¶

📚 Arkalia: Générer Documentation : Build MkDocs
📚 Arkalia: Servir Documentation Locale : Serveur local sur :9000

Maintenance¶

🧹 Arkalia: Nettoyer Linting : Correction automatique
🎨 Arkalia: Corriger Style : Formatage Black + isort
📊 Arkalia: Rapport Linting : Rapport d'erreurs

Docker¶

🐳 Arkalia: Démarrer Docker : docker-compose up -d
🐳 Arkalia: Arrêter Docker : docker-compose down
🔍 Arkalia: Vérifier État : État des conteneurs

🧠 Alias Shell¶

Motivation¶

ark-motivation  # Affichage motivant Arkalia
ark-welcome     # Message de bienvenue

Développement¶

pytest tests/ -v        # Tests complets
pytest tests/unit/ -v   # Tests rapides
ruff check --fix        # Nettoyage linting
black .                 # Formatage code
mkdocs serve           # Documentation locale
mkdocs build           # Build documentation

Docker¶

ark-docker-up     # Démarrer conteneurs
ark-docker-down   # Arrêter conteneurs
ark-docker-status # État des conteneurs

Git¶

ark-commit        # Commit style Arkalia
ark-push          # Push vers main

Monitoring¶

ark-logs          # Suivi des logs
ark-metrics       # Métriques système
pytest tests/security/ -v    # Tests de sécurité
pytest tests/performance/ -v # Tests de performance

Nettoyage¶

ark-clean-cache   # Nettoyer cache Python
ark-clean-logs    # Nettoyer logs
ark-info          # Information système

🔧 Extensions Recommandées¶

Core Dev IA¶

Ruff : Linting Python ultra-rapide
Black Formatter : Formatage automatique
Pyright : Type checking intelligent
isort : Organisation des imports

UX & Ergonomie¶

Error Lens : Erreurs visibles
Better Comments : Commentaires colorés
Indent Rainbow : Indentation colorée
GitLens : Historique Git avancé

Documentation¶

Markdown All in One : Édition Markdown
Mermaid Markdown : Diagrammes
Markdown Preview Enhanced : Prévisualisation avancée

IA & Productivité¶

Docker : Gestion conteneurs
REST Client : Tests API
GitHub : Intégration GitHub

🎯 Workflow Recommandé¶

1. Démarrage de Session¶

# Ouvrir le projet dans VSCode
code .

# Vérifier l'état
ark-motivation
ark-docker-status

2. Développement¶

# Tests avant développement
pytest tests/unit/ -v

# Développement avec snippets
# Utiliser logia, adoc, atest, etc.

# Vérification continue
ruff check --fix
black .

Tests et Validation¶

# Tests complets
pytest tests/ -v

# Tests rapides
pytest tests/unit/ -v

# Tests de sécurité
pytest tests/security/ -v

# Tests de performance
pytest tests/performance/ -v

4. Commit & Déploiement¶

# Commit style Arkalia
ark-commit

# Push
ark-push

# Vérification finale
ark-docker-status

🛠️ Dépannage¶

Extensions Non Installées¶

# Réinstaller les extensions
./scripts/ark-install-extensions.sh

Alias Non Disponibles¶

# Recharger les alias
source ~/.zshrc

# Ou reconfigurer
./scripts/ark-setup-shell.sh

Problèmes de Linting¶

# Nettoyer et corriger
ark-lint
ark-style

# Vérifier la configuration
ark-lint-report

Docker Problèmes¶

# Redémarrer Docker
ark-docker-down
ark-docker-up

# Vérifier l'état
ark-docker-status

🌌 Philosophie Arkalia¶

"L'intelligence naît de l'erreur… mais survit par la mémoire."

Principes¶

Ergonomie Cognitive : Interface adaptée au développement IA
Productivité Maximale : Outils optimisés et automatisés
Qualité Continue : Linting, tests et documentation intégrés
Ambiance Motivante : Environnement inspirant pour l'IA

Modules Actifs¶

ZeroIA : Raisonnement et décision
Reflexia : Réflexes et réactivité
Sandozia : Analyse comportementale
CognitiveReactor : Réactions automatiques

📚 Ressources¶

Configuration VSCode Arkalia-LUNA v3.0-phase1 - L'IA ne dort jamais. 🌕