277 lines
5.2 KiB
Markdown
277 lines
5.2 KiB
Markdown
# 한세로 Git 저장소 관리 규칙
|
|
|
|
한세로 Git 저장소는 소스 코드 이력 관리와 협업을 위한 공간입니다.
|
|
NAS 폴더 구조는 기존처럼 유지하되, Git 저장소는 프로그램 단위로 생성합니다.
|
|
|
|
---
|
|
|
|
## 1. 기본 원칙
|
|
|
|
* Git에는 소스 코드만 올린다.
|
|
* 설치파일, 실행파일, 빌드 결과물, 대용량 데이터는 올리지 않는다.
|
|
* 저장소는 고객사/공장/프로그램 단위로 구분한다.
|
|
* 저장소 이름은 영어, 숫자, 하이픈만 사용한다.
|
|
* 저장소 설명은 한글로 작성한다.
|
|
|
|
---
|
|
|
|
## 2. 저장소 이름 규칙
|
|
|
|
저장소 이름은 아래 형식을 사용한다.
|
|
|
|
```text
|
|
번호-고객사-공장-프로그램명
|
|
```
|
|
|
|
예시:
|
|
|
|
```text
|
|
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. 프로그램명 작성 규칙
|
|
|
|
프로그램명은 기능을 알 수 있게 작성한다.
|
|
|
|
예시:
|
|
|
|
```text
|
|
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에 올린다.
|
|
|
|
```text
|
|
소스 코드
|
|
프로젝트 파일
|
|
솔루션 파일
|
|
README.md
|
|
설정 샘플 파일
|
|
DB 스크립트
|
|
간단한 문서
|
|
간단한 샘플 데이터
|
|
```
|
|
|
|
---
|
|
|
|
## 9. Git에 올리지 않을 것
|
|
|
|
아래 항목은 Git에 올리지 않는다.
|
|
|
|
```text
|
|
bin
|
|
obj
|
|
.vs
|
|
exe
|
|
dll
|
|
zip
|
|
설치파일
|
|
빌드 결과물
|
|
런타임 폴더
|
|
학습 데이터
|
|
학습 모델
|
|
대량 이미지
|
|
로그 파일
|
|
현장 백업 파일
|
|
비밀번호 / API Key / 인증서
|
|
```
|
|
|
|
---
|
|
|
|
## 10. .gitignore 기본 규칙
|
|
|
|
각 저장소에는 반드시 `.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 폴더는 그대로 유지한다.
|
|
|
|
```text
|
|
NAS 폴더
|
|
→ 납품본, 설치파일, 현장 백업, 이미지, 문서 보관
|
|
|
|
Git 저장소
|
|
→ 소스 코드, 수정 이력, 협업 관리
|
|
```
|
|
|
|
---
|
|
|
|
## 12. 저장소 생성 예시
|
|
|
|
### 사내 프로그램
|
|
|
|
```text
|
|
98-internal-hai-studio
|
|
98-internal-groupware
|
|
98-internal-hansero-chat
|
|
```
|
|
|
|
### 현대자동차 울산공장
|
|
|
|
```text
|
|
01-hmc-ulsan-bolt-inspection
|
|
01-hmc-ulsan-pin-inspection
|
|
01-hmc-ulsan-underbody-inspection
|
|
```
|
|
|
|
### 기아자동차 광주공장
|
|
|
|
```text
|
|
02-kia-gwangju-misassembly-inspection
|
|
02-kia-gwangju-vision-system
|
|
```
|
|
|
|
### 통합 / 공통
|
|
|
|
```text
|
|
97-common-vision-library
|
|
97-common-mes-interface
|
|
97-common-inspection-runtime
|
|
```
|
|
|
|
---
|
|
|
|
## 13. 권한 관리
|
|
|
|
* 조회만 필요한 사용자는 Read 권한
|
|
* 소스 수정 및 Push가 필요한 사용자는 Write 권한
|
|
* 저장소 설정 변경이 필요한 관리자는 Admin 권한
|
|
|
|
일반 개발자는 기본적으로 Write 권한을 사용한다.
|
|
|
|
---
|
|
|
|
## 14. 기본 작업 순서
|
|
|
|
```text
|
|
1. 저장소 생성
|
|
2. README.md 작성
|
|
3. .gitignore 작성
|
|
4. 소스 코드 추가
|
|
5. commit
|
|
6. push
|
|
```
|
|
|
|
---
|
|
|
|
## 15. 주의사항
|
|
|
|
저장소 이름은 한 번 정하면 계속 사용하므로 신중하게 정한다.
|
|
한글 설명은 자유롭게 사용하되, 저장소 이름은 영어/숫자/하이픈으로 통일한다.
|
|
대용량 파일은 Git에 올리지 않고 NAS 공유 폴더 또는 Gitea Release로 별도 관리한다.
|