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

문서 개요

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

 

1. 프로젝트 배경

본 프로젝트는 고시원의 운영 상태를 효율적으로 관리하기 위한 웹 기반 프로그램을 만드는 것을 목표로 한다. 현재 운영자는 사장님, 원장님, 총무님으로 구성되어 있으며, 주요 관리 대상은 다음과 같다.

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

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

 

2. 사용자 정의

각 사용자에 대한 정의는 이 프로그램을 쓰는 목적에 대한 것을 간단하게 기술한다. 대체적으로 고시원을 관리하시는 분은 사장님이다.

 

2.1 사장님

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

 

2.2 원장님

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

 

2.3 총무님

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

 

3. 핵심 화면 목록

1. 대시보드(도면 기반)
2. 입실자 관리
3. 연간 캘린더

 

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.7 수치 데이터
  • 사용자는 총 방 개수, 총 입실자 수, 현재 공실, 유지보수를 볼 수 있다. 각 버튼을 누르면 어떤 입실자가 포함되어 있는지 확인할 수 있다.

 

표시 데이터

• 도면 → 방 번호, (공실 / 입실 중 / 유지보수)의 방 상태
• 도면 상세 화면 → 방 번호, 홈페이지 도면 사진, 홈페이지 비품, 입실자 이름, 입실자 성별, 방 유형, 기준 가격(6개월 기준 치), 입실일, 퇴실일, 입실자 나이, 입실자가 내는 월세 비용

 

논의 사항

1. 주요 기능 4.1.1 입니다.

• 원장님
  • 도면은 실제 도면 원본을 최대한 반영하는 방향 검토

2. 주요기능 4.1.5 입니다.

• 원장님
  • 각 방의 상세 화면에서의 입실자에 대한 입실자 관리 페이지에 있는 납부 이력 데이터를 도면 상세에도 볼 수 있다.

3. 주요 기능 4.1.6 입니다.

• 사장님
  • 상세 정보 영역을 더 크게 볼 수 있다. 도면의 크기 비율을 낮추고 상세 정보를 더 크게 볼 수 있다.
• 원장님
  • 확대 축소를 각각 할 수 있게 하여 도면이 커지면 상세 화면은 작아지고 도면이 작아지면 상세 화면이 커지는 형태

4. 주요 기능 4.1.7입니다.

• 원장님
  • 각 카드를 누르면 이에 해당하는 입실자가 누구 있는지 확인할 수 있다.

 

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

• 4.1.1 1층~6층 도면 표시 → 구현 완료
• 4.1.2 공실 / 입실중 / 유지보수 상태 표시 → 구현 완료
• 4.1.3 방 클릭 시 상세 정보 표시 → 일부 논의 중
• 4.1.4 신규 입실자 등록 연결 → 구현 완료
• 4.1.5 납부 이력 일부 표시 가능 → 일부 논의중
• 4.1.6 확대 / 축소 기능 → 일부 논의중
• 4.1.7 수치 데이터 → 일부 구현 완료

 

4.2 입실자 관리

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

 

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

• 4.2.1 입실자 목록 조회
  • 사용자는 기준 월 단위로 호실 / 입실자, 성별, 나이, 입실일, 퇴실일, 월세, 납부 대상 월일, 월세 납부일, 상태, 납부 이력 상태를 조회한다. 각 데이터에 대한 값(필요한 것만 선별)은 다음과 같다.
    • 월세 → 각 방에 대한 6개월 단위로 된 원래 가격
    • 납부 대상 월일 → 매월 3일 이런 형태
    • 월세 납부일 → 입실자의 월세 납부일 “2026-03-03” 이런 형태
    • 상태 → 납부 완료 / 납부 예정 / 미납
• 4.2.2 납부 이력 조회
  • 사용자는 입실자 목록 조회의 컬럼에 있는 납부 상태 조회 컬럼에서 “이력 보기” 버튼을 클릭한다. 납부 상태 페이지에서는 다음과 같은 데이터를 볼 수 있다.
    • 월세 → 각 방에 대한 6개월 단위로 된 원래 가격
    • 입실일
    • 퇴실일
    • 납부 현황 차트 → 사용자가 입실한 순간 부터 현재 시점까지 월마다 낸 월세를 볼 수 있으며 상태는 납부 완료 / 미납/ 납부 예정
    • 월별 납부 내역 → 사용자가 입실한 순간 부터 현재 시점까지 월마다 낸 월세를 볼 수 있으며 리스트 형태로 볼 수 있다.
• 4.2.3 상태 수정
  • 사용자는 입실자 목록 조회의 컬럼에 있는 수정 컬럼에서 “납부 수정” 버튼을 클릭하여 입실자에 대한 납부 이력을 수정할 수 있다. 상태를 수정하는 데이터는 다음과 같다.
    • 납부 상태 → 납부 완료 / 미납/ 납부 예정
    • 실제 납부일 → 년, 월, 일을 선택
    • 월세 금액(원) → 입실자가 낸 월세
