Agency v2 S2-B 보고 — Build + E2E + PG 4-tier + Integrity Manifest

보고 ID: agency-v2-s2b-20260503 작성일: 2026-05-03 작성자: Claude (임시 CEO) Sprint: S2-B (npm install + nest build + PM2 + E2E)

---

1. 한 줄 요약

S2-A (인프라 + skeleton) 직후 자동 S2-B 진행. NestJS api-gateway 빌드 + PM2 영구 가동 + Auth E2E + Agency CRUD E2E 6/6 + PG 4-tier user + DB 권한 분리 + sha256 manifest 모두 실측 검증 PASS. 거짓 완성 0건, PENDING 8건 정직 명시.

2. 검증 매트릭스 (정직 3분류)

✅ A. 실측 검증 완성 (23건)

영역	검증 결과
npm install workspaces	413 packages / 303MB / 18s
nest build	dist/main.js + 모든 모듈 컴파일
PM2 영구 등록	agency-v2-api online pid 3964435, 103.6MB, autorestart
health endpoint	{"status":"ok","db":true,...}
Auth register E2E	사용자 cmopnf87... 생성 + JWT 263 chars
Auth login E2E	JWT 발급, role STAFF 정확
RolesGuard (STAFF→403)	GET /agencies → "Forbidden / insufficient_role" ✅
SUPER_ADMIN promote	DB UPDATE 검증
re-login (SUPER_ADMIN JWT)	role=SUPER_ADMIN
Agency CRUD POST × 2	alpha (id cmopng12b...) + beta (id cmopng14c...)
Agency CRUD GET list	2개 array, ordered by createdAt desc
Agency CRUD GET :id	single agency
Agency CRUD PATCH	name 업데이트 + updatedAt 변경
Agency CRUD DELETE	status=ARCHIVED soft delete
DB SELECT 회귀	alpha ARCHIVED / beta ACTIVE 정확
PG 4-tier user 생성	super/rw/ro/audit (4 roles)
RO UPDATE 거부 검증	"permission denied for table User" ✅
DATABASE_URL super→rw	.env 변경 + PM2 restart
회귀 (rw user)	Auth + CRUD 정상 작동
sha256 manifest first record	61 files / 13569 bytes JSON
manifest verify	"OK: 61 files unchanged"
트레이딩 무중단	gunja-pair-hedge / multi-tenant / gate-pair-hedge / gate-admin active active
hospital 다른 PM2	28 online (27 + agency-v2-api 1)

⏳ B. 정직 PENDING (검증 불가 / 별도 sprint)

#	항목	사유
1	agency_db (v1) DROP	starium_postgres connection pool 만성 가득 (40/40 retry fail). PG max_connections 조정 또는 restart sprint 필요. agency_v2 별도 DB라 비즈니스 영향 0
2	Docker 앱 컨테이너 build	Dockerfile 작성됐으나 build 미시도. 현재 PM2 호스트 직접 실행 — 보안 spec L3 (Docker 격리)는 S5로 미룸 (변경 작아짐 후 일괄 컨테이너화)
3	Multi-tenant Prisma middleware	Auth + Agencies 외 모듈 추가 (clients/leads 등) 시 함께 — S3
4	OAuth 실 client (Google/Kakao/Naver)	사용자 외부 콘솔 액션 (Phase 2)
5	LLM API key (xAI/Gemini/Groq)	사용자 외부 액션, S3에서 사용
6	hospital-tamper-watch path 추가	보안 spec L1, 별도 보안 sprint
7	Web Next.js	S5
8	bot-connector	S3

⚠️ C. 진행 중 해결한 이슈 (4건)

1. minio port 9051 충돌 (다른 docker-proxy 점유) → 9061/9062 변경, .env + compose 일괄 갱신
2. Prisma 5.22 inline enum 158 validation error → Python regex로 multi-line 변환
3. Schema LeadScore 중복 정의 (S1-fix 잔재) → 깔끔히 재작성 (410 lines)
4. DB UPDATE shell escape → docker exec -i ... <<< "..." 또는 heredoc로 해결

3. E2E 시나리오 검증 (실 호출 결과)

[1] POST /api/v1/auth/register
    body: {email, password, name}
    → 201 Created
    → {accessToken, user: {sub, email, role: "STAFF", agencyId: null}}

[2] POST /api/v1/auth/login
    → 200 OK + JWT 263 chars

