✨ Import of documents #1609

StephanMeijer · 2025-11-15T15:30:13Z

Purpose

We can now import docx and and md files just by dropping them into the docs grid area.
To do so we added a new container "docspec", which uses the docspec service to convert these formats to Blocknote format.

Import of (markdown) documents. See #1567 #1569.

Demo

Docs.1.online-video-cutter.com.mp4

github-actions · 2025-11-15T15:34:46Z

Size Change: +18.5 kB (+0.44%)

Total Size: 4.19 MB

Filename	Size	Change
`apps/impress/out/_next/static/bc3e3f06/_buildManifest.js`	887 B	+887 B (new file)	🆕
`apps/impress/out/_next/static/c3c2b460/_buildManifest.js`	0 B	-887 B (removed)	🏆
`apps/impress/out/_next/static/chunks/3812.js`	0 B	-768 kB (removed)	🏆
`apps/impress/out/_next/static/chunks/4370.js`	785 kB	+785 kB (new file)	🆕
`apps/impress/out/_next/static/chunks/8495.js`	65.2 kB	+1.87 kB (+2.96%)

_{compressed-size-action}

github-actions · 2025-11-28T15:55:34Z

🚀 Preview will be available at https://1609-docs.ppr-docs.beta.numerique.gouv.fr/

You can use the existing account with these credentials:

username: docs
password: docs

You can also create a new account if you want to.

Once this Pull Request is merged, the preview will be destroyed.

Copilot

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

src/backend/core/services/converter_services.py

socket-security · 2026-01-09T09:21:02Z

All alerts resolved. Learn more about Socket for GitHub.

This PR previously contained dependency changes with security issues that have been resolved, removed, or ignored.

View full report

Refactored converter services based on PR #1609 review comments: - Renamed parameter to `data` across all convert methods for consistency - Replaced recursive call with explicit sequential calls for readability - Hardcoded CONVERSION_API_SECURE=True in Production class for security - Removed unused YdocConverter import from viewsets.py - Updated tests to match new error message wording Signed-off-by: Stephan Meijer <me@stephanmeijer.com>

Copilot

Pull request overview

Copilot reviewed 30 out of 35 changed files in this pull request and generated 6 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

src/frontend/apps/e2e/__tests__/app-impress/doc-import.spec.ts

src/backend/core/api/serializers.py

docs/env.md

CHANGELOG.md

src/backend/core/services/converter_services.py

src/frontend/apps/impress/src/features/docs/docs-grid/components/DocsGrid.tsx

Refactored converter services based on PR #1609 review comments: - Renamed parameter to `data` across all convert methods for consistency - Replaced recursive call with explicit sequential calls for readability - Hardcoded CONVERSION_API_SECURE=True in Production class for security - Removed unused YdocConverter import from viewsets.py - Updated tests to match new error message wording Signed-off-by: Stephan Meijer <me@stephanmeijer.com>

We can now import documents in formats .docx and .md. To do so we added a new container "docspec", which uses the docspec service to convert these formats to Blocknote format. More here: #1567 #1569.

Adapt the docs grid title bar to align with the new design. We will add a upload button in a future iteration.

Add import document area with drag and drop support in the docs grid component. We can now import docx and and md files just by dropping them into the designated area. We are using the `react-dropzone` library to handle the drag and drop functionality.

Updated docspec service image from 2.0.0 to 2.4.4 to include latest features and bug fixes. Signed-off-by: Stephan Meijer <me@stephanmeijer.com>

Added comprehensive tests covering DocSpec converter service, converter orchestration, and document creation with file uploads. Tests validate DOCX and Markdown conversion workflows, error handling, service availability, and edge cases including empty files and Unicode filenames. Signed-off-by: Stephan Meijer <me@stephanmeijer.com>

Refactored converter services based on PR #1609 review comments: - Renamed parameter to `data` across all convert methods for consistency - Replaced recursive call with explicit sequential calls for readability - Hardcoded CONVERSION_API_SECURE=True in Production class for security - Removed unused YdocConverter import from viewsets.py - Updated tests to match new error message wording Signed-off-by: Stephan Meijer <me@stephanmeijer.com>

Added Helm templates for docspec deployment and service to enable document specification conversion in the Kubernetes environment. Updated Tiltfile, compose.yml, and Helm values to configure docspec integration alongside the backend converter service for document import functionality.

…figuration

AntoLC

Frontend perspective works perfectly !
Bravo ! 🎉

We can try the feature here https://1609-docs.ppr-docs.beta.numerique.gouv.fr/

See: #1609 (comment)

Some tests files if you need:

test_import.docx
test_import.md

virgile-dev · 2026-01-14T14:03:50Z

Holy molly ! Let me try it.

lunika

Nice job !

CHANGELOG.md

lunika · 2026-01-15T15:41:19Z

