한세로 Git 저장소 관리 규칙
한세로 Git 저장소는 소스 코드 이력 관리와 협업을 위한 공간입니다. NAS 폴더 구조는 기존처럼 유지하되, Git 저장소는 프로그램 단위로 생성합니다.
1. 기본 원칙
- Git에는 소스 코드만 올린다.
- 설치파일, 실행파일, 빌드 결과물, 대용량 데이터는 올리지 않는다.
- 저장소는 고객사/공장/프로그램 단위로 구분한다.
- 저장소 이름은 영어, 숫자, 하이픈만 사용한다.
- 저장소 설명은 한글로 작성한다.
2. 저장소 이름 규칙
저장소 이름은 아래 형식을 사용한다.
번호-고객사-공장-프로그램명
예시:
01-hmc-ulsan-bolt-inspection
02-kia-gwangju-misassembly-inspection
03-hmc-jeonju-vision-system
98-internal-hai-studio
98-internal-groupware
3. 번호 규칙
| 번호 | 구분 |
|---|---|
| 00 | 의왕 및 남양 연구소 |
| 01 | 현대자동차 울산공장 |
| 02 | 기아자동차 광주공장 |
| 03 | 현대자동차 전주공장 |
| 04 | 해외 공장 |
| 10 | 삼표 시멘트 청주 공장 |
| 11 | 안양 모비스 |
| 12 | 중국 광저우 |
| 13 | 체코 모비스 |
| 80 | KMMG |
| 97 | 통합 / 공통 |
| 98 | 사내 |
| 99 | 기타 |
4. 고객사 약어
| 고객사 | 약어 |
|---|---|
| 현대자동차 | hmc |
| 기아자동차 | kia |
| 모비스 | mobis |
| 삼표시멘트 | sampyo |
| 한세로 사내 | internal |
| 공통 / 통합 | common |
5. 공장 / 지역 약어
| 지역 / 공장 | 약어 |
|---|---|
| 울산 | ulsan |
| 전주 | jeonju |
| 광주 | gwangju |
| 남양 | namyang |
| 의왕 | uiwang |
| 안양 | anyang |
| 청주 | cheongju |
| 중국 광저우 | china-guangzhou |
| 체코 | czech |
| 해외 | overseas |
6. 프로그램명 작성 규칙
프로그램명은 기능을 알 수 있게 작성한다.
예시:
bolt-inspection
pin-inspection
label-inspection
underbody-inspection
misassembly-inspection
vision-system
mes-interface
groupware
hai-studio
hansero-chat
7. 저장소 설명 작성 규칙
저장소 설명은 한글로 작성한다.
예시:
| 저장소명 | 설명 |
|---|---|
| 98-internal-hai-studio | 한세로 AI 트레이너 |
| 98-internal-groupware | 한세로 그룹웨어 |
| 01-hmc-ulsan-bolt-inspection | 현대자동차 울산공장 볼트 검사 프로그램 |
| 02-kia-gwangju-misassembly-inspection | 기아자동차 광주공장 오장착 검사 프로그램 |
8. Git에 올릴 것
아래 항목은 Git에 올린다.
소스 코드
프로젝트 파일
솔루션 파일
README.md
설정 샘플 파일
DB 스크립트
간단한 문서
간단한 샘플 데이터
9. Git에 올리지 않을 것
아래 항목은 Git에 올리지 않는다.
bin
obj
.vs
exe
dll
zip
설치파일
빌드 결과물
런타임 폴더
학습 데이터
학습 모델
대량 이미지
로그 파일
현장 백업 파일
비밀번호 / API Key / 인증서
10. .gitignore 기본 규칙
각 저장소에는 반드시 .gitignore를 만든다.
기본 예시:
.vs/
bin/
obj/
artifacts/
*.user
*.suo
*.log
*.zip
*.exe
*.dll
*.msi
runs/
*.pt
*.onnx
*.engine
PortableRuntime/
OfflineRuntime/
.env
appsettings.Production.json
config.local.json
11. 기존 NAS 폴더와 Git 역할
기존 NAS 폴더는 그대로 유지한다.
NAS 폴더
→ 납품본, 설치파일, 현장 백업, 이미지, 문서 보관
Git 저장소
→ 소스 코드, 수정 이력, 협업 관리
12. 저장소 생성 예시
사내 프로그램
98-internal-hai-studio
98-internal-groupware
98-internal-hansero-chat
현대자동차 울산공장
01-hmc-ulsan-bolt-inspection
01-hmc-ulsan-pin-inspection
01-hmc-ulsan-underbody-inspection
기아자동차 광주공장
02-kia-gwangju-misassembly-inspection
02-kia-gwangju-vision-system
통합 / 공통
97-common-vision-library
97-common-mes-interface
97-common-inspection-runtime
13. 권한 관리
- 조회만 필요한 사용자는 Read 권한
- 소스 수정 및 Push가 필요한 사용자는 Write 권한
- 저장소 설정 변경이 필요한 관리자는 Admin 권한
일반 개발자는 기본적으로 Write 권한을 사용한다.
14. 기본 작업 순서
1. 저장소 생성
2. README.md 작성
3. .gitignore 작성
4. 소스 코드 추가
5. commit
6. push
15. 주의사항
저장소 이름은 한 번 정하면 계속 사용하므로 신중하게 정한다. 한글 설명은 자유롭게 사용하되, 저장소 이름은 영어/숫자/하이픈으로 통일한다. 대용량 파일은 Git에 올리지 않고 NAS 공유 폴더 또는 Gitea Release로 별도 관리한다.