← 전체 프로젝트

PROJECT 01 · 블록체인 · AI Agent

새로이(SAEROI)

블록체인 기반 업사이클링 플랫폼

삼성청년 SW·AI 아카데미 프로젝트 우수상

프로젝트 개요

새로이는 폐소재 공급업체·가공업체·브랜드를 연결해 버려진 소재가 새 제품으로 이어지게 하는 블록체인 기반 업사이클링 플랫폼입니다. 공급업체는 폐소재를 등록해 판매하고, 가공업체는 소재를 가공하며, 브랜드는 소재를 구매해 제품을 생산·판매합니다. 주문·인계·생산 기록은 Hyperledger Besu에 남아 QR 패스포트로 누구나 제품의 소재 이력을 확인할 수 있고, 브랜드 담당자는 AI 여정 어시스턴트와 대화하며 소재 구매부터 판매까지 진행합니다.

주요 구현

소재 거래 API·화면과 지갑 서명 결과를 서버 상태에 연결했습니다. AI가 제안한 구매·결제 작업도 사용자 확인과 최신 상태 검증을 거치도록 설계했습니다.

진행 기간
2026.08 ~ 2026.09
팀 구성
6인 팀
담당 역할
Material–Brand 거래 및 AI Agent 백엔드·프론트엔드 개발

기술 스택

Backend
Java 21Spring BootJPA
Frontend
ReactTypeScriptTanStack Queryethers.js
Data / Chain
MySQLHyperledger Besu
AI
LLM Tool UseGMS API
시연 화면실제 프론트엔드에 시연용 목 데이터를 넣어 재현했습니다
01 · 서비스 첫 화면버려진 소재의 다음 쓰임을 소개하는 랜딩
02 · 쇼핑몰 · 상품 상세순환 소재로 만든 상품을 고르고 상세로 이동
03 · 소재 검색공급업체의 폐소재를 등급·가격·남은 양으로 비교
04 · AI 어시스턴트 · 소재 찾기만들 제품을 말하면 필요한 양을 계산하고 소재를 찾아 줌
05 · AI 어시스턴트 · 결제 카드구매 요청에 모델이 직접 결제하지 않고 확인할 카드를 띄움
06 · AI 어시스턴트 · 승인생산 확정처럼 되돌리기 어려운 작업은 사람이 눌러야 실행

01

서비스 소개

서비스 배경
버려지는 의류·원단 같은 폐소재는 공급업체, 가공업체, 브랜드를 차례로 거쳐야 새 제품이 됩니다. 업체마다 거래와 진행 상태를 따로 관리하면 소재가 어디서 와서 어떻게 가공됐는지 보여 주기 어렵고, 브랜드 담당자는 여러 업체와의 다음 할 일을 일일이 챙겨야 합니다.
서비스 목표
소재 거래부터 가공·생산·판매까지 한 플랫폼에서 이어지게 하고, 단계별 기록을 블록체인에 남겨 제품의 소재 이력을 투명하게 보여 줍니다. AI 어시스턴트가 업무를 안내하되, 상태를 바꾸는 작업은 사용자 확인과 서버 검증을 거치게 합니다.
대상 사용자
폐소재 공급업체 · 가공업체 · 브랜드 담당자 · 업사이클 제품 구매자

주요 기능

  • 소재 등록

    저울 사진 OCR로 무게를 인식해 소재를 등록하고, 증빙과 함께 소재 토큰(ERC-1155)을 발행합니다.

  • 소재 거래

    판매 등록, 검색·구매, 카카오페이 결제, 발송·수령 확인까지 진행하고 수령 시 온체인에서 소유권을 옮깁니다.

  • 가공

    가공업체를 찾아 가공을 요청하고, 가공비 결제·소재 인계·가공 결과 승인을 거칩니다.

  • 생산 · 판매

    생산 배치에 가공 소재를 투입해 확정하고 온체인에 기록한 뒤, 제품을 쇼핑몰에 등록해 판매합니다.

  • QR 패스포트

    로그인 없이 QR로 제품의 소재 이력(여정)을 공개 조회합니다.

  • AI 여정 어시스턴트

    대화로 소재 구매부터 판매까지 진행하고, 상태를 바꾸는 작업은 확인 카드를 승인한 뒤에만 실행합니다.

02

시스템 아키텍처

새로이의 MetaMask 지갑과 사용자, SSAFY EC2 Docker Compose 안의 Jenkins·Nginx·React·Spring Boot·MySQL·파일 저장소(Docker 볼륨, 설정 시 MinIO)·FastAPI OCR 서버, 외부 Hyperledger Besu·SSAFY GMS·Kakao API를 잇는 시스템 아키텍처
새로이(SAEROI) 시스템 아키텍처이미지를 누르면 크게 볼 수 있습니다

