Document local and production call flows
TaxBaik CI/CD / build-and-deploy (push) Successful in 4m51s

This commit is contained in:
2026-07-07 23:41:52 +09:00
parent aaca26c0d0
commit 2939de70d5
3 changed files with 52 additions and 19 deletions
+36 -1
View File
@@ -49,7 +49,42 @@
- 임시/스크래치 작업(스크린샷, 1회성 디버그 스크립트, 로그)은 저장소 밖(OS/세션 임시 폴더)에서 하고 절대 커밋하지 않는다. 저장소 안에서 꼭 필요하면 `.gitignore`에 등록된 `.scratch/`만 사용한다.
- 커밋 전 `git status`로 루트에 낯선 파일이 생기지 않았는지 확인한다. 빌드 산출물(runtimeconfig.json, deps.json, wwwroot 산출물 등)이 루트나 프로젝트 폴더 밖에 커밋되면 안 된다.
- 재현 맥락은 페이지별 수동 JS 호출이 아니라 `AdminTelemetryContext` 같은 공통 컴포넌트가 담당한다. 새 어드민 화면은 레이아웃 경유 기본값을 자동 상속해야 하며, 예외만 명시적으로 덮어쓴다.
- DB 접속 문자열은 임의로 손대지 않는다. `src/TaxBaik.Web/appsettings.json``src/TaxBaik.Web/appsettings.Development.json``ConnectionStrings:Default``Host=localhost;Database=taxbaikdb;Username=taxbaik;Password=taxbaik123`로 고정하고, 변경이 필요하면 문서와 검증 스크립트를 함께 수정한다.
- DB 접속 문자열은 환경별로 분리한다. `src/TaxBaik.Web/appsettings.Development.json`은 로컬 개발용 `Host=localhost;Database=taxbaikdb;Username=taxbaik;Password=taxbaik123`를 사용하고, 운영은 `systemd``ConnectionStrings__Default` 환경 변수로 실제 DB 호스트를 주입한다. 값이 바뀌면 문서와 검증 스크립트를 함께 수정한다.
## Environment Call Guide
### Local Test
- 실행:
```powershell
$env:ASPNETCORE_ENVIRONMENT = "Development"
dotnet watch run --project .\src\TaxBaik.Web\TaxBaik.Web.csproj
```
- 사용 설정:
- [`src/TaxBaik.Web/appsettings.json`](/D:/JobRoomz/taxbaik/src/TaxBaik.Web/appsettings.json)
- [`src/TaxBaik.Web/appsettings.Development.json`](/D:/JobRoomz/taxbaik/src/TaxBaik.Web/appsettings.Development.json)
- 로그인 검증:
- 개발 우회 계정 `test_admin / admin123`
- 또는 로컬 DB의 `admin` 계정
### Production
- 실행 주체:
- `taxbaik-admin.service` 또는 `taxbaik.service`
- 확인 명령:
```bash
ssh kjh2064@178.104.200.7
systemctl status taxbaik-admin
journalctl -u taxbaik-admin -n 100 --no-pager
```
- 재시작 명령:
```bash
ssh kjh2064@178.104.200.7
sudo systemctl daemon-reload
sudo systemctl restart taxbaik-admin
sudo systemctl status taxbaik-admin --no-pager -l
```
- 운영 연결 문자열은 서비스 파일의 `ConnectionStrings__Default`를 확인한다. 로컬 `appsettings.json`을 운영 기준으로 해석하지 않는다.
## Code Quality Harness