Remove root-level Gradle configuration files and update project structure to reflect standalone backend and frontend modules. Adjust Makefile commands for building, running, and testing to streamline development processes. Update documentation to clarify usage and improve organization.

Author: efraespada

.cursor/rules/vaultstadio-backend.mdc

@@ -156,11 +156,11 @@ Uses JWT secret as key placeholder. Not production-ready.
 Run from **repo root** (backend is part of root Gradle project).
 
 ```bash
-./gradlew :backend:api:run                    # Run backend
-./gradlew :backend:api:build -x test          # Build without tests
-./gradlew :backend:core:test :backend:api:test  # Run tests
-./gradlew :backend:api:flywayMigrate          # Run migrations
-./gradlew :backend:api:flywayClean            # Clean database (dev)
+cd backend && ./gradlew :api:run              # Run backend (or: make backend-run)
+cd backend && ./gradlew :api:build -x test     # Build without tests
+cd backend && ./gradlew :core:test :api:test  # Run tests
+cd backend && ./gradlew :api:flywayMigrate    # Run migrations
+cd backend && ./gradlew :api:flywayClean       # Clean database (dev)
 # Or: make backend-run, make backend-build, make backend-test, make db-migrate
 ```
 

.cursor/rules/vaultstadio-commands.mdc

@@ -8,19 +8,19 @@ globs: ["*"]
 
 Use these commands for build, run, test, quality, and Docker. See also [Makefile](Makefile), [frontend/Makefile](frontend/Makefile), [docs/getting-started/QUICK_START.md](docs/getting-started/QUICK_START.md), [docs/development/CODE_QUALITY.md](docs/development/CODE_QUALITY.md).
 
-**Project layout**: Backend is part of the root Gradle project (`:backend:*`). Frontend is a **standalone** project in `frontend/` (run Gradle from `frontend/` or use `make frontend-*` from root).
+**Project layout**: No Gradle at repo root. **Backend** and **frontend** are **standalone** Gradle projects in `backend/` and `frontend/` (each has its own `gradlew`, `settings.gradle.kts`, `build.gradle.kts`). Use `make` from root or run Gradle from the project directory.
 
 ## Build
 
 ```bash
-# Full build (backend from root + frontend from frontend/)
+# Full build (backend + frontend, from root)
 make build
 
-# Backend only (from repo root)
-./gradlew :backend:api:build -x test
+# Backend only (from root or from backend/)
 make backend-build
+# Or: cd backend && ./gradlew :api:build -x test
 
-# Frontend – web WASM (from repo root or from frontend/)
+# Frontend – web WASM (from root or from frontend/)
 make frontend-web
 # Or from frontend/: ./gradlew :composeApp:wasmJsBrowserDistribution
 
@@ -32,9 +32,9 @@ make frontend-web-dev
 cd frontend && ./gradlew :composeApp:compileKotlinDesktop
 # Or: make desktop-run (from root runs frontend desktop)
 
-# Plugins (from repo root)
-./gradlew :backend:plugins:image-metadata:pluginJar :backend:plugins:video-metadata:pluginJar
+# Plugins (from root or backend/)
 make plugins-build
+# Or: cd backend && ./gradlew :plugins:image-metadata:pluginJar :plugins:video-metadata:pluginJar
 
 # Android APK (from root or frontend/)
 make android-build
@@ -44,9 +44,9 @@ make android-build
 ## Run (development and production)
 
 ```bash
-# Backend (from repo root; requires PostgreSQL)
-./gradlew :backend:api:run
+# Backend (from root or backend/; requires PostgreSQL)
 make backend-run
+# Or: cd backend && ./gradlew :api:run
 
 # Frontend – desktop (from root or frontend/)
 make desktop-run
@@ -70,9 +70,9 @@ make dev
 # All tests (backend + frontend)
 make test
 
-# Backend only (from repo root)
-./gradlew :backend:core:test :backend:api:test
+# Backend only (from root or backend/)
 make backend-test