MySQL은 업무 데이터와 현재 상태를 관리하고, Hyperledger Besu는 주문·인계·생산 등의 블록체인 기록을 맡습니다. 블록체인 작업은 사용자 지갑 서명과 온체인 결과 확인을 거쳐 서버 상태에 반영합니다. AI는 기존 업무를 제안하고, 서버는 사용자 권한과 최신 상태를 확인해 실행 흐름을 연결합니다.

구성 요소별 역할

  • React 브랜드 화면

    소재 거래 화면과 대화창, 진행 패널, 결제·서명 확인 카드를 제공합니다.

  • Spring Boot Agent

    대화 이력과 실제 업무 상태를 조합하고 모델의 도구 요청을 조회 또는 승인 카드 생성으로 나눕니다.

  • 기존 도메인 서비스

    소재 거래·가공·생산·제품 서비스가 업무 규칙과 상태 변경을 처리합니다.

  • MySQL

    거래·프로젝트 관계, 대화 이력과 승인 대기 작업을 저장합니다.

  • Hyperledger Besu

    주문·인계·생산 등의 블록체인 기록을 다룹니다. 사용자 지갑으로 승인한 작업의 온체인 결과를 서버가 확인한 뒤 업무 상태에 반영합니다.

03

구현 기능

전체 서비스 안에서 직접 구현하거나 공동으로 맡은 기능입니다.

AI 여정 어시스턴트의 업무 도구

31개

  • 쓰기 · 승인 카드로 실행17
  • 읽기 · 바로 조회14
도구의 출처

31개

  • 기존 도메인 기능29
  • 대화 상태 도구2
확인 카드 유효기간

6시간

지나면 승인해도 실행하지 않습니다. 그사이 재고나 가격이 바뀌었을 수 있기 때문입니다.

  • 01본인 기여

    Material–Brand 소재 거래

    브랜드가 공급업체의 소재를 조회·구매하고 결제, 발송, 수령 상태를 확인하는 거래 API와 화면 흐름을 구현했습니다. 결제 이탈 거래 정리와 취소된 온체인 예약 해제도 다뤘습니다.

  • 02본인 기여

    브랜드 AI 여정 어시스턴트

    소재 검색·거래, 가공 요청, 생산 배치, 제품 등록·판매를 업무 도구 31개로 묶었습니다(기존 도메인 기능 29개, 대화 상태 도구 2개). 브랜드 담당자가 한 대화에서 현재 상태와 다음 할 일을 확인하도록 했습니다.

  • 03본인 기여

    승인형 업무 실행

    조회 도구는 바로 실행하고 구매·결제·생산 확정처럼 상태를 바꾸는 작업은 확인 카드를 만듭니다. 카드 승인 시 소유권·유효기간·현재 업무 상태를 다시 검사하며, 블록체인 작업은 사용자 지갑의 서명 결과까지 확인합니다.

  • 04본인 기여

    진행 상태와 후속 작업

    완료된 거래·가공·생산·제품의 연결 관계를 서버에서 따라가며 남은 일과 상대 업체를 기다리는 단계를 구분했습니다. 인자가 확정된 후속 작업만 서버가 자동 제안합니다.

기여 범위

본인 담당은 Material–Brand 거래와 AI 어시스턴트의 백엔드·프론트엔드입니다. 블록체인 설명은 전체 서비스의 맥락이며, 본인의 구현 기여는 거래·지갑 서명 결과·서버 상태를 연결한 흐름을 중심으로 표시했습니다.

04

트러블슈팅

문제와 해결, 확인한 결과를 적고 실제 코드와 테스트를 근거로 붙였습니다.

AI 도구 호출이 실제 작업이 되기까지

  1. 01도구 호출

    모델이 업무 도구 31개 중 하나를 선택

  2. 02 · 서버 검증읽기·쓰기 분기

    읽기 14개는 바로 실행, 쓰기 17개는 실행하지 않음

  3. 03 · 서버 검증확인 카드

    이미 끝난 일이거나 같은 대상의 카드가 열려 있으면 만들지 않음

  4. 04 · 서버 검증승인 시 재검증

    대화 소유자·유효기간·이미 처리됐는지 다시 확인

  5. 05도메인 실행

    기존 도메인 서비스가 업무 규칙을 최종 검사

  • 결제(PAYMENT)·확인(CONFIRM)·지갑 서명(WALLET_SIGN) 카드는 사용자가 화면에서 승인해야만 실행됩니다.
  • 방금 끝난 지갑 서명은 승인에 트랜잭션 해시가 함께 와서, 자기 카드를 '이미 처리됨'으로 오판하지 않습니다.

문제 해결

오래된 대화 정보가 실제 작업으로 이어지는 문제

