# 팀 공유 · 이동 중 작업 환경 구성 (검토 메모)

작성일: 2026-06-15

## 1. 배경 / 요구사항
- 이동 중에도 지금처럼 **VS Code로 수정·저장**하는 방식을 유지하고 싶다.
- 기존 Google Drive 방식(수동 다운로드/업로드)은 번거롭고 버전 꼬임이 생겨 개선 필요.
- **다른 직원과 소스 공유**도 해야 한다.

## 2. 결론
**Git + 사내 원격 저장소(private)** 로 간다.
한 번에 세 가지를 해결:
1. 팀 공유 — 각자 clone, 수정 후 push, 누가 뭘 바꿨는지 추적
2. 이동 중 작업 — 노트북에서 clone, 또는 브라우저 웹 IDE로 편집
3. 변경 이력 — 현재 이 폴더는 git 저장소가 아니라 diff 추적 불가 → git 도입으로 영구 해결

> 폴더 동기화(Google Drive / OneDrive / Syncthing)는 여러 명이 동시에 수정하면 충돌 파일이 쌓여 **팀 공유에는 부적합**. 단독 백업 용도라면 OneDrive/Syncthing이 Drive보다 낫지만, 본 목적에는 Git 채택.

## 3. 호스팅: 회사 Synology NAS (확정)
사내에 소스가 머무르고 직원 공유가 깔끔함. 내일 NAS에 Git 설치 후 진행 예정.

### 방식 비교
| 방식 | 특징 | 추천 상황 |
|---|---|---|
| **Git Server 패키지 (추천)** | 패키지 센터에서 `Git Server` 설치, SSH로 bare repo 접근. 가볍고 간단. | 소규모 팀(현재) |
| **GitLab (패키지/Docker)** | 머지요청·이슈·권한관리·웹 편집 등 풀기능 웹 UI. 무겁고 RAM 사용 큼. | 코드리뷰/PR 문화 필요 시 |

→ 우선 **Git Server 패키지**로 시작, 필요해지면 GitLab으로 확장.

### Git Server 방식 절차 (예시)
```bash
# NAS 측 (SSH 접속 후) — bare 저장소 생성
git init --bare /volume1/git/HERV.git

# 직원 PC 측 — clone
git clone ssh://사용자@NAS주소:포트/volume1/git/HERV.git
```

## 4. 로컬 준비 (NAS 연결 전, 오늘 가능)
원격 설정만 내일 하면 되도록 로컬 git을 먼저 초기화:
1. `.gitignore` 생성 — 빌드 산출물 제외, 소스·문서·PDF만 추적
   - 제외 대상: `program/build/`, C# `bin/` · `obj/`, `*.o *.d *.elf *.bin *.hex *.map`
2. `git init` + 첫 커밋 (현재 상태 스냅샷 → **이 시점부터 변경 이력 남음**)

내일 NAS 작업:
```bash
git remote add origin ssh://사용자@NAS주소:포트/volume1/git/HERV.git
git push -u origin main
```

## 5. 이동 중 작업 옵션 (참고)
- **노트북 + git clone**: 가장 일반적. 평소처럼 VS Code 편집.
- **브라우저 웹 IDE**: GitLab 도입 시 웹 편집 가능(Git Server 단독은 미지원).
- **VS Code Remote Tunnel**: 집/사무실 PC에 `code tunnel` 켜두고 원격 접속 → 그 PC의 실제 파일·빌드툴·연결된 PBA 보드까지 그대로 사용. (빌드·실보드 시험을 이동 중에도 해야 할 때 유용)

## 6. 주의 / 작업 범위
- 모든 작업은 `D:\project\nuvoton\HERV` 폴더 내부에서만 진행 (외부 `D:\project\C#\` 등은 건드리지 않음).
- 빌드 산출물은 git에 올리지 않음(.gitignore 처리) — 저장소를 소스·문서 위주로 깨끗하게 유지.

## 7. 다음 할 일
- [ ] (오늘/원하면) 로컬 `git init` + `.gitignore` + 첫 커밋
- [ ] (내일) NAS에 Git Server 패키지 설치, bare repo 생성
- [ ] NAS를 remote로 추가하고 push
- [ ] 직원 계정/접근 권한 부여 및 clone 테스트