← 앱으로 돌아가기

💊 MediTrack

AI 스마트 복약 관리 앱 - 기술 문서

📋 개요

MediTrack은 개인 및 가족의 복약을 스마트하게 관리하는 PWA(Progressive Web App)입니다. 복약 알림, 약물 상호작용 경고, 증상 추적, 복약 통계 등의 기능을 제공합니다.

✨ 주요 기능

💊 복약 관리

약 등록, 복용 시간 설정, 복용량 관리, 리필 알림

👨‍👩‍👧 가족 허브

한 계정에서 여러 가족 구성원의 약 관리

⚠️ 상호작용 경고

새 약 추가 시 기존 약과의 상호작용 체크

📝 증상 추적

기분, 에너지, 통증, 증상, 부작용 기록

📊 통계 대시보드

복약률, 연속 기록, 주간/월간 캘린더

📤 데이터 내보내기

JSON/CSV 형식으로 의료 기록 내보내기

🛠️ 기술 스택

Flask 3.0 SQLAlchemy PostgreSQL Gunicorn Docker PWA Vanilla JS

🔌 API 엔드포인트

인증

MethodEndpoint설명
GET/api/auth/csrfCSRF 토큰 발급
POST/api/auth/register회원가입
POST/api/auth/login로그인
POST/api/auth/logout로그아웃
GET/api/me현재 사용자 정보

가족 관리

MethodEndpoint설명
GET/api/family가족 구성원 목록
POST/api/family가족 구성원 추가
PATCH/api/family/:id가족 정보 수정
DELETE/api/family/:id가족 구성원 삭제

약 관리

MethodEndpoint설명
GET/api/medications약 목록 (family_id 필터)
POST/api/medications약 추가 (상호작용 체크)
GET/api/medications/:id약 상세
PATCH/api/medications/:id약 정보 수정
DELETE/api/medications/:id약 삭제

복약 기록

MethodEndpoint설명
GET/api/logs?date=YYYY-MM-DD특정 날짜 복약 기록
POST/api/logs복용 기록 추가
PATCH/api/logs/:id기록 상태 변경
POST/api/schedule/generate오늘 스케줄 생성

증상 & 통계

MethodEndpoint설명
GET/api/symptoms?days=7최근 증상 기록
POST/api/symptoms증상 기록 추가
GET/api/stats?days=7복약 통계
GET/api/calendar?year=&month=월별 캘린더 데이터

데이터 & 계정

MethodEndpoint설명
GET/api/export?format=json데이터 내보내기
DELETE/api/account계정 삭제

🔒 보안 기능

📱 PWA 기능

🚀 배포

Docker Compose로 배포:

cd /path/to/meditrack
docker compose up -d --build

© 2026 Pomepoko Labs. Built with ❤️ for better health management.