Community 자동 답변·지속 대화와 해결 기반 Knowledge Base

[dhslove]

개요

Community 질문을 한 번의 답변으로 종료하지 않고, 질문자가 해결 표시할 때까지 후속 댓글·이미지·로그 압축과 해결/재개 상태를 하나의 Conversation으로 관리합니다.

진행 중 답변은 전문 엔지니어가 플랫폼을 처음 접한 사용자에게 설명하는 쉬운 문장으로 즉시 공개합니다. 질문자가 Best Answer를 선택하면 선택 답변과 전체 대화를 종합한 Knowledge Base를 게시하고 해당 KB Post를 Discussion의 최종 Best Answer로 지정합니다.

주요 변경

• 기술지원 담당자와 Community 질문자를 위한 자동화 사용자 가이드 추가
• 최초 질문자 또는 등록된 Community 관리자 중 한 명의 해결 선택으로 Knowledge Base 생성
• 관리자 ID를 Gateway 운영 설정으로 판정하고 일반 참여자의 선택과 위조 역할 입력은 거부
• AI-Assistant 답변을 관리자 승인 없이 자동 공개
• 모든 사람 참여자의 후속 댓글에 응답하고 Assistant 자신의 Post만 제외
• 해결책·근거 있는 CLI·성공 기준을 먼저 제시하고 설명과 명령을 분리
• 반복 답변 재작성 및 진행되지 않는 답변 게시 차단
• 이미지·로그·ZIP/TAR.GZ 첨부자료를 같은 Conversation에서 분석
• 일반 질문 4,000자 계약 유지, 초과 대화는 최초 질문·최신 질문·직전 답변·필수 지침을 보존해 자동 압축
• Community 원문은 16,000자까지 수신·보관하고 내부 KB 종합은 별도 16,000자 계약 사용
• 첨부파일은 본문 글자 수와 분리해 파일당 10MB, 추출 합계 20MB, 압축 항목 100개, 압축률 20배, 로그 증거 120,000자 제한 적용
• 질문자가 선택한 해결 답변 중심 Knowledge Base 게시 및 최종 솔루션 지정
• 공개 KB의 적용 버전에는 실제 솔루션 적용 대상인 ABLESTACK Diplo만 표시
• Europa Preview와 제품 보완 판단은 내부 Evidence Ledger에만 유지
• 내부 Citation·Repository·Commit과 시스템 Marker 비공개
• Chat은 게시·실패·KB 최종 지정 상태 관찰 채널로 유지

Issue #76 공식 플랫폼 근거 보강

• Ubuntu 24.04, RHEL/Rocky, Windows의 QEMU Guest Agent 설치·시작·상태·로그 절차를 승인된 로컬 공식 자료로 추가
• ABLESTACK 문서와 모든 Source Profile을 먼저 검토하고, 로컬 공식 자료가 없거나 30일 갱신 기한을 넘긴 경우에만 공식 웹 검색
• Mold는 CloudStack과 가상화 질문의 libvirt/QEMU/KVM, Glue는 Ceph, Koral은 Kubernetes, Wall은 Grafana 공식 문서로 제한 보완
• 질문별 최소 도메인 Allowlist와 실제 web_search_call.action.sources URL을 이중 검증
• URL·이메일·IP·비밀정보를 검색 전에 제거하고 이미지·로그·압축 첨부 내용은 외부 검색 입력에서 제외
• 공개 답변에서는 Mold·Glue·Koral·Wall 제품명을 유지하고 내부 URL·Citation·Commit을 제거
• 공식 운영체제 진단에 필요한 /dev/virtio-ports/org.qemu.guest_agent.0은 복사 가능한 명령으로 안전하게 보존

Discussion #167 오류 복구

• Post #383을 솔루션으로 선택할 때 내부 KB Prompt 4,678자가 외부 일반 질문의 4,000자 계약에 걸려 ValidationError가 발생한 원인을 확인
• 외부 일반 질문 계약과 신뢰된 내부 KB 종합 계약을 분리해 Activepieces Flow 변경 없이 복구
• 기존 Webhook으로 재실행하여 AI Gateway HTTP 201 확인
• AI-Assistant Post #384를 게시하고 승인 상태 및 Chat 알림 확인
• Post #384를 Discussion #167의 최종 Best Answer로 지정
• 같은 Post #384를 제자리 갱신하여 공개 적용 버전을 ABLESTACK Diplo로 교정하고 KB Version 2로 감사 기록
• 공개 API에서 현재 적용 기준, 차기 참고 기준, ABLESTACK Europa, 제품 보완 비노출 확인

Discussion #168 교정

