가입 시 약관 동의 단계 추가 — 필수·선택 항목 구분 · 개인정보처리방침 고지 · 동의 기록 저장

app/lib/features/auth/signup_screens.dart

@@ -1,23 +1,45 @@
 import 'package:flutter/material.dart';
 
+import '../../core/data/backend.dart';
 import '../../core/theme/tokens.dart';
+import 'auth_repository.dart';
 
 /// 회원가입 약관 — Figma `179:24230`(미동의) · `179:24324`(전체 동의).
 ///
-/// 필수 3항(서비스 · 위치기반 · 만 14세)을 모두 체크해야 「완료」가 켜진다. 완료하면 `true` 를
-/// 돌려주고, 부른 쪽([SimpleLoginScreen] 가입 모드)이 제공자 인증으로 넘어간다.
+/// 필수 항목을 모두 체크해야 「완료」가 켜진다. 완료하면 동의한 항목 키([signupTermKeys] 중)를
+/// 돌려준다 — 가입 모드([SimpleLoginScreen])는 `pop` 결과로, 로그인 직후 약관 단계는 [onAgreed] 로 받는다.
+/// 서버(`fnSignupConsent`)가 같은 필수 목록을 다시 검사하고 항목별 동의 행을 남긴다.
 ///
-/// 약관 본문은 시안의 자리 표시 문구다. 확정 약관이 오면 [_body] 만 바꾼다.
+/// - 필수: 서비스 이용약관 · 개인정보 수집·이용 동의 · 만 14세 이상.
+/// - 선택: 마케팅 수신(기본 OFF).
+/// - 위치기반 서비스 약관은 여기서 받지 않는다 — 위치기능 최초 사용 직전에 따로 받는다.
+/// - 개인정보처리방침은 동의 항목이 아니라 고지다 — 체크 칸 없이 목록 끝에 안내와 보기 링크만 둔다.
+///
+/// 약관 본문은 확정 문구를 받기 전까지 시안의 자리 표시 문구다 — 받으면
+/// [termsPlaceholderBody] 와 [signupTermsVersion] 을 함께 바꾼다(동의 기록에 버전이 남는다).
 class TermsScreen extends StatefulWidget {
-  const TermsScreen({super.key});
+  const TermsScreen({super.key, this.onAgreed, this.onBack, this.busy = false});
+
+  /// 로그인 직후 약관 단계에서 쓸 때 — 「완료」가 화면을 닫지 않고 이걸 부른다.
+  final ValueChanged<Set<String>>? onAgreed;
+  final VoidCallback? onBack;
+
+  /// 동의를 기록하는 중 — 버튼을 막고 진행 표시를 띄운다.
+  final bool busy;
 
   @override
   State<TermsScreen> createState() => _TermsScreenState();
 }
 
