1. 서비스 소개
2. 프로젝트 기획서
3. 주요 기능
4. 팀원 소개
5. 시연 방법

HDC랩스 NOVA FullStack 과정, 1팀의 First 프로젝트 Repository 입니다.
스마트 빌딩을 주제 각 디바이스들에 대한 원격 제어, 자동 데이터 수집 기능을 구현한 서비스입니다.
권한에 따라 지원되는 서비스를 구분하였으며,
크게 전체통제가 가능한 관리자와, 각 오피스 별 부분 사용자 역할로 구분이 됩니다.

시스템 아키텍처

ERD

MQTT API

📦src
 ┣ 📂main
 ┃ ┣ 📂java
 ┃ ┃ ┣ 📜smartbuilding.sql // Database, Tables 생성 시 실행할 sql파일
 ┃ ┃ ┣ 📜Main.java // psvm 메서드로 java를 실행하는 첫 파일
 ┃ ┃ ┣ 📂dao // DB 작업 (CRUD) 을 수행하는 DAO 파일이 들어가는 폴더
 ┃ ┃ ┣ 📂dto // 데이터 전달 형식을 class, DTO 단위로 들어가는 폴더
 ┃ ┃ ┣ 📂mqtt //MqttClient 클래스를 통해 Connect, Sub/Pub 가 구현된 파일 폴더
 ┃ ┃ ┣ 📂controller // 프로젝트에서 주요 기능들을 처리하는 로직8
 ┃ ┃ ┣ 📂service // 각 기능 별로 로직 구현하는 폴더
 ┃ ┃ ┣ 📂util // DB Connection, ANSI Escape Codes 등 static으로 초기 생성하는 데이터
 ┃ ┃ ┣ 📂config // Broker 서버, DB 서버와 관련된 민감정보들이 들어가는 폴더 (깃에 안올림)
 ┃ ┃ ┗ 📂view // 콘솔 화면, UI를 넣는 폴더

입력한 ID, PW 값으로 회원 조회를 하고, 권한에 맞게 관리자 / 사용자 페이지로 이동한다.
회원가입 시 회원 정보가 추가되며, 사용자 권한으로 가입된다.

로그인한 회원의 권한과 출입문을 비교하고, 제어할 수 있는 경우 해당 문을 원격으로 연다.
Mqtt 토픽을 통해 해당 출입문을 열고, 해당 데이터 로그를 DB에 저장한다.
제어할 수 없는 경우 콘솔에 제어 거부를 출력하고, 해당 데이터 로그를 DB에 저장한다.

콘솔 화면	디바이스 동작 결과	기능 설명
		엘리베이터 조작이 가능한 유저들의 목록을 콘솔에 출력한다. 유저마다 어떤 권한을 가지고 있는지, 몇 층에 접근할 수 있는지 등의 정보를 출력한다.
		엘리베이터 디바이스와 Mqtt 통신을 통해 엘리베이터의 현 위치와 상태를 출력한다.
		엘리베이터 이용 여부를 변경시킨다. 정지시킬 경우 엘리베이터를 이용할 수 없다.
		엘리베이터의 현재 위치를 확인하고, 현재 위치해 있는 층과 원하는 층을 입력해 엘리베이터를 움직인다.
		엘리베이터 호출, 이동과 관련된 로그 데이터를 DB에서 가져와 전체 출력한다.

사무실마다 제어할 수 있는 디바이스 목록들이 다르다. 권한에 따라 제어할 수 있는 사무실 목록들을 출력하고, 어떤 사무실을 제어할 지 선택한다.
사무실 선택 시, 디바이스 목록들이 출력되고, 제어할 수 있는 액추에이터를 선택해 제어 여부를 선택하게 한다.

콘솔 화면	디바이스 동작 결과	기능 설명
		실제 시연 장면 — 차량이 진입하면 게이트가 자동으로 열리고, 차량이 지나간 뒤 자동으로 닫히는 과정. MQTT 실시간 통신 기반으로 동작.
		서버(Java)에서 MQTT 메시지를 수신 후, parking_space 및 parking_log 테이블에 입·출차 기록 저장. 관리자는 콘솔 메뉴에서 전체 주차 현황 및 차량 로그를 확인할 수 있다.

콘솔 화면	디바이스 동작 결과	기능 설명
		로그인한 사용자는 최근 주차 내역을 조회할 수 있다.최근 입차 시간(last_in), 출차 시간(last_out), 총 이용 횟수(total_logs), 누적 주차 시간(total_minutes)을 표 형태로 출력한다.
		사용자가 차량 등록 메뉴를 선택하면 updateVehicle() 메서드가 실행된다. 이미 등록된 차량이 있을 경우 콘솔에 “이미 차량이 등록되어 있습니다.” 메시지가 출력되고, 새로 등록은 불가하다.
		로그인 후 getUserInfo() 메서드를 통해 users 테이블에서 자신의 정보를 조회한다. 이때 user_id, id, name, vehicle_no, access_level 등의 필드를 가져온다.

콘솔 화면	디바이스 동작 결과	기능 설명
		DHT11, MQ2 센서를 이용해 온도·습도·가스 수치를 측정하고, 측정값을 MQTT 프로토콜을 통해 브로커로 전송한다.
		MQTT 브로커로부터 센서 데이터를 구독(subscribe)하여 DB(environment_data)에 실시간 저장한다.
		Java 콘솔 프로그램에서 DB의 최신 센서 데이터를 조회하고, 임계값(온도·가스)을 초과할 경우 화재 경보(사이렌 부저 및 LED 반복 점등)를 발생시킨다. 관리자 메뉴를 이용하면 권한이 어락된 관리자는 수동으로 경보를 발생시킬 수 있다.
		발생한 화재 이벤트를 event_log 테이블에 기록하고, 경보 발생 시간·장소·센서값을 함께 출력한다. 수동으로 경보를 발생시킨 경우 수동으로 해제한다.

프로그램 실행에 MySQL8.0, Mosquitto가 필요합니다.
소스코드 실행 전에 미리 다운로드 받는걸 권장합니다.

위 프로그램은 자바 소스코드로, Eclipse 나 Intellij 환경에서 실행하는 걸 가정하에 설명드립니다.
먼저 소스코드를 로컬 환경에 다운로드 받습니다.

git clone https://github.com/iot-building/iot_server.git

다운받은 소스코드 내엔 build.gradle 파일이 있습니다.
build.gradle 내에 명시된 라이브러리들을 모두 받아야 정상 실행이 가능합니다.

파일 경로 "src/main/java/config/broker.properties" 에 파일을 만든다.
위 파일에는 broker.ip, broker.port가 포함되어야 한다.
로컬에서 Mqtt 브로커를 실행할 경우 아래와 같이 입력한다.

broker.ip = localhost
broker.port = 1883

파일 경로 "src/main/java/config/db.properties" 에 파일을 만든다.
위 파일에는 db.ip, db.port, db.database, db.user, db.password 가 포함되어야 한다.
로컬에서 MySQL 서버를 실행할 경우 아래와 같이 입력한다.

db.ip = localhost
db.port = 3306
db.database = smart_building
db.user = '사용할 db 유저'
db.password = '패스워드'

smartbuilding.sql 파일을 실행합니다(src/main/java/smartbuilding.sql).
실행 후 사용되는 데이터베이스, 테이블, 기본 레코드들이 데이터베이스 상에 있어야 합니다. 어떤 테이블이 필요한 지는 ERD를 참고하면 됩니다.