🏛 sapstack

"SAP에서는 스탠다드라서 안됩니다." — 표준씨 (브랜드 가이드)

SAP 운영을 위한 AI 데스크톱

설치하고, 그냥 물어보세요 — 표준 프로세스부터 우리 회사 커스텀 프로그램(Z/Y)까지.

Windows 데스크톱 앱 v2.6.0 · 24 플러그인 · 21 에이전트 · 23 커맨드 · CBO 스냅샷 · 폐쇄망 지원 · 6개 언어 · 컴플라이언스

🌐 🇰🇷 한국어 · 🇬🇧 English · 🇨🇳 中文 · 🇯🇵 日本語 · 🇩🇪 Deutsch · 🇻🇳 Tiếng Việt

sapstack은 SAP 현업과 컨설턴트를 위한 SAP 전용 AI 데스크톱 앱입니다. ADT도, 개발 권한도, API 키도 없이 — 앱을 켜고 질문 하나를 입력하면 됩니다.

"F110 돌렸는데 오류가 나요"            → Evidence Loop 4턴 진단 (가설→증거→검증→롤백)
"월마감 순서 알려줘"                   → 기간마감 시퀀스 + T-code/메뉴 경로
"ZFI0171이 뭐 하는 프로그램이에요?"     → 회사 커스텀 코드(CBO 스냅샷)를 읽고 현업 언어로 설명

밑단에는 SAP 운영 전체 라이프사이클(Configure → Implement → Operate → Diagnose → Optimize)을 커버하는 24개 모듈 지식·IMG 가이드·Best Practice·컴플라이언스가 깔려 있고, 같은 지식을 Claude Code·MCP·VS Code에서도 쓸 수 있습니다(→ 개발자·파워유저용 통합).

의사결정 원칙은 ETHOS.md — Ground-truth · 증거 우선 · 하드코딩 금지 · ECC≠S/4 · 현장 용어 · 운영자 결정.

홈 화면 입력창에 쓰면 끝 — 오류/장애는 Evidence Loop(INTAKE→HYPOTHESIS→COLLECT→VERIFY, 반증 조건·롤백 페어 필수)로, 사실 질문은 Quick Advisory로 자동 분기. 예시 질문 칩으로 첫 질문을 베껴 쓸 수 있습니다.

관리자가 커스텀 ABAP(Z/Y) 소스를 스냅샷으로 내보내면, 앱이 SAP 접속 없이 그 사본을 읽고 "이 프로그램이 뭐 하는 거예요?"에 현업 언어로 답합니다. 전달 채널 3가지 — 배포 ZIP 동봉 · 공유폴더 자동 갱신 · 설정에서 "ZIP에서 가져오기". 모든 답변에 스냅샷 기준일을 고지합니다. → docs/cbo-snapshot.md

provision.yaml 하나를 exe 옆에 동봉하면 첫 실행 때 LLM 연결(회사 키·게이트웨이·로컬 모델)· SAP 환경·현업 모드가 자동 설정 — 현업은 어떤 설정 화면도 보지 않습니다. 키 교체는 version 숫자만 올려 재배포. → docs/provisioning.md

질문 중심의 단순한 홈(카드 3장 + 예시 칩), 개발자용 메뉴 숨김, 도구 승인 프롬프트 없음 (read-only 기본). 설정 → 외관에서 전환.

로컬 추론 엔진 llama-server(llama.cpp) 번들 — GGUF 모델팩을 USB로 반입하면 인터넷 없이 동작. air_gapped: true면 크래시 리포팅·업데이트 폴링까지 차단. → docs/compliance/air-gapped-deployment.md

• 24개 모듈: FI · CO · TR · MM · SD · PP · HCM · PM · QM · WM · EWM · ABAP · BASIS · BTP · SFSF · S4Mig · GTS · BC · Cloud PE · Session 외
• 21개 에이전트: 16개 모듈 컨설턴트 + ABAP developer + Integration/S4 migration advisor + SAP tutor(신입 교육) + CBO explainer(현업용 커스텀 코드 해설)
• IMG 구성 프레임워크: 76개 SPRO 기반 가이드 (ECC vs S/4 차이·검증 방법 포함)
• 3-Tier Best Practice: Operational · Period-End · Governance
• 6개 언어: 한국어 · English · 中文 · 日本語 · Deutsch · Tiếng Việt (24 모듈 × 5 언어 quick-guide)
• 컴플라이언스: K-SOX · SOC 2 · ISO 27001 · GDPR · PII 자동 마스킹

상황 1: "MIGO로 입고를 전기하려는데 자꾸 안 돼요." — Evidence Loop가 단정 대신 증거로 좁혀갑니다.

Turn 1 · INTAKE      환경부터: ECC(EhP?) / S/4(릴리스?), 이동유형(MvT),
                     에러 메시지 전문(M7 xxx)을 확인.
