Files, Folders, Documents (EntityFiles, CompanyDocuments)

1. Business Summary

Cross-entity attachments and brand/account-level reference documents (with ownership flags Ros/Rws — read-only/read-write subsets, observed naming).

2. Business Value

Centralized document management.

3. Users / Stakeholders

All users.

4. Workflows

• Upload via Home/Common controllers; metadata persisted to EntityFile.
• CompanyDocuments grouped per company; CompanyDocumentsRos/CompanyDocumentsRws variants for restricted views.

5. Sub-Features

• ownCloud-backed cache.
• Strict EntityFile metadata validation.

6. Business Rules

• title/desc/file_name/filesystem_name/size/date all required.
• File access bound to entity security and folder structure.

7. Data Entities

EntityFile, CompanyDocument, CompanyDocumentsRo, CompanyDocumentsRw, OcFilecache.

8. Entry Points

• home/companyDocuments, home/companyDocumentsRos, home/companyDocumentsRws, home/entityFiles.

9. Inputs & Outputs

• Inputs: uploads, metadata.
• Outputs: stored files, metadata records.

10. Integrations

• ownCloud.

11. Calculations / Logic

• N/A.

12. Status Lifecycle

• N/A.

13. Permissions

• Entity security; Ro/Rw split.

14. Reports & KPIs

• Storage usage, downloads.

15. Risks & Observations

• File path / cache drift; access enforcement relies on app code.

16. Source Code Evidence

• app/Plugin/home/Controller/CompanyDocumentsController.php, CompanyDocumentsRosController.php, CompanyDocumentsRwsController.php, EntityFilesController.php.
• app/Plugin/home/Model/CompanyDocument.php, CompanyDocumentsRo.php, CompanyDocumentsRw.php, EntityFile.php.