Upload README.md

README.md

@@ -0,0 +1,29 @@
+---
+title: BeeCareCore
+emoji: 🐝
+colorFrom: green
+colorTo: yellow
+sdk: streamlit
+sdk_version: 1.35.0
+app_file: app.py
+pinned: false
+---
+
+# 🐝 BeeCareCore 통합 연동 문서시스템
+
+이 저장소는 수급자등록, 상담일지, 사례관리를 하나의 Streamlit 어플리케이션 안에서 탭 구조로 통합 연동한 시스템입니다.
+
+## 🛠️ 주요 탑재 기능 (1차 통합 대상)
+1. **👥 수급자 등록 · 관리 (Tab 1)**: 수급자 정보 수기 등록, 엑셀 일괄 업로드, 가명 마스킹 처리 및 실시간 검색/수정.
+2. **📝 상담일지 작성 (Tab 2)**: 등록된 수급자를 연동하여 상담내용을 기록하고, AI 종합 소견을 임시 생성(임의 사실 날조 제한 기능 포함). 후속 업무(사례관리 회부 등) 체크 연동.
+3. **📋 사례관리 회의록 (Tab 3)**: 상담일지에서 **`사례관리필요`가 체크되었거나, `추가욕구요청사항`에 '사례관리' 키워드가 들어간 수급자**만 자동으로 목록에 노출 및 연동하여 회의록 기록.
+
+## 💾 데이터 저장 및 실시간 동기화
+* 모든 정보는 `data/clients.xlsx`, `data/counseling_logs.xlsx`, `data/case_management.xlsx` 엑셀 파일들로 로컬 디스크에 저장 및 가공됩니다.
+* 허깅페이스 컨테이너 재빌드 시 데이터가 소실되는 것을 막기 위해, 로그인/기동 시 및 저장 시 자동으로 **허깅페이스 Space 저장소로 실시간 업로드 및 다운로드 동기화**가 수행됩니다.
+
+## 🔑 필수 환경 변수 설정 (허깅페이스 Space Settings)
+데이터의 실시간 원격 백업 및 AI 소견 생성을 위해 허깅페이스 Space의 **Variables and Secrets** 메뉴에서 아래의 비밀키(Secret)를 등록해 주십시오.
+
+1. **`HF_TOKEN` (필수)**: 허깅페이스 **Write 권한**을 가진 Access Token. (데이터 실시간 자동 동기화/업로드에 필수적입니다)
+2. **`OPENAI_API_KEY` (선택)**: 상담 소견 및 사례 종합 의견 생성을 위한 OpenAI GPT API Key.