はてなブックマーク

これは SMat Advent Calendar 2024 の12/19分の記事です。 こんにちは、株式会社エスマットにてバックエンドを中心に開発をしています、野島といいます。 私は GoF の Strategy パターンが好きでよく使います。弊社では在庫管理プロダクトを提供しており、その中に「マスタデータをファイルアップロードで更新する機能」があります。この機能の実装に Strategy パターンを利用しています。 本記事では Strategy パターンの概要を簡単に説明した後、パターン適用例としてファイルアップロード処理の実装について共有します。 Strategy パターンの概要 Strategyパターンはアルゴリズムをカプセル化して交換可能にします。 Strategy: アリゴリズムに共通するインターフェイスを定義します ConcreteStrategy: Strategy インター

この記事は SMat Advent Calendar 2024 の12月18日分の記事です。 株式会社エスマット エンジニアの中村です。 今回は現在取り組んでいる弊社のサービスの推奨ブラウザに関する話をしていきます。 現状のブラウザ推奨環境 スマートマットクラウドの推奨ブラウザは現在下記のようになっています。 推奨ブラウザ：Google Chrome、Safari、Firefox 非推奨ブラウザ：Internet Explorer、Microsoft Edge これは数年前に決めたものであり、現状の利用環境に合っていない状態にあります。 この推奨ブラウザは当時の利用率や市場動向、想定されるユーザーの利用環境から策定したもので、PCからの利用を考えて設定したものです。（スマホからの利用は想定していません）WEBブラウザのシェア率1位は2016年頃からGoogle Chromeが1位になり、2

これは SMat Advent Calendar 2024 の12/17分の記事です。 弊社では「SmartMat Cloud」というIoT重量計 x SaaSでモノの流れを可視化するサービスを提供しております。最近お客様がスムーズにオンボーディングできるように、スマホのweb appのプロトタイプを作っております。当時のスプリントのゴールは商品の初回登録の時はスマートマットのシリアル番号や製品バーコードを読み取って検索するプロトタイプを狙いました。 バーコードリーダーはnpmのzxing-wasmがデファクトスタンダードでしたがスマートマットのシリアル番号はOptical Character Recognition(OCR)が必要でした。 OCR in the browser OCRはtesseract.jsでしょう？と思いましたが、ocrsというプロジェクトが気になりました。 ocrs

こちらは株式会社エスマットのSMat Advent Calendar 2024 16日目の記事になります。 記事概要 Gormは洗練されたAPIを持つ大変優れたORMなのですが、いろんな関数の引数の型がinterface{}になっており、静的型付きコンパイル言語のライブラリとしてはやや微妙なところがあります。 GormのコードジェネレータであるGenを使うとinterface{}がなくなるらしいので、APIや定義などを確認したいと思います。 基本的なことは書きませんので、公式ドキュメントやほかのかたの記事をご覧ください。 ドキュメント: https://gorm.io/gen/ GoのORM決定版 Genをはじめよう: https://qiita.com/muff1225/items/f660270694f29597df22 作成されるもの スキーマから以下のものが生成されるようです。なお

この記事は SMat Advent Calendar 2024 の12月13日分の記事です。 こんにちは、株式会社エスマットでSREをしているbiosugar0です。 2024年9月、GitHub Copilotの機能を拡張する「GitHub Copilot Extensions」のパブリックβ版が全ユーザー向けに公開されました。 これにより、個人やサードパーティの開発者がVS Codeなどで独自のAIエージェント（以下、エージェント）を開発できるようになりました。 GitHub Copilotは定額で使えるうえに拡張性も追加されたのは嬉しいアップデートですね。 この記事では、Cloudflare WorkersとTypescriptを使って、GitHub Copilot Chatのエージェントを実装する方法を紹介します。Cloudflare Workersを使うことで、サーバー構築のコス

