feat: 주요 CLI, 인증, 서비스 로직 및 문서 개선

README.md

@@ -105,6 +105,9 @@ portfoliohub user create --username alice --password password123 --email alice@e
 portfoliohub user get <user-id>
 portfoliohub user update <user-id> --username alice-updated --force
 portfoliohub user delete <user-id> --force
+portfoliohub bot token issue <bot-id> --name nightly --ttl-days 30
+portfoliohub bot token issue <bot-id> --name permanent --no-expiry
+portfoliohub bot token revoke <bot-id> <token-id> --force
 portfoliohub portfolio list
 portfoliohub portfolio status 005930:tv --recent 10
 portfoliohub portfolio create 005930:tv --symbol 005930 --cash-balance 10000000 --force
@@ -125,6 +128,8 @@ Supported commands:
 - `user create`
 - `user update`
 - `user delete`
+- `bot token issue`
+- `bot token revoke`
 - `portfolio list`
 - `portfolio status`
 - `portfolio create`
@@ -139,6 +144,13 @@ Supported commands:
 
 Write commands ask for confirmation by default. Use `--force` to skip the prompt for scripts and automation.
 
+Bot token issue policy:
+
+- 기본값은 365일 TTL이다.
+- `--ttl-days`와 `--no-expiry`는 동시에 사용할 수 없다.
+- `--no-expiry`는 관리자 권한에서만 허용된다.
+- 토큰 원문은 발급 응답 1회 이후 마스킹된 값으로만 출력/기록된다.
+
 The CLI uses the same repository and settings layer as the HTTP API. To target the external TimescaleDB, set `PORTFOLIOHUB_DB_ENABLED=true` and provide `TIMESCALEDB_*` values in the environment or `.env`.
 
 Initialize a new database explicitly before the first use: