[고객지원 챗봇 만들기] 김준영 제출합니다.

build.gradle

@@ -26,6 +26,9 @@ dependencyManagement {
 dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-web'
     implementation 'org.springframework.ai:spring-ai-starter-model-openai'
+    implementation 'org.springframework.ai:spring-ai-advisors-vector-store'
+    implementation 'org.springframework.ai:spring-ai-markdown-document-reader'
+    implementation 'org.projectlombok:lombok'
 
     testImplementation 'org.springframework.boot:spring-boot-starter-test'
 }

data/evaluate.py

@@ -170,7 +170,7 @@ def main():
         if args.verbose:
             print(f"[{qid}] {marker} ({tier}) {question_ko[:40]}...")
             if score == 0:
-                print(f"        이유: {judgment.get('reason', '')[:80]}")
+                print(f"        이유: {judgment.get('reason', '')[:160]}")
 
         # 진행률 (10개마다)
         if not args.verbose and (i + 1) % 10 == 0:

src/main/java/com/cholog/bootcamp/ChatRequest.java

@@ -0,0 +1,6 @@
+package com.cholog.bootcamp;
+
+public record ChatRequest(
+    String question
+) {
+}

src/main/java/com/cholog/bootcamp/ChatbotController.java

@@ -0,0 +1,57 @@
+package com.cholog.bootcamp;
+
+import java.util.Map;
+
+import org.springframework.ai.chat.client.ChatClient;
+import org.springframework.ai.chat.client.advisor.SimpleLoggerAdvisor;
+import org.springframework.ai.chat.client.advisor.vectorstore.QuestionAnswerAdvisor;
+import org.springframework.ai.embedding.EmbeddingModel;
+import org.springframework.ai.vectorstore.SearchRequest;
+import org.springframework.ai.vectorstore.SimpleVectorStore;
+import org.springframework.ai.vectorstore.VectorStore;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import lombok.extern.slf4j.Slf4j;
+
+@Slf4j
+@RequestMapping("/api/chat")
+@RestController
+public class ChatbotController {
+
+    private final ChatClient chatClient;
+
+    public ChatbotController(ChatClient.Builder builder, EmbeddingModel embeddingModel, MarkdownReader markdownReader) {
+        VectorStore vectorStore = SimpleVectorStore.builder(embeddingModel).build();
+        vectorStore.add(markdownReader.loadAll());
+        QuestionAnswerAdvisor questionAnswerAdvisor = QuestionAnswerAdvisor.builder(vectorStore)
+            .searchRequest(SearchRequest.builder().topK(8).build())
+            .build();
+        this.chatClient = builder
+            .defaultAdvisors(questionAnswerAdvisor, new SimpleLoggerAdvisor())
+            .build();
+    }
+
+    @PostMapping
+    public Map<String, String> chat(@RequestBody ChatRequest request) {
+        String answer = chatClient.prompt()
+            .user(request.question())
+            .call()
+            .content();
+        return Map.of("answer", answer);
+    }
+
+    @PostMapping("/debug")
+    public Map<String, String> debugChat(@RequestBody ChatRequest request) {
+        Object RETRIEVED_DOCUMENTS = chatClient.prompt()
+            .user(request.question())
+            .call()
+            .chatClientResponse()
+            .context()
+            .get(QuestionAnswerAdvisor.RETRIEVED_DOCUMENTS);
+        log.info("RETRIEVED_DOCUMENTS: {}", RETRIEVED_DOCUMENTS);
+        return Map.of("answer", "answer");
+    }
+}

src/main/java/com/cholog/bootcamp/MarkdownReader.java

@@ -0,0 +1,37 @@
+package com.cholog.bootcamp;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.springframework.ai.document.Document;
+import org.springframework.ai.reader.markdown.MarkdownDocumentReader;
+import org.springframework.ai.reader.markdown.config.MarkdownDocumentReaderConfig;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.core.io.Resource;
+import org.springframework.stereotype.Component;
+
+@Component
+class MarkdownReader {
+
+    private final Resource[] resources;
+
+    public MarkdownReader(@Value("classpath:data/**/*.md") Resource[] resources) {
+        this.resources = resources;
+    }
+
+    public List<Document> loadAll() {
+        List<Document> allDocuments = new ArrayList<>();
+        for (Resource resource : resources) {
+            MarkdownDocumentReaderConfig config = MarkdownDocumentReaderConfig.builder()
+                .withHorizontalRuleCreateDocument(true)
+                .withIncludeCodeBlock(false)
+                .withIncludeBlockquote(false)
+                .withAdditionalMetadata("filename", resource.getFilename())
+                .build();
+
+            MarkdownDocumentReader reader = new MarkdownDocumentReader(resource, config);
+            allDocuments.addAll(reader.get());
+        }
+        return allDocuments;
+    }
+}

