設計レビュー 일본어 가이드: 기술 아키텍처 토론과 의사결정 표현 완전 정복

【レビュイー（設計者）の開始発言】

「それでは、○○システムの基本設計について、ご説明させていただきます。」
(그러면 ○○ 시스템의 기본 설계에 대해 설명드리겠습니다.)

「本日のレビュー対象は、決済モジュールのアーキテクチャ設計書です。
 全体で30ページほどありますが、特にご確認いただきたいポイントを
 3点に絞ってご説明いたします。」
(오늘 리뷰 대상은 결제 모듈의 아키텍처 설계서입니다.
 전체 30페이지 정도이지만, 특히 확인해 주셨으면 하는 포인트를
 3가지로 압축해서 설명드리겠습니다.)

「まず全体構成をご説明した後、各コンポーネントの
 役割と連携方式についてお話しいたします。」
(우선 전체 구성을 설명드린 뒤, 각 컴포넌트의
 역할과 연계 방식에 대해 말씀드리겠습니다.)

---

【レビュアー（検討者）の進行発言】

「それでは、設計レビューを始めましょう。
 本日は○○さんの設計書を確認いたします。
 質問や指摘がございましたら、随時お願いいたします。」
(자, 설계 리뷰를 시작하겠습니다.
 오늘은 ○○씨의 설계서를 확인하겠습니다.
 질문이나 지적이 있으시면 수시로 말씀해 주세요.)

「限られた時間ですので、アーキテクチャの
 全体方針に関する議論を優先させてください。」
(시간이 한정되어 있으므로, 아키텍처의
 전체 방침에 관한 논의를 우선해 주세요.)

【設計意図を確認する質問パターン】

◆ 기본 패턴: 「〜という設計にされた背景を教えていただけますか」
(~라는 설계로 하신 배경을 알려주시겠습니까)

(例1) 「マイクロサービスではなくモノリシックな構成を選ばれた
      背景をお聞かせいただけますか。」
      (마이크로서비스가 아닌 모놀리식 구성을 선택하신
       배경을 알려주시겠습니까.)

(例2) 「RDBではなくNoSQLを採用された理由について、
      もう少し詳しくお聞きしてもよろしいでしょうか。」
      (RDB가 아닌 NoSQL을 채용하신 이유에 대해
       좀 더 자세히 여쭤봐도 될까요.)

(例3) 「同期処理ではなく非同期処理にされた判断基準は
      何でしょうか。」
      (동기 처리가 아닌 비동기 처리로 하신 판단 기준은
       무엇일까요.)

---

◆ 비기능 요건 확인 패턴

(例4) 「この構成でのSLAの目標値はどのように設定されていますか。」
      (이 구성에서 SLA 목표치는 어떻게 설정되어 있습니까.)

(例5) 「想定されているピーク時のスループットは
      どの程度でしょうか。」
      (상정하고 있는 피크 시 스루풋은 어느 정도일까요.)

(例6) 「障害発生時のフェイルオーバーは
      どのような仕組みを想定されていますか。」
      (장애 발생 시 페일오버는 어떤 구조를 상정하고 계십니까.)

【反対意見の3段構造テンプレート】

=== ステップ1: 認める（인정하기） ===

「○○さんのご提案の趣旨はよく理解できました。」
(○○씨의 제안 취지는 잘 이해했습니다.)

「確かに、シンプルな構成にするというお考えは理にかなっていると思います。」
(확실히, 심플한 구성으로 한다는 생각은 일리가 있다고 생각합니다.)

=== ステップ2: 懸念を示す（우려 제시하기） ===

「ただ、一つ気になる点がありまして、○○の場合に
 単一障害点になる可能性があるのではないかと考えております。」
(다만, 한 가지 신경 쓰이는 점이 있는데, ○○의 경우에
 단일 장애점이 될 가능성이 있지 않을까 생각하고 있습니다.)

「運用フェーズに入った際に、スケールアウトが
 難しくなるのではないかという懸念があります。」
(운용 페이즈에 들어갔을 때, 스케일 아웃이
 어려워지지 않을까 하는 우려가 있습니다.)

=== ステップ3: 代替案を示す（대안 제시하기） ===

「代替案として、キューベースの非同期処理を組み合わせることで、
 スケーラビリティを確保しつつ、構成のシンプルさも
 維持できるのではないかと考えたのですが、いかがでしょうか。」