문제
결제 이후에도 모델이 결제 이전 상태로 답하거나, 카드 번호를 생산 배치 번호처럼 사용하는 사례가 있었습니다.
해결
서버가 거래·가공·생산 상태를 읽어 별도 시스템 메시지로 제공하고, 수량·금액·카드 제목은 서버 조회값으로 구성했습니다. 대화 답변과 진행 패널이 같은 서버의 남은 일 판정을 사용하도록 연결했습니다.
결과
모델의 기억 대신 서버 상태를 기준으로 다음 작업을 판단합니다. 실제 운영 환경의 오류율 감소 수치는 측정하지 않았습니다.

핵심 코드

저장소에서 그대로 발췌했습니다 · S15P21E104 · origin/backend/develop

AgentTurnStore.javaL85–98

실제 업무 상태를 두 번째 system 메시지로 — 턴을 시작할 때 서버가 읽은 거래·가공·생산 상태를 기본 프롬프트와 분리해 넣고, 그 뒤에 대화 이력을 붙입니다.

@Transactional(readOnly = true)
public TurnPrompt loadPrompt(Long conversationId, String liveState) {
    AgentConversation conversation = load(conversationId);
    List<LlmMessage> messages = new ArrayList<>();
    messages.add(LlmMessage.system(promptBuilder.build(conversation)));
    if (StringUtils.hasText(liveState)) {
        messages.add(LlmMessage.system(liveState));
    }
    messages.addAll(store.toLlmMessages(store.history(conversationId)));
    if (endsWithOwnWords(messages)) {
        messages.add(LlmMessage.user(SCREEN_EVENT_NOTICE));
    }
    return new TurnPrompt(messages, registry.specs());
}

관련 테스트

저장소의 테스트 메서드입니다

AgentEventStateTests.java1개

  • 막힌 단계는 매 턴 시스템 프롬프트로 들어간다
판단 과정 단계별로 보기
  1. 대화 이력과 업무 정본 분리

    대화의 문장만으로 거래·재고·생산 상태를 판단하면 정보가 오래될 수 있음을 확인했습니다.

  2. 매 요청에서 실제 상태 재조회

    서버가 거래·가공·생산 상태를 읽어 별도 시스템 메시지로 제공하고, 수량·금액·카드 제목은 서버 조회값으로 구성했습니다.

  3. 업무 상태와 화면 판정 공유

    대화 답변과 진행 패널이 같은 서버의 남은 일 판정을 사용하도록 연결했습니다.

문제 해결

오래되거나 중복된 확인 카드의 실행 방지

문제
카드를 열어둔 사이 다른 화면에서 작업이 완료되거나, 같은 대상에 확인 카드가 여러 장 생성될 수 있었습니다.
해결
승인 요청에서는 대화 소유자·카드 유효기간과 이미 처리된 작업인지를 다시 확인한 뒤 실행하고, 나머지 업무 규칙은 도메인 서비스가 검사합니다. 이미 완료된 작업과 방금 끝난 지갑 서명을 구분하는 테스트를 작성했습니다.
결과
모델이 쓰기 작업을 직접 실행하지 못하게 하고, 승인 시점의 서버 상태를 다시 확인합니다.

핵심 코드

저장소에서 그대로 발췌했습니다 · S15P21E104 · origin/backend/develop

AgentToolExecutor.javaL76, L90–97, L102–109

쓰기 도구는 실행하지 않고 카드로 — 쓰기 도구는 실행 대신 확인 카드를 만들고, 같은 대상의 카드가 이미 열려 있으면 새로 만들지 않습니다. 읽기 도구만 바로 실행됩니다.

if (tool.isWrite()) {
    // ...
    // **같은 일에 카드를 두 장 만들지 않는다.** 카드를 만드는 문이 둘이라
    // (모델과 서버) 한쪽만 막으면 다른 쪽으로 중복이 들어온다. 실제로 온체인 기록
    // 카드가 자동으로 뜬 뒤 모델이 같은 거래에 한 장을 더 만들었고, 담당자가 한쪽만
    // 누르자 나머지가 영원히 남았다 — 서명은 다 끝났는데 "지갑 서명이 필요합니다"
    // 가 계속 떠 있었다.
    Optional<AgentPendingAction> already =
            openCards.sameWork(openCards.of(conversation.getId()), tool.name(), arguments);
    if (already.isPresent()) {
        // ...
        return alreadyProposed(already.get());
    }
    return propose(conversation, userId, tool, call, arguments, toolCallMessage, actionTtl);
}

