[외주] 고시원 관리 프로그램 요구사항 명세서 - v0.2

문서 개요

• 문서명 : 고시원 관리 프로그램 요구사항 명세서
• 작성일 : 2026년 3월 26일
• 작성자 : 정재윤
• 프로젝트 목적 : 고시원의 입실 현황, 장부, 연간 캘린더, 방 상세 정보 등을 관리할 수 있는 웹 기반 운영 도구를 개발하기 위한 요구사항 정리
• 현재 버전 : v0.2

 

1. 프로젝트 배경

본 프로젝트는 고시원의 운영 상태를 효율적으로 관리하기 위한 웹 기반 프로그램을 만드는 것을 목표로 한다.

현재 운영자는 사장님, 원장님, 총무님으로 구성되어 있으며, 주요 관리 대상은 다음과 같다.

• 현재 어느 방에 누가 거주 중인지
• 입실 시작일 / 종료일
• 월세 납부 여부 및 납부 이력
• 공실 여부
• 연간 입실 현황
• 방 상세 정보 및 유지보수 정보

또한 본 프로그램은 고정된 PC가 아니라 태블릿 중심으로 사용되는 것을 우선 고려한다.

 

2. 사용자 정의

각 사용자에 대한 정의는 이 프로그램을 쓰는 목적에 대한 것을 간단하게 기술한다.

 

대체적으로 고시원을 관리하시는 분은 사장님이다.

 

2.1 사장님

• 전체 운영 현황 확인
• 연간 캘린더 확인
• 방 상세 정보 확인
• 장부 리스트 관리
• 정산, 미납, 승계 정보 확인
• 신규 입실자 등록
• 방 상태 및 상세 정보 확인

 

2.2 원장님

• 전체 운영 현황 확인
• 도면 기반 입실 현황 확인

 

2.3 총무님

• 방 정보 입력
• 비품/소모품/유지보수 정보 관리
• 입실자 관련 기초 데이터 관리

 

3. 핵심 화면 목록

1. 대시보드(도면 기반)
2. 입실자 관리
3. 연간 캘린더
4. Todo List(MainPage)
5. 통계 그래프

 

4. 화면 별 요구사항

4.1 대시보드(도면 기반)

• 목적 → 고시원 전체 방 상태를 한눈에 확인한다.

 

주요 기능(기본 요구사항 - 논의 사항이 여기에 추가적으로 입력된다.)

• 4.1.1 1층~6층 도면 표시
  • 사용자는 고시원의 형태를 1층 부터 6층까지 도면형태로 확인할 수 있다.
• 4.1.2 공실 / 입실중 / 계약상태 상태 표시
  • 사용자는 고시원의 형태의 도면에서 방 상태의 공실 / 입실 중/ 계약상태 상태를 볼 수 있다.
• 4.1.3 방 클릭 시 상세 정보 표시
  • 사용자는 고시원의 형태의 도면에서 방 클릭시 상세 정보를 볼 수 있다.
  • 사용자는 입실자 관리에 등록된 데이터를 전부 볼 수 있다.
• 4.1.4 신규 입실자 등록 연결
  • 사용자는 고시원의 형태의 도면에서 방 상태의 공실인 부분에서 상세 정보를 클릭 후 “신규 입실자 등록” 버튼을 통해 입실자를 등록할 수 있다.
• 4.1.5 확대 / 축소 기능
  • 사용자는 고시원의 형태 도면 및 방의 상세 정보를 확대 축소를 해서 각 다르게 볼 수 있다.
• 4.1.6 수치 데이터
  • 사용자는 총 방 개수, 총 입실자 수, 현재 공실, 유지보수를 볼 수 있다. 각 버튼을 누르면 어떤 입실자가 포함되어 있는지 확인할 수 있다.

 

논의 사항

• 없음

 

개발 상태(구현 완료/ 일부 구현 완료 / 일부 논의중 / 구현 필요)

• 4.1.1 1층~6층 도면 표시 → 일부 구현 완료
  • 그린 형태가 아니라 실제 도면이 들어가는 형태
