• 반납 기록을 클릭하면 모달창으로 자세한 반납 정보와 반납시 촬영된 기기 사진을 출력한다.

• 모바일 기기를 CRUD를 할수 있어야함
• 모바일 기기를 등록할때 고유한 UUID를 생성하여 저장해야함

@riyenas0925 @ckswjd99
병사 휴대폰 반납 현황을 알려주는 return Key가 필요해서 이슈 남겼습니다!
라즈베리파이에서도 반납완료/불출시 반납현황을 변경해주시면 좋을 것 같습니다.

• "true"(반납함), "false"(미반납), "error"(반납 에러) 값이 들어갈 Key가 필요합니다.

• view template engine으로 mustache 사용
• Bootstrap 4 기반

• 관리자 군번으로 소속된 병사들을 조회 한다
• 관리자 군번이 조회되지 않는다면 오류 메시지를 띄운다

• Intellij 내부에서 데이터베이스에 접속할수 있도록 TCP 서버 설정

• 라즈베리파이에서 QR코드를 스캔할때의 시간과 TOTP 값, seed값을 서버로 전송한다.
• 서버에서는 seed값과 Time-based값으로 TOTP값을 생성하고 라즈베리파이에서 받은 TOTP값과 비교한다.

@ckswjd99 찬정님 QR코드에서 TOTP값과 seed값, 시간 이렇게 3개 서버로 전송할까 하는데 어떤가요?

• 병사들의 반납 여부를 현시간 기준으로 판단 (반납, 미반납, 지연 반납)

• 테스트 진행시 초기 데이터(data.sql)로 돌릴때 사용

• 나중에 추가된 기기가 제일 상단으로 가도록 수정

• 앱에서 네트워크 연결 없이 인증을 진행할수 있도록 하기 위해 TOTP를 사용
• seed는 Soldier entity에 UUID로 사용하기로 한 40자리 숫자로 이용
• otp 유지 시간은 10초로 설정

10월 21일 19시, 23시 데이터지만 아래와 같이 월과 시간이 UTC로 표시되는 오류가 있다.

serviceNumber, signUpCode 도입으로 더이상 기존의 rank와 unit key가 필요하지 않아서 이슈 남겼습니다, 또 관리자 앱에서 병사들의 반납 현황을 파악할 때 반납여부정보가 필요해서요. json에 return 키 추가 부탁드립니다.

*rank, unit Key 제거
*병사들의 반납현황을 보여주는 return key 추가 ("true", "false", "error"가 들어갈 예정입니다.)

위에 삭선은 #59 이슈로 생성

• Github Action 으로 CI 환경 구축
• AWS Code Deploy로 CD 환경 구축

• favicon.ico 설정
• 웹페이지 타이틀 국방모바일반납으로 설정
  

favicon.ico.zip

• 한명의 병사는 여러개의 모바일 기기를 가질수 있다. (Soldier와 Device는 1:n 관계임)
• 병사가 삭제되면 모바일 기기도 같이 삭제된다.

QueryDSL

• 정적 타입으로 된 SQL과 같은 쿼리를 구성할 수 있도록 해주는 프레임워크
• 타입안정성 (Type safety), 일관성(consistency)

이미 프로젝트에 RestController를 이용하여 mapping을 하였지만 아래처럼 경로를 인식하지 못하고 API문서가 만들어지지 않음...

증상

• 같은 Seed, 시간 값을 넣어도 OTP값이 다르게 생성

#!/usr/bin/env bash

REPOSITORY=/opt/OSAM_Hackathon
cd $REPOSITORY

APP_NAME=OSAM_Hackathon
JAR_NAME=$(ls $REPOSITORY/build/libs/ | grep '.jar' | tail -n 1)
JAR_PATH=$REPOSITORY/build/libs/$JAR_NAME

CURRENT_PID=$(pgrep -f $APP_NAME)

if [ -z $CURRENT_PID ]
then
  echo "> 종료할것 없음."
else
  echo "> kill -9 $CURRENT_PID"
  kill -15 $CURRENT_PID
  sleep 5
fi

echo "> $JAR_PATH 배포"
nohup java -jar $JAR_PATH > /dev/null 2> /dev/null < /dev/null &

APP_NAME이 잘못되어 있음

• 관리자가 병사들이 어플을 통해 가입할수 있도록 회원가입 코드를 확인하는 페이지
• 관리자 반납 시간과 불출 시간을 설정할수 있는 페이지

• 미반납, 상태 이상, 반납 순서로 표시

• 현재 아래와 같이 미반납 상태일때는 시간표시 부분에 null이라고 표시되지만 미반납으로 수정

• 전체 병사 정보를 조회 하는 기능 구현
• 병사중 모바일 기기가 2개 이상이면 아래처럼 표시한다

병사A - 모바일 기기 1
병사A - 모바일 기기 2

관리자 앱에서 병사들의 반납 현황을 표시할 때 등록한 병사 정보들을 불러오는 API가 필요해서 이슈 등록합니다!

• 하나의 SignUpCode 내에 담겨있는 병사 정보 모두를 불러올 수 있는 API

• ReturnState Enum 정의 (정상반납, 지연반납, 무게이상)
• 반납 기록(반납시간, 기기 무게)을 판단하여 정상반납, 지연반납, 무게이상 판별

• api상에서 deviceId를 넣으면 deviceId와 deviceId의 seed값으로 만들어진 totp을 QR코드로 변환
• QR코드 생성 라이브러리는 zxing 사용

QR코드 생성 데이터 예시

{
    "deviceId":1,
    "totp":"28783891"
}

API 자동 문서화

