Merge pull request #58 from AET-DevOps25/57-server-implement-course-service-api-crud-enrollments-bookmarks

feat(server): implement course service API (CRUD, enrollments, bookmarks) and add gateway-based rate limiting & authorization

Author: GravityDarkLab

.env.dev.example .env.example.env.dev.example renamed to .env.example

@@ -15,5 +15,12 @@ runs:
         # JWT (used by user-service tests)
         JWT_SECRET=test-secret
         JWT_EXPIRATION_MS=3600000
+
+        # MongoDB (for all services)
+        MONGO_URL=mongodb://localhost:27017/test
+
+        # Redis (for gateway)
+        REDIS_HOST=redis
+        REDIS_PORT=6379
         EOF
         echo "✅ Generated .env:" && cat .env

.github/actions/create-dotenv/action.yml

@@ -2,10 +2,11 @@ name: Build and Test Client
 
 on:
   push:
+    branches: [main, test, dev]
     paths:
       - 'client/**'
   pull_request:
-    branches: [main]
+    branches: [main, test, dev]
     paths:
       - 'client/**'
   workflow_dispatch:

.github/workflows/build-and-test-client.yml

@@ -2,9 +2,11 @@ name: Build, Lint & Test the GenAI Service
 
 on:
   push:
+    branches: [main, test, dev]
     paths:
       - 'genai/**'
   pull_request:
+    branches: [main, test, dev]
     paths:
       - 'genai/**'
   workflow_dispatch:

.github/workflows/build-and-test-genai.yml

@@ -2,14 +2,17 @@ name: Build and Test Server
 
 on:
   push:
+    branches: [main, test, dev]
     paths:
       - 'server/skillforge-gateway/**'
       - 'server/skillforge-user/**'
+      - 'server/skillforge-course/**'
   pull_request:
-    branches: [main]
+    branches: [main, test, dev]
     paths:
       - 'server/skillforge-gateway/**'
       - 'server/skillforge-user/**'
+      - 'server/skillforge-course/**'
   workflow_dispatch:
 
 permissions:
@@ -19,6 +22,11 @@ jobs:
   test-gateway:
     name: Build & Test Gateway
     runs-on: ubuntu-latest
+    services:
+      redis:
+        image: redis:7-alpine
+        ports:
+          - 6379:6379
     defaults:
       run:
         working-directory: server/skillforge-gateway
@@ -33,12 +41,27 @@ jobs:
       - uses: ./.github/actions/create-dotenv
       - name: Build and test
         env:
-          SPRING_PROFILE_ACTIVES: test
-        run: ./gradlew build --no-daemon
-  
+          SPRING_PROFILES_ACTIVE: test
+          REDIS_HOST: redis
+          REDIS_PORT: 6379
+        run: ./gradlew build --no-daemon --scan
+      - name: Post workflow summary
+        if: always()
+        run: |
+          echo "## Workflow Summary" >> $GITHUB_STEP_SUMMARY
+          echo "- Status: ${{ job.status }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Commit: ${{ github.sha }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Branch: ${{ github.ref }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Run: [View logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }})" >> $GITHUB_STEP_SUMMARY
+
   test-user-service:
     name: Build & Test User Service
     runs-on: ubuntu-latest
+    services:
+      mongo:
+        image: mongo:7
+        ports:
+          - 27017:27017
     defaults:
       run:
         working-directory: server/skillforge-user
@@ -53,5 +76,50 @@ jobs:
       - uses: ./.github/actions/create-dotenv
       - name: Build and test
         env:
-          SPRING_PROFILE_ACTIVES: test
-        run: ./gradlew build --no-daemon
+          SPRING_PROFILES_ACTIVE: test
+          JWT_SECRET: test-jwt-secret
+          JWT_EXPIRATION_MS: 3600000
+          MONGO_URL: mongodb://localhost:27017/test
+        run: ./gradlew build --no-daemon --scan
+      - name: Post workflow summary
+        if: always()
+        run: |
+          echo "## Workflow Summary" >> $GITHUB_STEP_SUMMARY
+          echo "- Status: ${{ job.status }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Commit: ${{ github.sha }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Branch: ${{ github.ref }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Run: [View logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }})" >> $GITHUB_STEP_SUMMARY
+
+  test-course-service:
+    name: Build & Test Course Service
+    runs-on: ubuntu-latest
+    services:
+      mongo:
+        image: mongo:7
+        ports:
+          - 27017:27017
+    defaults:
+      run:
+        working-directory: server/skillforge-course
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: 'gradle'
+      - uses: ./.github/actions/create-dotenv
+      - name: Build and test
+        env:
+          SPRING_PROFILES_ACTIVE: test
+          MONGO_URL: mongodb://localhost:27017/test
+        run: ./gradlew build --no-daemon --scan
+      - name: Post workflow summary
+        if: always()
+        run: |
+          echo "## Workflow Summary" >> $GITHUB_STEP_SUMMARY
+          echo "- Status: ${{ job.status }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Commit: ${{ github.sha }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Branch: ${{ github.ref }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Run: [View logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }})" >> $GITHUB_STEP_SUMMARY

.github/workflows/build-and-test-server.yml

@@ -2,18 +2,20 @@ name: Build and Push Docker Images
 
 on:
   push:
-    branches: [main, test]
+    branches: [main, test, dev]
     paths:
       - 'client/**'
       - 'server/skillforge-gateway/**'
       - 'server/skillforge-user/**'
