스팀 앱 개발기 #166 - 작성 완료: 문서 추가 정리

작성 완료: 문서 추가 정리

No. 166
2026. 09. 16 (수) | Written by @dorian-mobileapp

이번에는 그 동안 미뤄왔던 문서 정리를 했습니다. 예전에 코드를 다시 보고 정리를 하기는 부담이었는데, 이제는 AI가 상당 부분을 대신 해줄 수 있습니다. 덕분에 이번에 문서 정리하고 다음 단계로 넘어갑니다.


작업 요약

1. SteemWorld API 연동 가이드 신규 작성

scripts/integrate-steemworld-api.md — 502줄

기존 구현(delegations_api, transfers_api, rewards_api)을 분석해 SDS API 연동 절차를 정리했습니다.

  • SDS 제약 7가지 — HTTP 200 + code: -1 에러 보고, cols/rows 구조, op별 상이한 cols, Gson의 Double 역직렬화, API별 보관 기간·정렬 옵션 차이, from/to의 AND 조건, Unix timestamp
  • Step 0~10 — curl로 스펙 확인 → Response DTO → 도메인 모델 → SteemWorldServiceSteemWorldRepositoryImpl(단순 / DGP 병렬 / 페이징 3패턴) → UseCase → DI → ViewModel → Compose → 테스트
  • 파일 요약 표, 최종 체크리스트, 참고 파일 표

2. 문서 이름 정리

변경 전변경 후
generate-steemworld-api.md (초안)integrate-steemworld-api.md
generate-api.mdgenerate-steem-api-integration.md

generate-(템플릿 기반 코드 생성)와 integrate-(수동 연동 절차)로 두 문서의 성격 차이를 이름에 반영했습니다. 참조 5곳(README 3, SteemWorld 문서 2)을 갱신했고 남은 참조는 없습니다.

3. 저장소 문서 최신성 조사

작업 중 Fragment → Compose 마이그레이션이 이미 완료된 상태임을 확인했습니다. MainActivity.kt 없음, res/layout/ 0개, nav graph XML 없음, 모든 Activity가 ComponentActivity + setContent. 이름만 Fragment인 두 파일도 내용은 전부 Composable입니다.

4. CLAUDE.md 최신화 — 249줄

존재하지 않는 경로를 안내하던 부분을 전부 교정했습니다.

기존 기술실제
MainActivity/Main2Activity 공존SplashActivityMain2Activity 단일 경로
nav graph XML, SafeArgs@Serializable 라우트 + toRoute()
ViewBinding/DataBindingcompose만 활성
GlideCoil만
RxJava2 병행사실상 제거 (잔재 3곳)
SteemRepositorySteemWorld 포함 백엔드 2종 비교표

추가: ApiResult<T> vs State<T> 구분, Composable 화면 규약, 테스트 배치 규약과 실 네트워크 호출 경고, 마크다운 렌더링 경로(CommonMark → WebView → AndroidView).

5. readme.md 신규 작성 — 129줄

한 문장짜리였던 저장소 정문을 채웠습니다. 기능 표, 요구사항, 빌드·실행, 모듈 구조, 기술 스택, 백엔드 2종, 테스트 주의사항, 문서 목록. 읽기 전용 앱(서명·개인키 없음)임을 상단에 명시했습니다.


GitHub Commit

보다 자세한 코드는 아래 commit을 참고하세요.


지난 스팀 앱 개발기


Layout provided by Steemit Enhancer hommage by ayogom
Sort:  

안녕하세요.
SteemitKorea팀에서 제공하는 'steemit-enhancer'를 사용해 주셔서 감사합니다. 개선 사항이 있으면 언제나 저에게 연락을 주시면 되고, 관심이 있으신 분들은 https://cafe.naver.com/steemitkorea/425 에서 받아보실 수 있습니다. 사용시 @응원해 가 포함이 되며, 악용시에는 모든 서비스에서 제외될 수 있음을 알려드립니다.

새로운 콘덴서(steemit 사이트)를 소개합니다.
https://steemitkorea.com 에서 보다 편리한 스팀잇 활동 부탁드립니다


안녕하세요.
이 글은 SteemitKorea팀(@ayogom)님께서 저자이신 @dorian-mobileapp님을 응원하는 글입니다.
소정의 보팅을 해드렸습니다 ^^ 항상 좋은글 부탁드립니다
SteemitKorea팀에서는 보다 즐거운 steemit 생활을 위해 노력하고 있습니다.
이 글은 다음날 다시 한번 포스팅을 통해 소개 될 예정입니다. 감사합니다!

새로운 콘덴서(steemit 사이트)를 소개합니다.
https://steemitkorea.com 에서 보다 편리한 스팀잇 활동 부탁드립니다