Merge pull request #331 from Pseudo-Lab/feat/platform

feat(platform): setup devfactory homepage and workflow

Author: soohyunme

.github/workflows/devfactory-homepage.yml

@@ -0,0 +1,43 @@
+name: 🚀 DevFactory Homepage Deploy
+run-name: 🚀 Deploying to Production by @${{ github.actor }}
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'platform/**'
+      - '.github/workflows/devfactory-homepage.yml'
+  workflow_dispatch:
+
+# 같은 브랜치 동시 실행 시 이전 잡 취소(경쟁 배포 방지)
+concurrency:
+  group: DevFactory-homepage-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  deploy-prod:
+    if: github.ref_name == 'main'
+    name: 🚀 Deploy DF-platform (Production)
+    runs-on: oracle
+    environment: platform
+    defaults:
+      run:
+        working-directory: ./platform
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Write .env (prod)
+        run: |
+          cat > .env <<'EOF'
+          APP_HOST=${{ vars.APP_HOST }}
+          DATABASE_URL=${{ secrets.DATABASE_URL }}
+          EOF
+
+      - name: Build & up (prod)
+        run: |
+          set -euxo pipefail
+          docker compose -p df-platform-main config -q
+          docker compose -p df-platform-main down --remove-orphans
+          docker compose -p df-platform-main up -d --build --remove-orphans
+          docker image prune -f --filter "label=org.pseudolab.project=devfactory-platform"

README.en.md

@@ -65,7 +65,7 @@ Highlight activities of DevFactory 🤗
   <tr>
     <td align="center" width="200" valign="top">
       <b>Soohyun Kim</b><br>
-      <img src="docs/imgs/members/soohyun.png" height="180px"><br>
+      <img src="platform/frontend/public/members/soohyun.png" height="180px"><br>
       <img src="https://img.shields.io/badge/-Builder-3776AB">
       <img src="https://img.shields.io/badge/-TPM-94A3B8">
       <img src="https://img.shields.io/badge/-INFRA-94A3B8"><br>
@@ -76,7 +76,7 @@ Highlight activities of DevFactory 🤗
     </td>
     <td align="center" width="200" valign="top">
       <b>Yesin Kim</b><br>
-      <img src="docs/imgs/members/yesin.jpg" height="180px"><br>
+      <img src="platform/frontend/public/members/yesin.jpg" height="180px"><br>
       <img src="https://img.shields.io/badge/-Builder-3776AB">
       <img src="https://img.shields.io/badge/-BE-0891B2"><br>
       <img src="https://img.shields.io/badge/-10th-DAA520">
@@ -86,7 +86,7 @@ Highlight activities of DevFactory 🤗
     </td>
     <td align="center" width="200" valign="top">
       <b>Seungkyu Kim</b><br>
-      <img src="docs/imgs/members/seungkyu.jpg" height="180px"><br>
+      <img src="platform/frontend/public/members/seungkyu.jpg" height="180px"><br>
       <img src="https://img.shields.io/badge/-Builder-3776AB">
       <img src="https://img.shields.io/badge/-FE-60A5FA"><br>
       <img src="https://img.shields.io/badge/-10th-DAA520">

README.md

@@ -33,7 +33,7 @@
 ## 🌟 프로젝트
 DevFactory의 주요 활동 내역입니다 🤗
 *   **🐳 기술 튜토리얼 (Tutorials)**
