"층층 알리미" 어플 이용자 가이드

층층 알리미 - 이용자 가이드 

안녕하세요! 층층 알리미 앱을 사용해주셔서 감사합니다. 😊

층층 알리미는 여러 번 나눠 매수한 주식의 개별 매수가를 기준으로 수익률을 관리하고, 설정한 목표가에 도달하면 알림을 받아 매도 타이망을 잡는 데 도움을 주는 스마트한 투자 관리 앱입니다.

 

이 가이드를 통해 층층 알리미의 다양한 기능을 100% 활용해보세요!

 

1. 시작하기

1.1. 매수 종목 등록하기

• [투자 내역] 탭 (홈 화면) 우측 상단의 추가(+) 아이콘을 탭하세요.
• 매수 종목 등록 화면으로 이동합니다.
  • 매수 종목 선택: 검색창에 종목명 또는 종목 코드를 입력하여 검색 후, 목록에서 원하는 종목의 라디오 버튼을 선택합니다. (선택 시 키보드는 자동으로 내려갑니다.)
  • 매수 수량: 해당 종목을 매수한 수량을 입력합니다.
  • 매수 가격: 해당 종목을 매수한 주당 가격을 입력합니다.
  • 매수 일자: 달력 아이콘을 탭하여 실제 매수한 날짜를 선택합니다. (기본값: 오늘)
  • 한줄 메모 (선택): 매수 관련 메모를 자유롭게 남길 수 있습니다 (최대 50자).
  • [저장] 버튼을 탭하여 등록을 완료합니다.

 

2. 투자 내역 관리 (홈 화면)

2.1. 내역 확인 및 필터링

• [투자 내역] 탭에서는 등록한 모든 매수/매도 기록을 확인할 수 있습니다.
• 매수/매도 필터: 화면 상단의 [매수] / [매도] 라디오 버튼을 선택하여 원하는 거래 내역만 필터링하여 볼 수 있습니다. (기본값: 매수)
  • 매수: 아직 매도하지 않은 보유 내역만 표시됩니다.
  • 매도: 매도가 완료된 내역만 표시됩니다.
• 검색: 상단의 검색창에 종목명이나 코드를 입력하면 해당 내용이 포함된 내역만 실시간으로 필터링됩니다.

 

2.2. 정보 이해하기

각 항목에는 다음과 같은 정보가 표시됩니다.

• 종목명 (코드): 매수한 종목의 이름과 코드.
• 구분: 해당 기록이 '매수' 상태인지 '매도' 상태인지 표시됩니다.
• 현재가: 가장 최근에 업데이트된 해당 종목의 현재 가격.
• 매수가격: 사용자가 해당 건을 매수한 주당 가격.
• 수익률: 해당 매수가격 기준의 현재 평가 수익률(매수 상태) 또는 실현 수익률(매도 상태).
• 기준일: 현재가 및 수익률 계산의 기준이 되는 날짜 (화면 상단에 표시).

 

2.3. 정렬하기

• 목록 상단의 "종목명" 또는 "수익률" 텍스트를 탭하여 해당 기준으로 목록을 정렬할 수 있습니다.
• 같은 기준을 다시 탭하면 오름차순/내림차순 정렬 순서가 변경됩니다.
• 현재 정렬 기준과 방향은 해당 텍스트 옆의 화살표 아이콘(▲/▼) 색상으로 확인할 수 있습니다. (기본 상태는 아이콘 색상 없음)

 

2.4. 매도 처리하기 (매수 내역 클릭)

• [매수] 필터 상태에서 특정 항목을 짧게 클릭하면 해당 매수 건에 대한 매도 처리 화면으로 이동합니다. (자세한 내용은 아래 3번 참고)
• [매도] 필터 상태의 항목은 이미 매도 완료된 기록이므로 클릭해도 매도 처리 화면으로 이동하지 않습니다.

 

2.5. 내역 삭제하기 (롱클릭)

• 삭제하고 싶은 항목(매수/매도 무관)을 길게 누르면(롱클릭) "삭제 확인" 대화상자가 나타납니다.
• **[예]**를 누르면 해당 기록이 데이터베이스에서 영구적으로 삭제되고 목록이 갱신됩니다.
• **[아니오]**를 누르면 삭제가 취소됩니다.

 

3. 매도 처리 (매도 처리 화면)

"투자내역"화면에서 매수 내역을 클릭하면 이 화면으로 이동합니다.

3.1. 매수 정보 확인