(대안으로서, 큐 기반 비동기 처리를 결합함으로써,
 확장성을 확보하면서 구성의 심플함도
 유지할 수 있지 않을까 생각했는데, 어떨까요.)

【トレードオフを整理して提示する対話例】

佐藤（リーダー）：「では、メッセージキューの選定について
                  議論したいと思います。現在、RabbitMQと
                  Kafkaの2つの候補がありますが、
                  それぞれのトレードオフを整理しましょう。」

金（レビュアー）：「はい。私のほうで比較表をまとめてみました。
                 RabbitMQはメッセージの順序保証とルーティングの
                 柔軟性に優れていますが、大量データの
                 スループットではKafkaに劣ります。
                 一方、Kafkaはスループットとスケーラビリティに
                 優れていますが、メッセージの順序保証が
                 パーティション単位に限定されます。」
                (네. 제 쪽에서 비교표를 정리해 봤습니다.
                 RabbitMQ는 메시지 순서 보장과 라우팅
                 유연성이 뛰어나지만, 대량 데이터
                 스루풋에서는 Kafka에 뒤집니다.
                 한편, Kafka는 스루풋과 확장성이
                 뛰어나지만, 메시지 순서 보장이
                 파티션 단위로 한정됩니다.)

田中（アーキテクト）：「なるほど。我々のユースケースを考えると、
                     1日あたりの処理件数はどのくらいを
                     想定されていますか。」

金：「現時点では1日約100万件ですが、来年度には
    500万件まで増加する見込みです。」

田中：「そうしますと、将来のスケーラビリティを
      優先すべきではないかと思いますが、
      順序保証が必要な決済処理については
      どのように対応されるお考えですか。」

金：「決済処理についてはKafkaのパーティションキーを
    ユーザーIDにすることで、ユーザー単位での
    順序保証は担保できると考えております。
    ただし、この方式ではパーティション間の
    順序は保証されませんので、その点は
    トレードオフとして許容できるかどうか、
    ご判断をいただきたいと思います。」
    (결제 처리에 대해서는 Kafka 파티션 키를
     유저 ID로 하는 것으로, 유저 단위의
     순서 보장은 담보할 수 있다고 생각합니다.
     다만, 이 방식에서는 파티션 간의
     순서는 보장되지 않으므로, 그 점은
     트레이드오프로서 허용 가능한지,
     판단을 부탁드리고 싶습니다.)

佐藤：「わかりました。では、Kafkaを基本方針として、
      決済処理の順序保証はパーティションキー方式で
      対応する、という方向で合意を取りたいと思います。
      他にご意見はございますか。」

【合意に至らない場合の対処表現】

◆ 보류 제안
「この件については、もう少し検討が必要だと思いますので、
 次回のレビューまでに両案の比較検証を行った上で
 改めて議論するのはいかがでしょうか。」
(이 건에 대해서는 좀 더 검토가 필요하다고 생각되므로,
 다음 리뷰까지 양안의 비교 검증을 수행한 후
 다시 논의하는 것은 어떨까요.)

◆ 에스컬레이션 제안
「技術的な判断が分かれていますので、
 アーキテクトの山田さんにもご意見を
 伺ったほうがよいのではないでしょうか。」
(기술적 판단이 나뉘어 있으므로,
 아키텍트 야마다씨에게도 의견을
 여쭤보는 것이 좋지 않을까요.)

◆ 프로토타입 제안
「口頭での議論だけでは判断が難しいと思いますので、
 プロトタイプを作って実際に検証してみるのは
 いかがでしょうか。来週金曜日までに結果を
 共有できるかと思います。」
(구두 논의만으로는 판단이 어려울 것 같으므로,
 프로토타입을 만들어 실제로 검증해 보는 것은
 어떨까요. 다음 주 금요일까지 결과를
 공유할 수 있을 것 같습니다.)

◆ 다수결이 아닌 납득 기반 결정
「全員のご意見を踏まえた上で、
 最終的にはプロジェクトリーダーの
 ご判断をお願いできればと思います。」
(전원의 의견을 감안한 후,
 최종적으로는 프로젝트 리더의
 판단을 부탁드리면 하고 생각합니다.)

【気まずい場面とリカバリー例】

=== 시나리오: 설계자의 핵심 방침을 강하게 부정한 후 분위기가 경직 ===

（雰囲気が固くなった後…）

