Feature: Preserve original filename in metadata

[GwynHannay]

Proposed change

This change adds a metadata field to capture the original filename of the document being uploaded. For some, there can be important information in the original filename not captured within the document, so it is important to preserve this information.

Right now this field will only be displayed in the admin UI.

Fixes #874

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Other (please explain)

Checklist:

• I have read & agree with the contributing guidelines.
• If applicable, I have tested my code for new features & regressions on both mobile & desktop devices, using the latest version of major browsers.
• If applicable, I have checked that all tests pass, see documentation.
• I have run all pre-commit hooks, see documentation.
• I have made corresponding changes to the documentation as needed.
• I have checked my modifications for any breaking changes.

[paperless-ngx-secretary]

Hello @GwynHannay,

thank you very much for submitting this PR to us!

This is what will happen next:

1. My robotic colleagues will check your changes to see if they break anything. You can see the progress below.
2. Once that is finished, human contributors from paperless-ngx review your changes. Since this is a non-trivial change, a review from at least two contributors is required.
3. Please improve anything that comes up during the review until your pull request gets approved.
4. Your pull request will be merged into the dev branch. Changes there will be tested further.
5. Eventually, changes from you and other contributors will be merged into main and a new release will be made.

Please allow up to 7 days for an initial review. We're all very excited about new pull requests but we only do this as a hobby.
If any action will be required by you, please reply within a month.

[stumpylog]

If you don't mind, I'd like to cherry pick your commits a bit to clean up the history. It will mean you'll need to do a fetch and reset to instead of pull though. Let me know if that's a problem.

[GwynHannay]

If you don't mind, I'd like to cherry pick your commits a bit to clean up the history. It will mean you'll need to do a fetch and reset to instead of pull though. Let me know if that's a problem.

Please feel free! :-)

[coveralls]

Pull Request Test Coverage Report for Build 2900289856

• 0 of 0 changed or added relevant lines in 0 files are covered.
• 15 unchanged lines in 4 files lost coverage.
• Overall coverage increased (+0.009%) to 91.871%

---

Files with Coverage Reduction	New Missed Lines	%
documents/admin.py	1	98.46%
documents/models.py	3	98.6%
documents/consumer.py	4	94.74%
documents/views.py	7	96.65%

Totals
Change from base Build 2895990682:	0.009%
Covered Lines:	4826
Relevant Lines:	5253

---

💛 - Coveralls

[stumpylog]

The changes look good to me. I think it would be nice to extend this just a touch more for people though:

• Visible on the document details page (src-ui/src/app/components/document-detail/document-detail.component.html I think)
• Provided to the post consume script: https://github.com/paperless-ngx/paperless-ngx/blob/main/src/documents/consumer.py#L175 and https://github.com/paperless-ngx/paperless-ngx/blob/main/docs/advanced_usage.rst#post-consumption-script

[shamoon]

Agree its less useful if its not visible, I will add the frontend part

[shamoon]

All set for doc detail part =)

[GwynHannay]

Awesome!! Thank you so much - I couldn't, for the life of me, work out how to add it to the front end, haha.

[stumpylog]

I added the value to the post consume data as well. Looks good, thanks for the contribution

[qcasey]

Thanks to all three of you

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new discussion or issue for related concerns.