보름달 🌝 #3.2 개발 - NUGU 플레이빌더 (한글)

1. 역할분담

이름	역할
김정인	애플리케이션 백엔드, NUGU 백엔드 프록시 개발
김진아	애플리케이션 프론트엔드, NUGU 플레이빌더 개발
정시현	애플리케이션 백엔드, NUGU 백엔드 프록시 개발
Theophile	애플리케이션 백엔드 머신러닝

2. 플레이빌더

    누구 플레이빌더는 간단한 코드 정의와 예시 문장 입력만으로 손쉽게 SKT NUGU 디바이스 및 애플리케이션에서 사용 가능한 AI 서비스를 만들 수 있는 개발 툴이다.    위 사진은 보름달의 NUGU 플레이 구조이다.

3. 기능

1) 감성을 두드리는 대화

2) 건강 Tip

3) 진통제 추천

4) 여성 건강 자가 진단

# case 1

# case 2

5) 평균 주기 조회

6) 실제 생리일 조회

7) 실제 생리일 입력

8) 생리 예정일 조회

4. 누구 플레이

1) 감성을 두드리는 대화

• Intent : ask.Mood

  주체	발화 예시	힘들어
  사용자	Entity	MOOD

• Action : ask.Mood

  주체	발화 예시	가끔은 털어놓는 게 도움이 될 수도 있어요 ...
  NUGU	-	-

2) 건강 Tip

• Intet : ask.Tip

  주체	발화 예시	배가 아파
  사용자	Entity	TIP

• Action : ask.Tip

  주체	발화 예시	저를 따라 심호흡을 해보세요 ...
  NUGU	-	-

3) 여성 건강 자가 진단

• Intent : ask.selfTest

  주체	발화 예시	자가진단할래
  사용자	-	-