src/main/resources/application.yml

@@ -1,4 +1,6 @@
 spring:
+  config:
+    import: optional:file:.env[.properties]  # 루트의 .env 파일이 존재하면 .properties 형식으로 읽어 임포트
   application:
     name: spring-ai-bootcamp-basic
   ai:

src/main/resources/data/layer1_faq/account.md

@@ -0,0 +1,45 @@
+# Account & Membership
+
+## Cholog Corporation — Official FAQ
+
+### What are the membership tiers and their benefits?
+
+| Tier | Qualification | Free Shipping | Points | Extras |
+|------|--------------|---------------|--------|--------|
+| Standard | Default | Economy on orders ≥ 20,000 won | 1% | — |
+| Plus | Spend ≥ 200,000 won/year | Economy on all orders | 3% | Birthday double-points |
+| VIP | Spend ≥ 800,000 won/year | Priority on all orders | 5% | Early launch access, dedicated support line (1588-0002) |
+
+Tier status is evaluated on January 1st each year based on the prior year's spending.
+Returned items are deducted from annual spending totals and may trigger a tier downgrade.
+
+### How does the loyalty point system work?
+
+Points are earned at 1% (Standard), 3% (Plus), or 5% (VIP) of the pre-shipping order total.
+Points are credited 7 days after delivery confirmation and expire 12 months from the date
+earned. 1 point = 1 won. Minimum redemption: 1,000 points per order.
+
+### How do I create an account?
+
+You need a valid email address or Korean mobile number. You can also register instantly via
+Kakao, Naver, or Google SSO. All new accounts start at Standard tier and receive a one-time
+3,000 won welcome coupon valid for 30 days.
+
+### How do I permanently delete my account?
+
+Go to "Settings > Privacy > Delete My Account". After confirming with your password or
+a one-time verification code, deletion is scheduled within 7 business days. All personal
+data, order history, saved addresses, and payment tokens are purged under Korea's Personal
+Information Protection Act (PIPA). Unused points and coupons are forfeited upon deletion.
+
+### How do I enable two-factor authentication (2FA)?
+
+Go to "Settings > Security > Two-Factor Authentication". Choose SMS or an authenticator
+app (Google Authenticator, Authy). Once enabled, a 6-digit code is required at every login.
+Recovery codes are provided during setup — store them safely.
+
+### When do loyalty points expire?
+
+Points expire 12 months from the date they are earned. If you return an order, the points
+earned from that order are deducted within 24 hours of the refund. If your balance is
+insufficient, the deficit is carried forward and deducted from future earnings.

src/main/resources/data/layer1_faq/eco_green.md

@@ -0,0 +1,38 @@
+# Environment & Green Initiatives
+
+## Cholog Corporation — Official FAQ
+
+### What is the Eco Choice certification?
+
+Products bearing the green leaf "Eco Choice" badge meet at least one of: made from
+recycled materials, certified by Korea Eco-Label (환경부 인증), carbon-neutral shipping,
+or biodegradable packaging. Filter by "Eco Choice" in any product category to browse.
+Eco Choice status is reviewed annually and may be revoked if the product no longer meets criteria.
+
+### How does the Green Packaging option work?
+
+Select "Green Packaging" at checkout to receive your order in minimal, fully recyclable
+packaging with no plastic fillers. Green Packaging is free and reduces box size by up to
+40%. Each order using Green Packaging earns a 200-point eco bonus credited 7 days after
+delivery confirmation.
+
+### What is the Carbon Points program?
+
+Every completed order earns 1 Carbon Point per 1,000 won spent. Carbon Points accumulate
+in your account and can be donated to verified reforestation projects (1 Carbon Point =
+1 tree planted) or converted to 100 loyalty points each. Carbon Points do not expire
+and are separate from loyalty points.
+
+### How does the electronics take-back program work?
+
+Bring used electronics to any CU convenience store collection point. You receive 2,000
+loyalty points per item dropped off. For large items (TVs, appliances), free pickup can
+be scheduled through "Help Center > Electronics Recycling". Items are recycled through
+Korea's certified e-waste partners.
+
+### What eco-friendly packaging materials does Cholog use?
+
+Standard boxes are made from 80%+ recycled cardboard. Air pillows use plant-based
+biodegradable film. Tape is paper-based. The Green Packaging option eliminates all
+non-essential filler materials. Cholog aims to achieve 100% plastic-free packaging
+by end of 2026.

