@atlashub/smartstack-cli 2.6.3 → 2.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.documentation/agents.html +1 -1
- package/.documentation/apex.html +1 -1
- package/.documentation/business-analyse.html +749 -1419
- package/.documentation/cli-commands.html +1 -1
- package/.documentation/commands.html +1 -1
- package/.documentation/css/styles.css +160 -0
- package/.documentation/efcore.html +1 -1
- package/.documentation/gitflow.html +3 -453
- package/.documentation/hooks.html +1 -1
- package/.documentation/index.html +177 -68
- package/.documentation/init.html +747 -290
- package/.documentation/installation.html +63 -8
- package/.documentation/ralph-loop.html +1 -1
- package/.documentation/test-web.html +1 -1
- package/dist/index.js +534 -294
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/templates/agents/ba-reader.md +23 -0
- package/templates/agents/ba-writer.md +63 -4
- package/templates/skills/business-analyse/questionnaire/00-application.md +1 -1
- package/templates/skills/business-analyse/questionnaire/03-scope.md +2 -2
- package/templates/skills/business-analyse/questionnaire.md +1 -1
- package/templates/skills/business-analyse/react/application-viewer.md +1 -1
- package/templates/skills/business-analyse/react/schema.md +88 -1
- package/templates/skills/business-analyse/schemas/application-schema.json +16 -1
- package/templates/skills/business-analyse/schemas/feature-schema.json +19 -986
- package/templates/skills/business-analyse/schemas/sections/analysis-schema.json +157 -0
- package/templates/skills/business-analyse/schemas/sections/discovery-schema.json +82 -0
- package/templates/skills/business-analyse/schemas/sections/handoff-schema.json +80 -0
- package/templates/skills/business-analyse/schemas/sections/metadata-schema.json +69 -0
- package/templates/skills/business-analyse/schemas/sections/specification-schema.json +445 -0
- package/templates/skills/business-analyse/schemas/sections/validation-schema.json +93 -0
- package/templates/skills/business-analyse/schemas/shared/common-defs.json +133 -0
- package/templates/skills/business-analyse/steps/step-01-cadrage.md +22 -3
- package/templates/skills/business-analyse/steps/step-03-specify.md +129 -0
- package/templates/skills/business-analyse/steps/step-04-consolidation.md +38 -5
- package/templates/skills/business-analyse/steps/step-05-handoff.md +94 -218
package/.documentation/init.html
CHANGED
|
@@ -3,25 +3,31 @@
|
|
|
3
3
|
<head>
|
|
4
4
|
<meta charset="UTF-8">
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>
|
|
6
|
+
<title>Projet Client - SmartStack CLI</title>
|
|
7
7
|
<link rel="stylesheet" href="css/styles.css">
|
|
8
8
|
</head>
|
|
9
9
|
<body>
|
|
10
10
|
<div class="app-container">
|
|
11
|
-
<!-- Global Header
|
|
11
|
+
<!-- Global Header -->
|
|
12
12
|
<header class="global-header">
|
|
13
13
|
<div class="logo">SS</div>
|
|
14
14
|
<span class="site-title">SmartStack CLI</span>
|
|
15
|
-
<span class="version-badge">v2.
|
|
15
|
+
<span class="version-badge">v2.6.3</span>
|
|
16
16
|
<div class="header-divider"></div>
|
|
17
|
-
<span class="page-title">
|
|
17
|
+
<span class="page-title">
|
|
18
|
+
<span data-lang="fr">Projet Client</span>
|
|
19
|
+
<span data-lang="en">Client Project</span>
|
|
20
|
+
</span>
|
|
18
21
|
<nav class="breadcrumb">
|
|
19
22
|
<a href="index.html">
|
|
20
23
|
<span data-lang="fr">Accueil</span>
|
|
21
24
|
<span data-lang="en">Home</span>
|
|
22
25
|
</a>
|
|
23
26
|
<span class="breadcrumb-separator">›</span>
|
|
24
|
-
<span class="breadcrumb-current">
|
|
27
|
+
<span class="breadcrumb-current">
|
|
28
|
+
<span data-lang="fr">Projet Client</span>
|
|
29
|
+
<span data-lang="en">Client Project</span>
|
|
30
|
+
</span>
|
|
25
31
|
</nav>
|
|
26
32
|
<!-- Language Select -->
|
|
27
33
|
<select class="lang-select" id="lang-select" onchange="setLanguage(this.value); localStorage.setItem('doc-language', this.value);">
|
|
@@ -63,10 +69,31 @@
|
|
|
63
69
|
<span class="icon">📦</span>
|
|
64
70
|
<span class="nav-text">Installation</span>
|
|
65
71
|
</a>
|
|
66
|
-
<
|
|
67
|
-
<
|
|
68
|
-
|
|
69
|
-
|
|
72
|
+
<div class="nav-item-with-toc">
|
|
73
|
+
<a href="init.html" class="nav-item active">
|
|
74
|
+
<span class="icon">🚀</span>
|
|
75
|
+
<span class="nav-text" data-lang="fr">Projet Client</span>
|
|
76
|
+
<span class="nav-text" data-lang="en">Client Project</span>
|
|
77
|
+
</a>
|
|
78
|
+
<nav class="sidebar-toc">
|
|
79
|
+
<a href="#introduction" class="sidebar-toc-link">Introduction</a>
|
|
80
|
+
<a href="#architecture" class="sidebar-toc-link">Architecture</a>
|
|
81
|
+
<a href="#creation" class="sidebar-toc-link">
|
|
82
|
+
<span data-lang="fr">Creer votre projet</span>
|
|
83
|
+
<span data-lang="en">Create project</span>
|
|
84
|
+
</a>
|
|
85
|
+
<a href="#structure" class="sidebar-toc-link">Structure</a>
|
|
86
|
+
<a href="#development" class="sidebar-toc-link">
|
|
87
|
+
<span data-lang="fr">Cycle de dev</span>
|
|
88
|
+
<span data-lang="en">Dev cycle</span>
|
|
89
|
+
</a>
|
|
90
|
+
<a href="#maintenance" class="sidebar-toc-link">Maintenance</a>
|
|
91
|
+
<a href="#first-steps" class="sidebar-toc-link">
|
|
92
|
+
<span data-lang="fr">Premiers pas</span>
|
|
93
|
+
<span data-lang="en">First steps</span>
|
|
94
|
+
</a>
|
|
95
|
+
</nav>
|
|
96
|
+
</div>
|
|
70
97
|
</div>
|
|
71
98
|
|
|
72
99
|
<div class="nav-section">
|
|
@@ -127,379 +154,809 @@
|
|
|
127
154
|
|
|
128
155
|
<!-- Main Content -->
|
|
129
156
|
<main class="main-content">
|
|
130
|
-
<div class="content
|
|
131
|
-
|
|
157
|
+
<div class="content-full">
|
|
158
|
+
|
|
159
|
+
<!-- ============================================
|
|
160
|
+
1. INTRODUCTION
|
|
161
|
+
============================================ -->
|
|
132
162
|
<section id="introduction">
|
|
133
163
|
<h2>
|
|
134
|
-
<span data-lang="fr">
|
|
135
|
-
<span data-lang="en">SmartStack
|
|
164
|
+
<span data-lang="fr">Qu'est-ce qu'un projet client SmartStack ?</span>
|
|
165
|
+
<span data-lang="en">What is a SmartStack client project?</span>
|
|
136
166
|
</h2>
|
|
137
167
|
|
|
138
168
|
<p data-lang="fr">
|
|
139
|
-
|
|
169
|
+
Un projet client SmartStack est une application metier construite sur les fondations du socle SmartStack. Le socle fournit tout ce qui est commun a une application professionnelle — authentification JWT, gestion des roles (RBAC via HasData), isolation multi-tenant, communication temps reel (SignalR), notifications et audit. Votre projet se concentre exclusivement sur <strong>votre logique metier</strong> : vos entites, vos services, vos pages.
|
|
140
170
|
</p>
|
|
141
171
|
<p data-lang="en">
|
|
142
|
-
|
|
172
|
+
A SmartStack client project is a business application built on top of the SmartStack foundation. The foundation provides everything common to a professional application — JWT authentication, role management (RBAC via HasData), multi-tenant isolation, real-time communication (SignalR), notifications and auditing. Your project focuses exclusively on <strong>your business logic</strong>: your entities, your services, your pages.
|
|
143
173
|
</p>
|
|
144
174
|
|
|
175
|
+
<p data-lang="fr">
|
|
176
|
+
La separation est stricte : vous n'avez jamais besoin de toucher au code du socle. Vous <em>etendez</em> SmartStack en ajoutant vos propres couches, et le socle evolue independamment via les mises a jour (<code>ss upgrade</code>).
|
|
177
|
+
</p>
|
|
178
|
+
<p data-lang="en">
|
|
179
|
+
The separation is strict: you never need to touch the foundation code. You <em>extend</em> SmartStack by adding your own layers, and the foundation evolves independently through updates (<code>ss upgrade</code>).
|
|
180
|
+
</p>
|
|
181
|
+
|
|
182
|
+
<!-- SVG: Foundation Layers -->
|
|
183
|
+
<div class="svg-diagram">
|
|
184
|
+
<svg viewBox="0 0 780 255" xmlns="http://www.w3.org/2000/svg" style="font-family: 'Inter', system-ui, sans-serif; width: 100%; max-width: 780px; height: auto; display: block; margin: 1.5rem auto;">
|
|
185
|
+
<defs>
|
|
186
|
+
<marker id="arrowDown" markerWidth="8" markerHeight="8" refX="4" refY="4" orient="auto">
|
|
187
|
+
<path d="M0,0 L8,4 L0,8 z" fill="#8a9bb0"/>
|
|
188
|
+
</marker>
|
|
189
|
+
</defs>
|
|
190
|
+
|
|
191
|
+
<!-- Your Project (top) -->
|
|
192
|
+
<rect x="20" y="8" width="740" height="92" rx="10" fill="#1e293b" stroke="#f97316" stroke-width="2"/>
|
|
193
|
+
<text x="390" y="32" text-anchor="middle" fill="#f97316" font-weight="700" font-size="13" data-lang="fr">VOTRE CODE METIER</text>
|
|
194
|
+
<text x="390" y="32" text-anchor="middle" fill="#f97316" font-weight="700" font-size="13" data-lang="en">YOUR BUSINESS CODE</text>
|
|
195
|
+
|
|
196
|
+
<!-- Your Project pills -->
|
|
197
|
+
<rect x="52" y="48" width="100" height="32" rx="6" fill="#334155"/>
|
|
198
|
+
<text x="102" y="69" text-anchor="middle" fill="#c8d0dc" font-size="11" data-lang="fr">Entites</text>
|
|
199
|
+
<text x="102" y="69" text-anchor="middle" fill="#c8d0dc" font-size="11" data-lang="en">Entities</text>
|
|
200
|
+
|
|
201
|
+
<rect x="168" y="48" width="100" height="32" rx="6" fill="#334155"/>
|
|
202
|
+
<text x="218" y="69" text-anchor="middle" fill="#c8d0dc" font-size="11">Services</text>
|
|
203
|
+
|
|
204
|
+
<rect x="284" y="48" width="100" height="32" rx="6" fill="#334155"/>
|
|
205
|
+
<text x="334" y="69" text-anchor="middle" fill="#c8d0dc" font-size="11">Controllers</text>
|
|
206
|
+
|
|
207
|
+
<rect x="400" y="48" width="110" height="32" rx="6" fill="#334155"/>
|
|
208
|
+
<text x="455" y="69" text-anchor="middle" fill="#c8d0dc" font-size="11">Pages React</text>
|
|
209
|
+
|
|
210
|
+
<rect x="526" y="48" width="110" height="32" rx="6" fill="#334155"/>
|
|
211
|
+
<text x="581" y="69" text-anchor="middle" fill="#c8d0dc" font-size="11" data-lang="fr">Vos tables</text>
|
|
212
|
+
<text x="581" y="69" text-anchor="middle" fill="#c8d0dc" font-size="11" data-lang="en">Your tables</text>
|
|
213
|
+
|
|
214
|
+
<rect x="652" y="48" width="80" height="32" rx="6" fill="#334155"/>
|
|
215
|
+
<text x="692" y="69" text-anchor="middle" fill="#c8d0dc" font-size="11">Tests</text>
|
|
216
|
+
|
|
217
|
+
<!-- Arrow: extends -->
|
|
218
|
+
<line x1="390" y1="108" x2="390" y2="148" stroke="#8a9bb0" stroke-width="1.5" stroke-dasharray="5,4"/>
|
|
219
|
+
<polygon points="384,144 390,155 396,144" fill="#8a9bb0"/>
|
|
220
|
+
<text x="390" y="136" text-anchor="middle" fill="#8a9bb0" font-size="11" font-style="italic" data-lang="fr">etend / utilise</text>
|
|
221
|
+
<text x="390" y="136" text-anchor="middle" fill="#8a9bb0" font-size="11" font-style="italic" data-lang="en">extends / uses</text>
|
|
222
|
+
|
|
223
|
+
<!-- SmartStack (bottom) -->
|
|
224
|
+
<rect x="20" y="158" width="740" height="88" rx="10" fill="#1e293b" stroke="#6366f1" stroke-width="2"/>
|
|
225
|
+
<text x="390" y="180" text-anchor="middle" fill="#6366f1" font-weight="700" font-size="13">SMARTSTACK (SOCLE)</text>
|
|
226
|
+
|
|
227
|
+
<!-- SmartStack pills -->
|
|
228
|
+
<rect x="40" y="194" width="92" height="32" rx="6" fill="#312e81"/>
|
|
229
|
+
<text x="86" y="215" text-anchor="middle" fill="#c4b5fd" font-size="11">Auth JWT</text>
|
|
230
|
+
|
|
231
|
+
<rect x="146" y="194" width="100" height="32" rx="6" fill="#312e81"/>
|
|
232
|
+
<text x="196" y="215" text-anchor="middle" fill="#c4b5fd" font-size="11">RBAC</text>
|
|
233
|
+
|
|
234
|
+
<rect x="260" y="194" width="108" height="32" rx="6" fill="#312e81"/>
|
|
235
|
+
<text x="314" y="215" text-anchor="middle" fill="#c4b5fd" font-size="11">Multi-tenant</text>
|
|
236
|
+
|
|
237
|
+
<rect x="382" y="194" width="90" height="32" rx="6" fill="#312e81"/>
|
|
238
|
+
<text x="427" y="215" text-anchor="middle" fill="#c4b5fd" font-size="11">SignalR</text>
|
|
239
|
+
|
|
240
|
+
<rect x="486" y="194" width="115" height="32" rx="6" fill="#312e81"/>
|
|
241
|
+
<text x="543" y="215" text-anchor="middle" fill="#c4b5fd" font-size="11">Notifications</text>
|
|
242
|
+
|
|
243
|
+
<rect x="615" y="194" width="80" height="32" rx="6" fill="#312e81"/>
|
|
244
|
+
<text x="655" y="215" text-anchor="middle" fill="#c4b5fd" font-size="11">Audit</text>
|
|
245
|
+
</svg>
|
|
246
|
+
</div>
|
|
247
|
+
|
|
145
248
|
<div class="alert alert-info">
|
|
146
249
|
<span class="alert-icon">💡</span>
|
|
147
250
|
<div class="alert-content">
|
|
148
|
-
<
|
|
251
|
+
<h5 data-lang="fr">Principe fondamental</h5>
|
|
252
|
+
<h5 data-lang="en">Core principle</h5>
|
|
253
|
+
<p data-lang="fr">
|
|
254
|
+
Vous ne modifiez jamais les internes de SmartStack. Vous etendez le socle en ajoutant vos entites dans le Domain, vos services dans Application, vos tables dans votre propre DbContext. Quand SmartStack evolue, un simple <code>ss upgrade</code> met a jour les fondations sans toucher a votre code.
|
|
255
|
+
</p>
|
|
256
|
+
<p data-lang="en">
|
|
257
|
+
You never modify SmartStack internals. You extend the foundation by adding your entities in Domain, your services in Application, your tables in your own DbContext. When SmartStack evolves, a simple <code>ss upgrade</code> updates the foundations without touching your code.
|
|
258
|
+
</p>
|
|
149
259
|
</div>
|
|
150
260
|
</div>
|
|
151
261
|
</section>
|
|
152
262
|
|
|
153
|
-
<!--
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
263
|
+
<!-- ============================================
|
|
264
|
+
2. ARCHITECTURE
|
|
265
|
+
============================================ -->
|
|
266
|
+
<section id="architecture">
|
|
267
|
+
<h2>Architecture</h2>
|
|
268
|
+
|
|
269
|
+
<h3>Clean Architecture</h3>
|
|
270
|
+
|
|
271
|
+
<p data-lang="fr">
|
|
272
|
+
Votre projet suit le pattern <strong>Clean Architecture</strong> en 4 couches. Le principe fondamental : les dependances pointent toujours vers le centre. Le Domain ne connait rien du monde exterieur. L'Application orchestre sans savoir comment les donnees sont stockees. L'Infrastructure implemente les details techniques. L'Api expose les endpoints.
|
|
273
|
+
</p>
|
|
274
|
+
<p data-lang="en">
|
|
275
|
+
Your project follows the <strong>Clean Architecture</strong> pattern with 4 layers. The core principle: dependencies always point inward. Domain knows nothing about the outside world. Application orchestrates without knowing how data is stored. Infrastructure implements technical details. Api exposes the endpoints.
|
|
276
|
+
</p>
|
|
277
|
+
|
|
278
|
+
<!-- SVG: Clean Architecture -->
|
|
279
|
+
<div class="svg-diagram">
|
|
280
|
+
<svg viewBox="0 0 700 300" xmlns="http://www.w3.org/2000/svg" style="font-family: 'Inter', system-ui, sans-serif; width: 100%; max-width: 700px; height: auto; display: block; margin: 1.5rem auto;">
|
|
281
|
+
<!-- Api (outermost) -->
|
|
282
|
+
<rect x="8" y="8" width="684" height="284" rx="12" fill="none" stroke="#f97316" stroke-width="2.5" stroke-opacity="0.7"/>
|
|
283
|
+
<text x="24" y="32" fill="#f97316" font-weight="700" font-size="13">MyApp.Api</text>
|
|
284
|
+
<text x="680" y="32" text-anchor="end" fill="#8a9bb0" font-size="10.5" data-lang="fr">Controllers, Swagger, Program.cs</text>
|
|
285
|
+
<text x="680" y="32" text-anchor="end" fill="#8a9bb0" font-size="10.5" data-lang="en">Controllers, Swagger, Program.cs</text>
|
|
286
|
+
|
|
287
|
+
<!-- Infrastructure -->
|
|
288
|
+
<rect x="32" y="52" width="636" height="228" rx="10" fill="none" stroke="#06b6d4" stroke-width="2.5" stroke-opacity="0.7"/>
|
|
289
|
+
<text x="48" y="74" fill="#06b6d4" font-weight="700" font-size="13">MyApp.Infrastructure</text>
|
|
290
|
+
<text x="656" y="74" text-anchor="end" fill="#8a9bb0" font-size="10.5">ExtensionsDbContext, Repositories, Migrations</text>
|
|
291
|
+
|
|
292
|
+
<!-- Application -->
|
|
293
|
+
<rect x="56" y="96" width="588" height="172" rx="10" fill="none" stroke="#3b82f6" stroke-width="2.5" stroke-opacity="0.7"/>
|
|
294
|
+
<text x="72" y="118" fill="#3b82f6" font-weight="700" font-size="13">MyApp.Application</text>
|
|
295
|
+
<text x="632" y="118" text-anchor="end" fill="#8a9bb0" font-size="10.5">Services, DTOs, IExtensionsDbContext</text>
|
|
296
|
+
|
|
297
|
+
<!-- Domain (innermost) -->
|
|
298
|
+
<rect x="80" y="140" width="540" height="116" rx="10" fill="#1e1b4b" fill-opacity="0.4" stroke="#6366f1" stroke-width="2.5"/>
|
|
299
|
+
<text x="96" y="164" fill="#6366f1" font-weight="700" font-size="13">MyApp.Domain</text>
|
|
300
|
+
<text x="608" y="164" text-anchor="end" fill="#8a9bb0" font-size="10.5" data-lang="fr">Entites, Interfaces, Regles metier</text>
|
|
301
|
+
<text x="608" y="164" text-anchor="end" fill="#8a9bb0" font-size="10.5" data-lang="en">Entities, Interfaces, Business Rules</text>
|
|
302
|
+
|
|
303
|
+
<!-- Domain content example -->
|
|
304
|
+
<text x="100" y="192" fill="#c8d0dc" font-size="11" font-family="monospace" data-lang="fr">public class Product : BaseEntity, IAuditable</text>
|
|
305
|
+
<text x="100" y="192" fill="#c8d0dc" font-size="11" font-family="monospace" data-lang="en">public class Product : BaseEntity, IAuditable</text>
|
|
306
|
+
<text x="100" y="210" fill="#8a9bb0" font-size="11" font-family="monospace">{</text>
|
|
307
|
+
<text x="100" y="228" fill="#8a9bb0" font-size="11" font-family="monospace"> public string Name { get; set; }</text>
|
|
308
|
+
<text x="100" y="246" fill="#8a9bb0" font-size="11" font-family="monospace">}</text>
|
|
309
|
+
|
|
310
|
+
<!-- Arrow: dependencies -->
|
|
311
|
+
<line x1="662" y1="272" x2="662" y2="160" stroke="#8a9bb0" stroke-width="1.5" marker-end="url(#arrowDown)"/>
|
|
312
|
+
<text x="660" y="286" text-anchor="middle" fill="#8a9bb0" font-size="10" data-lang="fr">Dependances</text>
|
|
313
|
+
<text x="660" y="286" text-anchor="middle" fill="#8a9bb0" font-size="10" data-lang="en">Dependencies</text>
|
|
314
|
+
</svg>
|
|
315
|
+
</div>
|
|
159
316
|
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
<
|
|
317
|
+
<!-- Layer explanations as cards -->
|
|
318
|
+
<div class="card-grid">
|
|
319
|
+
<div class="card">
|
|
320
|
+
<div class="card-header">
|
|
321
|
+
<div class="card-icon" style="background: #6366f1;">D</div>
|
|
322
|
+
<div>
|
|
323
|
+
<div class="card-title">Domain</div>
|
|
324
|
+
<div class="card-subtitle" data-lang="fr">Coeur metier</div>
|
|
325
|
+
<div class="card-subtitle" data-lang="en">Business core</div>
|
|
326
|
+
</div>
|
|
327
|
+
</div>
|
|
328
|
+
<div class="card-body">
|
|
329
|
+
<p data-lang="fr">
|
|
330
|
+
C'est ici que vivent vos entites metier (<code>Product</code>, <code>Order</code>, <code>Customer</code>...), vos interfaces et vos regles de validation. Cette couche n'a aucune dependance sur un framework — c'est du C# pur. Le package SmartStack fournit les classes de base (<code>BaseEntity</code>, <code>IAuditable</code>...).
|
|
331
|
+
</p>
|
|
332
|
+
<p data-lang="en">
|
|
333
|
+
This is where your business entities live (<code>Product</code>, <code>Order</code>, <code>Customer</code>...), your interfaces and validation rules. This layer has no dependency on any framework — it's pure C#. The SmartStack package provides base classes (<code>BaseEntity</code>, <code>IAuditable</code>...).
|
|
334
|
+
</p>
|
|
335
|
+
</div>
|
|
336
|
+
</div>
|
|
337
|
+
|
|
338
|
+
<div class="card">
|
|
339
|
+
<div class="card-header">
|
|
340
|
+
<div class="card-icon" style="background: #3b82f6;">A</div>
|
|
341
|
+
<div>
|
|
342
|
+
<div class="card-title">Application</div>
|
|
343
|
+
<div class="card-subtitle" data-lang="fr">Orchestration</div>
|
|
344
|
+
<div class="card-subtitle" data-lang="en">Orchestration</div>
|
|
345
|
+
</div>
|
|
346
|
+
</div>
|
|
347
|
+
<div class="card-body">
|
|
348
|
+
<p data-lang="fr">
|
|
349
|
+
La couche d'orchestration. Vos services metier, vos DTOs, vos interfaces de repository. C'est aussi ici que se declare <code>IExtensionsDbContext</code> — le contrat que l'Infrastructure doit implementer. Aucune reference a EF Core ou SQL Server ici.
|
|
350
|
+
</p>
|
|
351
|
+
<p data-lang="en">
|
|
352
|
+
The orchestration layer. Your business services, DTOs, repository interfaces. This is also where <code>IExtensionsDbContext</code> is declared — the contract that Infrastructure must implement. No reference to EF Core or SQL Server here.
|
|
353
|
+
</p>
|
|
354
|
+
</div>
|
|
355
|
+
</div>
|
|
356
|
+
|
|
357
|
+
<div class="card">
|
|
358
|
+
<div class="card-header">
|
|
359
|
+
<div class="card-icon" style="background: #06b6d4;">I</div>
|
|
360
|
+
<div>
|
|
361
|
+
<div class="card-title">Infrastructure</div>
|
|
362
|
+
<div class="card-subtitle" data-lang="fr">Acces aux donnees</div>
|
|
363
|
+
<div class="card-subtitle" data-lang="en">Data access</div>
|
|
364
|
+
</div>
|
|
365
|
+
</div>
|
|
366
|
+
<div class="card-body">
|
|
367
|
+
<p data-lang="fr">
|
|
368
|
+
L'implementation technique. <code>ExtensionsDbContext</code> (votre DbContext EF Core), les repositories, les configurations d'entites (<code>EntityTypeConfiguration</code>). C'est la seule couche qui sait <em>comment</em> vos donnees sont stockees. Les migrations EF Core vivent ici.
|
|
369
|
+
</p>
|
|
370
|
+
<p data-lang="en">
|
|
371
|
+
The technical implementation. <code>ExtensionsDbContext</code> (your EF Core DbContext), repositories, entity configurations (<code>EntityTypeConfiguration</code>). This is the only layer that knows <em>how</em> your data is stored. EF Core migrations live here.
|
|
372
|
+
</p>
|
|
373
|
+
</div>
|
|
374
|
+
</div>
|
|
375
|
+
|
|
376
|
+
<div class="card">
|
|
377
|
+
<div class="card-header">
|
|
378
|
+
<div class="card-icon" style="background: #f97316;">P</div>
|
|
379
|
+
<div>
|
|
380
|
+
<div class="card-title">Api</div>
|
|
381
|
+
<div class="card-subtitle" data-lang="fr">Point d'entree HTTP</div>
|
|
382
|
+
<div class="card-subtitle" data-lang="en">HTTP entry point</div>
|
|
383
|
+
</div>
|
|
384
|
+
</div>
|
|
385
|
+
<div class="card-body">
|
|
386
|
+
<p data-lang="fr">
|
|
387
|
+
Le point d'entree de votre application. Vos controllers REST, la configuration Swagger, <code>Program.cs</code> avec l'injection de dependances. C'est la couche la plus externe — elle orchestre le demarrage et expose vos endpoints.
|
|
388
|
+
</p>
|
|
389
|
+
<p data-lang="en">
|
|
390
|
+
Your application's entry point. Your REST controllers, Swagger configuration, <code>Program.cs</code> with dependency injection. This is the outermost layer — it orchestrates startup and exposes your endpoints.
|
|
391
|
+
</p>
|
|
392
|
+
</div>
|
|
164
393
|
</div>
|
|
165
394
|
</div>
|
|
166
|
-
</section>
|
|
167
395
|
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
<h2>
|
|
171
|
-
<span data-lang="fr">Serveurs MCP requis</span>
|
|
172
|
-
<span data-lang="en">Required MCP Servers</span>
|
|
173
|
-
</h2>
|
|
396
|
+
<!-- Dual-DbContext -->
|
|
397
|
+
<h3>Dual-DbContext</h3>
|
|
174
398
|
|
|
175
399
|
<p data-lang="fr">
|
|
176
|
-
SmartStack utilise
|
|
400
|
+
SmartStack utilise une architecture <strong>Dual-DbContext</strong> qui separe strictement les donnees du socle de vos donnees metier. Le socle gere ses propres tables (Users, Roles, Tenants, Permissions, AuditLogs) via son contexte interne. Votre projet utilise <code>ExtensionsDbContext</code> pour ses propres tables.
|
|
177
401
|
</p>
|
|
178
402
|
<p data-lang="en">
|
|
179
|
-
SmartStack uses
|
|
403
|
+
SmartStack uses a <strong>Dual-DbContext</strong> architecture that strictly separates foundation data from your business data. The foundation manages its own tables (Users, Roles, Tenants, Permissions, AuditLogs) through its internal context. Your project uses <code>ExtensionsDbContext</code> for its own tables.
|
|
180
404
|
</p>
|
|
181
405
|
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
</
|
|
194
|
-
<
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
406
|
+
<!-- SVG: Dual-DbContext -->
|
|
407
|
+
<div class="svg-diagram">
|
|
408
|
+
<svg viewBox="0 0 780 290" xmlns="http://www.w3.org/2000/svg" style="font-family: 'Inter', system-ui, sans-serif; width: 100%; max-width: 780px; height: auto; display: block; margin: 1.5rem auto;">
|
|
409
|
+
<!-- SmartStack Context (left) -->
|
|
410
|
+
<rect x="20" y="10" width="340" height="200" rx="10" fill="#1e293b" stroke="#6366f1" stroke-width="2"/>
|
|
411
|
+
<text x="190" y="36" text-anchor="middle" fill="#6366f1" font-weight="700" font-size="13">SmartStack Context</text>
|
|
412
|
+
<text x="190" y="54" text-anchor="middle" fill="#8a9bb0" font-size="10.5" font-style="italic" data-lang="fr">Gere par le socle</text>
|
|
413
|
+
<text x="190" y="54" text-anchor="middle" fill="#8a9bb0" font-size="10.5" font-style="italic" data-lang="en">Managed by foundation</text>
|
|
414
|
+
|
|
415
|
+
<!-- SmartStack tables -->
|
|
416
|
+
<rect x="45" y="70" width="290" height="28" rx="4" fill="#334155"/>
|
|
417
|
+
<text x="60" y="89" fill="#c4b5fd" font-size="11" font-family="monospace">├ Users</text>
|
|
418
|
+
<rect x="45" y="102" width="290" height="28" rx="4" fill="#334155"/>
|
|
419
|
+
<text x="60" y="121" fill="#c4b5fd" font-size="11" font-family="monospace">├ Roles / Permissions</text>
|
|
420
|
+
<rect x="45" y="134" width="290" height="28" rx="4" fill="#334155"/>
|
|
421
|
+
<text x="60" y="153" fill="#c4b5fd" font-size="11" font-family="monospace">├ Tenants</text>
|
|
422
|
+
<rect x="45" y="166" width="290" height="28" rx="4" fill="#334155"/>
|
|
423
|
+
<text x="60" y="185" fill="#c4b5fd" font-size="11" font-family="monospace">└ AuditLogs</text>
|
|
424
|
+
|
|
425
|
+
<!-- Separator -->
|
|
426
|
+
<line x1="390" y1="20" x2="390" y2="200" stroke="#475569" stroke-width="2" stroke-dasharray="6,4"/>
|
|
427
|
+
<rect x="370" y="92" width="40" height="28" rx="4" fill="#0f172a"/>
|
|
428
|
+
<text x="390" y="111" text-anchor="middle" fill="#eab308" font-size="10" font-weight="600">⚔</text>
|
|
429
|
+
|
|
430
|
+
<!-- Extensions Context (right) -->
|
|
431
|
+
<rect x="420" y="10" width="340" height="200" rx="10" fill="#1e293b" stroke="#f97316" stroke-width="2"/>
|
|
432
|
+
<text x="590" y="36" text-anchor="middle" fill="#f97316" font-weight="700" font-size="13">Extensions Context</text>
|
|
433
|
+
<text x="590" y="54" text-anchor="middle" fill="#8a9bb0" font-size="10.5" font-style="italic" data-lang="fr">Gere par vous</text>
|
|
434
|
+
<text x="590" y="54" text-anchor="middle" fill="#8a9bb0" font-size="10.5" font-style="italic" data-lang="en">Managed by you</text>
|
|
435
|
+
|
|
436
|
+
<!-- Your tables -->
|
|
437
|
+
<rect x="445" y="70" width="290" height="28" rx="4" fill="#334155"/>
|
|
438
|
+
<text x="460" y="89" fill="#fdba74" font-size="11" font-family="monospace">├ Products</text>
|
|
439
|
+
<rect x="445" y="102" width="290" height="28" rx="4" fill="#334155"/>
|
|
440
|
+
<text x="460" y="121" fill="#fdba74" font-size="11" font-family="monospace">├ Orders</text>
|
|
441
|
+
<rect x="445" y="134" width="290" height="28" rx="4" fill="#334155"/>
|
|
442
|
+
<text x="460" y="153" fill="#fdba74" font-size="11" font-family="monospace">├ Categories</text>
|
|
443
|
+
<rect x="445" y="166" width="290" height="28" rx="4" fill="#334155"/>
|
|
444
|
+
<text x="460" y="185" fill="#fdba74" font-size="11" font-family="monospace">└ ...</text>
|
|
445
|
+
|
|
446
|
+
<!-- Database -->
|
|
447
|
+
<line x1="190" y1="210" x2="190" y2="240" stroke="#6366f1" stroke-width="1.5" stroke-opacity="0.6"/>
|
|
448
|
+
<line x1="590" y1="210" x2="590" y2="240" stroke="#f97316" stroke-width="1.5" stroke-opacity="0.6"/>
|
|
449
|
+
<line x1="190" y1="240" x2="590" y2="240" stroke="#475569" stroke-width="1.5"/>
|
|
450
|
+
|
|
451
|
+
<!-- DB icon -->
|
|
452
|
+
<ellipse cx="390" cy="258" rx="60" ry="10" fill="none" stroke="#8a9bb0" stroke-width="1.5"/>
|
|
453
|
+
<rect x="330" y="258" width="120" height="18" fill="#1e293b" stroke="#8a9bb0" stroke-width="1.5"/>
|
|
454
|
+
<ellipse cx="390" cy="276" rx="60" ry="10" fill="none" stroke="#8a9bb0" stroke-width="1.5"/>
|
|
455
|
+
<line x1="390" y1="240" x2="390" y2="248" stroke="#8a9bb0" stroke-width="1.5"/>
|
|
456
|
+
<text x="390" y="271" text-anchor="middle" fill="#c8d0dc" font-size="10">SQL Server</text>
|
|
457
|
+
</svg>
|
|
213
458
|
</div>
|
|
214
459
|
|
|
215
|
-
<
|
|
216
|
-
|
|
460
|
+
<p data-lang="fr">
|
|
461
|
+
Cette separation a trois avantages concrets :
|
|
462
|
+
</p>
|
|
463
|
+
<p data-lang="en">
|
|
464
|
+
This separation has three concrete advantages:
|
|
465
|
+
</p>
|
|
466
|
+
<ul>
|
|
467
|
+
<li data-lang="fr">Vos migrations n'interferent <strong>jamais</strong> avec les tables du socle</li>
|
|
468
|
+
<li data-lang="en">Your migrations <strong>never</strong> interfere with foundation tables</li>
|
|
469
|
+
<li data-lang="fr">Les mises a jour SmartStack (<code>ss upgrade</code>) n'impactent pas votre schema</li>
|
|
470
|
+
<li data-lang="en">SmartStack updates (<code>ss upgrade</code>) don't impact your schema</li>
|
|
471
|
+
<li data-lang="fr">Vous visualisez clairement ce qui vous appartient vs. ce qui est gere par le framework</li>
|
|
472
|
+
<li data-lang="en">You can clearly see what belongs to you vs. what is managed by the framework</li>
|
|
473
|
+
</ul>
|
|
474
|
+
|
|
475
|
+
<div class="alert alert-info">
|
|
476
|
+
<span class="alert-icon">📚</span>
|
|
217
477
|
<div class="alert-content">
|
|
218
|
-
<
|
|
219
|
-
<
|
|
220
|
-
<p data-lang="fr">
|
|
221
|
-
Si les serveurs MCP ne sont pas installes, vous pouvez continuer avec l'option <code>--skip-mcp-check</code>, mais certaines fonctionnalites seront limitees.
|
|
222
|
-
</p>
|
|
223
|
-
<p data-lang="en">
|
|
224
|
-
If MCP servers are not installed, you can continue with the <code>--skip-mcp-check</code> option, but some features will be limited.
|
|
225
|
-
</p>
|
|
478
|
+
<p data-lang="fr">Toutes les operations sur vos migrations passent par les skills <code>/efcore</code>. Le MCP valide les noms, detecte les conflits entre branches et assure la coherence. Voir la page <a href="efcore.html">EF Core</a> pour le workflow complet.</p>
|
|
479
|
+
<p data-lang="en">All operations on your migrations go through <code>/efcore</code> skills. The MCP validates names, detects conflicts between branches and ensures consistency. See the <a href="efcore.html">EF Core</a> page for the complete workflow.</p>
|
|
226
480
|
</div>
|
|
227
481
|
</div>
|
|
228
482
|
</section>
|
|
229
483
|
|
|
230
|
-
<!--
|
|
231
|
-
|
|
484
|
+
<!-- ============================================
|
|
485
|
+
3. CREER VOTRE PROJET
|
|
486
|
+
============================================ -->
|
|
487
|
+
<section id="creation">
|
|
232
488
|
<h2>
|
|
233
|
-
<span data-lang="fr">
|
|
234
|
-
<span data-lang="en">
|
|
489
|
+
<span data-lang="fr">Creer votre projet</span>
|
|
490
|
+
<span data-lang="en">Create your project</span>
|
|
235
491
|
</h2>
|
|
236
492
|
|
|
493
|
+
<p data-lang="fr">
|
|
494
|
+
La commande <code>ss init</code> cree un projet complet et pret a developper. Voici ce qui se passe etape par etape :
|
|
495
|
+
</p>
|
|
496
|
+
<p data-lang="en">
|
|
497
|
+
The <code>ss init</code> command creates a complete, ready-to-develop project. Here's what happens step by step:
|
|
498
|
+
</p>
|
|
499
|
+
|
|
500
|
+
<ol class="steps-list">
|
|
501
|
+
<li>
|
|
502
|
+
<div class="step-content">
|
|
503
|
+
<h5 data-lang="fr">Choisir le nom du projet</h5>
|
|
504
|
+
<h5 data-lang="en">Choose the project name</h5>
|
|
505
|
+
<p data-lang="fr">Le nom devient le namespace C# racine de toute votre application : <code>MyApp.Domain</code>, <code>MyApp.Application</code>, <code>MyApp.Infrastructure</code>, <code>MyApp.Api</code>. Choisissez un identifiant C# valide (PascalCase, sans espaces ni tirets).</p>
|
|
506
|
+
<p data-lang="en">The name becomes the root C# namespace for your entire application: <code>MyApp.Domain</code>, <code>MyApp.Application</code>, <code>MyApp.Infrastructure</code>, <code>MyApp.Api</code>. Choose a valid C# identifier (PascalCase, no spaces or dashes).</p>
|
|
507
|
+
</div>
|
|
508
|
+
</li>
|
|
509
|
+
<li>
|
|
510
|
+
<div class="step-content">
|
|
511
|
+
<h5 data-lang="fr">Le wizard vous guide</h5>
|
|
512
|
+
<h5 data-lang="en">The wizard guides you</h5>
|
|
513
|
+
<p data-lang="fr">En mode interactif, le wizard pose deux questions : <strong>Multi-tenant ?</strong> (activez si votre application doit isoler les donnees par client/organisation) et <strong>Azure AD B2C ?</strong> (si l'authentification passe par Azure B2C, necessite multi-tenant). En mode rapide (<code>-y</code>), les valeurs par defaut sont utilisees (single-tenant, pas de B2C).</p>
|
|
514
|
+
<p data-lang="en">In interactive mode, the wizard asks two questions: <strong>Multi-tenant?</strong> (enable if your app needs to isolate data per client/organization) and <strong>Azure AD B2C?</strong> (if authentication goes through Azure B2C, requires multi-tenant). In quick mode (<code>-y</code>), defaults are used (single-tenant, no B2C).</p>
|
|
515
|
+
</div>
|
|
516
|
+
</li>
|
|
517
|
+
<li>
|
|
518
|
+
<div class="step-content">
|
|
519
|
+
<h5 data-lang="fr">La commande genere tout</h5>
|
|
520
|
+
<h5 data-lang="en">The command generates everything</h5>
|
|
521
|
+
<p data-lang="fr">Solution .NET 4 projets Clean Architecture, frontend React/Vite/Tailwind preconfigure, fichiers VS Code (debug, tasks, extensions recommandees), <code>CLAUDE.md</code> pour Claude Code, <code>.smartstack/config.json</code> qui identifie votre projet, et <code>Directory.Build.props</code> pour le TargetFramework partage.</p>
|
|
522
|
+
<p data-lang="en">.NET solution with 4 Clean Architecture projects, preconfigured React/Vite/Tailwind frontend, VS Code files (debug, tasks, recommended extensions), <code>CLAUDE.md</code> for Claude Code, <code>.smartstack/config.json</code> identifying your project, and <code>Directory.Build.props</code> for the shared TargetFramework.</p>
|
|
523
|
+
</div>
|
|
524
|
+
</li>
|
|
525
|
+
</ol>
|
|
526
|
+
|
|
237
527
|
<div class="code-block">
|
|
238
528
|
<button class="copy-btn">Copy</button>
|
|
239
|
-
<pre><code
|
|
529
|
+
<pre><code><span class="code-comment"># Creer un projet avec le wizard interactif</span>
|
|
530
|
+
<span class="code-cmd">ss init</span> <span class="code-arg">MyApp</span>
|
|
531
|
+
|
|
532
|
+
<span class="code-comment"># Mode rapide : valeurs par defaut (single-tenant, pas de B2C)</span>
|
|
533
|
+
<span class="code-cmd">ss init</span> <span class="code-arg">MyApp</span> <span class="code-flag">-y</span>
|
|
534
|
+
|
|
535
|
+
<span class="code-comment"># Multi-tenant avec Azure AD B2C</span>
|
|
536
|
+
<span class="code-cmd">ss init</span> <span class="code-arg">MyApp</span> <span class="code-flag">--multi-tenant --b2c</span>
|
|
537
|
+
|
|
538
|
+
<span class="code-comment"># Previsualiser sans rien creer</span>
|
|
539
|
+
<span class="code-cmd">ss init</span> <span class="code-arg">MyApp</span> <span class="code-flag">--dry-run</span></code></pre>
|
|
240
540
|
</div>
|
|
241
541
|
|
|
242
|
-
<
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
<
|
|
247
|
-
|
|
248
|
-
<th>Option</th>
|
|
249
|
-
<th>
|
|
250
|
-
<span data-lang="fr">Description</span>
|
|
251
|
-
<span data-lang="en">Description</span>
|
|
252
|
-
</th>
|
|
253
|
-
</tr>
|
|
254
|
-
</thead>
|
|
255
|
-
<tbody>
|
|
256
|
-
<tr>
|
|
257
|
-
<td><code>--db <type></code></td>
|
|
258
|
-
<td>
|
|
259
|
-
<span data-lang="fr">Base de donnees: <code>sqlserver</code> (defaut), <code>postgresql</code>, <code>sqlite</code></span>
|
|
260
|
-
<span data-lang="en">Database: <code>sqlserver</code> (default), <code>postgresql</code>, <code>sqlite</code></span>
|
|
261
|
-
</td>
|
|
262
|
-
</tr>
|
|
263
|
-
<tr>
|
|
264
|
-
<td><code>--dry-run</code></td>
|
|
265
|
-
<td>
|
|
266
|
-
<span data-lang="fr">Simulation - affiche ce qui serait cree sans rien creer</span>
|
|
267
|
-
<span data-lang="en">Simulation - shows what would be created without creating anything</span>
|
|
268
|
-
</td>
|
|
269
|
-
</tr>
|
|
270
|
-
<tr>
|
|
271
|
-
<td><code>-y, --yes</code></td>
|
|
272
|
-
<td>
|
|
273
|
-
<span data-lang="fr">Mode non-interactif - utilise les valeurs par defaut</span>
|
|
274
|
-
<span data-lang="en">Non-interactive mode - uses default values</span>
|
|
275
|
-
</td>
|
|
276
|
-
</tr>
|
|
277
|
-
<tr>
|
|
278
|
-
<td><code>--skip-mcp-check</code></td>
|
|
279
|
-
<td>
|
|
280
|
-
<span data-lang="fr">Ignorer la verification des serveurs MCP</span>
|
|
281
|
-
<span data-lang="en">Skip MCP servers verification</span>
|
|
282
|
-
</td>
|
|
283
|
-
</tr>
|
|
284
|
-
</tbody>
|
|
285
|
-
</table>
|
|
542
|
+
<div class="alert alert-warning">
|
|
543
|
+
<span class="alert-icon">⚠️</span>
|
|
544
|
+
<div class="alert-content">
|
|
545
|
+
<p data-lang="fr"><code>ss init</code> <strong>sans nom de projet</strong> fonctionne aussi — il configure SmartStack sur un projet .NET existant (CLAUDE.md, hooks, verification MCP) au lieu d'en creer un nouveau. Utile pour integrer SmartStack a un projet deja en cours.</p>
|
|
546
|
+
<p data-lang="en"><code>ss init</code> <strong>without a project name</strong> also works — it configures SmartStack on an existing .NET project (CLAUDE.md, hooks, MCP verification) instead of creating a new one. Useful for integrating SmartStack into an ongoing project.</p>
|
|
547
|
+
</div>
|
|
286
548
|
</div>
|
|
287
549
|
</section>
|
|
288
550
|
|
|
289
|
-
<!--
|
|
290
|
-
|
|
551
|
+
<!-- ============================================
|
|
552
|
+
4. STRUCTURE DU PROJET
|
|
553
|
+
============================================ -->
|
|
554
|
+
<section id="structure">
|
|
291
555
|
<h2>
|
|
292
|
-
<span data-lang="fr">
|
|
293
|
-
<span data-lang="en">
|
|
556
|
+
<span data-lang="fr">Structure du projet</span>
|
|
557
|
+
<span data-lang="en">Project structure</span>
|
|
294
558
|
</h2>
|
|
295
559
|
|
|
560
|
+
<p data-lang="fr">Voici la structure generee par <code>ss init MyApp</code>, annotee avec le role de chaque element :</p>
|
|
561
|
+
<p data-lang="en">Here is the structure generated by <code>ss init MyApp</code>, annotated with the role of each element:</p>
|
|
562
|
+
|
|
296
563
|
<div class="code-block">
|
|
297
|
-
<
|
|
298
|
-
|
|
299
|
-
|
|
564
|
+
<pre><code>MyApp/
|
|
565
|
+
<span class="code-comment">├── src/ ← Backend .NET Clean Architecture</span>
|
|
566
|
+
│ ├── MyApp.Domain/ <span class="code-comment">← Entites, interfaces, regles metier</span>
|
|
567
|
+
│ ├── MyApp.Application/ <span class="code-comment">← Services, DTOs, IExtensionsDbContext</span>
|
|
568
|
+
│ ├── MyApp.Infrastructure/ <span class="code-comment">← ExtensionsDbContext, Repositories, Migrations</span>
|
|
569
|
+
│ └── MyApp.Api/ <span class="code-comment">← Controllers, Swagger, Program.cs</span>
|
|
570
|
+
<span class="code-comment">├── web/ ← Frontend</span>
|
|
571
|
+
│ └── myapp-web/ <span class="code-comment">← React + Vite + Tailwind</span>
|
|
572
|
+
<span class="code-comment">├── tests/ ← Tests unitaires et integration</span>
|
|
573
|
+
├── .smartstack/config.json <span class="code-comment">← Identite du projet SmartStack</span>
|
|
574
|
+
├── CLAUDE.md <span class="code-comment">← Contexte IA pour Claude Code</span>
|
|
575
|
+
├── Directory.Build.props <span class="code-comment">← TargetFramework partage (net10.0)</span>
|
|
576
|
+
├── .vscode/ <span class="code-comment">← Debug, tasks, extensions recommandees</span>
|
|
577
|
+
├── .ralph/ <span class="code-comment">← Configuration Ralph (IA)</span>
|
|
578
|
+
└── MyApp.sln <span class="code-comment">← Solution Visual Studio</span></code></pre>
|
|
579
|
+
</div>
|
|
300
580
|
|
|
301
|
-
|
|
302
|
-
|
|
581
|
+
<h3 data-lang="fr">Fichiers cles</h3>
|
|
582
|
+
<h3 data-lang="en">Key files</h3>
|
|
583
|
+
|
|
584
|
+
<div class="card-grid">
|
|
585
|
+
<div class="card">
|
|
586
|
+
<div class="card-header">
|
|
587
|
+
<div class="card-icon" style="background: var(--primary);">⚙</div>
|
|
588
|
+
<div>
|
|
589
|
+
<div class="card-title">.smartstack/config.json</div>
|
|
590
|
+
<div class="card-subtitle" data-lang="fr">Identite du projet</div>
|
|
591
|
+
<div class="card-subtitle" data-lang="en">Project identity</div>
|
|
592
|
+
</div>
|
|
593
|
+
</div>
|
|
594
|
+
<div class="card-body">
|
|
595
|
+
<p data-lang="fr">Contient le type de projet (client vs socle), le nom du DbContext, le namespace racine et la version SmartStack installee. Toutes les commandes CLI (<code>ss upgrade</code>, <code>ss doctor</code>) lisent ce fichier pour savoir comment traiter votre projet. Ne le modifiez pas manuellement.</p>
|
|
596
|
+
<p data-lang="en">Contains the project type (client vs foundation), DbContext name, root namespace and installed SmartStack version. All CLI commands (<code>ss upgrade</code>, <code>ss doctor</code>) read this file to know how to handle your project. Do not modify it manually.</p>
|
|
597
|
+
</div>
|
|
598
|
+
</div>
|
|
303
599
|
|
|
304
|
-
|
|
305
|
-
|
|
600
|
+
<div class="card">
|
|
601
|
+
<div class="card-header">
|
|
602
|
+
<div class="card-icon" style="background: var(--secondary);">📝</div>
|
|
603
|
+
<div>
|
|
604
|
+
<div class="card-title">CLAUDE.md</div>
|
|
605
|
+
<div class="card-subtitle" data-lang="fr">Contexte IA</div>
|
|
606
|
+
<div class="card-subtitle" data-lang="en">AI context</div>
|
|
607
|
+
</div>
|
|
608
|
+
</div>
|
|
609
|
+
<div class="card-body">
|
|
610
|
+
<p data-lang="fr">Le contexte que Claude Code utilise pour comprendre votre projet. Genere automatiquement avec les conventions SmartStack, la structure du projet et les regles a respecter. Vous pouvez l'enrichir avec vos propres conventions et regles metier.</p>
|
|
611
|
+
<p data-lang="en">The context Claude Code uses to understand your project. Auto-generated with SmartStack conventions, project structure and rules to follow. You can enrich it with your own conventions and business rules.</p>
|
|
612
|
+
</div>
|
|
613
|
+
</div>
|
|
614
|
+
|
|
615
|
+
<div class="card">
|
|
616
|
+
<div class="card-header">
|
|
617
|
+
<div class="card-icon" style="background: var(--accent);">🔌</div>
|
|
618
|
+
<div>
|
|
619
|
+
<div class="card-title">appsettings.json</div>
|
|
620
|
+
<div class="card-subtitle" data-lang="fr">Configuration API</div>
|
|
621
|
+
<div class="card-subtitle" data-lang="en">API configuration</div>
|
|
622
|
+
</div>
|
|
623
|
+
</div>
|
|
624
|
+
<div class="card-body">
|
|
625
|
+
<p data-lang="fr">Dans <code>src/MyApp.Api/</code>. C'est ici que vous definissez la connection string SQL Server, les parametres JWT, les URLs autorisees (CORS), et la configuration multi-tenant si activee. C'est le premier fichier a configurer apres <code>ss init</code>.</p>
|
|
626
|
+
<p data-lang="en">In <code>src/MyApp.Api/</code>. This is where you define the SQL Server connection string, JWT settings, allowed URLs (CORS), and multi-tenant configuration if enabled. It's the first file to configure after <code>ss init</code>.</p>
|
|
627
|
+
</div>
|
|
628
|
+
</div>
|
|
306
629
|
|
|
307
|
-
|
|
308
|
-
|
|
630
|
+
<div class="card">
|
|
631
|
+
<div class="card-header">
|
|
632
|
+
<div class="card-icon" style="background: var(--success);">⚖</div>
|
|
633
|
+
<div>
|
|
634
|
+
<div class="card-title">Directory.Build.props</div>
|
|
635
|
+
<div class="card-subtitle" data-lang="fr">Framework partage</div>
|
|
636
|
+
<div class="card-subtitle" data-lang="en">Shared framework</div>
|
|
637
|
+
</div>
|
|
638
|
+
</div>
|
|
639
|
+
<div class="card-body">
|
|
640
|
+
<p data-lang="fr">Centralise le <code>TargetFramework</code> (net10.0) pour tous les projets .NET. Au lieu de definir la version dans chaque <code>.csproj</code>, ce fichier unique simplifie les futures mises a jour de framework.</p>
|
|
641
|
+
<p data-lang="en">Centralizes the <code>TargetFramework</code> (net10.0) for all .NET projects. Instead of defining the version in each <code>.csproj</code>, this single file simplifies future framework upgrades.</p>
|
|
642
|
+
</div>
|
|
643
|
+
</div>
|
|
309
644
|
</div>
|
|
645
|
+
|
|
646
|
+
<!-- Frontend -->
|
|
647
|
+
<h3>Frontend — React + Vite + Tailwind</h3>
|
|
648
|
+
|
|
649
|
+
<p data-lang="fr">
|
|
650
|
+
Le frontend est une application React moderne qui s'integre au socle SmartStack via deux mecanismes :
|
|
651
|
+
</p>
|
|
652
|
+
<p data-lang="en">
|
|
653
|
+
The frontend is a modern React application that integrates with the SmartStack foundation through two mechanisms:
|
|
654
|
+
</p>
|
|
655
|
+
|
|
656
|
+
<ul>
|
|
657
|
+
<li data-lang="fr"><strong><code>SmartStackProvider</code></strong> — wrape votre application et fournit l'authentification, les roles, le theming et les notifications. Vous n'avez rien a configurer, c'est deja en place dans <code>main.tsx</code>.</li>
|
|
658
|
+
<li data-lang="en"><strong><code>SmartStackProvider</code></strong> — wraps your application and provides authentication, roles, theming and notifications. You don't need to configure anything, it's already set up in <code>main.tsx</code>.</li>
|
|
659
|
+
<li data-lang="fr"><strong><code>mergeRoutes()</code></strong> — fusionne vos routes metier avec les routes SmartStack (login, profil, admin, gestion des roles...). Vous developpez vos pages dans <code>src/pages/</code> et les declarez dans <code>App.tsx</code>.</li>
|
|
660
|
+
<li data-lang="en"><strong><code>mergeRoutes()</code></strong> — merges your business routes with SmartStack routes (login, profile, admin, role management...). You develop your pages in <code>src/pages/</code> and declare them in <code>App.tsx</code>.</li>
|
|
661
|
+
</ul>
|
|
310
662
|
</section>
|
|
311
663
|
|
|
312
|
-
<!--
|
|
313
|
-
|
|
664
|
+
<!-- ============================================
|
|
665
|
+
5. CYCLE DE DEVELOPPEMENT
|
|
666
|
+
============================================ -->
|
|
667
|
+
<section id="development">
|
|
314
668
|
<h2>
|
|
315
|
-
<span data-lang="fr">
|
|
316
|
-
<span data-lang="en">
|
|
669
|
+
<span data-lang="fr">Cycle de developpement</span>
|
|
670
|
+
<span data-lang="en">Development cycle</span>
|
|
317
671
|
</h2>
|
|
318
672
|
|
|
319
|
-
<p data-lang="fr">
|
|
320
|
-
|
|
673
|
+
<p data-lang="fr">
|
|
674
|
+
Voici le flux typique quand vous ajoutez une fonctionnalite a votre projet. Chaque etape a un skill ou un outil dedie qui vous guide :
|
|
675
|
+
</p>
|
|
676
|
+
<p data-lang="en">
|
|
677
|
+
Here is the typical flow when adding a feature to your project. Each step has a dedicated skill or tool to guide you:
|
|
678
|
+
</p>
|
|
321
679
|
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
680
|
+
<!-- SVG: Development Pipeline -->
|
|
681
|
+
<div class="svg-diagram">
|
|
682
|
+
<svg viewBox="0 0 780 170" xmlns="http://www.w3.org/2000/svg" style="font-family: 'Inter', system-ui, sans-serif; width: 100%; max-width: 780px; height: auto; display: block; margin: 1.5rem auto;">
|
|
683
|
+
<defs>
|
|
684
|
+
<marker id="arrowRight" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto">
|
|
685
|
+
<path d="M0,0 L8,4 L0,8 z" fill="#475569"/>
|
|
686
|
+
</marker>
|
|
687
|
+
</defs>
|
|
688
|
+
|
|
689
|
+
<!-- Step 1: Entity -->
|
|
690
|
+
<rect x="4" y="12" width="108" height="54" rx="8" fill="#1e293b" stroke="#6366f1" stroke-width="2"/>
|
|
691
|
+
<text x="58" y="36" text-anchor="middle" fill="#c8d0dc" font-weight="600" font-size="11.5" data-lang="fr">1. Entite</text>
|
|
692
|
+
<text x="58" y="36" text-anchor="middle" fill="#c8d0dc" font-weight="600" font-size="11.5" data-lang="en">1. Entity</text>
|
|
693
|
+
<text x="58" y="54" text-anchor="middle" fill="#6366f1" font-size="9.5">Domain</text>
|
|
694
|
+
|
|
695
|
+
<!-- Arrow 1→2 -->
|
|
696
|
+
<line x1="116" y1="39" x2="132" y2="39" stroke="#475569" stroke-width="1.5" marker-end="url(#arrowRight)"/>
|
|
697
|
+
|
|
698
|
+
<!-- Step 2: DbContext -->
|
|
699
|
+
<rect x="136" y="12" width="108" height="54" rx="8" fill="#1e293b" stroke="#06b6d4" stroke-width="2"/>
|
|
700
|
+
<text x="190" y="36" text-anchor="middle" fill="#c8d0dc" font-weight="600" font-size="11.5">2. DbContext</text>
|
|
701
|
+
<text x="190" y="54" text-anchor="middle" fill="#06b6d4" font-size="9.5">Infrastructure</text>
|
|
702
|
+
|
|
703
|
+
<!-- Arrow 2→3 -->
|
|
704
|
+
<line x1="248" y1="39" x2="264" y2="39" stroke="#475569" stroke-width="1.5" marker-end="url(#arrowRight)"/>
|
|
705
|
+
|
|
706
|
+
<!-- Step 3: Migration -->
|
|
707
|
+
<rect x="268" y="12" width="108" height="54" rx="8" fill="#1e293b" stroke="#22c55e" stroke-width="2"/>
|
|
708
|
+
<text x="322" y="36" text-anchor="middle" fill="#c8d0dc" font-weight="600" font-size="11.5">3. Migration</text>
|
|
709
|
+
<text x="322" y="54" text-anchor="middle" fill="#22c55e" font-size="9.5">/efcore</text>
|
|
710
|
+
|
|
711
|
+
<!-- Arrow 3→4 -->
|
|
712
|
+
<line x1="380" y1="39" x2="396" y2="39" stroke="#475569" stroke-width="1.5" marker-end="url(#arrowRight)"/>
|
|
713
|
+
|
|
714
|
+
<!-- Step 4: Service -->
|
|
715
|
+
<rect x="400" y="12" width="108" height="54" rx="8" fill="#1e293b" stroke="#3b82f6" stroke-width="2"/>
|
|
716
|
+
<text x="454" y="36" text-anchor="middle" fill="#c8d0dc" font-weight="600" font-size="11.5">4. Service</text>
|
|
717
|
+
<text x="454" y="54" text-anchor="middle" fill="#3b82f6" font-size="9.5">Application</text>
|
|
718
|
+
|
|
719
|
+
<!-- Arrow 4→5 -->
|
|
720
|
+
<line x1="512" y1="39" x2="528" y2="39" stroke="#475569" stroke-width="1.5" marker-end="url(#arrowRight)"/>
|
|
721
|
+
|
|
722
|
+
<!-- Step 5: Controller -->
|
|
723
|
+
<rect x="532" y="12" width="108" height="54" rx="8" fill="#1e293b" stroke="#f97316" stroke-width="2"/>
|
|
724
|
+
<text x="586" y="36" text-anchor="middle" fill="#c8d0dc" font-weight="600" font-size="11.5">5. Controller</text>
|
|
725
|
+
<text x="586" y="54" text-anchor="middle" fill="#f97316" font-size="9.5">Api</text>
|
|
726
|
+
|
|
727
|
+
<!-- Arrow 5→6 -->
|
|
728
|
+
<line x1="644" y1="39" x2="660" y2="39" stroke="#475569" stroke-width="1.5" marker-end="url(#arrowRight)"/>
|
|
729
|
+
|
|
730
|
+
<!-- Step 6: Page -->
|
|
731
|
+
<rect x="664" y="12" width="108" height="54" rx="8" fill="#1e293b" stroke="#06b6d4" stroke-width="2"/>
|
|
732
|
+
<text x="718" y="36" text-anchor="middle" fill="#c8d0dc" font-weight="600" font-size="11.5">6. Page</text>
|
|
733
|
+
<text x="718" y="54" text-anchor="middle" fill="#06b6d4" font-size="9.5">React</text>
|
|
734
|
+
|
|
735
|
+
<!-- Bottom: skill labels -->
|
|
736
|
+
<text x="58" y="90" text-anchor="middle" fill="#8a9bb0" font-size="9">Product.cs</text>
|
|
737
|
+
<text x="190" y="90" text-anchor="middle" fill="#8a9bb0" font-size="9" data-lang="fr">DbSet<Product></text>
|
|
738
|
+
<text x="190" y="90" text-anchor="middle" fill="#8a9bb0" font-size="9" data-lang="en">DbSet<Product></text>
|
|
739
|
+
<text x="322" y="90" text-anchor="middle" fill="#22c55e" font-size="9" font-weight="600">/efcore migration</text>
|
|
740
|
+
<text x="322" y="104" text-anchor="middle" fill="#22c55e" font-size="9" font-weight="600">/efcore db-deploy</text>
|
|
741
|
+
<text x="454" y="90" text-anchor="middle" fill="#8a9bb0" font-size="9">ProductService</text>
|
|
742
|
+
<text x="586" y="90" text-anchor="middle" fill="#8a9bb0" font-size="9">ProductController</text>
|
|
743
|
+
<text x="718" y="90" text-anchor="middle" fill="#8a9bb0" font-size="9">ProductPage.tsx</text>
|
|
744
|
+
|
|
745
|
+
<!-- Automation bar -->
|
|
746
|
+
<rect x="4" y="125" width="772" height="36" rx="8" fill="#1e293b" stroke="#eab308" stroke-width="1.5" stroke-dasharray="6,3"/>
|
|
747
|
+
<text x="390" y="148" text-anchor="middle" fill="#eab308" font-size="11" font-weight="600" data-lang="fr">⚡ /apex ou /application — orchestre tout le processus automatiquement</text>
|
|
748
|
+
<text x="390" y="148" text-anchor="middle" fill="#eab308" font-size="11" font-weight="600" data-lang="en">⚡ /apex or /application — orchestrates the entire process automatically</text>
|
|
749
|
+
</svg>
|
|
750
|
+
</div>
|
|
751
|
+
|
|
752
|
+
<p data-lang="fr">
|
|
753
|
+
Vous pouvez realiser chaque etape manuellement, ou utiliser <strong><code>/apex</code></strong> qui orchestre l'ensemble du processus en analysant votre besoin, planifiant les modifications, les executant et verifiant le resultat. Pour generer un module complet (entite + service + controller + page), utilisez <strong><code>/application</code></strong>.
|
|
754
|
+
</p>
|
|
755
|
+
<p data-lang="en">
|
|
756
|
+
You can perform each step manually, or use <strong><code>/apex</code></strong> which orchestrates the entire process by analyzing your need, planning modifications, executing them and verifying the result. To generate a complete module (entity + service + controller + page), use <strong><code>/application</code></strong>.
|
|
757
|
+
</p>
|
|
758
|
+
|
|
759
|
+
<div class="alert alert-info">
|
|
760
|
+
<span class="alert-icon">🔗</span>
|
|
761
|
+
<div class="alert-content">
|
|
762
|
+
<h5 data-lang="fr">Pages liees</h5>
|
|
763
|
+
<h5 data-lang="en">Related pages</h5>
|
|
764
|
+
<p data-lang="fr">
|
|
765
|
+
<a href="efcore.html">EF Core</a> — workflow complet des migrations (conflits, rebase, squash) •
|
|
766
|
+
<a href="gitflow.html">GitFlow</a> — gestion des branches et versioning •
|
|
767
|
+
<a href="apex.html">APEX</a> — implementation guidee etape par etape
|
|
768
|
+
</p>
|
|
769
|
+
<p data-lang="en">
|
|
770
|
+
<a href="efcore.html">EF Core</a> — complete migration workflow (conflicts, rebase, squash) •
|
|
771
|
+
<a href="gitflow.html">GitFlow</a> — branch management and versioning •
|
|
772
|
+
<a href="apex.html">APEX</a> — step-by-step guided implementation
|
|
773
|
+
</p>
|
|
774
|
+
</div>
|
|
347
775
|
</div>
|
|
348
776
|
</section>
|
|
349
777
|
|
|
350
|
-
<!--
|
|
351
|
-
|
|
778
|
+
<!-- ============================================
|
|
779
|
+
6. MAINTENIR VOTRE PROJET
|
|
780
|
+
============================================ -->
|
|
781
|
+
<section id="maintenance">
|
|
352
782
|
<h2>
|
|
353
|
-
<span data-lang="fr">
|
|
354
|
-
<span data-lang="en">
|
|
783
|
+
<span data-lang="fr">Maintenir votre projet</span>
|
|
784
|
+
<span data-lang="en">Maintain your project</span>
|
|
355
785
|
</h2>
|
|
356
786
|
|
|
357
|
-
<
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
787
|
+
<p data-lang="fr">
|
|
788
|
+
Trois commandes couvrent la maintenance de votre environnement SmartStack. Chacune a un perimetre different — voici quand et pourquoi les utiliser :
|
|
789
|
+
</p>
|
|
790
|
+
<p data-lang="en">
|
|
791
|
+
Three commands cover your SmartStack environment maintenance. Each has a different scope — here's when and why to use them:
|
|
792
|
+
</p>
|
|
793
|
+
|
|
794
|
+
<div class="card-grid">
|
|
795
|
+
<div class="card">
|
|
796
|
+
<div class="card-header">
|
|
797
|
+
<div class="card-icon" style="background: var(--accent);">🔄</div>
|
|
798
|
+
<div>
|
|
799
|
+
<div class="card-title">ss update</div>
|
|
800
|
+
<div class="card-subtitle" data-lang="fr">Outillage Claude Code</div>
|
|
801
|
+
<div class="card-subtitle" data-lang="en">Claude Code tooling</div>
|
|
802
|
+
</div>
|
|
803
|
+
</div>
|
|
804
|
+
<div class="card-body">
|
|
805
|
+
<p data-lang="fr">
|
|
806
|
+
Met a jour les <strong>skills, agents et hooks</strong> de Claude Code vers la derniere version. Utilisez-la quand SmartStack publie de nouvelles capacites IA (nouveaux skills, agents ameliores, hooks de securite). Ne touche <em>jamais</em> a votre code ni a vos packages — c'est uniquement l'outillage Claude Code qui evolue.
|
|
807
|
+
</p>
|
|
808
|
+
<p data-lang="en">
|
|
809
|
+
Updates Claude Code <strong>skills, agents and hooks</strong> to the latest version. Use it when SmartStack publishes new AI capabilities (new skills, improved agents, security hooks). <em>Never</em> touches your code or packages — only the Claude Code tooling evolves.
|
|
810
|
+
</p>
|
|
811
|
+
<p><code>--local</code> <span data-lang="fr">installe dans <code>.claude/</code> du projet</span><span data-lang="en">installs in the project's <code>.claude/</code></span> • <code>--dry-run</code> <span data-lang="fr">previsualise</span><span data-lang="en">previews</span></p>
|
|
812
|
+
</div>
|
|
813
|
+
</div>
|
|
814
|
+
|
|
815
|
+
<div class="card">
|
|
816
|
+
<div class="card-header">
|
|
817
|
+
<div class="card-icon" style="background: var(--secondary);">📦</div>
|
|
818
|
+
<div>
|
|
819
|
+
<div class="card-title">ss upgrade</div>
|
|
820
|
+
<div class="card-subtitle" data-lang="fr">Packages du projet</div>
|
|
821
|
+
<div class="card-subtitle" data-lang="en">Project packages</div>
|
|
822
|
+
</div>
|
|
823
|
+
</div>
|
|
824
|
+
<div class="card-body">
|
|
825
|
+
<p data-lang="fr">
|
|
826
|
+
Met a jour les <strong>packages SmartStack</strong> dans votre projet : NuGet (SmartStack, EF Core, JWT, Swashbuckle...) dans tous les projets .NET, et npm (<code>@atlashub/smartstack</code>) dans le frontend. Si necessaire, applique automatiquement des <strong>migrations de code</strong> pour adapter votre projet aux breaking changes.
|
|
827
|
+
</p>
|
|
828
|
+
<p data-lang="en">
|
|
829
|
+
Updates <strong>SmartStack packages</strong> in your project: NuGet (SmartStack, EF Core, JWT, Swashbuckle...) in all .NET projects, and npm (<code>@atlashub/smartstack</code>) in the frontend. If needed, automatically applies <strong>code migrations</strong> to adapt your project to breaking changes.
|
|
830
|
+
</p>
|
|
831
|
+
<p><code>--preview</code> <span data-lang="fr">versions prerelease</span><span data-lang="en">prerelease versions</span> • <code>--dry-run</code> <span data-lang="fr">liste sans appliquer</span><span data-lang="en">list without applying</span></p>
|
|
832
|
+
</div>
|
|
833
|
+
</div>
|
|
834
|
+
|
|
835
|
+
<div class="card">
|
|
836
|
+
<div class="card-header">
|
|
837
|
+
<div class="card-icon" style="background: var(--success);">🩺</div>
|
|
838
|
+
<div>
|
|
839
|
+
<div class="card-title">ss doctor</div>
|
|
840
|
+
<div class="card-subtitle" data-lang="fr">Diagnostic complet</div>
|
|
841
|
+
<div class="card-subtitle" data-lang="en">Full diagnostic</div>
|
|
842
|
+
</div>
|
|
843
|
+
</div>
|
|
844
|
+
<div class="card-body">
|
|
845
|
+
<p data-lang="fr">
|
|
846
|
+
Diagnostique <strong>l'ensemble de votre environnement</strong> : versions (Node.js, .NET, Git, Claude Code), etat du MCP, licence, composants installes, configuration. Affiche les correctifs recommandes pour chaque probleme detecte. Lancez-la quand quelque chose ne fonctionne pas ou apres une installation fraiche.
|
|
847
|
+
</p>
|
|
848
|
+
<p data-lang="en">
|
|
849
|
+
Diagnoses your <strong>entire environment</strong>: versions (Node.js, .NET, Git, Claude Code), MCP state, license, installed components, configuration. Shows recommended fixes for each detected issue. Run it when something doesn't work or after a fresh installation.
|
|
850
|
+
</p>
|
|
851
|
+
<p><code>--json</code> <span data-lang="fr">export JSON</span><span data-lang="en">JSON export</span> • <code>--verbose</code> <span data-lang="fr">details complets</span><span data-lang="en">full details</span></p>
|
|
852
|
+
</div>
|
|
853
|
+
</div>
|
|
854
|
+
</div>
|
|
365
855
|
</section>
|
|
366
856
|
|
|
367
|
-
<!--
|
|
368
|
-
|
|
857
|
+
<!-- ============================================
|
|
858
|
+
7. PREMIERS PAS
|
|
859
|
+
============================================ -->
|
|
860
|
+
<section id="first-steps">
|
|
369
861
|
<h2>
|
|
370
|
-
<span data-lang="fr">
|
|
371
|
-
<span data-lang="en">
|
|
862
|
+
<span data-lang="fr">Premiers pas apres l'initialisation</span>
|
|
863
|
+
<span data-lang="en">First steps after initialization</span>
|
|
372
864
|
</h2>
|
|
373
865
|
|
|
866
|
+
<p data-lang="fr">
|
|
867
|
+
Votre projet est cree. Voici les etapes pour le rendre operationnel :
|
|
868
|
+
</p>
|
|
869
|
+
<p data-lang="en">
|
|
870
|
+
Your project is created. Here are the steps to make it operational:
|
|
871
|
+
</p>
|
|
872
|
+
|
|
374
873
|
<ol class="steps-list">
|
|
375
874
|
<li>
|
|
376
875
|
<div class="step-content">
|
|
377
|
-
<h5 data-lang="fr">Configurer la
|
|
378
|
-
<h5 data-lang="en">Configure
|
|
379
|
-
<p data-lang="fr">
|
|
380
|
-
|
|
876
|
+
<h5 data-lang="fr">Configurer la base de donnees</h5>
|
|
877
|
+
<h5 data-lang="en">Configure the database</h5>
|
|
878
|
+
<p data-lang="fr">
|
|
879
|
+
Ouvrez <code>src/MyApp.Api/appsettings.json</code>, section <code>ConnectionStrings</code>. Remplacez la valeur par defaut par votre serveur SQL Server :
|
|
880
|
+
</p>
|
|
881
|
+
<p data-lang="en">
|
|
882
|
+
Open <code>src/MyApp.Api/appsettings.json</code>, section <code>ConnectionStrings</code>. Replace the default value with your SQL Server:
|
|
883
|
+
</p>
|
|
884
|
+
<div class="code-block">
|
|
885
|
+
<button class="copy-btn">Copy</button>
|
|
886
|
+
<pre><code>"ConnectionStrings": {
|
|
887
|
+
"DefaultConnection": "Server=localhost;Database=MyApp;Trusted_Connection=true;TrustServerCertificate=true"
|
|
888
|
+
}</code></pre>
|
|
889
|
+
</div>
|
|
890
|
+
</div>
|
|
891
|
+
</li>
|
|
892
|
+
<li>
|
|
893
|
+
<div class="step-content">
|
|
894
|
+
<h5 data-lang="fr">Initialiser GitFlow</h5>
|
|
895
|
+
<h5 data-lang="en">Initialize GitFlow</h5>
|
|
896
|
+
<p data-lang="fr">
|
|
897
|
+
Dans Claude Code, tapez <code>/gitflow init</code>. Cela configure les branches <code>main</code>/<code>develop</code>, le versioning SemVer et les worktrees Git. Indispensable avant de commencer a developper en equipe.
|
|
898
|
+
</p>
|
|
899
|
+
<p data-lang="en">
|
|
900
|
+
In Claude Code, type <code>/gitflow init</code>. This configures <code>main</code>/<code>develop</code> branches, SemVer versioning and Git worktrees. Essential before starting team development.
|
|
901
|
+
</p>
|
|
381
902
|
</div>
|
|
382
903
|
</li>
|
|
383
904
|
<li>
|
|
384
905
|
<div class="step-content">
|
|
385
906
|
<h5 data-lang="fr">Creer la migration initiale</h5>
|
|
386
|
-
<h5 data-lang="en">Create initial migration</h5>
|
|
387
|
-
<
|
|
388
|
-
<
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
</
|
|
907
|
+
<h5 data-lang="en">Create the initial migration</h5>
|
|
908
|
+
<p data-lang="fr">
|
|
909
|
+
Dans Claude Code : <code>/efcore migration</code>. Le MCP suggere le nom de la migration et valide son contenu. Cette premiere migration cree les tables de votre <code>ExtensionsDbContext</code>.
|
|
910
|
+
</p>
|
|
911
|
+
<p data-lang="en">
|
|
912
|
+
In Claude Code: <code>/efcore migration</code>. The MCP suggests the migration name and validates its content. This first migration creates the tables for your <code>ExtensionsDbContext</code>.
|
|
913
|
+
</p>
|
|
393
914
|
</div>
|
|
394
915
|
</li>
|
|
395
916
|
<li>
|
|
396
917
|
<div class="step-content">
|
|
397
|
-
<h5 data-lang="fr">
|
|
398
|
-
<h5 data-lang="en">
|
|
399
|
-
<
|
|
400
|
-
<
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
</
|
|
918
|
+
<h5 data-lang="fr">Deployer la base de donnees</h5>
|
|
919
|
+
<h5 data-lang="en">Deploy the database</h5>
|
|
920
|
+
<p data-lang="fr">
|
|
921
|
+
Dans Claude Code : <code>/efcore db-deploy</code>. Applique toutes les migrations en attente et cree les tables dans SQL Server. Vous pouvez verifier l'etat avec <code>/efcore db-status</code>.
|
|
922
|
+
</p>
|
|
923
|
+
<p data-lang="en">
|
|
924
|
+
In Claude Code: <code>/efcore db-deploy</code>. Applies all pending migrations and creates the tables in SQL Server. You can check the state with <code>/efcore db-status</code>.
|
|
925
|
+
</p>
|
|
405
926
|
</div>
|
|
406
927
|
</li>
|
|
407
928
|
<li>
|
|
408
929
|
<div class="step-content">
|
|
409
|
-
<h5 data-lang="fr">
|
|
410
|
-
<h5 data-lang="en">
|
|
930
|
+
<h5 data-lang="fr">Installer le frontend</h5>
|
|
931
|
+
<h5 data-lang="en">Install the frontend</h5>
|
|
932
|
+
<p data-lang="fr">
|
|
933
|
+
Dans le terminal, placez-vous dans le dossier frontend :
|
|
934
|
+
</p>
|
|
935
|
+
<p data-lang="en">
|
|
936
|
+
In the terminal, navigate to the frontend folder:
|
|
937
|
+
</p>
|
|
411
938
|
<div class="code-block">
|
|
412
939
|
<button class="copy-btn">Copy</button>
|
|
413
|
-
<pre><code>
|
|
940
|
+
<pre><code><span class="code-cmd">cd</span> <span class="code-arg">web/myapp-web</span>
|
|
941
|
+
<span class="code-cmd">npm install</span></code></pre>
|
|
414
942
|
</div>
|
|
415
943
|
</div>
|
|
416
944
|
</li>
|
|
945
|
+
<li>
|
|
946
|
+
<div class="step-content">
|
|
947
|
+
<h5 data-lang="fr">Commencer a developper</h5>
|
|
948
|
+
<h5 data-lang="en">Start developing</h5>
|
|
949
|
+
<p data-lang="fr">
|
|
950
|
+
Creez votre premiere branche avec <code>/gitflow start feature ma-feature</code>, puis utilisez <code>/apex</code> pour implementer votre fonctionnalite de maniere guidee, ou <code>/application</code> pour generer un module complet.
|
|
951
|
+
</p>
|
|
952
|
+
<p data-lang="en">
|
|
953
|
+
Create your first branch with <code>/gitflow start feature my-feature</code>, then use <code>/apex</code> for guided implementation, or <code>/application</code> to generate a complete module.
|
|
954
|
+
</p>
|
|
955
|
+
</div>
|
|
956
|
+
</li>
|
|
417
957
|
</ol>
|
|
418
958
|
</section>
|
|
419
959
|
|
|
420
|
-
<!-- MCP Server Features -->
|
|
421
|
-
<section id="mcp-features">
|
|
422
|
-
<h2>
|
|
423
|
-
<span data-lang="fr">Fonctionnalites MCP</span>
|
|
424
|
-
<span data-lang="en">MCP Features</span>
|
|
425
|
-
</h2>
|
|
426
|
-
|
|
427
|
-
<h3>SmartStack MCP</h3>
|
|
428
|
-
<div class="table-container">
|
|
429
|
-
<table>
|
|
430
|
-
<thead>
|
|
431
|
-
<tr>
|
|
432
|
-
<th>Tool</th>
|
|
433
|
-
<th>
|
|
434
|
-
<span data-lang="fr">Description</span>
|
|
435
|
-
<span data-lang="en">Description</span>
|
|
436
|
-
</th>
|
|
437
|
-
</tr>
|
|
438
|
-
</thead>
|
|
439
|
-
<tbody>
|
|
440
|
-
<tr>
|
|
441
|
-
<td><code>validate_conventions</code></td>
|
|
442
|
-
<td>
|
|
443
|
-
<span data-lang="fr">Valide les conventions SQL, migrations, services, namespaces</span>
|
|
444
|
-
<span data-lang="en">Validates SQL conventions, migrations, services, namespaces</span>
|
|
445
|
-
</td>
|
|
446
|
-
</tr>
|
|
447
|
-
<tr>
|
|
448
|
-
<td><code>check_migrations</code></td>
|
|
449
|
-
<td>
|
|
450
|
-
<span data-lang="fr">Analyse les conflits EF Core entre branches</span>
|
|
451
|
-
<span data-lang="en">Analyzes EF Core conflicts between branches</span>
|
|
452
|
-
</td>
|
|
453
|
-
</tr>
|
|
454
|
-
<tr>
|
|
455
|
-
<td><code>scaffold_extension</code></td>
|
|
456
|
-
<td>
|
|
457
|
-
<span data-lang="fr">Genere du code (services, entites, controllers, components)</span>
|
|
458
|
-
<span data-lang="en">Generates code (services, entities, controllers, components)</span>
|
|
459
|
-
</td>
|
|
460
|
-
</tr>
|
|
461
|
-
<tr>
|
|
462
|
-
<td><code>api_docs</code></td>
|
|
463
|
-
<td>
|
|
464
|
-
<span data-lang="fr">Documentation API Swagger/OpenAPI</span>
|
|
465
|
-
<span data-lang="en">Swagger/OpenAPI API documentation</span>
|
|
466
|
-
</td>
|
|
467
|
-
</tr>
|
|
468
|
-
</tbody>
|
|
469
|
-
</table>
|
|
470
|
-
</div>
|
|
471
|
-
|
|
472
|
-
<h3>Context7 MCP</h3>
|
|
473
|
-
<div class="table-container">
|
|
474
|
-
<table>
|
|
475
|
-
<thead>
|
|
476
|
-
<tr>
|
|
477
|
-
<th>Tool</th>
|
|
478
|
-
<th>
|
|
479
|
-
<span data-lang="fr">Description</span>
|
|
480
|
-
<span data-lang="en">Description</span>
|
|
481
|
-
</th>
|
|
482
|
-
</tr>
|
|
483
|
-
</thead>
|
|
484
|
-
<tbody>
|
|
485
|
-
<tr>
|
|
486
|
-
<td><code>resolve-library-id</code></td>
|
|
487
|
-
<td>
|
|
488
|
-
<span data-lang="fr">Trouve l'ID Context7 d'une bibliotheque</span>
|
|
489
|
-
<span data-lang="en">Finds the Context7 ID of a library</span>
|
|
490
|
-
</td>
|
|
491
|
-
</tr>
|
|
492
|
-
<tr>
|
|
493
|
-
<td><code>query-docs</code></td>
|
|
494
|
-
<td>
|
|
495
|
-
<span data-lang="fr">Recupere la documentation et exemples de code a jour</span>
|
|
496
|
-
<span data-lang="en">Retrieves up-to-date documentation and code examples</span>
|
|
497
|
-
</td>
|
|
498
|
-
</tr>
|
|
499
|
-
</tbody>
|
|
500
|
-
</table>
|
|
501
|
-
</div>
|
|
502
|
-
</section>
|
|
503
960
|
</div>
|
|
504
961
|
</main>
|
|
505
962
|
</div>
|