Skip to content

Commit e7d8608

Browse files
author
GoGoComputer
committed
Phase 0: scaffold 120-chapter curriculum
- README, ARCHITECTURE - docs: CHAPTER-MATRIX, LECTURE-TEMPLATE, STYLE-GUIDE, CAT-VIGILANTE-SPEC - 120 chapter folders with start/, finish/, notes/, exercises.md - 960 lecture stubs (H1~H8) per LECTURE-TEMPLATE - scripts/scaffold-chapters.sh (idempotent) - .gitignore
1 parent 722ea85 commit e7d8608

1,328 files changed

Lines changed: 49855 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.gitignore‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# OS
2+
.DS_Store
3+
Thumbs.db
4+
5+
# Editors
6+
.vscode/
7+
.idea/
8+
*.swp
9+
10+
# Python
11+
__pycache__/
12+
*.py[cod]
13+
*.egg-info/
14+
.venv/
15+
venv/
16+
.pytest_cache/
17+
.mypy_cache/
18+
.ruff_cache/
19+
.coverage
20+
htmlcov/
21+
22+
# Node
23+
node_modules/
24+
dist/
25+
build/
26+
.next/
27+
.turbo/
28+
*.log
29+
30+
# Env
31+
.env
32+
.env.local
33+
.env.*.local
34+
!.env.example
35+
36+
# Build artifacts
37+
*.zip
38+
*.tar.gz

‎ARCHITECTURE.md‎

