🧩 실벗 전체 구조 (기술 총정리)

실벗이 어떤 부품으로 만들어졌고, 어떻게 안전하게 동작하는지 한곳에 정리했습니다. 개발자·가족·관리자가 전체 그림을 이해하기 위한 페이지입니다.

한눈에 보는 실벗

실벗은 설치 없이 인터넷 주소로 쓰는 앱(PWA)입니다. 화면(프런트엔드)과 두뇌 역할을 하는 서버(백엔드), 정보를 담는 데이터베이스, 그리고 외부 AI·결제·메시지 서비스가 연결되어 있습니다.

사용한 기술

로그인·보안은 어떻게 지키나요?

• 비밀번호: 원문을 저장하지 않고 bcrypt로 암호화해 저장합니다.
• 로그인 유지: 세션(쿠키)과 JWT 토큰(HS256)을 함께 사용합니다. 세션이 먼저, 없으면 Bearer 토큰의 사용자(uid)를 확인합니다.
• 이메일 인증: 가입 시 인증 메일을 보내고, 링크를 눌러야 활성(active) 됩니다.
• CSRF 보호: 위조 요청을 막기 위한 토큰을 검사합니다.
• 요청 제한(rate limit): 로그인·AI 호출 등에 횟수 제한을 둡니다(파일 기반).
• 감사 로그(audit): 로그인, 결제, SOS, 관리자 행위 등 중요한 일은 모두 기록합니다.
• 세션 유지 기간: 30일.

AI는 어떻게 쓰이나요?

실벗은 DeepSeek AI를 세 가지 방식으로 사용합니다.

• 일반 대화(chat()): AI 말벗, 동네 질문, 생활 도움 등 — 한 번에 답을 받아옵니다.
• 실시간 스트리밍(stream(), SSE): 말벗 대화가 글자 하나하나 흐르듯 나타나게 합니다.
• 도구 호출(Function Calling): AI 비서가 사람 말을 이해해 일정 등록·약 등록·건강 기록 같은 7가지 도구를 스스로 실행합니다.

AI 말벗에는 6가지 대화 원칙이 적용됩니다: ① 항상 존댓말, ② 1~3문장으로 짧게, ③ 쉬운 말, ④ 의료 진단은 하지 않음, ⑤ 외로움에 공감, ⑥ 위급하면 119 안내.

데이터베이스 18개 표

API 한눈에 보기 (16개 그룹)