[3] GET /api/v1/agencies (STAFF JWT)
    → 403 Forbidden + {message: "insufficient_role"}
    ✅ RolesGuard 정상 동작

[4] DB: UPDATE "User" SET role='SUPER_ADMIN' WHERE email=...
    → UPDATE 1

[5] POST /api/v1/auth/login (재로그인)
    → 200 + JWT (role: "SUPER_ADMIN")

[6] POST /api/v1/agencies (SUPER_ADMIN JWT)
    body: {name, slug}
    → 201 Created + {id, name, slug, status: "ACTIVE", createdAt, updatedAt}

[7] GET /api/v1/agencies → 200 + 2 agencies array
[8] GET /api/v1/agencies/:id → 200 + single
[9] PATCH /api/v1/agencies/:id → 200 + updated name
[10] DELETE /api/v1/agencies/:id → 200 + status: "ARCHIVED" (soft delete)

[11] DB SELECT verify
     test-alpha: ARCHIVED / test-beta: ACTIVE

4. 보안 적용 (S2-B 단계)

보안 spec layer	적용 상태
L1 ld.so.preload immutable	hospital 호스트 그대로 (S1 sprint 결과)
L2 SSH 강화	별도 sprint (fail2ban 등)
L3 Docker 격리	data services만 Docker, 앱은 PM2 — S5에서 일괄 컨테이너화
L4 npm audit + sha256 manifest	manifest 첫 record (61 files OK) ✅
L5 DB user 4-tier	super/rw/ro/audit 생성 + DATABASE_URL=rw 적용 ✅
L6 시크릿 관리	.env 0600 / OAuth/LLM placeholder. sops/age는 Phase 2
L7 nginx WAF	conf 작성됨, 활성화는 사용자 또는 S3
L8 auditd	별도 sprint
L9 OAuth scope 최소	클라이언트 발급 후 적용
L10 Build server 분리	호스트 build (paperclip 또는 GitHub Actions로 이전 대기)
L11 health monitor cron	health endpoint 작성됨, cron 등록은 별도

→ L4 + L5 본 sprint 완성. 나머지 점진.

5. 산출물 (paperclip + hospital)

paperclip 정본

• /opt/star365-hq/docs/04-report/agency-v2-s2b-20260503.report.md (본 보고서)
• ~/.claude/projects/-opt/memory/agency-v2-s2b-build-e2e-20260503.md
• MEMORY.md 인덱스 (🚀 항목 갱신)

hospital 산출물

• /opt/agency-v2/apps/api-gateway/dist/ (nest build 결과)
• /opt/agency-v2/ecosystem.config.cjs (PM2)
• /opt/agency-v2/.integrity-manifest.json (61 files sha256)
• /opt/agency-v2/logs/ (PM2 log)
• DB user 4-tier (PG 안)

6. S3 다음 작업 (신호 받으면 진행)

1. agency_db (v1) DROP — starium_postgres 별도 처리 sprint
2. clients/staff/campaigns/leads/content 5 모듈 + Multi-tenant Prisma middleware
3. AI orchestrator 패키지 (LLM fallback chain) 구현
4. 리드 스코어링 AI (BullMQ + LLM call)
5. 모닝 브리핑 AI (cron 09:00 KST + Telegram)
6. nginx 활성화 (agency.starium.site SSL + sites-enabled 등록)
7. OAuth 실 client (사용자 외부 액션 후 통합)
8. Web Next.js (S5)

7. 안전 (S2-B 동안 0 영향)

• 트레이딩 (gunja×2 + gate×2) 모두 active 무중단 ✅
• 4서버 다른 서비스 0 영향 (hospital 다른 PM2 28 그대로) ✅
• starium_postgres 영향 0 (agency_v2는 dedicated 컨테이너 5441) ✅
• UFW / SSH / 재부팅 / 다른 DB DROP / 격리본 / scrapped 봉인 모두 0 ✅

8. 결론

S2-B = 23건 실측 PASS + 4 이슈 해결 + 8 PENDING 정직 명시.

agency-v2가 실 작동하는 NestJS API + PG + Redis + MinIO + JWT Auth + Role-based access control + 4-tier DB user + integrity manifest 까지 완성됨. CRUD 6개 액션 모두 E2E PASS.

S3에서 핵심 모듈 추가 시점에 Multi-tenant middleware 적용 + AI orchestrator 가동 → 비즈니스 가치 즉시 체감 시작.

— S2-B 보고 끝 —