@atlashub/smartstack-cli 2.9.0 → 3.0.0

package/.documentation/business-analyse.html

@@ -12,7 +12,7 @@
         <header class="global-header">
             <div class="logo">SS</div>
             <span class="site-title">SmartStack CLI</span>
-            <span class="version-badge">v5.0.0</span>
+            <span class="version-badge">v6.0.0</span>
             <div class="header-divider"></div>
             <span class="page-title">Business Analyse</span>
             <nav class="breadcrumb">
@@ -24,7 +24,7 @@
                 <span data-lang="fr">Workflows</span>
                 <span data-lang="en">Workflows</span>
                 <span class="breadcrumb-separator">&#8250;</span>
-                <span class="breadcrumb-current">Business Analyse v5.0</span>
+                <span class="breadcrumb-current">Business Analyse v6.0</span>
             </nav>
             <!-- Language Select -->
             <select class="lang-select" id="lang-select" onchange="setLanguage(this.value); localStorage.setItem('doc-language', this.value);">
@@ -99,8 +99,8 @@
                             </a>
                             <a href="#quick-start" class="sidebar-toc-link">Quick Start</a>
                             <a href="#use-cases" class="sidebar-toc-link">
-                                <span data-lang="fr">4 Cas d'usage</span>
-                                <span data-lang="en">4 Use Cases</span>
+                                <span data-lang="fr">5 Cas d'usage</span>
+                                <span data-lang="en">5 Use Cases</span>
                             </a>
                             <a href="#flags" class="sidebar-toc-link">
                                 <span data-lang="fr">Flags &amp; Modes</span>
@@ -169,14 +169,14 @@
                     <section id="introduction">
                         <h2>Introduction</h2>
                         <p data-lang="fr">
-                            Le skill <strong>Business Analyse v5.0</strong> est un workflow en <strong>6 etapes</strong> qui transforme un besoin utilisateur en specification fonctionnelle complete avec support iteratif multi-module. Chaque application est composee de modules interdependants, analyzes et specifies dans un ordre logique.
+                            Le skill <strong>Business Analyse v6.0</strong> est un workflow en <strong>7 etapes</strong> qui transforme un besoin utilisateur en specification fonctionnelle complete avec support iteratif multi-module. La v6.0 ajoute un document HTML interactif pour la revue client et un pipeline d'extraction (<code>-x</code>) pour re-importer les modifications.
                         </p>
                         <p data-lang="en">
-                            The <strong>Business Analyse v5.0</strong> skill is a <strong>6-step</strong> workflow that transforms a user need into a complete functional specification with iterative multi-module support. Each application consists of interdependent modules, analyzed and specified in logical order.
+                            The <strong>Business Analyse v6.0</strong> skill is a <strong>7-step</strong> workflow that transforms a user need into a complete functional specification with iterative multi-module support. v6.0 adds an interactive HTML document for client review and an extraction pipeline (<code>-x</code>) to re-import modifications.
                         </p>
 
-                        <h4 data-lang="fr">6 Etapes du workflow</h4>
-                        <h4 data-lang="en">6 Workflow Steps</h4>
+                        <h4 data-lang="fr">7 Etapes du workflow</h4>
+                        <h4 data-lang="en">7 Workflow Steps</h4>
                         <ol class="steps-list">
                             <li>
                                 <strong>Init</strong> - Detecte le mode (application vs module), cree feature.json initial
@@ -194,7 +194,10 @@
                                 <strong>Consolidation</strong> - Validation cross-module, coherence des permissions et entites partagees
                             </li>
                             <li>
-                                <strong>Handoff</strong> - Mapping des fichiers par module, extraction programmatique prd.json via <code>ss derive-prd</code>
+                                <strong>Handoff</strong> - Mapping des fichiers par module, extraction programmatique prd.json via <code>ss derive-prd</code>, deploiement HTML interactif
+                            </li>
+                            <li>
+                                <strong>Extract</strong> - Import depuis l'export JSON du HTML interactif (<code>-x</code>), mapping vers feature.json
                             </li>
                         </ol>
 
