sdk_client/docs/INDEX.md
2025-08-29 16:25:56 +00:00

226 lines
5.7 KiB
Markdown

# 📚 Index de Documentation - sdk_client
Index complet de la documentation du SDK client pour les Silent Payments.
## 🚀 État Actuel
### Migration WASM en cours
-**Stub WASM flate2** : Package temporaire compatible avec `sdk_signer`
- 🔄 **Migration complète** : Remplacement de `secp256k1-sys` par `k256` (en cours)
-**WASM natif** : Compilation WebAssembly complète (planifié)
## 📖 Guides Principaux
### 🚀 [Guide d'Installation](INSTALLATION.md)
Guide complet pour installer et configurer le SDK client.
- Prérequis système et logiciels
- Installation de Rust et dépendances
- Configuration du stub WASM
- Tests post-installation
- Dépannage et monitoring
### 📖 [Guide d'utilisation](USAGE.md)
Parcours d'utilisation, intégration et validations (sans exemples exécutables).
### ⚙️ [Guide de Configuration](CONFIGURATION.md)
Guide complet pour configurer le SDK selon vos besoins.
- Configuration générale et variables d'environnement
- Configuration Rust et Cargo
- Configuration du stub WASM
- Configuration des features
- Configuration de build
- Configuration de tests
- Configuration de sécurité
## 🔧 Guides Techniques
### 🏗️ [Architecture Technique](ARCHITECTURE.md)
Documentation technique détaillée de l'architecture.
- Architecture générale du SDK
- Composants principaux (Rust, stub WASM)
- Architecture des Silent Payments
- Flux de données et types
- Intégration avec sdk_common
- Sécurité et isolation
- Performance et optimisations
- Monitoring et observabilité
### 📡 [Référence API](API.md)
Documentation du stub WASM et des APIs disponibles.
- **Stub WASM** : Implémentation JavaScript temporaire
- **Types TypeScript** : Interfaces et structures
- **Fonctions disponibles** : API du stub
- **Compatibilité** : Intégration avec sdk_signer
### 🔒 Sécurité
Bonnes pratiques et audit: voir `SECURITY_AUDIT.md`.
### 🐙 [Configuration Gitea](GITEA_SETUP.md)
Guide de configuration spécifique pour Gitea.
- **Configuration du repository Gitea**
- **Templates d'issues et pull requests**
- **Configuration CI/CD avec Gitea Actions**
- **Intégrations et webhooks**
- **Workflow de contribution**
- **Sécurité et permissions**
### 🚀 [Plan de Release](RELEASE_PLAN.md)
Plan de lancement open source complet.
- **Phases de préparation**
- **Communication et marketing**
- **Checklist de lancement**
- **Support communautaire**
- **Gestion des risques**
### 🌟 [Guide de la Communauté](COMMUNITY_GUIDE.md)
Guide complet pour la communauté.
- **Comment contribuer**
- **Ressources d'apprentissage**
- **Environnement de développement**
- **Processus de contribution**
- **Support et reconnaissance**
### 🗺️ [Roadmap](ROADMAP.md)
Roadmap de développement détaillée.
- **Timeline de développement**
- **Fonctionnalités planifiées**
- **Évolution de l'architecture**
- **Métriques de succès**
## 🧪 Guides de Test
### 🧪 [Guide des Tests](TESTING.md)
- Tests unitaires et intégration (cargo)
- Tests du stub WASM
- Tests de compatibilité avec sdk_signer
#### Commandes utiles
```bash
# Tests natifs
cargo test
# Tests du stub WASM
npm test
```
### 🔍 [Audit de Sécurité](SECURITY_AUDIT.md)
Audit de sécurité détaillé.
- **Vulnérabilités connues**
- **Tests de pénétration**
- **Audit de code**
- **Recommandations de sécurité**
- **Plan de remédiation**
## 🔧 Guides de Développement
### 🔧 Développement
Références réparties entre `ARCHITECTURE.md`, `API.md`, `TESTING.md`.
## 🌐 Guides d'Intégration
### 🔑 [Configuration SSH](SSH_SETUP.md)
Guide de configuration SSH pour le développement.
- **Génération des clés SSH**
- **Configuration Git**
- **Intégration avec Gitea**
- **Automatisation des déploiements**
### 🤖 [Push SSH Automatisé](AUTO_SSH_PUSH.md)
Guide pour l'automatisation des pushes SSH.
- **Configuration des scripts**
- **Intégration CI/CD**
- **Gestion des clés**
- **Sécurité et bonnes pratiques**
## 🔧 Guides d'Open Source
### ✅ [Checklist Open Source](OPEN_SOURCE_CHECKLIST.md)
Checklist complète pour l'ouverture en open source.
- **Préparation du code**
- **Documentation**
- **Licences et légal**
- **Infrastructure**
- **Communication**
## 📞 Support et Contact
### 📞 [Support](SUPPORT.md)
Guide de support et contact.
- **Comment obtenir de l'aide**
- **Création d'issues**
- **Canal de communication**
- **FAQ**
- **Ressources additionnelles**
---
## 🎯 Navigation Rapide
### 🚀 Démarrage Rapide
1. [Installation](INSTALLATION.md) - Installer sdk_client
2. [Configuration](CONFIGURATION.md) - Configurer l'environnement
3. [Utilisation](USAGE.md) - Utiliser le SDK
### 🔧 Développement
1. [Architecture](ARCHITECTURE.md) - Comprendre l'architecture
2. [API](API.md) - Consulter les APIs
3. [Tests](TESTING.md) - Exécuter les tests
### 📚 Documentation
1. [Index](INDEX.md) - Cet index
2. [Roadmap](ROADMAP.md) - Évolution du projet
### 🤝 Communauté
1. [Guide Communauté](COMMUNITY_GUIDE.md) - Contribuer
2. [Code de Conduite](../CODE_OF_CONDUCT.md) - Règles de conduite
3. [Support](SUPPORT.md) - Obtenir de l'aide
---
## 🧪 Tests et Validation
### Tests Automatisés
```bash
# Tests unitaires
cargo test --all
# Tests d'intégration
cargo test --test integration
# Tests de performance
cargo test --test performance
# Linting
cargo clippy -- -D warnings
# Formatage
cargo fmt -- --check
```
### Tests du Stub WASM
```bash
# Tests de compatibilité avec sdk_signer
cd ../sdk_signer
npm test
```
---
## 🚀 Développement
### Commandes Essentielles
```bash
# Build de développement
cargo build
# Build de production
cargo build --release
# Tests
cargo test --all
```
---
**📚 Documentation complète pour sdk_client — SDK client pour les Silent Payments** 🚀