From 272104aafb431d4be7e0a87a2d584f7163bcbd05 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 17 Apr 2026 19:15:11 +0000
Subject: [PATCH 1/7] Initial plan


From 30cce4ab1d8eae47619d22876623b40958ae8067 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 17 Apr 2026 19:19:54 +0000
Subject: [PATCH 2/7] feat: add bundled welcome project docs and startup
 installer

Agent-Logs-Url: https://github.com/mcgivrer/MarkNote/sessions/2e439cd4-0051-4dec-a597-0d60e17ca76e

Co-authored-by: mcgivrer <216852+mcgivrer@users.noreply.github.com>
---
 pom.xml                                       | 33 ++++++++
 src/docs/packaging.md                         |  2 +
 src/docs/tips-and-tricks-en.md                | 31 +++++++
 src/main/java/MarkNote.java                   |  3 +
 .../java/utils/WelcomeProjectService.java     | 82 +++++++++++++++++++
 .../java/utils/WelcomeProjectServiceTest.java | 46 +++++++++++
 6 files changed, 197 insertions(+)
 create mode 100644 src/docs/tips-and-tricks-en.md
 create mode 100644 src/main/java/utils/WelcomeProjectService.java
 create mode 100644 src/test/java/utils/WelcomeProjectServiceTest.java

diff --git a/pom.xml b/pom.xml
index de110f0..7bb2c71 100644
--- a/pom.xml
+++ b/pom.xml
@@ -222,6 +222,39 @@
         </executions>
       </plugin>
 