+      - 'server/skillforge-course/**'
       - 'genai/**'
   pull_request:
-    branches: [main, test]
+    branches: [main, test, dev]
     paths:
       - 'client/**'
       - 'server/skillforge-gateway/**'
       - 'server/skillforge-user/**'
+      - 'server/skillforge-course/**'
       - 'genai/**'
   workflow_dispatch:
   workflow_call:
@@ -28,9 +30,6 @@ env:
 jobs:
   build-and-push:
     name: ${{ matrix.name }}
-    environment: 
-      name: AWS
-    
     runs-on: ubuntu-latest
     strategy:
       matrix:
@@ -53,12 +52,14 @@ jobs:
             path: server/skillforge-gateway
             image: server-gateway
             name: Build and Push Server Gateway
-            build-args: ""
           - id: user-service
             path: server/skillforge-user
             image: user-service
             name: Build and Push User Service
-            build-args: ""
+          - id: course-service
+            path: server/skillforge-course
+            image: course-service
+            name: Build and Push Course Service
           - id: genai
             path: genai
             image: genai
@@ -116,7 +117,6 @@ jobs:
             ${{ matrix.build-args }}
             VITE_APP_VERSION=${{ steps.extract_version.outputs.version }}
 
-
       - name: Clean up dangling images
         run: |
           docker image prune -f
@@ -127,3 +127,12 @@ jobs:
       - name: Output image URL
         run: |
           echo "Image URL: ghcr.io/aet-devops25/team-git-it-together/${{ matrix.image }}:${{ steps.set_tag.outputs.tag }}"
+      - name: Post workflow summary
+        if: always()
+        run: |
+          echo "## Docker Build & Push Summary" >> $GITHUB_STEP_SUMMARY
+          echo "- Status: ${{ job.status }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Commit: ${{ github.sha }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Branch: ${{ github.ref }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Image: ghcr.io/aet-devops25/team-git-it-together/${{ matrix.image }}:${{ steps.set_tag.outputs.tag }}" >> $GITHUB_STEP_SUMMARY
+          echo "- Run: [View logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }})" >> $GITHUB_STEP_SUMMARY

.github/workflows/docker-build-push.yml

@@ -22,6 +22,9 @@ npm-debug.log
 testem.log
 typings/
 .angular/
+# Ignore seed courses folder
+seed/seed_courses/
+
 
 # e2e
 e2e/*.js

.gitignore

@@ -1,5 +1,5 @@
 # Nginx config – rendered at runtime via envsubst
-# `${API_INTERNAL_HOST}` is replaced with the environment variable value when the
+# `${VITE_API_INTERNAL_HOST}` is replaced with the environment variable value when the
 # container starts (handled automatically by the nginx docker-entrypoint).
 
 # in server_name, we use "_" to catch all.

client/nginx.conf.template

@@ -16,22 +16,26 @@ interface AuthContextType {
     username?: string;
     password: string;
     rememberMe: boolean;
-  }) => Promise<void>;
+  }) => Promise<UserLoginResponse>;
   logout: () => void;
   register: (opts: {
     firstName: string;
     lastName: string;
     username: string;
     email: string;
     password: string;
-  }) => Promise<void>;
+  }) => Promise<UserLoginResponse>;
 }
 
 export const AuthContext = createContext<AuthContextType>({
   user: null,
   token: null,
   loading: true,
-  login: async () => {},
-  register: async () => {},
+  login: async () => {
+    throw new Error('Login function not implemented. Make sure to wrap your app in AuthProvider.');
+  },
+  register: async () => {
+    throw new Error('Register function not implemented. Make sure to wrap your app in AuthProvider.');
+  },
   logout: () => {},
 });

client/src/contexts/AuthContext.tsx

@@ -36,7 +36,7 @@ export function AuthProvider({ children }: { children: ReactNode }) {
     username?: string;
     password: string;
     rememberMe: boolean;
-  }) => {
+  }): Promise<UserLoginResponse> => {
     // Extract rememberMe separately; build a proper LoginPayload for userService.login
     const { email = '', username = '', password, rememberMe } = opts;
     const payload: LoginPayload = { email, username, password };
@@ -46,6 +46,7 @@ export function AuthProvider({ children }: { children: ReactNode }) {
     // response.jwtToken must exist, and response carries whatever user fields your backend returns
     persistAuth(response.jwtToken, response, rememberMe);
     navigate('/dashboard');
+    return response;
   };
 
   // Register function to register a new user
@@ -55,7 +56,7 @@ export function AuthProvider({ children }: { children: ReactNode }) {
     username: string;
     email: string;
     password: string;
-  }) => {
+  }): Promise<UserLoginResponse> => {
     const { firstName, lastName, username, email, password } = opts;
     // Call the userService.register method
     const response = await userService.register({
@@ -74,11 +75,14 @@ export function AuthProvider({ children }: { children: ReactNode }) {
         username: response.username,
         password, // Use the same password for login
       };
-      await login({
+      // The login function returns the user payload, so we can return it from here.
+      return login({
         ...loginPayload,
-        rememberMe: true,
+        rememberMe: true, // Auto-remember on register
       });
     }
+    // This path should not be reached if userService.register throws on failure, but as a safeguard:
+    throw new Error('Registration failed: server did not return a valid user.');
   };
 
   const logout = () => {