+# Or: cd backend && ./gradlew :core:test :api:test
 
 # Frontend only (from root or frontend/)
 make frontend-test
@@ -85,19 +85,19 @@ make test-coverage
 ## Code Quality (run before commit)
 
 ```bash
-# 1. Format
-./gradlew ktlintFormat
+# 1. Format (run in each project)
+cd backend && ./gradlew ktlintFormat
 cd frontend && ./gradlew ktlintFormat
 
 # 2. Check no FQN in type positions
 ./scripts/check-no-fqn.sh
 
 # 3. Static analysis (runs ktlintCheck then detekt)
-./gradlew detekt
+make lint   # backend detekt
 cd frontend && ./gradlew detektMain
 ```
 
-Quick: `./gradlew ktlintFormat && ./scripts/check-no-fqn.sh && ./gradlew detekt`
+Quick: `make lint` then `./scripts/check-no-fqn.sh`; format in backend/ and frontend/ with ktlintFormat.
 
 ## Docker
 
@@ -125,10 +125,8 @@ make docker-down
 ## Database
 
 ```bash
-./gradlew :backend:api:flywayMigrate   # migrate
-make db-migrate
-./gradlew :backend:api:flywayClean     # clean (dev)
-make db-clean
+make db-migrate   # or: cd backend && ./gradlew :api:flywayMigrate
+make db-clean     # or: cd backend && ./gradlew :api:flywayClean
 ```
 
 ## Release / Clean

.cursor/rules/vaultstadio-core.mdc

@@ -24,7 +24,7 @@ VaultStadio is a **self-hosted storage platform** with plugin architecture:
 
 ```
 vaultstadio/
-├── backend/            # Root Gradle project (:backend:*)
+├── backend/            # Standalone Gradle project (run from backend/)
 │   ├── core/           # Domain: models, services, repositories (interfaces), events
 │   ├── plugins-api/    # Plugin SDK: Plugin interface, PluginContext, hooks
 │   ├── api/            # Ktor: routes, DTOs, config, middleware

.cursor/rules/vaultstadio-plugins.mdc

@@ -44,7 +44,7 @@ ai-classification/→ AIClassificationPlugin.kt
 ## Commands
 
 ```bash
-./gradlew :kotlin-backend:plugins:image-metadata:pluginJar
-./gradlew :kotlin-backend:plugins:video-metadata:pluginJar
+cd backend && ./gradlew :plugins:image-metadata:pluginJar :plugins:video-metadata:pluginJar
+# Or: make plugins-build (from root)
 make plugins-build
 ```

.cursor/rules/vaultstadio-quality.mdc

@@ -11,8 +11,8 @@ See [docs/development/CODE_QUALITY.md](docs/development/CODE_QUALITY.md) for ful
 ## Formatting – ktlint
 
 - **Config**: [.editorconfig](.editorconfig). Max line length 120, indent 4, no trailing whitespace, final newline.
-- **Fix**: `./gradlew ktlintFormat`
-- **Check**: `./gradlew ktlintCheck` (CI runs this before detekt).
+- **Fix**: `cd backend && ./gradlew ktlintFormat` (and same in frontend/).
+- **Check**: `cd backend && ./gradlew ktlintCheck` (CI runs this before detekt).
 - **No wildcard imports** – explicit imports only (enforced by project rules and detekt).
 
 ## No FQN in type positions
@@ -23,8 +23,8 @@ See [docs/development/CODE_QUALITY.md](docs/development/CODE_QUALITY.md) for ful
 
 ## Static analysis – detekt
 
-- **Config**: [config/detekt/detekt.yml](config/detekt/detekt.yml).
-- **Run**: `./gradlew detekt` (after ktlintCheck). Use `detektMain` for main source only; `detektBaseline` to generate baseline.
+- **Config**: Backend: [backend/config/detekt/detekt.yml](backend/config/detekt/detekt.yml). Frontend: [frontend/config/detekt/](frontend/config/detekt/).
+- **Run**: `make lint` (backend); `cd frontend && ./gradlew detektMain`. Use `detektBaseline` to generate baseline.
 - **Make**: `make lint`, `make lint-report`, `make lint-baseline`.
 
 ## File size guidelines
@@ -37,12 +37,12 @@ See [docs/development/CODE_QUALITY.md](docs/development/CODE_QUALITY.md) for ful
 ## Testing
 
 - **Stack**: JUnit 5, MockK, Testcontainers for integration tests.
-- **Run**: `./gradlew test`, `make backend-test`, `make test-coverage`.
+- **Run**: `make test`, `make backend-test`, `make test-coverage`.
 - Add unit tests for non-trivial logic; document in structural changes.
 
 ## Pre-commit / CI order
 
-1. `./gradlew ktlintFormat`
+1. `cd backend && ./gradlew ktlintFormat` (and frontend if needed)
 2. `./scripts/check-no-fqn.sh`
-3. `./gradlew detekt`
-4. `./gradlew test`
+3. `make lint` (backend + frontend detekt)
+4. `make test`

.cursor/rules/vaultstadio.mdc

@@ -26,7 +26,9 @@ Project rules are split into several `.mdc` files for better context and classif
 ### Code Quality (run before every commit)
 
 ```bash