화면 상단에서 클릭한 항목의 종목명, 매수 수량, 매수 가격, 매수 일자를 다시 한번 확인합니다.

3.2. 매도 정보 입력

• 매도 일자: 달력 아이콘을 탭하여 실제 매도한 날짜를 선택합니다. (기본값: 오늘)
• 매도 가격: 매도한 주당 가격을 입력합니다.
• 매도 수량 (분할 매도 시):
  • 일괄 매도: 모든 수량을 매도할 경우 이 칸은 비워둡니다.
  • 분할 매도: 보유 수량 중 일부만 매도할 경우, 매도할 수량을 정확히 입력합니다. (현재 보유 수량보다 작아야 함)

3.3. 매도 실행

• [일괄 매도] 버튼: 현재 보유한 수량 전체를 입력된 매도 가격과 날짜로 매도 처리합니다.
• [분할 매도] 버튼: 입력한 매도 수량만큼만 매도 처리합니다.
  • 새로운 매도 기록이 생성됩니다   이 기록에는 기존 매수 정보와 입력된 매도 정보(날짜, 가격, 수량), 그리고 해당 매도분에 대한 실현 손익이 저장됩니다.
  • 기존 매수 기록이 업데이트됩니다. 기존 매수 수량에서 매도한 수량만큼 차감됩니다.

매도 처리 성공 시, "처리 완료" 메시지와 함께 이전 화면(홈 화면)으로 돌아가며 목록이 자동으로 갱신됩니다.

 

4. 대시보드 활용하기

[대시보드] 탭에서는 전체 투자 현황을 시각적으로 파악할 수 있습니다.

• 자산 요약: 총 매수 금액, 현재 총 평가 금액, 평가 손익(금액, %), 총 자산(평가액+총 매도액), 최고/최저 수익률 종목, 목표 수익률 달성 현황 등을 보여줍니다. (ⓘ 아이콘 클릭 시 총 자산 계산 설명 확인 가능)
• 실현 손익 요약: 매도를 통해 확정된 총 손익 금액과 수익률을 보여줍니다.
• 포트폴리오 가치 추이: 시간에 따른 총 평가 금액의 변화를 라인 차트로 보여줍니다. (데이터 수집 방식에 따라 제공 여부 상이)
• 시장 구분별 투자 비중: KOSPI, KOSDAQ 등 시장별 투자 금액 비율을 파이 차트로 보여줍니다.
• 종목별 평가금액 비율: 현재 보유 종목들의 평가 금액 기준 비중을 파이 차트로 보여줍니다. (클릭 시 종목명 확인 가능)
• 종목별 수익/손실 금액: 각 종목의 현재 평가 손익 금액을 막대 차트로 보여줍니다. (클릭 시 종목명 및 금액 확인 가능)
• 최근 거래 내역: 최근에 등록된 매수 또는 매도 기록을 보여줍니다.
• 최근 실현 손익 내역: 최근에 매도 완료된 건들의 손익 정보를 보여줍니다.

 

5. 알림 설정하기

[알림] 탭에서는 목표가 도달 알림을 설정할 수 있습니다.

• 목표 수익률 (%): 익절 목표 수익률을 입력합니다. (예: 20 입력 시 +20%)
• 목표 손실률 (%): 손절 목표 손실률을 양수로 입력합니다. (예: 10 입력 시 -10%)
• 목표 도달 시 알림 받기: 스위치를 켜면 알림 기능이 활성화됩니다.
  • 최초 활성화 시 (Android 13 이상): 알림 권한 요청 팝업이 나타납니다. '허용'해야 정상적으로 알림을 받을 수 있습니다.
  • 목표 수익률 또는 손실률 중 하나라도 입력되어 있어야 스위치를 켤 수 있습니다.
• [설정 저장] 버튼을 눌러야 입력한 목표값이 저장되고 알림 설정이 적용됩니다.

알림 동작 방식:

• 백그라운드에서 주기적으로 (예: 평일 12시, 18시) 매도되지 않은 각 매수 건의 수익률을 확인합니다.
• 개별 매수 건의 수익률이 설정된 목표 수익률 이상이 되거나 목표 손실률 이하가 되면 해당 종목에 대한 알림을 보냅니다.
• 알림은 조건에 맞는 모든 개별 건에 대해 발송될 수 있습니다.

 

6. 설정 메뉴 활용하기

앱 우측 상단 메뉴 또는 별도의 [설정] 탭에서 다음 기능들을 이용할 수 있습니다.

