solidprivacy-nl commited on
Commit
8bcc3ae
·
1 Parent(s): fb415a4

Add WP17 PDF text UI planning handover

Browse files
handover/workpackages/20260609_1130_pdf_text_reinsert_ui_planning.md ADDED
@@ -0,0 +1,118 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Handover — WP17 — PDF text extraction reinsert UI planning only
2
+
3
+ Repository: solidprivacy-nl/scrub
4
+ Status: completed planning/specification-only
5
+
6
+ ## Summary
7
+
8
+ WP17 created a safe future UI specification for exposing the WP16 PDF text extraction helper.
9
+
10
+ Planning conclusion:
11
+
12
+ - PDF text extraction may be exposed only as text-based PDF extraction to restored TXT output.
13
+ - The future UI must be placed only in `Originele waarden terugzetten`.
14
+ - The future UI must not appear in `Anonimiseren`.
15
+ - DOCX remains the preferred document-level reinsert route.
16
+ - The future workflow should be PDF upload → local text extraction → restored TXT preview/download only.
17
+ - Strong warnings are required for incomplete PDF extraction, no layout preservation, restored sensitive values, unsupported scanned/image-only PDFs, no OCR and TXT-only output.
18
+ - Required audit fields and unsupported cases are specified.
19
+ - Full restored PDF output, OCR, PDF-to-DOCX reconstruction, cloud PDF conversion and AI-based extraction remain out of scope.
20
+
21
+ No UI, code, tests, dependencies or export behavior were changed.
22
+
23
+ ## Files added
24
+
25
+ - `PDF_TEXT_REINSERT_UI_PLAN.md`
26
+ - `handover/workpackages/20260609_1130_pdf_text_reinsert_ui_planning.md`
27
+
28
+ ## Files changed
29
+
30
+ - `WORKPACKAGES.md`
31
+ - `CHANGELOG.md`
32
+
33
+ ## Tests
34
+
35
+ - Tests: not applicable; planning-only.
36
+ - No tests were added.
37
+ - No tests were changed.
38
+ - No local tests were run.
39
+
40
+ ## Validation
41
+
42
+ - Validation status: completed as planning/specification-only.
43
+ - GitHub Actions: not required unless documentation checks run.
44
+ - Hugging Face sync: not functionally relevant; no app behavior changed.
45
+ - App verification: not applicable; no UI behavior changed.
46
+
47
+ ## GitHub Actions status
48
+
49
+ Not required for WP17 unless documentation checks run.
50
+
51
+ ## Hugging Face sync status
52
+
53
+ Not functionally relevant because no app behavior changed.
54
+
55
+ ## App verification status
56
+
57
+ Not applicable because no UI behavior changed.
58
+
59
+ ## Boundaries preserved
60
+
61
+ - No code changed.
62
+ - No tests changed.
63
+ - No UI changed.
64
+ - No dependencies changed.
65
+ - No OCR added.
66
+ - No PDF output added.
67
+ - No PDF-to-DOCX reconstruction added.
68
+ - No cloud PDF conversion added.
69
+ - No AI-based extraction added.
70
+ - No layout preservation promises added.
71
+ - No batch PDF processing added.
72
+ - No real-data PDF test cases added.
73
+ - No automatic PDF rehydration added.
74
+ - No existing TXT/DOCX/pasted-text reinsert behavior changed.
75
+ - No existing scrubbed TXT/CSV/DOCX/PDF export/download behavior changed.
76
+ - No Scrub Key import/export behavior changed.
77
+ - No secrets, tokens or real personal data stored.
78
+
79
+ ## Remaining risks
80
+
81
+ - PDF text extraction remains inherently unreliable for layout, reading order, headers, footers, columns and tables.
82
+ - Scanned/image-only PDFs remain unsupported because OCR is out of scope.
83
+ - The future UI could still create false confidence if warnings are weakened during implementation.
84
+ - Future implementation must avoid any wording that implies restored PDF output or legal completeness.
85
+ - Future implementation must keep restored output clearly separated from scrubbed export/download controls.
86
+
87
+ ## Next recommended step
88
+
89
+ - WP18 — PDF text extraction to restored TXT UI implementation.
90
+
91
+ WP18 must be explicitly approved as a separate implementation workpackage before starting.
92
+
93
+ Recommended WP18 scope:
94
+
95
+ ```text
96
+ Originele waarden terugzetten only
97
+ PDF upload
98
+ local text extraction via WP16 helper
99
+ restored TXT preview
100
+ restored TXT download
101
+ audit report
102
+ strong warnings
103
+ no PDF output
104
+ no OCR
105
+ no AI/cloud
106
+ ```
107
+
108
+ Still out of scope unless separately approved:
109
+
110
+ - full restored PDF output;
111
+ - OCR;
112
+ - PDF-to-DOCX reconstruction;
113
+ - cloud PDF conversion;
114
+ - AI-based extraction;
115
+ - layout preservation promises;
116
+ - batch PDF processing;
117
+ - real-data PDF test cases;
118
+ - automatic PDF rehydration.