coderonak/modular-monolithic-cloud-file-storage-backend

Cloud File Storage API is a backend service for managing file storage in the cloud. It handles user accounts, authentication, and file operations, users can upload, download, and delete files such as images, videos, and documents. Access is secured using JWT, a token-based login system, and Role-Based Access Control, which lets different users have different levels of permission. The project is built as a modular monolith, a single application that deploys as one unit, but is internally divided into separate, self-contained modules. Each module owns its own data and logic and does not reach directly into another module's internals. Instead, modules communicate through well-defined interfaces and internal events. This structure is easier to maintain than a tightly tangled codebase, and it leaves the door open to splitting into separate microservices later if the project grows. The three modules are auth, which handles login and permissions, files, which handles file operations and cloud storage integration, and common, which holds shared utilities. The backend is written in Java 25 and built with Spring Boot 4. It stores metadata and user data in PostgreSQL, keeps the actual files in Google Cloud Storage, and runs on Google Cloud Run, a serverless container hosting service. Google Cloud SQL hosts the database, and Docker packages the whole application into a container for deployment. API endpoints are documented and testable through a Swagger UI interface. The README does not state a license.