これは SMat Advent Calendar 2024 の12/12分の記事です。 株式会社エスマットでエンジニアをしている potix2です。 私たちの開発環境はこれまでIPアドレスによるアクセス制限を採用していましたが、よりセキュアかつ柔軟なアクセス管理を実現するため、Cloudflare Accessの導入を決定しました。この記事では、その移行プロセス、遭遇した課題、および解決策について詳しく説明します。 なぜCloudflare Accessを導入したのか 従来のIPアドレスに基づくアクセス制限は、その単純さから選ばれていましたが、最近のオフィス移転に伴い、固定IPアドレスの利用が不可能になりました。この変化は、セキュリティとアクセシビリティのバランスを再考させる重要な要因となりました。特に以下のような課題がありました。 固定IPアドレスの喪失：オフィス移転により、以前に利用し

この記事は SMat Advent Calendar 2024 の12月11日分の記事です。 こんにちは。エスマットエンジニアの金尾です。 皆さんはリポジトリパターンでつらい思いをしたことはありますか？　僕はあります。 本記事はそもそもリポジトリパターンとはどういう実装パターンなのかについて検討した内容をまとめたものです。なお文中に出てくるコードはGo言語を前提としています。 リポジトリパターンとは リポジトリパターンとは、ドメインモデルのデータ処理をアプリケーションの他の部分から分離する実装パターンです。 対応するドメインモデルのCRUDや集計のメソッドを提供し、データストレージに関する処理をカプセル化します。 各クライアントは、データストレージのマッピング処理を考えずにUserモデルを利用できる なぜリポジトリパターンを使うのか リポジトリパターンを使うことによって以下のメリットが期待

この記事は SMat Advent Calendar 2024 の12月10日分の記事です。 こんにちは、株式会社エスマットでエンジニアリングマネージャーを担当している仙葉です 前回の記事から期間が空いてしまいましたが、今回も開発生産性を向上させるための取り組み状況をご紹介していきます！ 昨年からの変化 とりあえずFindyTeam+から直近半年の数字持ってきました 全体的に向上していてとてもいい感じ。。。！ 弊社では昨年の段階でレビューやデプロイに関しての課題感はほぼ無くなっており、これ以上無理に数値にこだわっても仕方ないよねという共通認識ができていたので、今年は数値を安定させつつ新しい取り組みを模索する1年だったと思います FindyTeam+さんには引き続きお世話になっており、毎週エンジニア全体で行なっている定例に直近の数値を確認するアジェンダを追加し、そこでアラート検知的な役割で活

この記事は SMat Advent Calendar 2024 の12月9日分の記事です。 はじめに 弊社エスマットの開発チームでは、新規機能の開発においてデザインスプリントを参考にした手順で機能開発に着手しました。オフラインで集まったメンバー7人全員がそれぞれ意見を出すことで様々な視点から解決策や問題点を出すことができ、短期間でプロトタイプを作成することに成功しました。 今まで出なかったような斬新な意見や、試したいアイディアを共有する機会となり、スムーズに開発に着手できた点が非常に有意義でした。 今回のプロセスでは、1日目をオンラインで、2日目をオフラインで実施しました。 1日目 オフラインで集まる前日までに、オンライン会議を通じて以下の内容を共有し、課題に対する理解を深めました。 課題が生じるまでに至った経緯 課題について詳しい人からのヒアリング 現在の状況 疑問を出す 実現したいこと

これは SMat Advent Calendar 2024 の12/6分の記事です。 弊社では「SmartMat Cloud」というIoT重量計 x SaaSでモノの流れを可視化するサービスを提供しております。最近オンボーディング改善のためスマホのweb appを作っております。 はじめに 先日、あいまい検索の機能をプロトタイプ作ってみました。手法は深く考えずに「レーベンシュタイン距離」のベースで作ったが、npm パッケージ(fastest-levenshtein)にもありましたので差し替えしました。しかし、「fastest」ってどれぐらいか気になり、benchmarkのツールを試しずつ、調べてみました。 JSのbenchmarkは現実の現状は何？ Deno 2のリリースノートにはbenchコマンドがあり、mitata 1.0のリリースノートにはオンラインで良い議論が始まっていたので、深く

これは SMat Advent Calendar 2024 の12/5分の記事です。 株式会社エスマット エンジニアの若林です。 弊社では「SmartMat Cloud」というIoT重量計 x SaaSでモノの流れを可視化するサービスを提供しております。弊社で働いているエンジニアはほとんどがWebアプリエンジニアで、組み込み系のソフトエンジニアは現在私しかおらず少し寂しさを感じています。 そこで組み込み系の技術についてWebアプリエンジニアにも触れてもらうために、今回はRTOSに関して記事を書いてみました。同じような会社は他にもあると思うのでIoTを取り扱っているエンジニアの方はぜひご覧ください。 RTOSとは RTOS(Real-Time Operating System)とは、時間的な制約がある処理を実行するための機能や特性を備えたOSのことです。 家電やIoTデバイスなどの組み込み機