• 4.1.2 공실 / 입실중 / 계약상태 상태 표시 → 일부 구현 완료
  • 유지보수를 계약 상태로 바꿔야함.
• 4.1.3 방 클릭 시 상세 정보 표시 → 일부 논의 중
  • 입실자 관리 데이터 전부 들고 오는 것 필요
• 4.1.4 신규 입실자 등록 연결 → 구현 완료
• 4.1.5 확대 / 축소 기능 → 구현 필요
• 4.1.6 수치 데이터 → 일부 구현 완료
  • 카드를 눌러서 해당된 데이터 볼 수 있는 기능 개발 필요

 

4.2 입실자 관리

• 목적 → 입실자와 월세 납부 상태를 표 형태로 관리한다.

 

주요 기능(기본 요구사항 - 논의 사항이 여기에 추가적으로 입력된다.)

• 4.2.1 입실자 목록 조회
  • 사용자는 표 형태에서 호실, 이름, 연락처, {상세 보기 버튼}을 볼 수 있다.
  • 사용자는 각 컬럼에 대해 다른 색깔로 볼 수 있다.
  • 사용자는 입실자에 대한 예정 입실 정보 버튼
    • 이 버튼을 누르면 오늘이 3월 24일인데, 26일부터 살 사람이 이미 정해져 있다. 그런데 다른 사람이 27일부터 오겠다고 문의하는 상황도 생길 수 있다. 이런 경우 단순히 현재 공실인지 아닌지만 보는 것으로는 부족하고, 앞으로 예정된 입실 일정까지 상세 내역에서 보여줄 수 있어야 한다
  • 사용자는 {방 관리} 버튼을 통해 다음과 같은 화면을 볼 수 있다.
    • 년도 월 일 → 26/03/24
    • 금액
    • 방에 대한 관리 상세 → 도배, 매트리스교체, 에어컨청소, 전구교체
• 4.2.2 입실자 상세 조회
  • 사용자는 입실자 목록 조회의 {상세 보기 버튼}을 누르면 다음과 같은 데이터를 볼 수 있다.
  • 사용자는 다음과 같은 데이터를 표 형태로 볼 수 있다.
    • 호실 → 101
    • 입실자 이름 → 정재윤
    • 연락처 → 010-0000-0000
    • 호실(방 유형) → Cozy, Standard A-1, Standard A-1 +, Standard A-2, Standard A-2 +, Standard A-2 (넓은 사이즈), Standard A-3, Standard B-1, Standard B-2, Deluxe A, Deluxe B
    • 금액(관포) → 70
    • 입실일 → 26/03/13
    • 퇴실일 → 26/03/13
    • 계약 만료일 → 26/03/13
    • 거주 목적 → 공시생(임용,일행,소방,경찰 등), 세무,회계,계리, 취준생, 수능, 직장
    • 실제 납부해야할 월세 → 70
    • 납부 대상 월일 → 매월 10일
    • 계약금 → 26/03/14 200,000
    • 부동산 → 부동산 여러 개 중 선택 == 이름은 기입하지 않겠다.
  • 사용자는 보증금 관리 이력에서 다음과 같은 내역을 볼 수 있다.
    • 잔여 보증금 내역
    • 차감 이행된 날짜
    • 차감 보증금 금액
    • 차감된 이유 → 차임, 미납, 공과금정산, 도배, 타일, 시설손상
  • 사용자는 입실자의 월세 납부 관리 및 내역을 볼 수 있다.
    • 납부한 날짜 → 26/03/16
    • 납부한 금액
    • 결제 방식 → 이체(자진 발급) or 이체 or 현금
    • 월별 납부 내역 → 사용자가 입실한 순간 부터 현재 시점까지 월마다 낸 월세를 볼 수 있으며 리스트 형태로 볼 수 있다.
    • 여기에 추가로 납부 상태인 미납, 납우 완료 상태를 볼 수 있다. 매월 3일로 예를 든다면 3일이 지나면 미납으로 자동 처리 되고 3월에 값을 넣으면 자동으로 납부 완료 처리가 된다.
  • 사용자는 공과금 처리에 대한 걸 볼 수 있다.
    • 2가지로 나뉜다.
      • 도시가스 → 사용자가 월마다 납부한 도시가스 알 수 있으며, 직접 등록 및 수정할 수 있다.
      • 한전 → 현금 승계 부분을 처리하기 위해 사용자의 퇴실일과 실제 퇴실일자의 값이 있고 그 사이에 쓴 한전값을 넣을 수 있다. 다음 입실자에게는 그 만큼 뺀 가격이 들어간다.