+      <!-- ── 3c. Bundle welcome project documentation resources ───────────── -->
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-resources-plugin</artifactId>
+        <version>3.3.1</version>
+        <executions>
+          <execution>
+            <id>copy-welcome-project</id>
+            <phase>process-resources</phase>
+            <goals><goal>copy-resources</goal></goals>
+            <configuration>
+              <outputDirectory>${project.build.outputDirectory}/welcome-project</outputDirectory>
+              <resources>
+                <resource>
+                  <directory>${project.basedir}/src/docs</directory>
+                  <includes>
+                    <include>user-guide-en.md</include>
+                    <include>tips-and-tricks-en.md</include>
+                  </includes>
+                </resource>
+                <resource>
+                  <directory>${project.basedir}/src/docs/illustrations</directory>
+                  <targetPath>illustrations</targetPath>
+                  <includes>
+                    <include>**/*</include>
+                  </includes>
+                </resource>
+              </resources>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+
       <!-- ── 4. Fat / uber JAR ────────────────────────────────────────────── -->
       <!--
            Équivalent de :
diff --git a/src/docs/packaging.md b/src/docs/packaging.md
index b2a1e69..eb9c840 100644
--- a/src/docs/packaging.md
+++ b/src/docs/packaging.md
@@ -31,6 +31,7 @@ Le script `build` fournit une action `package` qui génère une archive ZIP auto
 - Un script de lancement adapté à l'OS (`MarkNote.sh` ou `MarkNote.bat`)
 - Les icônes de l'application en plusieurs formats (`icons/`)
 - Un **installeur spécifique à l'OS** (`install.sh` ou `install.bat`)
+- Les ressources du projet **MarkNote Welcome** (guide + illustrations)
 
 L'archive est nommée selon le pattern : `MarkNote-<version>-<os>.zip` (ex : `MarkNote-0.0.6-linux.zip`).
 
@@ -91,6 +92,7 @@ Après décompression du ZIP, le répertoire contient :
 | `MarkNote.sh` ou `.bat`      | Script de lancement                              |
 | `icons/`                      | Icônes de l'application (SVG + PNG multi-tailles) |
 | `install.sh` ou `install.bat`| Installeur spécifique à l'OS                     |
+| `welcome-project/`            | Ressources intégrées pour créer `~/Documents/MarkNote Welcome` au premier lancement |
 
 ---
 
diff --git a/src/docs/tips-and-tricks-en.md b/src/docs/tips-and-tricks-en.md
new file mode 100644
index 0000000..6cde3e2
--- /dev/null
+++ b/src/docs/tips-and-tricks-en.md
@@ -0,0 +1,31 @@
+# MarkNote — Tips & Tricks
+
+## Productivity
+
+- Use `Ctrl+N` to create a new document quickly.
+- Use `Ctrl+S` and `Ctrl+Shift+S` to save without leaving the keyboard.
+- Use `Ctrl+F` (or the search box) to find notes and tags across your project.
+
+## Project navigation
+
+- Keep the **Project Explorer** open to create, rename, move, and organize notes.
+- Click tags in the **Tag Cloud** to launch instant filtered searches.
+- Use the **Visual Link Panel** to discover related notes through backlinks.
+
+## Writing
+
+- Use front matter (`title`, `tags`, `summary`, `author`, `date`) to structure your notes.
+- Drag and drop files from the explorer into the editor to create links quickly.
+- Keep an eye on the **Preview Panel** to validate formatting while writing.
+
+## Panels and layout
+
+- Detach any panel from the menu to focus on your editor workspace.
+- Reattach panels when you need the full workspace again.
+- Customize the theme from **Options** to improve readability in your environment.
+
+## Git and AI
+
+- Enable Git support to see file status indicators directly in the explorer.
+- Open the LLM panel to summarize, compare, or explain notes from your project context.
+- Tune LLM endpoint/model/timeout in **Options** before starting a long session.
diff --git a/src/main/java/MarkNote.java b/src/main/java/MarkNote.java
index dbac95f..59ba395 100644
--- a/src/main/java/MarkNote.java
+++ b/src/main/java/MarkNote.java
@@ -35,6 +35,7 @@
 import utils.IndexService;
 import utils.LogService;
 import utils.ProjectSessionService;
+import utils.WelcomeProjectService;
 
 import javafx.application.Application;
 import javafx.application.Platform;
@@ -132,6 +133,8 @@ public void init() {
 
         // Charger les messages avec la locale configurée
         messages = ResourceBundle.getBundle("i18n.messages", Locale.getDefault());
+
+        new WelcomeProjectService().installIfMissing(messages.getString("app.version"));
     }
 
     @Override
diff --git a/src/main/java/utils/WelcomeProjectService.java b/src/main/java/utils/WelcomeProjectService.java
new file mode 100644
index 0000000..53ab6a9
--- /dev/null
+++ b/src/main/java/utils/WelcomeProjectService.java
@@ -0,0 +1,82 @@
+package utils;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.List;
+
+/**
+ * Installe un projet de bienvenue dans le dossier Documents de l'utilisateur.
+ */
+public class WelcomeProjectService {
+
+    private static final String LOG_SOURCE = "WelcomeProjectService";
+    private static final String WELCOME_DIR_NAME = "MarkNote Welcome";
+    private static final String ILLUSTRATIONS_DIR_NAME = "illustrations";
+
+    private static final String USER_GUIDE_RESOURCE = "user-guide-en.md";
+    private static final String TIPS_RESOURCE = "tips-and-tricks-en.md";
+
+    private static final List<String> ILLUSTRATIONS = List.of(
+            "welcome-page.svg",
+            "main-interface.svg",
+            "front-matter-panel.svg",
+            "view-menu.svg",
+            "panel-detach.svg",
+            "file-menu.svg",
+            "drag-drop-editor.svg",
+            "front-matter-links.svg",
+            "project-explorer.svg",
+            "image-preview.svg",
+            "search-box.svg",
+            "tag-cloud.svg",
+            "network-diagram.svg",
+            "status-bar.svg",
+            "preview-front-matter.svg",
+            "llm-chat-panel.svg",
+            "themes.svg",
+            "keyboard-shortcuts.svg");
+
+    private final LogService log = LogService.getInstance();
+    private final Path userHome;
+
+    public WelcomeProjectService() {
+        this(Path.of(System.getProperty("user.home")));
+    }
+
+    WelcomeProjectService(Path userHome) {
+        this.userHome = userHome;
+    }
+
+    public void installIfMissing(String appVersion) {
+        try {
+            Path documentsDir = userHome.resolve("Documents");
+            Path welcomeDir = documentsDir.resolve(WELCOME_DIR_NAME);
+            if (Files.exists(welcomeDir)) {
+                return;
+            }
+
+            Files.createDirectories(welcomeDir.resolve(ILLUSTRATIONS_DIR_NAME));
+
+            copyResource(USER_GUIDE_RESOURCE, welcomeDir.resolve("MarkNote " + appVersion + " - User Guide.md"));
+            copyResource(TIPS_RESOURCE, welcomeDir.resolve("MarkNote " + appVersion + " - Tips & Tricks.md"));
+            for (String illustration : ILLUSTRATIONS) {
+                copyResource("illustrations/" + illustration,
+                        welcomeDir.resolve(ILLUSTRATIONS_DIR_NAME).resolve(illustration));
+            }
+            log.info(LOG_SOURCE, "Welcome project installed in " + welcomeDir);
+        } catch (IOException e) {
+            log.warn(LOG_SOURCE, "Unable to install welcome project: " + e.getMessage());
+        }
+    }
+
+    private void copyResource(String resourcePath, Path destination) throws IOException {
+        try (InputStream stream = WelcomeProjectService.class.getResourceAsStream("/welcome-project/" + resourcePath)) {
+            if (stream == null) {
+                throw new IOException("Missing embedded resource: /welcome-project/" + resourcePath);
+            }
+            Files.copy(stream, destination);
+        }
+    }
+}
diff --git a/src/test/java/utils/WelcomeProjectServiceTest.java b/src/test/java/utils/WelcomeProjectServiceTest.java
new file mode 100644
index 0000000..375fa47
--- /dev/null
+++ b/src/test/java/utils/WelcomeProjectServiceTest.java
@@ -0,0 +1,46 @@
+package utils;
+
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
+
+class WelcomeProjectServiceTest {
+
+    @TempDir
+    Path tempHome;
+
+    @Test
+    @DisplayName("Install welcome project in Documents when missing")
+    void installWelcomeProjectWhenMissing() {
+        WelcomeProjectService service = new WelcomeProjectService(tempHome);
+        service.installIfMissing("0.1.4");
+
+        Path welcomeDir = tempHome.resolve("Documents").resolve("MarkNote Welcome");
+        assertTrue(Files.exists(welcomeDir));
+        assertTrue(Files.exists(welcomeDir.resolve("MarkNote 0.1.4 - User Guide.md")));
+        assertTrue(Files.exists(welcomeDir.resolve("MarkNote 0.1.4 - Tips & Tricks.md")));
+        assertTrue(Files.exists(welcomeDir.resolve("illustrations").resolve("welcome-page.svg")));
+    }
+
+    @Test
+    @DisplayName("Do not override existing welcome project")
+    void doNotOverrideExistingWelcomeProject() throws IOException {
+        Path welcomeDir = tempHome.resolve("Documents").resolve("MarkNote Welcome");
+        Files.createDirectories(welcomeDir);
+        Path marker = welcomeDir.resolve("existing.md");
+        Files.writeString(marker, "keep me");
+
+        WelcomeProjectService service = new WelcomeProjectService(tempHome);
+        service.installIfMissing("0.1.4");
+
+        assertTrue(Files.exists(marker));
+        assertFalse(Files.exists(welcomeDir.resolve("MarkNote 0.1.4 - User Guide.md")));
+    }
+}