• Action : answer.selfTest

  주체	발화 예시	어떤 자가진단을 원하세요? 생리혈 상태 자가진단은 1번, 생리혈 색깔 자가진단은 2번이라고 말씀해주세요.
  NUGU	-	-

  
  

  주체	발화 예시	1번
  사용자	Entity	NUMBER

  • check.bleedState : NUMBER === 1번

    주체	발화 예시	생리혈 상태 자가진단을 시작할게요. 생리대 양으로 따져보면, 하루에 생리대 5개 정도를 사용하는 것이 정상적인 생리의 양이라고 볼 수 있습니다. 생리량이 갑자기 많아졌으면 1번, 생리량이 너무 적으면 2번, 생리할 때 핏덩어리가 나오면 3번이라고 말씀해주세요.
    NUGU	-	-

    
    

    주체	발화 예시	1번
    사용자	Entity	NUMBER

    • check.bleedState_large : NUMBER === 1번

      주체	발화 예시	생리량이 갑자기 늘었을 경우, "스트레스가 평소보다 과했군." 하고 넘어가서는 안됩니다! 생리량이 급격하게 많이 늘었다면, 자궁근종을 의심해볼 수 있습니다. 그냥 넘겼다가 병을 키울 수도 있으니, 꼭 산부인과에 방문하여 검사를 받아보시는 것이 좋습니다!
      NUGU	-	-

    • check.bleedState_small : NUMBER === 2번

      주체	발화 예시	배란기가 지나면 자궁내막의 두께는 8mm 이상으로 두꺼워져야 하는데 그렇지 않은 경우에는 생리량이 적어지게 됩니다. 자궁내막이 8mm 이상으로 성장하지 않으면 수정 후 착상에 지장을 줄 수 있기 때문에 임신에 안 좋은 영향을 끼칠 수 있으니 꼭 기억해 주세요!
      NUGU	-	-

    • check.bleedState_mass : NUMBER === 3번

      주체	발화 예시	생리할 때 나오는 피의 덩어리를 한방에서는 어혈이라고 불러요. 심한 스트레스 등으로, 혈액과 기 순환이 잘 되지 않아서생기는 것으로 핏덩이가 많이 나오는 분들은 하복냉증이나 생리통이 심할 가능성이 커요. 몸을 따뜻하게 해주고 혈액순환이 잘 되도록 스트레칭이나 가벼운 산책 등 규칙적으로 운동하는 것이 자궁건강과 내 몸 건강에 좋아요!
      NUGU	-	-

  • check.bleedColor : NUMBER === 2번

    주체	발화 예시	생리혈 색깔 자가진단을 시작할게요. 생리혈 색깔이 선명한 분홍색이면 1번, 밝은 빨간색이면 2번, 어두운 자주색이면 3번, 주황빛이면 4번, 진한 갈색이면 5번, 검은색이면 6번이라고 말씀해주세요.
    NUGU	-	-

    
    

    주체	발화 예시	1번
    사용자	Entity	NUMBER

    • check.bleedColor_PINK

      주체	발화 예시	생리 초기에는 생리혈이 선분홍색을 띌 수 있지만, 생리 기간 중 핑크빛을 보인다면 내부손상, 성병 또는 호르몬 변화 등 건강 상의 문제가 있을 수 있으므로 산부인과 진단이 필요해요. 또한, 생리 기간 외에 이러한 출혈이 있다면 자궁염증 혹은 임신 가능성이 있으므로 정확한 검사를 위해 병원을 꼭 방문해주세요!
      NUGU	-	-

    • check.bleedColor_RED

      주체	발화 예시	흔한 생리혈 색깔로, 호르몬 수치가 적당하며 혈액순환이 원활할 경우 밝은 빨간색의 생리혈이 나타나요. 그러나 지나치게 밝은 분홍빛을 띈다면 에스트로겐 수치의 문제일수도 있어요. 다이어트, 또한 과도한 알코올 섭취로도 나타날 수 있어요.
      NUGU	-	-

    • check.bleedColor_PURPLE

      주체	발화 예시	생리량이 많을 경우 어두운 자주색의 덩어리 혈이 보일 수 있어요. 그러나, 타인과 비교했을 때, 자주 생리대를 교체해야 할 정도로 생리혈이 배출된다면 자궁근종, 자궁선근증 등 여성 질환의 신호일 수 있으므로 주의해주세요!
      NUGU	-	-

    • check.bleedColor_ORANGE

      주체	발화 예시	질염에 감염되었을 가능성이 높다고 볼 수 있어요. 질염은 흔한 질병이지만, 방치하게 되면 더 큰 질병 또는 다른 질병을 야기하고 확대시킬 수 있답니다! 질염이 심각하지 않다고 가볍게 생각하지 말고 초기에 병원을 찾는 것이 좋아요.
      NUGU	-	-

    • check.bleedColor_BROWN

      주체	발화 예시	오래된 생리혈이 나오는 것일 수 있으므로 생리 첫날 또는 끝자락 즈음이라면, 걱정하지 않아도 돼요! 그러나 생리 기간 중 진한 갈색의 생리혈이 나온다면, 이는 부정 출혈로 자궁근종 또는 자궁내막증 일 수 있어요!
      NUGU	-	-

    • check.bleedColor_BLACK

      주체	발화 예시	생리 끝 무렵, 또는 생리양이 많은 삼일에서 사일 경에, 검은색을 띄는 생리혈이 나올 수 있어요. 그러나 이 상태가 오래 지속된다면 자궁근종을 의심해 볼 수 있어요.
      NUGU	-	-

4) 진통제 추천

• Intent : ask.pill

  주체	발화 예시	약	추천해줘
  사용자	Entity	PILL	-

• Action : check.userID2

  주체	발화 예시	보름달 어플의 메인 페이지에있는 누구 스피커아이디를 말씀해주세요.
  NUGU	-	-

  
  

  주체	발화 예시	1
  사용자	Entity	user_ID

  • answer.pill

    주체	발화 예시	1	님의 정보를 알려드릴게요.
    NUGU	Entity	user_ID	-

    
    

    주체	발화 예시	그래
    사용자	Entity	YON

    
    

    주체	발화 예시	약을 추천해드릴게요. 게보린과 펜잘큐를 복용하세요.
    NUGU	Backend Parameter	pillPredict

    * answer.noPill : 데이터 베이스에 증상이 입력되지 않았을 경우

    주체	발화 예시	입력된 증상이 없어서 추천해드릴 수 없어요. 보름달 어플에서 증상을 입력해주세요.
    NUGU	-	-

    * answer.wrongID3 : 입력한 아이디가 데이터베이스에 존재하지 않을 경우

    주체	발화 예시	존재하는 아이디가 없어요. 보름달 어플 메인 페이지에서 누구 스피커 아이디를 확인해주세요.
    NUGU	-	-

    * answer.WRONG3 : YON가 '예'가 아닌 경우

    주체	발화 예시	보름달을 종료할게요.
    NUGU	-	-

    
    

