Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
112 changes: 112 additions & 0 deletions PROFILE_PLAN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,112 @@
# haedalprogramming 조직 프로필 README — 기획 문서

작성일: 2026-03-16
작성자: haedalprogramming 팀

---

## 1. 왜 조직 프로필 README를 만드는가

### 목적

GitHub 조직 페이지(`github.com/haedalprogramming`)는 채용 지원자, 협력사, 투자자, 오픈소스 커뮤니티가 해달을 처음 접하는 기술적 첫인상입니다. 기본 빈 화면 대신 README를 작성하면:

- **기술 스택과 방향성을 명확히 전달**: "이 팀이 무엇을 만들고, 어떤 기술을 쓰는지" 5초 내에 파악 가능
- **채용 전환율 향상**: 관심 있는 개발자가 직접 레포를 탐색하기 전에 팀의 철학과 문화를 미리 경험
- **조직 신뢰도 제고**: 정리된 README가 있는 조직은 그렇지 않은 조직보다 전문성 인식이 높음

### 기대 효과

| 대상 | 기대 효과 |
|------|-----------|
| 채용 지원자 | "이 팀이 Next.js + AI를 진지하게 쓰는구나" → 기술 핏 자기검증 가능 |
| 학부모/교육 관계자 | 기술력이 뒷받침된 교육 회사라는 신뢰감 형성 |
| 협력사/파트너 | 스택 및 인프라 파악으로 협업 가능 여부 빠르게 판단 |
| 오픈소스 기여자 | 진입점이 명확해져 기여 의향 상승 |

---

## 2. 구조 설계 근거

### 섹션별 의도

#### Hero Section — 슬로건 + 조직 소개
- GitHub 프로필은 상단 200px가 가장 많이 읽힘
- 슬로건 "기술로 가치를, 교육으로 미래를 만듭니다"는 기술과 교육이라는 두 축을 동시에 담아 해달의 정체성을 한 줄로 압축
- 1-2문장 소개로 "AI EdTech 스타트업"임을 즉시 인지시킴

#### Our Focus — 현재 집중하는 기술적 과제
- 단순한 회사 소개 대신 **지금 이 팀이 집중하는 기술 문제**를 보여줌으로써 개발자의 흥미를 유발
- 3가지로 압축: AI×EdTech / 운영 자동화 / 오픈 실험 → 팀의 현재 우선순위를 외부에 투명하게 공개

#### Featured Repos — 카테고리별 핵심 레포
- 조직의 레포가 많아질수록 방문자는 어디서 시작해야 할지 모름
- 카테고리(교육 시스템 / 교육 컨텐츠 / 운영 자동화)로 분류하여 "내가 관심 있는 영역"으로 바로 진입 가능
- HTML `<table>` 2열 레이아웃으로 스크롤 없이 한 화면에 전체 조망

#### Tech Ecosystem — 배지
- 텍스트보다 배지가 훨씬 빠르게 스택을 스캔할 수 있음
- 프론트엔드 / 백엔드 / AI·ML / 인프라 4계층으로 분류하여 기술 깊이 표현

#### Activity Stats — github-readme-stats
- 코드 활동량을 시각화하여 "이 조직이 실제로 활발히 개발 중"임을 증명
- 외부 API를 활용하므로 별도 유지보수 불필요

#### Join Us / CTA — 채용·커피챗·블로그
- 관심 있는 방문자가 다음 행동(지원, 연락)을 취할 수 있도록 명확한 CTA 제공
- 링크는 `<!-- TODO -->` 플레이스홀더로 처리 → 실제 URL 확정 후 교체

---

## 3. 핵심 레포 선정 이유

6개 레포를 선정한 기준:

1. **비즈니스 가치**: 해달의 핵심 프로덕트를 직접 담당하는 레포
2. **기술 다양성**: 다양한 스택(Next.js, FastAPI, JavaScript 등)을 고루 노출하여 팀의 기술 폭을 보여줌
3. **카테고리 균형**: 교육 시스템 2 + 교육 컨텐츠 2 + 운영 자동화 2 = 해달의 3대 축을 동등하게 표현

| 레포 | 선정 이유 |
|------|-----------|
| `haedalEduMain` | 가장 대외적인 얼굴. 기술 스택(Next.js + TypeScript)의 기준점 |
| `haedaledu-lms` | AI 통합의 핵심 레포. Gemini + Supabase 조합이 기술적 차별점 |
| `octostudio` | 교육 컨텐츠의 볼륨과 JavaScript 기반 커리큘럼 역량 표현 |
| `lego-coding` | 하드웨어+소프트웨어 교육이라는 독특한 포지션 표현 |
| `haedal-hub` | 내부 도구도 공개 수준으로 만드는 팀 문화 표현 |
| `atalk-server` | Python FastAPI + LLM 파이프라인 역량 표현. AI 엔지니어 채용에 유리 |

