docling-studio/docs/design/256-doc-tab-chunk-mode-404.md

Design: Doc tab: chunk mode returns 404

• Issue: #256
• Title on issue: [BUG] Doc tab: chunk mode returns 404
• Author: Pier-Jean Malandrino
• Date: 2026-05-07
• Status: Draft
• Target milestone: 0.6.0 — Doc-centric ingest
• Impacted layers: <backend: domain | api | services | persistence | infra> · <frontend: features/ | shared | app> · · <infra/CI>
• Audit dimensions likely touched: <pick from: Hexagonal Architecture · DDD · Clean Code · KISS · DRY · SOLID · Decoupling · Security · Tests · CI/Build · Documentation · Performance>
• ADR spawned?: (write an ADR when choosing a library, moving a boundary, or deciding not to do something — see docs/architecture/adr-guide.md)

---

1. Problem

Dans l'onglet Doc, l'activation du mode chunk déclenche une réponse HTTP 404 côté front. Le mode chunk est donc inutilisable.

TODO: ajouter logs / capture / endpoint exact qui 404.

2. Goals

• TODO: étapes précises de reproduction (doc utilisé, séquence UI)
• TODO: identifier l'endpoint backend qui 404
• TODO: correctif + non-régression

3. Non-goals

• ...
• ...

4. Context & constraints

5. Proposed design

5.1 Domain

5.2 Persistence

5.3 Infra adapters

5.4 Services

5.5 API

5.6 Frontend — feature module

5.7 Cross-cutting (feature flags, i18n, shared types)

6. Alternatives considered

Alternative A —

• Summary:
• Why not:

Alternative B —

• Summary:
• Why not:

7. API & data contract

8. Risks & mitigations

Risk	Audit dimension	Likelihood	Impact	How we notice	Mitigation / rollback

9. Testing strategy

10. Rollout & observability

11. Open questions

• ...
• ...

12. References

• Issue: https://github.com/scub-france/Docling-Studio/issues/256
• Related PRs / commits:
• ADRs: <ADR-NNN or "none planned">
• Project docs:
  • Architecture: docs/architecture.md
  • Coding standards: docs/architecture/coding-standards.md
  • ADR guide / template: docs/architecture/adr-guide.md, docs/architecture/adr-template.md
  • Audit master: docs/audit/master.md
  • E2E conventions: e2e/CONVENTIONS.md
• External: <specs, upstream issues, dashboards, third-party docs>