• 4.2.4 수치 데이터
  • 사용자는 총 방 개수, 총 관리 입실자, 이번달 납부 완료, 확인 필요한 미납을 볼 수 있다. 각 버튼을 누르면 어떤 입실자가 포함되어 있는지 확인할 수 있다.

 

표시 데이터

• 호실 / 입실자, 성별, 나이, 입실일, 퇴실일, 월세, 납부 대상 월일, 월세 납부일, 상태, 납부 이력 상태
  • 월세 → 각 방에 대한 6개월 단위로 된 원래 가격
  • 납부 이력
    • 월세 → 각 방에 대한 6개월 단위로 된 원래 가격
    • 입실일
    • 퇴실일
    • 납부 현황 차트 → 사용자가 입실한 순간 부터 현재 시점까지 월마다 낸 월세를 볼 수 있으며 상태는 납부 완료 / 미납/ 납부 예정
    • 월별 납부 내역 → 사용자가 입실한 순간 부터 현재 시점까지 월마다 낸 월세를 볼 수 있으며 리스트 형태로 볼 수 있다.

 

논의 사항

1. 주요 기능 4.2.4입니다.

• 원장님
  • 각 카드를 누르면 이에 해당하는 입실자가 누구 있는지 확인할 수 있다.

 

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

• 4.2.1 입실자 목록 조회→ 구현 완료
• 4.2.2 납부 이력 조회 → 구현 완료
• 4.2.3 상태 수정→ 구현 완료
• 4.2.4 수치 데이터 → 일부 논의 중

 

4.3 연간 캘린더

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

 

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

• 4.3.1 호실별 막대 그래프 표시
  • 사용자는 막대 그래프로 나타난 바 위에 입실자의 정보인 이름, 호실, 월세 값, 입실일, 퇴실일을 볼 수 있다.
    • 월세 값 → 입실자가 낸 돈이 아닌 방의 금액
• 4.3.2 층별 필터링

 

표시 데이터

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

 

논의 사항

1. 주요 기능의 4.3.1 호실별 막대 그래프 표시
   • 사장님
     • 6개월 단위로 옆 페이지로 넘기는 형태로 한 화면에 보여지는 형태
     • 막대 그래프 안의 텍스트는 다음과 같다.
       • 월세가격 → 70만 or 70 이런 형태로 보여주는 것
     • 막대 그래프를 누르면 각 방의 상세 페이지가 뜬다. 뜨면 도면 또는 상세 정보가 보이는 형태
     • 보증금 차감 내역 → 모든 페이지에 들어갈 것 같습니다.
       • 보통 입실자는 보증금 300만 원을 내는데, 퇴실 시 문제가 생기면 여기서 차감이 일어날 수 있다. 이 차감은 단순히 방값 때문일 수도 있지만, 하자와 관련된 비용 차감일 수도 있다.
       • 즉, 퇴실 처리에서는 단순 종료가 아니라 보증금에서 어떤 사유로 얼마가 차감되었는지가 함께 관리되어야 한다.
     • 월세 미납금(검토)
       • 막대 그래프 안이나 상세 정보에서 미납금도 함께 볼 수 있으면 좋겠다.
     • 공과금 → 모든 페이지에 들어갈 것 같습니다.
       • 도시가스→ 도시가스는 상대적으로 실시간 정산이 가능하지만,
       • 전기요금 → 전기요금은 그렇지 않다고 하셨다. 한전에서 검침을 하고 나서 고지서가 나오기 때문에, 실제 입퇴실 날짜와 검침 시점이 어긋날 수 있다.
       • 즉, 현금 승계 내용이 막대 그래프 쪽에 들어가거나, 혹은 도면 상세 정보 쪽에 들어가면 좋겠다고 해주셨음.
     • 예정 입실 정보 → 모든 페이지에 들어갈 것 같습니다.
       • 예를 들어 오늘이 3월 24일인데, 26일부터 살 사람이 이미 정해져 있다. 그런데 다른 사람이 27일부터 오겠다고 문의하는 상황도 생길 수 있다. 이런 경우 단순히 현재 공실인지 아닌지만 보는 것으로는 부족하고, 앞으로 예정된 입실 일정까지 상세 내역에서 보여줄 수 있어야 한다
   • 원장님
     • 스크롤 방식을 사용해서 한 화면에 최대 2년치를 보여주며 전체 화면에서 2년치를 다 보여주다가 확대하면 6개월 치 3개월치 이렇게 보여주는 형태
     • 연간 캘린더에서 납부 이력 데이터도 보이는 형태