はてなブックマーク

「奥野さんと社員のリファクタリング部屋」は、リファクタリングに励むトレタの社員と技術顧問の奥野さん ( @okunokentaro ) の間で実際に行われた会話を切り取った開発現場実録コンテンツです。 技術顧問: 奥野さん 三度の飯よりリファクタリングが好き 今回の質問者: 武市さん トレタ在籍2年。沖縄在住のフロントエンジニア 今回の質問 前回に引き続き、Webアプリケーション (Next.js) のプロダクトのリファクタリングを進めている武市さんから、ディレクトリ構造のリファクタリングについての質問です。 tech.toreta.in 前回の指摘も踏まえて、新しいディレクトリ構造とその定義を考えてきました。 ┗ server ┃ ┣ boundary -- 外部システムとのやり取りを行うためのエンドポイント。 ┃ ┃ ┗ mo ┃ ┃ ┃ ┗ moClient.ts ┃ ┣ handl

こんにちは。トレタ技術顧問の奥野 (@okunokentaro) です。先日のブログ記事『奥野さんと社員のリファクタリング部屋　-リポジトリ層のディレクトリをどう作る？-』に対して多くの反響をいただき、ありがとうございます。いただいたご意見やご質問の一つひとつが非常に貴重であり、大変感謝しています。 いくつか個別に質問をいただくことがあったのですが、それらの質問を要約すると「リファクタリング後のコードもまだツッコミどころだらけでは？」や「リポジトリ層という名前がまずおかしいのでは？」という二つの点に集約されました。これらの質問はとても理解できます。今回の記事では、具体的な個別の質問への個別の回答は控えさせていただきますが、全体的な方針とテーマについてお伝えした上で、トレタが取り組んでいるリファクタリングは何を目指しているのかというお話をします。 前提と目的 今回のブログ記事『リファクタリン

