From 8ca3df53e0ab35031884a7703cabfbd51f885ec4 Mon Sep 17 00:00:00 2001 From: zihyeon08 Date: Mon, 16 Mar 2026 10:26:29 +0900 Subject: [PATCH 1/2] =?UTF-8?q?feat:=20haedalprogramming=20=EC=A1=B0?= =?UTF-8?q?=EC=A7=81=20=ED=94=84=EB=A1=9C=ED=95=84=20README=20=EC=B6=94?= =?UTF-8?q?=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - profile/README.md: GitHub 조직 홈(github.com/haedalprogramming)에 표시될 공개용 README - 슬로건, 핵심 레포 6개 카드, 기술 스택 배지, 활동 통계, CTA 섹션 포함 - PROFILE_PLAN.md: 구조 설계 근거 및 유지보수 가이드 포함 내부용 기획 문서 Co-Authored-By: Claude Sonnet 4.6 --- PROFILE_PLAN.md | 112 ++++++++++++++++++++++++++++++++ profile/README.md | 158 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 270 insertions(+) create mode 100644 PROFILE_PLAN.md create mode 100644 profile/README.md diff --git a/PROFILE_PLAN.md b/PROFILE_PLAN.md new file mode 100644 index 0000000..381a43f --- /dev/null +++ b/PROFILE_PLAN.md @@ -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 `` 2열 레이아웃으로 스크롤 없이 한 화면에 전체 조망 + +#### Tech Ecosystem — 배지 +- 텍스트보다 배지가 훨씬 빠르게 스택을 스캔할 수 있음 +- 프론트엔드 / 백엔드 / AI·ML / 인프라 4계층으로 분류하여 기술 깊이 표현 + +#### Activity Stats — github-readme-stats +- 코드 활동량을 시각화하여 "이 조직이 실제로 활발히 개발 중"임을 증명 +- 외부 API를 활용하므로 별도 유지보수 불필요 + +#### Join Us / CTA — 채용·커피챗·블로그 +- 관심 있는 방문자가 다음 행동(지원, 연락)을 취할 수 있도록 명확한 CTA 제공 +- 링크는 `` 플레이스홀더로 처리 → 실제 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 확정 | `` 플레이스홀더를 실제 링크로 교체 | + +### 플레이스홀더 목록 (교체 필요) + +`profile/README.md` 내 `` 주석이 달린 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`에 접속하면 바로 표시됩니다. diff --git a/profile/README.md b/profile/README.md new file mode 100644 index 0000000..e73801c --- /dev/null +++ b/profile/README.md @@ -0,0 +1,158 @@ +
+ +# 해달 프로그래밍 (haedalprogramming) + +### 기술로 가치를, 교육으로 미래를 만듭니다 + +아이들이 코딩을 배우는 방식을 바꾸는 AI EdTech 스타트업입니다. +커리큘럼 설계부터 LMS 개발, 운영 자동화까지 — 교육의 전 과정을 직접 만듭니다. + +
+ +--- + +## 🎯 우리가 집중하는 것 + +| | 과제 | 설명 | +|---|---|---| +| 🤖 | **AI × EdTech** | Gemini · GPT-4o · Whisper를 교육 현장에 실질적으로 녹여내는 방법을 실험합니다 | +| ⚙️ | **운영 자동화** | 선생님과 스태프의 반복 업무를 줄여 교육에만 집중할 수 있는 환경을 만듭니다 | +| 🔬 | **오픈 실험** | 로보틱스 · 블록 코딩 · LLM 튜터링 등 미래 교육 기술을 지속적으로 탐구합니다 | + +--- + +## 🗂️ 핵심 레포지토리 + +### 🎓 교육 시스템 + +
+ + + + +
+

haedalEduMain

+

해달에듀 공식 홈페이지. 수업 소개, 커리큘럼 안내, 수강 신청까지 — 학부모와 학생이 처음 만나는 얼굴입니다.

+ Next.js + TypeScript + 		+

haedaledu-lms

+

학생용 LMS 시스템. AI 튜터링, 과제 제출, 진도 관리를 Gemini 2.5와 Supabase 위에 구축했습니다.

+ Next.js + Supabase + Gemini +
+ +### 📚 교육 컨텐츠 + + + + + + +
+

octostudio

+

옥토스튜디오 기반 블록 코딩 커리큘럼. 초등학생이 처음 프로그래밍 개념을 익히는 학습 자료 모음입니다.

+ JavaScript + 		+

lego-coding

+

LEGO 로보틱스 교육과정. 하드웨어와 코딩을 동시에 배우는 실습 중심 커리큘럼입니다.

+ JavaScript +
+ +### ⚙️ 운영 자동화 + + + + + + +
+

haedal-hub

+

재직자용 AI 보조 자동화 허브. 반복적인 행정·보고 업무를 줄이고 팀이 교육에 집중할 수 있도록 돕습니다.

+ Next.js + TypeScript + 		+

atalk-server

+

전화 녹취 파일 수신 및 처리 서버. Whisper로 STT 변환 후 GPT-4o로 요약·분류합니다.

+ Python + FastAPI +
+ +--- + +## 🛠️ 기술 생태계 + +**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) + +--- + +## 📊 활동 현황 + +
+ +[![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) + +
+ +--- + +## 🤝 함께하기 + +해달은 교육과 기술의 교차점에서 일하고 싶은 분을 환영합니다. + + + + + + + +
+

💼 채용

+

프론트엔드, AI 엔지니어링, 교육 콘텐츠 분야의 동료를 찾고 있습니다.

+ + 채용 공고 보기 → + 		+

☕ 커피챗

+

EdTech, AI 교육, 스타트업에 관심 있다면 편하게 연락 주세요.

+ + 커피챗 신청하기 → + 		+

📝 기술 블로그

+

우리가 겪은 기술적 고민과 해결 과정을 공유합니다.

+ + 블로그 읽기 → +
+ +--- + +
+ © 2025 해달 (Haedal) · 아이들의 첫 코딩 경험을 더 좋게 만들기 위해 일합니다 +
From e95c2d52ce7a2a9ffac8fdb367634270244545a2 Mon Sep 17 00:00:00 2001 From: zihyeon08 Date: Mon, 16 Mar 2026 10:27:51 +0900 Subject: [PATCH 2/2] =?UTF-8?q?docs:=20=EC=A1=B0=EC=A7=81=20=ED=94=84?= =?UTF-8?q?=EB=A1=9C=ED=95=84=20=EC=A0=9C=EB=AA=A9=EC=97=90=20PUBLIC=20?= =?UTF-8?q?=ED=91=9C=EA=B8=B0=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 4.6 --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index e73801c..396d48f 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,6 +1,6 @@
-# 해달 프로그래밍 (haedalprogramming) +# 해달 프로그래밍 (haedalprogramming) - PUBLIC ### 기술로 가치를, 교육으로 미래를 만듭니다