src/main/resources/data/layer1_faq/feedback.md

@@ -0,0 +1,29 @@
+# Complaints & Feedback
+
+## Cholog Corporation — Official FAQ
+
+### How do I file a complaint?
+
+Go to "Help Center > Submit Feedback" on our website or app. Select the category (product
+quality, delivery issue, website bug, suggestion, etc.) and describe your experience.
+Complaints receive an acknowledgment email within 2 hours and a full response from our
+customer experience team within 48 hours.
+
+### Can I leave a product review?
+
+Yes. Only customers who have purchased and received the product can leave a review —
+labeled "Verified Purchase". Photo and video reviews earn 500 bonus points. Reviews that
+violate community guidelines (spam, offensive content) are removed by our moderation team.
+
+### How do I report a counterfeit or unsafe product?
+
+Tap "Report" on the product page and select "Counterfeit Suspected" or "Safety Concern".
+Our quality assurance team investigates within 48 hours. If confirmed, the product is
+removed, the seller is penalized, and all affected buyers receive a full refund plus a
+10,000 won inconvenience coupon.
+
+### What is the Cholog Community Forum?
+
+The Community Forum at community.cholog.kr is a space for customers to ask questions,
+share tips, and discuss products. Staff moderators answer questions tagged "@staff".
+Active contributors earn Community Points exchangeable for coupons. Available in Korean only.

src/main/resources/data/layer1_faq/invoice.md

@@ -0,0 +1,26 @@
+# Tax Invoice & Receipts
+
+## Cholog Corporation — Official FAQ
+
+### How do I get a tax invoice (세금계산서)?
+
+A digital receipt is automatically emailed after every purchase. For a formal tax invoice,
+go to "My Orders", select the order, and tap "Request Tax Invoice". Enter your business
+registration number (사업자등록번호). Tax invoices are issued within 1 business day and
+sent to your registered email address.
+
+Tax invoice requests must be made within the same calendar month as the purchase.
+Requests for prior months are not accepted.
+
+### Can I get a receipt for a corporate expense report?
+
+Yes. The automatically issued digital receipt serves as a valid purchase receipt.
+For businesses requiring a tax invoice with VAT breakdown, follow the tax invoice
+request process above. Business accounts registered at b2b.cholog.kr can request
+monthly consolidated invoices covering all orders in the billing period.
+
+### What if I entered the wrong business registration number?
+
+Contact customer support within 1 business day of the original request. We can void
+and reissue a tax invoice with the correct number within the same calendar month.
+After the month closes, corrections are not possible under Korean tax law.

src/main/resources/data/layer1_faq/marketplace.md

