chore: HERV 통합 저장소 초기 커밋
- 펌웨어(program), C# 대시보드(TestProgram), 시뮬레이터(Simulator), 프로토콜/문서(Protocol, doc) 전체를 단일 저장소로 통합 - program 폴더의 별도 git 저장소를 제거하고 통합 저장소에 흡수 - 빌드 산출물(program/build, bin/obj, *.o/.elf/.bin/.hex 등) .gitignore 처리 - 사내 Synology NAS Git 원격 연결 예정 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,64 @@
|
||||
# 팀 공유 · 이동 중 작업 환경 구성 (검토 메모)
|
||||
|
||||
작성일: 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 테스트
|
||||
Reference in New Issue
Block a user