Lines changed: 147 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,147 @@
1+
# 🏗 ARCHITECTURE — 고양이 자경단
2+
3+
> "고양이 자경단" 은 길고양이 목격 제보·구조·입양·자경단 커뮤니티 플랫폼입니다. 이 문서는 코스 전체에서 단계적으로 진화시킬 시스템의 최종 목표 아키텍처를 정의합니다.
4+
5+
---
6+
7+
## 1. 도메인 한 줄 요약
8+
9+
> 동네에서 발견한 길고양이를 **사진과 함께 지도에 핀으로 제보**하면, 근처 자경단원에게 **실시간으로 알림**이 가고, 필요 시 **라이브 영상**으로 현장을 공유하며 구조한다. AI가 **사진을 분석**해 같은 고양이인지·건강 상태는 어떤지·다음 행동은 무엇이 좋을지 제안한다.
10+
11+
---
12+
13+
## 2. 핵심 사용자
14+
15+
| 역할 | 설명 |
16+
|------|------|
17+
| 일반 회원 | 누구나 제보·열람·후원 가능 |
18+
| 자경단원 | 인증된 구조 활동가, 채팅·라이브·구조 기록 권한 |
19+
| 입양 희망자 | 보호 중인 고양이 신청 |
20+
| 관리자 | 자경단원 승인, 신고 처리, 통계 |
21+
22+
---
23+
24+
## 3. 핵심 기능 → 기술 매핑
25+
26+
| 기능 | 기술 | 코스 챕터 |
27+
|------|------|----------|
28+
| 길고양이 제보 (위치+사진) | Flask REST API + Leaflet + S3 Presigned | Ch 56~70, Ch 80 |
29+
| 신규 제보 실시간 알림 | SSE | Ch 81 |
30+
| 자경단 지역 채팅 | Socket.IO | Ch 82 |
31+
| 채팅의 클라우드 네이티브 버전 | API Gateway WebSocket / AppSync | Ch 83 |
32+
| 구조 현장 라이브 | WebRTC + LiveKit | Ch 84 |
33+
| 모바일 푸시 | 웹푸시 VAPID + PWA | Ch 85 |
34+
| AI 사진 분석·고양이 매칭 | Vision LLM + Embedding | Ch 99, Ch 97~98 |
35+
| Agent 비서 ("이 고양이 어떻게 해요?") | LLM Agent + Tool Calling + MCP | Ch 90~94 |
36+
| 입양·후원·결제 | Toss Payments (선택) | 외전 |
37+
| 운영자 대시보드 | React + Recharts | Ch 76~78 |
38+
39+
---
40+
41+
## 4. 시스템 다이어그램 (최종 — Ch 120 시점)
42+
43+
```
44+
┌─────────────────┐
45+
│ Route 53 │
46+
│ (DNS, Health) │
47+
└────────┬────────┘
48+
│
49+
┌────────▼────────┐
50+
│ CloudFront │ (CDN, OAC, WAF)
51+
└────────┬────────┘
52+
│
53+
┌──────────────────────┼──────────────────────┐
54+
│ │ │
55+
┌───────▼────────┐ ┌────────▼────────┐ ┌────────▼────────┐
56+
│ ALB (HTTPS) │ │ API Gateway │ │ S3 (static) │
57+
│ │ │ (WebSocket/HTTP)│ │ + 이미지 업로드│
58+
└───────┬────────┘ └────────┬────────┘ └─────────────────┘
59+
│ │
60+
┌────────▼────────┐ ┌────────▼────────┐
61+
│ ECS Fargate │ │ Lambda │
62+
│ - Flask API │ │ - WebSocket fn │
63+
│ - Gunicorn+ │ │ - Background fn │
64+
│ gevent │ └────────┬────────┘
65+
│ - Socket.IO │ │
66+
└───┬─────────┬───┘ │
67+
│ │ │
68+
│ └─► EventBridge ◄─┘
69+
│ │
70+
▼ ▼
71+
┌──────────────┐ ┌──────────────┐
72+
│ RDS / Aurora│ │ DynamoDB │ (WebSocket 연결 관리)
73+
│ (MySQL) │ └──────────────┘
74+
└──────┬───────┘
75+
│
76+
▼
77+
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
78+
│ Aurora │ │ Bedrock │ │ LiveKit │
79+
│ pgvector │ │ (LLM/Agent) │ │ (WebRTC SFU)│
80+
│ (RAG 메모리)│ │ + Knowledge │ │ + S3 녹화 │
81+
└──────────────┘ │ Bases │ └──────────────┘
82+
└──────────────┘
83+
```
84+
85+
---
86+
87+
## 5. 학기별 시스템 진화 단계
88+
89+
| Sem | 단계 | 변화 |
90+
|-----|------|------|
91+
| S1~S2 | Local CLI | Python으로 가계부/제보 기록 — DB 없음 |
92+
| S3 | Local DB | Docker MySQL + 직접 SQL |
93+
| S5 | Local Backend | Flask + SQLAlchemy + 로컬 MySQL + JWT |
94+
| S6 | Local Fullstack | + React + Leaflet + 로컬 SSE/Socket.IO + 로컬 LiveKit |
95+
| S7 | + AI | + Agent + MCP + RAG + Vision |
96+
| S8 (초중반) | Cloud Lift | EC2 → ECS Fargate, 로컬 MySQL → RDS, S3, CloudFront |
97+
| S8 (후반) | Production | Multi-AZ → Multi-Region DR, IaC, CI/CD, Bedrock Agents, 비용 최적화 |
98+
99+
---
100+
101+
## 6. 데이터 모델 (개요)
102+
103+
```
104+
User ─< Squad ─< Region
105+
│
106+
├─< CatReport >─ CatProfile
107+
│ │ │
108+
│ └< Photo ├< MatchScore
109+
│ └< Comment └< AdoptionRequest
110+
│
111+
├─< RescueLog
112+
├─< Donation
113+
└─< ChatMessage (Room: per region)
114+
115+
LiveSession (LiveKit Room) ─ Recording (S3)
116+
AgentConversation ─< AgentMessage ─< ToolCall
117+
```
118+
119+
상세 ERD: [docs/CAT-VIGILANTE-SPEC.md](docs/CAT-VIGILANTE-SPEC.md)
120+
121+
---
122+
123+
## 7. 비기능 요구사항 (S8 시점)
124+
125+
- **가용성**: 99.9% (Multi-AZ 기본, Multi-Region 옵션)
126+
- **응답시간**: P95 < 300ms (정적 자원 제외)
127+
- **비용**: 활성 사용자 1만 명 기준 월 $200 이하 (S8 Ch 120에서 분석)
128+
- **보안**: OWASP Top 10 통과, KMS 암호화, IAM 최소 권한, WAF
129+
- **관측**: CloudWatch + X-Ray 분산 추적, SLO/에러버짓
130+
- **재해 복구**: RPO ≤ 15분, RTO ≤ 1시간 (Warm Standby)
131+
132+
---
133+
134+
## 8. 의도적 결정 (Trade-offs)
135+
136+
| 결정 | 이유 |
137+
|------|------|
138+
| Flask (vs FastAPI) | 학습 자료·생태계 풍부, gevent로 SSE/Socket.IO 자연스러움 |
139+
| MySQL 기본 (vs Postgres) | 한국 실무 빈도, 단 RAG는 Aurora pgvector로 Postgres 도입 |
140+
| TanStack Query (vs Redux) | 서버 상태 90% — 보일러플레이트 최소화 |
141+
| Terraform (vs CDK) | 멀티클라우드 가능성, HCL 가독성 |
142+
| LiveKit (vs Agora/Twilio) | 오픈소스 self-host 가능, 비용 통제 |
143+
| MCP (vs 단일 SDK) | 2026년 표준, 도구 재사용성 |
144+
145+
---
146+
147+
> 이 ARCHITECTURE는 살아있는 문서입니다. 학기별로 갱신되며, 각 챕터 README는 이 문서의 어느 부분을 다루는지 명시합니다.