これは SMat Advent Calendar 2024 の12/4分の記事です。 弊社技術イベントの宣伝です。 IoTやデータ処理周りに少しでも興味がある方は是非ご参加ください。お一人様大歓迎です！まったり技術の話をしましょう！ はじめに こんにちは、株式会社エスマット エンジニアの hi6okuni です。 今回は、OpenAPI Specification(以降、OpenAPIと呼ぶ)からTypeScriptの型自動生成の仕組みをサクッと作った時の振り返りです。 型の自動生成自体はすでに多くの事例や記事が公開されていますが、本記事では特にマイクロサービスアーキテクチャにおいて「クライアントサイド（Next.js）とマイクロサービス（Go）の間にBFF（tRPCサーバー）が存在する」という構成に焦点を当て、実装例と得られた知見を紹介します。 特に以下のような課題をお持ちの方に参考にな

これは SMat Advent Calendar 2024 の12/2分の記事です。 こんにちは、株式会社エスマットにてバックエンドを中心に開発をしています、野島といいます。 弊社では在庫の重量を計測し、在庫数を推定する機能を有する在庫管理プロダクトを提供します。なにかを計測する場合、計測値は誤差を含み、この誤差をどう扱うかという課題があります。弊社の重量を測るスマートマットも計測値に誤差を含み[1]、誤差の扱いが課題として存在します。 本記事では誤差による影響を簡単に説明し、データに最頻値フィルタを適用する実験を行います。 誤差による影響 誤差が在庫数の推定に影響を与える一例として、以下のグラフを示します。 このグラフでは、赤い破線が真の在庫数（真値）を表し、オレンジの線が計測値を基に推定した在庫数（推定値）を表しています。誤差を含む重量計測値をシミュレートし、在庫1つあたりの重量で割る

前書き どうも、スマートショッピングでプログラマーをやっている桑島です。 昨年末頃からスクラム運用にNotionを使い始めました。まだまだ試行錯誤中ですが、現在の利用方法などについて社内共有もかねて記事としてまとめたいと思います。 弊チームのスクラムのすすめかたについて 社内でもチームごとにスクラムの進め方がちがうので、私のいるチームが普段どうスクラム開発を行っているかまず説明します。 社内のエンジニアチームですが、いわゆるSaaSのロードマップ開発を行っているチームが3つ、ハードと組み込みソフトウェアを開発しているチームが1つ、あとSREチームが存在しています。 その中で私はマッハ（Mach）というロードマップ開発を行うチームに所属しています。 チームメンバーはエンジニアが3人、PdM、デザイナーとなっており、PdMとデザイナーは他チームとの兼任になっています。 開発の流れですが、基本的

要旨 コメントを適切に記述することは、特にインターフェイス（クラスやメソッド）において重要です。これにより、直感性が高まり、抽象化が十分に行われているかを確認する手助けになります。そのため、コメントはソフトウェア設計プロセスの重要な一部と位置づけられます。 2種類のコメントタイプ まず、コメントを2種類に分類します。 1️⃣ コードをより詳細化するコメント(lower-level comment) 2️⃣ コードをより抽象化するコメント(higher-level comment) どちらも必要なコメントとしつつ、本書では後者のコメントをより重視しています。 1️⃣ コードを詳細化するコメント(lower-level comment) 変数名などに残すタイプのコメントで、宣言した対象の単位や境界値、null許容などの詳細を明示することで、コードの正確性を高めます。こちらのタイプのコメントも必

