project-3a69b0db

Introduction

Project-3a69b0db is a student-run AI automation agency based in Seoul, South Korea. The project aims to assist foreigner-friendly small businesses, such as hair salons, dental and aesthetic clinics, gyms, tattoo studios, cafés, language academies, and tour companies, in automating their Instagram customer inquiries in both English and Korean. The agency focuses on creating simple, repeatable systems using free no-code tools to auto-reply to direct messages (DMs) and comments, answer frequently asked questions, and capture booking leads directly into Google Sheets. This approach is tailored to the Korean digital ecosystem, where platforms like Instagram, Naver Maps, and KakaoTalk are prevalent.

System Overview

The system is designed to automate customer interactions on Instagram for small businesses in Korea. It leverages AI to handle inquiries in English and Korean, providing auto-replies to DMs and comments, addressing frequently asked questions about prices, hours, services, and location, and capturing booking leads into Google Sheets. The system is optimized for the Korean digital ecosystem, integrating with popular local tools such as Naver Maps and KakaoTalk.

Functional Requirements as Story Points

• As a small business owner, I want to automate Instagram DMs and comments to efficiently manage customer inquiries in English and Korean.
• As a small business owner, I want the system to answer frequently asked questions about prices, hours, services, and location automatically.
• As a small business owner, I want to capture booking leads directly into a Google Sheet for easy tracking and management.
• As a small business owner, I want the system to integrate with Naver Maps and KakaoTalk to provide location and communication support.
• As a student founder, I want AI to assist in research, outreach drafting, and bot building to focus on sending messages and closing deals.

User Personas

• Small Business Owner: Typically runs a foreigner-friendly business in Korea, such as a hair salon or café, and seeks to automate customer interactions on Instagram.
• Student Founder: An IB student managing the agency, focusing on leveraging AI for research and automation to streamline operations.

Core User Flows

• Small Business Owner sets up Instagram automation -> System auto-replies to DMs and comments -> System answers FAQs -> Booking leads are captured into Google Sheets.
• Student Founder uses AI tools for research -> AI drafts outreach and builds bots -> Founder sends messages and closes deals.

Visuals Colors and Theme

• primary: #1A73E8 (a deep blue representing trust and professionalism)
• primary_light: #E8F0FE (a light blue for hover states and secondary UI)
• secondary: #FF6F61 (a coral hue for headlines and emphasis)
• accent: #FFD700 (a vibrant gold for CTAs and active states)
• highlight: #FFA500 (an orange for hover states and notifications)
• bg: #FFFFFF (a clean white background)
• surface: rgba(240, 240, 240, 0.8) (a light grey for card/panel backgrounds)
• text: #333333 (a dark grey for primary text)
• text_muted: #777777 (a softer grey for secondary text)
• border: rgba(200, 200, 200, 0.2) (a subtle grey border)

Signature Design Concept

The homepage will feature an interactive "Digital Ecosystem Map" where users can explore the interconnected tools and platforms used in the Korean digital landscape. As users hover over each element (Instagram, Naver Maps, KakaoTalk), animations will illustrate how these tools integrate with the automation system. The map will be dynamic, with elements that expand and contract, demonstrating the flow of information and customer interactions. This concept will be built using motion/react for smooth transitions and interactions.

Landing Hero Motion Brief

The landing hero will depict a continuous loop of a small business owner receiving an Instagram inquiry, the system automatically responding, and a booking being captured in Google Sheets. The animation will feature layers of illustrated elements representing Instagram, Naver Maps, and KakaoTalk, with smooth transitions and a clear narrative arc. The animation will be created using motion/react, ensuring it is both engaging and informative.

Interaction Model & Motion Direction

The intended interaction model for the landing page is "animated." This will include moderate scroll-triggered reveals, hover transitions, and spring physics on interactive elements. Each section of the landing page will have a distinctive core mechanic, such as morphing SVGs or scroll-linked reveals, to maintain user engagement and convey the project's innovative approach.

Non-Functional Requirements

• The system must be reliable and handle a high volume of inquiries without downtime.
• The system should ensure data privacy and comply with local regulations regarding customer data.
• The user interface should be intuitive and easy to navigate for small business owners with limited technical expertise.

Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB
• AI Models: GPT 5.4 for user-friendly responses
• AI Tools: Litellm for LLM Routing, Langchain
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The system assumes that small business owners are familiar with Instagram and basic digital tools.
• The system is constrained by the availability of free no-code tools and their integration capabilities.
• The project assumes a stable internet connection for real-time automation and data capture.

Glossary

• DM: Direct Message
• FAQs: Frequently Asked Questions
• IB Student: International Baccalaureate Student
• Naver Maps: A popular mapping service in Korea
• KakaoTalk: A widely used messaging app in Korea