feat(docs): codebase refactor - added src directory

.github/workflows/build-image.yaml

@@ -15,7 +15,7 @@ on:
       context:
         description: "Docker build context path"
         required: false
-        default: "7project/backend"
+        default: "7project/src/backend"
         type: string
       pr_number:
         description: "PR number (required when mode=pr)"

.github/workflows/deploy-pr.yaml

@@ -21,7 +21,7 @@ jobs:
     with:
       mode: pr
       image_repo: lukastrkan/cc-app-demo
-      context: 7project/backend
+      context: 7project/src/backend
       pr_number: ${{ github.event.pull_request.number }}
     secrets: inherit
 
@@ -90,9 +90,9 @@ jobs:
           PR=${{ github.event.pull_request.number }}
           RELEASE=myapp-pr-$PR
           NAMESPACE=pr-$PR
-          helm upgrade --install "$RELEASE" ./7project/charts/myapp-chart \
+          helm upgrade --install "$RELEASE" ./7project/src/charts/myapp-chart \
             -n "$NAMESPACE" --create-namespace \
-            -f 7project/charts/myapp-chart/values-dev.yaml \
+            -f 7project/src/charts/myapp-chart/values-dev.yaml \
             --set prNumber="$PR" \
             --set deployment="pr-$PR" \
             --set domain="$DOMAIN" \

.github/workflows/deploy-prod.yaml

@@ -4,9 +4,9 @@ on:
   push:
     branches: [ "main" ]
     paths:
