Mise à jour doc

README.md

@@ -6,14 +6,17 @@ A lightweight, web-based Markdown note-taking application with a Go backend and
 
 *   **File-based Notes:** All notes are stored as plain Markdown files (`.md`) on the filesystem.
 *   **Tag Indexing:** Notes are indexed by tags specified in their YAML front matter, enabling quick search.
-*   **Live Markdown Preview:** A side-by-side editor and live preview pane for a better writing experience.
+*   **CodeMirror 6 Editor:** Modern, powerful Markdown editor with syntax highlighting and One Dark theme.
+*   **Live Markdown Preview:** Side-by-side editor and live preview pane with scroll synchronization.
 *   **Automatic Front Matter:** Automatically generates and updates `title`, `date` (creation), `last_modified`, and `tags` in YAML front matter.
 *   **Slash Commands:** Insert common Markdown elements and dynamic content (like current date) using `/` commands in the editor.
-*   **Dynamic File Tree:** An automatically updating file tree in the sidebar to navigate notes.
-*   **Lightweight Frontend:** Built with htmx for dynamic interactions, minimizing JavaScript complexity.
+*   **Search Modal:** Press `Ctrl/Cmd+K` to open a powerful search modal with keyboard navigation and real-time results.
+*   **Dynamic File Tree:** Automatically updating file tree in the sidebar to navigate notes.
 *   **Hierarchical Organization:** Organize notes in folders with drag-and-drop file management.
 *   **Rich Search:** Search by keywords, tags (`tag:projet`), title (`title:meeting`), or path (`path:backend`).
-*   **Go Backend:** A fast and efficient Go server handles file operations, indexing, and serving the frontend.
+*   **REST API:** Full REST API (`/api/v1/notes`) for programmatic access - list, read, create, update, and delete notes via HTTP.
+*   **Lightweight Frontend:** Built with htmx for dynamic interactions, minimizing JavaScript complexity.
+*   **Go Backend:** Fast and efficient Go server handles file operations, indexing, and serving the frontend.
 
 ## Technologies Used
 
@@ -49,17 +52,50 @@ A lightweight, web-based Markdown note-taking application with a Go backend and
 
 ### Frontend Build Process
 
-The frontend assets (JavaScript, CSS) are built and optimized using [Vite](https://vitejs.dev/). When changes are made to the frontend source code (e.g., in `frontend/src/`), the `npm run build` command must be executed from the `frontend/` directory. This command compiles, bundles, and minifies the source files into static assets (located in `static/dist/`) that the Go backend serves to the browser. This step is crucial to ensure that the latest frontend changes are reflected in the application.
+**IMPORTANT**: The frontend must be built before running the application.
+
+The frontend uses [Vite](https://vitejs.dev/) to bundle CodeMirror 6 and other JavaScript modules. This step is **required** for the editor to work.
+
+1.  **Install Node.js dependencies** (first time only):
+    ```bash
+    cd frontend
+    npm install
+    ```
+
+2.  **Build the frontend**:
+    ```bash
+    npm run build
+    ```
+
+    This compiles `frontend/src/` files into `static/dist/` (served by Go).
+
+3.  **Development mode** (auto-rebuild on changes):
+    ```bash
+    npm run build -- --watch
+    ```
 
 ### Running the Application
 
-To start the Go backend server:
+1.  **Build the frontend** (see above, required!)
 
+2.  **Start the Go backend server**:
+    ```bash
+    go run ./cmd/server
+    ```
+
+3.  **Access the application** at `http://localhost:8080`
+
+**Production build**:
 ```bash
-go run ./cmd/server
-```
+# Build frontend
+cd frontend && npm run build && cd ..
 
-The application will be accessible in your web browser at `http://localhost:8080`.
+# Compile Go binary
+go build -o server ./cmd/server
+
+# Run
+./server
+```
 
 ## Usage
 
@@ -79,8 +115,12 @@ The application will be accessible in your web browser at `http://localhost:8080
 
 ### Searching Notes
 
-The search supports multiple query formats:
+**Quick Search Modal** (Recommended):
+1.  Press **`Ctrl/Cmd+K`** anywhere to open the search modal.
+2.  Type your query - results appear instantly with keyboard navigation.
+3.  Use **`↑`/`↓`** to navigate, **`Enter`** to open, **`Esc`** to close.
 
+**Search Syntax** (works in both modal and header search):
 1.  **General search:** Type keywords to search across title, tags, path, and content.
 2.  **Tag filter:** Use `tag:projet` to filter by specific tags.
 3.  **Title filter:** Use `title:meeting` to search within note titles.
@@ -123,3 +163,64 @@ Example:
 ```bash
 go run ./cmd/server -addr :3000 -notes-dir ~/my-notes
 ```
+
+## REST API
+
+Project Notes includes a full REST API for programmatic access to your notes.
+
+**Base URL**: `http://localhost:8080/api/v1`
+
+### Quick Examples
+
+**List all notes**:
+```bash
+curl http://localhost:8080/api/v1/notes
+```
+
+**Get a specific note** (JSON):
+```bash
+curl http://localhost:8080/api/v1/notes/projet/backend.md
+```
+
+**Get note as Markdown**:
+```bash
+curl http://localhost:8080/api/v1/notes/projet/backend.md \
+  -H "Accept: text/markdown"
+```
+
+**Create/Update a note**:
+```bash
+curl -X PUT http://localhost:8080/api/v1/notes/test.md \
+  -H "Content-Type: application/json" \
+  -d '{
+    "body": "\n# Test\n\nContent here...",
+    "frontMatter": {
+      "title": "Test Note",
+      "tags": ["test"]
+    }
+  }'
+```
+
+**Delete a note**:
+```bash
+curl -X DELETE http://localhost:8080/api/v1/notes/old-note.md
+```
+
+### Full API Documentation
+
+See **[API.md](./API.md)** for complete documentation including:
+- All endpoints (LIST, GET, PUT, DELETE)
+- Request/response formats
+- Content negotiation (JSON/Markdown)
+- Advanced examples (sync, backup, automation)
+- Integration guides
+
+### Use Cases
+
+- **Backup**: Automate note backups with cron jobs
+- **Sync**: Synchronize notes across machines
+- **Integration**: Connect with other tools (Obsidian, Notion, etc.)
+- **Automation**: Create notes programmatically (daily notes, templates)
+- **CI/CD**: Validate Markdown in pipelines
+
+**⚠️ Security Note**: The API currently has no authentication. Use a reverse proxy (nginx, Caddy) with auth if exposing publicly.