try {
    AgentToolResult result = tool.execute(new AgentToolContext(userId, conversation), arguments);
    return result.payloadJson();
AgentActionStore.javaL73–82, L86–97

승인 시점에 다시 확인 — 카드의 소유자는 대화를 통해, 유효기간과 처리 여부는 승인 순간에 다시 확인합니다. 화면에서 먼저 처리된 일은 실패가 아니라 '이미 됨'으로 닫습니다.

// 액션 id 만으로는 소유자를 알 수 없다. 대화를 통해 확인한다 — require() 가
// 소유자 조건을 쿼리에 박아 두고 있어 남의 액션이면 여기서 not-found 가 난다.
AgentConversation conversation =
        conversationService.require(userId, action.getConversationId());

LocalDateTime now = LocalDateTime.now(clock);
if (!action.isPending() || action.isExpiredAt(now)) {
    action.expire();
    throw new BusinessException(AgentErrorCode.AGENT_ACTION_NOT_PENDING);
}
// ...
// 카드를 만든 뒤에 담당자가 화면에서 먼저 처리했을 수 있다. 그대로 실행하면 도메인이
// 거절하고, 담당자는 자기가 승인한 작업이 오류로 끝나는 것을 본다. 이미 끝난 일이면
// 실패가 아니라 "이미 됐다" 로 닫는다.
Optional<String> stale = executor.stalenessReason(conversation, userId, action, arguments);
if (stale.isPresent()) {
    action.markStale();
    store.appendAssistant(conversation, stale.get());
    log.info("Agent action stale on approval: id={} tool={}", actionId, action.getToolName());
    return new Outcome(conversation.getId(), false, stale.get());
}

AgentToolResult result = runOrFail(conversation, userId, action, arguments);

관련 테스트

저장소의 테스트 메서드입니다

AgentChatServiceTests.java2개

  • 읽기 tool 은 바로 실행되고 결과가 모델에게 돌아간다
  • 쓰기 tool 은 실행되지 않고 확인 카드만 만든다

AgentStaleActionTests.java4개

  • 이미 체인에 기록된 거래에는 카드를 띄우지 않는다
  • 카드를 만든 뒤 화면에서 먼저 처리했으면 승인해도 실행되지 않는다
  • 방금 한 서명이 자기 카드를 이미 처리됨으로 닫지 않는다
  • 해시가 없는 승인은 이미 처리됨 판정을 그대로 받는다

PendingActionServiceTests.java2개

  • 같은 액션을 두 번 승인할 수 없다
  • 남의 액션은 건드릴 수 없다

BrandStepAutoProposeTests.java2개

  • 자동으로 띄운 카드를 모델이 또 띄우지 못한다
  • 다른 거래의 카드는 막지 않는다
판단 과정 단계별로 보기
  1. 카드 생성 전 검사

    이미 완료된 작업인지 확인하고, 같은 도구·대상의 카드가 열려 있으면 새로 만들지 않고 기존 카드를 안내했습니다.

  2. 최신 상태 재검증

    승인 요청에서는 대화 소유자·카드 유효기간과 이미 처리된 작업인지를 다시 확인한 뒤 실행하고, 나머지 업무 규칙은 도메인 서비스가 검사합니다.

  3. 경계 사례 검증

    이미 완료된 작업과 방금 끝난 지갑 서명을 구분하는 테스트를 작성했습니다.

현재의 한계

대화별 동시 처리 제어는 현재 단일 서버 인스턴스의 메모리 잠금을 사용합니다. 다중 인스턴스 운영으로 확대할 경우 분산 조정이 필요합니다.

05

기술 선택 이유

기술 이름보다 해결하려던 작업과 적용 이유를 적었습니다.

Hyperledger Besu · 온체인 결과 연동

주문·인계·생산 기록과 서버의 업무 상태 연결

팀 서비스는 블록체인에서 처리한 결과를 사용합니다. 담당 거래 흐름에서는 지갑 서명 이후의 온체인 결과를 확인하고, 서버가 관리하는 진행 상태에 반영하도록 연결했습니다.

LLM Tool Use

기존 도메인 기능을 31개 대화형 업무 도구로 연결

기존 거래·생산 기능을 다시 구현하지 않고 모델의 제안을 기존 도메인 서비스의 실행 흐름에 연결했습니다.

Spring Boot · JPA

거래 상태와 승인 카드의 실행 조건 관리

모델의 대화 이력은 오래될 수 있어, 서버에서 실제 업무 상태·소유권·유효기간을 다시 확인하도록 책임을 분리했습니다.

React · ethers.js

거래 화면과 블록체인 작업의 사용자 지갑 승인 연결

ethers.js를 사용하는 지갑 서명 흐름을 거래 화면에 연결했습니다. AI의 작업 확인 카드와 사용자의 지갑 승인을 구분하고, 서명 이후의 결과를 서버 거래 상태와 이어주었습니다.

06

회고

AI의 답변과 실제 업무 상태는 서로 다른 책임으로 다뤄야 했습니다. 제안 시점과 승인 시점 사이의 상태 변화를 확인하는 방식은 결제뿐 아니라 생산 확정 같은 변경 작업에도 적용할 수 있는 설계 기준이 됐습니다.