From ee25c75829812f1184b63af5e46844c11f3c9d1a Mon Sep 17 00:00:00 2001
From: khyeonm <lamb122@pusan.ac.kr>
Date: Sun, 8 Jun 2025 09:09:41 +0900
Subject: [PATCH] Refactor(docker): add essential comments

---
 README.md                                |  1 +
 docker-compose.yml                       | 11 ++++++-----
 frontend/spec-trackr-app/sta.dockerfile  | 14 ++++++++++++++
 frontend/spectrackr-main/main.dockerfile | 14 ++++++++++++++
 4 files changed, 35 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index aaac96a7a..ad993f019 100644
--- a/README.md
+++ b/README.md
@@ -59,6 +59,7 @@ _"폭넓은 가능성 속에서, 각자의 길을 찾고 준비할 수 있도록
 
 ## 🚀 사용자 가이드
 ```bash
+# docker 사용가능 환경에서 실행
 # 2025_Advanced_Programming 디렉토리에서 아래 명령어 실행
 docker compose up
 # 브라우저에서 아래 URL 접속
diff --git a/docker-compose.yml b/docker-compose.yml
index 7ba29a300..5be49508a 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -6,7 +6,7 @@ services:
     ports:
       - "3001:3001"  # 고정 포트 매핑
     networks:
-      - spec-net
+      - spec-net  # spec-net 네트워크에 연결
 
   spectrackr-main:
     build: 
@@ -15,10 +15,11 @@ services:
     ports:
       - "3003:3003"  # 고정 포트 매핑
     networks:
-      - spec-net
+      - spec-net  # spec-net 네트워크에 연결
     depends_on:
-      - spec-trackr
-
+      - spec-trackr  # spec-trackr 서비스가 먼저 시작되어야 함
 networks:
   spec-net:
-    driver: bridge
\ No newline at end of file
+    driver: bridge
+
+    
\ No newline at end of file
diff --git a/frontend/spec-trackr-app/sta.dockerfile b/frontend/spec-trackr-app/sta.dockerfile
index cab0a8d00..958fc91bb 100644
--- a/frontend/spec-trackr-app/sta.dockerfile
+++ b/frontend/spec-trackr-app/sta.dockerfile
@@ -1,8 +1,22 @@
 FROM node:18-alpine
+
+# 작업 디렉토리를 /app으로 설정
 WORKDIR /app
+
+# package.json과 package-lock.json 파일을 컨테이너로 복사
 COPY package*.json ./
+
+# 의존성 설치
 RUN npm install
+
+# 모든 파일을 컨테이너로 복사
 COPY . .
+
+# 환경 변수 설정: 브라우저 자동 실행 방지
 ENV HOST=0.0.0.0 BROWSER=none PORT=3001
+
+# 컨테이너 외부에 노출할 포트 지정
 EXPOSE 3001
+
+# 서버 실행
 CMD ["npm", "start"]
diff --git a/frontend/spectrackr-main/main.dockerfile b/frontend/spectrackr-main/main.dockerfile
index c0aa62c30..2516835a9 100644
--- a/frontend/spectrackr-main/main.dockerfile
+++ b/frontend/spectrackr-main/main.dockerfile
@@ -1,8 +1,22 @@
 FROM node:18-alpine
+
+# 작업 디렉토리를 /app으로 설정
 WORKDIR /app
+
+# package.json과 package-lock.json 파일을 컨테이너로 복사
 COPY package*.json ./
+
+# 의존성 설치
 RUN npm install
+
+# 나머지 모든 파일을 컨테이너로 복사
 COPY . .
+
+# 환경 변수 설정
 ENV HOST=0.0.0.0 PORT=3003
+
+# 컨테이너 외부에 노출할 포트 지정
 EXPOSE 3003
+
+# 서버 실행
 CMD ["npm", "run", "dev"]