@@ -0,0 +1,32 @@
+# Cholog Marketplace
+
+## Cholog Corporation — Official FAQ
+
+### What is Cholog Marketplace?
+
+Cholog Marketplace is our platform for verified third-party sellers. Marketplace products
+are clearly labeled with the seller's name on the product page and order confirmation.
+Cholog guarantees buyer protection on all Marketplace transactions up to 500,000 won.
+Beyond that amount, disputes are handled directly between buyer and seller.
+
+### Does the standard Cholog return policy apply to Marketplace items?
+
+No. Marketplace items follow the individual seller's return policy, which may differ
+significantly from Cholog's standard 14-day window. Return windows for Marketplace
+sellers range from 3 to 30 days depending on the seller. Always check the seller's
+policy on the product page before purchasing. Cholog's buyer protection guarantee
+covers cases of item not received or item significantly not as described.
+
+### How do I become a Marketplace seller?
+
+Apply at seller.cholog.kr with your business registration certificate, product catalog,
+and bank account details. Review takes approximately 5 business days. Approved sellers
+pay a commission of 5–12% per transaction depending on the product category. Sellers
+must maintain a customer satisfaction rating above 4.2 / 5.0 to remain listed.
+
+### What if I have a dispute with a Marketplace seller?
+
+Contact the seller directly first through the in-app messaging feature ("My Orders >
+Contact Seller"). If unresolved within 3 business days, you can escalate to Cholog
+Buyer Protection by selecting "Open Dispute" in "My Orders". Cholog mediates and may
+issue a full refund under the buyer protection guarantee within 5 business days.

src/main/resources/data/layer1_faq/orders.md

@@ -0,0 +1,49 @@
+# Orders & Order Management
+
+## Cholog Corporation — Official FAQ
+
+### How do I cancel an order?
+
+You can cancel an order by going to "My Orders" and tapping "Cancel Order" while the status
+is "Preparing". Cancellation is instant and the full amount is refunded to your original
+payment method. Once the status changes to "Shipped", cancellation is no longer possible —
+you must wait for delivery and then initiate a return.
+
+Note: Marketplace seller orders may have a shorter cancellation window. Check the seller's
+policy on the product page before placing the order.
+
+### Can I modify my order after placing it?
+
+You can change the delivery address only if the order status is still "Preparing". Go to
+"My Orders", tap the order, and select "Edit Address". Quantity changes and product swaps
+are not supported after checkout — cancel the order and place a new one instead.
+
+### How do I track my order?
+
+After dispatch, you receive a Hanjin Express tracking number via email and KakaoTalk.
+Use the "Track Shipment" feature in the Cholog app or enter the number at hanjin.kr.
+Real-time GPS tracking is available for Priority shipments only.
+
+### What is the cutoff time for same-day dispatch?
+
+Orders confirmed before 1 PM KST on business days are handed to the courier the same
+afternoon. Orders placed after 1 PM, on weekends, or on public holidays enter the dispatch
+queue for the next business day morning.
+
+### Can I combine multiple orders into one shipment?
+
+Orders placed within 30 minutes of each other and sharing the same delivery address may be
+combined automatically. To request manual consolidation, contact customer support before
+the first order enters "Shipped" status. Consolidation is not available for Priority or
+same-day shipments.
+
+### What happens if my package is lost or damaged in transit?
+
+Go to "My Orders", select the affected order, and tap "Report Issue". Upload photos of
+the damage or describe the missing items. Our logistics team investigates within 2 business
+days and offers a replacement shipment or full refund.
+
+### Can I schedule delivery for a future date?
+
+Yes. At checkout, select "Scheduled Delivery" and choose a date up to 14 days in advance.
+Available for Economy and Priority shipping tiers. Same-day delivery cannot be pre-scheduled.

src/main/resources/data/layer1_faq/packaging.md

@@ -0,0 +1,31 @@
+# Special Packaging & Delivery Types
+
+## Cholog Corporation — Official FAQ
+
+### Do you ship fresh or frozen products?
+
+Yes. Fresh and frozen items are shipped in insulated packaging with ice packs via CJ Logistics
+Fresh (dedicated cold-chain courier). Cold-chain delivery is available only Monday through
+Thursday to prevent weekend transit degradation. A flat cold-chain fee of 4,000 won applies
+regardless of order size. Cold-chain orders cannot be combined with standard shipments.
+
+### How are large or heavy items delivered?
+
+Items over 20 kg or classified as "Large Item" are delivered by a Lotte Global Logistics
+two-person team. Delivery includes placement in the room of your choice (ground floor).
+Buildings with restricted elevator access or stair-carry requirements incur an additional
+fee of 15,000 won per floor. Schedule large-item delivery at checkout or by contacting
+customer support.
+
+### What is the Green Packaging option?
+
+Select "Green Packaging" at checkout to receive your order in minimal, fully recyclable
+packaging with no plastic fillers. Green Packaging is free of charge and reduces box size
+by up to 40%, lowering carbon emissions. Each Green Packaging order earns a 200-point
+eco bonus credited 7 days after delivery.
+
+### Is gift wrapping available?
+
+Yes. Select "Gift Wrap" at checkout for 1,500 won per item. Includes a branded box,
+ribbon, and a personalized message card (up to 100 characters). Gift wrapping is not
+available for oversized items or Marketplace seller products.