+/// 동의 기록에 남는 약관 버전. 본문이 자리 표시 문구인 동안은 `draft` 다.
+const signupTermsVersion = 'draft-1';
+
+/// 서버 `SIGNUP_REQUIRED_TERMS` + 선택 `marketing` 과 같은 키.
+List<String> get signupTermKeys => [for (final t in _Term.values) t.name];
+
 enum _Term {
   service('서비스 이용약관 (필수)', required: true, body: true),
-  location('위치기반 서비스 이용약관 (필수)', required: true, body: true),
+  privacy('개인정보 수집·이용 동의 (필수)', required: true, body: true),
   age('만 14세 이상입니다. (필수)', required: true, body: false),
   marketing('마케팅 정보 및 이벤트 알림 수신 동의 (선택)', required: false, body: true);
 
@@ -28,7 +50,8 @@ enum _Term {
   final bool body;
 }
 
-const _body =
+/// 약관 본문 자리 표시 문구.
+const termsPlaceholderBody =
     'FANUZU 서비스 이용약관\n\n제1조 (적용범위)\n서비스 이용약관에 대한 더미 텍스트 입니다.\n'
     '추후 작성해주시기 바랍니다. 서비스 이용약관에 대한 더미 텍스트 입니다.';
 
@@ -41,13 +64,88 @@ class _TermsScreenState extends State<TermsScreen> {
   bool get _ready =>
       _Term.values.where((t) => t.required).every(_agreed.contains);
 
+  void _done() {
+    final agreed = {for (final t in _agreed) t.name};
+    final cb = widget.onAgreed;
+    cb != null ? cb(agreed) : Navigator.of(context).pop(agreed);
+  }
+
+  void _back() => (widget.onBack ?? () => Navigator.of(context).pop())();
+
   void _toggle(_Term t) =>
       setState(() => _agreed.contains(t) ? _agreed.remove(t) : _agreed.add(t));
 
+  void _showPrivacyPolicy() => showDialog<void>(
+    context: context,
+    builder: (context) => AlertDialog(
+      title: const Text('개인정보처리방침'),
+      content: const SingleChildScrollView(child: Text(termsPlaceholderBody)),
+      actions: [
+        TextButton(
+          onPressed: () => Navigator.of(context).pop(),
+          child: const Text('확인'),
+        ),
+      ],
+    ),
+  );
+
+  Widget _buttons() {
+    final shape = RoundedRectangleBorder(
+      borderRadius: BorderRadius.circular(AppRadius.sm),
+    );
+    final busy = widget.busy;
+    return Row(
+      children: [
+        Expanded(
+          child: FilledButton(
+            onPressed: busy ? null : _back,
+            style: FilledButton.styleFrom(
+              minimumSize: const Size.fromHeight(56),
+              shape: shape,
+              side: const BorderSide(color: _stroke),
+              backgroundColor: Colors.black,
+              foregroundColor: AppColors.onCosmic,
+            ),
+            child: const Text('이전'),
+          ),
+        ),
+        const SizedBox(width: 10),
+        Expanded(
+          child: FilledButton(
+            onPressed: _ready && !busy ? _done : null,
+            style: FilledButton.styleFrom(
+              minimumSize: const Size.fromHeight(56),
+              shape: shape,
+              side: const BorderSide(color: _stroke),
+              backgroundColor: AppColors.cosmicAccent,
+              foregroundColor: AppColors.onCosmicAccent,
+              disabledBackgroundColor: const Color(0xFF333333),
+              disabledForegroundColor: const Color(0xFF777777),
+            ),
+            child: const Text('완료'),
+          ),
+        ),
+      ],
+    );
+  }
+
   @override
   Widget build(BuildContext context) {
-    return Scaffold(
-      appBar: AppBar(title: const Text('이용 약관')),
+    final scaffold = Scaffold(
+      // Figma `179:24230` 머리줄 좌측 「<」 — 「이전」과 같은 동작.
+      appBar: AppBar(
+        automaticallyImplyLeading: false,
+        leading: BackButton(onPressed: widget.busy ? null : _back),
+        title: const Text('이용 약관'),
+        centerTitle: true,
+      ),
+      // 「이전 · 완료」는 화면 하단 고정(56 높이 · 간격 10). 시스템 내비게이션 바 위로 올린다.
+      bottomNavigationBar: SafeArea(
+        child: Padding(
+          padding: const EdgeInsets.all(AppSpace.s4),
+          child: _buttons(),
+        ),
+      ),
       body: ListView(
         padding: const EdgeInsets.all(AppSpace.s4),
         children: [
@@ -85,7 +183,7 @@ class _TermsScreenState extends State<TermsScreen> {
                             height: 80,
                             child: ClipRect(
                               child: Text(
-                                _body,
+                                termsPlaceholderBody,
                                 overflow: TextOverflow.clip,
                                 style: TextStyle(
                                   fontFamily: AppFonts.display,
@@ -108,42 +206,101 @@ class _TermsScreenState extends State<TermsScreen> {
                     ),
             ),
           ],
-          const SizedBox(height: AppSpace.s6),
-          Row(
-            children: [
-              Expanded(
-                child: FilledButton(
-                  onPressed: () => Navigator.of(context).pop(false),
-                  style: FilledButton.styleFrom(
-                    backgroundColor: Colors.black,
-                    foregroundColor: AppColors.onCosmic,
+          // 개인정보처리방침 — 동의 항목과 구분한 고지. 체크 칸이 없고 「보기」로 본문을 연다.
+          Padding(
+            padding: const EdgeInsets.symmetric(vertical: AppSpace.s4),
+            child: Row(
+              children: [
+                const Expanded(
+                  child: Text(
+                    '개인정보 처리 내용은 개인정보처리방침에서 확인할 수 있습니다.',
+                    style: TextStyle(
+                      fontFamily: AppFonts.display,
+                      fontFamilyFallback: [AppFonts.body],
+                      fontSize: 12,
+                      height: 1.36,
+                      color: AppColors.onCosmicMuted,
+                    ),
                   ),
-                  child: const Text('이전'),
                 ),
-              ),
-              const SizedBox(width: 10),
-              Expanded(
-                child: FilledButton(
-                  onPressed: _ready
-                      ? () => Navigator.of(context).pop(true)
-                      : null,
-                  style: FilledButton.styleFrom(
-                    backgroundColor: AppColors.cosmicAccent,
-                    foregroundColor: AppColors.onCosmicAccent,
-                    disabledBackgroundColor: const Color(0xFF333333),
-                    disabledForegroundColor: const Color(0xFF777777),
-                  ),
-                  child: const Text('완료'),
+                TextButton(
+                  key: const ValueKey('privacy-policy-link'),
+                  onPressed: _showPrivacyPolicy,
+                  child: const Text('보기'),
                 ),
-              ),
-            ],
+              ],
+            ),
           ),
         ],
       ),
     );
+    if (!widget.busy) return scaffold;
+    return Stack(children: [scaffold, const BlockingProgress()]);
   }
 }
 
+/// 진행 중 화면 전체를 막는 반투명 막 + 가운데 진행 표시.
+class BlockingProgress extends StatelessWidget {
+  const BlockingProgress({super.key});
+
+  @override
+  Widget build(BuildContext context) => const Stack(
+    children: [
+      ModalBarrier(dismissible: false, color: Color(0x8A000000)),
+      Center(child: CircularProgressIndicator()),
+    ],
+  );
+}
+
+/// 로그인 직후 약관 단계 — 동의 기록이 없는 계정은 HOME 대신 여기로 온다.
+///
+/// 판정 중(또는 이미 동의한 계정이 셸로 넘어가는 동안)에는 진행 표시만 그린다.
+/// 「이전」은 로그아웃하고 로그인 화면으로 돌아간다 — 동의 없이 셸에 들어가는 길이 없다.
+class SignupTermsGate extends StatefulWidget {
+  const SignupTermsGate({super.key, required this.auth});
+
+  final AuthRepository auth;
+
+  @override
+  State<SignupTermsGate> createState() => _SignupTermsGateState();
+}
+
+class _SignupTermsGateState extends State<SignupTermsGate> {
+  bool _busy = false;
+
+  Future<void> _agree(Set<String> agreed) async {
+    setState(() => _busy = true);
+    try {
+      await widget.auth.agreeTerms(agreed);
+    } catch (e) {
+      if (!mounted) return;
+      ScaffoldMessenger.maybeOf(context)
+        ?..hideCurrentSnackBar()
+        ..showSnackBar(
+          SnackBar(
+            content: Text(
+              e is BackendException ? e.message : '요청을 처리하지 못했습니다. 다시 시도해 주세요.',
+            ),
+          ),
+        );
+    } finally {
+      if (mounted) setState(() => _busy = false);
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) => ListenableBuilder(
+    listenable: widget.auth,
+    builder: (context, _) => widget.auth.terms == TermsGate.required
+        ? TermsScreen(
+            busy: _busy,
+            onAgreed: _agree,
+            onBack: widget.auth.signOut,
+          )
+        : const Scaffold(body: Center(child: CircularProgressIndicator())),
+  );
+}
+
 /// 약관 칸 — #545454 획 · 모서리 8 · 좌우 16.
 class _Box extends StatelessWidget {
   const _Box({required this.child});