• 4.2.3 수치 데이터
  • 사용자는 총 방 개수, 총 관리 입실자, 이번달 납부 완료, 확인 필요한 미납을 볼 수 있다. 각 버튼을 누르면 어떤 입실자가 포함되어 있는지 확인할 수 있다.

 

논의 사항

• 없음

 

개발 상태(구현 완료/ 일부 구현 완료 / 일부 논의중 / 구현 필요)

• 4.2.1 입실자 목록 조회→ 일부 구현 완료
  • 사용자는 각 컬럼에 대해 다른 색깔로 볼 수 있는 기능 필요
  • 예정 입실 정보
• 4.2.2 입실자 상세 조회 → 구현 필요
  • 전부 다 개발 필요
• 4.2.3 수치 데이터 → 일부 구현 완료
  • 카드를 눌러서 해당된 데이터 볼 수 있는 기능 개발 필요

 

4.3 연간 캘린더

목적 → 시간 축 기준으로 각 호실의 입실 현황을 시각적으로 확인한다.

 

주요 기능(기본 요구사항 - 논의 사항이 여기에 추가적으로 입력된다.)

• 4.3.1 호실별 막대 그래프 표시
  • 사용자는 막대 그래프로 나타난 바 위에 입실자의 정보인 이름, 호실, 월세 값, 입실일, 퇴실일을 볼 수 있다.
• 4.3.2 막대 그래프에서의 상세 정보
  • 사용자는 하나의 막대 그래프를 클릭시 해당 데이터의 상세 정보에서 입실자 관리에 해당하는 모든 데이터를 볼 수 있다.
• 4.3.3 층별 필터링

 

표시 데이터

• 방 번호
• 입실자 이름
• 월세 값(예: 70, 75)
• 입실일
• 퇴실일

 

논의 사항

• 없음

 

개발 상태(구현 완료/ 일부 구현 완료 / 일부 논의중 / 구현 필요)

• 4.3.1 호실별 막대 그래프 표시 → 일부 구현 완료
  • 사용자는 각 컬럼에 대해 다른 색깔로 볼 수 있는 기능 필요
  • 월세 값(예: 70, 75) 으로 보이는 형태 기능 필요
  • 모든 연도를 볼 수 있는 스크롤 형태로 진행 == 모든 데이터 보여야함
• 4.3.2 막대 그래프에서의 상세 정보 → 구현 필요
  • 입실자 관리에서 보여주는 데이터 모두 필요
• 4.3.3 층별 필터링 → 구현 완료

 

4.4 Todo List(MainPage)

• 목적 → 총무님들이 해야할 일들을 원장님과 사장님과 공유한다.

 

주요 기능(기본 요구사항 - 논의 사항이 여기에 추가적으로 입력된다.)

• 4.4.1 todoList 조회
  • 사용자는 달마다 캘린더 형태로 조회할 수 있다.
  • 사용자는 안에 캘린더에는 해야할일을 볼 수 있다
• 4.4.2 todoList 입력
  • 사용자는 todoList를 입력할 수 있다.

 

논의 사항

• 없음

 

개발 상태(구현 완료/ 일부 구현 완료 / 일부 논의중 / 구현 필요)

• 4.4.1 todoList 조회 → 구현 필요
• 4.4.2 todoList 입력 → 구현 필요

 

4.5 통계 그래프

• 목적 → 사장님이 이 고시원에 대한 전체 통계 그래프

 

주요 기능(기본 요구사항 - 논의 사항이 여기에 추가적으로 입력된다.)

• 미정

 

논의 사항

• 없음

 

개발 상태(구현 완료/ 일부 구현 완료 / 일부 논의중 / 구현 필요)