@@ -267,10 +270,10 @@ Exemple:
                         </h2>
 
                         <p data-lang="fr">
-                            La v5.0 utilise une hierarchie 5 niveaux pour naviguer les applications multi-modules. Deux fichiers JSON (master application + per-module) garantissent la tracabilite et la coherence cross-module.
+                            La v6.0 utilise une hierarchie 5 niveaux pour naviguer les applications multi-modules. Deux fichiers JSON (master application + per-module) garantissent la tracabilite et la coherence cross-module.
                         </p>
                         <p data-lang="en">
-                            v5.0 uses a 5-level hierarchy to navigate multi-module applications. Two JSON files (master application + per-module) ensure traceability and cross-module coherence.
+                            v6.0 uses a 5-level hierarchy to navigate multi-module applications. Two JSON files (master application + per-module) ensure traceability and cross-module coherence.
                         </p>
 
                         <h4 data-lang="fr">Structure de repertoires</h4>
@@ -411,7 +414,10 @@ Exemple:
 /business-analyse -r FEAT-001 "Add return management module"
 
 # Micro-feature (analyse minimale)
-/business-analyse -m Add a status field to orders</code></pre>
+/business-analyse -m Add a status field to orders
+
+# Extract depuis HTML interactif
+/business-analyse -x ./docs/business/MyApp/ba-export.json</code></pre>
                                 </div>
                             </div>
                         </div>
@@ -422,8 +428,8 @@ Exemple:
                     <!-- ============================================ -->
                     <section id="use-cases">
                         <h2>
-                            <span data-lang="fr">4 Cas d'usage</span>
-                            <span data-lang="en">4 Use Cases</span>
+                            <span data-lang="fr">5 Cas d'usage</span>
+                            <span data-lang="en">5 Use Cases</span>
                         </h2>
 
                         <div class="table-container">
@@ -470,6 +476,12 @@ Exemple:
                                         <td><span data-lang="fr">module simple</span><span data-lang="en">simple module</span></td>
                                         <td>00 (micro) → 01 (lite) → 02 (skip) → 03 (minimal) → 04 (auto) → 05</td>
                                     </tr>
+                                    <tr>
+                                        <td><strong>Extract</strong></td>
+                                        <td><code>-x</code></td>
+                                        <td><span data-lang="fr">import HTML interactif</span><span data-lang="en">interactive HTML import</span></td>
+                                        <td>00 → 06 (extract) → <span data-lang="fr">choix</span><span data-lang="en">choice</span> (01 | 05 | EXIT)</td>
+                                    </tr>
                                 </tbody>
                             </table>
                         </div>
@@ -521,6 +533,14 @@ Exemple:
                                         </td>
                                         <td>false</td>
                                     </tr>
+                                    <tr>
+                                        <td><code>-x, --extract</code></td>
+                                        <td>
+                                            <span data-lang="fr">Importer depuis l'export JSON du HTML interactif</span>
+                                            <span data-lang="en">Import from interactive HTML JSON export</span>
+                                        </td>
+                                        <td>false</td>
+                                    </tr>
                                     <tr>
                                         <td><code>--economy-mode</code></td>
                                         <td>
@@ -546,13 +566,13 @@ Exemple:
                     <!-- WORKFLOW (6 STEPS)                            -->
                     <!-- ============================================ -->
                     <section id="workflow">
-                        <h2>Workflow (6 Etapes)</h2>
+                        <h2>Workflow (7 Etapes)</h2>
 
                         <p data-lang="fr">
-                            Le workflow v5.0 combine decouverte, decomposition, specification iterative et consolidation cross-module. Chaque etape enrichit progressivement le feature.json.
+                            Le workflow v6.0 combine decouverte, decomposition, specification iterative et consolidation cross-module. Chaque etape enrichit progressivement le feature.json.
                         </p>
                         <p data-lang="en">
-                            The v5.0 workflow combines discovery, decomposition, iterative specification and cross-module consolidation. Each step progressively enriches the feature.json.
+                            The v6.0 workflow combines discovery, decomposition, iterative specification and cross-module consolidation. Each step progressively enriches the feature.json.
                         </p>
                     </section>
 
