Micasa: 터미널에서 주택 유지보수를 통합 관리하는 오픈소스 도구

주택 유지보수 일정, 가전 보증 기간, 공사 견적서, 종이 영수증까지 흩어져 관리되고 있지는 않으신가요? Micasa는 이러한 문제를 해결하기 위해 만들어진 터미널 기반 오픈소스 애플리케이션입니다. 집과 관련된 모든 정보를 하나의 SQLite 파일로 통합하고, 키보드 중심의 인터페이스로 빠르게 탐색·관리할 수 있도록 설계되었습니다.

이 글에서는 Micasa의 개념과 개발 배경, 주요 기능, 데이터 관리 방식, 설치 및 실행 방법, 그리고 인터페이스 특징까지 체계적으로 정리합니다.

반응형

---

Micasa란 무엇인가

Micasa는 주택 유지보수와 프로젝트, 가전 관리, 견적 비교, 사고 기록 등을 한 곳에서 관리할 수 있도록 설계된 터미널 기반 애플리케이션입니다.

모든 데이터는 단일 SQLite 파일에 저장되며, 정비 일정이나 보증 상태 같은 정보는 자동 계산되어 표시됩니다. 종이 영수증이나 메모 대신, 구조화된 데이터 기반으로 집을 관리할 수 있는 환경을 제공합니다.

개발 배경

Micasa는 다음과 같은 문제의식에서 출발했습니다.

• 상자에 쌓인 영수증
• 열어보지 않는 서류 바인더
• 냉장고에 붙은 메모지

이처럼 분산된 정보 관리 방식의 비효율을 줄이고, 모든 주택 관련 정보를 터미널과 하나의 데이터베이스로 통합하기 위해 개발되었습니다.

또한 VisiData에서 영감을 받은 모달 기반, 키보드 중심 인터페이스를 채택해 생산성을 높였습니다.

---

주요 기능

Micasa는 단순한 메모 도구가 아니라, 주택 관리 전반을 체계적으로 다루는 기능을 제공합니다.

1. 유지보수 관리

• 필터 교체 시점 등 정비 일정을 자동 계산
• 전체 서비스 이력 기록 및 추적
• 보증 상태 자동 표시

예를 들어, 에어컨 필터 교체 주기를 등록하면 다음 교체 예정일을 자동으로 계산해 보여줍니다. 사용자는 주기 계산을 직접 할 필요가 없습니다.

---

2. 프로젝트 추적

• 초기 구상 단계부터 완료 또는 중단까지 상태 관리
• 진행 단계별 이력 기록

주방 리모델링과 같은 프로젝트를 생성하고, 현재 상태를 추적하며 관련 문서와 비용을 함께 관리할 수 있습니다.

---

3. 견적 비교

• 여러 업체의 견적을 나란히 비교
• 업체 이력과 비용 계산 정보 제공

단순히 금액만 비교하는 것이 아니라, 과거 거래 이력과 연계해 보다 합리적인 의사결정을 지원합니다.

---

4. 가전 추적

• 구매일 관리
• 보증 상태 확인
• 유지보수 이력 연결

각 가전 항목에 관련 유지보수 기록과 문서를 연결할 수 있어, 제품 수명주기 전체를 관리할 수 있습니다.

---

5. 사고 기록

• 누수 등 사건을 심각도와 위치 기준으로 기록
• 관련 가전 및 업체와 연동

예를 들어 누수 사고를 기록하면, 해당 위치와 관련 설비, 수리 업체 정보를 함께 연결해 관리할 수 있습니다.

---

데이터 및 파일 관리 구조

단일 SQLite 파일 구조

모든 데이터는 단일 SQLite 파일에 저장됩니다.

• 백업이 간단
• 데이터 이동 및 복원이 용이
• 별도의 서버 구성 불필요

파일 하나만 보관하면 전체 데이터가 유지되므로 개인 환경에서 관리하기 적합합니다.

파일 첨부 기능

• 매뉴얼
• 영수증
• 사진
• 계약서 등

이러한 파일을 프로젝트나 가전에 직접 연결할 수 있어 데이터와 문서가 분리되지 않습니다.

---

설치 및 실행 방법

Micasa는 Linux, macOS, Windows용 바이너리를 제공합니다. Go 환경에서도 직접 설치할 수 있습니다.

1. Go를 통한 설치

Go(1.25+) 환경에서 아래 명령으로 설치할 수 있습니다.

go install github.com/cpcloud/micasa/cmd/micasa@latest

---

2. 바이너리 다운로드

GitHub의 최신 릴리스에서 운영체제에 맞는 바이너리를 다운로드하여 사용할 수 있습니다.

---

3. 실행 예제

샘플 데이터 체험:

micasa --demo

새 데이터베이스 생성:

micasa

데이터베이스 위치 확인:

micasa --print-path

처음 사용하는 경우 --demo 옵션을 통해 전체 기능 흐름을 체험한 뒤, 실제 데이터베이스를 생성하는 방식이 효율적입니다.

---

인터페이스와 조작 방식

Micasa는 Vim 스타일 모드 기반 인터페이스를 채택했습니다.

지원 기능:

• 탐색(nav) 모드
• 편집(edit) 모드
• 정렬 기능
• 퍼지 검색
• 열 숨김
• 관련 레코드 탐색

마우스 중심이 아닌 키보드 중심 설계로, 반복 작업에서 높은 생산성을 기대할 수 있습니다.

전체 키 바인딩 목록은 공식 문서의 keybinding reference에서 확인할 수 있습니다.

---

Micasa의 기술적 특징 요약

• 터미널 기반 오픈소스 애플리케이션
• 단일 SQLite 파일 구조
• 자동 일정 계산 및 상태 표시
• 객체 간 연동 구조(가전–프로젝트–업체–사고)
• 모달 기반 키보드 중심 UI
• 크로스 플랫폼 지원

---

728x90

Micasa는 단순한 메모 도구가 아니라, 주택 관리의 전 과정을 데이터 중심으로 구조화하는 도구입니다.

종이 영수증과 흩어진 메모, 기억에 의존한 유지보수 관리에서 벗어나 하나의 SQLite 파일과 터미널 환경으로 통합 관리할 수 있다는 점이 가장 큰 특징입니다.

특히 키보드 중심 인터페이스와 객체 간 연결 구조는 단순 기록을 넘어 ‘관계 기반 데이터 관리’에 가깝습니다.

앞으로 개인 인프라 관리 영역에서도 이처럼 경량 데이터베이스 기반, 터미널 중심 관리 도구의 활용 가능성은 더욱 확대될 것으로 기대됩니다.

300x250

https://micasa.dev/

micasa — your house, in a terminal