「奥野さんと社員のリファクタリング部屋」は、リファクタリングに励むトレタの社員と技術顧問の奥野さん ( @okunokentaro ) の間で実際に行われた会話を切り取った開発現場実録コンテンツです。 技術顧問: 奥野さん 三度の飯よりリファクタリングが好き。 今回の質問者: 武市さん トレタ在籍２年。沖縄在住のフロントエンジニア 今回の質問 今回は初期リリースを終えたWebアプリケーション(Next.js)のプロダクトを担当している武市さんから、複数人で開発を進めてきて統率が取れなくなったディレクトリ構造のリファクタリングについての質問です。 APIで外部とやり取りしている部分をリファクタリングして、クリーンアーキテクチャに沿ってリポジトリを作ろうと考えています。 その中で、GraphQL APIレスポンスの結果を変換するアダプター関数(adaptGetIServiceItemsAggr

こんにちは。トレタ VPoEの北川です。 先日、「優先順位が口癖になる危機感」という記事を見かけました。 まさに自分が普段行っていることで同様の危機感を抱えていたたので、非常にささる内容でした。 jinjor-labo.hatenablog.com 要約すると、 優先度の高いタスクだけをやっていると、優先度の低いタスクを着手する時期は一生訪れない 実装したい機能の最優先部分だけを小さくリリースした場合、残りの機能は実装されず常に及第点の品質となる 及第点を取ることを目標として常態化してしまうとUXや内部品質が低下し続ける 自分が携わっているプロダクトもtoBのWebアプリケーションなので、普段のプロセスにとてもあてはまります。 本来の機能をすべて実装するにはリリースが数ヶ月先になってしまうが、要望を貰っている顧客向けであれば最小限の部分が実装できた段階で、制約や制限があったとしても説明した

こんにちは、VPoEの北川です。 今回はトレタで現在使用している技術スタックについて紹介します。 創業時から稼働している予約・顧客台帳サービス「トレタ」から現在の注力事業のモバイルオーダーサービス「トレタO/X」までをあらためて振り返ってみると、まるで異なる技術スタックになっているので歴史的な背景などを辿りながら紹介していきます。 技術スタックの変遷 予約・顧客台帳「トレタ」 会社名にもなっている予約・顧客台帳の「トレタ」は創業当時から稼働している築11年ほどのシステムです。 サーバーサイドにはRubyとRubyOnRailsで作られた巨大なコードベースのAPIサーバーがあり、予約台帳のiOSアプリやウェブ予約などのWebアプリケーションなどが利用しています。 長年このモノリシックなシステムを成長させてきたので、以前からトレタを知ってくださっている人にはトレタはRubyの会社と認知されてい

こんにちは、トレタ VPoEの北川です。 先日VPoEに就任したご報告をしましたが、あわせて開発組織内のコアバリューを新しくしました。 この記事ではその新しいコアバリューについて書こうと思います。 tech.toreta.in 新しいコアバリュー 「短く速く作り出そう。遠いゴールを目指して飛び込もう。(Dash & Dive)」 トレタの会社全体のビジョンやミッション、行動指針などはありますが、その中でも現時点での開発組織としての重心としたい要素をこの言葉にまとめました。 盛り込みたい要素はいろいろとありましたが、なるべく短い言葉にしたかったのでそこに込めた背景を説明していきます。 短距離走ではなく長距離走でもなく、短距離走の連続 トレタはベンチャー企業である以上、短期間での開発＆リリースが求められるプロジェクトは少なくないです。 新規プロダクトを2ヶ月で作り上げてリリースする等、ユーザー

こちらはトレタAdventCalendar2023 10日目の記事です。 こんにちは、株式会社トレタでモバイルオーダーアプリ・トレタO/Xのプロダクトマネージャーをしている北川です。 toreta.in 年月はあっという間に過ぎ去るもので、プロダクトマネージャーという肩書きをいただいてからもうすぐ2年が経ちます。 手探りで始めたプロダクトマネジメント業務も少しは板についてきたと思うので、この記事では自分がトレタで行なっているプロダクトマネジメントの仕事についてまとめようと思います。 他のプロダクトマネージャーやトレタでの開発プロセスに興味のある方の参考になれば幸いです。 プロダクトマネジメントとは まず「プロダクトマネジメント」という定義は一般的にも曖昧です。プロダクトマネジメントの定義はプロダクトマネージャーの数だけある、ということが「プロダクトマネージャーのしごと」という本にも示されて

はじめに こんにちは、サーバーサイドエンジニアの @shiroemons です。 プルリクエストにDBスキーマの変更が含まれた場合、ER図を自動生成するために、tblsとGitHub Actionsを組み合わせた設定を行いました。 DBスキーマの変更は開発プロセスにおいて頻繁に発生しますが、手動でER図やドキュメントを更新することは煩雑で効率が悪い作業です。 そこで、GitHub Actionsとtblsを使用することで、ER図の自動生成と更新を容易に実現できました。 今回は、設定したGitHub Actionsの設定ファイルを紹介します。 必要なツールと環境 今回紹介するツールと環境はこちらです。 CI: GitHub Actions DB: PostgreSQL マイグレーションツール: psqldef テーブル定義書作成: tbls tbls について github.com tbls

この記事はトレタ Advent Calendar 2022の15日目の記事です。 はじめに こんにちは、サーバーサイドエンジニアの @shiroemons です。 前回の記事に書いた通り、認定資格を取得してからGoogle Cloudを頻繁に活用するようになりました。 tech.toreta.in 現在のプロジェクトでは、Cloud Buildを用いてdocker buildやCloud Runへのデプロイを行っています。 また、データベース（Cloud SQL）へのマイグレーションもCloud Buildから行っています。 今回は、Cloud Buildからpsqldefというマイグレーションツールを使用して、Cloud SQL for PostgreSQLにマイグレーションする方法を紹介します。 ただし、Cloud SQL for PostgreSQLなどの設定は完了している前提のため

こんにちは、トレタのモバイルオーダー事業でプロダクトマネージャーを行なっている北川です。 こちらはトレタアドベントカレンダー2日目の記事です。この記事では2022年の振り返りとして、今年の前半に取り組んだモバイルオーダー・トレタO/Xでの決済トラブルについてどう対応していったのかを記そうと思います。 toreta.in 決済でのトラブルというのは基本的に起こしてはならないものであり、それを記事にすることは憚られましたが、自分が苦闘しているなかで同様に決済への試みをしている記事を大いに参考にさせていただいたので、自分も誰かの助けになればと思いこの記事を公開します。 あらためて、導入店の飲食店様と来店してご利用いただいていたお客様には、多大なご迷惑をおかけしたことをこの場を借りてお詫び申し上げます。 トレタO/Xの決済の概要 まずはトレタO/Xでの決済について説明します。 トレタO/Xでは店員

はじめに この記事はトレタ Advent Calendar 2021の15日目の記事です。 こんにちは、iOSエンジニアのarisaです。 本日は、Flutterのテストを書いたはなしです。 弊社のトレタO/Xでは、大きく分けて２つのプロダクトがあります。 お店のスタッフさんが使う画面と、お店に来たお客さんが使う画面です。 そのうち、お店のスタッフさんが使う方のアプリでは、Flutterを採用しています。 今回私がテストを実装したのは、そんなお店のスタッフさん用のtoBアプリです。 やったこと とても簡単なユニットテストから実装し始めました。 Intから「〇〇円」というString表示に変換するextensionを例とします。 extension OxInt on int { String formatYen() { final numberFormat = NumberFormat('#

この記事は、トレタのアドベントカレンダー2021の14日目の記事です。 。。。いや、なんぼはあると管理的な意味で困っちゃいますね。 みなさん、ドキュメント作ってますか？こんにちは。トレタでQAをしている福富です。 普段は（こないだプレスリリースも出た）デジタル塚田農場プロジェクトのO/Xの方でQAをしています。 （プレスリリースはこちら、O/Xについてはこちらをご参照ください！） こちらのプロジェクト、自分はキックオフから関わってきまして、たくさんのドキュメントをまとめてきました。 スピードが重要視されるプロジェクトにおいてドキュメントをいっぱい作るのは大変ですし、管理も辛いです。 でも、作ってきたドキュメントに助けられることも多々ありました。 今回は、自分がドキュメントをまとめる目的ならびに気をつけていること、実際にどんなドキュメントを作っているのかを紹介してみたいと思います。 なぜドキ

はじめに こんにちは、Half-Vaccinatedなフロントエンドエンジニアのkitagawaです。接種2回目にビビりながら今から備えています。 この度トレタの新しいサービスとして、トレタO/X(トレタオーエックス)が正式リリースされました。O/Xは「Order Experience(注文体験)」の略で、飲食店に来店したお客様がご自身のスマートフォンで注文から決済までを行えるモバイルオーダーアプリです。 サービスの本格立ち上げから今回のリリースまで、約1年ほど主にバックエンドのマネジメントに携わってきたので、その振り返りとして開発内で行った数々の挑戦について、この記事では紹介しようと思います。 サービスの詳細や背景については代表のひとしさんのブログをぜひご一読ください。 トレタO/Xの特徴 タブレット据置機でのオーダーや、テイクアウトのモバイルオーダーなど、オーダーアプリを目にする機会は

この記事はトレタ Advent Calendar 2020の22日目の記事です。 はじめまして。2020年3月からJOINしたサーバーサイドエンジニアをしている @shiroemons です。 Appleから AirPods Max が発表されて、SonyのWH-1000XM4を即購入して、ノイズキャンセリング機能と2台の機器に同時接続できるマルチポイント機能に感動している今日このごろです。 マイク性能に関しては、手持ちのAirPodsの方が良さそうなので、ビデオ会議の時は切り替えが必要なのが残念ポイントでした... 本日は、私がトレタにJOINして、勉強になったRailsに関する3つを紹介します。 config/routes.rb のファイル分割 1つ目は、巨大になりがちなルートファイル(config/routes.rb)を複数のファイルに分割するTipsです。 ↓でconfig/rou

こんにちは、iOSエンジニアの高です。 みなさん、製品開発してますか？うまくいってますか？ 開発しているとうまくいくこともあれば、残念ながら失敗してしまうこともあると思います。 開発自体がうまく進まないこともありますし、開発は順調なんだけれど、リリースしてみると誰も使ってくれないみたいなこともありますよね。 今日は、プロダクトマネージャの教科書である「INSPIRED」から、こういった失敗をいかに防ぐか、という内容を紹介したいと思います。 個人的に本書で一番大事なんじゃないかと思えた部分です。 それは、PART Ⅰ CHAPTER6にある「製品開発が失敗する根本的原因」です。 結構序盤にあるのですが、かなり大事なことが書かれています。 これを初めて読んだ時、 うわっ、分かる！あるある！ と、首がもげるくらいうなずきながら読んでいました。 僕たちが製品を開発する目的は何でしょう。 アプリを作

＊この記事は トレタ Advent Calendar 2020 の７日目の記事です。 こんにちは。トレタでサーバーサイドエンジニアをしている川村です。 この記事では自分の学習も兼ねてHTTP/3についてまとめたいと思います。 このテーマにしたきっかけと記事の目標 先月「QUICとHTTP/3がIETFのラストコール。RFCによる標準化が間近に」という記事を見て、「規格策定してることはなんとなく知ってたけど全然気にしてなかったな」と思っていたものの、全く調べてなかったのでこれを機に調べてみようとこのテーマにしました。 という入りなので、データ構造やシーケンスのような細かいレベルの話はでてきません。※細かい所は参考のリンク先を辿っていただけると見つかるかと思います この記事ではHTTP/3で何がどう変わって何が良くなるのかを把握することを目標にします。 HTTP/3の背景 HTTP/3はQUI

本記事はトレタアドベントカレンダーの6日目の記事です。 始めに 皆さま、こんにちは！ 『劇場版ヴァイオレット・エヴァーガーデン』で映画館にいる誰よりも号泣していたトレタのエンジニア兼北条加蓮ちゃんのプロデューサーの@hiroki_tanakaです。 先日、API Gateway~Lambda構成のサーバレスシステムをterraform+Lambrollで構築しました。 本記事ではterraformを用いてのAPI Gatewayの構築とAPI Keyでの認証設定に関してお話します。 ※Lambrollに関しては昨日投稿された下記の記事を参考にしてください(o*｡_｡)oﾍﾟｺｯ tech.toreta.in システム構成 今回は下記のサーバレスアーキテクチャの基本型のようなシステム構成です。 アプリケーションからAPI Gatewayをキックして、キックしたパスに応じて対応するLambda

Advent Calendar 2020 の 4 日目の記事です。 こんにちは、 wind-up-bird です。 前回に引き続き、ECS移行について書いていきたいと思います。 前編: 移行前の構成や課題、移行方針を記載しています。 後編: 移行後の構成や旧環境との変更点を記載しています。 ※前編をまだ読んでない人は是非チェックしてみてね！ 目次 目次 新環境 全体構成 詳細 AWS のリソース管理 デプロイ ロギング 移行作業 振り返り Build 時間の短縮 EC2とOSの管理から開放された 起動時間と費用 ハマった点など 設定ファイルの管理 ECS 標準デプロイアクション 16kB のログチャンクサイズ 最後に お決まり 新環境 この章では、ECS移行後の構成やデプロイ方法、移行方法を紹介していきたいと思います。 全体構成 全体的な構成は以下のようなイメージです。 1 つの ECS

はじめに 皆様、こんにちは！ 『あつまれ どうぶつの森』でゴリラの住民ばかりが島に集まるトレタのサーバサイドエンジニア兼佐久間まゆちゃんのプロデューサーの@hiroki_tanakaです。 現在、私が携わっているプロダクトでAlgoliaという高速検索APIを使用しています。 今回はAlgoliaとは何か?から実際に使用してみて感じたことをご紹介します！ そもそもAlgoliaとは？ 高速な全文検索APIサービスのSaaS。 公式サイト 一番の売りは検索速度の圧倒的な速さ。 公式が出しているデモサイトもあり、試してみることが可能です。 Algolia内にJSON 形式でデータを保持し、その中で検索を行います。 検索可能にする属性や検索順の重み付け設定はGUIから柔軟に行うことが出来ます。 RubyやPHP Java Go Scale Swiftなどの様々な言語向けにAPIを提供しています。

始めに 皆さま、こんにちは！ トレタのサーバサイドエンジニア兼佐久間まゆちゃんのプロデューサーの@hiroki_tanakaです。 先日、コードレビューに関する議論が社内で巻き起こり、その時話に上がった内容や実際にトレタで行っているコードレビューの取組に関してご紹介します！ コードレビューの目的 そもそも何故、コードレビューが必要なのでしょうか。 前提としてシステム開発は何もしないと下の”あるある”現象に苛まれます。(身に覚えのある人が多いのではないでしょうか。) コピペの横行 動けば良しのコードの乱立 //TODO:後で直す と書かれているコードの散乱 単一責任の原則を無視した巨大クラス・メソッドの発生 ソースコードは継続的にメンテナンスをしないと品質は低下し続けます。 コード品質が低下している状態では、訳の分からないコードや処理を追うのが困難なコードが壁となってちょっとした機能追加や修

SREチームの中村です。2019年は弊社のエンジニア採用はありがたいことに好調で、たくさんのエンジニアに入社していただきました。2018年比で人数としては2倍近くになっています。 2019年のエンジニア採用戦略についてはVP of Engineeringによる以下の記事に詳しく載っていますのでぜひ御覧ください。 tech.toreta.in 一緒にプロダクトを前に進める仲間が増えることは非常に嬉しいことです。しかし、新規メンバーを迎える側である我々が考えておくべき点がいくつかあります。 新しいエンジニアを迎えるときに考えておくこと 弊社が提供するプロダクト群はバーティカルSaaSです。バーティカルSaaSとしてのトレタについては、弊社代表の以下の記事に詳しく載っていますので、詳細はそちらを御覧ください。 note.com バーティカルSaaSは特定の産業の課題に深くフォーカスしなければなり

この記事は トレタ Advent Calendar 2019 12日目*1の記事です。 こんにちは。最近、子供に荷物に買い物かばんにとリアルポーターごっこに腰がつらくなってきた@joy04dです。 前回のAdvent Calendarでこんな事を書いていた自分ですが、その後、今年1月から VP of Engineering の役割を頂いております。まだ1年足らずのひよっこですが、日々頑張ってお仕事しております(=ω=) 今回の記事では、せっかくなのでこの1年の振り返りと知見(あるいはアンチパターン)の共有を兼ねて、つらつらと*2書いてみたいと思います。 どんなことしたか 今年のコンセプトを一言でいうと 個からチームへ になります。 トレタの開発組織では、創業期から 自治 をコンセプトとしており、フラットな組織のなかでエンジニアそれぞれが自身の裁量と責任を持って行動することを大事にしていまし

この記事は トレタ Advent Calendar 2019 の23日目の記事です。 こんにちは。iOS & Androidエンジニアの山口です。 トレタでは、主にトレタnowの開発を行っています。 これまで、UIKit、RxSwift(RxCocoa)を使ったMVVMアーキテクチャで実装することが多かったこともあり、 SwiftUI、Combineを使った場合にはどう書けばよいか考えてみました。 なお、この記事はSwiftUIを使う際に重要なポイントとなる PropertyWrappersやDynamicMemberLookup、それらを利用したObservedObjectやBindingについて の知識がある前提で記述しています。 ViewModel Protocol の定義 早速ですが、コードから説明していきます。 まず、すべてのViewModelが準拠すべきシンプルなProtoco

こんにちは。 サンタ業務を控えているパパiOSエンジニアのkentaroです。 今年実施したトレタ iPad台帳のカラーリファクタリング（v35.0にて対応しました）についてご紹介します。 なぜ行ったのか これは担当デザイナーの言葉をそのまま引用します。 トレタはリリースされてから5年、デザインが大きく変わることはありませんでしたが、機能追加で画面が増えていく過程で、微妙な差の色も含めて120色も使用されていました。 色数が多いと下記のような問題が発生します。 プロダクト内の統一感がない どの色を使用すればいいか考えなくてはいけないので、デザイナーの作業工数がかかる 今回は2つ目の業務効率化をメイン目標にリファクタリングしています。 どう変わったか ホーム画面 キーカラーを少しだけ濃くして白文字の視認性を上げています 予約フロー画面 背景に埋もれがちだったテキストのコントラストを上げて視認

本記事はトレタアドベントカレンダー19日目の記事です。 こんにちは。リングフィットアドベンチャーを2週に1回のペースでプレイしているフロントエンドエンジニアの北川です。 私はトレタのコンタクトセンター事業(以下、トレタCC)のシステム開発全般を担っており、今年は基幹のCTI(電話機)をAmazonConnectへ入れ替えたので、その辺の話を本記事で紹介します。 トレタCCとは トレタCCは、契約している飲食店の電話業務を代行するサービスです。 トレタって予約台帳なのになんでコンタクトセンターやってるの？と聞かれることがありますが、トレタは飲食店を支援することをミッションとしています。店舗にとっての電話業務とは、予約の電話に限らず当日の道案内や落し物の問い合わせなど、予約以外の多種多様な電話も時間問わずにかかってくるとても業務負荷の高いものです。トレタCCではそれらすべての電話を代行し、飲食