fix: 실시간 보드 삭제 반영, 내용 마크다운 렌더링, 참여도 자동갱신, 성능 개선

1. 삭제 즉시 반영: on_click 콜백 → 직접 if 버튼 패턴으로 변경 후
fetch_live_messages.clear() + st.rerun(scope="app") 호출
2. 내용 표시 오류: st.info(content) 마크다운 해석 방지 — ~, *, _, ` 이스케이프
3. 학생 참여도 현황: @st .fragment(run_every=10)으로 분리해 자동 갱신
4. 성능: 워드클라우드 @st .cache_data(ttl=5) 캐싱으로 재생성 방지,
토론 상태 폴링 3초 → 5초로 완화

https://claude.ai/code/session_016DE3uHLsVmA5Uv7gZGGaKT

app.py

@@ -129,9 +129,9 @@ if user_role == "교사" and teacher_auth:
                     st.toast("✅ 주제가 수정되었습니다.", icon="✏️")
                     st.rerun()
 
-@st.fragment(run_every=3)
+@st.fragment(run_every=5)
 def _poll_debate_status(room_name):
-    """학생 화면에서 3초마다 토론 상태를 확인하고 변경 시 전체 rerun."""
+    """학생 화면에서 5초마다 토론 상태를 확인하고 변경 시 전체 rerun."""
     current = fetch_debate_status(supabase, room_name)
     if current != st.session_state.get("_last_debate_status"):
         st.session_state["_last_debate_status"] = current

components/chat_board.py

@@ -13,6 +13,26 @@ _RANK_BADGES = {1: "🥇", 2: "🥈", 3: "🥉"}
 _LIKE_COOLDOWN = 3
 
 
+def _escape_md(text: str) -> str:
+    """st.info() 마크다운 해석 방지 — ~, *, _, ` 등 이스케이프."""
+    s = str(text or "")
+    for ch in ('\\', '`', '*', '_', '~'):
+        s = s.replace(ch, '\\' + ch)
+    return s
+
+
+@st.cache_data(ttl=5)
+def _cached_wordcloud(content_tuple: tuple):
+    """같은 데이터면 워드클라우드를 재생성하지 않고 캐시 반환."""
+    import pandas as pd
+    frequencies = build_word_frequencies(pd.Series(list(content_tuple)))
+    if not frequencies:
+        return None, None
+    wc_html = build_circular_wordcloud_html(frequencies)
+    top_words = ", ".join([f"{w}({c})" for w, c in frequencies.most_common(8)])
+    return wc_html, top_words
+
+
 def _live_chat_board_core(supabase, room_name, user_role, teacher_auth, student_name, current_mode, act_type):
     opinion_df = with_fallback_author_role(
         fetch_live_messages(supabase, room_name, LIVE_BOARD_FETCH_LIMIT)
@@ -29,10 +49,11 @@ def _live_chat_board_core(supabase, room_name, user_role, teacher_auth, student_
                 st.plotly_chart(live_pie_fig, use_container_width=True, config={'displayModeBar': False, 'scrollZoom': False})
             with right_col:
                 st.caption("누적 토의/토론 워드클라우드")
-                frequencies = build_word_frequencies(stats_opinion_df["content"])
-                if frequencies:
-                    st.markdown(build_circular_wordcloud_html(frequencies), unsafe_allow_html=True)
-                    top_words = ", ".join([f"{word}({count})" for word, count in frequencies.most_common(8)])
+                wc_html, top_words = _cached_wordcloud(
+                    tuple(stats_opinion_df["content"].fillna("").tolist())
+                )
+                if wc_html:
+                    st.markdown(wc_html, unsafe_allow_html=True)
                     st.caption(f"상위 키워드: {top_words}")
                 else:
                     st.info("워드클라우드를 만들 단어가 아직 부족합니다.")
@@ -74,16 +95,6 @@ def _live_chat_board_core(supabase, room_name, user_role, teacher_auth, student_
             # 쿨다운 확인
             on_like_cooldown = (time.time() - st.session_state.get('_last_like_ts', 0)) < _LIKE_COOLDOWN
 
-        def delete_chat_msg(msg_id):
-            try:
-                if delete_opinion_message(supabase, msg_id) is None:
-                    return
-                fetch_live_messages.clear()
-                log_audit("chat_deleted", room_name=room_name, actor_name=student_name, role=user_role, message_id=msg_id)
-                st.toast("의견이 즉시 삭제되었습니다.", icon="🗑️")
-            except Exception as e:
-                st.error(f"삭제 실패: {e}")
-
         def do_toggle_like(msg_id):
             toggle_like(supabase, msg_id, room_name, student_name)
             fetch_room_likes.clear()
@@ -120,8 +131,17 @@ def _live_chat_board_core(supabase, room_name, user_role, teacher_auth, student_
                               type=like_type, use_container_width=True,
                               on_click=do_toggle_like, args=(msg_id,))
                 with c_del:
-                    st.button("❌", key=f"del_{msg_id}", help="강제 삭제",
-                              on_click=delete_chat_msg, args=(msg_id,))
+                    if st.button("❌", key=f"del_{msg_id}", help="강제 삭제"):
+                        try:
+                            if delete_opinion_message(supabase, msg_id) is not None:
+                                fetch_live_messages.clear()
+                                _cached_wordcloud.clear()
+                                log_audit("chat_deleted", room_name=room_name, actor_name=student_name,
+                                          role=user_role, message_id=msg_id)
+                                st.toast("의견이 즉시 삭제되었습니다.", icon="🗑️")
+                                st.rerun(scope="app")
+                        except Exception as e:
+                            st.error(f"삭제 실패: {e}")
             else:
                 c_name, c_like = st.columns([5, 1])
                 with c_name:
@@ -134,7 +154,7 @@ def _live_chat_board_core(supabase, room_name, user_role, teacher_auth, student_
                     st.button(like_label, key=f"like_{msg_id}", disabled=like_disabled,
                               type=like_type, use_container_width=True,
                               on_click=do_toggle_like, args=(msg_id,))
-            st.info(row['content'])
+            st.info(_escape_md(row['content']))
             st.write("")
 
         if current_mode == "⚔️ 찬반 토론":

components/teacher_dashboard.py

@@ -201,6 +201,32 @@ def _render_oc_section(supabase, room_name, act_type, current_topic, df_all):
                     st.info("아직 제출된 결론이 없습니다.")
 
 
+@st.fragment(run_every=10)
+def _render_participation_section(supabase, room_name, act_type):
+    df = with_fallback_author_role(fetch_live_messages(supabase, room_name, DASHBOARD_FETCH_LIMIT))
+    student_df = (
+        df[
+            (df['author_role'] == '학생') &
+            ~df['student_name'].str.contains('익명|AI', na=False, regex=True)
+        ].copy()
+        if not df.empty else df
+    )
+    st.subheader("📊 학생 참여도 현황")
+    if not df.empty:
+        if not student_df.empty:
+            counts = student_df['student_name'].astype(str).value_counts().reset_index()
+            counts.columns = ['학생 이름', '참여 횟수']
+            counts['학생 이름'] = counts['학생 이름'] + " "
+            fig = px.bar(counts, x='학생 이름', y='참여 횟수', text='참여 횟수', color='학생 이름')
+            fig.update_xaxes(type='category', title="")
+            fig.update_layout(yaxis_title="의견 수", dragmode=False, showlegend=False, font={"family": UI_FONT_FAMILY})
+            st.plotly_chart(fig, use_container_width=True, config={'scrollZoom': False, 'displayModeBar': False})
+        else:
+            st.info("실명 참여 데이터가 없습니다.")
+    else:
+        st.info(f"{act_type} 데이터가 없습니다.")
+
+
 def render_teacher_dashboard(supabase, room_name, user_role, student_name, current_topic, current_mode, act_type):
     st.divider()
     col_dash_title, col_dash_refresh = st.columns([8, 2])
@@ -211,13 +237,6 @@ def render_teacher_dashboard(supabase, room_name, user_role, student_name, curre
             st.rerun()
 
     df_all = with_fallback_author_role(fetch_live_messages(supabase, room_name, DASHBOARD_FETCH_LIMIT))
-    student_only_df = (
-        df_all[
-            (df_all['author_role'] == '학생') &
-            ~df_all['student_name'].str.contains('익명|AI', na=False, regex=True)
-        ].copy()
-        if not df_all.empty else df_all
-    )
 
     # ── 1. AI 토의 촉진 ──
     render_hint_section(supabase, room_name, user_role, student_name, current_topic, act_type, df_all)
@@ -244,22 +263,9 @@ def render_teacher_dashboard(supabase, room_name, user_role, student_name, curre
     st.divider()
     render_summary_section(room_name, act_type, current_topic, df_all)
 
-    # ── 4. 학생 참여도 현황 ──
+    # ── 4. 학생 참여도 현황 (10초마다 자동 갱신) ──
     st.divider()
-    st.subheader("📊 학생 참여도 현황")
-    if not df_all.empty:
-        if not student_only_df.empty:
-            counts = student_only_df['student_name'].astype(str).value_counts().reset_index()
-            counts.columns = ['학생 이름', '참여 횟수']
-            counts['학생 이름'] = counts['학생 이름'] + " "
-            fig = px.bar(counts, x='학생 이름', y='참여 횟수', text='참여 횟수', color='학생 이름')
-            fig.update_xaxes(type='category', title="")
-            fig.update_layout(yaxis_title="의견 수", dragmode=False, showlegend=False, font={"family": UI_FONT_FAMILY})
-            st.plotly_chart(fig, use_container_width=True, config={'scrollZoom': False, 'displayModeBar': False})
-        else:
-            st.info("실명 참여 데이터가 없습니다.")
-    else:
-        st.info(f"{act_type} 데이터가 없습니다.")
+    _render_participation_section(supabase, room_name, act_type)
 
     _render_oc_section(supabase, room_name, act_type, current_topic, df_all)
     render_depth_analysis_section(supabase, room_name, act_type)