102 lines
5.0 KiB
Markdown
102 lines
5.0 KiB
Markdown
<!-- file: docs/plans/001-V0_0_3_PLAN.md -->
|
|
<!-- version: 5 -->
|
|
|
|
# Plan KSP 0.0.3
|
|
|
|
## Mission
|
|
|
|
Poursuivre la phase fondatrice sans développement fonctionnel afin de transformer le brainstorming KSP en architecture, règles, nomenclature et plan de développement suffisamment précis pour ouvrir `0.1.x`.
|
|
|
|
## Décisions structurantes acquises
|
|
|
|
- Les bibliothèques d'implémentation utilisent `ksp-<role>-lib`.
|
|
- Les crates de contrats publics extensibles utilisent `ksp-<domain>-api`, sans suffixe `-lib`.
|
|
- Éviter un `ksp-api-lib` monolithique.
|
|
- Couples API/implémentation retenus : program, materializer, store.
|
|
- `ksp-store-lib` contient PostgreSQL comme implémentation de référence de `ksp-store-api`.
|
|
- Les workers continus utilisent `ksp-worker-api`.
|
|
- Les jobs à la demande utilisent `ksp-job-api`.
|
|
- Workers et jobs ne partagent pas une abstraction de lifecycle commune.
|
|
- W1 est strictement raw live/quasi-live et ne fait pas de backfill.
|
|
- Le backfill historique est un job séparé, candidat `ksp-job-backfill`.
|
|
- D'autres jobs pourront exister pour metadata, quotes et autres tâches ponctuelles.
|
|
- Les notifications de données sont normalisées indépendamment de leur producteur ; `ksp-store-api` est le propriétaire candidat des notifications de données persistées.
|
|
- `ksp-worker-control-lib` est le candidat pour une implémentation commune de contrôle des workers uniquement.
|
|
- Aucun `ksp-pipeline-lib` monolithique ; pipelines séparés à la demande.
|
|
- Aucun `ksp-scenarios-lib` monolithique ; scénarios séparés par crates de domaine.
|
|
- Trading Intelligence précède la couche/application de trading opérationnelle.
|
|
|
|
## Ligne directrice du développement fonctionnel
|
|
|
|
- `0.1.x` — `ksp-core-lib`, `ksp-logging-lib`, `ksp-config-lib`, `ksp-app-config-desk`.
|
|
- `0.2.x` — `ksp-onchain-transport-lib`, wallet, `ksp-interface-lib`, `ksp-program-api`, `ksp-program-lib`.
|
|
- `0.3.x` — `ksp-materializer-api`, `ksp-materializer-lib`, `ksp-store-api`, `ksp-store-lib`, W1, `ksp-worker-api`, `ksp-job-api`, backfill.
|
|
- `0.4.x` — premières surfaces Core/SPL/metadata, matérialisations, off-chain transport selon besoin, jobs/scénarios/demos spécialisés.
|
|
- `0.5.x` — Anchor puis protocoles trading par releases bornées.
|
|
- `0.6.x` — W2, contrôle workers, managers, orchestrateur et application globale.
|
|
- `0.7.x` — Trading Intelligence.
|
|
- `0.8.x+` — couche/application trading, extension continue, explorer Solana et explorer/analyse DEX.
|
|
|
|
## Prévision souple des prereleases 0.0.3
|
|
|
|
### `pre.001` — Base de planification
|
|
|
|
Considérée stabilisée après les fixes de cadrage.
|
|
|
|
### `pre.002` — Domaines et crates candidates
|
|
|
|
- inventorier les domaines fonctionnels ;
|
|
- fixer les couples `*-api` / `*-lib` réellement justifiés ;
|
|
- définir workers vs jobs ;
|
|
- définir les responsabilités des notifications de données ;
|
|
- inventorier les scénarios/pipelines spécialisés ;
|
|
- définir pour chaque crate candidate responsabilité, niveau, entrées/sorties et consommateurs ;
|
|
- mettre à jour le brouillon de prompt `0.1.x`.
|
|
|
|
### `pre.003` — Graphe de dépendances
|
|
|
|
- construire le graphe de dépendances autorisées/interdites ;
|
|
- identifier les propriétaires des dépendances Solana externes ;
|
|
- vérifier les risques de cycles ;
|
|
- positionner précisément les crates `*-api` ;
|
|
- préciser les dépendances autorisées de `ksp-program-api`, `ksp-materializer-api`, `ksp-store-api`, `ksp-worker-api` et `ksp-job-api`.
|
|
|
|
### `pre.004` — Programmes, décodage et exécution
|
|
|
|
- détailler `ksp-program-api` et `ksp-program-lib` ;
|
|
- définir les interfaces wire et leur source de vérité ;
|
|
- cadrer les tests de conformité ;
|
|
- définir le niveau supérieur propriétaire de la sécurité d'exécution ;
|
|
- traiter Metaplex/ElGamal comme exemples architecturaux sans développement fonctionnel.
|
|
|
|
### `pre.005` — Données, storage et acquisitions
|
|
|
|
- détailler `ksp-materializer-api` / `ksp-materializer-lib` ;
|
|
- détailler `ksp-store-api` / `ksp-store-lib` ;
|
|
- finaliser W1, `ksp-worker-api` et ses notifications de données ;
|
|
- détailler `ksp-job-api` et le backfill ;
|
|
- cadrer W2 sans l'implémenter ;
|
|
- définir les frontières backend et replay/reconstruction.
|
|
|
|
### `pre.006` — Applications, workers, jobs, demos et scénarios
|
|
|
|
- formaliser config/store/wallet apps ;
|
|
- finaliser la nomenclature réseau/environnement ;
|
|
- détailler les crates de scénarios spécialisées ;
|
|
- détailler managers workers/jobs et trajectoire vers l'orchestrateur ;
|
|
- inventorier les pipelines spécialisés nécessaires sans crate pipeline monolithique.
|
|
|
|
### `pre.007` — Plan de développement et contrôle de charge
|
|
|
|
- affiner le roadmap fonctionnel `0.1.x+` ;
|
|
- détailler le premier plan `0.1.x` ;
|
|
- transformer le brouillon de prompt en quasi-version finale ;
|
|
- vérifier et redécouper la charge de la session suivante si nécessaire.
|
|
|
|
### `pre.008` — Clôture fondatrice
|
|
|
|
- vérifier la cohérence règles/architecture/plans ;
|
|
- mettre à jour la documentation finale ;
|
|
- nettoyer/archiver les éléments temporaires ;
|
|
- finaliser le prompt de reprise `0.1.x`.
|