---

## 4. 향후 유지보수 가이드

### 언제 README를 업데이트해야 하는가

| 상황 | 업데이트 범위 |
|------|---------------|
| 새 핵심 레포 오픈 | Featured Repos 섹션에 추가. 기존 레포 중 덜 중요한 것 제거 고려 |
| 기술 스택 변경 | Tech Ecosystem 배지 추가/제거 |
| 채용 포지션 변경 | Join Us 섹션 텍스트 및 링크 교체 |
| 팀 슬로건/방향성 변경 | Hero Section 및 Our Focus 섹션 재작성 |
| 기술 블로그/채용 페이지 URL 확정 | `<!-- TODO -->` 플레이스홀더를 실제 링크로 교체 |

### 플레이스홀더 목록 (교체 필요)

`profile/README.md` 내 `<!-- TODO -->` 주석이 달린 3곳:

```
1. 채용 공고 보기 → href="#" (채용 페이지 URL로 교체)
2. 커피챗 신청하기 → href="#" (폼/오픈채팅 URL로 교체)
3. 블로그 읽기 → href="#" (기술 블로그 URL로 교체)
```

### 파일 위치

```
.github/
├── profile/
│ └── README.md ← GitHub 조직 프로필에 자동으로 표시되는 파일
└── PROFILE_PLAN.md ← 이 기획 문서 (내부용)
```

> **Note**: `profile/README.md`는 GitHub이 조직 홈 화면에 자동으로 렌더링합니다.
> 별도 설정 없이 `github.com/haedalprogramming`에 접속하면 바로 표시됩니다.
158 changes: 158 additions & 0 deletions profile/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,158 @@
<div align="center">

# 해달 프로그래밍 (haedalprogramming) - PUBLIC

### 기술로 가치를, 교육으로 미래를 만듭니다

아이들이 코딩을 배우는 방식을 바꾸는 AI EdTech 스타트업입니다.
커리큘럼 설계부터 LMS 개발, 운영 자동화까지 — 교육의 전 과정을 직접 만듭니다.

</div>

---

## 🎯 우리가 집중하는 것

| | 과제 | 설명 |
|---|---|---|
| 🤖 | **AI × EdTech** | Gemini · GPT-4o · Whisper를 교육 현장에 실질적으로 녹여내는 방법을 실험합니다 |
| ⚙️ | **운영 자동화** | 선생님과 스태프의 반복 업무를 줄여 교육에만 집중할 수 있는 환경을 만듭니다 |
| 🔬 | **오픈 실험** | 로보틱스 · 블록 코딩 · LLM 튜터링 등 미래 교육 기술을 지속적으로 탐구합니다 |

---

## 🗂️ 핵심 레포지토리

### 🎓 교육 시스템

<table>
<tr>
<td width="50%">
<h3><a href="https://github.com/haedalprogramming/haedalEduMain">haedalEduMain</a></h3>
<p>해달에듀 공식 홈페이지. 수업 소개, 커리큘럼 안내, 수강 신청까지 — 학부모와 학생이 처음 만나는 얼굴입니다.</p>
<img src="https://img.shields.io/badge/Next.js-000000?style=flat-square&logo=nextdotjs&logoColor=white" alt="Next.js">
<img src="https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript">
</td>
<td width="50%">
<h3><a href="https://github.com/haedalprogramming/haedaledu-lms">haedaledu-lms</a></h3>
<p>학생용 LMS 시스템. AI 튜터링, 과제 제출, 진도 관리를 Gemini 2.5와 Supabase 위에 구축했습니다.</p>
<img src="https://img.shields.io/badge/Next.js-000000?style=flat-square&logo=nextdotjs&logoColor=white" alt="Next.js">
<img src="https://img.shields.io/badge/Supabase-3ECF8E?style=flat-square&logo=supabase&logoColor=white" alt="Supabase">
<img src="https://img.shields.io/badge/Gemini-8E75B2?style=flat-square&logo=googlegemini&logoColor=white" alt="Gemini">
</td>
</tr>
</table>

### 📚 교육 컨텐츠

<table>
<tr>
<td width="50%">
<h3><a href="https://github.com/haedalprogramming/octostudio">octostudio</a></h3>
<p>옥토스튜디오 기반 블록 코딩 커리큘럼. 초등학생이 처음 프로그래밍 개념을 익히는 학습 자료 모음입니다.</p>
<img src="https://img.shields.io/badge/JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=black" alt="JavaScript">
</td>
<td width="50%">
<h3><a href="https://github.com/haedalprogramming/lego-coding">lego-coding</a></h3>
<p>LEGO 로보틱스 교육과정. 하드웨어와 코딩을 동시에 배우는 실습 중심 커리큘럼입니다.</p>
<img src="https://img.shields.io/badge/JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=black" alt="JavaScript">
</td>
</tr>
</table>