@@ -849,6 +869,16 @@ Exemple:
 }</code></pre>
                         </div>
 
+                        <h4 data-lang="fr">Document HTML interactif</h4>
+                        <h4 data-lang="en">Interactive HTML Document</h4>
+
+                        <p data-lang="fr">
+                            A l'etape de handoff, un document HTML interactif (<code>ba-interactive.html</code>) est deploye dans le repertoire du projet. Ce document permet au client de consulter, modifier et enrichir l'analyse metier directement dans son navigateur, sans serveur. Les modifications peuvent etre re-importees via <code>/business-analyse -x &lt;json-path&gt;</code>.
+                        </p>
+                        <p data-lang="en">
+                            At the handoff step, an interactive HTML document (<code>ba-interactive.html</code>) is deployed to the project directory. This document allows the client to review, edit and enrich the business analysis directly in their browser, without a server. Modifications can be re-imported via <code>/business-analyse -x &lt;json-path&gt;</code>.
+                        </p>
+
                         <h4 data-lang="fr">Verification post-handoff</h4>
                         <h4 data-lang="en">Post-Handoff Verification</h4>
 
@@ -861,9 +891,42 @@ Exemple:
                             <li data-lang="en">Extract prd.json via <code>ss derive-prd</code></li>
                             <li data-lang="fr">Generer progress.txt tracker</li>
                             <li data-lang="en">Generate progress.txt tracker</li>
+                            <li data-lang="fr">Deployer ba-interactive.html avec placeholders remplaces</li>
+                            <li data-lang="en">Deploy ba-interactive.html with placeholders replaced</li>
                         </ul>
                     </section>
 
+                    <!-- ============================================ -->
+                    <!-- STEP 06 - EXTRACT                             -->
+                    <!-- ============================================ -->
+                    <section id="step-06">
+                        <h3>06. Extract</h3>
+
+                        <p data-lang="fr">
+                            Importe les donnees depuis l'export JSON du document HTML interactif (<code>ba-interactive.html</code>) et les transforme en feature.json. Cette etape est declenchee par le flag <code>-x</code>.
+                        </p>
+                        <p data-lang="en">
+                            Imports data from the interactive HTML document's JSON export (<code>ba-interactive.html</code>) and transforms it into feature.json. This step is triggered by the <code>-x</code> flag.
+                        </p>
+
+                        <h4 data-lang="fr">Principe</h4>
+                        <h4 data-lang="en">Principle</h4>
+
+                        <ul>
+                            <li data-lang="fr">Zero perte d'information : chaque champ du JSON exporte est mappe vers feature.json</li>
+                            <li data-lang="en">Zero information loss: every field from the exported JSON is mapped to feature.json</li>
+                            <li data-lang="fr">Mapping deterministe : cadrage, modules, specifications, consolidation</li>
+                            <li data-lang="en">Deterministic mapping: cadrage, modules, specifications, consolidation</li>
+                            <li data-lang="fr">Post-extraction : choix entre enrichir (step-01), handoff (step-05), ou terminer</li>
+                            <li data-lang="en">Post-extraction: choice between enrichment (step-01), handoff (step-05), or terminate</li>
+                        </ul>
+
+                        <div class="code-block">
+                            <button class="copy-btn">Copy</button>
+<pre><code>/business-analyse -x ./docs/business/MyApp/ba-export.json</code></pre>
+                        </div>
+                    </section>
+
                     <!-- ============================================ -->
                     <!-- SCHEMAS                                      -->
                     <!-- ============================================ -->
@@ -1065,6 +1128,7 @@ Module: "Checkout"
 <pre><code>docs/business/{app}/business-analyse/
 ├── v1.0/
 │   ├── feature.json              ← Master application spec
+│   ├── ba-interactive.html       ← Interactive client review document
 │   └── README.md                 ← Overview
 ├── checkout/v1.0/
 │   ├── feature.json              ← Module spec