시설 전체 이용인원

통계 > 운영통계 > 시설 전체 이용인원

1. 기능 개요

지정된 기간(년월) 동안 시설의 전체 이용 인원을 유형별(청소년활동, 평생교육 등)과 연령대별(유아, 청소년, 성인 등)로 집계하여 트리 그리드 형태로 조회하는 기능입니다.

2. 주요 기능 목록

기간 선택 및 조회: 캘린더 툴바를 통해 시작일과 종료일을 선택하여 데이터 조회

데이터 시각화: DHX TreeGrid를 사용하여 계층적 구조로 이용 인원 통계 표시

자동 초기화: 페이지 로드 시 초기 레이아웃 설정 및 기본 데이터 조회 실행

일시 변경 감지: 날짜 선택 시 자동으로 onSelect 함수를 호출하여 데이터 갱신

3. 비즈니스 규칙

조회 조건: startDate와 endDate는 'YYYYMMDD' 형식의 문자열로 변환되어 서버로 전송됨

데이터 구조: 조회 결과는 계층적 트리 구조를 가지며, 초기에는 모든 노드가 축소(collapsed: true)된 상태로 표시됨

소스 기관 코드: 현재 로그인한 사용자의 기관 코드(instCd)를 세션에서 추출하여 조회 조건으로 사용

에러 처리: AJAX 요청 실패 시 별도의 에러 처리 로직 없이 silently fail됨

4. 연관 테이블

DB 쿼리 ID: stsMngDAO.selectFacilityUserStatus

주요 조회 필드: 구분(reqYm), 전체 이용 인원, 청소년활동(유아/청소년/성인), 평생교육(유아/청소년/성인), 일반대관(청소년/일반), 청소년전용공간(청소년/일반), 이용권(전체)

참고: 실제 테이블명은 소스 코드에 명시되지 않았으나, stsMngDAO를 통해 접근하는 시설 이용 통계 관련 테이블로 추정됨

5. 접근 권한

로그인 사용자 전체 (세션에서 loginVO를 참조하므로 로그인 상태 필수)

대관 이용인원

통계 > 운영통계 > 대관 이용인원

1. 기능 개요

지정된 기간(년월) 동안의 대관 신청 건수를 상태별(접수완료, 승인대기, 결제대기, 반려, 취소) 및 유형별(일반, 청소년)로 집계하여 트리 그리드 형태로 시각화하여 제공합니다.

2. 주요 기능 목록

조회 조건 설정: 연도/월(yyyymm) 단위로 조회 기간을 선택할 수 있는 캘린더 툴바 제공

데이터 조회: 선택된 기간의 대관 이용 인원 통계를 서버로 요청하여 화면에 표시

통계 항목 표시:

- 구분(대분류)
- 접수완료 (전체, 일반, 청소년)
- 승인대기 (일반, 청소년)
- 결제대기 (일반, 청소년)
- 반려 (일반, 청소년)
- 취소 (일반, 청소년)

트리 그리드 제어: 데이터 로드 후 모든 노드가 접힌 상태(collapsed)로 초기화

3. 비즈니스 규칙

조회 단위: 통계는 '년월(YYYYMM)' 단위로 집계되어 조회됨

데이터 소스: /admin/common/selectDataList.do 엔드포인트를 통해 stsMngDAO.selectRentalStatus 쿼리 ID를 사용하여 데이터 조회

필수 파라미터:

- instCd: 현재 로그인한 사용자의 기관 코드 (세션에서 추출)
- startDate, endDate: 캘린더에서 선택된 날짜 범위 (날짜 형식에서 하이픈 제거 후 전송)

출력 형식: 숫자 값은 천 단위 콤마(#,##) 형식으로 포맷팅되어 표시됨

기본 동작: 데이터 조회 성공 시 트리 그리드의 모든 항목이 접힌 상태(collapseAll)로 설정됨

4. 연관 테이블

DB 테이블: 코드상 직접적인 테이블명은 명시되지 않으나, stsMngDAO.selectRentalStatus 쿼리를 통해 대관 신청 현황 테이블(또는 뷰)에서 데이터를 조회함.

세션 변수: sessionScope.loginVO.instCd를 사용하여 기관별 데이터 필터링 수행

5. 접근 권한

로그인 사용자 전체

- 코드상 별도의 권한 체크 로직(예: hasRole('ADMIN'))은 구현되어 있지 않으나, instCd가 세션에서 추출되므로 로그인한 사용자만 접근 가능함.

이용권

통계 > 운영통계 > 이용권

1. 기능 개요

선택한 기간(YYYYMM)을 기준으로 이용권 발급 현황을 계층형 트리 그리드(TreeGrid)로 조회하는 기능입니다. 수영 및 헬스 시설별 사용/미사용 통계를 집계하여 시각적으로 제공합니다.

2. 주요 기능 목록

조회 조건: 시작일(StartDate), 종료일(EndDate) 선택 (툴바에서 YYYYMM 형식 또는 날짜 선택 가능)

데이터 조회: AJAX 비동기 요청을 통해 서버에서 통계 데이터 fetching

데이터 시각화: dhtmlx TreeGrid 컴포넌트를 사용하여 계층 구조(구분별 합계 및 상세)로 데이터 표시

데이터 포맷팅: 숫자 컬럼에 천 단위 콤마(#,##) 포맷 적용

트리 제어: 데이터 로드 후 모든 노드가 접힌 상태(collapsed: true)로 초기화

3. 비즈니스 규칙

조회 기간: 툴바에서 선택한 날짜(stDate, edDate)를 기준으로 데이터 필터링. 날짜 문자열에서 하이픈(-)을 제거하여 서버로 전송.

데이터 구조: 응답 데이터(resultList)는 트리 그리드 구조에 맞게 계층화된 배열 형태여야 함.

초기화: 데이터 로드 성공 시 treeGrid.collapseAll() 호출하여 트리 노드를 기본 접힘 상태로 유지.

에러 처리: AJAX 요청 실패 시 별도의 에러 메시지 처리 로직은 구현되지 않음 (빈 함수).

4. 연관 테이블

DB DAO: stsMngDAO.selectTicketIssuanceStatus (통계 관리 DAO의 이용권 발급 현황 조회 메서드)

세션 변수: sessionScope.loginVO.instCd (현재 로그인한 기관 코드, 조회 필터링용)

5. 접근 권한

로그인 사용자 전체 (관리자 페이지 /admin/ 경로이므로 로그인된 관리자 권한 필요)