5) 평균 생리 주기 조회

• Intent : ask.meanCycle

  주체	발화 예시	주기	알려줘
  사용자	Entity	MEANCYCLE	-

• Action : check.userID1

  주체	발화 예시	보름달 어플의 메인 페이지에있는 누구 스피커아이디를 말씀해주세요.
  NUGU	-	-

  
  

  주체	발화 예시	1
  사용자	Entity	user_ID

  
  

  • answer.meanCycle

    주체	발화 예시	1	님의 정보를 알려드릴게요.
    NUGU	Entity	user_ID	-

    
    

    주체	발화 예시	그래
    사용자	Entity	YON

    
    

    주체	발화 예시	회원님의 주기는	30	일 입니다.
    NUGU	Backend Parameter	-	meanCycle	-

    
    

    *  answer.noMeanCycle : 데이터 베이스에 평균주기가 입력되지 않았을 경우, 
                            평균주기를 계산할 만큼 충분한 주기가 없을 경우

    주체	발화 예시	입력된 충분한 주기가 없네요. 어플에서 주기를 입력해주세요.
    NUGU	-	-

    
    

    * answer.wrongID3 : 입력한 아이디가 데이터베이스에 존재하지 않을 경우

    주체	발화 예시	존재하는 아이디가 없어요. 보름달 어플 메인 페이지에서 누구 스피커 아이디를 확인해주세요.
    NUGU	-	-

    * answer.WRONG3 : YON가 '예'가 아닌 경우

    주체	발화 예시	보름달을 종료할게요.
    NUGU	-	-

    
    

6) 실제 생리 주기 조회

• Intent : ask.cycle

  주체	발화 예시	이번 생리	언제 끝나?
  사용자	Entity	CYCLE_STATE	-

• Action : check.userID3

  주체	발화 예시	보름달 어플의 메인 페이지에있는 누구 스피커아이디를 말씀해주세요.
  NUGU	-	-

  
  

  주체	발화 예시	1
  사용자	Entity	user_ID

  • answer.cycle

    주체	발화 예시	1	님의 정보를 알려드릴게요.
    NUGU	Entity	user_ID	-

    
    

    주체	발화 예시	그래
    사용자	Entity	YON

    
    

    주체	발화 예시	회원님의 이번 생리 시작일은	2020-12-3	이고, 종료일은	2020-12-9	입니다.
    NUGU	Backend Parameter	-	cycleStart	-	cycleEnd	-

    * answer.noCycle : 최근 주기가 하나도 입력되지 않은 경우

    주체	발화 예시	입력된 주기가 없네요. 어플에서 주기를 입력해주세요.
    NUGU	-	-

    * answer.wrongID1 : 입력한 아이디가 데이터베이스에 존재하지 않을 경우

    주체	발화 예시	존재하는 아이디가 없어요. 보름달 어플 메인 페이지에서 누구 스피커 아이디를 확인해주세요.
    NUGU	-	-

    * answer.WRONG1 : YON가 '예'가 아닌 경우

    주체	발화 예시	보름달을 종료할게요.
    NUGU	-	-

    
    

7) 실제 생리 주기 입력

1 - 상대적 날짜

• Intent : input.cycle

  주체	발화 예시	나	오늘	생리	시작	했어
  사용자	Entity	-	DATE	-	CYCLE	-

• Action : check.userID5

  주체	발화 예시	보름달 어플의 메인 페이지에있는 누구 스피커아이디를 말씀해주세요.
  NUGU	-	-

  
  

  주체	발화 예시	1
  사용자	Entity	user_ID

  • output.cycleStart

    주체	발화 예시	1	님의 정보에 입력합니다.
    NUGU	Entity	user_ID	-

    
    

    주체	발화 예시	그래
    사용자	Entity	YON

    
    

    주체	발화 예시	생리 시작일을 입력했습니다.
    NUGU	-	-

    * answer.wrongID5_1 : 입력한 아이디가 데이터베이스에 존재하지 않을 경우

    주체	발화 예시	존재하는 아이디가 없어요. 보름달 어플 메인 페이지에서 누구 스피커 아이디를 확인해주세요.
    NUGU	-	-

    * answer.WRONG5_1 : YON가 '예'가 아닌 경우

    주체	발화 예시	보름달을 종료할게요.
    NUGU	-	-

  • output.cycleEnd

    주체	발화 예시	1	님의 정보에 입력합니다.
    NUGU	Entity	user_ID	-

    
    

    주체	발화 예시	그래
    사용자	Entity	YON

    
    

    주체	발화 예시	생리 종료일을 입력했습니다.
    NUGU	-	-

    - answer.wrongID5_2 : 입력한 아이디가 데이터베이스에 존재하지 않을 경우

    주체	발화 예시	존재하는 아이디가 없어요. 보름달 어플 메인 페이지에서 누구 스피커 아이디를 확인해주세요.
    NUGU	-	-

    - answer.WRONG5_2 : YON가 '예'가 아닌 경우

    주체	발화 예시	보름달을 종료할게요.
    NUGU	-	-