• 기존 Post #388을 삭제하거나 새로 만들지 않고 같은 Post와 멱등성 Marker를 보존해 교정
• Ubuntu VM에서 직접 실행할 apt install, 서비스 시작·상태·버전·로그 명령 제공
• 정상 판정과 실패 시 Guest Agent 통신 채널 확인을 별도 코드 블록으로 제공
• Community Case draftAnswer와 Post 본문을 같은 내용으로 동기화
• 외부 API HTTP 200, isApproved=true, Assistant User 40 확인

검증

• AI Gateway 0.14.7, Provider openai, Process·Database·Vector ready
• 로컬 Python 단위·통합 테스트 248건 전체 통과
• Versioned Golden Set 15건: Ubuntu·Rocky·Windows·Mold·Glue·Koral·Wall 포함
• Glue 공식 웹 실검색 6건, Mold 가상화 실검색 5건과 공식 도메인 제한 검증
• Discussion #168 Post #388 설치·상태·로그·통신 채널 명령과 DB 일치 확인
• PPTX 5슬라이드 overflow 없음, 보고서 PDF 3쪽과 발표 PDF 5쪽 전 페이지 시각 검수 완료
• GitHub→Chat 보호 서비스 Container·Image·Restart Count 불변

Issue #76 결과물

• 사용자 가이드: docs/guides/community-automation-user-guide.md
• 사용자 가이드 PDF: output/pdf/techflow-community-automation-user-guide.pdf
• 질문자·관리자 승인 변경 보고서: docs/reports/community-requester-admin-kb-approval-validation.md
• 설계: docs/plans/issue-76-guest-os-official-platform-evidence-design.md
• Runbook: docs/runbooks/community-conversation.md
• 구현·E2E 보고서: docs/reports/issue-76-guest-os-official-platform-evidence-validation.md
• 보고서 PDF: output/pdf/techflow-guest-os-official-platform-evidence-report.pdf
• 발표자료: output/presentation/techflow-guest-os-official-platform-evidence.pptx
• 발표자료 PDF: output/pdf/techflow-guest-os-official-platform-evidence-presentation.pdf
• 자산 Manifest: output/issue-76-guest-os-official-platform-evidence-manifest.json

Discussion #169 이미지 누락 복구

• 실제 PNG가 공개·사설 경로에서 HTTP 200인데 최초 Webhook에는 Artifact ID와 Warning이 모두 0건이었던 조용한 누락 확인
• Flarum 인라인 이미지 참조 수와 Artifact/Warning 처리 결과를 대조해 조용한 성공 차단
• Discussion #169의 실제 FoF Upload HTML을 회귀 시험으로 고정
• 첨부 처리 진단을 현재 분석 입력에만 사용하고 저장된 질문 원문과 최종 KB 맥락에서는 분리
• 실제 실패 기록이 없으면 KB의 다운로드 실패·화면 미확인 문구 제거
• AI Gateway 0.14.10, 전체 252 tests + 15 subtests 통과
• 실제 PNG를 OpenAI 종합 분석에 전달해 이미지 근거 1건 확인, 잘못된 다운로드 실패 문구 0건 검증
• 기존 Knowledge Base Post #392를 제자리 교정하고 KB Version 2·최종 Best Answer #392 확인
• KB 솔루션 확인 이벤트를 DB varchar(32) 경계에 맞춰 KB_SOLUTION_CONFIRMED로 수정
• 시험 서버 Gateway·Community Poller만 0.14.10으로 제한 배포, Source Reconciler와 GitHub→Chat Event Gateway 불변
• 복구 보고서: docs/reports/discussion-169-community-image-recovery.md

Closes #64
Closes #66
Closes #67
Closes #68
Closes #69
Closes #76
Closes #77
Relates #23
Relates #24
Depends on #61

[dhslove]

Discussion #164 실제 장애 복구를 PR #65에 추가 반영했습니다.

• macOS ZIP 메타데이터 제외와 실제 로그 보안 경계 유지
• 영구 첨부 오류의 안전 안내 전환 및 일시 오류 재시도
• Post 단위 원자적 Poller 체크포인트와 Discussion 장애 격리
• Activepieces Community Draft timeout 300초
• AI 일시 실패의 HTTP 503 재시도와 실패 Draft 동일 Version 복구
• AI Gateway 0.13.2 시험 서버 배포
• Post #361 보완 로그 재실행 후 최신 Review Post #362 생성
• Chat 알림, Case 승인 대기, Poller 안정화, 보호 서비스 불변 확인
• 보고서 PDF 및 프레젠테이션 PDF/PPTX 추가

검증: 201 tests, Flow 3개 valid/enabled, OpenAPI 34 operations, artifact QA 통과.

커밋: 03784cf

PR은 기존 계획대로 Draft 상태를 유지합니다. 현재 Discussion #164는 구현 장애가 해소됐고, Post #362에 대한 담당자 승인만 남아 있습니다.