TalkStock은 증권사 리포트를 요약 제공하고, 이를 **TTS(Text-to-Speech)**로 변환해
언제 어디서나 핸즈프리로 청취할 수 있는 Android 기반 모바일 앱입니다.
이동 중이거나 글을 읽기 어려운 상황에서도 쉽게 정보를 습득할 수 있도록 설계되었습니다.

• 증권 리포트를 음성으로 변환해 이동 중에도 편리한 정보 청취 제공
• 초보자도 이해하기 쉬운 요약 중심의 직관적인 UI 제공
• 좋아요 기반 재생목록, 추천 콘텐츠, 이어듣기 기능 등 사용자 맞춤 기능 제공
• 정보 접근성과 편의성 향상을 통한 리포트 소비 방식 개선

TalkStock은 총 **4개의 핵심 화면(Activity/Fragment)**으로 구성됩니다:

TalkStock은 단일 Activity - 다중 Fragment 구조로 설계되며, 다음과 같은 방식으로 데이터 흐름이 이루어집니다:

• Fragment 간 전환: ViewPager2 + BottomNavigationView를 통해 구현
• 데이터 통신: OkHttp + REST API로 서버 데이터 요청
• 로컬 저장: SharedPreferences 기반으로 좋아요/자동로그인 정보 저장
• TTS 변환: Google TTS를 통해 mp3 파일 생성 후 캐시 디렉토리에 저장
• 오디오 재생 서비스: ForegroundService를 통해 Fragment/Activity 간 이어듣기 유지
• UI 동기화: LocalBroadcastManager를 통해 좋아요 상태 반영 등 처리

• 모든 네트워크 실패 시 더미 데이터로 fallback 처리
• Shimmer UI 로딩 구현 (Home / Search / Recommend)
• 실시간 재생 상태 반영을 위해 AudioService에서 콜백 처리 및 UI 갱신

TalkStock은 사용자 편의성과 정보 접근성을 고려해 핵심 화면 중심으로 설계되었습니다.
각 화면은 독립적인 역할을 가지며, 아래와 같이 구성됩니다:

🔍 상세 화면: '기능 요약'

🔍 상세 로직: HomeFragment

다음 페이지로 넘어가려면 👉 [화면별 기능 상세 설명 및 로직 분석](화면 별 기능 상세 설명)

TalkStock 앱은 Django 기반 백엔드 서버와 REST API를 통해 통신합니다.
프론트엔드에서는 OkHttpClient를 사용하여 요청하며, JSON 응답을 파싱합니다.

🔗 각 엔드포인트의 파라미터, 응답 포맷 등은 백엔드 문서 참조

OkHttpClient client = new OkHttpClient();
String url = "http://10.0.2.2:8000/textload/content";

Request request = new Request.Builder()
        .url(url)
        .get()
        .build();

client.newCall(request).enqueue(new Callback() {
    @Override
    public void onFailure(Call call, IOException e) {
        // 실패 시 더미 데이터 로딩
    }

    @Override
    public void onResponse(Call call, Response response) throws IOException {
        String json = response.body().string();
        // JSON 파싱 후 RecyclerView 갱신
    }
});

• Android Emulator에서는 localhost 대신 10.0.2.2 사용해야 서버와 통신 가능
• HTTPS가 아닌 HTTP 사용 시, network_security_config.xml 설정 필요

<network-security-config>
    <domain-config cleartextTrafficPermitted="true">
          <domain includeSubdomains="true">10.0.2.2</domain>
    </domain-config>
</network-security-config>

• Django 서버가 실행 중인지 항상 확인할 것 (python manage.py runserver)

• 서버 통신 실패 시 → 더미 데이터로 자동 fallback 처리
• 모든 API 요청은 비동기 처리 (enqueue) 되어 UI thread를 차단하지 않음
• 데이터 로딩 중에는 Shimmer 애니메이션으로 사용자에게 피드백 제공
• Fragment의 onDestroyView()에서 네트워크 요청이나 핸들러를 제거해 메모리 누수 방지

