Home / Project guide

Project guide

Project Guide | AIX Pilot

Free enterprise GenAI readiness scorecard for RAG, agent, DLP, eval, and KPI controls. This guide organizes the repository's original implementation notes for enterprise AI leaders and platform teams.

Reviewed 2026-07-28. This page is derived from checked-in repository evidence and links back to its source.

AIX Pilot

합성 문서로 로컬 검색, 근거 기반 초안, 개인정보 마스킹, 골든셋 평가, 파일럿 리포트를 검증하는 브라우저 기반 기업 AI 준비도 데모입니다.

System Overview

AIX Pilot is a browser-based enterprise AI readiness workbench. The public demo uses synthetic documents and local state; optional Ollama, Cloudflare Workers AI, and D1 adapters illustrate extension points without implying production readiness.

AreaDetails
UsersCustomer-center leaders, internal knowledge owners, IT governance teams, and AI adoption leads.
Technical pathValidate the demo, README, architecture notes, and quality gate before deeper workflow review.
System scopeRAG, Agent drafts, DLP masking, evaluation lab, KPI dashboard, value readiness model, presentation pack, and Cloudflare-ready deployment.
Operating boundaryDemo data is local and controlled; external deployments should use approved customer storage, access control, audit logs, and model routing.
Evaluation pathnpm run verify runs TypeScript checks, tests, production build, and content verification.

Evaluation Path

Architecture Notes

핵심 기능

기술 스택 임팩트

무료 기준 스택

영역기본 구현확장 옵션
UIReact, Vite, TypeScriptNext.js, Remix
RAG 검색로컬 TF-IDF/BM25 유사 검색Qdrant, Chroma, LanceDB
LLMOllama qwen2.5:1.5b + Workers AI free allocation + 규칙 기반 fallback사내 승인 LLM gateway
AgentPlaybook 기반 오케스트레이션LangGraph, CrewAI, n8n
보안DLP 패턴 탐지, 마스킹, 승인 플래그OPA, Keycloak, Authentik
평가Golden set + VitestPromptfoo, Ragas, LangSmith
운영 준비도Service readiness scoringSLO, incident runbook, SIEM
서비스 런칭Value readiness + service packagesCRM, billing, usage metering
KPIRechartsMetabase, Superset
배포Cloudflare Pages free tierWAF, custom domain, SSO
DBCloudflare D1 + localStorage fallbackGoverned Postgres/D1

실행

npm install
npm run dev

브라우저에서 http://localhost:5173으로 접속합니다.

빌드

npm run build

전체 QA

npm run verify

qa는 TypeScript 검사, Vitest 자동 테스트, 프로덕션 빌드를 순서대로 실행합니다. GitHub Actions에서도 모든 push와 pull request마다 같은 검증을 실행합니다.

운영 품질 게이트

파일 구조

src/
  App.tsx                # 대시보드 UI와 상호작용
  data/
    businessModel.ts     # 서비스 패키지, 검토자 심리, 문화 도입, 검증 실험 데이터
    sampleDocs.ts        # 고객센터/사내지식 샘플 문서
    metrics.ts           # KPI와 운영 이벤트 샘플 데이터
    enterpriseSpec.ts    # 요구사항/로드맵/평가/보안 게이트 스펙 데이터
    serviceModel.ts      # 서비스 운영 모델, trust control, SLO, maturity 데이터
  lib/
    rag.ts               # 로컬 문서 청크화, 검색, 근거 답변 생성
    rag.test.ts          # RAG 랭킹과 fallback 테스트
    agent.ts             # Agent 초안 생성과 승인 단계
    agent.test.ts        # Agent 플레이북 테스트
    report.ts            # Markdown 파일럿 리포트 생성과 마스킹
    report.test.ts       # 리포트 개인정보 미노출 테스트
    valueModel.ts        # 회수 시간, 승인 단계, 운영 전환 신호 계산
    valueModel.test.ts   # 가치 검증 모델과 과장 포지셔닝 방지 테스트
    evaluation.ts        # 골든 질문셋 기반 RAG/보안 평가
    evaluation.test.ts   # 평가 점수와 DLP 회귀 테스트
    serviceReadiness.ts  # 운영 준비도 계산과 서비스 모델 무결성 검증
    serviceReadiness.test.ts # 운영 준비도와 trust model 테스트
    spec.ts              # 스펙팩 완성도와 ID 무결성 검증
    spec.test.ts         # 스펙팩 요구사항/게이트 테스트
    security.ts          # DLP 탐지와 마스킹
    security.test.ts     # DLP 탐지/마스킹 테스트
  styles.css             # 반응형 엔터프라이즈 UI
public/
  brand/
    aix-hero-generated.png  # 저작권 안전 제품 비주얼 백업 자산
    aix-hero-generated.webp # 브라우저용 최적화 백업 이미지
    aix-hero-4k.png         # 로컬 제작 4K 비주얼
    aix-motion.gif          # 로컬 제작 운영 흐름 GIF

데모 시나리오

상단 실행 버튼은 배송 지연 고객 응대 시나리오를 실행합니다. 전화번호가 포함된 요청을 넣어 RAG 답변, 이메일 Agent 초안, DLP 마스킹, 감사 로그가 함께 움직이는 것을 확인할 수 있습니다.

리포트 버튼은 현재 질의, 답변, 근거 문서, 보안 탐지, 파일럿 상태를 Markdown 리포트로 다운로드합니다. 리포트에는 감지된 전화번호, 이메일, 주민등록번호 패턴이 마스킹된 값으로 기록됩니다.

초기화 버튼은 업로드 문서와 감사 로그를 초기 샘플 상태로 되돌립니다.

실제 기업 파일럿으로 확장하는 순서

  1. 사내 문서 원천을 정리합니다: Google Drive, Confluence, SharePoint, Notion, Zendesk, GitHub Wiki.
  2. 문서 메타데이터를 통일합니다: 소유자, 최신일, 민감도, 접근 권한, 업무 태그.
  3. 로컬 검색을 Qdrant 또는 Chroma로 교체합니다.
  4. Ollama 같은 로컬 LLM을 연결하고 근거 없는 답변은 차단합니다.
  5. SSO/RBAC, DLP, 감사 로그를 먼저 붙이고 외부 발송 Agent는 휴먼 승인으로 제한합니다.
  6. 파일럿 KPI를 정합니다: 검색 성공률, 근거 포함률, 상담 처리 시간, 자동화 완료율, 보안 차단 건수.

상세 제품 스펙은 docs/PRODUCT_SPEC.md에 정리되어 있습니다. 서비스 운영 모델은 docs/SERVICE_OPERATING_MODEL.md, 서비스 런칭 전략은 docs/SERVICE_LAUNCH_STRATEGY.md, 아키텍처 케이스 스터디는 docs/ARCHITECTURE_CASE_STUDY.md, 위협 모델은 docs/THREAT_MODEL.md, 주요 의사결정은 docs/ADR에 정리되어 있습니다. 클라우드와 AI 운영 경계는 docs/cloud-ai-architecture.md와 docs/architecture/blueprint.json에 정리되어 있습니다.

무료 배포 옵션

이 프로젝트는 무료 기준의 설득력 있는 파일럿 데모를 목표로 합니다. 실제 개인정보나 고객 데이터를 넣기 전에는 반드시 접근 권한, 로그 보관, DLP 정책을 먼저 확정하세요.

Enterprise Productization

System Architecture

Service Architecture

Search And Service Surface