From 1091127f6ef9d821d7b9dd471d195e85d164a701 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 17 Apr 2026 19:22:03 +0000
Subject: [PATCH 3/7] chore: align welcome service javadoc language

Agent-Logs-Url: https://github.com/mcgivrer/MarkNote/sessions/2e439cd4-0051-4dec-a597-0d60e17ca76e

Co-authored-by: mcgivrer <216852+mcgivrer@users.noreply.github.com>
---
 src/main/java/utils/WelcomeProjectService.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/java/utils/WelcomeProjectService.java b/src/main/java/utils/WelcomeProjectService.java
index 53ab6a9..1ef42a2 100644
--- a/src/main/java/utils/WelcomeProjectService.java
+++ b/src/main/java/utils/WelcomeProjectService.java
@@ -7,7 +7,7 @@
 import java.util.List;
 
 /**
- * Installe un projet de bienvenue dans le dossier Documents de l'utilisateur.
+ * Installs a welcome project in the user's Documents folder.
  */
 public class WelcomeProjectService {
 

From 21deb000738ac317e0c63dfebb197d4d82bacfac Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 17 Apr 2026 19:23:27 +0000
Subject: [PATCH 4/7] fix: add fallback when Documents folder is unavailable

Agent-Logs-Url: https://github.com/mcgivrer/MarkNote/sessions/2e439cd4-0051-4dec-a597-0d60e17ca76e

Co-authored-by: mcgivrer <216852+mcgivrer@users.noreply.github.com>
---
 src/main/java/utils/WelcomeProjectService.java | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/src/main/java/utils/WelcomeProjectService.java b/src/main/java/utils/WelcomeProjectService.java
index 1ef42a2..623ec03 100644
--- a/src/main/java/utils/WelcomeProjectService.java
+++ b/src/main/java/utils/WelcomeProjectService.java
@@ -51,7 +51,7 @@ public WelcomeProjectService() {
 
     public void installIfMissing(String appVersion) {
         try {
-            Path documentsDir = userHome.resolve("Documents");
+            Path documentsDir = resolveDocumentsDirectory();
             Path welcomeDir = documentsDir.resolve(WELCOME_DIR_NAME);
             if (Files.exists(welcomeDir)) {
                 return;
@@ -71,6 +71,16 @@ public void installIfMissing(String appVersion) {
         }
     }
 
+    private Path resolveDocumentsDirectory() {
+        Path documentsDir = userHome.resolve("Documents");
+        try {
+            Files.createDirectories(documentsDir);
+            return documentsDir;
+        } catch (IOException e) {
+            return userHome;
+        }
+    }
+
     private void copyResource(String resourcePath, Path destination) throws IOException {
         try (InputStream stream = WelcomeProjectService.class.getResourceAsStream("/welcome-project/" + resourcePath)) {
             if (stream == null) {

From b56750e6ce251c4eb40b8ebff025ca891e56f9ce Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 17 Apr 2026 19:24:46 +0000
Subject: [PATCH 5/7] chore: log documents directory fallback for welcome
 project

Agent-Logs-Url: https://github.com/mcgivrer/MarkNote/sessions/2e439cd4-0051-4dec-a597-0d60e17ca76e

Co-authored-by: mcgivrer <216852+mcgivrer@users.noreply.github.com>
---
 src/main/java/utils/WelcomeProjectService.java | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/main/java/utils/WelcomeProjectService.java b/src/main/java/utils/WelcomeProjectService.java
index 623ec03..bd5b2cd 100644
--- a/src/main/java/utils/WelcomeProjectService.java
+++ b/src/main/java/utils/WelcomeProjectService.java
@@ -77,6 +77,7 @@ private Path resolveDocumentsDirectory() {
             Files.createDirectories(documentsDir);
             return documentsDir;
         } catch (IOException e) {
+            log.warn(LOG_SOURCE, "Documents directory unavailable, fallback to user home: " + e.getMessage());
             return userHome;
         }
     }

From 38ddead1d643c04e49a65c57bebe05be4ec3d065 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 17 Apr 2026 19:43:31 +0000
Subject: [PATCH 6/7] fix: remove app-side welcome project provisioning

Agent-Logs-Url: https://github.com/mcgivrer/MarkNote/sessions/088c4d1f-142e-40c6-ab14-71989c6ce386

Co-authored-by: mcgivrer <216852+mcgivrer@users.noreply.github.com>
---
 src/docs/packaging.md                         |  2 +-
 src/main/java/MarkNote.java                   |  3 -
 .../java/utils/WelcomeProjectService.java     | 93 -------------------
 .../java/utils/WelcomeProjectServiceTest.java | 46 ---------
 4 files changed, 1 insertion(+), 143 deletions(-)
 delete mode 100644 src/main/java/utils/WelcomeProjectService.java
 delete mode 100644 src/test/java/utils/WelcomeProjectServiceTest.java

diff --git a/src/docs/packaging.md b/src/docs/packaging.md
index eb9c840..8acbc7e 100644
--- a/src/docs/packaging.md
+++ b/src/docs/packaging.md
@@ -92,7 +92,7 @@ Après décompression du ZIP, le répertoire contient :
 | `MarkNote.sh` ou `.bat`      | Script de lancement                              |
 | `icons/`                      | Icônes de l'application (SVG + PNG multi-tailles) |
 | `install.sh` ou `install.bat`| Installeur spécifique à l'OS                     |
-| `welcome-project/`            | Ressources intégrées pour créer `~/Documents/MarkNote Welcome` au premier lancement |
+| `welcome-project/`            | Ressources intégrées pour que l'installeur provisionne `~/Documents/MarkNote Welcome` |
 
 ---
 
diff --git a/src/main/java/MarkNote.java b/src/main/java/MarkNote.java
index 59ba395..dbac95f 100644
--- a/src/main/java/MarkNote.java
+++ b/src/main/java/MarkNote.java
@@ -35,7 +35,6 @@
 import utils.IndexService;
 import utils.LogService;
 import utils.ProjectSessionService;
-import utils.WelcomeProjectService;
 
 import javafx.application.Application;
 import javafx.application.Platform;
@@ -133,8 +132,6 @@ public void init() {
 
         // Charger les messages avec la locale configurée
         messages = ResourceBundle.getBundle("i18n.messages", Locale.getDefault());
-
-        new WelcomeProjectService().installIfMissing(messages.getString("app.version"));
     }
 
     @Override
diff --git a/src/main/java/utils/WelcomeProjectService.java b/src/main/java/utils/WelcomeProjectService.java
deleted file mode 100644
index bd5b2cd..0000000
--- a/src/main/java/utils/WelcomeProjectService.java
+++ /dev/null
@@ -1,93 +0,0 @@
-package utils;
-
-import java.io.IOException;
-import java.io.InputStream;
-import java.nio.file.Files;
-import java.nio.file.Path;
-import java.util.List;
-
-/**
- * Installs a welcome project in the user's Documents folder.
- */
-public class WelcomeProjectService {
-
-    private static final String LOG_SOURCE = "WelcomeProjectService";
-    private static final String WELCOME_DIR_NAME = "MarkNote Welcome";
-    private static final String ILLUSTRATIONS_DIR_NAME = "illustrations";
-
-    private static final String USER_GUIDE_RESOURCE = "user-guide-en.md";
-    private static final String TIPS_RESOURCE = "tips-and-tricks-en.md";
-
-    private static final List<String> ILLUSTRATIONS = List.of(
-            "welcome-page.svg",
-            "main-interface.svg",
-            "front-matter-panel.svg",
-            "view-menu.svg",
-            "panel-detach.svg",
-            "file-menu.svg",
-            "drag-drop-editor.svg",
-            "front-matter-links.svg",
-            "project-explorer.svg",
-            "image-preview.svg",
-            "search-box.svg",
-            "tag-cloud.svg",
-            "network-diagram.svg",
-            "status-bar.svg",
-            "preview-front-matter.svg",
-            "llm-chat-panel.svg",
-            "themes.svg",
-            "keyboard-shortcuts.svg");
-
-    private final LogService log = LogService.getInstance();
-    private final Path userHome;
-
-    public WelcomeProjectService() {
-        this(Path.of(System.getProperty("user.home")));
-    }
-
-    WelcomeProjectService(Path userHome) {
-        this.userHome = userHome;
-    }
-
-    public void installIfMissing(String appVersion) {
-        try {
-            Path documentsDir = resolveDocumentsDirectory();
-            Path welcomeDir = documentsDir.resolve(WELCOME_DIR_NAME);
-            if (Files.exists(welcomeDir)) {
-                return;
-            }
-
-            Files.createDirectories(welcomeDir.resolve(ILLUSTRATIONS_DIR_NAME));
-
-            copyResource(USER_GUIDE_RESOURCE, welcomeDir.resolve("MarkNote " + appVersion + " - User Guide.md"));
-            copyResource(TIPS_RESOURCE, welcomeDir.resolve("MarkNote " + appVersion + " - Tips & Tricks.md"));
-            for (String illustration : ILLUSTRATIONS) {
-                copyResource("illustrations/" + illustration,
-                        welcomeDir.resolve(ILLUSTRATIONS_DIR_NAME).resolve(illustration));
-            }
-            log.info(LOG_SOURCE, "Welcome project installed in " + welcomeDir);
-        } catch (IOException e) {
-            log.warn(LOG_SOURCE, "Unable to install welcome project: " + e.getMessage());
-        }
-    }
-
-    private Path resolveDocumentsDirectory() {
-        Path documentsDir = userHome.resolve("Documents");
-        try {
-            Files.createDirectories(documentsDir);
-            return documentsDir;
-        } catch (IOException e) {
-            log.warn(LOG_SOURCE, "Documents directory unavailable, fallback to user home: " + e.getMessage());
-            return userHome;
-        }
-    }
-
-    private void copyResource(String resourcePath, Path destination) throws IOException {
-        try (InputStream stream = WelcomeProjectService.class.getResourceAsStream("/welcome-project/" + resourcePath)) {
-            if (stream == null) {
-                throw new IOException("Missing embedded resource: /welcome-project/" + resourcePath);
-            }
-            Files.copy(stream, destination);
-        }
-    }
-}
diff --git a/src/test/java/utils/WelcomeProjectServiceTest.java b/src/test/java/utils/WelcomeProjectServiceTest.java
deleted file mode 100644
index 375fa47..0000000
--- a/src/test/java/utils/WelcomeProjectServiceTest.java
+++ /dev/null
@@ -1,46 +0,0 @@
-package utils;
-
-import static org.junit.jupiter.api.Assertions.assertFalse;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-
-import java.io.IOException;
-import java.nio.file.Files;
-import java.nio.file.Path;
-
-import org.junit.jupiter.api.DisplayName;
-import org.junit.jupiter.api.Test;
-import org.junit.jupiter.api.io.TempDir;
-
-class WelcomeProjectServiceTest {
-
-    @TempDir
-    Path tempHome;
-
-    @Test
-    @DisplayName("Install welcome project in Documents when missing")
-    void installWelcomeProjectWhenMissing() {
-        WelcomeProjectService service = new WelcomeProjectService(tempHome);
-        service.installIfMissing("0.1.4");
-
-        Path welcomeDir = tempHome.resolve("Documents").resolve("MarkNote Welcome");
-        assertTrue(Files.exists(welcomeDir));
-        assertTrue(Files.exists(welcomeDir.resolve("MarkNote 0.1.4 - User Guide.md")));
-        assertTrue(Files.exists(welcomeDir.resolve("MarkNote 0.1.4 - Tips & Tricks.md")));
-        assertTrue(Files.exists(welcomeDir.resolve("illustrations").resolve("welcome-page.svg")));
-    }
-
-    @Test
-    @DisplayName("Do not override existing welcome project")
-    void doNotOverrideExistingWelcomeProject() throws IOException {
-        Path welcomeDir = tempHome.resolve("Documents").resolve("MarkNote Welcome");
-        Files.createDirectories(welcomeDir);
-        Path marker = welcomeDir.resolve("existing.md");
-        Files.writeString(marker, "keep me");
-
-        WelcomeProjectService service = new WelcomeProjectService(tempHome);
-        service.installIfMissing("0.1.4");
-
-        assertTrue(Files.exists(marker));
-        assertFalse(Files.exists(welcomeDir.resolve("MarkNote 0.1.4 - User Guide.md")));
-    }
-}

From 83b79c83cbab665f0dd59a6837e7e44d792e64f5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Delorme?= <frederic.delorme@gmail.com>
Date: Wed, 29 Apr 2026 09:36:14 +0200
Subject: [PATCH 7/7] feat(doc): Add welcome project with docs

---
 .vscode/settings.json                         |  2 +-
 pom.xml                                       | 24 +++++++-
 .../linux-resources/template.postinst         | 58 +++++++++++++++++++
 src/packaging/post-install-mac.sh             | 35 +++++++++++
 src/packaging/post-install.bat                | 40 +++++++++++++
 src/packaging/post-install.sh                 | 35 +++++++++++
 6 files changed, 191 insertions(+), 3 deletions(-)
 create mode 100644 src/packaging/linux-resources/template.postinst
 create mode 100755 src/packaging/post-install-mac.sh
 create mode 100644 src/packaging/post-install.bat
 create mode 100755 src/packaging/post-install.sh

diff --git a/.vscode/settings.json b/.vscode/settings.json
index cb7d824..dd4a247 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -46,5 +46,5 @@
     ],
     "java.project.outputPath": "target/classes",
     "java.format.settings.url": ".vscode/java-formatter.xml",
-    "java.configuration.updateBuildConfiguration": "interactive"
+    "java.configuration.updateBuildConfiguration": "disabled"
 }
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index 7bb2c71..4375e2e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -314,6 +314,7 @@
         <groupId>org.codehaus.mojo</groupId>
         <artifactId>exec-maven-plugin</artifactId>
         <configuration>
+          <mainClass>${app.main.class}</mainClass>
           <executable>java</executable>
           <arguments>
             <argument>${app.jvm.options}</argument>
@@ -531,7 +532,7 @@
                   <appVersion>${jpackage.app.version}</appVersion>
                   <vendor>${jpackage.vendor}</vendor>
                   <description>${jpackage.description}</description>
-                  <copyright>Copyright 2024 ${jpackage.vendor}</copyright>
+                  <copyright>Copyright 2026 ${jpackage.vendor}</copyright>
 
                   <!-- Input: the fat JAR (minus JavaFX) produced by shade -->
                   <input>${project.build.directory}/build</input>
@@ -546,7 +547,7 @@
 
                   <!-- JVM flags passed to the launched app -->
                   <javaOptions>
-                    <javaOption>-Djava.net.preferIPv6Addresses=true</javaOption>
+                    <!--javaOption>-Djava.net.preferIPv6Addresses=true</javaOption-->
                     <javaOption>-Xmx512m</javaOption>
                   </javaOptions>
 
@@ -568,15 +569,34 @@
                   <linuxMenuGroup>Utility</linuxMenuGroup>
                   <linuxAppCategory>Utility</linuxAppCategory>
                   <linuxPackageName>marknote</linuxPackageName>
+                  <!--
+                    Script post-install pour DEB : jpackage cherche dans resourceDir
+                    un fichier nommé "template.postinst" pour remplacer son template
+                    interne. Notre template conserve les placeholders jpackage
+                    (DESKTOP_COMMANDS_INSTALL, etc.) et ajoute la copie des fichiers
+                    de bienvenue.
+                  -->
+                  <resourceDir>${project.basedir}/src/packaging/linux-resources</resourceDir>
 
                   <!-- ── macOS-specific ──────────────────────────────── -->
                   <macPackageIdentifier>${jpackage.bundle.id}</macPackageIdentifier>
                   <macPackageName>${project.name}</macPackageName>
+                  <!--
+                    NOTE: jpackage ne supporte pas de script post-install pour le
+                    type DMG. Le script post-install-mac.sh doit être distribué
+                    séparément ou le type de package changé en PKG (qui supporte
+                    les scripts via le resource-dir).
+                  -->
 
                   <!-- ── Windows-specific ───────────────────────────── -->
                   <winDirChooser>${jpackage.win.dir.chooser}</winDirChooser>
                   <winMenu>${jpackage.win.menu}</winMenu>
                   <winShortcut>${jpackage.win.shortcut}</winShortcut>
+                  <!--
+                    NOTE: jpackage ne supporte pas de script post-install pour le
+                    type EXE. Pour MSI, un script peut être intégré via le
+                    resource-dir avec un fichier WiX customisé.
+                  -->
                 </configuration>
               </execution>
             </executions>
diff --git a/src/packaging/linux-resources/template.postinst b/src/packaging/linux-resources/template.postinst
new file mode 100644
index 0000000..44d455c
--- /dev/null
+++ b/src/packaging/linux-resources/template.postinst
@@ -0,0 +1,58 @@
+#!/bin/sh
+# postinst script for APPLICATION_PACKAGE
+#
+# see: dh_installdeb(1)
+
+set -e
+
+# summary of how this script can be called:
+#        * <postinst> `configure' <most-recently-configured-version>
+#        * <old-postinst> `abort-upgrade' <new version>
+#        * <conflictor's-postinst> `abort-remove' `in-favour' <package>
+#          <new-version>
+#        * <postinst> `abort-remove'
+#        * <deconfigured's-postinst> `abort-deconfigure' `in-favour'
+#          <failed-install-package> <version> `removing'
+#          <conflicting-package> <version>
+# for details, see https://www.debian.org/doc/debian-policy/ or
+# the debian-policy package
+
+package_type=deb
+LAUNCHER_AS_SERVICE_SCRIPTS
+
+case "$1" in
+    configure)
+DESKTOP_COMMANDS_INSTALL
+LAUNCHER_AS_SERVICE_COMMANDS_INSTALL
+
+        # ── Copier les fichiers de bienvenue ──────────────────────────
+        INSTALL_DIR=/opt/marknote
+        JAR_FILE="$INSTALL_DIR/lib/MarkNote.jar"
+        # Copie dans le dossier Documents de tous les utilisateurs existants
+        for USER_HOME in /home/*/; do
+            TARGET_DIR="$USER_HOME/Documents/MarkNote Welcome"
+            if [ -f "$JAR_FILE" ]; then
+                mkdir -p "$TARGET_DIR"
+                unzip -q -o "$JAR_FILE" "welcome-project/*" -d /tmp/marknote-welcome-extract 2>/dev/null || true
+                if [ -d /tmp/marknote-welcome-extract/welcome-project ]; then
+                    cp -r /tmp/marknote-welcome-extract/welcome-project/. "$TARGET_DIR/"
+                    rm -rf /tmp/marknote-welcome-extract
+                fi
+                # Donner les droits au propriétaire du dossier home
+                USER_NAME=$(basename "$USER_HOME")
+                chown -R "$USER_NAME:$USER_NAME" "$TARGET_DIR" 2>/dev/null || true
+            fi
+        done
+        # ─────────────────────────────────────────────────────────────
+    ;;
+
+    abort-upgrade|abort-remove|abort-deconfigure)
+    ;;
+
+    *)
+        echo "postinst called with unknown argument \`$1'" >&2
+        exit 1
+    ;;
+esac
+
+exit 0
diff --git a/src/packaging/post-install-mac.sh b/src/packaging/post-install-mac.sh
new file mode 100755
index 0000000..24f1d40
--- /dev/null
+++ b/src/packaging/post-install-mac.sh
@@ -0,0 +1,35 @@
+#!/bin/bash
+
+# Script post-installation pour macOS
+# Copie les fichiers de bienvenue dans le dossier Documents de l'utilisateur
+
+set -e
+
+# Chemin vers le JAR installé (à ajuster selon l'emplacement d'installation)
+INSTALL_DIR="/Applications/MarkNote.app/Contents/Java"
+JAR_FILE="$INSTALL_DIR/MarkNote.jar"
+
+# Dossier de destination pour les fichiers de bienvenue
+TARGET_DIR="$HOME/Documents/MarkNote Welcome"
+
+# Créer le dossier de destination s'il n'existe pas
+mkdir -p "$TARGET_DIR"
+
+# Extraire les fichiers de bienvenue du JAR
+if [ -f "$JAR_FILE" ]; then
+    echo "Extraction des fichiers de bienvenue..."
+    unzip -q -o "$JAR_FILE" "welcome-project/*" -d "$TARGET_DIR"
+    
+    # Supprimer le dossier welcome-project temporaire
+    if [ -d "$TARGET_DIR/welcome-project" ]; then
+        mv "$TARGET_DIR/welcome-project"/* "$TARGET_DIR/"
+        rmdir "$TARGET_DIR/welcome-project"
+    fi
+    
+    echo "Fichiers de bienvenue installés dans $TARGET_DIR"
+else
+    echo "Erreur: JAR non trouvé à $JAR_FILE" >&2
+    exit 1
+fi
+
+exit 0
\ No newline at end of file
diff --git a/src/packaging/post-install.bat b/src/packaging/post-install.bat
new file mode 100644
index 0000000..99d505d
--- /dev/null
+++ b/src/packaging/post-install.bat
@@ -0,0 +1,40 @@
+@echo off
+
+:: Script post-installation pour Windows
+:: Copie les fichiers de bienvenue dans le dossier Documents de l'utilisateur
+
+setlocal enabledelayedexpansion
+
+:: Chemin vers le JAR installé (à ajuster selon l'emplacement d'installation)
+set "INSTALL_DIR=C:\Program Files\MarkNote"
+set "JAR_FILE=%INSTALL_DIR%\lib\MarkNote.jar"
+
+:: Dossier de destination pour les fichiers de bienvenue
+set "TARGET_DIR=%USERPROFILE%\Documents\MarkNote Welcome"
+
+:: Créer le dossier de destination s'il n'existe pas
+if not exist "!TARGET_DIR!" (
+    mkdir "!TARGET_DIR!"
+)
+
+:: Vérifier si le JAR existe
+if exist "!JAR_FILE!" (
+    echo Extraction des fichiers de bienvenue...
+    
+    :: Extraire les fichiers de bienvenue du JAR
+    jar -xf "!JAR_FILE!" "welcome-project/" -C "!TARGET_DIR!"
+    
+    :: Déplacer les fichiers du sous-dossier welcome-project
+    if exist "!TARGET_DIR!\welcome-project" (
+        move /Y "!TARGET_DIR!\welcome-project\*" "!TARGET_DIR!\" >nul
+        rmdir "!TARGET_DIR!\welcome-project"
+    )
+    
+    echo Fichiers de bienvenue installés dans !TARGET_DIR!
+) else (
+    echo Erreur: JAR non trouvé à !JAR_FILE!
+    exit /b 1
+)
+
+endlocal
+exit /b 0
\ No newline at end of file
diff --git a/src/packaging/post-install.sh b/src/packaging/post-install.sh
new file mode 100755
index 0000000..675f255
--- /dev/null
+++ b/src/packaging/post-install.sh
@@ -0,0 +1,35 @@
+#!/bin/bash
+
+# Script post-installation pour copier les fichiers de bienvenue
+# Ce script est exécuté après l'installation du package Debian
+
+set -e
+
+# Chemin vers le JAR installé (à ajuster selon l'emplacement d'installation)
+INSTALL_DIR=/opt/MarkNote
+JAR_FILE=$INSTALL_DIR/lib/MarkNote.jar
+
+# Dossier de destination pour les fichiers de bienvenue
+TARGET_DIR=$HOME/Documents/MarkNote Welcome
+
+# Créer le dossier de destination s'il n'existe pas
+mkdir -p "$TARGET_DIR"
+
+# Extraire les fichiers de bienvenue du JAR
+if [ -f "$JAR_FILE" ]; then
+    echo "Extraction des fichiers de bienvenue..."
+    unzip -q -o "$JAR_FILE" "welcome-project/*" -d "$TARGET_DIR"
+    
+    # Supprimer le dossier welcome-project temporaire
+    if [ -d "$TARGET_DIR/welcome-project" ]; then
+        mv "$TARGET_DIR/welcome-project"/* "$TARGET_DIR/"
+        rmdir "$TARGET_DIR/welcome-project"
+    fi
+    
+    echo "Fichiers de bienvenue installés dans $TARGET_DIR"
+else
+    echo "Erreur: JAR non trouvé à $JAR_FILE" >&2
+    exit 1
+fi
+
+exit 0
\ No newline at end of file