# limjiajing123/portfolio_instance_only architecture

> Architecture diagram of the GitHub repository limjiajing123/portfolio_instance_only, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/limjiajing123/portfolio_instance_only
- Repository: https://github.com/limjiajing123/portfolio_instance_only

## Overview

##### Project type and purpose
- This is a full-stack personal portfolio web application (“portfolio_instance_only”).
- Frontend: React app (components, assets, CSS, build output) served via Nginx.
- Backend: Node.js service (server.js, Express endpoints, Redis integration, data modules).
- Infrastructure: Docker Compose for local/pre-prod, Terraform + AWS (ECR/ECS) for production.
- CI/CD: GitHub Actions workflows (ci-preprod, deploy).

##### File structure
- Top-level:
- .github/workflows: CI and deploy pipelines.
- docker-compose.yml/docker-compose.preprod.yml: local and pre-prod multi-container setup.
- terraform-aws/: IaC (provider, ECR registry, ECS cluster/services, task definitions).
- backend/: Node.js service code, Dockerfile, Redis client, mock data, package files.
- frontend/: React source (src/), public assets, built artifacts (build/), Dockerfile, nginx.conf.
- tests/: Python smoke and unit tests for frontend & backend.
- Architectural signals:
- Clear separation of UI (React/Nginx) and API (Node.js).
- Redis as a caching or session store.
- Docker Compose orchestrates three containers (frontend, backend, redis).
- Terraform drives cloud deployment on AWS ECS Fargate, with container tasks and ECR registry.

##### README
- Minimal content (“portfolio_instance_only”) but file tree reveals tech stack and infra approach.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User Client
    Browser["Client Browser"]:::external

    %% Local/Preprod Environment
    subgraph "Local / Pre-Prod (Docker Compose)" 
        direction TB
        FrontendContainer["Frontend Container\n(Nginx + React)"]:::frontend
        BackendContainer["Backend Container\n(Node.js + Express)"]:::backend
        RedisContainer["Redis Container"]:::db
    end

    %% AWS Cloud Environment
    subgraph "AWS Cloud" 
        direction TB
        ECR["ECR (Docker Image Registry)"]:::infra
        ECSCluster["ECS Cluster"]:::infra
        ECSServiceFE["Frontend Service (Fargate Task)"]:::frontend
        ECSServiceBE["Backend Service (Fargate Task)"]:::backend
    end

    %% CI/CD
    subgraph "CI/CD (GitHub Actions)" 
        direction TB
        CI["CI Pipeline\n(.github/workflows/ci-preprod.yml)"]:::ci
        CD["Deploy Pipeline\n(.github/workflows/deploy.yml)"]:::ci
    end

    %% IaC
    Terraform["Terraform IaC\n(terraform-aws/)"]:::infra

    %% Connections
    Browser -->|"HTTP/S Port 80"| FrontendContainer
    FrontendContainer -->|"AJAX/REST"| BackendContainer
    BackendContainer -->|"Redis Client"| RedisContainer

    CI -->|"Run Docker Compose"| FrontendContainer
    CI -->|"Run Docker Compose"| BackendContainer
    CI -->|"Run Docker Compose"| RedisContainer

    CD -->|"Build & Push Images"| ECR
    CD -->|"Trigger Terraform Apply"| Terraform
    Terraform -->|"Provision"| ECR
    Terraform -->|"Provision"| ECSCluster
    Terraform -->|"Provision Tasks & Services"| ECSServiceFE
    Terraform -->|"Provision Tasks & Services"| ECSServiceBE
    ECSCluster --> ECSServiceFE
    ECSCluster --> ECSServiceBE
    ECSServiceFE -->|"HTTP/S"| FrontendContainer
    ECSServiceBE -->|"API"| BackendContainer
    ECSServiceBE -->|"Redis"| RedisContainer

    %% Click Events - Frontend
    click FrontendContainer "https://github.com/limjiajing123/portfolio_instance_only/tree/main/frontend/"
    click FrontendContainer "https://github.com/limjiajing123/portfolio_instance_only/tree/main/frontend/Dockerfile"
    click FrontendContainer "https://github.com/limjiajing123/portfolio_instance_only/blob/main/frontend/nginx.conf"
    click FrontendContainer "https://github.com/limjiajing123/portfolio_instance_only/tree/main/frontend/build/"
    click FrontendContainer "https://github.com/limjiajing123/portfolio_instance_only/blob/main/frontend/frontend-task.json"

    %% Click Events - Backend
    click BackendContainer "https://github.com/limjiajing123/portfolio_instance_only/tree/main/backend/"
    click BackendContainer "https://github.com/limjiajing123/portfolio_instance_only/tree/main/backend/Dockerfile"
    click BackendContainer "https://github.com/limjiajing123/portfolio_instance_only/blob/main/backend/server.js"
    click BackendContainer "https://github.com/limjiajing123/portfolio_instance_only/blob/main/backend/redis.js"
    click BackendContainer "https://github.com/limjiajing123/portfolio_instance_only/blob/main/backend/axiosMock.js"
    click BackendContainer "https://github.com/limjiajing123/portfolio_instance_only/blob/main/backend/portfolioKnowledge.js"
    click BackendContainer "https://github.com/limjiajing123/portfolio_instance_only/blob/main/backend/package.json"
    click BackendContainer "https://github.com/limjiajing123/portfolio_instance_only/blob/main/backend/backend-task.json"

    %% Click Events - Docker Compose
    click CI "https://github.com/limjiajing123/portfolio_instance_only/blob/main/docker-compose.yml"
    click CI "https://github.com/limjiajing123/portfolio_instance_only/blob/main/docker-compose.preprod.yml"

    %% Click Events - Terraform
    click Terraform "https://github.com/limjiajing123/portfolio_instance_only/blob/main/terraform-aws/provider.tf"
    click Terraform "https://github.com/limjiajing123/portfolio_instance_only/blob/main/terraform-aws/ecr.tf"
    click Terraform "https://github.com/limjiajing123/portfolio_instance_only/blob/main/terraform-aws/ecs.tf"
    click Terraform "https://github.com/limjiajing123/portfolio_instance_only/blob/main/terraform-aws/ecs_services.tf"
    click Terraform "https://github.com/limjiajing123/portfolio_instance_only/blob/main/terraform-aws/task_definitions.tf"

    %% Click Events - CI/CD
    click CI "https://github.com/limjiajing123/portfolio_instance_only/blob/main/.github/workflows/ci-preprod.yml"
    click CD "https://github.com/limjiajing123/portfolio_instance_only/blob/main/.github/workflows/deploy.yml"

    %% Click Events - Tests
    click CI "https://github.com/limjiajing123/portfolio_instance_only/blob/main/tests/smoke_test.py"
    click CI "https://github.com/limjiajing123/portfolio_instance_only/blob/main/tests/test_backend.py"
    click CI "https://github.com/limjiajing123/portfolio_instance_only/blob/main/tests/test_frontend.py"

    %% Styles
    classDef external fill:#D9EAD3,stroke:#6AA84F,color:#274E13
    classDef frontend fill:#B3D4FC,stroke:#3C78D8,color:#073763
    classDef backend fill:#C8E6C9,stroke:#6AA84F,color:#274E13
    classDef db fill:#F4CCCC,stroke:#CC0000,color:#660000
    classDef infra fill:#FFF2CC,stroke:#E69138,color:#7F6000
    classDef ci fill:#D9D2E9,stroke:#8E7CC3,color:#4B3869
```
