docs: refresh README for fixes landed in this branch

- Drop the 'known build defect' callout — tsconfig now compiles
  cleanly with rootDir + ignoreDeprecations applied.
- Add SIGNATURE_HOST to the env var table.
This commit is contained in:
Claude Owner
2026-05-26 14:42:35 +09:00
parent acdaa4734f
commit 08de63b448

View File

@@ -73,6 +73,7 @@ db/
| `DEV` | 선택 | `true`면 글로벌 대신 `GUILDID`에만 슬래시 등록 | | `DEV` | 선택 | `true`면 글로벌 대신 `GUILDID`에만 슬래시 등록 |
| `DEBUG` | 선택 | `true`면 명령어 오류 스택 로깅 | | `DEBUG` | 선택 | `true`면 명령어 오류 스택 로깅 |
| `REPLACETEXT` | 선택 | 치환 사전(JSON 배열). 기본 사전(`def_replaceObj`)과 병합 | | `REPLACETEXT` | 선택 | 치환 사전(JSON 배열). 기본 사전(`def_replaceObj`)과 병합 |
| `SIGNATURE_HOST` | 선택 | 시그니처 서버 `host:port`. 미설정 시 `192.168.10.5:2967` 기본값 |
| `TTSPATH` | 선택 | `Config.ttsPath` getter만 정의돼 있고 현재 호출처 없음. 향후 사용 대비 환경변수만 받아둠 | | `TTSPATH` | 선택 | `Config.ttsPath` getter만 정의돼 있고 현재 호출처 없음. 향후 사용 대비 환경변수만 받아둠 |
## 실행 ## 실행
@@ -86,22 +87,13 @@ npm run dev
# 빌드 후 실행 (ts-cleaner가 dist/를 스캔하므로 먼저 만들어야 함) # 빌드 후 실행 (ts-cleaner가 dist/를 스캔하므로 먼저 만들어야 함)
mkdir -p dist mkdir -p dist
npm run build # ⚠️ 현재 tsconfig 결함으로 실패 — 아래 "알려진 빌드 결함" 참고 npm run build
npm start npm start
# 전역 슬래시 명령어 등록 (배포 파이프라인) # 전역 슬래시 명령어 등록 (배포 파이프라인)
npm run prod npm run prod
``` ```
> **알려진 빌드 결함 (TypeScript 6+ 환경)**
>
> 현재 `tsconfig.json` 상태에서 `tsc` 가 다음 두 에러로 실패한다:
> - `TS5101`: `baseUrl` 옵션이 사용중지(deprecated). `"ignoreDeprecations": "6.0"` 추가 필요
> - `TS5011`: `outDir`만 지정돼 있고 `rootDir` 미지정. `"rootDir": "./src"` 추가 필요
>
> Docker 빌드도 내부에서 `npm run build`를 실행하므로 같은 사유로 실패한다.
> 임시 우회로 `npm run dev`(ts-node)를 사용하거나, 위 두 옵션을 `tsconfig.json` `compilerOptions`에 추가하면 정상 빌드된다.
### Docker ### Docker
```bash ```bash
@@ -109,7 +101,7 @@ docker build -t tts_bot .
docker run --env-file .env -v $(pwd)/db:/app/db tts_bot docker run --env-file .env -v $(pwd)/db:/app/db tts_bot
``` ```
Dockerfile은 `node:20-alpine` 기반이며 `ffmpeg`을 설치한다. 단 위 "알려진 빌드 결함"이 해결돼야 이미지 빌드가 통과한다. Dockerfile은 `node:20-alpine` 기반이며 `ffmpeg`을 설치한다.
## 동작 흐름 요약 ## 동작 흐름 요약