DSHS Developer Platform

대구과학고등학교 학생들이 개발한 프로그램을 공유·검색·피드백하는 교내 전용 포트폴리오 플랫폼

주요 기능

기능	설명
프로젝트 탐색	프로그램 종류·플랫폼별 필터링, 작성자 닉네임 검색
프로젝트 등록	웹사이트·앱·확장프로그램·CLI·라이브러리 등록, 공개/비공개 설정
바이브 코딩 가이드	만들고 싶은 프로그램에 맞는 단계별 시작 가이드 추천 위저드
개발 팁	마크다운 기반 개발 노하우 블로그 (좋아요·댓글)
해줘!	비개발자가 아이디어를 올리고 개발자에게 구현을 요청하는 기능

기술 스택

계층	기술
Framework	Next.js 16 (App Router, TypeScript strict)
Styling	Tailwind CSS v4 + shadcn/ui (base-nova)
BaaS	Supabase (PostgreSQL + Auth + RLS)
Hosting	Cloudflare Workers (OpenNext, dshs.dev)

시작하기

1. 환경 변수 설정

.env.local 파일을 생성하고 아래 변수를 채워주세요.

NEXT_PUBLIC_SUPABASE_URL=https://<project-id>.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=<anon-key>

2. Supabase 스키마 적용

docs/ 폴더의 SQL 파일을 Supabase SQL 에디터에서 순서대로 실행합니다.

docs/03-supabase-schema.sql        # 기본 테이블 (users, projects, reviews)
docs/06-supabase-alter-users.sql   # users 컬럼 추가
docs/07-supabase-onboarding.sql    # 온보딩
docs/08-supabase-tips.sql          # 개발 팁 (tips, tip_likes, tip_comments)
docs/09-supabase-developer-role.sql
docs/10-supabase-haejwo.sql        # 해줘! (ideas)
docs/11-supabase-haejwo-alter.sql  # ideas.linked_project_id 추가

3. 의존성 설치 및 실행

npm install
npm run dev

http://localhost:3000에서 확인합니다.

인증

• Google OAuth 단일 방식 (Supabase Auth 경유)
• @ts.hs.kr 도메인 전용 — Google hd 파라미터 → Middleware → Supabase RLS 3단 검증

디렉토리 구조

src/
├── app/
│   ├── (nav)/
│   │   ├── explore/        # 프로젝트 탐색
│   │   ├── projects/       # 프로젝트 등록·수정·상세
│   │   ├── guide/          # 바이브 코딩 가이드 위저드 + 결과
│   │   ├── tips/           # 개발 팁 블로그
│   │   └── haejwo/         # 해줘! 아이디어 요청
│   ├── auth/               # OAuth 콜백·forbidden
│   ├── me/                 # 내 프로필
│   └── onboarding/         # 닉네임 설정
├── components/
│   ├── shared/             # SiteHeader, PageNav, Markdown 등
│   ├── projects/           # 프로젝트 카드·폼
│   ├── guide/              # 가이드 위저드·뷰어
│   ├── tips/               # 팁 에디터·카드·댓글
│   └── haejwo/             # 해줘 위저드·완료 버튼
├── content/guides/         # 가이드 마크다운 파일
└── lib/
    ├── supabase/           # 서버·클라이언트 헬퍼
    ├── tips/actions.ts     # 팁 서버 액션
    ├── haejwo/actions.ts   # 해줘 서버 액션
    ├── constants.ts        # 옵션 상수
    ├── types.ts            # Supabase 타입
    └── guide.ts            # 가이드 위저드 로직

라이선스

이 프로젝트는 대구과학고등학교 재학생·졸업생 전용 내부 서비스입니다.