BACKEND: Create File Upload and Management Service

[yusuftomilola]

Description:
Build a comprehensive file upload service supporting profile pictures, documents, receipts, and biometric images with AWS S3/CloudFlare R2 storage, image optimization, and CDN integration.

Acceptance Criteria:

• POST /api/files/upload endpoint - Upload single file
• POST /api/files/upload-multiple endpoint - Upload multiple files
• GET /api/files/:id endpoint - Get file metadata
• GET /api/files/:id/download endpoint - Download file
• DELETE /api/files/:id endpoint - Delete file
• Support file types: images (JPEG, PNG, WebP), PDFs, documents (DOC, DOCX)
• File size limits: Images (5MB), Documents (10MB), PDFs (20MB)
• Image optimization (compression, resizing, format conversion)
• Generate thumbnails for images (3 sizes: small, medium, large)
• Virus scanning with ClamAV
• Store files in AWS S3 or CloudFlare R2
• Generate signed URLs for private files (1-hour expiry)
• CDN integration for public files
• Track file metadata (size, mime type, uploader, upload date)
• Automatic cleanup of orphaned files (30 days)
• Rate limiting (20 uploads per hour per user)

Technical Requirements:

• Use @nestjs/platform-express with Multer
• Use @aws-sdk/client-s3 for S3 operations
• Use sharp for image processing
• Use file-type for MIME type detection
• Use clamscan for virus scanning
• Implement streaming for large files
• Create custom validators for file types and sizes

Files to Create:

backend/src/
├── files/
│   ├── files.module.ts
│   ├── files.controller.ts
│   ├── files.service.ts
│   ├── storage/
│   │   ├── storage.interface.ts
│   │   ├── s3-storage.service.ts
│   │   └── local-storage.service.ts (for development)
│   ├── processors/
│   │   ├── image-processor.service.ts
│   │   └── virus-scanner.service.ts
│   ├── validators/
│   │   ├── file-type.validator.ts
│   │   └── file-size.validator.ts
│   ├── dto/
│   │   ├── upload-file.dto.ts
│   │   └── file-filter.dto.ts
│   ├── entities/
│   │   └── file.entity.ts
│   └── decorators/
│       └── file-upload.decorator.ts
└── config/
    └── storage.config.ts

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 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

[mijinummi]

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

Hi, am full stack developer, I can treat this with experience in no time

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

[Eniola3321]

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

I’d like to work on this issue if it’s still available.
I’m a backend developer with experience in Node.js and Web3, and I understand the problem described.
Please let me know if I can be assigned. Thank you!

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

[KAMALDEEN333]

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

i will love to work on this with my experience in Nestjs i will be able to achieve it.

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

[phertyameen]

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

Hi, I am a great backend developer. I have uploaded files to cloudinary and s3 buckets. This should be a easy to implement for me. My ETA is 28hrs

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

[drips-wave]

Congratulations, @phertyameen! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on January 31, 2026.

🧑‍💻 @phertyameen: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

⚠️ Important: When opening a PR, please link it to this issue to ensure it gets tracked accurately.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @phertyameen as part of the Stellar Wave Program's 1st Wave 🥳

😎 @phertyameen: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here.

🧑‍💻 Repo maintainers: How'd the contributor do? If you like, you can reward them with additional points by making a compliment within seven days after the Wave Program's current wave ends.