-      - 7project/backend/**
-      - 7project/frontend/**
-      - 7project/charts/myapp-chart/**
+      - ../../7project/src/backend/**
+      - ../../7project/src/frontend/**
+      - ../../7project/src/charts/myapp-chart/**
       - .github/workflows/deploy-prod.yaml
       - .github/workflows/build-image.yaml
       - .github/workflows/frontend-pages.yml
@@ -32,7 +32,7 @@ jobs:
     with:
       mode: prod
       image_repo: lukastrkan/cc-app-demo
-      context: 7project/backend
+      context: 7project/src/backend
     secrets: inherit
 
   get_urls:
@@ -103,9 +103,9 @@ jobs:
           SMTP_FROM: ${{ secrets.SMTP_FROM }}
           UNIRATE_API_KEY: ${{ secrets.UNIRATE_API_KEY }}
         run: |
-          helm upgrade --install myapp ./7project/charts/myapp-chart \
+          helm upgrade --install myapp ./7project/src/charts/myapp-chart \
             -n prod --create-namespace \
-            -f 7project/charts/myapp-chart/values-prod.yaml \
+            -f 7project/src/charts/myapp-chart/values-prod.yaml \
             --set deployment="prod" \
             --set domain="$DOMAIN" \
             --set domain_scheme="$DOMAIN_SCHEME" \

.github/workflows/frontend-pages.yml

@@ -35,7 +35,7 @@ jobs:
     runs-on: ubuntu-latest
     defaults:
       run:
-        working-directory: 7project/frontend
+        working-directory: 7project/src/frontend
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -45,7 +45,7 @@ jobs:
         with:
           node-version: '20'
           cache: 'npm'
-          cache-dependency-path: 7project/frontend/package-lock.json
+          cache-dependency-path: 7project/src/frontend/package-lock.json
 
       - name: Install dependencies
         run: npm ci
@@ -61,7 +61,7 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: frontend-dist
-          path: 7project/frontend/dist
+          path: 7project/src/frontend/dist
 
   deploy:
     name: Deploy to Cloudflare Pages

.github/workflows/run-tests.yml

@@ -46,21 +46,21 @@ jobs:
 
       - name: Add test dependencies to requirements
         run: |
-          echo "pytest==8.4.2" >> ./7project/backend/requirements.txt
-          echo "pytest-asyncio==1.2.0" >> ./7project/backend/requirements.txt
+          echo "pytest==8.4.2" >> ./7project/src/backend/requirements.txt
+          echo "pytest-asyncio==1.2.0" >> ./7project/src/backend/requirements.txt
 
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -r ./7project/backend/requirements.txt
+          pip install -r ./7project/src/backend/requirements.txt
 
       - name: Run Alembic migrations
         run: |
           alembic upgrade head
-        working-directory: ./7project/backend
+        working-directory: ./7project/src/backend
 
       - name: Run tests with pytest
         env:
           PYTEST_RUN_CONFIG: "True"
         run: pytest
-        working-directory: ./7project/backend
+        working-directory: ./7project/src/backend

.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

7project/.gitignore

@@ -1,8 +1,8 @@
-/tofu/controlplane.yaml
-/tofu/kubeconfig
-/tofu/talosconfig
-/tofu/terraform.tfstate
-/tofu/terraform.tfstate.backup
-/tofu/worker.yaml
-/tofu/.terraform.lock.hcl
-/tofu/.terraform/
+/src/tofu/controlplane.yaml
+/src/tofu/kubeconfig
+/src/tofu/talosconfig
+/src/tofu/terraform.tfstate
+/src/tofu/terraform.tfstate.backup
+/src/tofu/worker.yaml
+/src/tofu/.terraform.lock.hcl
+/src/tofu/.terraform/

7project/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

7project/report.md

@@ -32,7 +32,7 @@ Other services deployed in the cluster includes Longhorn for persistent storage,
 ### High-Level Architecture
 
 ```mermaid
-flowchart LR
+flowchart TB
     n3(("User")) <--> client["Frontend"]
     proc_queue["Message Queue"] --> proc_queue_worker["Worker Service"]
     proc_queue_worker -- SMTP --> ext_mail[("Email Service")]
@@ -61,7 +61,7 @@ The workflow works in the following way:
 - On every push to main, the production app is automatically updated
 - UI is responsive for mobile devices
 - Slow operations (emails, transactions fetching) are handled
-in the background by Celery workers.
+  in the background by Celery workers.
 - App is monitored using prometheus metrics endpoint and metrics are shown in Grafana dashboard.
 
 ### Components
@@ -73,7 +73,8 @@ in the background by Celery workers.
 - Worker service (backend/app/workers): Celery worker handling background tasks (emails, transactions fetching).
 - Database (MariaDB with Maxscale): Persists users, categories, transactions; schema managed by Alembic migrations.
 - Message Queue (RabbitMQ): Queues background tasks for Celery workers.
-- Infrastructure as Code (tofu/): OpenTofu modules provisioning cluster services (RabbitMQ, Redis, Cloudflare tunnel, etc.).
+- Infrastructure as Code (tofu/): OpenTofu modules provisioning cluster services (RabbitMQ, Redis, Cloudflare tunnel,
+  etc.).
 - Deployment Chart (charts/myapp-chart/): Helm chart to deploy the application to Kubernetes.
 
 ### Technologies Used
@@ -165,7 +166,7 @@ You can run the project with Docker Compose and Python virtual environment for t
 
 ```bash
 git clone https://github.com/dat515-2025/Group-8.git
-cd Group-8/7project
+cd Group-8/7project/src
 ```
 
 ### 2) Install dependencies
@@ -416,45 +417,25 @@ tofu apply
     - UNIRATE_API_KEY
 5) On Github open Actions tab, select "Deploy Prod" and run workflow manually
 
-# TODO: REMOVE I guess
-
-2) Deploy the app using Helm
-
-```bash
-# Set the namespace
-kubectl create namespace myapp || true
-
-# Install/upgrade the chart with required values
-helm upgrade --install myapp charts/myapp-chart \
-  -n myapp \
-  -f charts/myapp-chart/values.yaml \
-  --set image.backend.repository=myorg/myapp-backend \
-  --set image.backend.tag=latest \
-  --set env.BACKEND_URL="https://myapp.example.com" \
-  --set env.FRONTEND_URL="https://myapp.example.com" \
-  --set env.SECRET="CHANGE_ME_SECRET"
-```
-
 ## Testing Instructions
 
 The tests are located in 7project/backend/tests directory. All tests are run by GitHub actions on every pull request and
 push to main.
 See the workflow [here](../.github/workflows/run-tests.yml).
 
-If you want to run the tests locally, the preferred is to use a [bash script](backend/test-with-ephemeral-mariadb.sh)
-that will start a [test DB container](backend/docker-compose.test.yml) and remove it afterward.
-
+If you want to run the tests locally, the preferred way is to use a [bash script](src/backend/test_locally.sh)
+that will start a test DB container with [docker compose](src/backend/docker-compose.test.yml)  and remove it afterwards.
 ```bash
 cd 7project/backend 
-bash test-with-ephemeral-mariadb.sh
+bash test_locally.sh
 ```
 
 ### Unit Tests
 
-There are only 5 basic unit tests, since our services logic is very simple
+There are 5 basic unit tests, since our services logic is very simple
 
 ```bash
-bash test-with-ephemeral-mariadb.sh --only-unit
+bash test_locally.sh --only-unit
 ```
 
 ### Integration Tests
@@ -462,7 +443,7 @@ bash test-with-ephemeral-mariadb.sh --only-unit
 There are 9 basic unit tests, testing the individual backend API logic
 
 ```bash
-bash test-with-ephemeral-mariadb.sh --only-integration
+bash test_locally.sh --only-integration
 ```
 
 ### End-to-End Tests
@@ -470,7 +451,7 @@ bash test-with-ephemeral-mariadb.sh --only-integration
 There are 7 e2e tests, testing more complex app logic
 
 ```bash
-bash test-with-ephemeral-mariadb.sh --only-e2e
+bash test_locally.sh --only-e2e
 ```
 
 ## Usage Examples
@@ -598,18 +579,22 @@ curl -H "Authorization: Bearer $TOKEN" http://127.0.0.1:8000/authenticated-route
 
 ### Dejan
 
-| Date            | Activity             | Hours  | Description                                                   |
-|-----------------|----------------------|--------|---------------------------------------------------------------|
-| 25.9.           | Design               | 2      | 6design                                                       |
-| 9.10 to 11.10.  | Backend APIs         | 12     | Implemented Backend APIs                                      |
-| 13.10 to 15.10. | Frontend Development | 8      | Created user interface mockups                                |
-| Continually     | Documentation        | 6      | Documenting the dev process                                   |
-| 21.10 to 23.10  | Tests, frontend      | 10     | Test basics, balance charts, and frontend improvement         |
-| 28.10 to 30.10  | CI                   | 6      | Integrated tests with test database setup on github workflows |
-| 28.10 to 30.10  | Frontend             | 7      | UI improvements and exchange rate API integration             |
-| 4.11 to 6.11    | Tests                | 6      | Test fixes improvement, more integration and e2e              |
-| 4.11 to 6.11    | Frontend             | 6      | Fixes, Improved UI, added support for mobile devices          |
-| **Total**       |                      | **63** |                                                               |
+| Date            | Activity                 | Hours  | Description                                                   | Representative Commit / PR                               |
+|:----------------|:-------------------------|:-------|:--------------------------------------------------------------|:---------------------------------------------------------|
+| 25.9.           | Design                   | 2      | 6design                                                       |                                                          |
+| 9.10 to 11.10.  | Backend APIs             | 14     | Implemented Backend APIs                                      | `PR #26`, `20-create-a-controller-layer-on-backend-side` |
+| 13.10 to 15.10. | Frontend Development     | 8      | Created user interface mockups                                | `PR #28`, `frontend basics`                              |
+| Continually     | Documentation            | 8      | Documenting the dev process                                   |                                                          |
+| 21.10 to 23.10  | Tests, frontend          | 10     | Test basics, balance charts, and frontend improvement         | `PR #31`, `30 create tests and set up a GitHub pipeline` |
+| 28.10 to 30.10  | CI                       | 6      | Integrated tests with test database setup on github workflows | `PR #28`, `frontend basics`                              |
+| 28.10 to 30.10  | Frontend                 | 8      | UI improvements and exchange rate API integration             | `PR #28`, `frontend basics`                              |
+| 4.11 to 6.11    | Tests                    | 6      | Test fixes improvement, more integration and e2e              | `PR #28`, `frontend basics`                              |
+| 4.11 to 6.11    | Frontend                 | 6      | Fixes, Improved UI, added support for mobile devices          | `PR #28`, `frontend basics`                              |
+| 11.11           | Backend APIs             | 4      | Moved rates API, mock bank to Backend, few fixes              | `PR #28`, `frontend basics`                              |
+| 11.11 to 12.11  | Tests                    | 3      | Local testing DB container, few fixes                         | `PR #28`, `frontend basics`                              |
+| 12.11           | Frontend                 | 3      | Enabled multiple transaction edits at once, CSAS button state | `PR #28`, `frontend basics`                              |
+| 13.11           | Video                    | 3      | Video                                                         |                                                          |
+| **Total**       |                          | **81** |                                                               |                                                          |
 
 ### Group Total: [XXX.X] hours
 
@@ -627,7 +612,11 @@ curl -H "Authorization: Bearer $TOKEN" http://127.0.0.1:8000/authenticated-route
 
 This was caused by single SATA SSD disk running all VMs. This was solved by adding second NVMe disk just for Talos VMs.
 
-[Describe the main challenges and how you overcame them]
+#### Stucked IaC deployment
+
+If the deployed module (helm chart for example) was not configured properly, it would get stuck and timeout resulting in
+namespace that cannot be deleted.
+This was solved by using snapshots in Proxmox and restoring if this happened.
 
 ### If We Did This Again
 
@@ -654,7 +643,11 @@ used not only by myself.
 
 [Personal reflection on growth, challenges, and learning]
 
-#### [Team Member 2 Name]
+#### [Dejan]
+Since I do not have a job, this project was probably the most complex one I have ever worked on. 
+It was also the first school project where I was encouraged to use AI.
+
+Lukas 
 
 [Personal reflection on growth, challenges, and learning]
 

7project/src/backend/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

7project/src/backend/test_locally.sh

@@ -4,13 +4,13 @@ set -euo pipefail
 # Run tests against a disposable local MariaDB on host port 3307 using Docker Compose.
 # Requirements: Docker, docker compose plugin, Python, Alembic, pytest.
 # Usage:
-#   chmod +x ./test-with-ephemeral-mariadb.sh
+#   chmod +x ./test_locally.sh
 #   # From 7project/backend directory
-#   ./test-with-ephemeral-mariadb.sh [--only-unit|--only-integration|--only-e2e] [pytest-args...]
+#   ./test_locally.sh [--only-unit|--only-integration|--only-e2e] [pytest-args...]
 #   # Examples:
-#   ./test-with-ephemeral-mariadb.sh --only-unit -q
-#   ./test-with-ephemeral-mariadb.sh --only-integration -k "login"
-#   ./test-with-ephemeral-mariadb.sh --only-e2e -vv
+#   ./test_locally.sh --only-unit -q
+#   ./test_locally.sh --only-integration -k "login"
+#   ./test_locally.sh --only-e2e -vv
 #
 # This script will:
 # 1) Start a MariaDB 11.4 container (ephemeral storage, port 3307)