src/backend/core/api/serializers.py


    content = serializers.CharField(required=False)
    websocket = serializers.BooleanField(required=False, write_only=True)
+    file = serializers.FileField(required=False, write_only=True, allow_null=True)


There is no check on the file size. You should check what is made in the FileUploadSerializer
The max_length should be set to 255. The filename will be used as document title. And the title max length is 255.

StephanMeijer requested a review from AntoLC November 15, 2025 15:41

StephanMeijer force-pushed the feature/doc-import branch from d823f39 to 2c07a42 Compare November 18, 2025 16:48

AntoLC assigned StephanMeijer and AntoLC Nov 28, 2025

AntoLC added frontend feature add a new feature backend docker labels Nov 28, 2025

AntoLC force-pushed the feature/doc-import branch from 2c07a42 to d6bc397 Compare November 28, 2025 15:53

AntoLC added the preview label Nov 28, 2025

This was linked to issues Nov 28, 2025

(DocSpec) Integration between DocSpec and La Suite Docs #1567

Open

(DocSpec) Infrastuctural integration with La Suite (Docker Compose, Helm) #1569

Open

AntoLC force-pushed the feature/doc-import branch 8 times, most recently from 2282095 to eeeaa0c Compare December 3, 2025 14:45

StephanMeijer force-pushed the feature/doc-import branch from d3c9562 to 970fcd5 Compare December 5, 2025 22:02

StephanMeijer requested review from Copilot, lunika and virgile-dev December 5, 2025 22:08

Copilot AI reviewed Dec 5, 2025

View reviewed changes

lunika reviewed Dec 8, 2025

View reviewed changes

src/backend/core/services/converter_services.py Outdated Show resolved Hide resolved

src/backend/core/services/converter_services.py Outdated Show resolved Hide resolved

src/backend/core/services/converter_services.py Show resolved Hide resolved

StephanMeijer force-pushed the feature/doc-import branch 2 times, most recently from a9c28e9 to 9cef0a0 Compare January 8, 2026 11:01

AntoLC force-pushed the feature/doc-import branch from df60fc6 to e71eb79 Compare January 9, 2026 09:24

StephanMeijer changed the title ~~Draft: ✨ Import of documents~~ ✨ Import of documents Jan 12, 2026

StephanMeijer requested review from Copilot and lunika January 13, 2026 12:44

Copilot started reviewing on behalf of StephanMeijer January 13, 2026 12:44 View session

Copilot AI reviewed Jan 13, 2026

View reviewed changes

AntoLC force-pushed the feature/doc-import branch 2 times, most recently from 1e06ed7 to 33ef8dc Compare January 13, 2026 13:06

AntoLC force-pushed the feature/doc-import branch from 33ef8dc to cbd85a0 Compare January 13, 2026 13:10

AntoLC force-pushed the feature/doc-import branch from cbd85a0 to dde68a3 Compare January 13, 2026 13:27

StephanMeijer and others added 8 commits January 14, 2026 10:26

✨(backend) Import of documents

5c434a8

We can now import documents in formats .docx and .md. To do so we added a new container "docspec", which uses the docspec service to convert these formats to Blocknote format. More here: #1567 #1569.

💄(frontend) adapt the docs grid title bar

9dc11a6

Adapt the docs grid title bar to align with the new design. We will add a upload button in a future iteration.

⬆️(docker) upgrade docspec api to version 2.4.4

f95576f

Updated docspec service image from 2.0.0 to 2.4.4 to include latest features and bug fixes. Signed-off-by: Stephan Meijer <me@stephanmeijer.com>

fixup! ✨(docker) add docspec deployment and service to kubernetes con…

fa2be3b

…figuration

AntoLC force-pushed the feature/doc-import branch from dde68a3 to fa2be3b Compare January 14, 2026 09:35

AntoLC mentioned this pull request Jan 14, 2026

Broken layout with copy paste from word #1797

Closed

AntoLC approved these changes Jan 14, 2026

View reviewed changes

lunika reviewed Jan 15, 2026

View reviewed changes

CHANGELOG.md Outdated Show resolved Hide resolved

lunika reviewed Jan 15, 2026

View reviewed changes

fixup! ✨(frontend) add import document area in docs grid

39a0c63

✨ Import of documents #1609

Are you sure you want to change the base?

✨ Import of documents #1609

Uh oh!

Conversation

StephanMeijer commented Nov 15, 2025 • edited by AntoLC Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Purpose

Demo

Uh oh!

github-actions bot commented Nov 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Nov 28, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

socket-security bot commented Jan 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

AntoLC left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

virgile-dev commented Jan 14, 2026

Uh oh!

lunika left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

lunika Jan 15, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

StephanMeijer commented Nov 15, 2025 •

edited by AntoLC

Loading

github-actions bot commented Nov 15, 2025 •

edited

Loading

socket-security bot commented Jan 9, 2026 •

edited

Loading

AntoLC left a comment •

edited

Loading