📐 Диаграма на реалния flow, по кода в репото

Как работи порталът

Пътят на един проект — от подаване на документи от клиента до защитено изтегляне на готовите файлове — точно както е имплементирано в контролерите.

Клиент Персонал / система

Подава проект с файлове

До 20 файла наведнъж (PDF, DOC/DOCX, XLS/XLSX, PNG/JPG, ZIP), макс. 25 MB всеки. Проектът влиза със статус "подаден".

ProjectController@store

Файловете се записват на частен диск

Всеки файл получава случайно генерирано UUID име и се пази извън публично достъпните папки — не съществува URL, който просто да отвори файла.

ProjectFileUploadService::storeOne()

Персоналът преглежда и движи статуса

Служебно табло показва всички проекти с филтър по статус.

подаден в прогрес нужна информация завършен

Admin\ProjectController@updateStatus

При нужда — клиентът добавя файлове

Ако статусът е "нужна информация", клиентът качва допълнителни документи и проектът автоматично се връща на "подаден".

ProjectController@storeFiles

Персоналът качва готовите файлове

Крайните документи се маркират отделно като "deliverables" — различни от входните файлове на клиента.

Admin\ProjectController@storeDeliverables

Клиентът изтегля готовите файлове

Всяко изтегляне минава през проверка — собственик на проекта ли е заявителят (или е персонал) — преди файлът изобщо да бъде прочетен от диска.

ProjectFileController@download

    Технически детайли
    Файловете никога не се сервират директно — всяко изтегляне минава през контролер, който проверява правата преди да прочете файла от диска.
Клиент вижда само собствените си проекти (Project::scopeForClient) — заявка за чужд проект връща 403, не 404, за да е ясно, че е забрана, не липсващ ресурс.
Типът и размерът на всеки файл се валидират при качване — разрешени са само познати документни формати, лимит 25 MB на файл.

  