• swagger2 라이브러리 사용
• /swagger-ui 로 접속

• 관리자가 요일별로 핸드폰을 불출하고 반납하는 시간을 지정해둔다.
• 불출, 반납 시간은 관리자가 수정할 수 있다. (훈련 등의 이유로 변경이 필요할 때를 위함)
• 라즈베리파이 반납기에서 요청을 보내면 지금이 스마트폰 사용 가능 시간인지에 대해 True/False값으로 응답한다.

• 기존의 seed값만 반환하는 방식에서 deviceId, adminId도 포함하여 반환

서버 <-> App

• 서버에서 App으로는 deviceId, adminId, seed값을 넘겨주고 앱에서 저장한다.

앱

• 앱에서는 deviceId, adminId, seed값으로 만든 totp 값으로 QRCode를 생성한다

앱 <-> IoT

• IoT에서는 QRCode에서 deviceId, adminId, totp 값을 읽는다

• 일반인의 어플 가입을 제한
• 관리자가 제공하는 코드로 등록시 해당 관리자 소속 부대로 자동으로 병사 등록
• 병사가 소속을 임의로 등록시 잘못된 부대로 설정할수 있기때문에 관리자의 소속을 지정해두고 병사들이 관리자 코드를 입력하여 해당 관리자의 소속으로 지정되도록 구현
• 관리자 코드는 관리자가 생성될때 지정하며 사용자가 입력하기 쉽도록 고유한 숫자 8자리로 생성

• Rest API로 구성
• POST방식으로 앱에서 보내줌
• 반환값으로 UUID값을 반환
• 앱에서 보내주는 정보는 아래와 같이 구성

//requset
{
    "name" : "홍길동",
    "rank" : "병장",
    "unit" : "국방부 국직부대 정보체계개발단",
    "serialNumber" : "S/NSDF65SF45S4F52FD3AS3DF",
    "type" : "tablet",
    "manufacturer" : "삼성",
    "phoneNumber" : "010-1234-5678"
}

Log

Hibernate: select admin0_.id as id1_0_, admin0_.name as name2_0_, admin0_.password as password3_0_, admin0_.serviceNumber as servicen4_0_, admin0_.signUpCode as signupco5_0_ from Admin admin0_ where admin0_.signUpCode=?
Hibernate: select soldier0_.id as id1_2_, soldier0_.admin_id as admin_id6_2_, soldier0_.name as name2_2_, soldier0_.rank as rank3_2_, soldier0_.serviceNumber as servicen4_2_, soldier0_.unit as unit5_2_ from Soldier soldier0_ where soldier0_.serviceNumber=?
Hibernate: select device0_.id as id1_1_, device0_.manufacturer as manufact2_1_, device0_.phoneNumber as phonenum3_1_, device0_.serialNumber as serialnu4_1_, device0_.soldier_id as soldier_7_1_, device0_.type as type5_1_, device0_.uuid as uuid6_1_ from Device device0_ where device0_.serialNumber=?
Hibernate: insert into Soldier (id, admin_id, name, rank, serviceNumber, unit) values (null, ?, ?, ?, ?, ?)
Hibernate: insert into Soldier (id, admin_id, name, rank, serviceNumber, unit) values (null, ?, ?, ?, ?, ?)
Hibernate: insert into Device (id, manufacturer, phoneNumber, serialNumber, soldier_id, type, uuid) values (null, ?, ?, ?, ?, ?, ?)

위에 로그에서 보이듯이 Insert가 두번 이루어지고 있음

• 병사 정보 Key에 화면 크기정보 추가(7인치 이상인 경우 태블릿으로 인지하고 같은 군번이라도 서버에 병사 정보 등록이 가능하도록 함)

• Key Value중 'type' 정보를 삭제(위 화면 크기정보로 대체)

• 스프링 부트 시작시 병사, 핸드폰 정보를 자동으로 기입하여 추후에 검색 기능등에 사용
• data.sql 설정

• 병사가 소유하고 있는 기기 목록을 보여주고 기기에 해당하는 seed값을 통해 TOTP값과 QRCode 값을 관리자에게 보여주는 기능

• 현재 Exception시 단순히 throws 하기 때문에 상대측에서 에러에 대한 대응을 하지 못함
• json으로 에러메시지를 응답해 상대측에서 에러에 대한 대응을 할수 있게 한다,(toast 메시지 등등....)

라즈베리파이로 구성된 반납기로부터 아래와 같은 정보를 POST요청을 통해 받는다.

{
      deviceId : 기기 ID,
      returnTime : 기기가 반납된 시간,
      weight : 반납 시점에 측정된 기기의 무게,
      photo : 반납 시점의 핸드폰 사진 (Base64로 Encoding됨)
}

서버에서는 이를 바탕으로 반납 기록을 추가하고, 특이사항 여부를 점검한다.

응답으로는 반납 기록 추가가 성공했는지 여부를 전송한다.

Spring Boot Init, log4j2 설정, JUnit5 설정

• 빌드 결과물을 jar 파일로 저장
• batch, validation, web, log4j2, devtools 의존성 라이브러리 추가
• 데이터베이스는 h2로 설정

• 전체 반납 현황을 조회하는 페이지
• 비정상 반납 현황을 조회하는 페이지

phoneNumber, serialNumber Key를 제거하고 guid Key 생성

• 안드로이드에서 하드웨어 식별자 사용을 피하도록 권장하기 때문.
• https://developer.android.com/training/articles/user-data-ids?hl=ko 참고

• 현재 반납시간인지 알려주는 API가 Local 환경에서는 작동하나 Deploy 환경에서는 작동하지 않는 오류