‎README.md‎

Lines changed: 164 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,164 @@
1+
# 🐱 고양이 자경단 — 풀스택 + AI 엔지니어링 + AWS 클라우드 아키텍트 코스
2+
3+
> **이 코스 하나로 신입~주니어 백엔드/프론트엔드/풀스택/AI 엔지니어/DevOps 어디든 지원할 수 있는 역량을 만든다.**
4+
> 오픈소스 "고양이 자경단" 사이트(길고양이 구조 커뮤니티)를 0에서 프로덕션 배포까지 직접 만들면서 배운다.
5+
6+
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
7+
![Status](https://img.shields.io/badge/status-WIP-orange)
8+
![Chapters](https://img.shields.io/badge/chapters-120-blue)
9+
![Lectures](https://img.shields.io/badge/lectures-960-blue)
10+
11+
---
12+
13+
## 📌 한눈에
14+
15+
| 항목 | 값 |
16+
|------|-----|
17+
| 학기 | 8학기 |
18+
| 챕터 | **120챕터** |
19+
| 강의 대본 | **960개** (120 × H1~H8 = 8교시) |
20+
| 학습 기간 | **약 24개월 (주 5~10시간)** |
21+
| 챕터당 학습 | 2주 |
22+
| 도메인 | 고양이 자경단 (오픈소스 길고양이 구조 커뮤니티 사이트) |
23+
| 라이선스 | MIT (사내 교육·부트캠프·유튜브 자유 사용) |
24+
25+
---
26+
27+
## 🎯 이 코스를 끝내면
28+
29+
- **백엔드 엔지니어** — Python/Flask/SQLAlchemy/MySQL/RESTful/OAuth/JWT/RBAC/보안
30+
- **프론트엔드 엔지니어** — TypeScript/React/TailwindCSS/TanStack Query/실시간 UI
31+
- **풀스택 엔지니어** — 위 두 가지 + 통합 + 배포
32+
- **AI 엔지니어 / LLM 엔지니어** — Agent / MCP / Harness / RAG / Eval / MLOps / Safety
33+
- **DevOps / 클라우드 엔지니어** — AWS 클라우드 아키텍트 실무 역량 + Terraform + CI/CD
34+
- **신입 개발자** — CS 기초 + 자료구조·알고리즘 + 시스템 디자인 면접 + 이력서·포트폴리오
35+
36+
---
37+
38+
## 🧭 8학기 로드맵
39+
40+
| Sem | 주제 | 챕터 | 산출물 |
41+
|-----|------|------|--------|
42+
| **S1** | CS 기초 + Python 입문 | Ch 1~15 | CLI 가계부 |
43+
| **S2** | Python 심화 + 자료구조·알고리즘 + 코딩테스트 | Ch 16~30 | 코딩테스트 30문제 풀이 노트 |
44+
| **S3** | SQL + 데이터베이스 깊이 | Ch 31~42 | 고양이 자경단 ERD + 100쿼리 |
45+
| **S4** | HTML/CSS/JavaScript/TypeScript + 프론트 기초 | Ch 43~55 | 바닐라 TS 고양이 카드 UI |
46+
| **S5** | 백엔드 풀코스 (Flask·API·OAuth·보안) | Ch 56~70 | 고양이 제보 API 완성 |
47+
| **S6** | 프론트엔드 심화 + 실시간 (SSE/Socket.IO/WebRTC) | Ch 71~85 | 라이브 영상까지 도는 사이트 |
48+
| **S7** | AI 엔지니어링 (LLM·Agent·MCP·Harness·MLOps) | Ch 86~103 | 자체 Agent 하니스 + MCP 서버 |
49+
| **S8** | AWS 클라우드 아키텍트 + DevOps + 취업 준비 | Ch 104~120 | 멀티리전 라이브 사이트 + 시디면접 노트 |
50+
51+
📖 학기·챕터 전체 매트릭스: [docs/CHAPTER-MATRIX.md](docs/CHAPTER-MATRIX.md)
52+
53+
---
54+
55+
## 📂 레포 구조
56+
57+
```
58+
react-flask-ai-stack/
59+
├── README.md # 이 파일
60+
├── ARCHITECTURE.md # 시스템 아키텍처
61+
├── LICENSE
62+
│
63+
├── docs/
64+
│ ├── CHAPTER-MATRIX.md # 120챕터 전체 표
65+
│ ├── LECTURE-TEMPLATE.md # 강의 대본 표준 템플릿 (H1~H8)
66+
│ ├── STYLE-GUIDE.md # 톤·길이·박스 규약
67+
│ └── CAT-VIGILANTE-SPEC.md # 도메인 사양 (ERD/페이지/플로우)
68+
│
69+
├── chapters/
70+
│ ├── 001-cs-computer-architecture/
71+
│ ├── 002-cs-os-basics/
72+
│ ├── ...
73+
│ └── 120-advanced-architecture-and-job-prep/
74+
│
75+
└── final-project/ # 모든 챕터 통합 완성본 (S8 후)
76+
├── backend/ frontend/ agent/ infra/ deploy/
77+
```
78+
79+
각 챕터 폴더 표준 구조:
80+
81+
```
82+
chapters/NNN-name/
83+
├── README.md # 개발자용 (학습 목표·체크리스트·코드 가이드)
84+
├── start/ # 시작 코드 (이전 챕터 finish 복사)
85+
├── finish/ # 완성 코드
86+
├── exercises.md # 연습 문제 (쉬움/중간/어려움)
87+
├── notes/ # 다이어그램, 면접 Q&A, 트러블슈팅
88+
└── lecture/ # 비개발자도 이해 가능한 강의 대본 (8교시 × 60분)
89+
├── README.md # 강의 운영 가이드 + 마스터 목차
90+
├── H1-orientation.md
91+
├── H2-concepts.md
92+
├── H3-setup.md
93+
├── H4-catalog.md
94+
├── H5-demo.md ⭐ "보이는 결과물"
95+
├── H6-management.md
96+
├── H7-internals.md
97+
└── H8-apply-wrap.md
98+
```
99+
100+
---
101+
102+
## 🎙 H1~H8 표준 시간 슬롯
103+
104+
각 챕터는 **60분짜리 강의 8교시**로 구성됩니다 (총 8시간).
105+
106+
| 교시 | 역할 |
107+
|------|------|
108+
| H1 | 오리엔테이션 — 왜 이걸 배우나, ROI |
109+
| H2 | 핵심 개념 4개 — 비유로 친해지기 |
110+
| H3 | 환경/설치 — 한 줄의 의미 |
111+
| H4 | 기본 명령/API/문법 카탈로그 |
112+
| H5 | **첫 실전 데모 — "보이는 결과물"** ⭐ |
113+
| H6 | 보관/관리 (백업·디버깅·흔한 실수) |
114+
| H7 | 안심하고 쓰는 원리 (멱등성·격리·보안·내부 동작) |
115+
| H8 | 내 일에 적용 + 회고 + 다음 챕터 예고 |
116+
117+
📖 대본 상세 규약: [docs/LECTURE-TEMPLATE.md](docs/LECTURE-TEMPLATE.md), [docs/STYLE-GUIDE.md](docs/STYLE-GUIDE.md)
118+
119+
---
120+
121+
## 🚀 빠른 시작
122+
123+
### 학습자
124+
125+
```bash
126+
git clone https://github.com/GoGoComputer/react-flask-ai-stack.git
127+
cd react-flask-ai-stack
128+
open docs/CHAPTER-MATRIX.md # 전체 코스 한눈에
129+
cd chapters/001-cs-computer-architecture
130+
open lecture/H1-orientation.md
131+
```
132+
133+
### 강사 / 부트캠프
134+
135+
각 챕터의 `lecture/` 폴더에 있는 H1~H8 대본을 마이크 앞에서 그대로 읽어도 강의가 진행됩니다.
136+
137+
---
138+
139+
## 🛠 기술 스택 (전 코스 통합)
140+
141+
**언어/런타임**: Python 3.12+, TypeScript 5+, Node.js 20+, SQL(MySQL 8/PostgreSQL 16), Bash
142+
**백엔드**: Flask, SQLAlchemy 2, Alembic, Gunicorn+gevent, Flask-SocketIO, Flask-JWT-Extended
143+
**프론트엔드**: React 18+, TanStack Query, TailwindCSS, react-hook-form+zod, Leaflet, Vite
144+
**실시간**: SSE, Socket.IO, LiveKit (WebRTC SFU), API Gateway WebSocket, AppSync
145+
**데이터베이스**: MySQL, PostgreSQL+pgvector, Redis, DynamoDB
146+
**AI**: Anthropic Claude, Google Gemini, AWS Bedrock, Ollama, MCP, LangSmith/Promptfoo, LoRA/QLoRA
147+
**인프라**: Docker/Compose, AWS (60+ 서비스), Terraform, GitHub Actions OIDC
148+
**관측·보안**: CloudWatch, X-Ray, Sentry, KMS, Secrets Manager, WAF, GuardDuty
149+
150+
---
151+
152+
## 📜 라이선스
153+
154+
[MIT License](LICENSE) — 사내 교육·부트캠프·유튜브 등 자유 사용/수정/배포 가능. 출처(`react-flask-ai-stack` / 고양이 자경단) 표기 부탁드립니다.
155+
156+
---
157+
158+
## 🤝 기여
159+
160+
이 코스는 오픈 컨트리뷰션을 환영합니다. 챕터별 README의 체크리스트를 기준으로 PR 부탁드립니다.
161+
162+
---
163+
164+
**자, 시작합시다. → [docs/CHAPTER-MATRIX.md](docs/CHAPTER-MATRIX.md)**
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# Ch 001 · 컴퓨터 구조 기본
2+
3+
> 학기: **S1** · 강의 시간: **8교시 × 60분 = 8시간** · 학습 권장: **2주**
4+
5+
---
6+
7+
## 🎯 학습 목표
8+
9+
- [ ] {목표 1}
10+
- [ ] {목표 2}
11+
- [ ] {목표 3}
12+
- [ ] {목표 4}
13+
- [ ] {목표 5}
14+
15+
## ✅ 완료 체크리스트
16+
17+
- [ ] H1~H8 강의 시청/음독
18+
- [ ] start/ → finish/ 코드 실습
19+
- [ ] exercises.md 3문제 풀이
20+
- [ ] 음독 시뮬레이션 60분 ± 5분 (대본 작성자용)
21+
- [ ] 다음 챕터 H1 회수 멘트와 연결되는지 확인
22+
23+
## 📂 폴더
24+
25+
- `start/` — 시작 코드
26+
- `finish/` — 완성 코드
27+
- `exercises.md` — 연습 문제
28+
- `notes/` — 다이어그램·면접 Q&A·트러블슈팅
29+
- `lecture/` — 8교시 강의 대본 (H1~H8)
30+
31+
## 🔗 연결
32+
33+
- ⬅ 이전: 01번 - 1
34+
- ➡ 다음: 01번 + 1
35+
- 📋 매트릭스: [docs/CHAPTER-MATRIX.md](../../docs/CHAPTER-MATRIX.md)
36+
- 🎙 대본 템플릿: [docs/LECTURE-TEMPLATE.md](../../docs/LECTURE-TEMPLATE.md)
37+
38+
## 🛠 산출물
39+
40+
- {이 챕터에서 만들 것}

0 commit comments

Comments
 (0)