K-OSP Frontend

한국기술교육대학교 오픈소스 프로젝트 플랫폼

---

Overview

KOSP(KOREATECH Open Source Platform)는 한국기술교육대학교 구성원을 위한 오픈소스 프로젝트 협업 플랫폼입니다. 팀 구성, 프로젝트 모집, 커뮤니티, 챌린지 등 오픈소스 활동에 필요한 기능을 통합 제공합니다.

Features

기능	설명
커뮤니티	게시판 기반의 자유 게시글 작성 및 토론
모집공고	오픈소스 프로젝트 팀원 모집 및 지원
팀 관리	팀 생성, 초대, 멤버 관리
챌린지	GitHub 활동 기반 챌린지 시스템
관리자 패널	사용자/권한/콘텐츠/정책 통합 관리
알림	실시간 알림 시스템
검색	통합 검색 기능

Tech Stack

• Framework — Next.js 15 (App Router)
• Language — TypeScript 5
• Styling — Tailwind CSS 4
• Rich Text Editor — Lexical
• Code Editor — Monaco Editor
• UI Components — Radix UI, Headless UI
• Animation — GSAP
• Icons — Lucide React, Bootstrap Icons
• Toast — Sonner
• Validation — Zod

Getting Started

Prerequisites

• Node.js 20+
• npm

Installation

# 저장소 클론
git clone https://github.com/KOREATECH-OSP/KOSP-Frontend.git
cd KOSP-Frontend

# 의존성 설치
npm install

# 개발 서버 실행
npm run dev

http://localhost:3000에서 확인할 수 있습니다.

Scripts

npm run dev       # 개발 서버 실행
npm run build     # 프로덕션 빌드
npm run start     # 프로덕션 서버 실행
npm run lint      # 코드 린트

Project Structure

src/
├── app/                  # App Router 페이지 및 레이아웃
│   ├── admin/            # 관리자 페이지
│   ├── auth/             # 인증 콜백
│   ├── challenge/        # 챌린지
│   ├── community/        # 커뮤니티 게시판
│   ├── recruit/          # 모집공고
│   ├── team/             # 팀 관리
│   ├── user/             # 사용자 프로필
│   ├── notification/     # 알림
│   └── search/           # 검색
├── common/               # 공용 컴포넌트, 훅, 유틸리티
├── lib/                  # API 클라이언트, 인증, 유틸리티
├── assets/               # 정적 자원
├── mocks/                # 목업 데이터
└── types/                # 타입 정의

Contributing

1. develop 브랜치에서 새 브랜치를 생성합니다.
2. 변경 사항을 커밋합니다.
3. main 브랜치로 Pull Request를 생성합니다.

License

이 프로젝트는 MIT License에 따라 배포됩니다.

Copyright (c) 2025 Korea University of Technology and Education