金：「すみません、先ほどの発言は少し言葉が
    足りなかったかもしれません。
    佐藤さんの設計のコンセプト自体には
    賛同しておりまして、ただ実装面での
    リスクが少し気になったもので、
    うまく伝えられず申し訳ありません。」
    (죄송합니다, 방금 발언은 좀 말이
     부족했을지 모르겠습니다.
     사토씨 설계의 콘셉트 자체에는
     찬동하고 있으며, 다만 구현 측면의
     리스크가 좀 신경 쓰여서,
     잘 전달하지 못해 죄송합니다.)

佐藤：「いえ、大丈夫です。具体的にどの部分が
      気になりましたか。」

金：「ありがとうございます。具体的には、
    データベースの書き込み負荷が集中した場合の
    ボトルネックについてです。もし可能であれば、
    書き込みの分散方式についてもう少し
    議論させていただければと思います。」
    (감사합니다. 구체적으로는,
     데이터베이스의 쓰기 부하가 집중된 경우의
     병목에 대해서입니다. 가능하다면,
     쓰기 분산 방식에 대해 좀 더
     논의할 수 있으면 합니다.)

---

=== 시나리오: 잘못된 기술 정보를 말한 것을 깨달았을 때 ===

金：「すみません、先ほどの発言を訂正させてください。
    KafkaのConsumer Groupの仕組みについて、
    私の理解が不正確だったかもしれません。
    確認した上で改めてご報告いたします。」
    (죄송합니다, 방금 발언을 정정하겠습니다.
     Kafka Consumer Group 구조에 대해
     제 이해가 정확하지 않았을 수 있습니다.
     확인 후 다시 보고드리겠습니다.)

【設計レビュー議事録テンプレート】

======================================
設計レビュー議事録
======================================

■ 基本情報
・会議名　：決済システム基本設計レビュー（第2回）
・日時　　：2026年3月8日（日）14:00～16:00
・場所　　：会議室A（オンライン併用）
・参加者　：佐藤（リーダー）、田中（アーキテクト）、
　　　　　　金（バックエンド）、鈴木（インフラ）、
　　　　　　山田（QA）
・書記　　：金
・配布資料：決済システム基本設計書 v2.1

■ アジェンダ
1. 前回指摘事項の対応状況確認
2. メッセージキュー方式の選定
3. データベース構成の見直し
4. 非機能要件の目標値設定

■ 決定事項
1. メッセージキューはKafkaを採用する
   ・理由：将来的なスケーラビリティを最優先とする
   ・条件：決済処理の順序保証はパーティションキー方式で対応
   ・担当：金（詳細設計書への反映、3/15まで）

2. データベースはリードレプリカ構成とする
   ・理由：読み取り負荷の分散が必要と判断
   ・条件：フェイルオーバー手順を別途策定すること
   ・担当：鈴木（インフラ設計書への反映、3/15まで）

■ 継続検討事項
1. キャッシュ戦略（RedisかMemcachedか）
   → 次回レビューまでにベンチマーク結果を準備
     （担当：金、期限：3/14）

2. ログ集約基盤の選定
   → 田中アーキテクトが別途検討会を設定
     （期限：3/12までに日程調整）

■ 指摘事項一覧
No.1 ：API Gateway のレート制限が未定義
       → 要件定義フェーズで確認が必要（担当：佐藤）
No.2 ：障害時の縮退運転方針が不明確
       → 詳細設計フェーズで具体化（担当：金）

■ 次回レビュー予定
・日時：2026年3月22日（日）14:00～16:00
・内容：詳細設計レビュー（第1回）
・準備物：詳細設計書 v1.0、ベンチマーク結果

以上

【レビュー後のフォローアップメール】

件名：【設計レビュー議事録】決済システム基本設計レビュー（第2回）3/8実施分

関係者各位

お疲れ様です。金です。

本日の設計レビューにご参加いただき、
ありがとうございました。

議事録を作成いたしましたので、
添付ファイルをご確認ください。

決定事項および担当・期限を以下にまとめます。

【決定事項】
1. メッセージキュー：Kafka採用
   → 担当：金（設計書反映 3/15まで）
2. DB構成：リードレプリカ方式
   → 担当：鈴木（設計書反映 3/15まで）

【継続検討事項】
1. キャッシュ戦略のベンチマーク
   → 担当：金（3/14まで）
2. ログ集約基盤の検討会日程調整
   → 担当：田中（3/12まで）

内容に相違がございましたら、
3月10日（火）までにご連絡ください。

