レッスン6:API仕様の整合性 敬語までした

 

ロイックさんはフロントエンドエンジニアとして、フロントエンド側の要求(UIの挙動)とバックエンド側の制約(データベースやAPIの構造)の間に生じる不整合を解決するため、バックエンドチームと調整・交渉する場面を想定します。


1. 語彙

語彙 読み方 意味 例文(英訳併記)
連携
=コラボ
れんけい 目的を達成するために、協力して物事を行うこと。 リアルタイムでデータを表示するため、バックエンドチームとの密な連携が不可欠です。
(Close collaboration with the back-end team is essential for displaying data in real-time.)

データベース同士の連携が上手くいかず、原因究明に時間がかかった。

Investigate究明きゅうめい

ルイヴィトンとJR西日本との連携で出来たグッズは急に人気になりました。

不整合 ふせいごう 複数の事柄の間で、つじつまが合っていないこと。 APIのレスポンス形式に不整合が見つかったので、画面表示が崩れてしまいました。
(An inconsistency was found in the API response format, causing the screen display to break.)

彼の言う事とやる事の間には不整合がある。

このドラマでは、シーズン1とシーズン2の話が整合してたのに、シーズン3になると筋に大きな不整合が出ましたので、ファンの皆さんが怒っています。

定義 ていぎ はっきりと定めること。 新しいエンドポイントを追加する前に、データ型の定義を明確にする必要があります。
(Before adding a new endpoint, it is necessary to clarify the definition of data types.)

中学生の時、数学の証明問題で定義を覚えるのが苦手だった。When I was in middle school, I had trouble memorizing definitions for math proof problems.

プログラムを一気に書きましたが、ランした時、変数が不定義のエラーが発生しました。

同期 どうき 複数のものが同じタイミングで動作・一致すること。 フロントとバックエンドで開発スケジュールを同期させ、効率的に進めます。
(We will synchronize the front-end and back-end development schedules to proceed efficiently.)

いくつかのデータベースを連結したつもりだったが、同期が取れていなかった。
I thought I had linked several databases, but they weren’t synchronized.

映画で軍人達が作戦をはじめるまえに腕時計を同期しました。

折衝

交渉

せっしょう

こうしょう

利害が一致しない相手と話し合って、解決策を見出すこと。It involves compromise.
They clash, and then they are sublimated.

I try to make them understand.

インフラコストとUIの利便性の間で、バックエンド担当者と折衝を重ねました。
(I had repeated negotiations with the back-end staff between infrastructure costs and UI convenience.)

隣の家とどこが土地の境界線なのか、折衝して、やっと境界が決まったので、塀が作れる。After negotiating with the neighbor to determine the property boundary, we finally decided on the boundary line, so we can now build the fence.

今年は上司との個人面談で、一年分の成果を材料に折衝し、給料を上げてもらいました。


2. 文法

文法 読み方 意味 例文(英訳併記)
~に則って ~にのっとって 基準や手順、規則に従って。 当初合意したAPI仕様書に則って、フロントエンドの実装を進めております。
(We are proceeding with the front-end implementation in accordance with the initially agreed API specification.)

憲法に則って、法律を作る。Laws are made in accordance with the Constitution.

最近の健康状態と事故件数に則って、バス会社がこのドライバーを雇うべきじゃなかった。

~ないまでも ~ないまでも ~という高いレベルには達しなくても、せめて~。 リアルタイムではないまでも、数秒おきにデータを自動更新したいと考えています。
(Even if it’s not in real-time, I’d like to automatically update the data every few seconds.)

アイスクリームを食べたいと言わないまでも、冷たい水ぐらいは飲みたい。

お祝いの時は、高級神戸牛を食べないまでも、寿司ぐらいは食べます。

~に至っては ~にいたっては ~という極端な例になると(さらにひどい状態)。 画面の読み込みに10秒、検索に至っては30秒以上かかる現状は改善すべきです。
(The current situation, where it takes 10 seconds to load a screen and more than 30 seconds for a search, should be improved.)

体重が100キロになるに至っては、なるべく健康診断に行ったほうが良い。

台風が来ると、一週間、フェリーが来れなくてゴールデンウィークの間にガソリンスタンドが閉まるに至っては、島で生活するには準備が大事だということが分かった。

~を禁じ得ない ~をきんじえない (感情を)抑えることができない。 このまま仕様が決まらないことへの焦りを禁じ得ません。
(I cannot help but feel impatient about the specifications not being decided yet.)

この映画を見ると、登場人物が可哀そうで、涙を禁じえない。

彼女は空港にBTSを迎えに行ったら、握手ができて、ドキドキを禁じえなかった。