• PIN 잠금 사용: 스위치를 켜고 끌 수 있습니다. (PIN이 설정되어 있어야 켤 수 있음)
• PIN 번호 변경: 현재 PIN을 입력하고 새 PIN으로 변경합니다. (PIN 잠금이 활성화되어 있어야 가능)
• 광고 보고 24시간 광고 제거: 보상형 광고를 시청하고 일정 시간 동안 앱 내 배너 광고 등을 제거할 수 있습니다.
• 라이선스 정보: 앱에서 사용된 오픈소스 라이선스 정보를 확인합니다.
• 개인정보 처리방침: 앱의 개인정보 처리방침을 확인합니다. (웹뷰로 표시)
• 앱 평가하기: 구글 플레이 스토어로 이동하여 앱 리뷰를 남길 수 있습니다.
• 어플 이용자 가이드: 현재 보고 계신 이 가이드 내용을 다시 확인할 수 있습니다. (웹뷰로 표시)
• 데이터 내보내기 (백업): 현재 앱의 모든 투자 데이터를 안전한 파일 형태로 외부 저장소(예: Downloads 폴더)에 저장합니다. (저장소 권한 필요할 수 있음)
• 데이터 복원하기: 이전에 내보낸 백업 파일을 선택하여 데이터를 복원합니다. 주의: 복원 시 현재 앱의 데이터는 모두 사라집니다! (저장소 권한 및 파일 선택 필요)
• 데이터 동기화 확인: 백그라운드에서 데이터(주가 정보 등)가 언제, 어떻게 동기화되었는지 기록을 확인합니다.
• CSV 데이터 가져오기 : 증권사 HTS(PC) 또는 MTS(모바일 앱)에서 내려받은 거래내역 CSV 파일을 읽어와 데이터를 간편하게 등록하는 기능을 제공합니다.

 

7. 추가 팁

• 정확한 데이터 입력: 정확한 수익률 계산과 알림을 위해 매수/매도 정보를 최대한 정확하게 입력해주세요.
• 데이터 동기화: 주가 정보 등은 백그라운드에서 주기적으로 동기화됩니다. (기본: 평일 12시) 
• 백업 생활화: 휴대폰 교체나 예기치 못한 문제에 대비하여 주기적으로 데이터를 내보내기(백업)하는 것을 권장합니다.

 

 

 

 

층층 알리미 - CSV 데이터 가져오기 가이드 

"증권사 거래 내역, 한 번에 옮겨오고 싶으신가요?"

'층층 알리미'는 사용 편의를 위해 증권사 HTS(PC) 또는 MTS(모바일 앱)에서 내려받은 거래내역 CSV 파일을 읽어와 데이터를 간편하게 등록하는 기능을 제공합니다.

이 가이드를 따라 CSV 파일을 준비하고 앱으로 가져오는 방법을 알아보세요.

 

 

1. 증권사에서 거래내역 CSV 파일 다운로드하기

먼저, 이용하시는 증권사의 HTS 또는 MTS에서 주식 거래내역을 CSV 파일 형식으로 내보내기(다운로드)해야 합니다.

• 메뉴 찾기: 증권사 프로그램마다 메뉴 위치와 이름이 다릅니다. 보통 '거래내역 조회', '매매내역 조회', '체결내역 조회' 등의 메뉴에서 기간을 설정하고 '파일 저장', '엑셀 저장', 'CSV 저장' 등의 버튼을 찾아보세요.
• 필수 정보 확인: 내보내기 시 거래일자, 종목코드, 종목명, 매수/매도 구분, 거래 수량, 거래 단가 정보가 반드시 포함되어야 합니다.
  • 매도 기록의 경우: 정확한 실현 손익 계산을 위해 해당 매도 건과 연결된 원래 매수일자와 매수가격 정보가 CSV 파일에 포함되어 있으면 가장 좋습니다. (증권사마다 제공 여부 상이)
• 파일 저장: 내려받은 CSV 파일을 스마트폰으로 옮겨 쉽게 찾을 수 있는 위치(예: Downloads 폴더)에 저장합니다.

⚠️ 중요: 증권사별로 CSV 파일의 열(Column) 순서나 이름이 다를 수 있습니다. '층층 알리미'는 특정 형식을 기준으로 데이터를 읽어오므로, 아래 "2. CSV 파일 형식 확인" 부분을 꼭 참고하여 파일을 준비해주세요.

 

2. CSV 파일 형식 확인 (앱 호환성)

'층층 알리미' 앱이 거래내역을 올바르게 인식하려면 CSV 파일이 다음과 같은 형식(열 순서)을 따르는 것이 가장 좋습니다.