-    *   Docker, Git, LLM 등 실습 중심의 콘텐츠와 오프라인 워크숍을 운영합니다.
+    *   Docker, Git, LLM 등 실습 중심의 온라인 콘텐츠와 오프라인 워크숍을 운영합니다.
     *   [🔗 튜토리얼 보기](https://pseudo-lab.github.io/DevFactory/intro.html)
 
 *   **🎮 네트워킹 프로그램 (BINGO)**
@@ -60,7 +60,7 @@ DevFactory의 주요 활동 내역입니다 🤗
   <tr>
     <td align="center" width="200" valign="top">
       <b>김수현</b><br>
-      <img src="docs/imgs/members/soohyun.png" height="180px"><br>
+      <img src="platform/frontend/public/members/soohyun.png" height="180px"><br>
       <img src="https://img.shields.io/badge/-Builder-3776AB">
       <img src="https://img.shields.io/badge/-TPM-94A3B8">
       <img src="https://img.shields.io/badge/-INFRA-94A3B8"><br>
@@ -71,7 +71,7 @@ DevFactory의 주요 활동 내역입니다 🤗
     </td>
     <td align="center" width="200" valign="top">
       <b>김예신</b><br>
-      <img src="docs/imgs/members/yesin.jpg" height="180px"><br>
+      <img src="platform/frontend/public/members/yesin.jpg" height="180px"><br>
       <img src="https://img.shields.io/badge/-Builder-3776AB">
       <img src="https://img.shields.io/badge/-BE-0891B2"><br>
       <img src="https://img.shields.io/badge/-10th-DAA520">
@@ -81,7 +81,7 @@ DevFactory의 주요 활동 내역입니다 🤗
     </td>
     <td align="center" width="200" valign="top">
       <b>김승규</b><br>
-      <img src="docs/imgs/members/seungkyu.jpg" height="180px"><br>
+      <img src="platform/frontend/public/members/seungkyu.jpg" height="180px"><br>
       <img src="https://img.shields.io/badge/-Builder-3776AB">
       <img src="https://img.shields.io/badge/-FE-60A5FA"><br>
       <img src="https://img.shields.io/badge/-10th-DAA520">

platform/.env.example

@@ -0,0 +1,5 @@
+# Domain Setting
+APP_HOST=your-domain.com
+
+# Database Setting
+DATABASE_URL=postgresql://user:pass@devfactory-postgres:5432/dbname

platform/.gitignore

@@ -0,0 +1,5 @@
+.env
+node_modules/
+dist/
+build/
+.DS_Store

platform/PLATFORM.md

@@ -0,0 +1,66 @@
+# DevFactory Unified Platform
+
+소개 페이지와 백엔드 API가 통합된 DevFactory의 메인 플랫폼 관리 가이드입니다. 
+본 설정은 **Traefik 역방향 프록시**를 사용하는 서버 환경을 전제로 합니다.
+
+### 1. Production Build
+로컬 또는 서버에서 프론트엔드 에셋을 빌드합니다.
+```bash
+cd platform/frontend
+npm install
+npm run build
+```
+결과물은 `platform/frontend/dist` 디렉토리에 생성됩니다.
+
+### 2. Deployment Options
+
+#### Option A: Static Hosting (GitHub Pages / Vercel)
+단순 웹 페이지(Frontend)만 배포하고 싶은 경우에 사용합니다.
+1. `platform/frontend`에서 `npm run build`를 실행합니다.
+2. `dist` 폴더 내의 파일들을 배포 서비스에 업로드합니다.
+> **참고**: 이 방식으로는 자체 DB 방문자 추적 기능을 사용할 수 없습니다.
+
+#### Option B: Unified Platform (Full-Stack / Docker)
+방문자 추적 기능을 포함한 전체 플랫폼 배포 방식입니다. **(권장)**
+
+### 3. Environment Setup
+`platform` 디렉토리 루트에 `.env` 파일을 생성하고 서버 환경에 맞게 정보를 입력합니다.
+```bash
+# .env 파일 예시
+APP_HOST=intro.pseudolab-devfactory.com
+
+# Database
+DATABASE_URL=postgresql://user:pass@devfactory-postgres:5432/dbname
+```
+
+### 3. Traefik 기반 배포
+Docker Compose를 사용하여 서비스를 실행합니다.
+```bash
+cd platform
+# 전체 서비스 빌드 및 실행
+docker-compose up -d --build
+```
+
+#### 배포 확인
+- **Frontend (Web)**: `https://<APP_HOST>`
+- **Backend (API)**: `https://<APP_HOST>/api/health`
+
+### 4. Database Schema
+사용 중인 `logging.access_log` 테이블의 구조는 다음과 같아야 합니다.
+```sql
+CREATE TABLE logging.access_log (
+    id SERIAL PRIMARY KEY,
+    ts TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+    path TEXT NOT NULL,
+    method TEXT NOT NULL,
+    status INTEGER NOT NULL,
+    latency_ms INTEGER,
+    ip_hash TEXT,
+    user_agent TEXT,
+    referrer TEXT
+);
+```
+
+### 5. Verification
+- Traefik 대시보드에서 `df-platform` 관련 라우터가 활성화되었는지 확인하세요.
+- 브라우저에서 사이트 접속 시 HTTPS 상시 연결 및 방문 기록 적재 여부를 확인하세요.

platform/docker-compose.dev.yml

@@ -0,0 +1,43 @@
+services:
+  # Development Overrides with Traefik Support
+  frontend:
+    build:
+      context: ./frontend
+      target: build-stage
+    image: devfactory-frontend:dev
+    command: npm run dev -- --host 0.0.0.0
+    volumes:
+      - ./frontend:/app
+      - /app/node_modules
+    labels:
+      - traefik.enable=true
+      - traefik.docker.network=traefik
+      - traefik.http.routers.df-platform-web.rule=Host(`${APP_HOST}`)
+      - traefik.http.routers.df-platform-web.entrypoints=websecure
+      - traefik.http.routers.df-platform-web.tls=true
+      - traefik.http.routers.df-platform-web.tls.certresolver=le
+      - traefik.http.services.df-platform-web.loadbalancer.server.port=5173
+      # HTTP → HTTPS redirect (re-adding to ensure full functionality)
+      - traefik.http.routers.df-platform-web-http.rule=Host(`${APP_HOST}`)
+      - traefik.http.routers.df-platform-web-http.entrypoints=web
+      - traefik.http.routers.df-platform-web-http.middlewares=redirect-to-https@file
+      - traefik.http.routers.df-platform-web-http.service=df-platform-web
+
+  server:
+    command: npm run dev
+    volumes:
+      - ./server:/app
+      - /app/node_modules
+    labels:
+      - traefik.enable=true
+      - traefik.docker.network=traefik
+      - traefik.http.routers.df-platform-api.rule=Host(`${APP_HOST}`) && PathPrefix(`/api`)
+      - traefik.http.routers.df-platform-api.entrypoints=websecure
+      - traefik.http.routers.df-platform-api.tls=true
+      - traefik.http.routers.df-platform-api.tls.certresolver=le
+      - traefik.http.services.df-platform-api.loadbalancer.server.port=3000
+      # HTTP → HTTPS redirect
+      - traefik.http.routers.df-platform-api-http.rule=Host(`${APP_HOST}`) && PathPrefix(`/api`)
+      - traefik.http.routers.df-platform-api-http.entrypoints=web
+      - traefik.http.routers.df-platform-api-http.middlewares=redirect-to-https@file
+      - traefik.http.routers.df-platform-api-http.service=df-platform-api

platform/docker-compose.yml

@@ -0,0 +1,61 @@
+services:
+  # Frontend static server (Nginx)
+  frontend:
+    build:
+      context: ./frontend
+      labels:
+        - "org.pseudolab.project=devfactory-platform"
+    container_name: devfactory-frontend
+    restart: unless-stopped
+    networks:
+      - traefik
+      - internal
+    labels:
+      - traefik.enable=true
+      - traefik.docker.network=traefik
+      # --- Traefik Router (frontend) ---
+      - traefik.http.routers.df-platform-web.rule=Host(`${APP_HOST}`)
+      - traefik.http.routers.df-platform-web.entrypoints=websecure
+      - traefik.http.routers.df-platform-web.tls=true
+      - traefik.http.routers.df-platform-web.tls.certresolver=le
+      - traefik.http.services.df-platform-web.loadbalancer.server.port=80
+      # HTTP → HTTPS redirect
+      - traefik.http.routers.df-platform-web-http.rule=Host(`${APP_HOST}`)
+      - traefik.http.routers.df-platform-web-http.entrypoints=web
+      - traefik.http.routers.df-platform-web-http.middlewares=redirect-to-https@file
+      - traefik.http.routers.df-platform-web-http.service=df-platform-web
+
+  # Backend API server
+  server:
+    build:
+      context: ./server
+      labels:
+        - "org.pseudolab.project=devfactory-platform"
+    container_name: devfactory-api
+    restart: unless-stopped
+    environment:
+      - DATABASE_URL=${DATABASE_URL}
+      - PORT=3000
+    networks:
+      - traefik
+      - internal
+    labels:
+      - traefik.enable=true
+      - traefik.docker.network=traefik
+      # --- Traefik Router (backend) ---
+      - traefik.http.routers.df-platform-api.rule=Host(`${APP_HOST}`) && PathPrefix(`/api`)
+      - traefik.http.routers.df-platform-api.entrypoints=websecure
+      - traefik.http.routers.df-platform-api.tls=true
+      - traefik.http.routers.df-platform-api.tls.certresolver=le
+      - traefik.http.services.df-platform-api.loadbalancer.server.port=3000
+      # HTTP → HTTPS redirect
+      - traefik.http.routers.df-platform-api-http.rule=Host(`${APP_HOST}`) && PathPrefix(`/api`)
+      - traefik.http.routers.df-platform-api-http.entrypoints=web
+      - traefik.http.routers.df-platform-api-http.middlewares=redirect-to-https@file
+      - traefik.http.routers.df-platform-api-http.service=df-platform-api
+
+networks:
+  traefik:
+    external: true
+  internal:
+    driver: bridge

platform/frontend/Dockerfile

@@ -0,0 +1,23 @@
+# Stage 1: Build stage
+FROM node:20-alpine as build-stage
+
+WORKDIR /app
+
+# Copy package files and install dependencies
+COPY package*.json ./
+RUN npm install
+
+# Copy project files and build
+COPY . .
+RUN npm run build
+
+# Stage 2: Serve stage
+FROM nginx:stable-alpine as production-stage
+
+# Copy built assets from build-stage to nginx
+COPY --from=build-stage /app/dist /usr/share/nginx/html
+
+# Expose port 80
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]