-./gradlew ktlintFormat && ./scripts/check-no-fqn.sh && ./gradlew detekt
+make lint   # backend detekt; then cd frontend && ./gradlew detektMain
+./scripts/check-no-fqn.sh
+# Format: cd backend && ./gradlew ktlintFormat; cd frontend && ./gradlew ktlintFormat
 ```
 
 ### Key Constraints

.github/workflows/ci.yml

@@ -34,6 +34,7 @@ jobs:
       - name: Setup Gradle
         uses: gradle/gradle-build-action@v3
         with:
+          project-root: backend
           cache-read-only: ${{ github.ref != 'refs/heads/main' && github.ref != 'refs/heads/master' }}
 
       - name: Ensure Docker is available (for Testcontainers)
@@ -59,35 +60,38 @@ jobs:
           fi
       
       - name: Build backend modules
+        working-directory: backend
         run: |
-          ./gradlew :backend:core:build \
-            :backend:plugins-api:build \
-            :backend:infrastructure:build \
-            :backend:api:build \
+          ./gradlew :core:build \
+            :plugins-api:build \
+            :infrastructure:build \
+            :api:build \
             -x test
       
       - name: Run backend tests
+        working-directory: backend
         run: |
-          ./gradlew :backend:core:test \
-            :backend:api:test \
-            :backend:infrastructure:test \
-            :backend:plugins-api:test \
-            :backend:plugins:image-metadata:test \
-            :backend:plugins:video-metadata:test \
-            :backend:plugins:fulltext-search:test \
-            :backend:plugins:ai-classification:test \
+          ./gradlew :core:test \
+            :api:test \
+            :infrastructure:test \
+            :plugins-api:test \
+            :plugins:image-metadata:test \
+            :plugins:video-metadata:test \
+            :plugins:fulltext-search:test \
+            :plugins:ai-classification:test \
             --continue
 
       - name: Generate backend coverage reports
+        working-directory: backend
         run: |
-          ./gradlew :backend:core:jacocoTestReport \
-            :backend:api:jacocoTestReport \
-            :backend:infrastructure:jacocoTestReport \
-            :backend:plugins-api:jacocoTestReport \
-            :backend:plugins:image-metadata:jacocoTestReport \
-            :backend:plugins:video-metadata:jacocoTestReport \
-            :backend:plugins:fulltext-search:jacocoTestReport \
-            :backend:plugins:ai-classification:jacocoTestReport \
+          ./gradlew :core:jacocoTestReport \
+            :api:jacocoTestReport \
+            :infrastructure:jacocoTestReport \
+            :plugins-api:jacocoTestReport \
+            :plugins:image-metadata:jacocoTestReport \
+            :plugins:video-metadata:jacocoTestReport \
+            :plugins:fulltext-search:jacocoTestReport \
+            :plugins:ai-classification:jacocoTestReport \
             --continue
 
       - name: Upload test results
@@ -217,13 +221,16 @@ jobs:
 
       - name: Setup Gradle
         uses: gradle/gradle-build-action@v3
+        with:
+          project-root: backend
 
       - name: Build plugins
+        working-directory: backend
         run: |
-          ./gradlew :backend:plugins:image-metadata:build \
-            :backend:plugins:video-metadata:build \
-            :backend:plugins:fulltext-search:build \
-            :backend:plugins:ai-classification:build \
+          ./gradlew :plugins:image-metadata:build \
+            :plugins:video-metadata:build \
+            :plugins:fulltext-search:build \
+            :plugins:ai-classification:build \
             -x test
 
   # Build Android app
@@ -256,7 +263,7 @@ jobs:
       - name: Build Android APK (debug)
         run: cd frontend && ./gradlew :androidApp:assembleDevDebug
 
-  # Code quality checks
+  # Code quality checks (no root Gradle; backend and frontend are standalone)
   lint:
     name: Lint & Code Quality
     runs-on: [self-hosted, macOS, X64]
@@ -280,14 +287,16 @@ jobs:
             "platforms;android-34" \
             "build-tools;34.0.0"
       
-      - name: Setup Gradle
-        uses: gradle/gradle-build-action@v3
-      
       - name: Check no FQN in type positions
         run: ./scripts/check-no-fqn.sh
 
-      - name: Run Detekt
-        run: ./gradlew detekt --continue
+      - name: Run Detekt (backend)
+        working-directory: backend
+        run: ./gradlew detektMain --continue
+      
+      - name: Run Detekt (frontend)
+        working-directory: frontend
+        run: ./gradlew detektMain --continue
 
       - name: Upload Detekt report
         uses: actions/upload-artifact@v4

.github/workflows/docker.yml

@@ -36,9 +36,12 @@ jobs:
 
       - name: Setup Gradle
         uses: gradle/gradle-build-action@v3
+        with:
+          project-root: backend
 
       - name: Build backend JAR
-        run: ./gradlew :backend:api:build -x test
+        working-directory: backend
+        run: ./gradlew :api:build -x test
 
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
@@ -158,10 +161,12 @@ jobs:
 
       - name: Setup Gradle
         uses: gradle/gradle-build-action@v3
+        with:
+          project-root: backend
 
       - name: Build release artifacts
-        run: |
-          ./gradlew :backend:api:distZip -x test
+        working-directory: backend
+        run: ./gradlew :api:distZip -x test
 
       - name: Create Release
         uses: softprops/action-gh-release@v1

.github/workflows/security.yml

@@ -29,18 +29,11 @@ jobs:
           java-version: '21'
           distribution: 'temurin'
 
-      - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v3
+      - name: Run dependency check (backend)
+        run: cd backend && ./gradlew dependencies --no-daemon || true
 
-      - name: Run dependency check
-        run: ./gradlew dependencyCheckAnalyze || true
-
-      - name: Upload dependency check report
-        uses: actions/upload-artifact@v4
-        if: always()
-        with:
-          name: dependency-check-report
-          path: build/reports/dependency-check/
+      - name: Run dependency check (frontend)
+        run: cd frontend && ./gradlew dependencies --no-daemon || true
 
   # ==================== Code Security Scan ====================
   code-scan:
@@ -64,7 +57,9 @@ jobs:
           distribution: 'temurin'
 
       - name: Build for analysis
-        run: ./gradlew assemble --no-daemon || true
+        run: |
+          cd backend && ./gradlew :api:build -x test --no-daemon || true
+          cd frontend && ./gradlew :composeApp:compileKotlinDesktop --no-daemon || true
 
       - name: Perform CodeQL Analysis
         uses: github/codeql-action/analyze@v3