2 - 절대적 날짜

• Intent : input.pastCycleStart

  주체	발화 예시	2020년	12월	9일	에	생리 시작	했어
  사용자	Entity	START_YEAR	START_MONTH	START_DATE	-	PAST_CYCLE_START	-

• Action : add.pastPeriod

  주체	발화 예시	생리 시작을 입력하셨습니다. 생리를 며칠 동안 하셨는지 알려주세요. 이틀 동안 하셨다면, 2일이라고 말씀해주세요.
  NUGU	-	-

  
  

  주체	발화 예시	2	일
  사용자	Entity	PAST_PERIOD	-

  • check.userID6

    주체	발화 예시	보름달 어플의 메인 페이지에있는 누구 스피커아이디를 말씀해주세요.
    NUGU	-	-

    
    

    주체	발화 예시	1
    사용자	Entity	user_ID

    • output.pastCycle

      주체	발화 예시	1	님의 정보에 입력합니다.
      NUGU	Entity	user_ID	-

      
      

      주체	발화 예시	그래
      사용자	Entity	YON

      
      

      주체	발화 예시	생리 종료일을 입력했습니다.
      NUGU	-	-

      - answer.wrongID6 : 입력한 아이디가 데이터베이스에 존재하지 않을 경우
      - answer.WRONG6 : YON가 '예'가 아닌 경우

8) 생리 예정일 조회

• Intent : ask.predictCycle

  주체	발화 예시	생리 예정일	알려줘
  사용자	Entity	CYCLE_STATE	-

• Action : check.userID4

  주체	발화 예시	보름달 어플의 메인 페이지에있는 누구 스피커아이디를 말씀해주세요.
  NUGU	-	-

  
  

  주체	발화 예시	1
  사용자	Entity	user_ID

  • answer.predictBleed

    주체	발화 예시	1	님의 정보를 알려드릴게요.
    NUGU	Entity	user_ID	-

    
    

    주체	발화 예시	그래
    사용자	Entity	YON

    
    

    주체	발화 예시	회원님의 다음 생리는	2020-1-3	에 시작해서	2020-1-9	에 끝날 예정입니다.
    NUGU	Backend Parameter	-	predictStart	-	predictEnd	-

    * answer.NoPredictBleed : 입력된 과거의 주기가 없어서 예측이 불가능할 경우

    주체	발화 예시	입력된 주기가 없네요. 어플에서 주기를 입력해주세요.
    NUGU	-	-

    * answer.wrongID4 : 입력한 아이디가 데이터베이스에 존재하지 않을 경우

    주체	발화 예시	존재하는 아이디가 없어요. 보름달 어플 메인 페이지에서 누구 스피커 아이디를 확인해주세요.
    NUGU	-	-

    * answer.WRONG4 : YON가 '예'가 아닌 경우

    주체	발화 예시	보름달을 종료할게요.
    NUGU	-	-]

5. 백엔드 프록시 서버

    Backend proxy는 응답을 생성하기 위해 필요한 정보를 외부로부터 가져와야 하는 경우 사용하는 서버이다.
   NUGU developers 가이드에 따르면 version, resultCode, output이 필수 요소이다. 샘플 응답 형식에 맞춰서 responseController 모듈을 작성하였다.

const resSample = function () {
  let resSample = {
    version: "2.0",
    resultCode: "OK",
    output: {},
  };
  return resSample;
};

module.exports = { resSample };

    애플리케이션 백엔드와 구분하기 위해 routes 폴더의 proxyIndex 파일에서 라우팅을, proxyControllers 폴더에서 기능을 구현했다.
   각 컨트롤러에서 기능을 구현하고 responseController 형식에 맞추어 결과를 리턴한다.