Turn 2 · HYPOTHESIS  가설 A: 전기기간 미오픈 — 확인: MMRV에서 현재기간이 전기일과
                     일치하는가? (반증: 일치하면 A 기각)
                     가설 B: 이동유형/계정결정(OBYC) 문제 — 확인: …
Turn 3 · COLLECT     (운영자가 MMRV 조회 → 결과를 알려줌)
Turn 4 · VERIFY      기간 불일치 확정 → Fix: MMPV로 기간 이월 (시뮬레이션 먼저,
                     Transport 경유). Rollback 계획 + 관련 SAP Note 포인터 동봉.

상황 2: "ZFI0042가 뭐 하는 프로그램이에요?" — CBO 스냅샷(가상의 예시)을 읽고 이런 형식으로 답합니다.

한 줄 요약   (스냅샷의 소스 헤더·카탈로그에서 파생한 프로그램 목적 한 줄)
어디서 쓰나  실행 화면·버튼 기능 (T-code 매핑은 스냅샷 범위 밖이면 그렇게 고지)
처리 흐름   권한 확인 → 조회 → 목록/출력 등 소스에서 읽은 실제 흐름
주의할 점   현업이 마주칠 메시지와 대처 (추측 금지 — 스냅샷에 없으면 "없다"고 답함)
기준일      이 답변은 YYYY-MM-DD 스냅샷 기준입니다.

각 가설에는 반증 기준, 각 수정에는 롤백 계획. 프로덕션 직접 변경 없이 안내만 — 운영자가 결정합니다. (→ ETHOS)

받은 배포 ZIP이 있다면: 압축을 풀고 sapstack-Desktop-*-Portable-x64.exe 실행 — 끝. (관리자가 provision.yaml을 동봉했다면 설정 화면 없이 바로 질문할 수 있습니다.)

직접 설치: GitHub Releases에서 sapstack-Desktop-<버전>-Setup-x64.exe(NSIS, per-user, 관리자 권한 불필요) 또는 Portable을 받습니다. Git for Windows(Git Bash) 필수, 크기 약 249MB (v2.4.1 실측). → 설치: docs/desktop-install.md · 배포 패키징: docs/provisioning.md

SAP 데이터 경로 3가지 — 어느 쪽도 SAP를 수정하지 않습니다: ① 복붙 기본 ② ADT 읽기 전용 브리지(설정 > SAP 접속, docs/adt-bridge.md) ③ CBO 스냅샷(오프라인 사본, docs/cbo-snapshot.md)

git clone https://github.com/BoxLogoDev/sapstack.git && cd sapstack
./setup.sh        # Windows: ./setup.ps1   ·   점검만: ./setup.sh --check

자세히: docs/quickstart-5min.md

같은 SAP 지식을 쓰는 다른 입구들입니다.

/plugin marketplace add https://github.com/BoxLogoDev/sapstack
/plugin install sap-fi@sapstack sap-session@sapstack

npm install -g @boxlogodev/sapstack-mcp
sapstack-mcp --sessions-dir ~/.sapstack/sessions

VS Code Marketplace에서 "sapstack" 검색 → Install · (또는 GitHub Release의 .vsix 직접 설치)

git submodule add https://github.com/BoxLogoDev/sapstack sapstack
cp sapstack/.kiro/settings/mcp.json .kiro/settings/
cp sapstack/.kiro/steering/*.md .kiro/steering/

저장소 clone → 자동 인식. 상세: docs/multi-ai-compatibility.md

전체 가이드: docs/workflow.md

1. 절대 하드코딩 금지 — 회사코드·GL 계정·조직 단위 고정값 사용 금지
2. 환경 인테이크 우선 — SAP 릴리스·배포 모델·회사코드 확인 먼저
3. ECC vs S/4HANA 명시 구분 — 버전별 동작 차이 명확히
4. Transport 필수 — 운영 환경 변경은 항상 Transport 경유
5. 시뮬레이션 선행 — AFAB, F.13, FAGL_FC_VAL, MR11, F110 등
6. SE16N 편집 금지 — 운영 환경 데이터 직접 수정 권장 금지
7. T-code + SPRO 경로 — 모든 조치에 둘 다 제공
8. 한국어는 현장체 우선 — "코스트 센터 (원가센터, KOSTL)" 이중 병기

이 규칙들의 왜는 ETHOS.md, 전체 운영 규칙은 CLAUDE.md 참고.

5개 언어(en/zh/ja/de/vi) quick-guide는 Claude 작성 초안입니다. 각 언어 native speaker + SAP 도메인 전문가의 검수를 환영합니다.

• 절차·평가 기준·PR 형식: docs/TRANSLATION-REVIEW.md
• 피드백: Translation Feedback 이슈
• T-code/Note 번호는 번역 대상 아님 (원형 유지)

MIT License — 상업/비상업 사용 모두 자유. 저작권 표기 유지.

• 🐛 버그 리포트
• ✨ 기능 요청
• 💬 토론
• 📖 기여 가이드