こんにちは、バックエンドを中心に開発をしています、野島といいます。 ソフトウェアテスト自動化カンファレンス2023に「マイクロサービスアーキテクチャへのIntegration Test導入のすゝめ」というお題で登壇しました。 そちらで発表した内容を記事にしつつ、当日話しきれなかった内容についても書きます。 発表は下記の内容を話しました。 Integration Testの導入を決意した背景にあった課題 Integration Testの導入/運用での工夫 Integration Testを導入して得られたメリット まとめ 本記事では、Integration Testを以下の定義で扱います。 マイクロサービスが依存する外部コンポーネントをモック化せずに行うAPIテスト。 外部コンポーネントとは、具体的にはデータストア、外部サービス、テスト対象が依存するマイクロサービス、などを指します。 テス

こんにちは、バックエンドを中心に開発をしている野島と申します。 最近下記の流れで開発をしており、とても開発しやすいと感じているので共有します。 APIの自動テストの作成 モックAPIの作成 APIの処理の実装 TDDは下記の順序で行いますが、それを拡張してAPI開発にあてはめたようなスタイルです。 レッド:動作しない、おそらく最初のうちはコンパイルも通らないテストを1つ書く。 グリーン:そのテストを迅速に動作させる。このステップでは罪を犯してもよい。 リファクタリング:テストを通すために発生した重複をすべて除去する。 テスト駆動開発 p.ⅹより引用。 それでは、内容に入っていきます。 0. 前提 Go言語でAPI開発し、テストツールにはscenarigoを利用するとします。 scenarigo は YAML でテストシナリオを記述するAPIテストツールです。簡潔に記載できるので、どのような

こんにちは、株式会社スマートショッピングでエンジニアリングマネージャーを担当しているleafです 先日開催された Findy Team+ Award 2023 にて組織別部門(50人未満の組織規模)とチーム別部門(レビューリードタイムが早い)を受賞することができましたので、Findy Team+ 導入から今までに取り組んだこと、今後の取り組みについてご紹介させていただきます 初めにやったこと 初期に取り組んだことは2点で、正確な現状把握と目標設定です 運用中のリポジトリに計測を導入したため、放置されたPRなどが残っており、開発状況に関係なく数値が上下することがありました そのため、対象リポジトリの放置PRなどを全て棚卸しし、どうしても制御できないPR(自動生成されるものや隣接チームの依存が大きいもの)に関してはタグを設定し除外することでようやく現状が把握できる状態となりました 目標設定に関

はじめに 株式会社スマートショッピングで SRE をしているbiosugar0です。 先日、2023 年 10 月 23 日に行われた Amazon Bedrock Prototyping Camp というイベントに参加してきました。 そこでは Bedrock の紹介から始まり、Claude のハンズオン、実際にプロダクト反映を目指したプロトタイピングを行うという内容でした。 今回はその中で検証、実装した社内用の Slack bot に弊社ヘルプページを参照させる事例を紹介します。 Retrieval Augmented Generation (RAG) Retrieval Augmented Generation (RAG)は、LLM を用いた処理において、外部のデータベースや文書と連携してより精度の高い回答を生成するためのテクニックです。 GPT-4 のような LLM は、学習に使用さ

こんにちは、株式会社スマートショッピングでエンジニアをしているrobjamです。 デベロッパーツール（DevTools）には便利な機能が盛り沢山です。今回はその中から一部の機能をご紹介したいと思います。今回は主にChromeのDevToolsを使いますが、他のbrowserでも同じような機能が提供されております。 簡単な例文をローカルで試せるようにrepoを準備しました。 こちらをcloneしてセットアップいただければと思います。 1. タブの並べ替え タブの並び替えは、キラーフィチャーではないかもしれませんが、ご存知の方が少ないかもと思って共有します。タブの並び替えができます！動画をみていただければイメージがつかめると思います。 2. xhrリクエストの再送信 たまにプログラム的にリクエストを送信したい時があります。例えば、体験のrepoにあるcounterのエンドポイントを20回送信し

はじめに こんにちは、株式会社スマートショッピング エンジニアのhi6okuniです。 フロントエンドエンジニアとして主にReactを用いた開発に従事してきましたが、この半年間は幸運にも自社のバックエンドをGoで開発する機会に恵まれました。Goらしいコードを書く技術も日々学習中ですが、最近ではデータ構造そのものにも興味が湧いてきました。そこで今回、GoのMapの内部構造がどのように作られているのかを深堀りしてみることにしました。主な焦点はruntime/map.goのmapassign関数の解析になります。 ざっくり理解 始めにruntime/map.goファイルのMapのコメントを読んでみましょう。データ構造/仕組みが記載されています。 A map is just a hash table. The data is arranged into an array of buckets. E