TalkStock 앱은 Firebase Authentication을 기반으로 이메일/비밀번호 로그인과 Google 계정 로그인 기능을 제공합니다.
또한 Splash 화면에서 자동 로그인 여부를 판단하여 로그인 유지 상태를 관리합니다.

• 사용자가 이메일과 비밀번호 입력
• Firebase Auth의 signInWithEmailAndPassword(email, password) 호출
• 성공 시 basic_layout(메인 화면)으로 이동

mAuth.signInWithEmailAndPassword(email, password)
     .addOnCompleteListener(task -> {
         if (task.isSuccessful()) {
             FirebaseUser user = mAuth.getCurrentUser();
             updateUI(user); // → main 화면으로 전환
         }
     });

• Google Sign-In 버튼 클릭 시 Google 계정 선택
• 선택한 계정의 ID 토큰을 Firebase에 인증 요청
• 신규 유저인 경우 Firebase Realtime Database에 닉네임 등록

AuthCredential credential = GoogleAuthProvider.getCredential(idToken, null);
mAuth.signInWithCredential(credential)
     .addOnCompleteListener(task -> {
         if (task.isSuccessful()) {
             FirebaseUser user = mAuth.getCurrentUser();
             // 새 유저라면 DB에 추가
             if (task.getResult().getAdditionalUserInfo().isNewUser()) {
                 saveGoogleUserToDatabase(user);
             }
             updateUI(user); // → main 화면으로 전환
         }
     });

• 앱 실행 시 SplashActivity에서 로그인 상태 확인 후 화면 전환:
• 로그인 정보가 있으면 → 바로 basic_layout으로 이동
• 없으면 → LoginActivity로 이동

FirebaseUser currentUser = FirebaseAuth.getInstance().getCurrentUser();
if (currentUser != null) {
    startActivity(new Intent(SplashActivity.this, basic_layout.class));
} else {
    startActivity(new Intent(SplashActivity.this, LoginActivity.class));
}

• basic_layout 상단 로그아웃 버튼 클릭 시:
  • Firebase 로그아웃
  • Google 로그아웃 (사용한 경우만)
  • SharedPreferences 초기화
  • LoginActivity로 이동

FirebaseAuth.getInstance().signOut();
googleSignInClient.signOut().addOnCompleteListener(task -> {
    PreferenceUtil.clearAll(); // SharedPreferences 초기화
    startActivity(new Intent(this, LoginActivity.class));
    finish();
});

• Firebase Realtime Database에 사용자 정보 저장 시 사용자 UID를 기준으로 저장됨
• 인증 상태는 앱 재시작 후에도 Firebase가 자동 유지
• 로그아웃 시 앱의 모든 세션 및 SharedPreferences 초기화됨

TalkStock는 Android 기반의 증권 리포트 오디오 요약 앱으로,
프론트엔드는 Java 기반 Android Studio, 백엔드는 Django + Firebase를 활용하였습니다.

    implementation ("com.squareup.okhttp3:okhttp:4.9.2")
    implementation ("com.google.android.material:material:1.9.0")
    implementation ("com.squareup.retrofit2:retrofit:2.6.4")
    implementation ("com.squareup.retrofit2:converter-gson:2.6.4")
    implementation ("androidx.viewpager2:viewpager2:1.0.0")
    implementation ("com.tbuonomo:dotsindicator:5.0")
    implementation ("com.facebook.shimmer:shimmer:0.5.0")
    implementation(platform("com.google.firebase:firebase-bom:33.12.0"))
    implementation("com.google.firebase:firebase-analytics")
    implementation("com.google.android.gms:play-services-auth:21.2.0")
    implementation("com.google.firebase:firebase-auth")
    implementation("com.google.firebase:firebase-firestore")