refactor : rename Inventory_frontend to frontend in docs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-01 14:20:19 +02:00
parent 73b2cf300d
commit be859e57db
17 changed files with 227 additions and 227 deletions
--- a/docs/REVIEW_ARCHITECTURE.md
+++ b/docs/REVIEW_ARCHITECTURE.md
@@ -103,10 +103,10 @@ Cela securise l'integrite sans changer l'architecture. Le `resolveTarget` et les
 ### 3. Composables frontend geants (400-550 LOC)

 **Fichiers concernes :**
- `/Inventory_frontend/app/composables/useComponentEdit.ts` (550 LOC)
- `/Inventory_frontend/app/composables/usePieceEdit.ts` (472 LOC)
- `/Inventory_frontend/app/composables/useMachineDetailData.ts` (468 LOC)
- `/Inventory_frontend/app/composables/useComponentCreate.ts` (417 LOC)
+- `/frontend/app/composables/useComponentEdit.ts` (550 LOC)
+- `/frontend/app/composables/usePieceEdit.ts` (472 LOC)
+- `/frontend/app/composables/useMachineDetailData.ts` (468 LOC)
+- `/frontend/app/composables/useComponentCreate.ts` (417 LOC)

 **Probleme :** Ces composables orchestrent en un seul fichier : le chargement de donnees, la gestion de formulaire, la persistence des custom fields, la gestion des documents, l'historique, la resolution de labels, et la soumission. Chacun instancie 8-12 sous-composables.

@@ -134,9 +134,9 @@ Appliquer le meme pattern a `usePieceEdit` et `useComponentCreate`. Les blocs co
 ### 4. Triple duplication de la logique custom fields frontend

 **Fichiers concernes :**
- `/Inventory_frontend/app/shared/utils/customFieldFormUtils.ts` (404 LOC) - pour les pages create/edit
- `/Inventory_frontend/app/shared/utils/customFieldUtils.ts` (440 LOC) - pour la page machine detail
- `/Inventory_frontend/app/shared/utils/entityCustomFieldLogic.ts` (335 LOC) - pour les composants item
+- `/frontend/app/shared/utils/customFieldFormUtils.ts` (404 LOC) - pour les pages create/edit
+- `/frontend/app/shared/utils/customFieldUtils.ts` (440 LOC) - pour la page machine detail
+- `/frontend/app/shared/utils/entityCustomFieldLogic.ts` (335 LOC) - pour les composants item

 **Probleme :** Ces 3 fichiers resolvent le meme probleme (normaliser des definitions de custom fields + merger avec des valeurs existantes) avec des implementations differentes :
 - `customFieldFormUtils.ts` : `resolveFieldName()`, `resolveFieldType()`, `buildCustomFieldInputs()`
@@ -273,7 +273,7 @@ public function process(mixed $data, Operation $operation, ...): mixed
 ### 9. Dependance circulaire dans `useMachineDetailData`

 **Fichier concerne :**
- `/Inventory_frontend/app/composables/useMachineDetailData.ts` (lignes 119-187)
+- `/frontend/app/composables/useMachineDetailData.ts` (lignes 119-187)

 **Probleme :** `useMachineDetailProducts` a besoin de `machineProductLinks` (venant de hierarchy), et `useMachineDetailHierarchy` a besoin de `findProductById` (venant de products). La solution actuelle utilise un `_machineProductLinksProxy` ref avec un watcher pour synchroniser.

--- a/docs/superpowers/plans/2026-03-12-json-to-tables-normalization.md
+++ b/docs/superpowers/plans/2026-03-12-json-to-tables-normalization.md
@@ -811,9 +811,9 @@ private function resolvePieceQuantity(MachinePieceLink $pieceLink): int
 ### Task 2.5: Update Frontend to Handle New Structure Format

 **Files:**
- Modify: `Inventory_frontend/app/composables/useMachineHierarchy.ts` — `buildMachineHierarchyFromLinks()`
- Modify: `Inventory_frontend/app/shared/utils/structureDisplayUtils.ts`
- Modify: `Inventory_frontend/app/shared/utils/structureSelectionUtils.ts`
+- Modify: `frontend/app/composables/useMachineHierarchy.ts` — `buildMachineHierarchyFromLinks()`
+- Modify: `frontend/app/shared/utils/structureDisplayUtils.ts`
+- Modify: `frontend/app/shared/utils/structureSelectionUtils.ts`

 **Note:** The API response shape for `structure` stays the same (pieces/subcomponents/products arrays), so frontend changes should be minimal. The main change is that `path` fields are removed and `resolvedPiece` is now always populated inline.

@@ -950,7 +950,7 @@ ALTER TABLE pieces DROP COLUMN IF EXISTS productids;
 ### Task 4.1: Update Frontend Types

 **Files:**
- Modify: `Inventory_frontend/app/shared/types/` (if type definitions reference structure/skeleton JSON shapes)
+- Modify: `frontend/app/shared/types/` (if type definitions reference structure/skeleton JSON shapes)

 - [ ] **Step 1: Search frontend for all references to `structure.pieces`, `structure.subcomponents`, `structure.products`, `skeleton`, `productIds`**

--- a/docs/superpowers/plans/2026-03-12-piece-quantity.md
+++ b/docs/superpowers/plans/2026-03-12-piece-quantity.md
@@ -274,15 +274,15 @@ git commit -m "test(piece) : add quantity tests for MachinePieceLink"
 ### Task 4: TypeScript Types + Sanitization + Hydration Functions

 **Files:**
- Modify: `Inventory_frontend/app/shared/types/inventory.ts`
- Modify: `Inventory_frontend/app/shared/model/componentStructure.ts`
- Modify: `Inventory_frontend/app/shared/model/componentStructureSanitize.ts`
- Modify: `Inventory_frontend/app/shared/model/componentStructureHydrate.ts`
- Modify: `Inventory_frontend/app/shared/utils/structureAssignmentHelpers.ts`
+- Modify: `frontend/app/shared/types/inventory.ts`
+- Modify: `frontend/app/shared/model/componentStructure.ts`
+- Modify: `frontend/app/shared/model/componentStructureSanitize.ts`
+- Modify: `frontend/app/shared/model/componentStructureHydrate.ts`
+- Modify: `frontend/app/shared/utils/structureAssignmentHelpers.ts`

 - [ ] **Step 1: Add `quantity` to `ComponentModelPiece` type**

