Skip to content

LikeLionHGU/guardian

Repository files navigation

🛡️ Guardian Edu - AI 학부모 민원 감정 방패 & 스마트 라우팅 시스템 (MVP)

선생님의 마음과 사생활을 지키는 인공지능 민원 보호 솔루션


📌 서비스 개요

Guardian Edu는 학부모의 감정적이고 강경한 민원이 교사에게 여과 없이 닿기 전, 인공지능(AI)이 먼저 민원의 어조와 핵심 내용을 분석하여 1차 방어막 역할을 수행하는 교사용 웹 서비스입니다.

정규 업무 시간 외의 심야 연락, 고소/신고 등 위협성 발언, 단순 행정 문의 등을 AI가 자동으로 식별하고 최적의 담당 부서로 라우팅하여 교사의 감정적 탈진(Burn-out)을 방지하고 학교 차원의 체계적인 대응망을 제공합니다.


✨ 주요 기능 및 특징

1. 🛡️ AI 감정 정화 방패 (순화된 요약)

  • 거친 비난과 압박성 발언을 필터링하고 사실 중심의 정제된 요약본을 제공하여 교사가 정신적 충격 없이 사안의 본질에 집중할 수 있도록 돕습니다.

2. 🎯 스마트 담당자 라우팅 & 긴급도 판단

  • 4단계 긴급도 산출: 낮음 / 보통 / 높음 / 즉시 확인 필요 (학생 안전 관련 사안 최우선 배치)
  • 부서별 자동 라우팅: 담임교사, 교과교사, 행정실, 생활지도부, 학교폭력 담당, 관리자/교감 등 가장 적합한 처리 주체를 즉시 배정.
  • 행정실 직통 이관: 급식, 스쿨뱅킹, 증명서 등 단순 행정 사안은 교사 확인을 생략하고 행정실로 직통 연결.

3. 👑 관리자 자동 개입 및 보고 판단

  • 직접적인 법적 조치(고소, 신고, 교육청 언급) 및 반복 악성 민원이 감지될 경우 관리자(교감/교장) 보고 필요 여부를 자동으로 활성화하여 개인 차원이 아닌 학교 차원의 방어망을 가동합니다.

4. ⚡ 8종 원클릭 데모 샘플 제공

  • 발표 및 시연 시 타이핑 없이 즉시 결과를 확인할 수 있도록, 학교 현장에서 빈번히 발생하는 8가지 대표 상황 샘플 데이터를 내장하였습니다.

🖥️ 주요 화면 구성 (5대 대시보드)

  1. 메인 대시보드: 실시간 AI 분석 통계 지표 및 최근 접수/분석된 민원 요약 카드 리스트.
  2. 민원 분석 입력 화면: 원클릭 8종 샘플 선택 및 상세 정보(채널, 시간대, 반복 여부, 안전 관련 등) 입력 폼.
  3. AI 분석 결과 화면: 10가지 필수 분석 지표(유형, 긴급도, 라우팅 대상, 권장 처리, 보고 필요 여부, 원문 vs 순화 요약, 판단 근거, 리스크 태그)를 한눈에 볼 수 있는 종합 리포트.
  4. 분석 기록 화면: 누적된 분석 기록을 제목, 유형, 긴급도별로 즉시 필터링 및 검색할 수 있는 아카이브.
  5. 서비스 소개 화면: 문제 상황, 솔루션, 4대 기대효과 및 정책 연계 방안을 설명하는 피칭 덱 화면.

🛠️ 기술 스택

  • Frontend: React 19, TypeScript, Vite
  • Styling: Tailwind CSS v4, Lucide Icons, Pretendard Font
  • State & Storage: LocalStorage API (브라우저 내 영구 보존 및 데모 데이터 자동 초기화)

🚀 설치 및 로컬 실행 방법

본 프로젝트는 별도의 백엔드나 복잡한 환경 설정 없이 브라우저 단독으로 실행 가능한 발표용 MVP입니다.

# 1. 저장소 클론 (또는 폴더 이동)
cd Guardian_BE

# 2. 의존성 패키지 설치
npm install

# 3. 로컬 개발 서버 실행
npm run dev

서버 실행 후 브라우저에서 http://localhost:5173 으로 접속하여 즉시 테스트할 수 있습니다.


💡 파일 구조 및 확장성 안내

  • src/services/complaintAnalyzer.ts: AI 분석 핵심 로직. 현재는 정교한 규칙 기반 AI Mock 엔진으로 동작하며, 추후 OpenAI API (fetch) 등으로 손쉽게 교체 가능하도록 비동기(async) 인터페이스로 분리 설계되어 있습니다.
  • src/services/storage.ts: 로컬스토리지 기반 누적 기록 및 데모 데이터 주입 관리자.
  • src/types/complaint.ts: 입출력 데이터 규격 및 타입 정의.

Releases

No releases published

Packages

 
 
 

Contributors

Languages