[필수 열 순서 예시]

거래일자, 종목코드, 종목명, 매매구분, 거래수량, 거래단가, (선택)매수일자(매도용), (선택)매수가(매도용)

• 거래일자: YYYY/MM/DD 또는 YYYY-MM-DD 형식 권장
• 종목코드: 'A' 접두사 제외한 숫자 6자리 (예: 005930)
• 종목명: 전체 종목 이름
• 매매구분: "매수" 또는 "매도" 텍스트 포함
• 거래수량: 숫자
• 거래단가: 숫자 (쉼표 없이)
• (선택) 매수일자/매수가 (매도용): 매도 기록에 대해, 이 매도와 연결된 원래 매수 건의 날짜와 단가 정보가 있다면 포함합니다. 없다면 앱에서 기본값(매도일자, 0원)으로 처리합니다.

[CSV 파일 예시]

거래일자,종목코드,종목명,매매구분,거래수량,거래단가,매수일자,매수가
2024/01/15,005930,삼성전자,매수,10,80000,,
2024/02/20,035720,카카오,매수,5,55000,,
2025/03/10,005930,삼성전자,매도,5,90000,2024/01/15,80000
...

⚠️ 중요:

• 파일의 첫 번째 줄은 헤더(제목) 줄로 가정하고 건너뜁니다.
• 쉼표(,)로 각 데이터가 구분되어야 합니다.
• 만약 사용하시는 증권사의 CSV 형식이 위와 많이 다르다면, 데이터를 가져오지 못하거나 잘못된 정보가 등록될 수 있습니다. (향후 다양한 형식 지원 예정)

 

3. 앱에서 CSV 데이터 가져오기

1. '층층 알리미' 앱을 실행하고 [설정] 메뉴로 이동합니다.
2. [데이터 관리] 섹션에서 [CSV 데이터 가져오기] 메뉴를 탭합니다.
3. 파일 선택 화면이 나타나면, 1단계에서 스마트폰에 저장한 거래내역 CSV 파일을 찾아 선택합니다. (파일 접근 권한이 필요할 수 있습니다.)
4. 파일 선택이 완료되면 앱이 자동으로 CSV 파일을 읽고 데이터를 분석하여 데이터베이스에 저장합니다.
5. 처리 완료 후, 가져오기 결과 팝업이 나타납니다. (총 처리 건수, 성공, 건너뛰기(중복), 오류 건수 확인)
6. [확인] 버튼을 누르면 설정 화면으로 돌아갑니다.
7. [투자 내역] 탭으로 이동하여 데이터가 정상적으로 등록되었는지 확인합니다.

⚠️ 참고:

• 매도 기록 처리: 현재 CSV 가져오기 기능은 '매도' 기록을 별도의 완료된 거래 내역으로 **새롭게 추가(INSERT)**합니다. 기존 '매수' 기록을 찾아 업데이트하는 방식이 아닙니다. 정확한 실현 손익 계산을 위해서는 CSV 파일에 매도 건에 대한 매수 정보가 포함되어 있거나, 앱 내에서 수동으로 매도 처리를 진행하는 것이 좋습니다.
• 중복 방지: 앱은 가져오는 데이터가 이미 DB에 존재하는지 기본적인 확인을 시도하지만(TODO 주석 부분 참고), 완벽하지 않을 수 있습니다. 동일한 파일을 여러 번 가져오면 데이터가 중복 등록될 수 있으니 주의하세요.
• 대용량 파일: 거래 내역이 매우 많은 경우 처리 시간이 다소 걸릴 수 있습니다.

이제 CSV 파일을 이용하여 거래 내역을 더 편리하게 '층층 알리미'에 등록하고 관리해보세요!

 

 

 

 

앱 다운로드 바로가기

구글 플레이스토어 : https://play.google.com/store/apps/details?id=jspsoft.stock.investment.profit.management&hl=ko

층층알리미 - Google Play 앱

 

앱스토어 : https://apps.apple.com/us/app/%EC%B8%B5%EC%B8%B5-%EC%95%8C%EB%A6%AC%EB%AF%B8/id6745892049

‎층층 알리미

 

 

 

 

앱 사용 중 궁금한 점이나 불편한 점이 있다면 언제든지 문의해주세요.

(문의처: ddolcatmaster@gmail.com)

 

여러분의 성공적인 투자를 층층 알리미가 응원합니다! 🎉

 

 

 

 

 

 

[홍보용 이미지]

424x146

300x103