次回レビューは3月22日（日）14:00からを
予定しております。

引き続きよろしくお願いいたします。

金 英柱

【認証システムアーキテクチャ設計レビュー ロールプレイ】

=== 参加者 ===
・佐藤（プロジェクトリーダー、進行役）
・金（レビュイー、設計担当）
・田中（シニアアーキテクト、レビュアー）
・鈴木（セキュリティ担当、レビュアー）

=== レビュー開始 ===

佐藤：「それでは、認証システムのアーキテクチャ設計レビューを
      始めます。金さん、ご説明をお願いします。」

金：「はい。本日は認証システムの基本設計について
    ご説明いたします。認証方式としてはJWT＋OAuth2.0を
    採用し、トークン管理にはRedisを使用する構成です。
    まず全体のシーケンスからご説明させてください。」
    (네. 오늘은 인증 시스템의 기본 설계에 대해
     설명드리겠습니다. 인증 방식으로는 JWT+OAuth2.0을
     채용하고, 토큰 관리에는 Redis를 사용하는 구성입니다.
     우선 전체 시퀀스부터 설명드리겠습니다.)

（10分間の説明後）

田中：「ご説明ありがとうございます。一点確認させてください。
      リフレッシュトークンの有効期限はどのように
      設定されていますか。」

金：「リフレッシュトークンの有効期限は30日に
    設定しております。アクセストークンは15分です。」

鈴木：「セキュリティの観点から少し気になる点がありまして、
      リフレッシュトークンの30日は、我々の取り扱う
      データの機密性を考えると、少し長いのではないかと
      感じています。業界標準では7日から14日が
      多いように思いますが、30日にされた
      背景をお聞かせいただけますか。」
      (보안 관점에서 좀 신경 쓰이는 점이 있는데,
       리프레시 토큰 30일은 우리가 다루는
       데이터의 기밀성을 고려하면 좀 긴 것이 아닌가
       생각합니다. 업계 표준에서는 7일에서 14일이
       많은 것으로 보이는데, 30일로 하신
       배경을 알려주시겠습니까.)

金：「ご指摘ありがとうございます。30日にした理由は、
    ユーザーの利便性を優先したためです。ただ、
    おっしゃる通り、セキュリティとのバランスを
    考えると、14日に短縮した上で、
    リフレッシュトークンローテーションを
    導入するのが良いかもしれません。」
    (지적 감사합니다. 30일로 한 이유는
     사용자 편의성을 우선했기 때문입니다. 다만,
     말씀하신 대로 보안과의 밸런스를
     생각하면, 14일로 단축한 후,
     리프레시 토큰 로테이션을
     도입하는 것이 좋을 수도 있겠습니다.)

田中：「リフレッシュトークンローテーションは
      良い案だと思います。実装コストも
      それほど高くないですし、セキュリティと
      利便性のバランスが取れますね。」

佐藤：「では、この点については、リフレッシュトークンの
      有効期限を14日に変更し、ローテーション方式を
      導入するということで合意としてよろしいですか。」

全員：「異議ありません。」

佐藤：「ありがとうございます。では続けて、
      他に気になる点はございますか。」

田中：「もう一つよろしいでしょうか。JWTのペイロードに
      含める情報について確認したいのですが、
      個人情報は含まれていませんか。JWTはBase64で
      エンコードされているだけで、暗号化されていないので、
      機微な情報を含めるのはリスクがあります。」
      (하나 더 괜찮을까요. JWT 페이로드에
       포함하는 정보에 대해 확인하고 싶은데,
       개인정보는 포함되어 있지 않습니까. JWT는 Base64로
       인코딩되어 있을 뿐 암호화되지 않으므로,
       민감한 정보를 포함하는 것은 리스크가 있습니다.)

金：「はい、その点は考慮しておりまして、JWTペイロードには
    ユーザーIDとロール情報のみを含めています。
    氏名やメールアドレスなどの個人情報は
    含めない方針です。」

田中：「承知しました。それであれば問題ないと思います。」

佐藤：「他にご意見がなければ、本日のレビューは以上と
      したいと思います。金さん、議事録の作成を
      お願いできますか。」

金：「はい、承知いたしました。明日中に議事録を
    共有いたします。」
    (네, 알겠습니다. 내일 안으로 의사록을
     공유하겠습니다.)

佐藤：「ありがとうございました。お疲れ様でした。」