~んがために ~んがために ~という目的を果たすために(強い意志)。 ユーザーのストレスを最小限に抑えんがために、APIのレスポンス速度向上を提案します。
(In order to minimize user stress, I propose improving the API response speed.)

無人島で生きんがために、普段だったら、食べないようなヘビとか昆虫を食べて、生き延びた。

定年後の生活をせんがために、
毎週宝くじを五万円分買います。


3. 敬語

敬語 読み方 意味 種類 例文(英訳併記)
ご教示ください ごきょうじください 教えてほしい。 尊敬語/丁寧語 現在のDB構造で、このデータの抽出が可能かどうかご教示ください。
(Please guide me on whether it is possible to extract this data with the current DB structure.)
左様でございますか さようでございますか 「そうですか」の非常に丁寧な表現。 丁寧語 左様でございますか。バックエンド側の制約については承知いたしました。
(Is that so? I understand the constraints on the back-end side.)
拝察いたします はいさついたします 「(心中を)お察しします」の謙譲語。 謙譲語 大規模な改修がサーバー負荷に与える懸念は、重々拝察いたします。
(I deeply sympathize with the concerns regarding the impact of large-scale repairs on server load.)
伺う うかがう 「聞く・尋ねる」の謙譲語。 謙譲語 実装上の懸念点について、バックエンドチームのご意見を伺いたく存じます。
(I would like to hear the opinions of the back-end team regarding implementation concerns.)
仰せの通り おおせのとおり 「おっしゃる通り」の非常に丁寧な表現。 尊敬語 リードエンジニアの仰せの通り、データの不整合を防ぐためのバリデーションを追加します。
(Just as the lead engineer said, I will add validation to prevent data inconsistency.)

4. 会話

パターン1:社内会議(バックエンドチームとのAPI仕様調整)

ロイック: お疲れ様です。新しい患者モニタリング画面の実装に際して、APIの仕様について相談させてください。

(Good job, everyone. Regarding the implementation of the new patient monitoring screen, I’d like to consult with you about the API specifications.)

バックエンド担当者: はい。今のところ、既存のエンドポイントを使ってもらう予定ですが、何か問題はありますか?

(Yes. Currently, we plan to have you use the existing endpoint, but are there any issues?)

ロイック: 既存のものでは、必要な項目が網羅されていません。具体的には、血圧の履歴データが不足しており、UIでの可視化に支障をきたしています。

(The existing one does not cover the necessary items. Specifically, blood pressure history data is lacking, which is hindering visualization in the UI.)

バックエンド担当者: なるほど。しかし、履歴をすべて出すとサーバーの負荷が上がり、パフォーマンスが落ちかねません。

(I see. However, if we output all the history, the server load will increase, and performance could drop.)

ロイック: 負荷への懸念は拝察いたします。ですが、正確な診断を下さんがために、過去24時間分のデータは必須だと考えております。

(I sympathize with the concerns about the load. However, in order to make an accurate diagnosis, I believe that data for the past 24 hours is essential.)

バックエンド担当者: 左様でございますか。では、取得期間を制限するパラメータを追加する方向で検討しましょう。

(Is that so? Then, let’s consider adding a parameter to limit the acquisition period.)

ロイック: ありがとうございます。不整合を防がんがために、修正後のスキーマをご教示いただけますでしょうか。

(Thank you. In order to prevent inconsistencies, could you please provide the revised schema?)

パターン2:日常生活(仕事後の雑談)

同僚: ロイックさん、さっきの会議での折衝、お疲れ様でした。大変そうでしたね。

(Loic, good job on the negotiations in the meeting earlier. It looked tough.)

ロイック: ええ。異なる部署間での連携は、技術的な問題はおろか、コミュニケーションの難しさを禁じ得ません。

(Yes. Collaboration between different departments cannot help but be difficult in terms of communication, let alone technical issues.)

同僚: 本当ですね。でも、ロイックさんが粘り強く交渉したおかげで、いい着地点が見つかったと思いますよ。

(That’s true. But thanks to your persistent negotiations, I think a good middle ground was found.)

ロイック: ありがとうございます。お互いの制約を拝察しつつ、より良いものを作らんがために努力するのは、やりがいがありますね。

(Thank you. It is rewarding to strive to create something better while sympathizing with each other’s constraints.)

同僚: さて、今日はもう上がりですか?

(So, are you finishing for the day now?)

ロイック: はい。今日はサイクリング仲間とベジタリアン料理を食べに行く予定なんです。

(Yes. I’m planning to go eat vegetarian food with my cycling friends today.)

同僚: いいですね!楽しんできてください。

(That’s nice! Have a great time.)