Update CI workflows to use Maven wrapper for consistency and improve npm dependency installation logic; enhance progress tracking documentation

.gitea/workflows/api-docs.yml

@@ -44,7 +44,12 @@ jobs:
           ${{ runner.os }}-node-
         
     - name: Install dependencies
-      run: npm ci
+      run: |
+        if [ -f package-lock.json ]; then
+          npm ci
+        else
+          npm install
+        fi
       
     - name: Run linting
       run: |
@@ -106,7 +111,12 @@ jobs:
           ${{ runner.os }}-node-
         
     - name: Install dependencies
-      run: npm ci
+      run: |
+        if [ -f package-lock.json ]; then
+          npm ci
+        else
+          npm install
+        fi
       
     - name: Build application
       run: npm run build

.gitea/workflows/api-gateway.yml

@@ -34,6 +34,10 @@ jobs:
       with:
         java-version: ${{ matrix.java-version }}
         distribution: 'temurin'
+        cache: maven
+        
+    - name: Verify Maven installation
+      run: ./mvnw --version
         
     - name: Cache Maven dependencies
       uses: actions/cache@v4
@@ -45,13 +49,13 @@ jobs:
           ${{ runner.os }}-m2-
         
     - name: Validate POM
-      run: mvn validate
+      run: ./mvnw validate
         
     - name: Compile code
-      run: mvn compile
+      run: ./mvnw compile
       
     - name: Run unit tests
-      run: mvn test
+      run: ./mvnw test
       
     - name: Generate test report
       uses: dorny/test-reporter@v1
@@ -63,12 +67,12 @@ jobs:
         
     - name: Run code quality checks
       run: |
-        mvn spotbugs:check
-        mvn checkstyle:check
-        mvn pmd:check
+        ./mvnw spotbugs:check
+        ./mvnw checkstyle:check
+        ./mvnw pmd:check
         
     - name: Generate code coverage
-      run: mvn jacoco:report
+      run: ./mvnw jacoco:report
       
     - name: Upload coverage to Codecov
       uses: codecov/codecov-action@v3
@@ -93,6 +97,10 @@ jobs:
       with:
         java-version: '17'
         distribution: 'temurin'
+        cache: maven
+        
+    - name: Verify Maven installation
+      run: ./mvnw --version
         
     - name: Cache Maven dependencies
       uses: actions/cache@v4
@@ -102,7 +110,7 @@ jobs:
         restore-keys: ${{ runner.os }}-m2
         
     - name: Build application
-      run: mvn clean package -DskipTests
+      run: ./mvnw clean package -DskipTests
       
     - name: Build Docker image (test only)
       run: docker build -t api-gateway:test .

.gitea/workflows/ci.yml

@@ -123,7 +123,12 @@ jobs:
           ${{ runner.os }}-node-
         
     - name: Install dependencies
-      run: npm ci
+      run: |
+        if [ -f package-lock.json ]; then
+          npm ci
+        else
+          npm install
+        fi
       
     - name: Run linting
       run: npm run lint
@@ -163,7 +168,12 @@ jobs:
           ${{ runner.os }}-node-
         
     - name: Install dependencies
-      run: npm ci
+      run: |
+        if [ -f package-lock.json ]; then
+          npm ci
+        else
+          npm install
+        fi
       
     - name: Run linting
       run: npm run lint

.gitea/workflows/frontend.yml

@@ -44,7 +44,12 @@ jobs:
           ${{ runner.os }}-node-
         
     - name: Install dependencies
-      run: npm ci
+      run: |
+        if [ -f package-lock.json ]; then
+          npm ci
+        else
+          npm install
+        fi
       
     - name: Run linting
       run: |
@@ -106,7 +111,12 @@ jobs:
           ${{ runner.os }}-node-
         
     - name: Install dependencies
-      run: npm ci
+      run: |
+        if [ -f package-lock.json ]; then
+          npm ci
+        else
+          npm install
+        fi
       
     - name: Build application
       run: |