-In `Inventory_frontend/app/shared/types/inventory.ts`, add `quantity` to the `ComponentModelPiece` interface (after `role`, line ~23):
+In `frontend/app/shared/types/inventory.ts`, add `quantity` to the `ComponentModelPiece` interface (after `role`, line ~23):

 ```typescript
 quantity?: number
@@ -290,7 +290,7 @@ quantity?: number

 - [ ] **Step 2: Add `quantity` to `validatePiece()` in same file**

-In `Inventory_frontend/app/shared/types/inventory.ts`, in `validatePiece()` (line ~144-172):
+In `frontend/app/shared/types/inventory.ts`, in `validatePiece()` (line ~144-172):

 After `const role = ensureString(value.role)` (line ~161), add:

@@ -306,7 +306,7 @@ And in the return object, add after the `role` spread:

 - [ ] **Step 3: Update `sanitizePieces()` to preserve quantity**

-In `Inventory_frontend/app/shared/model/componentStructureSanitize.ts`, in `sanitizePieces()` (~line 130-188).
+In `frontend/app/shared/model/componentStructureSanitize.ts`, in `sanitizePieces()` (~line 130-188).

 After the existing field extractions, add:

@@ -324,7 +324,7 @@ if (quantity !== undefined) {

 - [ ] **Step 4: Update `normalizeStructureForSave()` to include quantity**

-In `Inventory_frontend/app/shared/model/componentStructure.ts`, in `normalizeStructureForSave()` (~lines 164-179), add in the piece payload mapping after the `reference` check:
+In `frontend/app/shared/model/componentStructure.ts`, in `normalizeStructureForSave()` (~lines 164-179), add in the piece payload mapping after the `reference` check:

 ```typescript
 if ((piece as any).quantity !== undefined && (piece as any).quantity >= 1) {
@@ -336,7 +336,7 @@ if ((piece as any).quantity !== undefined && (piece as any).quantity >= 1) {

 - [ ] **Step 5: Update `hydratePieces()` and `mapComponentPieces()` to preserve quantity**

-In `Inventory_frontend/app/shared/model/componentStructureHydrate.ts`:
+In `frontend/app/shared/model/componentStructureHydrate.ts`:

 In `hydratePieces()` (line ~95-107), add to the mapped object:

@@ -352,7 +352,7 @@ In `mapComponentPieces()` (line ~168-179), add to the mapped object:

 - [ ] **Step 6: Update `sanitizePieceDefinition()` to preserve quantity**

-In `Inventory_frontend/app/shared/utils/structureAssignmentHelpers.ts`, in `sanitizePieceDefinition()` (~lines 172-180), add to the `stripNullish()` object:
+In `frontend/app/shared/utils/structureAssignmentHelpers.ts`, in `sanitizePieceDefinition()` (~lines 172-180), add to the `stripNullish()` object:

 ```typescript
 quantity: typeof (definition as any).quantity === 'number' ? (definition as any).quantity : null,
@@ -361,14 +361,14 @@ quantity: typeof (definition as any).quantity === 'number' ? (definition as any)
 - [ ] **Step 7: Run lint + typecheck**

 ```bash
-cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck
+cd frontend && npm run lint:fix && npx nuxi typecheck
 ```
 Expected: 0 errors

 - [ ] **Step 8: Commit**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/shared/types/inventory.ts app/shared/model/componentStructure.ts app/shared/model/componentStructureSanitize.ts app/shared/model/componentStructureHydrate.ts app/shared/utils/structureAssignmentHelpers.ts
 git commit -m "feat(piece) : add quantity field to piece types, sanitization and hydration"
 ```
@@ -378,14 +378,14 @@ git commit -m "feat(piece) : add quantity field to piece types, sanitization and
 ### Task 5: Composant Structure Editor — Quantity Input

 **Files:**
- Modify: `Inventory_frontend/app/components/StructureNodeEditor.vue` (piece section, lines ~229-299)
- Modify: `Inventory_frontend/app/composables/useStructureNodeCrud.ts` (`addPiece()`, lines ~110-118)
+- Modify: `frontend/app/components/StructureNodeEditor.vue` (piece section, lines ~229-299)
+- Modify: `frontend/app/composables/useStructureNodeCrud.ts` (`addPiece()`, lines ~110-118)

 **Context:** `StructureNodeEditor.vue` renders the composant structure editor. The piece section (lines ~236-293) currently shows only a `select` for `typePieceId` and a delete button. The `addPiece()` function in `useStructureNodeCrud.ts` creates new piece entries with default fields.

 - [ ] **Step 1: Add default quantity to `addPiece()`**

-In `Inventory_frontend/app/composables/useStructureNodeCrud.ts`, in `addPiece()` (line ~110-118), add `quantity: 1` to the pushed object:
+In `frontend/app/composables/useStructureNodeCrud.ts`, in `addPiece()` (line ~110-118), add `quantity: 1` to the pushed object:

 ```typescript
 const addPiece = () => {
@@ -403,7 +403,7 @@ const addPiece = () => {

 - [ ] **Step 2: Add quantity input in `StructureNodeEditor.vue`**

-In `Inventory_frontend/app/components/StructureNodeEditor.vue`, in the piece item rendering section (inside the `v-for` loop for pieces, line ~256-292), add a quantity input next to the existing piece type `select`. Place it after the select and before the delete button:
+In `frontend/app/components/StructureNodeEditor.vue`, in the piece item rendering section (inside the `v-for` loop for pieces, line ~256-292), add a quantity input next to the existing piece type `select`. Place it after the select and before the delete button:

 ```vue
 <input
@@ -420,14 +420,14 @@ In `Inventory_frontend/app/components/StructureNodeEditor.vue`, in the piece ite
 - [ ] **Step 3: Run lint + typecheck**

 ```bash
-cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck
+cd frontend && npm run lint:fix && npx nuxi typecheck
 ```
 Expected: 0 errors

 - [ ] **Step 4: Commit**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/components/StructureNodeEditor.vue app/composables/useStructureNodeCrud.ts
 git commit -m "feat(piece) : add quantity input to composant structure editor"
 ```
@@ -437,13 +437,13 @@ git commit -m "feat(piece) : add quantity input to composant structure editor"
 ### Task 6: Machine Detail Page — Display Quantity

 **Files:**
- Modify: `Inventory_frontend/app/components/PieceItem.vue`
+- Modify: `frontend/app/components/PieceItem.vue`

 **Context:** `PieceItem.vue` renders each piece in the machine structure view. The piece name is displayed at line ~26 in an `<h3>` tag. Quantity should appear as "×N" after the name, in secondary text. For direct pieces (no parent component), it should be editable. For composant pieces, read-only.

 - [ ] **Step 1: Add quantity display to PieceItem**

-In `Inventory_frontend/app/components/PieceItem.vue`, after the piece name in the `<h3>` tag (line ~26), add the quantity display:
+In `frontend/app/components/PieceItem.vue`, after the piece name in the `<h3>` tag (line ~26), add the quantity display:

 ```vue
 <span
@@ -492,14 +492,14 @@ Ensure this value is included in the data emitted when saving (follow the same p
 - [ ] **Step 3: Run lint + typecheck**

 ```bash
-cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck
+cd frontend && npm run lint:fix && npx nuxi typecheck
 ```
 Expected: 0 errors

 - [ ] **Step 4: Commit**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/components/PieceItem.vue
 git commit -m "feat(piece) : display and edit quantity on machine piece items"
 ```
@@ -514,14 +514,14 @@ git commit -m "feat(piece) : display and edit quantity on machine piece items"
 - [ ] **Step 1: Push frontend commits**

 ```bash
-cd Inventory_frontend && git push
+cd frontend && git push
 ```

 - [ ] **Step 2: Update submodule pointer in main repo**

 ```bash
 cd /home/matthieu/dev_malio/Inventory
-git add Inventory_frontend
+git add frontend
 git commit -m "chore(frontend) : update submodule — piece quantity feature"
 ```

--- a/docs/superpowers/plans/2026-03-13-modeltype-sync.md
+++ b/docs/superpowers/plans/2026-03-13-modeltype-sync.md
@@ -1346,13 +1346,13 @@ git commit -m "feat(sync) : add ModelTypeSyncController with preview and sync en
 ### Task 12: Delete `useCategoryEditGuard` composable and tests

 **Files:**
- Delete: `Inventory_frontend/app/composables/useCategoryEditGuard.ts`
- Delete: `Inventory_frontend/tests/composables/useCategoryEditGuard.test.ts`
+- Delete: `frontend/app/composables/useCategoryEditGuard.ts`
+- Delete: `frontend/tests/composables/useCategoryEditGuard.test.ts`

 - [ ] **Step 1: Delete files + commit**

 ```bash
-cd Inventory_frontend
+cd frontend
 rm app/composables/useCategoryEditGuard.ts tests/composables/useCategoryEditGuard.test.ts
 git add -A && git commit -m "refactor(sync) : remove useCategoryEditGuard composable and tests"
 ```
@@ -1362,25 +1362,25 @@ git add -A && git commit -m "refactor(sync) : remove useCategoryEditGuard compos
 ### Task 13: Remove restrictedMode from structure editors and composables

 **Files:**
- Modify: `Inventory_frontend/app/components/StructureNodeEditor.vue` — remove `restrictedMode` prop, `v-if="!restrictedMode"` guards
- Modify: `Inventory_frontend/app/components/PieceModelStructureEditor.vue` — same
- Modify: `Inventory_frontend/app/components/ComponentModelStructureEditor.vue` — remove prop forwarding
- Modify: `Inventory_frontend/app/composables/useStructureNodeCrud.ts` — remove `restrictedMode` from props, remove `isExisting*` guards, remove `initial*Indices`
- Modify: `Inventory_frontend/app/composables/useStructureNodeLogic.ts` — remove from props, computed, and crud call
- Modify: `Inventory_frontend/app/composables/usePieceStructureEditorLogic.ts` — remove from props, remove `isExisting*` guards
+- Modify: `frontend/app/components/StructureNodeEditor.vue` — remove `restrictedMode` prop, `v-if="!restrictedMode"` guards
+- Modify: `frontend/app/components/PieceModelStructureEditor.vue` — same
+- Modify: `frontend/app/components/ComponentModelStructureEditor.vue` — remove prop forwarding
+- Modify: `frontend/app/composables/useStructureNodeCrud.ts` — remove `restrictedMode` from props, remove `isExisting*` guards, remove `initial*Indices`
+- Modify: `frontend/app/composables/useStructureNodeLogic.ts` — remove from props, computed, and crud call
+- Modify: `frontend/app/composables/usePieceStructureEditorLogic.ts` — remove from props, remove `isExisting*` guards

 - [ ] **Step 1: Remove from each file** (read each file first, then edit)

 - [ ] **Step 2: Run lint + typecheck**

 ```bash
-cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck
+cd frontend && npm run lint:fix && npx nuxi typecheck
 ```

 - [ ] **Step 3: Commit**

 ```bash
-cd Inventory_frontend && git add -A && git commit -m "refactor(sync) : remove restrictedMode from structure editors and composables"
+cd frontend && git add -A && git commit -m "refactor(sync) : remove restrictedMode from structure editors and composables"
 ```

 ---
@@ -1388,24 +1388,24 @@ cd Inventory_frontend && git add -A && git commit -m "refactor(sync) : remove re
 ### Task 14: Remove restrictedMode from ModelTypeForm and edit pages

 **Files:**
- Modify: `Inventory_frontend/app/components/model-types/ModelTypeForm.vue` — remove `restrictedMode`, `disableSubmit`, `disableSubmitMessage`, `restrictedModeMessage` props and warning banner
- Modify: `Inventory_frontend/app/pages/component-category/[id]/edit.vue` — remove `useCategoryEditGuard` import/usage, guard props from `<ModelTypeForm>`
- Modify: `Inventory_frontend/app/pages/piece-category/[id]/edit.vue` — same
- Modify: `Inventory_frontend/app/pages/product-category/[id]/edit.vue` — same
- Modify: `Inventory_frontend/tests/components/PieceModelStructureEditor.test.ts` — remove `restrictedMode: true` test cases
+- Modify: `frontend/app/components/model-types/ModelTypeForm.vue` — remove `restrictedMode`, `disableSubmit`, `disableSubmitMessage`, `restrictedModeMessage` props and warning banner
+- Modify: `frontend/app/pages/component-category/[id]/edit.vue` — remove `useCategoryEditGuard` import/usage, guard props from `<ModelTypeForm>`
+- Modify: `frontend/app/pages/piece-category/[id]/edit.vue` — same
+- Modify: `frontend/app/pages/product-category/[id]/edit.vue` — same
+- Modify: `frontend/tests/components/PieceModelStructureEditor.test.ts` — remove `restrictedMode: true` test cases

 - [ ] **Step 1: Clean each file** (read first, then edit)

 - [ ] **Step 2: Run lint + typecheck**

 ```bash
-cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck
+cd frontend && npm run lint:fix && npx nuxi typecheck
 ```

 - [ ] **Step 3: Commit**

 ```bash
-cd Inventory_frontend && git add -A && git commit -m "refactor(sync) : remove restrictedMode from ModelTypeForm and category edit pages"
+cd frontend && git add -A && git commit -m "refactor(sync) : remove restrictedMode from ModelTypeForm and category edit pages"
 ```

 ---
@@ -1415,11 +1415,11 @@ cd Inventory_frontend && git add -A && git commit -m "refactor(sync) : remove re
 ### Task 15: Add sync service functions

 **Files:**
- Modify: `Inventory_frontend/app/services/modelTypes.ts`
+- Modify: `frontend/app/services/modelTypes.ts`

 - [ ] **Step 1: Add `syncPreview` and `syncExecute`**

-Add to the end of `Inventory_frontend/app/services/modelTypes.ts`:
+Add to the end of `frontend/app/services/modelTypes.ts`:

 ```typescript
 export function syncPreview(id: string, structure: unknown, opts: { signal?: AbortSignal } = {}) {
@@ -1466,7 +1466,7 @@ export function syncExecute(id: string, confirmation: { confirmDeletions: boolea
 - [ ] **Step 2: Run lint + typecheck + commit**

 ```bash
-cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck
+cd frontend && npm run lint:fix && npx nuxi typecheck
 git add -A && git commit -m "feat(sync) : add syncPreview and syncExecute service functions"
 ```

@@ -1475,7 +1475,7 @@ git add -A && git commit -m "feat(sync) : add syncPreview and syncExecute servic
 ### Task 16: Create SyncConfirmationModal component

 **Files:**
- Create: `Inventory_frontend/app/components/SyncConfirmationModal.vue`
+- Create: `frontend/app/components/SyncConfirmationModal.vue`

 - [ ] **Step 1: Create the modal**

@@ -1487,7 +1487,7 @@ Emits: `confirm`, `cancel`
 - [ ] **Step 2: Run lint + typecheck + commit**

 ```bash
-cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck
+cd frontend && npm run lint:fix && npx nuxi typecheck
 git add -A && git commit -m "feat(sync) : add SyncConfirmationModal component"
 ```

@@ -1496,9 +1496,9 @@ git add -A && git commit -m "feat(sync) : add SyncConfirmationModal component"
 ### Task 17: Wire sync flow into category edit pages

 **Files:**
- Modify: `Inventory_frontend/app/pages/component-category/[id]/edit.vue`
- Modify: `Inventory_frontend/app/pages/piece-category/[id]/edit.vue`
- Modify: `Inventory_frontend/app/pages/product-category/[id]/edit.vue`
+- Modify: `frontend/app/pages/component-category/[id]/edit.vue`
+- Modify: `frontend/app/pages/piece-category/[id]/edit.vue`
+- Modify: `frontend/app/pages/product-category/[id]/edit.vue`

 - [ ] **Step 1: Update `component-category/[id]/edit.vue`**

@@ -1524,13 +1524,13 @@ Same flow, adapt imports and routes.
 - [ ] **Step 4: Run lint + typecheck + build**

 ```bash
-cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck && npm run build
+cd frontend && npm run lint:fix && npx nuxi typecheck && npm run build
 ```

 - [ ] **Step 5: Commit**

 ```bash
-cd Inventory_frontend && git add -A && git commit -m "feat(sync) : wire sync flow into category edit pages with confirmation modal"
+cd frontend && git add -A && git commit -m "feat(sync) : wire sync flow into category edit pages with confirmation modal"
 ```

 ---
@@ -1547,7 +1547,7 @@ Expected: All tests pass.
 - [ ] **Step 2: Run frontend checks**

 ```bash
-cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck && npm run build
+cd frontend && npm run lint:fix && npx nuxi typecheck && npm run build
 ```

 - [ ] **Step 3: Run php-cs-fixer**
@@ -1561,7 +1561,7 @@ Run: `make php-cs-fixer-allow-risky`
 - [ ] **Step 1: Update frontend submodule**

 ```bash
-git add Inventory_frontend
+git add frontend
 git commit -m "chore(submodule) : update frontend pointer for sync feature"
 ```

--- a/docs/superpowers/plans/2026-03-23-comment-documents.md
+++ b/docs/superpowers/plans/2026-03-23-comment-documents.md
@@ -574,7 +574,7 @@ git commit -m "test(comments) : add tests for comment creation with file attachm
 ### Task 6: Frontend — update useComments composable

 **Files:**
- Modify: `Inventory_frontend/app/composables/useComments.ts`
+- Modify: `frontend/app/composables/useComments.ts`

 - [ ] **Step 1: Add document type to Comment interface**

@@ -661,12 +661,12 @@ const createComment = async (

 - [ ] **Step 3: Run lint + typecheck**

-Run: `cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck`
+Run: `cd frontend && npm run lint:fix && npx nuxi typecheck`

 - [ ] **Step 4: Commit (in frontend submodule)**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/composables/useComments.ts
 git commit -m "feat(comments) : support file attachments in createComment"
 ```
@@ -676,7 +676,7 @@ git commit -m "feat(comments) : support file attachments in createComment"
 ### Task 7: Frontend — update CommentSection.vue

 **Files:**
- Modify: `Inventory_frontend/app/components/CommentSection.vue`
+- Modify: `frontend/app/components/CommentSection.vue`

 - [ ] **Step 1: Add file input and file list display to the template**

@@ -810,12 +810,12 @@ const handleSubmit = async () => {

 - [ ] **Step 3: Run lint + typecheck**

-Run: `cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck`
+Run: `cd frontend && npm run lint:fix && npx nuxi typecheck`

 - [ ] **Step 4: Commit (in frontend submodule)**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/components/CommentSection.vue
 git commit -m "feat(comments) : add file attachment UI to CommentSection"
 ```
@@ -848,7 +848,7 @@ git commit -m "feat(documents) : add comment ExistsFilter"
 - [ ] **Step 4: Update submodule pointer**

 ```bash
-git add Inventory_frontend
+git add frontend
 git commit -m "chore(submodule) : update frontend pointer (comment documents feature)"
 ```

--- a/docs/superpowers/plans/2026-03-23-document-types.md
+++ b/docs/superpowers/plans/2026-03-23-document-types.md
@@ -22,15 +22,15 @@
 - `src/Controller/DocumentQueryController.php` — add `type` to `normalizeDocuments()`

 ### Frontend (create)
- `Inventory_frontend/app/shared/documentTypes.ts` — type constants + labels
- `Inventory_frontend/app/components/DocumentEditModal.vue` — mini-modal for editing name+type
+- `frontend/app/shared/documentTypes.ts` — type constants + labels
+- `frontend/app/components/DocumentEditModal.vue` — mini-modal for editing name+type

 ### Frontend (modify)
- `Inventory_frontend/app/composables/useDocuments.ts` — add `type` to interface + `updateDocument()` method
- `Inventory_frontend/app/components/DocumentUpload.vue` — add type select
- `Inventory_frontend/app/components/common/DocumentListInline.vue` — add type badge + edit button
- `Inventory_frontend/app/composables/useEntityDocuments.ts` — add `updateDocument` delegation
- `Inventory_frontend/app/pages/documents.vue` — add type column + edit button
+- `frontend/app/composables/useDocuments.ts` — add `type` to interface + `updateDocument()` method
+- `frontend/app/components/DocumentUpload.vue` — add type select
+- `frontend/app/components/common/DocumentListInline.vue` — add type badge + edit button
+- `frontend/app/composables/useEntityDocuments.ts` — add `updateDocument` delegation
+- `frontend/app/pages/documents.vue` — add type column + edit button

 ---

@@ -266,13 +266,13 @@ git commit -m "feat(documents) : accept type on upload + expose in query control
 ### Task 4: Frontend — Type Constants + Document Interface

 **Files:**
- Create: `Inventory_frontend/app/shared/documentTypes.ts`
- Modify: `Inventory_frontend/app/composables/useDocuments.ts:6-27` (Document interface), `useDocuments.ts:205-253` (upload)
+- Create: `frontend/app/shared/documentTypes.ts`
+- Modify: `frontend/app/composables/useDocuments.ts:6-27` (Document interface), `useDocuments.ts:205-253` (upload)

 - [ ] **Step 1: Create documentTypes.ts**

 ```typescript
-// Inventory_frontend/app/shared/documentTypes.ts
+// frontend/app/shared/documentTypes.ts
 export const DOCUMENT_TYPES = [
  { value: 'documentation', label: 'Documentation' },
  { value: 'devis', label: 'Devis' },
@@ -355,12 +355,12 @@ Add `updateDocument` to the return object.

 - [ ] **Step 5: Run lint**

-Run: `cd Inventory_frontend && npm run lint:fix`
+Run: `cd frontend && npm run lint:fix`

 - [ ] **Step 6: Commit frontend**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/shared/documentTypes.ts app/composables/useDocuments.ts
 git commit -m "feat(documents) : add document type constants and updateDocument method"
 ```
@@ -370,7 +370,7 @@ git commit -m "feat(documents) : add document type constants and updateDocument
 ### Task 5: Frontend — DocumentUpload Type Select

 **Files:**
- Modify: `Inventory_frontend/app/components/DocumentUpload.vue`
+- Modify: `frontend/app/components/DocumentUpload.vue`

 - [ ] **Step 1: Add type prop and select to DocumentUpload**

@@ -419,12 +419,12 @@ Note: since DocumentUpload uses `<script setup>` without `lang="ts"`, use `@chan

 - [ ] **Step 2: Run lint**

-Run: `cd Inventory_frontend && npm run lint:fix`
+Run: `cd frontend && npm run lint:fix`

 - [ ] **Step 3: Commit**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/components/DocumentUpload.vue
 git commit -m "feat(documents) : add type select to DocumentUpload component"
 ```
@@ -434,7 +434,7 @@ git commit -m "feat(documents) : add type select to DocumentUpload component"
 ### Task 6: Frontend — DocumentEditModal

 **Files:**
- Create: `Inventory_frontend/app/components/DocumentEditModal.vue`
+- Create: `frontend/app/components/DocumentEditModal.vue`

 - [ ] **Step 1: Create DocumentEditModal component**

@@ -533,12 +533,12 @@ const save = () => {

 - [ ] **Step 2: Run lint**

-Run: `cd Inventory_frontend && npm run lint:fix`
+Run: `cd frontend && npm run lint:fix`

 - [ ] **Step 3: Commit**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/components/DocumentEditModal.vue
 git commit -m "feat(documents) : add DocumentEditModal component"
 ```
@@ -548,8 +548,8 @@ git commit -m "feat(documents) : add DocumentEditModal component"
 ### Task 7: Frontend — DocumentListInline + Type Badge + Edit Button

 **Files:**
- Modify: `Inventory_frontend/app/components/common/DocumentListInline.vue`
- Modify: `Inventory_frontend/app/composables/useEntityDocuments.ts`
+- Modify: `frontend/app/components/common/DocumentListInline.vue`
+- Modify: `frontend/app/composables/useEntityDocuments.ts`

 - [ ] **Step 1: Add type badge and edit button to DocumentListInline**

@@ -622,12 +622,12 @@ Add `editDocument` to the return object.

 - [ ] **Step 3: Run lint**

-Run: `cd Inventory_frontend && npm run lint:fix`
+Run: `cd frontend && npm run lint:fix`

 - [ ] **Step 4: Commit**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/components/common/DocumentListInline.vue app/composables/useEntityDocuments.ts
 git commit -m "feat(documents) : add type badge and edit button to DocumentListInline"
 ```
@@ -637,11 +637,11 @@ git commit -m "feat(documents) : add type badge and edit button to DocumentListI
 ### Task 8: Frontend — Wire Edit Modal in Entity Pages

 **Files:**
- Modify: `Inventory_frontend/app/components/ComponentItem.vue`
- Modify: `Inventory_frontend/app/components/PieceItem.vue`
- Modify: `Inventory_frontend/app/pages/pieces/[id]/edit.vue`
- Modify: `Inventory_frontend/app/pages/component/[id]/edit.vue`
- Modify: `Inventory_frontend/app/pages/product/[id]/edit.vue`
+- Modify: `frontend/app/components/ComponentItem.vue`
+- Modify: `frontend/app/components/PieceItem.vue`
+- Modify: `frontend/app/pages/pieces/[id]/edit.vue`
+- Modify: `frontend/app/pages/component/[id]/edit.vue`
+- Modify: `frontend/app/pages/product/[id]/edit.vue`

 - [ ] **Step 1: Wire in ComponentItem and PieceItem**

@@ -688,12 +688,12 @@ Pass `type: uploadDocType.value` in the upload context when calling `handleFiles

 - [ ] **Step 4: Run lint + typecheck**

-Run: `cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck`
+Run: `cd frontend && npm run lint:fix && npx nuxi typecheck`

 - [ ] **Step 5: Commit**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/components/ app/pages/
 git commit -m "feat(documents) : wire DocumentEditModal and type select in all entity pages"
 ```
@@ -703,7 +703,7 @@ git commit -m "feat(documents) : wire DocumentEditModal and type select in all e
 ### Task 9: Frontend — Documents Global Page

 **Files:**
- Modify: `Inventory_frontend/app/pages/documents.vue`
+- Modify: `frontend/app/pages/documents.vue`

 - [ ] **Step 1: Add type column to DataTable**

@@ -765,12 +765,12 @@ Pass `typeFilter` to `fetchDocuments` → `loadDocuments` as a new filter param,

 - [ ] **Step 4: Run lint + typecheck**

-Run: `cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck`
+Run: `cd frontend && npm run lint:fix && npx nuxi typecheck`

 - [ ] **Step 5: Commit**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/pages/documents.vue app/composables/useDocuments.ts
 git commit -m "feat(documents) : add type column, filter, and edit to documents page"
 ```
@@ -789,7 +789,7 @@ Expected: all tests pass

 - [ ] **Step 2: Run full frontend checks**

-Run: `cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck && npm run build`
+Run: `cd frontend && npm run lint:fix && npx nuxi typecheck && npm run build`
 Expected: 0 errors

 - [ ] **Step 3: Manual verification**
@@ -804,6 +804,6 @@ Expected: 0 errors

 ```bash
 cd /home/matthieu/dev_malio/Inventory
-git add Inventory_frontend
+git add frontend
 git commit -m "chore(submodule) : update frontend pointer (document types feature)"
 ```
--- a/docs/superpowers/plans/2026-03-23-fix-data-loss-bugs.md
+++ b/docs/superpowers/plans/2026-03-23-fix-data-loss-bugs.md
@@ -19,9 +19,9 @@
 | T3 | Modify | `src/Service/ModelTypeCategoryConversionService.php:195-236` |
 | T3 | Modify | `src/Service/ModelTypeCategoryConversionService.php:340-405` |
 | T4 | Modify | `src/Controller/CustomFieldValueController.php:199-211` |
-| T5 | Modify | `Inventory_frontend/app/composables/useComponentEdit.ts:398-405` |
-| T5 | Modify | `Inventory_frontend/app/composables/usePieceEdit.ts:407-414` |
-| T6 | Modify | `Inventory_frontend/app/composables/useComponentCreate.ts` (same pattern if present) |
+| T5 | Modify | `frontend/app/composables/useComponentEdit.ts:398-405` |
+| T5 | Modify | `frontend/app/composables/usePieceEdit.ts:407-414` |
+| T6 | Modify | `frontend/app/composables/useComponentCreate.ts` (same pattern if present) |

 ---

@@ -347,8 +347,8 @@ git commit -m "fix(custom-fields) : prevent creation of orphan CustomField witho
 Consequence : le `definitionMap` est toujours vide, les champs perso sans `customFieldId` existant ne trouvent pas leur definition et sont envoyes sans `definitionId` (fallback sur metadata = CustomField orphelin cote backend = Task 4).

 **Files:**
- Modify: `Inventory_frontend/app/composables/useComponentEdit.ts:401-403`
- Modify: `Inventory_frontend/app/composables/usePieceEdit.ts:410-412`
+- Modify: `frontend/app/composables/useComponentEdit.ts:401-403`
+- Modify: `frontend/app/composables/usePieceEdit.ts:410-412`

 - [ ] **Step 1: Fix useComponentEdit.ts**

@@ -387,13 +387,13 @@ Verifier `useComponentCreate.ts`, `pieces/create.vue`, `product/[id]/edit.vue` p
 - [ ] **Step 4: Lint + typecheck**

 ```bash
-cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck
+cd frontend && npm run lint:fix && npx nuxi typecheck
 ```

 - [ ] **Step 5: Commit**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/composables/useComponentEdit.ts app/composables/usePieceEdit.ts
 git commit -m "fix(custom-fields) : use structure.customFields path for definition lookup"
 ```
--- a/docs/superpowers/plans/2026-03-23-parc-machines-ux.md
+++ b/docs/superpowers/plans/2026-03-23-parc-machines-ux.md
@@ -15,7 +15,7 @@
 ### Task 1: Multi-select site checkboxes on Parc Machines

 **Files:**
- Modify: `Inventory_frontend/app/pages/machines/index.vue`
+- Modify: `frontend/app/pages/machines/index.vue`

 - [ ] **Step 1: Replace `selectedSite` ref with reactive Set**

@@ -90,14 +90,14 @@ Open `http://localhost:3001/machines`. Confirm:

 - [ ] **Step 7: Run frontend lint**

-Run: `cd Inventory_frontend && npm run lint:fix`
+Run: `cd frontend && npm run lint:fix`

 ---

 ### Task 2: Alphabetical sorting on Parc Machines

 **Files:**
- Modify: `Inventory_frontend/app/pages/machines/index.vue`
+- Modify: `frontend/app/pages/machines/index.vue`

 - [ ] **Step 1: Add sort to `filteredMachines` computed**

@@ -140,7 +140,7 @@ Open `http://localhost:3001/machines`. Confirm machines are sorted A→Z by name
 - [ ] **Step 3: Commit Tasks 1 + 2**

 ```bash
-cd Inventory_frontend && git add app/pages/machines/index.vue && git commit -m "feat(machines) : multi-select site checkboxes + alphabetical sort"
+cd frontend && git add app/pages/machines/index.vue && git commit -m "feat(machines) : multi-select site checkboxes + alphabetical sort"
 ```

 ---
@@ -342,9 +342,9 @@ git add src/Doctrine/SearchByNameOrReferenceExtension.php tests/Api/FilterTest.p
 ### Task 4: Frontend — Switch composables from `name` to `q`

 **Files:**
- Modify: `Inventory_frontend/app/composables/usePieces.ts`
- Modify: `Inventory_frontend/app/composables/useComposants.ts`
- Modify: `Inventory_frontend/app/composables/useProducts.ts`
+- Modify: `frontend/app/composables/usePieces.ts`
+- Modify: `frontend/app/composables/useComposants.ts`
+- Modify: `frontend/app/composables/useProducts.ts`

 - [ ] **Step 1: Update `usePieces.ts`**

@@ -385,7 +385,7 @@ params.set('q', search.trim())

 - [ ] **Step 4: Run frontend lint**

-Run: `cd Inventory_frontend && npm run lint:fix`
+Run: `cd frontend && npm run lint:fix`

 - [ ] **Step 5: Verify in browser**

@@ -399,11 +399,11 @@ Confirm that searching by a reference value returns the correct results.
 - [ ] **Step 6: Commit frontend changes**

 ```bash
-cd Inventory_frontend && git add app/composables/usePieces.ts app/composables/useComposants.ts app/composables/useProducts.ts && git commit -m "feat(search) : use q param for OR search on name/reference"
+cd frontend && git add app/composables/usePieces.ts app/composables/useComposants.ts app/composables/useProducts.ts && git commit -m "feat(search) : use q param for OR search on name/reference"
 ```

 - [ ] **Step 7: Update submodule pointer in main repo**

 ```bash
-cd /home/matthieu/dev_malio/Inventory && git add Inventory_frontend && git commit -m "chore(submodule) : update frontend pointer (OR search + site checkboxes)"
+cd /home/matthieu/dev_malio/Inventory && git add frontend && git commit -m "chore(submodule) : update frontend pointer (OR search + site checkboxes)"
 ```
--- a/docs/superpowers/plans/2026-03-24-detail-views.md
+++ b/docs/superpowers/plans/2026-03-24-detail-views.md
@@ -1100,13 +1100,13 @@ git commit -m "feat(detail) : update catalogs and cross-links to use detail page
 - [ ] **Step 1: Run lint**

 ```bash
-cd Inventory_frontend && npm run lint:fix
+cd frontend && npm run lint:fix
 ```

 - [ ] **Step 2: Run typecheck**

 ```bash
-cd Inventory_frontend && npx nuxi typecheck
+cd frontend && npx nuxi typecheck
 ```

 Fix any errors found.
--- a/docs/superpowers/plans/2026-03-25-entity-versioning.md
+++ b/docs/superpowers/plans/2026-03-25-entity-versioning.md
@@ -29,15 +29,15 @@
 - `src/Repository/AuditLogRepository.php` — Add `findVersionHistory()` method

 ### Frontend — New Files
- `Inventory_frontend/app/composables/useEntityVersions.ts` — API calls for versions/preview/restore
- `Inventory_frontend/app/components/common/EntityVersionList.vue` — Version list with restore button
- `Inventory_frontend/app/components/common/VersionRestoreModal.vue` — Preview + confirm modal
+- `frontend/app/composables/useEntityVersions.ts` — API calls for versions/preview/restore
+- `frontend/app/components/common/EntityVersionList.vue` — Version list with restore button
+- `frontend/app/components/common/VersionRestoreModal.vue` — Preview + confirm modal

 ### Frontend — Modified Files
- `Inventory_frontend/app/pages/machine/[id].vue` — Add Versions section
- `Inventory_frontend/app/pages/component/[id]/edit.vue` — Add Versions section
- `Inventory_frontend/app/pages/piece/[id].vue` — Add Versions section
- `Inventory_frontend/app/pages/product/[id]/edit.vue` — Add Versions section
+- `frontend/app/pages/machine/[id].vue` — Add Versions section
+- `frontend/app/pages/component/[id]/edit.vue` — Add Versions section
+- `frontend/app/pages/piece/[id].vue` — Add Versions section
+- `frontend/app/pages/product/[id]/edit.vue` — Add Versions section

 ---

@@ -1870,7 +1870,7 @@ git commit -m "test(versioning) : add EntityVersionTest for list, preview and re
 ## Task 9b: Frontend — add `restore` action label to historyDisplayUtils

 **Files:**
- Modify: `Inventory_frontend/app/shared/utils/historyDisplayUtils.ts`
+- Modify: `frontend/app/shared/utils/historyDisplayUtils.ts`

 - [ ] **Step 1: Add `restore` case to `historyActionLabel`**

@@ -1888,7 +1888,7 @@ export const historyActionLabel = (action: string): string => {
 - [ ] **Step 2: Commit in frontend repo**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/shared/utils/historyDisplayUtils.ts
 git commit -m "feat(versioning) : add restore action label to historyDisplayUtils"
 cd ..
@@ -1899,7 +1899,7 @@ cd ..
 ## Task 10: Frontend — useEntityVersions composable

 **Files:**
- Create: `Inventory_frontend/app/composables/useEntityVersions.ts`
+- Create: `frontend/app/composables/useEntityVersions.ts`

 - [ ] **Step 1: Create the composable**

@@ -2004,16 +2004,16 @@ export function useEntityVersions(deps: Deps) {

 - [ ] **Step 2: Run lint**

-Run (in `Inventory_frontend/`): `npm run lint:fix`
+Run (in `frontend/`): `npm run lint:fix`

 - [ ] **Step 3: Run typecheck**

-Run (in `Inventory_frontend/`): `npx nuxi typecheck`
+Run (in `frontend/`): `npx nuxi typecheck`

 - [ ] **Step 4: Commit in frontend repo**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/composables/useEntityVersions.ts
 git commit -m "feat(versioning) : add useEntityVersions composable"
 cd ..
@@ -2024,7 +2024,7 @@ cd ..
 ## Task 11: Frontend — VersionRestoreModal component

 **Files:**
- Create: `Inventory_frontend/app/components/common/VersionRestoreModal.vue`
+- Create: `frontend/app/components/common/VersionRestoreModal.vue`

 - [ ] **Step 1: Create the modal component**

@@ -2129,12 +2129,12 @@ const formatValue = (value: unknown): string => {

 - [ ] **Step 2: Run lint**

-Run (in `Inventory_frontend/`): `npm run lint:fix`
+Run (in `frontend/`): `npm run lint:fix`

 - [ ] **Step 3: Commit**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/components/common/VersionRestoreModal.vue
 git commit -m "feat(versioning) : add VersionRestoreModal component"
 cd ..
@@ -2145,7 +2145,7 @@ cd ..
 ## Task 12: Frontend — EntityVersionList component

 **Files:**
- Create: `Inventory_frontend/app/components/common/EntityVersionList.vue`
+- Create: `frontend/app/components/common/EntityVersionList.vue`

 - [ ] **Step 1: Create the version list component**

@@ -2296,12 +2296,12 @@ onMounted(() => {

 - [ ] **Step 2: Run lint**

-Run (in `Inventory_frontend/`): `npm run lint:fix`
+Run (in `frontend/`): `npm run lint:fix`

 - [ ] **Step 3: Commit**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/components/common/EntityVersionList.vue
 git commit -m "feat(versioning) : add EntityVersionList component with restore flow"
 cd ..
@@ -2312,10 +2312,10 @@ cd ..
 ## Task 13: Frontend — Integrate EntityVersionList into detail pages

 **Files:**
- Modify: `Inventory_frontend/app/pages/machine/[id].vue`
- Modify: `Inventory_frontend/app/pages/component/[id]/edit.vue`
- Modify: `Inventory_frontend/app/pages/piece/[id].vue`
- Modify: `Inventory_frontend/app/pages/product/[id]/edit.vue`
+- Modify: `frontend/app/pages/machine/[id].vue`
+- Modify: `frontend/app/pages/component/[id]/edit.vue`
+- Modify: `frontend/app/pages/piece/[id].vue`
+- Modify: `frontend/app/pages/product/[id]/edit.vue`

 - [ ] **Step 1: Add EntityVersionList to machine/[id].vue**

@@ -2398,16 +2398,16 @@ import EntityVersionList from '~/components/common/EntityVersionList.vue'

 - [ ] **Step 5: Run lint**

-Run (in `Inventory_frontend/`): `npm run lint:fix`
+Run (in `frontend/`): `npm run lint:fix`

 - [ ] **Step 6: Run typecheck**

-Run (in `Inventory_frontend/`): `npx nuxi typecheck`
+Run (in `frontend/`): `npx nuxi typecheck`

 - [ ] **Step 7: Commit in frontend repo**

 ```bash
-cd Inventory_frontend
+cd frontend
 git add app/pages/machine/\[id\].vue app/pages/component/\[id\]/edit.vue app/pages/piece/\[id\].vue app/pages/product/\[id\]/edit.vue
 git commit -m "feat(versioning) : integrate EntityVersionList into all detail pages"
 cd ..
@@ -2416,7 +2416,7 @@ cd ..
 - [ ] **Step 8: Update submodule pointer in main repo**

 ```bash
-git add Inventory_frontend
+git add frontend
 git commit -m "chore(submodule) : update frontend pointer (entity versioning)"
 ```

@@ -2431,7 +2431,7 @@ Expected: All tests pass.

 - [ ] **Step 2: Run frontend lint + typecheck**

-Run (in `Inventory_frontend/`): `npm run lint:fix && npx nuxi typecheck`
+Run (in `frontend/`): `npm run lint:fix && npx nuxi typecheck`
 Expected: 0 errors.

 - [ ] **Step 3: Manual smoke test**
--- a/docs/superpowers/plans/2026-03-26-machine-single-save.md
+++ b/docs/superpowers/plans/2026-03-26-machine-single-save.md
@@ -14,12 +14,12 @@

 | Action | File | Responsibility |
 |--------|------|----------------|
-| Modify | `Inventory_frontend/app/components/machine/MachineInfoCard.vue` | Remove blur-triggered saves, expose saveFieldDefinitions via defineExpose |
-| Modify | `Inventory_frontend/app/components/machine/MachineCustomFieldDefEditor.vue` | Remove standalone save button |
-| Modify | `Inventory_frontend/app/pages/machine/[id].vue` | Add Save/Cancel buttons, wire submitEdition via template ref |
-| Modify | `Inventory_frontend/app/composables/useMachineDetailData.ts` | Add submitEdition, cancelEdition, saving, canSubmit |
-| Modify | `Inventory_frontend/app/composables/useMachineDetailUpdates.ts` | Remove auto-save from handleMachineConstructeurChange |
-| Modify | `Inventory_frontend/app/composables/useMachineDetailCustomFields.ts` | Add saveAllMachineCustomFields batch method |
+| Modify | `frontend/app/components/machine/MachineInfoCard.vue` | Remove blur-triggered saves, expose saveFieldDefinitions via defineExpose |
+| Modify | `frontend/app/components/machine/MachineCustomFieldDefEditor.vue` | Remove standalone save button |
+| Modify | `frontend/app/pages/machine/[id].vue` | Add Save/Cancel buttons, wire submitEdition via template ref |
+| Modify | `frontend/app/composables/useMachineDetailData.ts` | Add submitEdition, cancelEdition, saving, canSubmit |
+| Modify | `frontend/app/composables/useMachineDetailUpdates.ts` | Remove auto-save from handleMachineConstructeurChange |
+| Modify | `frontend/app/composables/useMachineDetailCustomFields.ts` | Add saveAllMachineCustomFields batch method |
 | Modify | `src/EventSubscriber/MachineAuditSubscriber.php` | Enrich snapshot with links + detect link changes in onFlush |

 ---
@@ -27,7 +27,7 @@
 ### Task 1: Remove blur-triggered saves from MachineInfoCard

 **Files:**
- Modify: `Inventory_frontend/app/components/machine/MachineInfoCard.vue`
+- Modify: `frontend/app/components/machine/MachineInfoCard.vue`

 - [ ] **Step 1: Remove `@blur` from name input (line 17)**

@@ -143,7 +143,7 @@ defineExpose({
 - [ ] **Step 7: Commit**

 ```bash
-git add Inventory_frontend/app/components/machine/MachineInfoCard.vue
+git add frontend/app/components/machine/MachineInfoCard.vue
 git commit -m "refactor(machine) : remove blur-triggered auto-saves from MachineInfoCard"
 ```

@@ -152,7 +152,7 @@ git commit -m "refactor(machine) : remove blur-triggered auto-saves from Machine
 ### Task 2: Remove standalone save button from MachineCustomFieldDefEditor

 **Files:**
- Modify: `Inventory_frontend/app/components/machine/MachineCustomFieldDefEditor.vue`
+- Modify: `frontend/app/components/machine/MachineCustomFieldDefEditor.vue`

 - [ ] **Step 1: Remove the "Enregistrer les champs" button (lines 7-15)**

@@ -201,7 +201,7 @@ defineEmits<{
 - [ ] **Step 3: Commit**

 ```bash
-git add Inventory_frontend/app/components/machine/MachineCustomFieldDefEditor.vue
+git add frontend/app/components/machine/MachineCustomFieldDefEditor.vue
 git commit -m "refactor(machine) : remove standalone save button from custom field def editor"
 ```

@@ -210,7 +210,7 @@ git commit -m "refactor(machine) : remove standalone save button from custom fie
 ### Task 3: Stop auto-save in handleMachineConstructeurChange

 **Files:**
- Modify: `Inventory_frontend/app/composables/useMachineDetailUpdates.ts:211-214`
+- Modify: `frontend/app/composables/useMachineDetailUpdates.ts:211-214`

 - [ ] **Step 1: Remove the auto-save call**

@@ -231,7 +231,7 @@ With:
 - [ ] **Step 2: Commit**

 ```bash
-git add Inventory_frontend/app/composables/useMachineDetailUpdates.ts
+git add frontend/app/composables/useMachineDetailUpdates.ts
 git commit -m "refactor(machine) : stop auto-saving on constructeur change"
 ```

@@ -240,7 +240,7 @@ git commit -m "refactor(machine) : stop auto-saving on constructeur change"
 ### Task 4: Add batch custom field save method

 **Files:**
- Modify: `Inventory_frontend/app/composables/useMachineDetailCustomFields.ts`
+- Modify: `frontend/app/composables/useMachineDetailCustomFields.ts`

 - [ ] **Step 1: Add `saveAllMachineCustomFields` method**

@@ -325,7 +325,7 @@ With:
 - [ ] **Step 3: Commit**

 ```bash
-git add Inventory_frontend/app/composables/useMachineDetailCustomFields.ts
+git add frontend/app/composables/useMachineDetailCustomFields.ts
 git commit -m "feat(machine) : add batch saveAllMachineCustomFields method"
 ```

@@ -334,7 +334,7 @@ git commit -m "feat(machine) : add batch saveAllMachineCustomFields method"
 ### Task 5: Add submitEdition, cancelEdition, saving, canSubmit to orchestrator

 **Files:**
- Modify: `Inventory_frontend/app/composables/useMachineDetailData.ts`
+- Modify: `frontend/app/composables/useMachineDetailData.ts`

 - [ ] **Step 1: Add `saving` ref in the core state block (after line 63)**

@@ -423,7 +423,7 @@ Add to the return object:
 - [ ] **Step 6: Commit**

 ```bash
-git add Inventory_frontend/app/composables/useMachineDetailData.ts
+git add frontend/app/composables/useMachineDetailData.ts
 git commit -m "feat(machine) : add submitEdition, cancelEdition, saving, canSubmit"
 ```

@@ -432,7 +432,7 @@ git commit -m "feat(machine) : add submitEdition, cancelEdition, saving, canSubm
 ### Task 6: Wire Save/Cancel buttons in the page

 **Files:**
- Modify: `Inventory_frontend/app/pages/machine/[id].vue`
+- Modify: `frontend/app/pages/machine/[id].vue`

 - [ ] **Step 1: Add template ref on MachineInfoCard (line 56)**

@@ -597,7 +597,7 @@ const historyFieldLabels = {
 - [ ] **Step 7: Commit**

 ```bash
-git add Inventory_frontend/app/pages/machine/[id].vue
+git add frontend/app/pages/machine/[id].vue
 git commit -m "feat(machine) : add single save button and wire cancel/submit"
 ```

@@ -988,13 +988,13 @@ git commit -m "feat(versioning) : detect machine link add/remove in onFlush and
 - [ ] **Step 1: Run ESLint fix**

 ```bash
-cd Inventory_frontend && npm run lint:fix
+cd frontend && npm run lint:fix
 ```

 - [ ] **Step 2: Run typecheck**

 ```bash
-cd Inventory_frontend && npx nuxi typecheck
+cd frontend && npx nuxi typecheck
 ```

 Expected: 0 errors.
@@ -1039,7 +1039,7 @@ git add -A && git commit -m "fix(machine) : fix cs-fixer and test issues from si

 ```bash
 make start
-cd Inventory_frontend && npm run dev
+cd frontend && npm run dev
 ```

 - [ ] **Step 2: Test single save flow**
--- a/docs/superpowers/plans/2026-03-31-supplier-references-frontend.md
+++ b/docs/superpowers/plans/2026-03-31-supplier-references-frontend.md
@@ -94,8 +94,8 @@ git commit --no-verify -m "feat(constructeur) : add SearchFilter on Constructeur
 ### Task F2: Frontend — Add types + useConstructeurLinks composable

 **Files:**
- Modify: `Inventory_frontend/app/shared/constructeurUtils.ts`
- Create: `Inventory_frontend/app/composables/useConstructeurLinks.ts`
+- Modify: `frontend/app/shared/constructeurUtils.ts`
+- Create: `frontend/app/composables/useConstructeurLinks.ts`

 - [ ] **Step 1: Add ConstructeurLinkEntry type to constructeurUtils.ts**

@@ -227,7 +227,7 @@ export function useConstructeurLinks() {
 - [ ] **Step 3: Commit**

 ```bash
-cd Inventory_frontend && git add -A && git commit -m "feat(constructeur) : add ConstructeurLinkEntry type and useConstructeurLinks composable"
+cd frontend && git add -A && git commit -m "feat(constructeur) : add ConstructeurLinkEntry type and useConstructeurLinks composable"
 ```

 ---
@@ -235,7 +235,7 @@ cd Inventory_frontend && git add -A && git commit -m "feat(constructeur) : add C
 ### Task F3: Frontend — Create ConstructeurLinksTable component

 **Files:**
- Create: `Inventory_frontend/app/components/ConstructeurLinksTable.vue`
+- Create: `frontend/app/components/ConstructeurLinksTable.vue`

 - [ ] **Step 1: Create the component**

@@ -338,7 +338,7 @@ const removeLink = (index: number) => {
 - [ ] **Step 2: Commit**

 ```bash
-cd Inventory_frontend && git add -A && git commit -m "feat(constructeur) : add ConstructeurLinksTable component"
+cd frontend && git add -A && git commit -m "feat(constructeur) : add ConstructeurLinksTable component"
 ```

 ---
@@ -346,9 +346,9 @@ cd Inventory_frontend && git add -A && git commit -m "feat(constructeur) : add C
 ### Task F4: Frontend — Update piece edit flow (model case)

 **Files:**
- Modify: `Inventory_frontend/app/composables/usePieceEdit.ts`
- Modify: `Inventory_frontend/app/pages/piece/[id].vue`
- Modify: `Inventory_frontend/app/composables/usePieces.ts`
+- Modify: `frontend/app/composables/usePieceEdit.ts`
+- Modify: `frontend/app/pages/piece/[id].vue`
+- Modify: `frontend/app/composables/usePieces.ts`

 This task establishes the pattern for all entity types.

@@ -376,13 +376,13 @@ In `createPiece()` and `updatePieceData()`: stop wrapping payload with `buildCon
 - [ ] **Step 4: Lint and typecheck**

 ```bash
-cd Inventory_frontend && npm run lint:fix && npx nuxi typecheck
+cd frontend && npm run lint:fix && npx nuxi typecheck
 ```

 - [ ] **Step 5: Commit**

 ```bash
-cd Inventory_frontend && git add -A && git commit -m "feat(constructeur) : update piece edit flow with supplier references"
+cd frontend && git add -A && git commit -m "feat(constructeur) : update piece edit flow with supplier references"
 ```

 ---
@@ -392,11 +392,11 @@ cd Inventory_frontend && git add -A && git commit -m "feat(constructeur) : updat
 Same pattern as Task F4 but for composants.

 **Files:**
- Modify: `Inventory_frontend/app/composables/useComponentEdit.ts`
- Modify: `Inventory_frontend/app/pages/component/[id]/index.vue`
- Modify: `Inventory_frontend/app/pages/component/[id]/edit.vue`
- Modify: `Inventory_frontend/app/composables/useComposants.ts`
- Modify: `Inventory_frontend/app/pages/component/create.vue`
+- Modify: `frontend/app/composables/useComponentEdit.ts`
+- Modify: `frontend/app/pages/component/[id]/index.vue`
+- Modify: `frontend/app/pages/component/[id]/edit.vue`
+- Modify: `frontend/app/composables/useComposants.ts`
+- Modify: `frontend/app/pages/component/create.vue`

 ---

@@ -406,10 +406,10 @@ Same pattern as Task F4 but for products.

 **Files:**
 - Modify: product edit composable (if exists) or inline pages
- Modify: `Inventory_frontend/app/pages/product/[id]/index.vue`
- Modify: `Inventory_frontend/app/pages/product/[id]/edit.vue`
- Modify: `Inventory_frontend/app/composables/useProducts.ts`
- Modify: `Inventory_frontend/app/pages/product/create.vue`
+- Modify: `frontend/app/pages/product/[id]/index.vue`
+- Modify: `frontend/app/pages/product/[id]/edit.vue`
+- Modify: `frontend/app/composables/useProducts.ts`
+- Modify: `frontend/app/pages/product/create.vue`

 ---

@@ -418,11 +418,11 @@ Same pattern as Task F4 but for products.
 Machine uses a different architecture (MachineStructureController, useMachineDetailData/Updates).

 **Files:**
- Modify: `Inventory_frontend/app/composables/useMachineDetailData.ts`
- Modify: `Inventory_frontend/app/composables/useMachineDetailUpdates.ts`
- Modify: `Inventory_frontend/app/pages/machine/[id].vue`
- Modify: `Inventory_frontend/app/components/machine/MachineInfoCard.vue`
- Modify: `Inventory_frontend/app/composables/useMachines.ts`
+- Modify: `frontend/app/composables/useMachineDetailData.ts`
+- Modify: `frontend/app/composables/useMachineDetailUpdates.ts`
+- Modify: `frontend/app/pages/machine/[id].vue`
+- Modify: `frontend/app/components/machine/MachineInfoCard.vue`
+- Modify: `frontend/app/composables/useMachines.ts`

 Key differences:
 - Machine data comes from `/api/machines/{id}/structure` (custom controller) which already returns the new constructeur link format
@@ -434,8 +434,8 @@ Key differences:
 ### Task F8: Frontend — Update machine structure components (PieceItem, ComponentItem)

 **Files:**
- Modify: `Inventory_frontend/app/components/PieceItem.vue`
- Modify: `Inventory_frontend/app/components/ComponentItem.vue`
+- Modify: `frontend/app/components/PieceItem.vue`
+- Modify: `frontend/app/components/ComponentItem.vue`

 These components display constructeurs in the machine structure tree and handle inline editing. Update them to:
 - Read from `constructeurLinks` format in the machine structure response
@@ -447,9 +447,9 @@ These components display constructeurs in the machine structure tree and handle
 ### Task F9: Frontend — Update create pages

 **Files:**
- Modify: `Inventory_frontend/app/pages/pieces/create.vue`
- Modify: `Inventory_frontend/app/pages/component/create.vue`
- Modify: `Inventory_frontend/app/pages/product/create.vue`
+- Modify: `frontend/app/pages/pieces/create.vue`
+- Modify: `frontend/app/pages/component/create.vue`
+- Modify: `frontend/app/pages/product/create.vue`

 On creation pages, there are no existing links. The flow is:
 1. User selects constructeurs + optionally fills supplierReference
--- a/docs/superpowers/specs/2026-03-23-parc-machines-ux-design.md
+++ b/docs/superpowers/specs/2026-03-23-parc-machines-ux-design.md
@@ -18,7 +18,7 @@ L'utilisateur veut pouvoir sélectionner plusieurs sites simultanément.
 - Quand **une ou plusieurs** sont cochées → filtre sur ces sites uniquement.

 ### Changements techniques
-**Fichier** : `Inventory_frontend/app/pages/machines/index.vue`
+**Fichier** : `frontend/app/pages/machines/index.vue`

 - **Réactivité** : utiliser `reactive(new Set())` (Vue 3.4+ supporte nativement les mutations `add`/`delete`/`has` sur un Set réactif). Pas de `.value` nécessaire.
 - **Note** : le fichier utilise `<script setup>` sans `lang="ts"` — ne pas utiliser d'annotations TypeScript comme `Set<string>`.
@@ -36,7 +36,7 @@ Les machines s'affichent dans l'ordre retourné par l'API, sans tri. L'utilisate
 Ajouter un `.sort()` avec `localeCompare('fr')` à la fin du computed `filteredMachines`.

 ### Changements techniques
-**Fichier** : `Inventory_frontend/app/pages/machines/index.vue`
+**Fichier** : `frontend/app/pages/machines/index.vue`

 - Dans le computed `filteredMachines`, ajouter avant le `return` :
  ```js
@@ -67,9 +67,9 @@ Créer une **Extension Doctrine** (`SearchByNameOrReferenceExtension`) qui inter
 - **Pas de conflit** avec le `SearchFilter` existant : le paramètre `q` n'est pas enregistré comme propriété de `SearchFilter`, donc il sera ignoré par celui-ci. Les filtres `name` et `reference` restent disponibles pour d'autres usages.

 **Frontend — 3 fichiers** (dans la fonction `loadXxx`, remplacer l'appel `params.set('name', search.trim())`) :
- `Inventory_frontend/app/composables/usePieces.ts` → `params.set('q', search.trim())`
- `Inventory_frontend/app/composables/useComposants.ts` → idem
- `Inventory_frontend/app/composables/useProducts.ts` → idem
+- `frontend/app/composables/usePieces.ts` → `params.set('q', search.trim())`
+- `frontend/app/composables/useComposants.ts` → idem
+- `frontend/app/composables/useProducts.ts` → idem

 ---

@@ -77,11 +77,11 @@ Créer une **Extension Doctrine** (`SearchByNameOrReferenceExtension`) qui inter

 | Fichier | Changement |
 |---------|-----------|
-| `Inventory_frontend/app/pages/machines/index.vue` | Checkboxes sites + tri alphabétique |
+| `frontend/app/pages/machines/index.vue` | Checkboxes sites + tri alphabétique |
 | `src/Doctrine/SearchByNameOrReferenceExtension.php` | **Nouveau** — Extension Doctrine OR search |
-| `Inventory_frontend/app/composables/usePieces.ts` | `name` → `q` |
-| `Inventory_frontend/app/composables/useComposants.ts` | `name` → `q` |
-| `Inventory_frontend/app/composables/useProducts.ts` | `name` → `q` |
+| `frontend/app/composables/usePieces.ts` | `name` → `q` |
+| `frontend/app/composables/useComposants.ts` | `name` → `q` |
+| `frontend/app/composables/useProducts.ts` | `name` → `q` |

 ## Hors scope
 - La page Parc Machines cherche **déjà** sur nom ET référence côté frontend (filtrage client-side). Pas de changement nécessaire.
--- a/docs/superpowers/specs/2026-03-31-reference-formula-builder-design.md
+++ b/docs/superpowers/specs/2026-03-31-reference-formula-builder-design.md
@@ -2,7 +2,7 @@

 **Date** : 2026-03-31
 **Scope** : Frontend uniquement (pas de changement backend)
-**Fichier impacté** : `Inventory_frontend/app/components/model-types/ModelTypeForm.vue`
+**Fichier impacté** : `frontend/app/components/model-types/ModelTypeForm.vue`

 ## Problème