はじめに こんにちわ、フロントエンジニアの川上です。今回は自分も初めて見た時に使い方に戸惑ったCSSのネガティブマージンについて記事を書かせていただきます。 ネガティブマージンとは、CSSのmarginにマイナス値を設定することを指します。大抵は正の数をしてしますが、負の数を設定するとどうなるのでしょうか。 特にCSSでは、この書き方でなければ問題が解決できないということは、ほとんどありません。CSSをコーディングする人によって書き方は無数に存在しますし、どの書き方でも見た目は一緒になります。しかし、CSSのプロパティの数やエレメントの数が少ないほど、見やすく理解しやいすいコードになり、それは良いコーディングのひとつであると考えます。 ネガティブマージンも良いコーディングのための書き方と捉えていただけると良いと思います。 ネガティブマージンの使いどころ ネガティブマージンの使いどころとして

はじめに こんにちは、バックエンドを中心に開発をしている野島と申します。 最近は、弊社プロダクトであるSmartMat Cloudに対する自動テストの拡充を推し進めています。 SmartMat Cloudは在庫の重量を計測し、閾値を下回った際に自動で発注を行う機能を有するIoTプロダクトです。この記事ではその発注機能、特にジョブに対するテストについて共有します。 発注ジョブに対する自動テストを作成する中で、下記の課題がありました。 どのようにしてジョブを実行するか ジョブの実行結果はどう評価するか これらに対するアプローチを共有します。 どのようにしてジョブを実行するか 発注ジョブはCronで定期的に実行されており、テストをしたい任意のタイミングでどのように発注処理を実行するかが課題でした。 そこで、テスト用のWebAPIを作成し、これを呼び出すことでジョブと同じ処理を実行することにしまし

はじめまして2022/11に入社しましたソフトウェアエンジニアの葛西です。 主にバックエンド開発を担当しています。 社内で競プロ部を立ち上げたのでいつか機会があれば記事にしたいなと思っています！ はじめに チーム内で現在のプロジェクトのDB(リポジトリ層)単体テストをどういう風にやろうかという話になり、色々悩みながらやり方を検討していったのでその過程と最終的にどのように実装したかを残しておきたいと思い記事にしました。 技術スタック まずDBテスト方法を検討する際の前提条件として現在のプロジェクトで使用している技術スタックを書いておきます。 言語 Go DBマイグレーションツール sql-migrate スキーマ変更用のSQLを用意しておけばコマンドでスキーマ変更などを反映してくれるというツールです。 スキーマ変更用のSQLはこのプロジェクトのディレクトリに直接置いています。 ORMライブラ

この記事で紹介しているRequired workflowはRepository Rulesに移行し、2023年10月18に廃止されます。(気に入ってたけど) https://github.blog/changelog/2023-08-02-github-actions-required-workflows-will-move-to-repository-rules/ 先日、GitHubのアップデートによりRequired workflowが使えるようになりました。 これにより、 Organization内のリポジトリに対して共通のWorkflowを設定できるようになりました。 スマートショッピングでは、さっそく組織横断でWorkflowを中央管理するリポジトリを作成し、運用を始めたので共有します。 Required workflowsを管理するリポジトリの設定 組織のプライベートリポジトリ

この記事は、開発生産性 Advent Calendar 2022の24日目の記事です。 株式会社スマートショッピングでSREをしているbiosugar0です。 今回はSREが現在DevOpsに向き合い、開発を加速させるために取り組んでいることについて紹介します。 開発を加速させるDevOpsという考え方 DevOpsは、開発チームと運用チームが協力し、よりスムーズに高品質なサービスを作り上げるという考え方です。 歴史的に、企業は複雑なシステムを開発運用していくために「開発」と「運用」という別々のチームにそれぞれの仕事を任せてきました。 このアプローチに伴う開発／運用の分断には、多くの問題がありました。 その中でも大きい問題は、2つのチームの目標が対立関係に陥りやすいことです。 開発者は新しい機能や改修をスピード感をもって開発してリリースしたい、運用者はシステムをより安定させるためにシステム