edit : 기본 rest서버구조 추가

2025-01-14 17:26:27 +09:00
parent e53282d7e7
commit bd28fcdca4
37 changed files with 4194 additions and 1 deletions
--- a/rest/app/api_request_sample.py
+++ b/rest/app/api_request_sample.py
@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+"""
+@File: api_request_sample.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: test api key
+"""
+
+import base64
+import hmac
+from datetime import datetime, timedelta
+
+import requests
+
+
+def parse_params_to_str(params):
+    url = "?"
+    for key, value in params.items():
+        url = url + str(key) + '=' + str(value) + '&'
+    return url[1:-1]
+
+
+def hash_string(qs, secret_key):
+    mac = hmac.new(bytes(secret_key, encoding='utf8'), bytes(qs, encoding='utf-8'), digestmod='sha256')
+    d = mac.digest()
+    validating_secret = str(base64.b64encode(d).decode('utf-8'))
+    return validating_secret
+
+
+def sample_request():
+    access_key = 'c0883231-4aa9-4a1f-a77b-3ef250af-e449-42e9-856a-b3ada17c426b'
+    secret_key = 'QhOaeXTAAkW6yWt31jWDeERkBsZ3X4UmPds656YD'
+    cur_time = datetime.utcnow()+timedelta(hours=9)
+    cur_timestamp = int(cur_time.timestamp())
+    qs = dict(key=access_key, timestamp=cur_timestamp)
+    header_secret = hash_string(parse_params_to_str(qs), secret_key)
+
+    url = f'http://127.0.0.1:8080/api/services?{parse_params_to_str(qs)}'
+    res = requests.get(url, headers=dict(secret=header_secret))
+    return res
+
+
+print(sample_request().json())
--- a/rest/app/common/config.py
+++ b/rest/app/common/config.py
@@ -0,0 +1,111 @@
+# -*- coding: utf-8 -*-
+"""
+@File: config.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: Configurations
+"""
+
+from dataclasses import dataclass
+from os import path, environ
+
+from rest.app.common import consts
+from rest.app.models import UserInfo
+
+base_dir = path.dirname(path.dirname(path.dirname(path.abspath(__file__))))
+
+
+@dataclass
+class Config:
+    """
+    기본 Configuration
+    """
+    BASE_DIR: str = base_dir
+    DB_POOL_RECYCLE: int = 900
+    DB_ECHO: bool = True
+    DEBUG: bool = False
+    TEST_MODE: bool = False
+    DEV_TEST_CONNECT_ACCOUNT: str | None = None
+
+    # NOTE(hsj100): SERVICE_AUTH_API_KEY (token 방식으로 진행)
+    SERVICE_AUTH_API_KEY: bool = False
+
+    DB_URL: str = environ.get('DB_URL', f'mysql+pymysql://{consts.DB_USER_ID}:{consts.DB_USER_PW}@{consts.DB_ADDRESS}:{consts.DB_PORT}/{consts.DB_NAME}?charset={consts.DB_CHARSET}')
+    REST_SERVER_PORT = consts.REST_SERVER_PORT
+
+    SW_TITLE = consts.SW_TITLE
+    SW_VERSION = consts.SW_VERSION
+    SW_DESCRIPTION = consts.SW_DESCRIPTION
+    TERMS_OF_SERVICE = consts.TERMS_OF_SERVICE
+    CONTEACT = consts.CONTEACT
+    LICENSE_INFO = consts.LICENSE_INFO
+
+    GLOBAL_TOKEN = consts.ADMIN_INIT_ACCOUNT_INFO.connect_token
+    
+    COOKIES_AUTH = 'Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MTQsImVtYWlsIjoia29hbGFAZGluZ3JyLmNvbSIsIm5hbWUiOm51bGwsInBob25lX251bWJlciI6bnVsbCwicHJvZmlsZV9pbWciOm51bGwsInNuc190eXBlIjpudWxsfQ.4vgrFvxgH8odoXMvV70BBqyqXOFa2NDQtzYkGywhV48'
+
+
+@dataclass
+class LocalConfig(Config):
+    TRUSTED_HOSTS = ['*']
+    ALLOW_SITE = ['*']
+    DEBUG: bool = True
+
+
+@dataclass
+class ProdConfig(Config):
+    TRUSTED_HOSTS = ['*']
+    ALLOW_SITE = ['*']
+
+
+@dataclass
+class TestConfig(Config):
+    DB_URL: str = environ.get('DB_URL', f'mysql+pymysql://{consts.DB_USER_ID}:{consts.DB_USER_PW}@{consts.DB_ADDRESS}/{consts.DB_NAME}_test?charset={consts.DB_CHARSET}')
+    TRUSTED_HOSTS = ['*']
+    ALLOW_SITE = ['*']
+    TEST_MODE: bool = True
+
+
+@dataclass
+class DevConfig(Config):
+    TRUSTED_HOSTS = ['*']
+    ALLOW_SITE = ['*']
+    DEBUG: bool = True
+    DB_URL: str = environ.get('DB_URL', f'mysql+pymysql://{consts.DB_USER_ID}:{consts.DB_USER_PW}@{consts.DB_ADDRESS}/{consts.DB_NAME}_dev?charset={consts.DB_CHARSET}')
+    REST_SERVER_PORT = consts.REST_SERVER_PORT + 1
+
+    SW_TITLE = '[Dev] ' + consts.SW_TITLE
+
+
+@dataclass
+class MyConfig(Config):
+    TRUSTED_HOSTS = ['*']
+    ALLOW_SITE = ['*']
+    DEBUG: bool = True
+    DB_URL: str = environ.get('DB_URL', f'mysql+pymysql://{consts.DB_USER_ID}:{consts.DB_USER_PW}@{consts.DB_ADDRESS}/{consts.DB_NAME}_my?charset={consts.DB_CHARSET}')
+    REST_SERVER_PORT = consts.REST_SERVER_PORT + 2
+
+    # NOTE(hsj100): DEV_TEST_CONNECT_ACCOUNT
+    # DEV_TEST_CONNECT_ACCOUNT: UserInfo = UserInfo(**consts.ADMIN_INIT_ACCOUNT_INFO)
+    # DEV_TEST_CONNECT_ACCOUNT: str = None
+
+    # NOTE(hsj100): SERVICE_AUTH_API_KEY (token 방식으로 진행)
+    SERVICE_AUTH_API_KEY: bool = False
+
+    SW_TITLE = '[My] ' + consts.SW_TITLE
+
+
+def conf():
+    """
+    환경 불러오기
+    :return:
+    """
+    config = dict(prod=ProdConfig, local=LocalConfig, test=TestConfig, dev=DevConfig, my=MyConfig)
+    return config[environ.get('API_ENV', 'local')]()
+    return config[environ.get('API_ENV', 'dev')]()
+    return config[environ.get('API_ENV', 'my')]()
+    return config[environ.get('API_ENV', 'test')]()
+
--- a/rest/app/common/consts.py
+++ b/rest/app/common/consts.py
@@ -0,0 +1,104 @@
+# -*- coding: utf-8 -*-
+"""
+@File: consts.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: consts
+"""
+
+# SUPPORT PROJECT
+SUPPORT_PROJECT_BASIC = 'PROJECT_BASIC'
+
+PROJECT_NAME = 'FERMAT-TEST'
+SW_TITLE= f'{PROJECT_NAME} - REST API'
+SW_VERSION = '0.1.0'
+SW_DESCRIPTION = f'''
+### FERMAT-TEST REST API
+
+## API 이용법
+  - 개별 API 설명과 Request/Response schema 참조
+
+
+'''
+TERMS_OF_SERVICE = 'http://www.a2tec.co.kr'
+CONTEACT={
+    'name': 'A2TEC (주)에이투텍',
+    'url': 'http://www.a2tec.co.kr',
+    'email': 'marketing@a2tec.co.kr'
+}
+LICENSE_INFO = {
+    'name': 'Copyright by A2TEC', 'url': 'http://www.a2tec.co.kr'
+}
+
+REST_SERVER_PORT = 51000
+DEFAULT_USER_ACCOUNT_PW = '1234'
+
+
+class AdminInfo:
+    def __init__(self):
+        self.id: int = 1
+        self.user_type: str = 'admin'
+        self.account: str = 'a2d2_lc_manager@naver.com'  # !ekdnfeldpsdptm1 다울디엔에스
+        self.pw: str = '$2b$12$PklBvVXdLhOQnIiNanlnIu.DJh5MspRARVChJQfFu1qg35vBoIuX2'
+        self.name: str = 'administrator'
+        self.email: str = 'a2d2_lc_manager@naver.com'  # daool1020
+        self.email_pw: str = 'gAAAAABioV5NucuS9nQugZJnz-KjVG_FGnaowB9KAfhOoWjjiQ4jGLuYJh4Qe94mT_lCm6m3HhuOJqUeOgjppwREDpIQYzrUXA=='
+        self.address: str = '대구광역시 동구 동촌로351 에이스빌딩 4F'
+        self.phone_number: str = '053-384-3010'
+        self.connect_token: str = 'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MSwiYWNjb3VudCI6ImEyZDJfbGNfbWFuYWdlckBuYXZlci5jb20iLCJuYW1lIjoiYWRtaW5pc3RyYXRvciIsInBob25lX251bWJlciI6IjA1My0zODQtMzAxMCIsInByb2ZpbGVfaW1nIjpudWxsLCJhY2NvdW50X3R5cGUiOiJlbWFpbCJ9.SlQSCfAof1bv2YxmW2DO4dIBrbHLg1jPO3AJsX6xKbw'
+
+    def get_dict(self):
+        info = {}
+        for k, v in self.__dict__.items():
+            if type(v) is tuple:
+                info[k] = v[0]
+            else:
+                info[k] = v
+        return info
+
+
+ADMIN_INIT_ACCOUNT_INFO = AdminInfo()
+
+FERNET_SECRET_KEY = b'wQjpSYkmc4kX8MaAovk1NIHF02R2wZX760eeBTeIHW4='
+AES_CBC_PUBLIC_KEY = b'daooldns12345678'
+AES_CBC_IV = b'daooldns12345678'
+
+COOKIES_AUTH = 'Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MTQsImVtYWlsIjoia29hbGFAZGluZ3JyLmNvbSIsIm5hbWUiOm51bGwsInBob25lX251bWJlciI6bnVsbCwicHJvZmlsZV9pbWciOm51bGwsInNuc190eXBlIjpudWxsfQ.4vgrFvxgH8odoXMvV70BBqyqXOFa2NDQtzYkGywhV48'
+
+JWT_SECRET = 'ABCD1234!'
+JWT_ALGORITHM = 'HS256'
+EXCEPT_PATH_LIST = ['/', '/openapi.json']
+EXCEPT_PATH_REGEX = '^(/docs|/redoc|/api/auth' +\
+                    '|/api/user/check_account_exist' +\
+                    '|/api/services' + \
+                    '|/api/temp' + \
+                    '|/api/dev' + \
+                    '|/static' + \
+                    ')'
+MAX_API_KEY = 3
+MAX_API_WHITELIST = 10
+
+NUM_RETRY_UUID_GEN = 3
+
+# DATABASE
+DB_ADDRESS = "localhost"
+DB_PORT = 53306
+DB_USER_ID = 'root'
+DB_USER_PW = '1234'
+DB_NAME = 'FM_TEST'
+DB_CHARSET = 'utf8mb4'
+
+# MAIL
+# SMTP_HOST = 'smtp.gmail.com'
+# SMTP_PORT = 587
+SMTP_HOST = 'smtp.naver.com'
+SMTP_PORT = 587
+MAIL_REG_TITLE = f'{PROJECT_NAME} - Registration'
+MAIL_REG_CONTENTS = '''
+안녕하세요.
+감사합니다.
+
+'''
--- a/rest/app/database/conn.py
+++ b/rest/app/database/conn.py
@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+"""
+@File: conn.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: DB Connections
+"""
+
+from fastapi import FastAPI
+from sqlalchemy import create_engine
+from sqlalchemy.ext.declarative import declarative_base
+from sqlalchemy.orm import sessionmaker
+import logging
+
+
+def _database_exist(engine, schema_name):
+    query = f'SELECT SCHEMA_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = "{schema_name}"'
+    with engine.connect() as conn:
+        result_proxy = conn.execute(query)
+        result = result_proxy.scalar()
+        return bool(result)
+
+
+def _drop_database(engine, schema_name):
+    with engine.connect() as conn:
+        conn.execute(f'DROP DATABASE {schema_name};')
+
+
+def _create_database(engine, schema_name):
+    with engine.connect() as conn:
+        conn.execute(f'CREATE DATABASE {schema_name} CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;')
+
+
+class SQLAlchemy:
+    def __init__(self, app: FastAPI = None, **kwargs):
+        self._engine = None
+        self._session = None
+        if app is not None:
+            self.init_app(app=app, **kwargs)
+
+    def init_app(self, app: FastAPI, **kwargs):
+        """
+        DB 초기화 함수
+        :param app: FastAPI 인스턴스
+        :param kwargs:
+        :return:
+        """
+        database_url = kwargs.get('DB_URL')
+        pool_recycle = kwargs.setdefault('DB_POOL_RECYCLE', 900)
+        is_testing = kwargs.setdefault('TEST_MODE', False)
+        echo = kwargs.setdefault('DB_ECHO', True)
+
+        self._engine = create_engine(
+            database_url,
+            echo=echo,
+            pool_recycle=pool_recycle,
+            pool_pre_ping=True,
+        )
+        if is_testing:  # create schema
+            db_url = self._engine.url
+            if db_url.host != 'localhost':
+                raise Exception('db host must be \'localhost\' in test environment')
+            except_schema_db_url = f'{db_url.drivername}://{db_url.username}:{db_url.password}@{db_url.host}:{db_url.port}'
+            schema_name = db_url.database
+            temp_engine = create_engine(except_schema_db_url, echo=echo, pool_recycle=pool_recycle, pool_pre_ping=True)
+            if _database_exist(temp_engine, schema_name):
+                _drop_database(temp_engine, schema_name)
+            _create_database(temp_engine, schema_name)
+            temp_engine.dispose()
+        else:
+            db_url = self._engine.url
+            except_schema_db_url = f'{db_url.drivername}://{db_url.username}:{db_url.password}@{db_url.host}:{db_url.port}'
+            schema_name = db_url.database
+            temp_engine = create_engine(except_schema_db_url, echo=echo, pool_recycle=pool_recycle, pool_pre_ping=True)
+            if not _database_exist(temp_engine, schema_name):
+                _create_database(temp_engine, schema_name)
+            Base.metadata.create_all(db.engine)
+            temp_engine.dispose()
+
+        self._session = sessionmaker(autocommit=False, autoflush=False, bind=self._engine)
+
+        # NOTE(hsj100): ADMINISTRATOR
+        create_admin(self._session)
+
+        @app.on_event('startup')
+        def startup():
+            self._engine.connect()
+            logging.info('DB connected.')
+
+        @app.on_event('shutdown')
+        def shutdown():
+            self._session.close_all()
+            self._engine.dispose()
+            logging.info('DB disconnected')
+
+    def get_db(self):
+        """
+        요청마다 DB 세션 유지 함수
+        :return:
+        """
+        if self._session is None:
+            raise Exception('must be called \'init_app\'')
+        db_session = None
+        try:
+            db_session = self._session()
+            yield db_session
+        finally:
+            db_session.close()
+
+    @property
+    def session(self):
+        return self.get_db
+
+    @property
+    def engine(self):
+        return self._engine
+
+
+db = SQLAlchemy()
+Base = declarative_base()
+
+
+# NOTE(hsj100): ADMINISTRATOR
+def create_admin(db_session):
+    import bcrypt
+    from rest.app.database.schema import Users
+    from rest.app.common.consts import ADMIN_INIT_ACCOUNT_INFO
+
+    session = db_session()
+
+    if not session:
+        raise Exception('cat`t create account of admin')
+
+    if Users.get(account=ADMIN_INIT_ACCOUNT_INFO.account):
+        return
+
+    admin = {**ADMIN_INIT_ACCOUNT_INFO.get_dict()}
+
+    Users.create(session=session, auto_commit=True, **admin)
--- a/rest/app/database/crud.py
+++ b/rest/app/database/crud.py
@@ -0,0 +1,300 @@
+# -*- coding: utf-8 -*-
+"""
+@File: crud.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: CRUD
+"""
+
+import math
+from datetime import datetime
+from dateutil.relativedelta import relativedelta
+from sqlalchemy import func, desc
+
+from fastapi import APIRouter, Depends, Body
+from sqlalchemy.orm import Session
+from rest.app import models as M
+from rest.app.database.conn import Base, db
+from rest.app.database.schema import Users, UserLog
+from rest.app.utils.extra import query_to_groupby, query_to_groupby_date
+
+
+def get_month_info_list(start: datetime, end: datetime):
+    delta = relativedelta(end, start)
+    month_delta = 12 * delta.years + delta.months + (1 if delta.days > 0 else 0)
+
+    month_list = list()
+    for i in range(month_delta):
+        count = start + relativedelta(months=i)
+        month_info = dict()
+        month_info['period_title'] = count.strftime('%Y-%m')
+        month_info['year'] = count.year
+        month_info['month'] = count.month
+        month_info['start'] = (start + relativedelta(months=i)).replace(day=1)
+        month_info['end'] = (start + relativedelta(months=i + 1)).replace(day=1)
+        month_list.append(month_info)
+    return month_list
+
+
+def request_parser(request_data: dict = None) -> dict:
+    """
+    request information -> dict
+
+    :param request_data:
+    :return:
+    """
+    result_dict = dict()
+    if not request_data:
+        return result_dict
+    for key, val in request_data.items():
+        if val is not None:
+            result_dict[key] = val if val != 'null' else None
+    return result_dict
+
+
+def dict_to_filter_fmt(dict_data, get_attributes_callback=None):
+    """
+    dict -> sqlalchemy filter (criterion: sql expression)
+
+    :param dict_data:
+    :param get_attributes_callback:
+    :return:
+    """
+    if get_attributes_callback is None:
+        raise Exception('invalid get_attributes_callback')
+
+    criterion = list()
+
+    for key, val in dict_data.items():
+        key = key.split('__')
+        if len(key) > 2:
+            raise Exception('length of split(key) should be no more than 2.')
+
+        key_length = len(key)
+        col = get_attributes_callback(key[0])
+
+        if col is None:
+            continue
+
+        if key_length == 1:
+            criterion.append((col == val))
+        elif key_length == 2 and key[1] == 'gt':
+            criterion.append((col > val))
+        elif key_length == 2 and key[1] == 'gte':
+            criterion.append((col >= val))
+        elif key_length == 2 and key[1] == 'lt':
+            criterion.append((col < val))
+        elif key_length == 2 and key[1] == 'lte':
+            criterion.append((col <= val))
+        elif key_length == 2 and key[1] == 'in':
+            criterion.append((col.in_(val)))
+        elif key_length == 2 and key[1] == 'like':
+            criterion.append((col.like(val)))
+
+    return criterion
+
+
+async def table_select(accessor_info, target_table, request_body_info, response_model, response_model_data):
+    """
+    table_read
+    """
+    try:
+        # parameter
+        if not accessor_info:
+            raise Exception('invalid accessor')
+
+        if not target_table:
+            raise Exception(f'invalid table_name:{target_table}')
+
+        # if not request_body_info:
+        #     raise Exception('invalid request_body_info')
+
+        if not response_model:
+            raise Exception('invalid response_model')
+
+        if not response_model_data:
+            raise Exception('invalid response_model_data')
+
+        # paging - request
+        paging_request = None
+        if request_body_info:
+            if hasattr(request_body_info, 'paging'):
+                paging_request = request_body_info.paging
+                request_body_info = request_body_info.search
+
+        # request
+        request_info = request_parser(request_body_info.dict())
+
+        # search
+        criterion = None
+        if isinstance(request_body_info, M.UserLogDaySearchReq):
+            # UserLog search
+            # request
+            request_info = request_parser(request_body_info.dict())
+
+            # search UserLog
+            def get_attributes_callback(key: str):
+                return getattr(UserLog, key)
+            criterion = dict_to_filter_fmt(request_info, get_attributes_callback)
+
+            # search
+            session = next(db.session())
+            search_info = session.query(UserLog)\
+                .filter(UserLog.mac.isnot(None)
+                        , UserLog.api == '/api/auth/login'
+                        , UserLog.type == M.UserLogMessageType.info
+                        , UserLog.message == 'ok'
+                        , *criterion)\
+                .order_by(desc(UserLog.created_at), desc(UserLog.updated_at))\
+                .all()
+            if not search_info:
+                raise Exception('not found data')
+
+            group_by_day = query_to_groupby_date(search_info, 'updated_at')
+
+            # result
+            result_info = list()
+            for day, info_list in group_by_day.items():
+                info_by_mac = query_to_groupby(info_list, 'mac', first=True)
+                for log_info in info_by_mac.values():
+                    result_info.append(response_model_data.from_orm(log_info))
+        else:
+            # basic search (single table)
+            # request
+            request_info = request_parser(request_body_info.dict())
+
+            # search
+            search_info = target_table.filter(**request_info).all()
+            if not search_info:
+                raise Exception('not found data')
+
+            # result
+            result_info = list()
+            for purchase_info in search_info:
+                result_info.append(response_model_data.from_orm(purchase_info))
+
+        # response - paging
+        paging_response = None
+        if paging_request:
+            total_contents_num = len(result_info)
+            total_page_num = math.ceil(total_contents_num / paging_request.page_contents_num)
+            start_contents_index = (paging_request.start_page - 1) * paging_request.page_contents_num
+            end_contents_index = start_contents_index + paging_request.page_contents_num
+            if end_contents_index < total_contents_num:
+                result_info = result_info[start_contents_index: end_contents_index]
+            else:
+                result_info = result_info[start_contents_index:]
+
+            paging_response = M.PagingRes()
+            paging_response.total_page_num = total_page_num
+            paging_response.total_contents_num = total_contents_num
+            paging_response.start_page = paging_request.start_page
+            paging_response.search_contents_num = len(result_info)
+
+        return response_model(data=result_info, paging=paging_response)
+    except Exception as e:
+        return response_model.set_error(str(e))
+
+
+async def table_update(accessor_info, target_table, request_body_info, response_model, response_model_data=None):
+    search_info = None
+
+    try:
+
+        # parameter
+        if not accessor_info:
+            raise Exception('invalid accessor')
+
+        if not target_table:
+            raise Exception(f'invalid table_name:{target_table}')
+
+        if not request_body_info:
+            raise Exception('invalid request_body_info')
+
+        if not response_model:
+            raise Exception('invalid response_model')
+
+        # if not response_model_data:
+        #     raise Exception('invalid response_model_data')
+
+        # request
+        if not request_body_info.search_info:
+            raise Exception('invalid request_body: search_info')
+
+        request_search_info = request_parser(request_body_info.search_info.dict())
+        if not request_search_info:
+            raise Exception('invalid request_body: search_info')
+
+        if not request_body_info.update_info:
+            raise Exception('invalid request_body: update_info')
+
+        request_update_info = request_parser(request_body_info.update_info.dict())
+        if not request_update_info:
+            raise Exception('invalid request_body: update_info')
+
+        # search
+        search_info = target_table.filter(**request_search_info)
+
+        # process
+        search_info.update(auto_commit=True, synchronize_session=False, **request_update_info)
+
+        # result
+        return response_model()
+    except Exception as e:
+        if search_info:
+            search_info.close()
+        return response_model.set_error(str(e))
+
+
+async def table_delete(accessor_info, target_table, request_body_info, response_model, response_model_data=None):
+    search_info = None
+
+    try:
+        # request
+        if not accessor_info:
+            raise Exception('invalid accessor')
+
+        if not target_table:
+            raise Exception(f'invalid table_name:{target_table}')
+
+        if not request_body_info:
+            raise Exception('invalid request_body_info')
+
+        if not response_model:
+            raise Exception('invalid response_model')
+
+        # if not response_model_data:
+        #     raise Exception('invalid response_model_data')
+
+        # request
+        request_search_info = request_parser(request_body_info.dict())
+        if not request_search_info:
+            raise Exception('invalid request_body')
+
+        # search
+        search_info = target_table.filter(**request_search_info)
+        temp_search = search_info.all()
+
+        # process
+        search_info.delete(auto_commit=True, synchronize_session=False)
+
+        # update license num
+        uuid_list = list()
+        for _license in temp_search:
+            if not hasattr(temp_search, 'uuid'):
+                # case: license
+                break
+            if _license.uuid not in uuid_list:
+                uuid_list.append(_license.uuid)
+                license_num = target_table.filter(uuid=_license.uuid).count()
+                target_table.filter(uuid=_license.uuid).update(auto_commit=True, synchronize_session=False, num=license_num)
+
+        # result
+        return response_model()
+    except Exception as e:
+        if search_info:
+            search_info.close()
+        return response_model.set_error(str(e))
--- a/rest/app/database/schema.py
+++ b/rest/app/database/schema.py
@@ -0,0 +1,304 @@
+# -*- coding: utf-8 -*-
+"""
+@File: schema.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: database schema
+"""
+
+from sqlalchemy import (
+    Column,
+    Integer,
+    String,
+    DateTime,
+    func,
+    Enum,
+    Boolean,
+    ForeignKey,
+)
+from sqlalchemy.orm import Session, relationship
+
+from rest.app.database.conn import Base, db
+from rest.app.utils.date_utils import D
+from rest.app.models import (
+    SexType,
+    UserType,
+    MemberType,
+    AccountType,
+    UserStatusType,
+    UserLoginType,
+    UserLogMessageType
+)
+
+
+class BaseMixin:
+    id = Column(Integer, primary_key=True, index=True)
+    created_at = Column(DateTime, nullable=False, default=D.datetime())
+    updated_at = Column(DateTime, nullable=False, default=D.datetime(), onupdate=D.datetime())
+
+    def __init__(self):
+        self._q = None
+        self._session = None
+        self.served = None
+
+    def all_columns(self):
+        return [c for c in self.__table__.columns if c.primary_key is False and c.name != 'created_at']
+
+    def __hash__(self):
+        return hash(self.id)
+
+    @classmethod
+    def create(cls, session: Session, auto_commit=False, **kwargs):
+        """
+        테이블 데이터 적재 전용 함수
+        :param session:
+        :param auto_commit: 자동 커밋 여부
+        :param kwargs: 적재 할 데이터
+        :return:
+        """
+        obj = cls()
+
+        # NOTE(hsj100) : FIX_DATETIME
+        if 'created_at' not in kwargs:
+            obj.created_at = D.datetime()
+        if 'updated_at' not in kwargs:
+            obj.updated_at = D.datetime()
+
+        for col in obj.all_columns():
+            col_name = col.name
+            if col_name in kwargs:
+                setattr(obj, col_name, kwargs.get(col_name))
+        session.add(obj)
+        session.flush()
+        if auto_commit:
+            session.commit()
+        return obj
+
+    @classmethod
+    def get(cls, session: Session = None, **kwargs):
+        """
+        Simply get a Row
+        :param session:
+        :param kwargs:
+        :return:
+        """
+        sess = next(db.session()) if not session else session
+        query = sess.query(cls)
+        for key, val in kwargs.items():
+            col = getattr(cls, key)
+            query = query.filter(col == val)
+
+        if query.count() > 1:
+            raise Exception('Only one row is supposed to be returned, but got more than one.')
+        result = query.first()
+        if not session:
+            sess.close()
+        return result
+
+    @classmethod
+    def filter(cls, session: Session = None, **kwargs):
+        """
+        Simply get a Row
+        :param session:
+        :param kwargs:
+        :return:
+        """
+        cond = []
+        for key, val in kwargs.items():
+            key = key.split('__')
+            if len(key) > 2:
+                raise Exception('length of split(key) should be no more than 2.')
+            col = getattr(cls, key[0])
+            if len(key) == 1: cond.append((col == val))
+            elif len(key) == 2 and key[1] == 'gt': cond.append((col > val))
+            elif len(key) == 2 and key[1] == 'gte': cond.append((col >= val))
+            elif len(key) == 2 and key[1] == 'lt': cond.append((col < val))
+            elif len(key) == 2 and key[1] == 'lte': cond.append((col <= val))
+            elif len(key) == 2 and key[1] == 'in': cond.append((col.in_(val)))
+            elif len(key) == 2 and key[1] == 'like': cond.append((col.like(val)))
+
+        obj = cls()
+        if session:
+            obj._session = session
+            obj.served = True
+        else:
+            obj._session = next(db.session())
+            obj.served = False
+        query = obj._session.query(cls)
+        query = query.filter(*cond)
+        obj._q = query
+        return obj
+
+    @classmethod
+    def cls_attr(cls, col_name=None):
+        if col_name:
+            col = getattr(cls, col_name)
+            return col
+        else:
+            return cls
+
+    def order_by(self, *args: str):
+        for a in args:
+            if a.startswith('-'):
+                col_name = a[1:]
+                is_asc = False
+            else:
+                col_name = a
+                is_asc = True
+            col = self.cls_attr(col_name)
+            self._q = self._q.order_by(col.asc()) if is_asc else self._q.order_by(col.desc())
+        return self
+
+    def update(self, auto_commit: bool = False, synchronize_session='evaluate', **kwargs):
+        # NOTE(hsj100) : FIX_DATETIME
+        if 'updated_at' not in kwargs:
+            kwargs['updated_at'] = D.datetime()
+
+        qs = self._q.update(kwargs, synchronize_session=synchronize_session)
+        get_id = self.id
+        ret = None
+
+        self._session.flush()
+        if qs > 0 :
+            ret = self._q.first()
+        if auto_commit:
+            self._session.commit()
+        return ret
+
+    def first(self):
+        result = self._q.first()
+        self.close()
+        return result
+
+    def delete(self, auto_commit: bool = False, synchronize_session='evaluate'):
+        self._q.delete(synchronize_session=synchronize_session)
+        if auto_commit:
+            self._session.commit()
+
+    def all(self):
+        print(self.served)
+        result = self._q.all()
+        self.close()
+        return result
+
+    def count(self):
+        result = self._q.count()
+        self.close()
+        return result
+
+    def close(self):
+        if not self.served:
+            self._session.close()
+        else:
+            self._session.flush()
+
+
+class ApiKeys(Base, BaseMixin):
+    __tablename__ = 'api_keys'
+    __table_args__ = {'extend_existing': True} 
+    
+    access_key = Column(String(length=64), nullable=False, index=True)
+    secret_key = Column(String(length=64), nullable=False)
+    user_memo = Column(String(length=40), nullable=True)
+    status = Column(Enum('active', 'stopped', 'deleted'), default='active')
+    is_whitelisted = Column(Boolean, default=False)
+    user_id = Column(Integer, ForeignKey('users.id'), nullable=False)
+    whitelist = relationship('ApiWhiteLists', backref='api_keys')
+    users = relationship('Users', back_populates='keys')
+
+
+class ApiWhiteLists(Base, BaseMixin):
+    __tablename__ = 'api_whitelists'
+    __table_args__ = {'extend_existing': True} 
+    
+    ip_addr = Column(String(length=64), nullable=False)
+    api_key_id = Column(Integer, ForeignKey('api_keys.id'), nullable=False)
+
+
+class Users(Base, BaseMixin):
+    __tablename__ = 'users'
+    __table_args__ = {'extend_existing': True} 
+    
+    status = Column(Enum(UserStatusType), nullable=False, default=UserStatusType.active)
+    user_type = Column(Enum(UserType), nullable=False, default=UserType.user)
+    account_type = Column(Enum(AccountType), nullable=False, default=AccountType.email)
+    account = Column(String(length=255), nullable=False, unique=True)
+    pw = Column(String(length=2000), nullable=True)
+    email = Column(String(length=255), nullable=True)
+    name = Column(String(length=255), nullable=False)
+    sex = Column(Enum(SexType), nullable=False, default=SexType.male)
+    rrn = Column(String(length=255), nullable=True)
+    address = Column(String(length=2000), nullable=True)
+    phone_number = Column(String(length=20), nullable=True)
+    picture = Column(String(length=1000), nullable=True)
+    marketing_agree = Column(Boolean, nullable=False, default=False)
+    keys = relationship('ApiKeys', back_populates='users')
+
+    # extra
+    login = Column(Enum(UserLoginType), nullable=False, default=UserLoginType.logout)  # TODO(hsj100): LOGIN_STATUS
+    member_type = Column(Enum(MemberType), nullable=False, default=MemberType.personal)
+    # uuid = Column(String(length=36), nullable=True, unique=True)
+
+
+class UserLog(Base, BaseMixin):
+    __tablename__ = 'userlog'
+    __table_args__ = {'extend_existing': True} 
+    
+    account = Column(String(length=255), nullable=False)
+    mac = Column(String(length=255), nullable=True)
+    type = Column(Enum(UserLogMessageType), nullable=False, default=UserLogMessageType.info)
+    api = Column(String(length=511), nullable=False)
+    message = Column(String(length=5000), nullable=True)
+    # NOTE(hsj100): 다단계 자동 삭제
+    # user_id = Column(Integer, ForeignKey('users.id', ondelete='CASCADE'), nullable=False)
+    # user_id = Column(Integer, ForeignKey('users.id'), nullable=False)
+
+    # users = relationship('Users', back_populates='userlog')
+    # users = relationship('Users', back_populates='userlog', lazy=False)
+
+
+# ===============================================================================================
+class CustomBaseMixin(BaseMixin):
+    id = Column(Integer, primary_key=True, index=True)
+    
+    def all_columns(self):
+        return [c for c in self.__table__.columns if c.primary_key is False]
+
+
+    @classmethod
+    def create(cls, session: Session, auto_commit=False, **kwargs):
+        """
+        테이블 데이터 적재 전용 함수
+        :param session:
+        :param auto_commit: 자동 커밋 여부
+        :param kwargs: 적재 할 데이터
+        :return:
+        """
+        obj = cls()
+
+        for col in obj.all_columns():
+            col_name = col.name
+            if col_name in kwargs:
+                setattr(obj, col_name, kwargs.get(col_name))
+        session.add(obj)
+        session.flush()
+        if auto_commit:
+            session.commit()
+        return obj
+    
+    def update(self, auto_commit: bool = False, synchronize_session='evaluate', **kwargs):
+
+        qs = self._q.update(kwargs, synchronize_session=synchronize_session)
+        get_id = self.id
+        ret = None
+
+        self._session.flush()
+        if qs > 0 :
+            ret = self._q.first()
+        if auto_commit:
+            self._session.commit()
+        return ret
+    
--- a/rest/app/errors/exceptions.py
+++ b/rest/app/errors/exceptions.py
@@ -0,0 +1,188 @@
+from rest.app.common.consts import MAX_API_KEY, MAX_API_WHITELIST
+
+
+class StatusCode:
+    HTTP_500 = 500
+    HTTP_400 = 400
+    HTTP_401 = 401
+    HTTP_403 = 403
+    HTTP_404 = 404
+    HTTP_405 = 405
+
+
+class APIException(Exception):
+    status_code: int
+    code: str
+    msg: str
+    detail: str
+    ex: Exception
+
+    def __init__(
+        self,
+        *,
+        status_code: int = StatusCode.HTTP_500,
+        code: str = '000000',
+        msg: str | None = None,
+        detail: str | None = None,
+        ex: Exception = None,
+    ):
+        self.status_code = status_code
+        self.code = code
+        self.msg = msg
+        self.detail = detail
+        self.ex = ex
+        super().__init__(ex)
+
+
+class NotFoundUserEx(APIException):
+    def __init__(self, user_id: int = None, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_404,
+            msg=f'해당 유저를 찾을 수 없습니다.',
+            detail=f'Not Found User ID : {user_id}',
+            code=f'{StatusCode.HTTP_400}{"1".zfill(4)}',
+            ex=ex,
+        )
+
+
+class NotAuthorized(APIException):
+    def __init__(self, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_401,
+            msg=f'로그인이 필요한 서비스 입니다.',
+            detail='Authorization Required',
+            code=f'{StatusCode.HTTP_401}{"1".zfill(4)}',
+            ex=ex,
+        )
+
+
+class TokenExpiredEx(APIException):
+    def __init__(self, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_400,
+            msg=f'세션이 만료되어 로그아웃 되었습니다.',
+            detail='Token Expired',
+            code=f'{StatusCode.HTTP_400}{"1".zfill(4)}',
+            ex=ex,
+        )
+
+
+class TokenDecodeEx(APIException):
+    def __init__(self, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_400,
+            msg=f'비정상적인 접근입니다.',
+            detail='Token has been compromised.',
+            code=f'{StatusCode.HTTP_400}{"2".zfill(4)}',
+            ex=ex,
+        )
+
+
+class NoKeyMatchEx(APIException):
+    def __init__(self, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_404,
+            msg=f'해당 키에 대한 권한이 없거나 해당 키가 없습니다.',
+            detail='No Keys Matched',
+            code=f'{StatusCode.HTTP_404}{"3".zfill(4)}',
+            ex=ex,
+        )
+
+
+class MaxKeyCountEx(APIException):
+    def __init__(self, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_400,
+            msg=f'API 키 생성은 {MAX_API_KEY}개 까지 가능합니다.',
+            detail='Max Key Count Reached',
+            code=f'{StatusCode.HTTP_400}{"4".zfill(4)}',
+            ex=ex,
+        )
+
+
+class MaxWLCountEx(APIException):
+    def __init__(self, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_400,
+            msg=f'화이트리스트 생성은 {MAX_API_WHITELIST}개 까지 가능합니다.',
+            detail='Max Whitelist Count Reached',
+            code=f'{StatusCode.HTTP_400}{"5".zfill(4)}',
+            ex=ex,
+        )
+
+
+class InvalidIpEx(APIException):
+    def __init__(self, ip: str, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_400,
+            msg=f'{ip}는 올바른 IP 가 아닙니다.',
+            detail=f'invalid IP : {ip}',
+            code=f'{StatusCode.HTTP_400}{"6".zfill(4)}',
+            ex=ex,
+        )
+
+
+class SqlFailureEx(APIException):
+    def __init__(self, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_500,
+            msg=f'이 에러는 서버측 에러 입니다. 자동으로 리포팅 되며, 빠르게 수정하겠습니다.',
+            detail='Internal Server Error',
+            code=f'{StatusCode.HTTP_500}{"2".zfill(4)}',
+            ex=ex,
+        )
+
+
+class APIQueryStringEx(APIException):
+    def __init__(self, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_400,
+            msg=f'쿼리스트링은 key, timestamp 2개만 허용되며, 2개 모두 요청시 제출되어야 합니다.',
+            detail='Query String Only Accept key and timestamp.',
+            code=f'{StatusCode.HTTP_400}{"7".zfill(4)}',
+            ex=ex,
+        )
+
+
+class APIHeaderInvalidEx(APIException):
+    def __init__(self, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_400,
+            msg=f'헤더에 키 해싱된 Secret 이 없거나, 유효하지 않습니다.',
+            detail='Invalid HMAC secret in Header',
+            code=f'{StatusCode.HTTP_400}{"8".zfill(4)}',
+            ex=ex,
+        )
+
+
+class APITimestampEx(APIException):
+    def __init__(self, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_400,
+            msg=f'쿼리스트링에 포함된 타임스탬프는 KST 이며, 현재 시간보다 작아야 하고, 현재시간 - 10초 보다는 커야 합니다.',
+            detail='timestamp in Query String must be KST, Timestamp must be less than now, and greater than now - 10.',
+            code=f'{StatusCode.HTTP_400}{"9".zfill(4)}',
+            ex=ex,
+        )
+
+
+class NotFoundAccessKeyEx(APIException):
+    def __init__(self, api_key: str,  ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_404,
+            msg=f'API 키를 찾을 수 없습니다.',
+            detail=f'Not found such API Access Key : {api_key}',
+            code=f'{StatusCode.HTTP_404}{"10".zfill(4)}',
+            ex=ex,
+        )
+
+
+class KakaoSendFailureEx(APIException):
+    def __init__(self, ex: Exception = None):
+        super().__init__(
+            status_code=StatusCode.HTTP_400,
+            msg=f'카카오톡 전송에 실패했습니다.',
+            detail=f'Failed to send KAKAO MSG.',
+            code=f'{StatusCode.HTTP_400}{"11".zfill(4)}',
+            ex=ex,
+        )
--- a/rest/app/main.py
+++ b/rest/app/main.py
@@ -0,0 +1,116 @@
+# -*- coding: utf-8 -*-
+"""
+@File: main.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: Main
+"""
+
+from dataclasses import asdict
+
+import uvicorn
+from fastapi import FastAPI, Depends
+from fastapi.security import APIKeyHeader
+from fastapi.staticfiles import StaticFiles
+from fastapi.exceptions import RequestValidationError
+from fastapi.responses import JSONResponse
+from starlette.middleware.base import BaseHTTPMiddleware
+from starlette.middleware.cors import CORSMiddleware
+
+from rest.app.common import consts
+
+from rest.app.database.conn import db
+from rest.app.common.config import conf
+from rest.app.middlewares.token_validator import access_control
+from rest.app.middlewares.trusted_hosts import TrustedHostMiddleware
+from rest.app.routes import dev, index, auth, users, services
+from contextlib import asynccontextmanager
+
+from custom_logger.custom_log import custom_logger as LOG
+
+
+API_KEY_HEADER = APIKeyHeader(name='Authorization', auto_error=False)
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    # When service starts.
+    LOG.info("REST start")
+    
+    yield
+    
+    # When service is stopped.
+    LOG.info("REST shutdown")
+
+
+def create_app():
+    """
+    fast_api_app 생성
+
+    :return: fast_api_app
+    """
+    configurations = conf()
+    fast_api_app = FastAPI(
+        title=configurations.SW_TITLE,
+        version=configurations.SW_VERSION,
+        description=configurations.SW_DESCRIPTION,
+        terms_of_service=configurations.TERMS_OF_SERVICE,
+        contact=configurations.CONTEACT,
+        license_info={'name': 'Copyright by A2TEC', 'url': 'http://www.a2tec.co.kr'},
+        lifespan=lifespan
+    )
+
+    # 데이터 베이스 이니셜라이즈
+    conf_dict = asdict(configurations)
+    db.init_app(fast_api_app, **conf_dict)
+
+    # 레디스 이니셜라이즈
+
+    # 미들웨어 정의
+    fast_api_app.add_middleware(middleware_class=BaseHTTPMiddleware, dispatch=access_control)
+    fast_api_app.add_middleware(
+        CORSMiddleware,
+        allow_origins=conf().ALLOW_SITE,
+        allow_credentials=True,
+        allow_methods=['*'],
+        allow_headers=['*'],
+    )
+    fast_api_app.add_middleware(TrustedHostMiddleware, allowed_hosts=conf().TRUSTED_HOSTS, except_path=['/health'])
+
+    # 라우터 정의
+    fast_api_app.include_router(index.router, tags=['Defaults'])
+    
+    if conf().DEBUG:
+        fast_api_app.include_router(auth.router, tags=['Authentication'], prefix='/api')
+
+    fast_api_app.include_router(services.router, tags=['Services'], prefix='/api', dependencies=[Depends(API_KEY_HEADER)])
+
+    if conf().DEBUG:
+        fast_api_app.include_router(users.router, tags=['Users'], prefix='/api', dependencies=[Depends(API_KEY_HEADER)])
+        fast_api_app.include_router(dev.router, tags=['Developments'], prefix='/api', dependencies=[Depends(API_KEY_HEADER)])
+    
+    import os
+    fast_api_app.mount('/static', StaticFiles(directory=os.path.abspath('./rest/app/static')), name="static")
+    
+    return fast_api_app
+
+
+app = create_app()
+
+#TODO(jwkim): 422 error handler
+# @app.exception_handler(RequestValidationError)
+# async def validation_exception_handler(request, exc):
+#     err = exc.errors()
+#     return JSONResponse(
+#         status_code=422,
+#         content={
+#             "result": False,
+#             "error": f"VALIDATION ERROR : {err}",
+#             "data": None},
+#     )
+
+if __name__ == '__main__':
+    uvicorn.run('main:app', host='0.0.0.0', port=conf().REST_SERVER_PORT, reload=True)
--- a/rest/app/middlewares/token_validator.py
+++ b/rest/app/middlewares/token_validator.py
@@ -0,0 +1,166 @@
+import base64
+import hmac
+import json
+import time
+import typing
+import re
+
+import jwt
+import sqlalchemy.exc
+
+from jwt.exceptions import ExpiredSignatureError, DecodeError
+from starlette.requests import Request
+from starlette.responses import JSONResponse
+
+from rest.app.common.consts import EXCEPT_PATH_LIST, EXCEPT_PATH_REGEX
+from rest.app.database.conn import db
+from rest.app.database.schema import Users, ApiKeys
+from rest.app.errors import exceptions as ex
+
+from rest.app.common import consts
+from rest.app.common.config import conf
+from rest.app.errors.exceptions import APIException, SqlFailureEx, APIQueryStringEx
+from rest.app.models import UserToken
+
+from rest.app.utils.date_utils import D
+from rest.app.utils.logger import api_logger
+from rest.app.utils.query_utils import to_dict
+
+from dataclasses import asdict
+
+
+async def access_control(request: Request, call_next):
+    request.state.req_time = D.datetime()
+    request.state.start = time.time()
+    request.state.inspect = None
+    request.state.user = None
+    request.state.service = None
+
+    ip = request.headers['x-forwarded-for'] if 'x-forwarded-for' in request.headers.keys() else request.client.host
+    request.state.ip = ip.split(',')[0] if ',' in ip else ip
+    headers = request.headers
+    cookies = request.cookies
+
+    url = request.url.path
+    if await url_pattern_check(url, EXCEPT_PATH_REGEX) or url in EXCEPT_PATH_LIST:
+        response = await call_next(request)
+        if url != '/':
+            await api_logger(request=request, response=response)
+        return response
+
+    try:
+        if url.startswith('/api'):
+            # api 인경우 헤더로 토큰 검사
+            # NOTE(hsj100): SERVICE_AUTH_API_KEY (token 방식으로 진행)
+            if url.startswith('/api/services') and conf().SERVICE_AUTH_API_KEY:
+                qs = str(request.query_params)
+                qs_list = qs.split('&')
+                session = next(db.session())
+                if not conf().DEBUG:
+                    try:
+                        qs_dict = {qs_split.split('=')[0]: qs_split.split('=')[1] for qs_split in qs_list}
+                    except Exception:
+                        raise ex.APIQueryStringEx()
+
+                    qs_keys = qs_dict.keys()
+
+                    if 'key' not in qs_keys or 'timestamp' not in qs_keys:
+                        raise ex.APIQueryStringEx()
+
+                    if 'secret' not in headers.keys():
+                        raise ex.APIHeaderInvalidEx()
+
+                    api_key = ApiKeys.get(session=session, access_key=qs_dict['key'])
+
+                    if not api_key:
+                        raise ex.NotFoundAccessKeyEx(api_key=qs_dict['key'])
+                    mac = hmac.new(bytes(api_key.secret_key, encoding='utf8'), bytes(qs, encoding='utf-8'), digestmod='sha256')
+                    d = mac.digest()
+                    validating_secret = str(base64.b64encode(d).decode('utf-8'))
+
+                    if headers['secret'] != validating_secret:
+                        raise ex.APIHeaderInvalidEx()
+
+                    now_timestamp = int(D.datetime(diff=9).timestamp())
+                    if now_timestamp - 10 > int(qs_dict['timestamp']) or now_timestamp < int(qs_dict['timestamp']):
+                        raise ex.APITimestampEx()
+
+                    user_info = to_dict(api_key.users)
+                    request.state.user = UserToken(**user_info)
+
+                else:
+                    # Request User 가 필요함
+                    if 'authorization' in headers.keys():
+                        key = headers.get('Authorization')
+                        api_key_obj = ApiKeys.get(session=session, access_key=key)
+                        user_info = to_dict(Users.get(session=session, id=api_key_obj.user_id))
+                        request.state.user = UserToken(**user_info)
+                        # 토큰 없음
+                    else:
+                        if 'Authorization' not in headers.keys():
+                            raise ex.NotAuthorized()
+                session.close()
+                response = await call_next(request)
+                return response
+            else:
+                if 'authorization' in headers.keys():
+                    # 토큰 존재
+                    token_info = await token_decode(access_token=headers.get('Authorization'))
+                    request.state.user = UserToken(**token_info)
+                elif conf().DEV_TEST_CONNECT_ACCOUNT:
+                    # NOTE(hsj100): DEV_TEST_CONNECT_ACCOUNT
+                    request.state.user = UserToken.from_orm(conf().DEV_TEST_CONNECT_ACCOUNT)
+                else:
+                    # 토큰 없음
+                    if 'Authorization' not in headers.keys():
+                        raise ex.NotAuthorized()
+        else:
+            # 템플릿 렌더링인 경우 쿠키에서 토큰 검사
+            cookies['Authorization'] = conf().COOKIES_AUTH
+
+            if 'Authorization' not in cookies.keys():
+                raise ex.NotAuthorized()
+
+            token_info = await token_decode(access_token=cookies.get('Authorization'))
+            request.state.user = UserToken(**token_info)
+        response = await call_next(request)
+        await api_logger(request=request, response=response)
+    except Exception as e:
+
+        error = await exception_handler(e)
+        error_dict = dict(status=error.status_code, msg=error.msg, detail=error.detail, code=error.code)
+        response = JSONResponse(status_code=error.status_code, content=error_dict)
+        await api_logger(request=request, error=error)
+
+    return response
+
+
+async def url_pattern_check(path, pattern):
+    result = re.match(pattern, path)
+    if result:
+        return True
+    return False
+
+
+async def token_decode(access_token):
+    """
+    :param access_token:
+    :return:
+    """
+    try:
+        access_token = access_token.replace('Bearer ', "")
+        payload = jwt.decode(access_token, key=consts.JWT_SECRET, algorithms=[consts.JWT_ALGORITHM])
+    except ExpiredSignatureError:
+        raise ex.TokenExpiredEx()
+    except DecodeError:
+        raise ex.TokenDecodeEx()
+    return payload
+
+
+async def exception_handler(error: Exception):
+    print(error)
+    if isinstance(error, sqlalchemy.exc.OperationalError):
+        error = SqlFailureEx(ex=error)
+    if not isinstance(error, APIException):
+        error = APIException(ex=error, detail=str(error))
+    return error
--- a/rest/app/middlewares/trusted_hosts.py
+++ b/rest/app/middlewares/trusted_hosts.py
@@ -0,0 +1,63 @@
+import typing
+
+
+from starlette.datastructures import URL, Headers
+from starlette.responses import PlainTextResponse, RedirectResponse, Response
+from starlette.types import ASGIApp, Receive, Scope, Send
+
+ENFORCE_DOMAIN_WILDCARD = 'Domain wildcard patterns must be lNo module named \'app\'ike \'*.example.com\'.'
+
+
+class TrustedHostMiddleware:
+    def __init__(
+        self,
+        app: ASGIApp,
+        allowed_hosts: typing.Sequence[str] = None,
+        except_path: typing.Sequence[str] = None,
+        www_redirect: bool = True,
+    ) -> None:
+        if allowed_hosts is None:
+            allowed_hosts = ['*']
+        if except_path is None:
+            except_path = []
+        for pattern in allowed_hosts:
+            assert '*' not in pattern[1:], ENFORCE_DOMAIN_WILDCARD
+            if pattern.startswith('*') and pattern != '*':
+                assert pattern.startswith('*.'), ENFORCE_DOMAIN_WILDCARD
+        self.app = app
+        self.allowed_hosts = list(allowed_hosts)
+        self.allow_any = '*' in allowed_hosts
+        self.www_redirect = www_redirect
+        self.except_path = list(except_path)
+
+    async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
+        if self.allow_any or scope['type'] not in ('http', 'websocket',):  # pragma: no cover
+            await self.app(scope, receive, send)
+            return
+
+        headers = Headers(scope=scope)
+        host = headers.get('host', "").split(':')[0]
+        is_valid_host = False
+        found_www_redirect = False
+        for pattern in self.allowed_hosts:
+            if (
+                host == pattern
+                or (pattern.startswith('*') and host.endswith(pattern[1:]))
+                or URL(scope=scope).path in self.except_path
+            ):
+                is_valid_host = True
+                break
+            elif 'www.' + host == pattern:
+                found_www_redirect = True
+
+        if is_valid_host:
+            await self.app(scope, receive, send)
+        else:
+            if found_www_redirect and self.www_redirect:
+                url = URL(scope=scope)
+                redirect_url = url.replace(netloc='www.' + url.netloc)
+                response = RedirectResponse(url=str(redirect_url))  # type: Response
+            else:
+                response = PlainTextResponse('Invalid host header', status_code=400)
+
+            await response(scope, receive, send)
--- a/rest/app/models.py
+++ b/rest/app/models.py
@@ -0,0 +1,567 @@
+# -*- coding: utf-8 -*-
+"""
+@File: models.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: data models
+"""
+
+from datetime import datetime
+from enum import Enum
+from typing import List
+
+from pydantic import TypeAdapter
+from pydantic import Field, ConfigDict
+from pydantic.main import BaseModel
+from pydantic.networks import EmailStr, IPvAnyAddress
+from typing import Optional
+
+from rest.app.common.consts import (
+    SW_TITLE,
+    SW_VERSION,
+    MAIL_REG_TITLE,
+    MAIL_REG_CONTENTS,
+    SMTP_HOST,
+    SMTP_PORT,
+    ADMIN_INIT_ACCOUNT_INFO,
+    DEFAULT_USER_ACCOUNT_PW
+)
+from rest.app.utils.date_utils import D
+
+
+class SWInfo(BaseModel):
+    """
+    ### 서비스 정보
+    """
+    name: str = Field(SW_TITLE, description='SW 이름', example=SW_VERSION)
+    version: str = Field(SW_VERSION, description='SW 버전', example=SW_VERSION)
+    date: str = Field(D.date_str(), description='현재날짜', example='%Y.%m.%dT%H:%M:%S')
+    data1: str = Field(None, description='TestData1', example=None)
+    data2: str = Field(None, description='TestData2', example=None)
+    data3: str = Field(None, description='TestData3', example=None)
+    data4: str = Field(None, description='TestData4', example=None)
+    
+    data5: str = Field(None, description='TestData1', example=None)
+    data6: str = Field(None, description='TestData2', example=None)
+    data7: str = Field(None, description='TestData3', example=None)
+    data8: str = Field(None, description='TestData4', example=None)
+
+
+class CustomEnum(Enum):
+    @classmethod
+    def get_elements_str(cls, is_key=True):
+        if is_key:
+            result_str = cls.__members__.keys()
+        else:
+            result_str = cls.__members__.values()
+        return '[' + ', '.join(result_str) + ']'
+
+
+class SexType(str, CustomEnum):
+    male: str = 'male'
+    female: str = 'female'
+
+
+class AccountType(str, CustomEnum):
+    email: str = 'email'
+    # facebook: str = 'facebook'
+    # google: str = 'google'
+    # kakao: str = 'kakao'
+
+
+class UserStatusType(str, CustomEnum):
+    active: str = 'active'
+    deleted: str = 'deleted'
+    blocked: str = 'blocked'
+
+
+class UserLoginType(str, CustomEnum):
+    login: str = 'login'
+    logout: str = 'logout'
+
+
+class MemberType(str, CustomEnum):
+    personal: str = 'personal'
+    company: str = 'company'
+
+
+class UserType(str, CustomEnum):
+    admin: str = 'admin'
+    user: str = 'user'
+
+
+class UserLogMessageType(str, CustomEnum):
+    info: str = 'info'
+    error: str = 'error'
+
+
+class Token(BaseModel):
+    Authorization: str = Field(None, description='인증키', example='Bearer [token]')
+
+
+class EmailRecipients(BaseModel):
+    name: str
+    email: str
+
+
+class SendEmail(BaseModel):
+    email_to: List[EmailRecipients] = None
+
+
+class KakaoMsgBody(BaseModel):
+    msg: str | None = None
+
+
+class MessageOk(BaseModel):
+    message: str = Field(default='OK')
+
+
+class UserToken(BaseModel):
+    id: int
+    account: str | None = None
+    name: str | None = None
+    phone_number: str | None = None
+    profile_img: str | None = None
+    account_type: str | None = None
+
+    # model_config = ConfigDict(from_attributes=True)
+
+
+class AddApiKey(BaseModel):
+    user_memo: str | None = None
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class GetApiKeyList(AddApiKey):
+    id: int = None
+    access_key: str | None = None
+    created_at: datetime = None
+
+
+class GetApiKeys(GetApiKeyList):
+    secret_key: str | None = None
+
+
+class CreateAPIWhiteLists(BaseModel):
+    ip_addr: str | None = None
+
+
+class GetAPIWhiteLists(CreateAPIWhiteLists):
+    id: int
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class ResponseBase(BaseModel):
+    """
+    ### [Response] API End-Point
+
+    **정상처리**\n
+    - result: true\n
+    - error: null\n
+
+    **오류발생**\n
+    - result: false\n
+    - error: 오류내용\n
+    """
+    result: bool = Field(True, description='처리상태(성공: true, 실패: false)', example=True)
+    error: str | None = Field(None, description='오류내용(성공: null, 실패: 오류내용)', example=None)
+
+    @staticmethod
+    def set_error(error):
+        ResponseBase.result = False
+        ResponseBase.error = str(error)
+
+        return ResponseBase
+    
+    @staticmethod
+    def set_message():
+        ResponseBase.result = True
+        ResponseBase.error = None
+        return ResponseBase
+    
+    model_config = ConfigDict(from_attributes=True)
+    
+
+class PagingReq(BaseModel):
+    """
+    ### [Request] 페이징 정보
+    """
+    start_page: int = Field(None, description='시작 페이지 번호(base: 1)', example=1)
+    page_contents_num: int = Field(None, description='페이지 내용 개수', example=2)
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class PagingRes(BaseModel):
+    """
+    ### [Response] 페이징 정보
+    """
+    total_page_num: int = Field(None, description='전체 페이지 개수', example=100)
+    total_contents_num: int = Field(None, description='전체 내용 개수', example=100)
+    start_page: int = Field(None, description='시작 페이지 번호(base: 1)', example=1)
+    search_contents_num: int = Field(None, description='검색된 내용 개수', example=100)
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class TokenRes(ResponseBase):
+    """
+    ### [Response] 토큰 정보
+    """
+    Authorization: str = Field(None, description='인증키', example='Bearer [token]')
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserLogInfo(BaseModel):
+    """
+    ### 사용자 로그 정보
+    """
+    id: int = Field(None, description='Table Index', example='1')
+    created_at: datetime = Field(None, description='생성날짜', example='2022-01-01T12:34:56')
+    updated_at: datetime = Field(None, description='수정날짜', example='2022-01-01T12:34:56')
+
+    account: str = Field(None, description='계정', example='user1@test.com')
+    mac: str = Field(None, description='MAC(네트워크 인터페이스 식별자)', example='11:22:33:44:55:66')
+    type: str = Field(None, description='로그 타입' + UserLogMessageType.get_elements_str(), example=UserLogMessageType.info)
+    api: str = Field(None, description='API 이름', example='/api/auth/login')
+    message: str = Field(None, description='로그 내용', example='ok')
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserInfo(BaseModel):
+    """
+    ### 유저 정보
+    """
+    id: int = Field(None, description='Table Index', example='1')
+    created_at: datetime = Field(None, description='생성날짜', example='2022-01-01T12:34:56')
+    updated_at: datetime = Field(None, description='수정날짜', example='2022-01-01T12:34:56')
+
+    status: UserStatusType = Field(None, description='계정상태' + UserStatusType.get_elements_str(), example=UserStatusType.active)
+    user_type: UserType = Field(None, description='유저 타입' + UserType.get_elements_str(), example=UserType.user)
+    account_type: AccountType = Field(None, description='계정종류' + AccountType.get_elements_str(), example=AccountType.email)
+    account: str = Field(None, description='계정', example='user1@test.com')
+    email: str = Field(None, description='전자메일', example='user1@test.com')
+    name: str = Field(None, description='이름', example='user1')
+    sex: str = Field(None, description='성별' + SexType.get_elements_str(), example=SexType.male)
+    rrn: str = Field(None, description='주민등록번호', example='123456-1234567')
+    address: str = Field(None, description='주소', example='대구1')
+    phone_number: str = Field(None, description='연락처', example='010-1234-1234')
+    picture: str = Field(None, description='프로필사진', example='profile1.png')
+    marketing_agree: bool = Field(False, description='마케팅동의 여부', example=False)
+    # extra
+    login: UserLoginType = Field(None, description='로그인 상태' + UserLoginType.get_elements_str(), example=UserLoginType.logout)  # TODO(hsj100): LOGIN_STATUS
+    member_type: MemberType = Field(None, description='회원 타입' + MemberType.get_elements_str(), example=MemberType.personal)
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class SendMailReq(BaseModel):
+    """
+    ### [Request] 메일 전송
+    """
+    smtp_host: str = Field(None, description='SMTP 서버 주소', example=SMTP_HOST)
+    smtp_port: int = Field(None, description='SMTP 서버 포트', example=SMTP_PORT)
+    title: str = Field(None, description='제목', example=MAIL_REG_TITLE)
+    recipient: str = Field(None, description='수신자', example='user1@test.com')
+    cc_list: list = Field(None, description='참조 리스트', example='["user2@test.com", "user3@test.com"]')
+    # recipient: str = Field(None, description='수신자', example='hsj100@a2tec.co.kr')
+    # cc_list: list = Field(None, description='참조 리스트', example=None)
+    contents_plain: str = Field(None, description='내용', example=MAIL_REG_CONTENTS.format('user1@test.com', 10))
+    contents_html: str = Field(None, description='내용', example='<p>내 고양이는 <strong>아주 고약해.</p></strong>')
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserInfoRes(ResponseBase):
+    """
+    ### [Response] 유저 정보
+    """
+    data: UserInfo = None
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserLoginReq(BaseModel):
+    """
+    ### 유저 로그인 정보
+    """
+    account: str = Field(description='계정', example='user1@test.com')
+    pw: str = Field(None, description='비밀번호 [관리자 필수]', example='1234')
+    # SW-LICENSE
+    sw: str = Field(None, description='라이선스 SW 이름 [유저 필수]', example='저작도구')
+    mac: str = Field(None, description='MAC [유저 필수]', example='11:22:33:44:55:01')
+
+
+class UserRegisterReq(BaseModel):
+    """
+    ### [Request] 유저 등록
+    """
+    status: Optional[str] = Field(UserStatusType.active, description='계정상태' + UserStatusType.get_elements_str(), example=UserStatusType.active)
+    user_type: Optional[UserType] = Field(UserType.user, description='유저 타입' + UserType.get_elements_str(), example=UserType.user)
+    account: str = Field(description='계정', example='test@test.com')
+    pw: Optional[str] = Field(DEFAULT_USER_ACCOUNT_PW, description='비밀번호', example='1234')
+    email: Optional[str] = Field(None, description='전자메일', example='test@test.com')
+    name: str = Field(description='이름', example='test')
+    sex: Optional[SexType] = Field(SexType.male, description='성별' + SexType.get_elements_str(), example=SexType.male)
+    rrn: Optional[str] = Field(None, description='주민등록번호', example='19910101-1234567')
+    address: Optional[str] = Field(None, description='주소', example='대구광역시 동구 동촌로 351, 4층 (용계동, 에이스빌딩)')
+    phone_number: Optional[str] = Field(None, description='휴대전화', example='010-1234-1234')
+    picture: Optional[str] = Field(None, description='사진', example='profile1.png')
+    marketing_agree: Optional[bool] = Field(False, description='마케팅동의 여부', example=False)
+    # extra
+    member_type: Optional[MemberType] = Field(MemberType.personal, description='회원 타입' + MemberType.get_elements_str(), example=MemberType.personal)
+    # relationship:license
+    license_sw: str = Field(description='라이선스 SW 이름', example='저작도구')
+    license_start: datetime = Field(description='라이선스 시작날짜', example='2022-02-10T15:00:00')
+    license_end: datetime = Field(description='라이선스 시작날짜', example='2023-02-10T15:00:00')
+    license_num: Optional[int] = Field(1, description='계약된 라이선스 개수', example=1)
+    license_manager_name: Optional[str] = Field(ADMIN_INIT_ACCOUNT_INFO.name, description='담당자 이름', example=ADMIN_INIT_ACCOUNT_INFO.name)
+    license_manager_phone: Optional[str] = Field(ADMIN_INIT_ACCOUNT_INFO.phone_number, description='담당자 연락처', example=ADMIN_INIT_ACCOUNT_INFO.phone_number)
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserSearchReq(BaseModel):
+    """
+    ### [Request] 유저 검색 (기본)
+    """
+    # basic
+    id: Optional[int] = Field(None, description='등록번호', example='1')
+    id__in: Optional[list] = Field(None, description='등록번호 리스트', example=[1,])
+    created_at: Optional[str] = Field(None, description='생성날짜', example='2022-01-01T12:34:56')
+    created_at__gt: Optional[str] = Field(None, description='생성날짜(주어진 날짜 이후)', example='2022-02-10T15:00:00')
+    created_at__gte: Optional[str] = Field(None, description='생성날짜(주어진 날짜 포함 이후)', example='2022-02-10T15:00:00')
+    created_at__lt: Optional[str] = Field(None, description='생성날짜(주어진 날짜 이전)', example='2022-02-10T15:00:00')
+    created_at__lte: Optional[str] = Field(None, description='생성날짜(주어진 날짜 포함 이전)', example='2022-02-10T15:00:00')
+    updated_at: Optional[str] = Field(None, description='수정날짜', example='2022-01-01T12:34:56')
+    updated_at__gt: Optional[str] = Field(None, description='생성날짜(주어진 날짜 이후)', example='2022-02-10T15:00:00')
+    updated_at__gte: Optional[str] = Field(None, description='생성날짜(주어진 날짜 포함 이후)', example='2022-02-10T15:00:00')
+    updated_at__lt: Optional[str] = Field(None, description='생성날짜(주어진 날짜 이전)', example='2022-02-10T15:00:00')
+    updated_at__lte: Optional[str] = Field(None, description='생성날짜(주어진 날짜 포함 이전)', example='2022-02-10T15:00:00')
+
+    status: Optional[UserStatusType] = Field(None, description='계정상태' + UserStatusType.get_elements_str(), example=UserStatusType.active)
+    user_type: Optional[UserType] = Field(None, description='유저 타입' + UserType.get_elements_str(), example=UserType.user)
+    account_type: Optional[AccountType] = Field(None, description='계정종류' + AccountType.get_elements_str(), example=AccountType.email)
+    account: Optional[str] = Field(None, description='계정', example='user1@test.com')
+    account__like: Optional[str] = Field(None, description='계정 부분검색', example='%user%')
+    email: Optional[str] = Field(None, description='전자메일', example='user1@test.com')
+    email__like: Optional[str] = Field(None, description='전자메일 부분검색', example='%user%')
+    name: Optional[str] = Field(None, description='이름', example='test')
+    name__like: Optional[str] = Field(None, description='이름 부분검색', example='%user%')
+    sex: Optional[SexType] = Field(None, description='성별' + SexType.get_elements_str(), example=SexType.male)
+    rrn: Optional[str] = Field(None, description='주민등록번호', example='123456-1234567')
+    address: Optional[str] = Field(None, description='주소', example='대구1')
+    address__like: Optional[str] = Field(None, description='주소 부분검색', example='%대구%')
+    phone_number: Optional[str] = Field(None, description='연락처', example='010-1234-1234')
+    picture: Optional[str] = Field(None, description='프로필사진', example='profile1.png')
+    marketing_agree: Optional[bool] = Field(None, description='마케팅동의 여부', example=False)
+    # extra
+    login: Optional[UserLoginType] = Field(None, description='로그인 상태' + UserLoginType.get_elements_str(), example=UserLoginType.logout)  # TODO(hsj100): LOGIN_STATUS
+    member_type: Optional[MemberType] = Field(None, description='회원 타입' + MemberType.get_elements_str(), example=MemberType.personal)
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserSearchRes(ResponseBase):
+    """
+    ### [Response] 유저 검색
+    """
+    data: List[UserInfo] = []
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserSearchPagingReq(BaseModel):
+    """
+    ### [Request] 유저 페이징 검색
+    """
+    # paging
+    paging: Optional[PagingReq] = None
+    search: Optional[UserSearchReq] = None
+
+
+class UserSearchPagingRes(ResponseBase):
+    """
+    ### [Response] 유저 페이징 검색
+    """
+    paging: PagingRes = None
+    data: List[UserInfo] = []
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserUpdateReq(BaseModel):
+    """
+    ### [Request] 유저 변경
+    """
+    status: Optional[UserStatusType] = Field(None, description='계정상태' + UserStatusType.get_elements_str(), example=UserStatusType.active)
+    user_type: Optional[UserType] = Field(None, description='유저 타입' + UserType.get_elements_str(), example=UserType.user)
+    account_type: Optional[AccountType] = Field(None, description='계정종류' + AccountType.get_elements_str(), example=AccountType.email)
+    account: Optional[str] = Field(None, description='계정', example='user1@test.com')
+    email: Optional[str] = Field(None, description='전자메일', example='user1@test.com')
+    name: Optional[str] = Field(None, description='이름', example='test')
+    sex: Optional[SexType] = Field(None, description='성별' + SexType.get_elements_str(), example=SexType.male)
+    rrn: Optional[str] = Field(None, description='주민등록번호', example='123456-1234567')
+    address: Optional[str] = Field(None, description='주소', example='대구1')
+    phone_number: Optional[str] = Field(None, description='연락처', example='010-1234-1234')
+    picture: Optional[str] = Field(None, description='프로필사진', example='profile1.png')
+    marketing_agree: Optional[bool] = Field(False, description='마케팅동의 여부', example=False)
+    # extra
+    login: Optional[UserLoginType] = Field(None, description='로그인 상태' + UserLoginType.get_elements_str(), example=UserLoginType.logout)  # TODO(hsj100): LOGIN_STATUS
+    # uuid: Optional[str] = Field(None, description='UUID', example='12345678-1234-5678-1234-567800000001')
+    member_type: Optional[MemberType] = Field(None, description='회원 타입' + MemberType.get_elements_str(), example=MemberType.personal)
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserUpdateMultiReq(BaseModel):
+    """
+    ### [Request] 유저 변경 (multi)
+    """
+    search_info: UserSearchReq = None
+    update_info: UserUpdateReq = None
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserUpdatePWReq(BaseModel):
+    """
+    ### [Request] 유저 비밀번호 변경
+    """
+    account: str = Field(None, description='계정', example='user1@test.com')
+    current_pw: str = Field(None, description='현재 비밀번호', example='1234')
+    new_pw: str = Field(None, description='신규 비밀번호', example='5678')
+
+
+class UserLogSearchReq(BaseModel):
+    """
+    ### [Request] 유저로그 검색
+    """
+    # basic
+    id: Optional[int] = Field(None, description='등록번호', example='1')
+    id__in: Optional[list] = Field(None, description='등록번호 리스트', example=[1,])
+    created_at: Optional[str] = Field(None, description='생성날짜', example='2022-01-01T12:34:56')
+    created_at__gt: Optional[str] = Field(None, description='생성날짜(주어진 날짜 이후)', example='2022-02-10T15:00:00')
+    created_at__gte: Optional[str] = Field(None, description='생성날짜(주어진 날짜 포함 이후)', example='2022-02-10T15:00:00')
+    created_at__lt: Optional[str] = Field(None, description='생성날짜(주어진 날짜 이전)', example='2022-02-10T15:00:00')
+    created_at__lte: Optional[str] = Field(None, description='생성날짜(주어진 날짜 포함 이전)', example='2022-02-10T15:00:00')
+    updated_at: Optional[str] = Field(None, description='수정날짜', example='2022-01-01T12:34:56')
+    updated_at__gt: Optional[str] = Field(None, description='생성날짜(주어진 날짜 이후)', example='2022-02-10T15:00:00')
+    updated_at__gte: Optional[str] = Field(None, description='생성날짜(주어진 날짜 포함 이후)', example='2022-02-10T15:00:00')
+    updated_at__lt: Optional[str] = Field(None, description='생성날짜(주어진 날짜 이전)', example='2022-02-10T15:00:00')
+    updated_at__lte: Optional[str] = Field(None, description='생성날짜(주어진 날짜 포함 이전)', example='2022-02-10T15:00:00')
+
+    account: Optional[str] = Field(None, description='계정', example='user1@test.com')
+    account__like: Optional[str] = Field(None, description='계정 부분검색', example='%user%')
+    mac: Optional[str] = Field(None, description='MAC', example='11:22:33:44:55:01')
+    mac__like: Optional[str] = Field(None, description='MAC 부분검색', example='%33%')
+    type: Optional[UserLogMessageType] = Field(None, description='유저로그 메시지 타입' + UserLogMessageType.get_elements_str(), example=UserLogMessageType.error)
+    api: Optional[str] = Field(None, description='API 이름', example='/api/auth/login')
+    api__like: Optional[str] = Field(None, description='API 이름 부분검색', example='%login%')
+    message: Optional[str] = Field(None, description='로그내용', example='invalid password')
+    message__like: Optional[str] = Field(None, description='로그내용 부분검색', example='%invalid%')
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserLogDayInfo(BaseModel):
+    """
+        ### 유저로그 일별 접속 정보 (출석)
+    """
+    account: str = Field(None, description='계정', example='user1@test.com')
+    mac: str = Field(None, description='MAC(네트워크 인터페이스 식별자)', example='11:22:33:44:55:66')
+    updated_at: datetime = Field(None, description='수정날짜', example='2022-01-01T12:34:56')
+    message: str = Field(None, description='로그 내용', example='ok')
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserLogDaySearchReq(BaseModel):
+    """
+    ### [Request] 유저로그 일별 마지막 접속 검색
+    """
+    updated_at: Optional[str] = Field(None, description='수정날짜', example='2022-01-01T12:34:56')
+    updated_at__gt: Optional[str] = Field(None, description='생성날짜(주어진 날짜 이후)', example='2022-02-10T15:00:00')
+    updated_at__gte: Optional[str] = Field(None, description='생성날짜(주어진 날짜 포함 이후)', example='2022-02-10T15:00:00')
+    updated_at__lt: Optional[str] = Field(None, description='생성날짜(주어진 날짜 이전)', example='2022-02-10T15:00:00')
+    updated_at__lte: Optional[str] = Field(None, description='생성날짜(주어진 날짜 포함 이전)', example='2022-02-10T15:00:00')
+
+    account: Optional[str] = Field(None, description='계정', example='user1@test.com')
+    account__like: Optional[str] = Field(None, description='계정 부분검색', example='%user%')
+    mac: Optional[str] = Field(None, description='MAC', example='11:22:33:44:55:01')
+    mac__like: Optional[str] = Field(None, description='MAC 부분검색', example='%33%')
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserLogDaySearchPagingReq(BaseModel):
+    """
+    ### [Request] 유저로그 일별 마지막 접속 페이징 검색
+    """
+    # paging
+    paging: Optional[PagingReq] = None
+    search: Optional[UserLogDaySearchReq] = None
+
+
+class UserLogDaySearchPagingRes(ResponseBase):
+    """
+    ### [Response] 유저로그 일별 마지막 접속 검색
+    """
+    paging: PagingRes = None
+    data: List[UserLogDayInfo] = []
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserLogPagingReq(BaseModel):
+    """
+    ### [Request] 유저로그 페이징 검색
+    """
+    # paging
+    paging: Optional[PagingReq] = None
+    search: Optional[UserLogSearchReq] = None
+
+
+class UserLogPagingRes(ResponseBase):
+    """
+    ### [Response] 유저로그 페이징 검색
+    """
+    paging: PagingRes = None
+    data: List[UserLogInfo] = []
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserLogUpdateReq(BaseModel):
+    """
+    ### [Request] 유저로그 변경
+    """
+    account: Optional[str] = Field(None, description='계정', example='user1@test.com')
+    mac: Optional[str] = Field(None, description='MAC', example='11:22:33:44:55:01')
+    type: Optional[UserLogMessageType] = Field(None, description='유저로그 메시지 타입' + UserLogMessageType.get_elements_str(), example=UserLogMessageType.error)
+    api: Optional[str] = Field(None, description='API 이름', example='/api/auth/login')
+    message: Optional[str] = Field(None, description='로그내용', example='invalid password')
+
+    model_config = ConfigDict(from_attributes=True)
+
+
+class UserLogUpdateMultiReq(BaseModel):
+    """
+    ### [Request] 유저로그 변경 (multi)
+    """
+    search_info: UserLogSearchReq = None
+    update_info: UserLogUpdateReq = None
+
+    model_config = ConfigDict(from_attributes=True)
+
+#===============================================================================
+#===============================================================================
+#===============================================================================
+#===============================================================================
--- a/rest/app/routes/auth.py
+++ b/rest/app/routes/auth.py
@@ -0,0 +1,93 @@
+# -*- coding: utf-8 -*-
+"""
+@File: auth.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: authentication api
+"""
+
+from itertools import groupby
+from operator import attrgetter
+from fastapi import APIRouter, Depends
+from sqlalchemy.orm import Session
+import bcrypt
+import jwt
+from datetime import datetime, timedelta
+
+from rest.app.common import consts
+from rest.app import models as M
+from rest.app.database.conn import db
+from rest.app.common.config import conf
+from rest.app.database.schema import Users, UserLog
+from rest.app.utils.extra import query_to_groupby, AESCryptoCBC
+from rest.app.utils.date_utils import D
+
+router = APIRouter(prefix='/auth')
+
+
+@router.get('/find-account/{account}', response_model=M.ResponseBase, summary='계정유무 검사')
+async def find_account(account: str):
+    """
+    ## 계정유무 검사
+
+    주어진 계정이 존재하면 true, 없으면 false 처리
+
+    **결과**
+      - ResponseBase
+    """
+    try:
+        search_info = Users.get(account=account)
+        if not search_info:
+            raise Exception(f'not found data: {account}')
+        return M.ResponseBase()
+    except Exception as e:
+        return M.ResponseBase.set_error(str(e))
+
+
+@router.post('/logout/{account}', status_code=200, response_model=M.TokenRes, summary='사용자 접속종료')
+async def logout(account: str):
+    """
+    ## 사용자 접속종료
+
+    현재 버전에서는 로그인/로그아웃의 상태를 유지하지 않고 상태값만을 서버에서 사용하기 때문에,\n
+    ***로그상태는 실제상황과 다를 수 있다.***
+
+    정상처리시 Authorization(null) 반환
+
+    **결과**
+      - TokenRes
+    """
+    user_info = None
+
+    try:
+        # TODO(hsj100): LOGIN_STATUS
+        user_info = Users.filter(account=account)
+        if not user_info:
+            raise Exception('not found user')
+
+        user_info.update(auto_commit=True, login='logout')
+        return M.TokenRes()
+    except Exception as e:
+        if user_info:
+            user_info.close()
+        return M.ResponseBase.set_error(e)
+
+
+async def is_account_exist(account: str):
+    get_account = Users.get(account=account)
+    return True if get_account else False
+
+
+def create_access_token(*, data: dict = None, expires_delta: int = None):
+
+    if conf().GLOBAL_TOKEN:
+        return conf().GLOBAL_TOKEN
+
+    to_encode = data.copy()
+    if expires_delta:
+        to_encode.update({'exp': datetime.utcnow() + timedelta(hours=expires_delta)})
+    encoded_jwt = jwt.encode(to_encode, consts.JWT_SECRET, algorithm=consts.JWT_ALGORITHM)
+    return encoded_jwt
--- a/rest/app/routes/dev.py
+++ b/rest/app/routes/dev.py
@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+"""
+@File: dev.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: Developments Test
+"""
+import struct
+
+from fastapi import APIRouter, Depends
+from sqlalchemy.orm import Session
+import bcrypt
+from starlette.requests import Request
+
+from rest.app.common import consts
+from rest.app import models as M
+from rest.app.database.conn import db, Base
+from rest.app.database.schema import Users, UserLog
+
+from rest.app.utils.extra import FernetCrypto, AESCryptoCBC, AESCipher
+from custom_logger.custom_log import custom_logger as LOG
+
+
+# mail test
+import smtplib
+from email.mime.text import MIMEText
+from email.mime.multipart import MIMEMultipart
+
+
+def send_mail():
+    """
+    구글 계정사용시 : 보안 수준이 낮은 앱에서의 접근 활성화
+
+    :return:
+    """
+    sender = 'jolimola@gmail.com'
+    sender_pw = '!ghkdtmdwns1'
+    # recipient = 'hsj100@a2tec.co.kr'
+    recipient = 'jwkim@daooldns.co.kr'
+    list_cc = ['cc1@gmail.com', 'cc2@naver.com']
+    str_cc = ','.join(list_cc)
+
+    title = 'Test mail'
+    contents = '''
+    This is test mail
+    using smtplib.
+    '''
+
+    smtp_server = smtplib.SMTP(  # 1
+        host='smtp.gmail.com',
+        port=587
+    )
+
+    smtp_server.ehlo()  # 2
+    smtp_server.starttls()  # 2
+    smtp_server.ehlo()  # 2
+    smtp_server.login(sender, sender_pw)  # 3
+
+    msg = MIMEMultipart()  # 4
+    msg['From'] = sender  # 5
+    msg['To'] = recipient  # 5
+    # msg['Cc'] = str_cc  # 5
+    msg['Subject'] = contents  # 5
+    msg.attach(MIMEText(contents, 'plain'))  # 6
+
+    smtp_server.send_message(msg)  # 7
+    smtp_server.quit()  # 8
+
+
+router = APIRouter(prefix='/dev')
+
+
+@router.get('/test', summary='테스트', response_model=M.SWInfo)
+async def test(request: Request):
+    """
+    ## ELB 상태 체크용 API
+
+    **결과**
+     - SWInfo
+    """
+
+    a = M.SWInfo()
+
+    a.name = '!ekdnfeldpsdptm1'
+    # a.name = 'testtesttest123'
+    simpleEnDecrypt = FernetCrypto()
+    a.data1 = simpleEnDecrypt.encrypt(a.name)
+    a.data2 = bcrypt.hashpw(a.name.encode('utf-8'), bcrypt.gensalt())
+
+    t = bytes(a.name.encode('utf-8'))
+
+    enc = AESCryptoCBC().encrypt(t)
+    dec = AESCryptoCBC().decrypt(enc)
+
+    t = enc.decode('utf-8')
+
+    # enc = AESCipher('daooldns12345678').encrypt(a.name).decode('utf-8')
+    # enc = 'E563ZFt+yJL8YY5yYlYyk602MSscPP2SCCD8UtXXpMI='
+    # dec = AESCipher('daooldns12345678').decrypt(enc).decode('utf-8')
+
+    a.data3 = f'enc: {enc}, {t}'
+    a.data4 = f'dec: {dec}'
+    
+    a.name = '!ekdnfeldpsdptm1'
+    
+    
+    # simpleEnDecrypt = SimpleEnDecrypt()
+    a.data5 = simpleEnDecrypt.encrypt(a.name)
+    a.data6 = bcrypt.hashpw(a.name.encode('utf-8'), bcrypt.gensalt())
+
+    key = consts.ADMIN_INIT_ACCOUNT_INFO['aes_cbc_key']
+
+    t = bytes(a.name.encode('utf-8'))
+
+    enc = AESCryptoCBC(key).encrypt(t)
+    dec = AESCryptoCBC(key).decrypt(enc)
+
+    t = enc.decode('utf-8')
+
+    # enc = AESCipher('daooldns12345678').encrypt(a.name).decode('utf-8')
+    # enc = 'E563ZFt+yJL8YY5yYlYyk602MSscPP2SCCD8UtXXpMI='
+    # dec = AESCipher('daooldns12345678').decrypt(enc).decode('utf-8')
+
+    print(f'key: {key}')
+    a.data7 = f'enc: {enc}, {t}'
+    a.data8 = f'dec: {dec}'
+
+    
+    eee = "gAAAAABioV5NucuS9nQugZJnz-KjVG_FGnaowB9KAfhOoWjjiQ4jGLuYJh4Qe94mT_lCm6m3HhuOJqUeOgjppwREDpIQYzrUXA=="
+    a.data8  = simpleEnDecrypt.decrypt(eee)
+    
+    return a
+
+
--- a/rest/app/routes/index.py
+++ b/rest/app/routes/index.py
@@ -0,0 +1,32 @@
+# -*- coding: utf-8 -*-
+"""
+@File: index.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: basic & test api
+"""
+
+from fastapi import APIRouter
+
+from rest.app.utils.date_utils import D
+from rest.app.models import SWInfo
+
+
+router = APIRouter()
+
+
+@router.get('/', summary='서비스 정보', response_model=SWInfo)
+async def index():
+    """
+    ## 서비스 정보
+    소프트웨어 이름, 버전정보, 현재시간
+
+    **결과**
+     - SWInfo
+    """
+    sw_info = SWInfo()
+    sw_info.date = D.date_str()
+    return sw_info
--- a/rest/app/routes/services.py
+++ b/rest/app/routes/services.py
@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+"""
+@File: services.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: services api
+"""
+
+import requests, json, traceback
+from fastapi import APIRouter, Depends, Body
+from starlette.requests import Request
+from typing import Annotated, List
+
+from rest.app.common import consts
+from rest.app import models as M
+from rest.app.utils.date_utils import D
+from custom_logger.custom_log import custom_logger as LOG
+
+
+
+router = APIRouter(prefix="/services")
+
+
--- a/rest/app/routes/users.py
+++ b/rest/app/routes/users.py
@@ -0,0 +1,298 @@
+# -*- coding: utf-8 -*-
+"""
+@File: users.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: users api
+"""
+
+from fastapi import APIRouter
+from starlette.requests import Request
+import bcrypt
+
+from rest.app.common import consts
+from rest.app import models as M
+from rest.app.common.config import conf
+from rest.app.database.schema import Users
+from rest.app.database.crud import table_select, table_update, table_delete
+
+from rest.app.utils.extra import AESCryptoCBC
+
+
+router = APIRouter(prefix='/user')
+
+
+@router.get('/me', response_model=M.UserSearchRes, summary='접속자 정보')
+async def get_me(request: Request):
+    """
+    ## 현재 접속된 자신정보 확인
+
+    ***현 버전 미지원(추후 상세 처리)***
+
+    **결과**
+      - UserSearchRes
+    """
+    target_table = Users
+    search_info = None
+
+    try:
+        # request
+        if conf().GLOBAL_TOKEN:
+            raise Exception('not supported: use search api!')
+
+        accessor_info = request.state.user
+        if not accessor_info:
+            raise Exception('invalid accessor')
+
+        # search
+        search_info = target_table.get(account=accessor_info.account)
+        if not search_info:
+            raise Exception('not found data')
+
+        # result
+        result_info = list()
+        result_info.append(M.UserInfo.from_orm(search_info))
+        return M.UserSearchRes(data=result_info)
+    except Exception as e:
+        if search_info:
+            search_info.close()
+        return M.ResponseBase.set_error(str(e))
+
+
+@router.post('/search', response_model=M.UserSearchPagingRes, summary='유저정보 검색')
+async def user_search(request: Request, request_body_info: M.UserSearchPagingReq):
+    """
+    ## 유저정보 검색 (기본)
+    검색 조건은 유저 테이블 항목만 가능 (Request body: Schema 참조)\n
+    관련 정보 연동 검색은 별도 API 사용
+
+    **세부항목**
+    - **paging**\n
+      항목 미사용시에는 페이징기능 없이 검색조건(search) 결과 모두 반환
+
+    - **search**\n
+      검색에 필요한 항목들을 search 에 포함시킨다.\n
+      검색에 사용된 각 항목들은 AND 조건으로 처리된다.
+
+      - **전체검색**\n
+        empty object 사용 ( {} )\n
+            예) "search": {}
+
+      - **검색항목**\n
+        - 부분검색 항목\n
+          SQL 문법( %, _ )을 사용한다.\n
+          __like: 시작포함(X%), 중간포함(%X%), 끝포함(%X)
+        - 구간검색 항목
+            * __lt: 주어진 값보다 작은값
+            * __lte: 주어진 값보다 같거나 작은 값
+            * __gt: 주어진 값보다 큰값
+            * __gte: 주어진 값보다 같거나 큰값
+
+    **결과**
+      - UserSearchPagingRes
+    """
+    return await table_select(request.state.user, Users, request_body_info, M.UserSearchPagingRes, M.UserInfo)
+
+
+@router.put('/update', response_model=M.ResponseBase, summary='유저정보 변경')
+async def user_update(request: Request, request_body_info: M.UserUpdateMultiReq):
+    """
+    ## 유저정보 변경
+
+    **search_info**: 변경대상\n
+
+    **update_info**: 변경내용\n
+      - **비밀번호** 제외
+
+    **결과**
+      - ResponseBase
+    """
+    return await table_update(request.state.user, Users, request_body_info, M.ResponseBase)
+
+
+@router.put('/update_pw', response_model=M.ResponseBase, summary='유저 비밀번호 변경')
+async def user_update_pw(request: Request, request_body_info: M.UserUpdatePWReq):
+    """
+    ## 유저정보 비밀번호 변경
+
+    **account**의 **비밀번호**를 변경한다.
+
+    **결과**
+      - ResponseBase
+    """
+    target_table = Users
+    search_info = None
+
+    try:
+        # request
+        accessor_info = request.state.user
+        if not accessor_info:
+            raise Exception('invalid accessor')
+        if not request_body_info.account:
+            raise Exception('invalid account')
+
+        # decrypt pw
+        try:
+            decode_cur_pw = request_body_info.current_pw.encode('utf-8')
+            desc_cur_pw = AESCryptoCBC().decrypt(decode_cur_pw)
+        except Exception as e:
+            raise Exception(f'failed decryption [current_pw]: {e}')
+        try:
+            decode_new_pw = request_body_info.new_pw.encode('utf-8')
+            desc_new_pw = AESCryptoCBC().decrypt(decode_new_pw)
+        except Exception as e:
+            raise Exception(f'failed decryption [new_pw]: {e}')
+
+        # search
+        target_user = target_table.get(account=request_body_info.account)
+        is_verified = bcrypt.checkpw(desc_cur_pw, target_user.pw.encode('utf-8'))
+        if not is_verified:
+            raise Exception('invalid password')
+
+        search_info = target_table.filter(id=target_user.id)
+        if not search_info.first():
+            raise Exception('not found data')
+
+        # process
+        hash_pw = bcrypt.hashpw(desc_new_pw, bcrypt.gensalt())
+        result_info = search_info.update(auto_commit=True, pw=hash_pw)
+        if not result_info or not result_info.id:
+            raise Exception('failed update')
+
+        # result
+        return M.ResponseBase()
+    except Exception as e:
+        if search_info:
+            search_info.close()
+        return M.ResponseBase.set_error(str(e))
+
+
+@router.delete('/delete', response_model=M.ResponseBase, summary='유저정보 삭제')
+async def user_delete(request: Request, request_body_info: M.UserSearchReq):
+    """
+    ## 유저정보 삭제
+    조건에 해당하는 정보를 모두 삭제한다.\n
+      - **본 API는 DB에서 완적삭제를 하는 함수이며, 서버관리자가 사용하는 것을 권장한다.**
+      - **update API를 사용하여 상태 항목을 변경해서 사용하는 것을 권장.**
+
+    `유저삭제시 관계 테이블의 정보도 같이 삭제된다.`
+
+    **결과**
+      - ResponseBase
+    """
+    return await table_delete(request.state.user, Users, request_body_info, M.ResponseBase)
+
+
+# NOTE(hsj100): apikey
+"""
+"""
+# @router.get('/apikeys', response_model=List[M.GetApiKeyList])
+# async def get_api_keys(request: Request):
+#     """
+#     API KEY 조회
+#     :param request:
+#     :return:
+#     """
+#     user = request.state.user
+#     api_keys = ApiKeys.filter(user_id=user.id).all()
+#     return api_keys
+#
+#
+# @router.post('/apikeys', response_model=M.GetApiKeys)
+# async def create_api_keys(request: Request, key_info: M.AddApiKey, session: Session = Depends(db.session)):
+#     """
+#     API KEY 생성
+#     :param request:
+#     :param key_info:
+#     :param session:
+#     :return:
+#     """
+#     user = request.state.user
+#
+#     api_keys = ApiKeys.filter(session, user_id=user.id, status='active').count()
+#     if api_keys == MAX_API_KEY:
+#         raise ex.MaxKeyCountEx()
+#
+#     alphabet = string.ascii_letters + string.digits
+#     s_key = ''.join(secrets.choice(alphabet) for _ in range(40))
+#     uid = None
+#     while not uid:
+#         uid_candidate = f'{str(uuid4())[:-12]}{str(uuid4())}'
+#         uid_check = ApiKeys.get(access_key=uid_candidate)
+#         if not uid_check:
+#             uid = uid_candidate
+#
+#     key_info = key_info.dict()
+#     new_key = ApiKeys.create(session, auto_commit=True, secret_key=s_key, user_id=user.id, access_key=uid, **key_info)
+#     return new_key
+#
+#
+# @router.put('/apikeys/{key_id}', response_model=M.GetApiKeyList)
+# async def update_api_keys(request: Request, key_id: int, key_info: M.AddApiKey):
+#     """
+#     API KEY User Memo Update
+#     :param request:
+#     :param key_id:
+#     :param key_info:
+#     :return:
+#     """
+#     user = request.state.user
+#     key_data = ApiKeys.filter(id=key_id)
+#     if key_data and key_data.first().user_id == user.id:
+#         return key_data.update(auto_commit=True, **key_info.dict())
+#     raise ex.NoKeyMatchEx()
+#
+#
+# @router.delete('/apikeys/{key_id}')
+# async def delete_api_keys(request: Request, key_id: int, access_key: str):
+#     user = request.state.user
+#     await check_api_owner(user.id, key_id)
+#     search_by_key = ApiKeys.filter(access_key=access_key)
+#     if not search_by_key.first():
+#         raise ex.NoKeyMatchEx()
+#     search_by_key.delete(auto_commit=True)
+#     return MessageOk()
+#
+#
+# @router.get('/apikeys/{key_id}/whitelists', response_model=List[M.GetAPIWhiteLists])
+# async def get_api_keys(request: Request, key_id: int):
+#     user = request.state.user
+#     await check_api_owner(user.id, key_id)
+#     whitelists = ApiWhiteLists.filter(api_key_id=key_id).all()
+#     return whitelists
+#
+#
+# @router.post('/apikeys/{key_id}/whitelists', response_model=M.GetAPIWhiteLists)
+# async def create_api_keys(request: Request, key_id: int, ip: M.CreateAPIWhiteLists, session: Session = Depends(db.session)):
+#     user = request.state.user
+#     await check_api_owner(user.id, key_id)
+#     import ipaddress
+#     try:
+#         _ip = ipaddress.ip_address(ip.ip_addr)
+#     except Exception as e:
+#         raise ex.InvalidIpEx(ip.ip_addr, e)
+#     if ApiWhiteLists.filter(api_key_id=key_id).count() == MAX_API_WHITELIST:
+#         raise ex.MaxWLCountEx()
+#     ip_dup = ApiWhiteLists.get(api_key_id=key_id, ip_addr=ip.ip_addr)
+#     if ip_dup:
+#         return ip_dup
+#     ip_reg = ApiWhiteLists.create(session=session, auto_commit=True, api_key_id=key_id, ip_addr=ip.ip_addr)
+#     return ip_reg
+#
+#
+# @router.delete('/apikeys/{key_id}/whitelists/{list_id}')
+# async def delete_api_keys(request: Request, key_id: int, list_id: int):
+#     user = request.state.user
+#     await check_api_owner(user.id, key_id)
+#     ApiWhiteLists.filter(id=list_id, api_key_id=key_id).delete()
+#
+#     return MessageOk()
+#
+#
+# async def check_api_owner(user_id, key_id):
+#     api_keys = ApiKeys.get(id=key_id, user_id=user_id)
+#     if not api_keys:
+#         raise ex.NoKeyMatchEx()
--- a/rest/app/utils/_temp.py
+++ b/rest/app/utils/_temp.py
@@ -0,0 +1,17 @@
+ps_list = [
+{"LOAD_ORD_NO":"PS202311010109","DELIVERY_ORDER_NO":"5015958110","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007189167","ORD_LINE_NO":"000010","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHJ2G1","DIMS_CODE_MEANING":"H 390 x 300 x 10/16","ORD_LENGTH":14000,"LOAD_SITE_CD":"P4330","LOAD_SITE_CD_MEANING":"C구역","YD_STRE_LOC_CD":"O0211","BUNDLE_PCS_CNT":3,"BS_BD_NO":0,"PROD_PCS_PIECE_NO":1,"PROD_WGT":1498,"ARR_LOC_CD":"432","ARR_LOC_CD_MEANING":"충남 천안시","VEHL_NO":"서울98바9283","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5388-5588","PROD_PIECE_WGHT":1498,"PROD_COL":3,"PROD_ROW":1,"PROD_TP":"I","PROD_THIK_1":10,"PROD_THIK_2":16,"PROD_HGHT":390,"PROD_SIDE":300,"TOT_COL_WTH":610,"TOT_ROW_HGT":406},
+{"LOAD_ORD_NO":"PS202311010109","DELIVERY_ORDER_NO":"5015958111","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007189167","ORD_LINE_NO":"000020","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHH3K1","DIMS_CODE_MEANING":"H 350 x 350 x 12/19","ORD_LENGTH":12000,"LOAD_SITE_CD":"P1600","LOAD_SITE_CD_MEANING":"형강1출하장","YD_STRE_LOC_CD":"F0208","BUNDLE_PCS_CNT":2,"BS_BD_NO":0,"PROD_PCS_PIECE_NO":1,"PROD_WGT":1644,"ARR_LOC_CD":"432","ARR_LOC_CD_MEANING":"충남 천안시","VEHL_NO":"서울98바9283","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5388-5588","PROD_PIECE_WGHT":1644,"PROD_COL":2,"PROD_ROW":1,"PROD_TP":"I","PROD_THIK_1":12,"PROD_THIK_2":19,"PROD_HGHT":350,"PROD_SIDE":350,"TOT_COL_WTH":531,"TOT_ROW_HGT":369},
+{"LOAD_ORD_NO":"PS202311010109","DELIVERY_ORDER_NO":"5015958112","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007189167","ORD_LINE_NO":"000030","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHH3K1","DIMS_CODE_MEANING":"H 350 x 350 x 12/19","ORD_LENGTH":11000,"LOAD_SITE_CD":"P1600","LOAD_SITE_CD_MEANING":"형강1출하장","YD_STRE_LOC_CD":"K0261","BUNDLE_PCS_CNT":2,"BS_BD_NO":0,"PROD_PCS_PIECE_NO":1,"PROD_WGT":1507,"ARR_LOC_CD":"432","ARR_LOC_CD_MEANING":"충남 천안시","VEHL_NO":"서울98바9283","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5388-5588","PROD_PIECE_WGHT":1507,"PROD_COL":2,"PROD_ROW":1,"PROD_TP":"I","PROD_THIK_1":12,"PROD_THIK_2":19,"PROD_HGHT":350,"PROD_SIDE":350,"TOT_COL_WTH":531,"TOT_ROW_HGT":369},
+{"LOAD_ORD_NO":"PS202311010109","DELIVERY_ORDER_NO":"5015958113","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007189167","ORD_LINE_NO":"000040","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHG191","DIMS_CODE_MEANING":"H 300 x 150 x 6.5/9","ORD_LENGTH":11000,"LOAD_SITE_CD":"P4330","LOAD_SITE_CD_MEANING":"C구역","YD_STRE_LOC_CD":"O0201","BUNDLE_PCS_CNT":10,"BS_BD_NO":0,"PROD_PCS_PIECE_NO":2,"PROD_WGT":808,"ARR_LOC_CD":"432","ARR_LOC_CD_MEANING":"충남 천안시","VEHL_NO":"서울98바9283","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5388-5588","PROD_PIECE_WGHT":404,"PROD_COL":2,"PROD_ROW":5,"PROD_TP":"H","PROD_THIK_1":6.5,"PROD_THIK_2":9,"PROD_HGHT":300,"PROD_SIDE":150,"TOT_COL_WTH":618,"TOT_ROW_HGT":463},
+{"LOAD_ORD_NO":"PS202311010109","DELIVERY_ORDER_NO":"5015958114","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007189167","ORD_LINE_NO":"000050","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHG191","DIMS_CODE_MEANING":"H 300 x 150 x 6.5/9","ORD_LENGTH":9000,"LOAD_SITE_CD":"P4310","LOAD_SITE_CD_MEANING":"A구역","YD_STRE_LOC_CD":"Y0219","BUNDLE_PCS_CNT":10,"BS_BD_NO":0,"PROD_PCS_PIECE_NO":1,"PROD_WGT":330,"ARR_LOC_CD":"432","ARR_LOC_CD_MEANING":"충남 천안시","VEHL_NO":"서울98바9283","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5388-5588","PROD_PIECE_WGHT":330,"PROD_COL":2,"PROD_ROW":5,"PROD_TP":"H","PROD_THIK_1":6.5,"PROD_THIK_2":9,"PROD_HGHT":300,"PROD_SIDE":150,"TOT_COL_WTH":618,"TOT_ROW_HGT":463},
+{"LOAD_ORD_NO":"PS202311010109","DELIVERY_ORDER_NO":"5015958115","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007189167","ORD_LINE_NO":"000060","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHF3E1","DIMS_CODE_MEANING":"H 250 x 250 x 9/14","ORD_LENGTH":12000,"LOAD_SITE_CD":"P4310","LOAD_SITE_CD_MEANING":"A구역","YD_STRE_LOC_CD":"Y0205","BUNDLE_PCS_CNT":4,"BS_BD_NO":0,"PROD_PCS_PIECE_NO":1,"PROD_WGT":869,"ARR_LOC_CD":"432","ARR_LOC_CD_MEANING":"충남 천안시","VEHL_NO":"서울98바9283","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5388-5588","PROD_PIECE_WGHT":869,"PROD_COL":2,"PROD_ROW":2,"PROD_TP":"H","PROD_THIK_1":9,"PROD_THIK_2":14,"PROD_HGHT":250,"PROD_SIDE":250,"TOT_COL_WTH":528,"TOT_ROW_HGT":379.5},
+{"LOAD_ORD_NO":"PS202311010109","DELIVERY_ORDER_NO":"5015958116","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007189167","ORD_LINE_NO":"000070","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHE3C1","DIMS_CODE_MEANING":"H 200 x 200 x 8/12","ORD_LENGTH":11000,"LOAD_SITE_CD":"P4320","LOAD_SITE_CD_MEANING":"B구역","YD_STRE_LOC_CD":"W0233","BUNDLE_PCS_CNT":6,"BS_BD_NO":1,"PROD_PCS_PIECE_NO":0,"PROD_WGT":3294,"ARR_LOC_CD":"432","ARR_LOC_CD_MEANING":"충남 천안시","VEHL_NO":"서울98바9283","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5388-5588","PROD_PIECE_WGHT":549,"PROD_COL":2,"PROD_ROW":3,"PROD_TP":"H","PROD_THIK_1":8,"PROD_THIK_2":12,"PROD_HGHT":200,"PROD_SIDE":200,"TOT_COL_WTH":424,"TOT_ROW_HGT":408},
+{"LOAD_ORD_NO":"PS202311010109","DELIVERY_ORDER_NO":"5015958117","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007189167","ORD_LINE_NO":"000080","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHE291","DIMS_CODE_MEANING":"H 194 x 150 x 6/9","ORD_LENGTH":12000,"LOAD_SITE_CD":"P4320","LOAD_SITE_CD_MEANING":"B구역","YD_STRE_LOC_CD":"W0201","BUNDLE_PCS_CNT":12,"BS_BD_NO":0,"PROD_PCS_PIECE_NO":1,"PROD_WGT":367,"ARR_LOC_CD":"432","ARR_LOC_CD_MEANING":"충남 천안시","VEHL_NO":"서울98바9283","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5388-5588","PROD_PIECE_WGHT":367,"PROD_COL":3,"PROD_ROW":4,"PROD_TP":"H","PROD_THIK_1":6,"PROD_THIK_2":9,"PROD_HGHT":194,"PROD_SIDE":150,"TOT_COL_WTH":600,"TOT_ROW_HGT":384},
+{"LOAD_ORD_NO":"PS202311010109","DELIVERY_ORDER_NO":"5015958118","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007189167","ORD_LINE_NO":"000090","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHC3A1","DIMS_CODE_MEANING":"H 150 x 150 x 7/10","ORD_LENGTH":12000,"LOAD_SITE_CD":"P4300","LOAD_SITE_CD_MEANING":"형강제품창고","YD_STRE_LOC_CD":"C0214","BUNDLE_PCS_CNT":12,"BS_BD_NO":0,"PROD_PCS_PIECE_NO":2,"PROD_WGT":756,"ARR_LOC_CD":"432","ARR_LOC_CD_MEANING":"충남 천안시","VEHL_NO":"서울98바9283","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5388-5588","PROD_PIECE_WGHT":378,"PROD_COL":3,"PROD_ROW":4,"PROD_TP":"H","PROD_THIK_1":7,"PROD_THIK_2":10,"PROD_HGHT":150,"PROD_SIDE":150,"TOT_COL_WTH":470,"TOT_ROW_HGT":385.5},
+{"LOAD_ORD_NO":"PS202311010109","DELIVERY_ORDER_NO":"5015958119","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007189167","ORD_LINE_NO":"000100","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHC3A1","DIMS_CODE_MEANING":"H 150 x 150 x 7/10","ORD_LENGTH":10000,"LOAD_SITE_CD":"P4300","LOAD_SITE_CD_MEANING":"형강제품창고","YD_STRE_LOC_CD":"B0204","BUNDLE_PCS_CNT":12,"BS_BD_NO":0,"PROD_PCS_PIECE_NO":3,"PROD_WGT":945,"ARR_LOC_CD":"432","ARR_LOC_CD_MEANING":"충남 천안시","VEHL_NO":"서울98바9283","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5388-5588","PROD_PIECE_WGHT":315,"PROD_COL":3,"PROD_ROW":4,"PROD_TP":"H","PROD_THIK_1":7,"PROD_THIK_2":10,"PROD_HGHT":150,"PROD_SIDE":150,"TOT_COL_WTH":470,"TOT_ROW_HGT":385.5},
+{"LOAD_ORD_NO":"PS202311010109","DELIVERY_ORDER_NO":"5015958122","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007191107","ORD_LINE_NO":"000030","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHF3E1","DIMS_CODE_MEANING":"H 250 x 250 x 9/14","ORD_LENGTH":10000,"LOAD_SITE_CD":"P1600","LOAD_SITE_CD_MEANING":"형강1출하장","YD_STRE_LOC_CD":"K0253","BUNDLE_PCS_CNT":4,"BS_BD_NO":4,"PROD_PCS_PIECE_NO":2,"PROD_WGT":13032,"ARR_LOC_CD":"441","ARR_LOC_CD_MEANING":"충남 당진시","VEHL_NO":"서울98바9283","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5789-1591","PROD_PIECE_WGHT":724,"PROD_COL":2,"PROD_ROW":2,"PROD_TP":"H","PROD_THIK_1":9,"PROD_THIK_2":14,"PROD_HGHT":250,"PROD_SIDE":250,"TOT_COL_WTH":528,"TOT_ROW_HGT":379.5},
+# {"LOAD_ORD_NO":"PS202311010110","DELIVERY_ORDER_NO":"5015958120","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007191107","ORD_LINE_NO":"000010","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHE181","DIMS_CODE_MEANING":"H 200 x 100 x 5.5/8","ORD_LENGTH":10000,"LOAD_SITE_CD":"P4320","LOAD_SITE_CD_MEANING":"B구역","YD_STRE_LOC_CD":"V0226","BUNDLE_PCS_CNT":12,"BS_BD_NO":3,"PROD_PCS_PIECE_NO":4,"PROD_WGT":8520,"ARR_LOC_CD":"441","ARR_LOC_CD_MEANING":"충남 당진시","VEHL_NO":"경북98사1884","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5789-1591","PROD_PIECE_WGHT":213,"PROD_COL":3,"PROD_ROW":4,"PROD_TP":"H","PROD_THIK_1":5.5,"PROD_THIK_2":8,"PROD_HGHT":200,"PROD_SIDE":100,"TOT_COL_WTH":616,"TOT_ROW_HGT":258.25},
+# {"LOAD_ORD_NO":"PS202311010110","DELIVERY_ORDER_NO":"5015958121","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007191107","ORD_LINE_NO":"000020","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHE3C1","DIMS_CODE_MEANING":"H 200 x 200 x 8/12","ORD_LENGTH":10000,"LOAD_SITE_CD":"P4320","LOAD_SITE_CD_MEANING":"B구역","YD_STRE_LOC_CD":"W0237","BUNDLE_PCS_CNT":6,"BS_BD_NO":2,"PROD_PCS_PIECE_NO":3,"PROD_WGT":7485,"ARR_LOC_CD":"441","ARR_LOC_CD_MEANING":"충남 당진시","VEHL_NO":"경북98사1884","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5789-1591","PROD_PIECE_WGHT":499,"PROD_COL":2,"PROD_ROW":3,"PROD_TP":"H","PROD_THIK_1":8,"PROD_THIK_2":12,"PROD_HGHT":200,"PROD_SIDE":200,"TOT_COL_WTH":424,"TOT_ROW_HGT":408},
+# {"LOAD_ORD_NO":"PS202311010110","DELIVERY_ORDER_NO":"5015958122","DELIVERY_ORDER_LINE_NO":"10","ORD_NO":"3007191107","ORD_LINE_NO":"000030","ITEM_TP_CD":"S","ITEM_TP_CD_MEANING":"형강","SPEC_CD":"KS SM355A ALL","DIMS_CODE":"SHF3E1","DIMS_CODE_MEANING":"H 250 x 250 x 9/14","ORD_LENGTH":10000,"LOAD_SITE_CD":"P1600","LOAD_SITE_CD_MEANING":"형강1출하장","YD_STRE_LOC_CD":"K0253","BUNDLE_PCS_CNT":4,"BS_BD_NO":2,"PROD_PCS_PIECE_NO":3,"PROD_WGT":7964,"ARR_LOC_CD":"441","ARR_LOC_CD_MEANING":"충남 당진시","VEHL_NO":"경북98사1884","VEHICLE_TYPE":"TL01","VEHICLE_TYPE_MEANING":"트레일러 (25톤)","DELY_PHONE":"010-5789-1591","PROD_PIECE_WGHT":724,"PROD_COL":2,"PROD_ROW":2,"PROD_TP":"H","PROD_THIK_1":9,"PROD_THIK_2":14,"PROD_HGHT":250,"PROD_SIDE":250,"TOT_COL_WTH":528,"TOT_ROW_HGT":379.5}
+]
+
--- a/rest/app/utils/date_utils.py
+++ b/rest/app/utils/date_utils.py
@@ -0,0 +1,50 @@
+# -*- coding: utf-8 -*-
+"""
+@File: date_utils.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: date-utility functions
+"""
+
+from datetime import datetime, date, timedelta
+
+_TIMEDELTA = 9
+
+
+class D:
+    def __init__(self, *args):
+        self.utc_now = datetime.utcnow()
+        # NOTE(hsj100): utc->kst
+        self.timedelta = _TIMEDELTA
+
+    @classmethod
+    def datetime(cls, diff: int=_TIMEDELTA) -> datetime:
+        return datetime.utcnow() + timedelta(hours=diff) if diff > 0 else datetime.now()
+
+    @classmethod
+    def date(cls, diff: int=_TIMEDELTA) -> date:
+        return cls.datetime(diff=diff).date()
+
+    @classmethod
+    def date_num(cls, diff: int=_TIMEDELTA) -> int:
+        return int(cls.date(diff=diff).strftime('%Y%m%d'))
+
+    @classmethod
+    def validate(cls, date_text):
+        try:
+            datetime.strptime(date_text, '%Y-%m-%d')
+        except ValueError:
+            raise ValueError('Incorrect data format, should be YYYY-MM-DD')
+
+    @classmethod
+    def date_str(cls, diff: int = _TIMEDELTA) -> str:
+        return cls.datetime(diff=diff).strftime('%Y-%m-%dT%H:%M:%S')
+
+    @classmethod
+    def check_expire_date(cls, expire_date: datetime):
+        td = expire_date - datetime.now()
+        timestamp = td.total_seconds()
+        return timestamp
--- a/rest/app/utils/dk_api_parsing.py
+++ b/rest/app/utils/dk_api_parsing.py
@@ -0,0 +1,197 @@
+from rest.app.utils._temp import ps_list
+
+
+class parsingDKAPI:
+
+    def __init__(self):
+        # self.info_list = []
+        self.info_list = ps_list
+        self.location_list = []  # index 0 사용 안함
+        
+        self.bd_type = None
+        self.bd_meaning = None
+
+    class bundleType:
+        bd = "1"
+        pcs = "0"
+
+    hbeam = "HBeam"
+
+    def set_api_infolist(self, list):
+        self.info_list = list
+
+    def location_list_parsing(self):
+        if not self.info_list:
+            raise
+
+        for i in self.info_list:
+            if isinstance(i, int):
+                pass
+            elif isinstance(i.get("ARR_LOC_CD"), str):
+                self.location_list.append(i.get("ARR_LOC_CD"))
+
+        self.location_list = [-1] + list(set(self.location_list))
+
+    def get_bd_data(self):
+        return (self.bd_type,self.bd_meaning)
+    
+    def parsing(self):
+
+        def pcs_length_parsing(info):
+            import re
+
+            try:
+                width, height = (None, None)
+
+                name = info.get("DIMS_CODE_MEANING")
+
+                blank_name = name.replace(" ", "").split("x")
+
+                width = float(re.sub(r"[a-zA-Z]", "", blank_name[0]))
+                height = int(blank_name[1])
+            except Exception as e:
+                pass
+            finally:
+                return width, height
+
+        def pcs_weight_parsing(info, bd, pcs):
+            try:
+                weight, stdweight = (None, None)
+                weight = int(
+                    (info.get("PROD_WGT")- (info.get("PROD_PIECE_WGHT") * info.get("BUNDLE_PCS_CNT"))* bd)
+                    / pcs
+                )
+                stdweight = weight
+
+            except Exception as e:
+                pass
+            finally:
+                return weight, stdweight
+
+        result = []
+        self.location_list_parsing()
+
+        if not self.info_list:
+            raise
+
+        for info in self.info_list:
+
+            bd = int(info.get("BS_BD_NO")) if info.get("BS_BD_NO") != None else None
+            pcs = int(info.get("PROD_PCS_PIECE_NO")) if info.get("PROD_PCS_PIECE_NO") != None else None
+
+            if info.get("VEHICLE_TYPE_MEANING") != None:
+                if self.bd_meaning:
+                    if self.bd_meaning != info.get("VEHICLE_TYPE_MEANING"):
+                        raise Exception("'VEHICLE_TYPE_MEANING' parsing error")
+                else:
+                    self.bd_meaning = info.get("VEHICLE_TYPE_MEANING")
+                    
+            if info.get("VEHICLE_TYPE") != None:
+                if self.bd_type:
+                    if self.bd_type != info.get("VEHICLE_TYPE"):
+                        raise Exception("'VEHICLE_TYPE' parsing error")
+                else:
+                    self.bd_type = info.get("VEHICLE_TYPE")
+
+            if isinstance(bd, int):
+                if bd == 0:
+                    pass
+                else:
+                    _bd_json = {
+                        "objectType": info.get("COMMDT_NM_CD_MEANING"),
+                        "objectSpec": info.get("DIMS_CODE_MEANING"),
+                        "bundle": self.bundleType.bd,
+                        "stackType": info.get("PROD_TP"),
+                        "dest": {
+                            "date": info.get("CONF_DUE_DATE"),
+                            "time": info.get("CUST_ARRV_TM"),
+                            "name": info.get("ARR_LOC_CD_MEANING"),
+                            "code": info.get("ARR_LOC_CD"),
+                            "no": self.location_list.index(info.get("ARR_LOC_CD")),
+                        },
+                        "width": info.get("TOT_COL_WTH"),
+                        "height": info.get("TOT_ROW_HGT"),
+                        "depth": info.get("ORD_LENGTH"),
+                        "weight": info.get("PROD_PIECE_WGHT") * info.get("BUNDLE_PCS_CNT"),
+                        "loadBearing": info.get("PROD_PIECE_WGHT") * info.get("BUNDLE_PCS_CNT")
+                        ,  # info.get("포장단중코드"),
+                        "stdNum": info.get("BUNDLE_PCS_CNT"),
+                        "stdWeight": info.get("PROD_PIECE_WGHT"),
+                        "widthNum": info.get("PROD_COL"),
+                        "heightNum": info.get("PROD_ROW"),
+                        "addInfo1": (
+                            info.get("PROD_THIK_1")
+                            if info.get("COMMDT_NM_CD_MEANING") == self.hbeam
+                            else 0
+                        ),
+                        "addInfo2": (
+                            info.get("PROD_THIK_2")
+                            if info.get("COMMDT_NM_CD_MEANING") == self.hbeam
+                            else 0
+                        ),
+                        "addInfo3": 0,
+                        "addInfo4": 0,
+                        "addInfo5": 0,
+                        "addInfo6": 0,
+                        "addInfo7": 0,
+                        "addInfo8": 0,
+                        "addInfo9": 0,
+                    }
+                    for i in range(bd):
+                        result.append(_bd_json)
+
+            if isinstance(pcs, int):
+                if pcs == 0:
+                    pass
+                else:
+                    width, height = pcs_length_parsing(info)
+                    weight, stdweight = pcs_weight_parsing(info=info, bd=bd, pcs=pcs)
+                    _pcs_json = {
+                        "objectType": info.get("COMMDT_NM_CD_MEANING"),
+                        "objectSpec": info.get("DIMS_CODE_MEANING"),
+                        "bundle": self.bundleType.pcs,
+                        "stackType": "0",
+                        "dest": {
+                            "date": info.get("CONF_DUE_DATE"),
+                            "time": info.get("CUST_ARRV_TM"),
+                            "name": info.get("ARR_LOC_CD_MEANING"),
+                            "code": info.get("ARR_LOC_CD"),
+                            "no": self.location_list.index(info.get("ARR_LOC_CD")),
+                        },
+                        "width": width,
+                        "height": height,
+                        "depth": info.get("ORD_LENGTH"),
+                        "weight": weight,
+                        "loadBearing": weight,  # info.get("포장단중코드"),
+                        "stdNum": 1,
+                        "stdWeight": stdweight,
+                        "widthNum": 1,
+                        "heightNum": 1,
+                        "addInfo1": (
+                            info.get("PROD_THIK_1")
+                            if info.get("COMMDT_NM_CD_MEANING") == self.hbeam
+                            else 0
+                        ),
+                        "addInfo2": (
+                            info.get("PROD_THIK_2")
+                            if info.get("COMMDT_NM_CD_MEANING") == self.hbeam
+                            else 0
+                        ),
+                        "addInfo3": 0,
+                        "addInfo4": 0,
+                        "addInfo5": 0,
+                        "addInfo6": 0,
+                        "addInfo7": 0,
+                        "addInfo8": 0,
+                        "addInfo9": 0,
+                    }
+                    for i in range(pcs):
+                        result.append(_pcs_json)
+
+        return result
+
+
+if __name__ == "__main__":
+    a = parsingDKAPI()
+    b = a.parsing()
+    pass
--- a/rest/app/utils/extra.py
+++ b/rest/app/utils/extra.py
@@ -0,0 +1,205 @@
+# -*- coding: utf-8 -*-
+"""
+@File: extra.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: extra functions
+"""
+
+from hashlib import md5
+from base64 import b64decode
+from base64 import b64encode
+
+from Crypto.Cipher import AES
+from Crypto.Util.Padding import pad, unpad
+from cryptography.fernet import Fernet  # symmetric encryption
+
+# mail test
+import smtplib
+from email.mime.text import MIMEText
+from email.mime.multipart import MIMEMultipart
+
+from itertools import groupby
+from operator import attrgetter
+import uuid
+
+from rest.app.common.consts import NUM_RETRY_UUID_GEN, SMTP_HOST, SMTP_PORT
+from rest.app.utils.date_utils import D
+from rest.app import models as M
+from rest.app.common.consts import AES_CBC_PUBLIC_KEY, AES_CBC_IV, FERNET_SECRET_KEY
+
+
+async def send_mail(sender, sender_pw, title, recipient, contents_plain, contents_html, cc_list, smtp_host=SMTP_HOST, smtp_port=SMTP_PORT):
+    """
+    구글 계정사용시 : 보안 수준이 낮은 앱에서의 접근 활성화
+
+    :return:
+        None: success
+        Str. Message: error
+    """
+    try:
+        # check parameters
+        if not sender:
+            raise Exception('invalid sender')
+        if not title:
+            raise Exception('invalid title')
+        if not recipient:
+            raise Exception('invalid recipient')
+
+        # sender info.
+        # sender = consts.ADMIN_INIT_ACCOUNT_INFO.email
+        # sender_pw = consts.ADMIN_INIT_ACCOUNT_INFO.email_pw
+
+        # message
+        msg = MIMEMultipart()
+        msg['From'] = sender
+        msg['To'] = recipient
+        if cc_list:
+            list_cc = cc_list
+            str_cc = ','.join(list_cc)
+            msg['Cc'] = str_cc
+        msg['Subject'] = title
+
+        if contents_plain:
+            msg.attach(MIMEText(contents_plain, 'plain'))
+        if contents_html:
+            msg.attach(MIMEText(contents_html, 'html'))
+
+        # smtp server
+        smtp_server = smtplib.SMTP(host=smtp_host, port=smtp_port)
+        smtp_server.ehlo()
+        smtp_server.starttls()
+        smtp_server.ehlo()
+        smtp_server.login(sender, sender_pw)
+        smtp_server.send_message(msg)
+        smtp_server.quit()
+        return None
+    except Exception as e:
+        return str(e)
+
+
+def query_to_groupby(query_result, key, first=False):
+    """
+    쿼리 결과물(list)을 항목값(key)으로 그룹화한다.
+
+    :param query_result: 쿼리 결과 리스트
+    :param key: 그룹 항목값
+    :return: dict
+    """
+    group_info = dict()
+    for k, g in groupby(query_result, attrgetter(key)):
+        if k not in group_info:
+            if not first:
+                group_info[k] = list(g)
+            else:
+                group_info[k] = list(g)[0]
+        else:
+            if not first:
+                group_info[k].extend(list(g))
+    return group_info
+
+
+def query_to_groupby_date(query_result, key):
+    """
+    쿼리 결과물(list)을 항목값(key)으로 그룹화한다.
+
+    :param query_result: 쿼리 결과 리스트
+    :param key: 그룹 항목값
+    :return: dict
+    """
+    group_info = dict()
+    for k, g in groupby(query_result, attrgetter(key)):
+        day_str = k.strftime("%Y-%m-%d")
+        if day_str not in group_info:
+            group_info[day_str] = list(g)
+        else:
+            group_info[day_str].extend(list(g))
+    return group_info
+
+
+class FernetCrypto:
+    def __init__(self, key=FERNET_SECRET_KEY):
+        self.key = key
+        self.f = Fernet(self.key)
+
+    def encrypt(self, data, is_out_string=True):
+        if isinstance(data, bytes):
+            ou = self.f.encrypt(data)  # 바이트형태이면 바로 암호화
+        else:
+            ou = self.f.encrypt(data.encode('utf-8'))  # 인코딩 후 암호화
+        if is_out_string is True:
+            return ou.decode('utf-8')  # 출력이 문자열이면 디코딩 후 반환
+        else:
+            return ou
+
+    def decrypt(self, data, is_out_string=True):
+        if isinstance(data, bytes):
+            ou = self.f.decrypt(data)  # 바이트형태이면 바로 복호화
+        else:
+            ou = self.f.decrypt(data.encode('utf-8'))  # 인코딩 후 복호화
+        if is_out_string is True:
+            return ou.decode('utf-8')  # 출력이 문자열이면 디코딩 후 반환
+        else:
+            return ou
+
+
+class AESCryptoCBC:
+    def __init__(self, key=AES_CBC_PUBLIC_KEY, iv=AES_CBC_IV):
+        # Initial vector를 0으로 초기화하여 16바이트 할당함
+        # iv = chr(0) * 16 #pycrypto 기준
+        # iv = bytes([0x00] * 16) #pycryptodomex 기준
+        # aes cbc 생성
+        self.key = key
+        self.iv = iv
+        self.crypto = AES.new(self.key, AES.MODE_CBC, self.iv)
+
+    def encrypt(self, data):
+        # 암호화 message는 16의 배수여야 한다.
+        # enc = self.crypto.encrypt(data)
+        # return enc
+        enc = self.crypto.encrypt(pad(data, AES.block_size))
+        return b64encode(enc)
+
+    def decrypt(self, enc):
+        # 복호화 enc는 16의 배수여야 한다.
+        # dec = self.crypto.decrypt(enc)
+        # return dec
+        enc = b64decode(enc)
+        dec = self.crypto.decrypt(enc)
+        return unpad(dec, AES.block_size)
+
+
+class AESCipher:
+    def __init__(self, key):
+        # self.key = md5(key.encode('utf8')).digest()
+        self.key = bytes(key.encode('utf-8'))
+
+    def encrypt(self, data):
+        # iv = get_random_bytes(AES.block_size)
+        iv = bytes('daooldns12345678'.encode('utf-8'))
+
+        self.cipher = AES.new(self.key, AES.MODE_CBC, iv)
+        t = b64encode(self.cipher.encrypt(pad(data.encode('utf-8'), AES.block_size)))
+        return b64encode(iv + self.cipher.encrypt(pad(data.encode('utf-8'), AES.block_size)))
+
+    def decrypt(self, data):
+        raw = b64decode(data)
+        self.cipher = AES.new(self.key, AES.MODE_CBC, raw[:AES.block_size])
+        return unpad(self.cipher.decrypt(raw[AES.block_size:]), AES.block_size)
+    
+def cls_list_to_dict_list(list):
+    """
+    list 내부 element가 dict로 변환 가능한 class일경우 
+    내부 element를 dict 로 변경
+    """
+    _result = []
+    for i in list:
+        if isinstance(i, dict):
+            _result = list
+            break
+
+        _result.append(i.dict())
+    return _result
--- a/rest/app/utils/logger.py
+++ b/rest/app/utils/logger.py
@@ -0,0 +1,65 @@
+# -*- coding: utf-8 -*-
+"""
+@File: logger.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: logger
+"""
+
+import json
+import logging
+from datetime import timedelta, datetime
+from time import time
+from fastapi.requests import Request
+from fastapi import Body
+from fastapi.logger import logger
+
+logger.setLevel(logging.INFO)
+
+
+async def api_logger(request: Request, response=None, error=None):
+    time_format = '%Y/%m/%d %H:%M:%S'
+    t = time() - request.state.start
+    status_code = error.status_code if error else response.status_code
+    error_log = None
+    user = request.state.user
+    if error:
+        if request.state.inspect:
+            frame = request.state.inspect
+            error_file = frame.f_code.co_filename
+            error_func = frame.f_code.co_name
+            error_line = frame.f_lineno
+        else:
+            error_func = error_file = error_line = 'UNKNOWN'
+
+        error_log = dict(
+            errorFunc=error_func,
+            location='{} line in {}'.format(str(error_line), error_file),
+            raised=str(error.__class__.__name__),
+            msg=str(error.ex),
+        )
+
+    account = user.account.split('@') if user and user.account else None
+    user_log = dict(
+        client=request.state.ip,
+        user=user.id if user and user.id else None,
+        account='**' + account[0][2:-1] + '*@' + account[1] if user and user.account else None,
+    )
+
+    log_dict = dict(
+        url=request.url.hostname + request.url.path,
+        method=str(request.method),
+        statusCode=status_code,
+        errorDetail=error_log,
+        client=user_log,
+        processedTime=str(round(t * 1000, 5)) + 'ms',
+        datetimeUTC=datetime.utcnow().strftime(time_format),
+        datetimeKST=(datetime.utcnow() + timedelta(hours=9)).strftime(time_format),
+    )
+    if error and error.status_code >= 500:
+        logger.error(json.dumps(log_dict))
+    else:
+        logger.info(json.dumps(log_dict))
--- a/rest/app/utils/query_utils.py
+++ b/rest/app/utils/query_utils.py
@@ -0,0 +1,22 @@
+# -*- coding: utf-8 -*-
+"""
+@File: query_utils.py
+@Date: 2020-09-14
+@author: A2TEC
+@section MODIFYINFO 수정정보
+- 수정자/수정일   : 수정내역
+- 2022-01-14/hsj100@a2tec.co.kr : refactoring
+@brief: query-utility functions
+"""
+
+from typing import List
+
+
+def to_dict(model, *args, exclude: List = None):
+    q_dict = {}
+    for c in model.__table__.columns:
+        if not args or c.name in args:
+            if not exclude or c.name not in exclude:
+                q_dict[c.name] = getattr(model, c.name)
+
+    return q_dict