### ⚙️ 운영 자동화

<table>
<tr>
<td width="50%">
<h3><a href="https://github.com/haedalprogramming/haedal-hub">haedal-hub</a></h3>
<p>재직자용 AI 보조 자동화 허브. 반복적인 행정·보고 업무를 줄이고 팀이 교육에 집중할 수 있도록 돕습니다.</p>
<img src="https://img.shields.io/badge/Next.js-000000?style=flat-square&logo=nextdotjs&logoColor=white" alt="Next.js">
<img src="https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript">
</td>
<td width="50%">
<h3><a href="https://github.com/haedalprogramming/atalk-server">atalk-server</a></h3>
<p>전화 녹취 파일 수신 및 처리 서버. Whisper로 STT 변환 후 GPT-4o로 요약·분류합니다.</p>
<img src="https://img.shields.io/badge/Python-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python">
<img src="https://img.shields.io/badge/FastAPI-009688?style=flat-square&logo=fastapi&logoColor=white" alt="FastAPI">
</td>
</tr>
</table>

---

## 🛠️ 기술 생태계

**Frontend**

![Next.js](https://img.shields.io/badge/Next.js-000000?style=for-the-badge&logo=nextdotjs&logoColor=white)
![React](https://img.shields.io/badge/React-61DAFB?style=for-the-badge&logo=react&logoColor=black)
![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white)
![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-06B6D4?style=for-the-badge&logo=tailwindcss&logoColor=white)

**Backend**

![FastAPI](https://img.shields.io/badge/FastAPI-009688?style=for-the-badge&logo=fastapi&logoColor=white)
![Node.js](https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)
![Supabase](https://img.shields.io/badge/Supabase-3ECF8E?style=for-the-badge&logo=supabase&logoColor=white)
![PostgreSQL](https://img.shields.io/badge/PostgreSQL-4169E1?style=for-the-badge&logo=postgresql&logoColor=white)

**AI / ML**

![Google Gemini](https://img.shields.io/badge/Gemini_2.5-8E75B2?style=for-the-badge&logo=googlegemini&logoColor=white)
![OpenAI](https://img.shields.io/badge/GPT--4o-412991?style=for-the-badge&logo=openai&logoColor=white)
![Whisper](https://img.shields.io/badge/Whisper_STT-412991?style=for-the-badge&logo=openai&logoColor=white)
![MediaPipe](https://img.shields.io/badge/MediaPipe-0097A7?style=for-the-badge&logo=google&logoColor=white)

**Infra**

![Vercel](https://img.shields.io/badge/Vercel-000000?style=for-the-badge&logo=vercel&logoColor=white)
![Firebase](https://img.shields.io/badge/Firebase-FFCA28?style=for-the-badge&logo=firebase&logoColor=black)
![Google Cloud](https://img.shields.io/badge/Google_Cloud-4285F4?style=for-the-badge&logo=googlecloud&logoColor=white)

---

## 📊 활동 현황

<div align="center">

[![GitHub Stats](https://github-readme-stats.vercel.app/api?username=haedalprogramming&show_icons=true&theme=default&hide_border=true&title_color=2563eb&icon_color=2563eb&text_color=374151&bg_color=ffffff)](https://github.com/haedalprogramming)

[![Top Languages](https://github-readme-stats.vercel.app/api/top-langs/?username=haedalprogramming&layout=compact&theme=default&hide_border=true&title_color=2563eb&text_color=374151&bg_color=ffffff)](https://github.com/haedalprogramming)

</div>

---

## 🤝 함께하기

해달은 교육과 기술의 교차점에서 일하고 싶은 분을 환영합니다.

<table>
<tr>
<td align="center" width="33%">
<h3>💼 채용</h3>
<p>프론트엔드, AI 엔지니어링, 교육 콘텐츠 분야의 동료를 찾고 있습니다.</p>
<!-- TODO: 채용 페이지 링크로 교체 -->
<a href="#">채용 공고 보기 →</a>
</td>
<td align="center" width="33%">
<h3>☕ 커피챗</h3>
<p>EdTech, AI 교육, 스타트업에 관심 있다면 편하게 연락 주세요.</p>
<!-- TODO: 커피챗 신청 링크로 교체 -->
<a href="#">커피챗 신청하기 →</a>
</td>
<td align="center" width="33%">
<h3>📝 기술 블로그</h3>
<p>우리가 겪은 기술적 고민과 해결 과정을 공유합니다.</p>
<!-- TODO: 기술 블로그 링크로 교체 -->
<a href="#">블로그 읽기 →</a>
</td>
</tr>
</table>

---

<div align="center">
<sub>© 2025 해달 (Haedal) · 아이들의 첫 코딩 경험을 더 좋게 만들기 위해 일합니다</sub>
</div>