Google Drive & Cloud File Operations

1. Business Summary

Receives finalized files from Google Drive uploads and integrates with PM close-task; also low-level cloud operations like ZIP unpacking.

2. Business Value

External-system bridge to PM workflow.

3. Users / Stakeholders

PMs, engineers.

4. Workflows

• GoogleDriveAPIsController::getJobs() queries unfinished tasks.
• closeTaskWithFiles() accepts uploaded files, calls CommonController::PMCloseTask.
• CloudController operations (zip extraction, base path resolution, file relation building).

5. Sub-Features

• Cloud directory cleanup, zip extract, file-record linkage.

6. Business Rules

• API auth via FunctionsController::doLogin().

7. Data Entities

OcFilecache, OcFscache, File.

8. Entry Points

• google_drive_apis/*, cloud/*.

9. Inputs & Outputs

• Inputs: uploads, ZIPs.
• Outputs: linked files, closed tasks.

10. Integrations

• Google Drive, ownCloud.

11. Calculations / Logic

• File relation graph build.

12. Status Lifecycle

• N/A.

13. Permissions

• PMs.

14. Reports & KPIs

• Successful closes by upload.

15. Risks & Observations

• File cache vs. filesystem drift risk.
• Server-side ZIP unpacking — security risk if not validated.

16. Source Code Evidence

• app/Controller/GoogleDriveAPIsController.php.
• app/Controller/CloudController.php.