Media Storage Management System

[respp]

📘 Issue Description

Develop a complete file management system that enhances the existing basic upload, implementing a robust system for handling merchant logos, verification documents, generated reports, and other system files. The current system is very basic and needs enterprise-level functionalities.

The system should include:

• Intelligent storage with multiple providers (local, S3, etc.)
• Automatic image processing (resize, compression, thumbnails)
• Virus scanning system for uploaded files
• File metadata and categorization management
• Complete CRUD API for files
• Automatic cleanup system for orphaned files

🔍 Steps

1. Extend existing file upload service (fileUpload.service.ts)
2. Implement multiple storage providers (local, S3, etc.)
3. Add automatic image processing
4. Create virus scanning system
5. Develop metadata and tag management
6. Implement automatic cleanup system
7. Create complete file management API
8. Add automatic compression and optimization

✅ Acceptance Criteria

• Support for multiple storage providers (local, AWS S3, Google Cloud)
• Automatic image processing (resize, thumbnails, compression)
• Virus scanning for all uploaded files
• Metadata system (tags, categories, descriptions)
• Complete REST API for file management (/api/files)
• Automatic cleanup of unreferenced files
• Configurable limits by user type
• Automatic watermarking for sensitive images

🌎 References

• Existing file upload: src/services/fileUpload.service.ts
• Controller: src/controllers/fileUpload.controller.ts
• Middleware: src/middlewares/fileUploadMiddleware.ts

📜 Additional Notes

This feature significantly improves system asset management and is especially important for merchants who need to upload logos, verification documents, and other branding materials.

[OthmanImam]

Hi,

I'm Usman Adamu, a full-stack developer.
I want to carefully implement this task if assigned.

Best regards;
OthmanImam

Recommended by OnlyDust for high-quality and dependable contributions.

[gabito1451]

Hi @respp, I am a fullstack dev with the necessary skill to resolve this issue. I am confident of handling this task, would gladly handle this tasl if assigned.
ETA: 12HRS.

Recommended by OnlyDust for high-quality and dependable contributions.

[clintjeff2]

Hello, I’m Jefferson, a full-stack engineer with deep expertise in building enterprise-grade file management systems using Node.js, TypeScript, Express, AWS S3, Cloudinary, and local storage. I’ve previously implemented robust file storage modules featuring multi-provider support, automatic image processing (resizing, compression, watermarking), file metadata tagging, orphan cleanup automation, and virus scanning using ClamAV—all integrated with scalable REST APIs and secure middleware layers.

For this task, I’ll extend your existing fileUpload.service.ts by introducing provider abstraction for local, AWS S3, and Google Cloud storage. I will integrate Sharp for image processing, ClamAV for virus scanning, and implement metadata tagging and categorization. I’ll also build a full-featured REST API (/api/files) with CRUD support, automatic watermarking, and a cleanup cron job to delete orphaned files. Configurable limits by user roles will be enforced via middleware policies.

Estimated completion time: 20–24 hours
Telegram: @JeffersonYouashi

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 150 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[Godsmiracle001]

@Godsmiracle001 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I would like to take on this issue and implement a robust file management system for PayStell. The goal is to extend the existing basic upload functionality into an enterprise-grade solution that handles merchant logos, verification documents, generated reports, and other system files.

I will:

Extend the existing fileUpload.service.ts to support multiple storage providers (local, AWS S3, Google Cloud)

Implement automatic image processing, including resizing, compression, thumbnails, and optional watermarking for sensitive files

Integrate virus scanning for all uploads

Develop a metadata system for categorization, tags, and descriptions

Create a complete REST API for file management (/api/files) with CRUD operations

Implement automatic cleanup for unreferenced files and configurable limits by user type

With experience in NestJS, REST APIs, TypeScript, and secure file handling, I can deliver a maintainable, scalable system that improves asset management and ensures reliability for merchant uploads.

I look forward to contributing to PayStell’s backend and helping make file management secure, efficient, and user-friendly.

— Godsmiracle Ibitayo

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Godsmiracle001 to this issue.

[GideonBature]

@GideonBature has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I will love to work on this issue. Thank you!

ℹ️ Repo Maintainers: To accept this application, review their application or assign @GideonBature to this issue.

[Jayrodri088]

@Jayrodri088 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hello @respp Can I take this issue?

I'm a developer with a solid background in Web3, working across both front-end and back-end. You can check out my profile to see my contributions to the most important projects within the Stellar ecosystem.

Additionally, I have experience working in other ecosystems such as StarkNet, Optimism, and Worldcoin, and I have already contributed multiple times to Akkuea, Offer-Hub and kindifi.

My ETA on this issue will be 10 hours

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Jayrodri088 to this issue.

[Oluwaseyi89]

@Oluwaseyi89 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi able Maintainer! I’m really excited about building the media storage management system to make file handling way more robust and user-friendly. I can set up multiple storage providers, add automatic image processing, virus scanning, and metadata management, plus a full CRUD API so everything is easy to manage. This will really level up the system for merchants and ensure uploaded files are secure, optimized, and organized.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Oluwaseyi89 to this issue.

[Chucks1093]

@Chucks1093 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hello, I am a fullstack engineer. I’ve reviewed the repo and the issue, and here’s how I’d approach it:

• Begin by extending src/services/fileUpload.service.ts to act as a thin orchestration layer instead of a single provider implementation.
• Define a storage adapter interface and implement providers for local storage and S3 so switching is driven by config.
• Add image processing on upload to handle resizing, compression, thumbnails, and optional watermarking for sensitive assets.
• Integrate a virus scanning step into the upload pipeline and fail fast when a file does not pass checks.
• Store file metadata like type, size, tags, category, owner, and usage reference in a dedicated table or collection.
• Expose a full CRUD API under /api/files for listing, retrieving, updating metadata, and deleting files.
• Implement a background cleanup job to detect and remove orphaned or expired files safely.
• Enforce configurable limits based on user type to prevent abuse and control storage usage.

ETA: 36–48 hours

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Chucks1093 to this issue.

[DioChuks]

@DioChuks has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I would like to work on this issue cos i'm a software engineer with over 4yrs, that has good experience with Media Module. I am also a returning contributor & would love to continue contributing to the success of the project.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @DioChuks to this issue.