↓まだチャンネル登録をしていない人はこちらから！↓<a href="https://www.youtube.com/channel/UCytjAXJpeqzSotBHYJ7lMqQ" target="_blank" rel="noopener noreferrer">【click】YouTube エンジニアファースト</a>

今回は我々、グラントホープがなぜエンジニアの独立支援をしているのか？ なぜエンジニアファーストというチャンネルを立ち上げたのか？ そんな話をしています。15分だけ時間をください。

動画はこちらからご覧ください。 <a href="https://m.youtube.com/watch?v=48BimW3jTHs" target="_blank" rel="noopener noreferrer">https://m.youtube.com/watch?v=48BimW3jTHs</a>

【独立を迷っているエンジニアに伝えたいこと】

猫が大好き。食べることが大好き。寝ると嫌なことは忘れるタイプ。
いろんな人に出会い、いろんなものに触れて、思考を柔らかく、自分の世界を広げていきたい駆け出しライターもどき。


こんにちは！タカトです。 &nbsp; 2022年からちょくちょく話題に上がっていたインボイス制度。皆さんは具体的にどういった制度か把握してますか？会社員の方は特に意識する必要はありませんが、副業でそれなりに稼いでいたり、個人事業主・フリーランスの方は意識しないと今後の仕事に影響が出てきます。今回はそんなインボイス制度について解説していきます。 &nbsp; できるだけシンプルかつ分かりやすくお伝えしてきますので、インボイスが気になるぐらいの感じで読んで頂いて大丈夫です！時間にして3分ほどで読めるのでランチやお茶のお供にどうぞ！

インボイス制度はシンプルにいうと、消費税を払わせる制度です。 &nbsp; 消費税は物を購入した際に商品購入代金と一緒に払っていますが、その消費税とは別であなたが個人で請け負った仕事に対する消費税のことを指します。（詳細は後述で解説します） &nbsp; 消費税を払った人には適格請求書発行事業者として番号が発行されます。 適格請求書発行事業者になるためには課税事業者になる必要があり、課税事業者になる＝消費税をしっかり払いますということです。

消費税をなぜ今更払うのか？今まで免除されてた理由は？

ここで質問です。 &nbsp; あなたが物を購入し10%の消費税が掛かりました。お店には商品代＋消費税を支払いますが、この10%の消費税は誰が国に払っているか？ &nbsp; 答えはお店が代わりに国に払っています。 &nbsp; お店、または会社は毎年確定申告を行っており、その際に貰った消費税をまとめて国に支払っているワケです。 &nbsp; 次に、あなた自身が個人で仕事を受注し請求書が来ました。その請求書には売上の10%の消費税が加算され、振込の金額として提示されてます。（売上が10万だったら11万が振込対象額。1万は消費税。） &nbsp; ではこの消費税は誰が支払っているでしょうか？ &nbsp; 多分、この回答は言葉に詰まると思います。 &nbsp; 本来であればお店と同じであなたは消費税を受け取っているので、それを国に支払う必要があります。 &nbsp; これを払わなくて良いのには理由があって、売上が一千万以下の個人事業主は免税事業者と呼ばれて、消費税を支払わなくてよいとされているからです。 &nbsp; なので知らぬ間に脱税してた！？といったことにはなりません。 &nbsp; インボイス制度が施行されると、売上が一千万以下の個人事業主も課税対象者になり、毎年売上の10%を国に納める必要があります。

インボイス制度の施行は2023年10月1日からになります。 &nbsp; なので2024年に行う確定申告ではインボイス制度を考慮した申告が必要になります。 &nbsp; 各種会計ソフトもそれに向けて対応を実施中です。

適格請求書発行者って何なのか？番号は無いとダメなの？

適格請求書発行者になると番号が発行されます。番号を発行しない（適格請求書発行者にならない）選択も可能です。 &nbsp; では番号あり／なしでどういった違いがあるのでしょうか？ &nbsp; あなたに仕事を依頼する会社からすると、番号あり／なしでの違いは国に納める消費税分を全額免除できるか、できないかの違いがあります。 <img src="https://images.microcms-assets.io/assets/03df7942ab184c4fb92ae2a6d548e115/f466d12227d94fe2a6d56a13bbff7eca/image2.jpeg" alt=""> 会社からしたら、番号がない人と取引するのはデメリットしかないんです。 &nbsp; こうなると個人は仕事の受注にモロに影響が出るので、実質番号あり（自身で消費税を納める）を選択せざるを得ないのが実状です。

適格請求書発行者になると収入はどれだけ下がるのか

適格請求書発行者になるということは消費税を新たに納めるということです。 &nbsp; 2023年現在、消費税は10%なので、自身の年間売上が300万の人なら年30万、500万なら50万の税金が新たに発生します。 &nbsp; 消費税が上がれば、この税金もどんどん上がっていきます。 &nbsp; ただでさえ多くの税を払っているのに、更にまた税金が重くのしかかる。中々厳しい現実ではあります。

インボイス制度が反対される理由

インボイス制度は今まで対象外だった免税者（売上が一千万以下）から消費税を徴収する制度というのはお分かり頂けたかと思います。 &nbsp; 売上が100万円の人も10万という額を追加の税として納める必要が出てくるので、売上が少ない人にとっては死活問題で、反対されるのは当然の結果です。 &nbsp; 実際、エンタメ業界へのダメージがかなり大きいと言われています。 <a style="color:#1155cc" href="https://maidonanews.jp/article/14719374" target="_blank" rel="noopener noreferrer">「インボイス制度は日本のエンタメ業界を破壊する」　声優の甲斐田裕子が反対の声を上げる理由</a> &nbsp; これで徴収しても300億程度にしかならないので、反対されるのも無理はありません。

インボイス制度施行に向けて出来ること

正直この制度は個人事業主にとってはかなり痛い制度です。 &nbsp; とはいえ決まってしまったのは仕方ないので、出来ることとして売上額を上げるのが一番だと筆者は感じます。結局10%もっていかれるなら売上額を上げて少しでも税の負担を減らすのが今できる最善の策です。 &nbsp; もう1つはインボイス制度に対しての対応は会社によって様々なので、そこをお世話になってる会社に確認し、より良い対応をしている会社を選びなおすという手段です。 &nbsp; 例えば適格請求書発行者にならなくても良いや、その税の分を上乗せして支払ってくれるなど対応は様々かと思います。 &nbsp; グラントホープは業界的にレアな対応をしており、適格請求書発行者になることを止む無しと感じているエンジニアや個人事業主の人はグラントホープなら心配ない対応を取っています。 &nbsp; 話を聞くだけでも全然良いと思うので、興味のある方は聞いてみてはいかがでしょうか。

まとめ：しっかり理解した上で施行されるまでに準備をしよう！

いかがだったでしょうか？2023年から年収の10%が減るのは目に見えたので、そこをどう補填するか事前に考えて準備すること、もしくはお世話になってる会社を見直すことが今できる策なのかなと思います。 &nbsp; もちろん、適格請求書発行者にならなくても問題はないです。 &nbsp; 実際、施行された時にどれだけの人がなるかは未知で、下手したら適格請求書発行者にならない人が多い可能性もあります。 &nbsp; 自分の将来に関わることなので、しっかり理解した上で自身が望む選択をしていきましょう！ &nbsp; 本日も読んでいただきありがとうございました。

インボイス制度とは？施行される前に抑えておきたいポイントを解説！

タカト

2児に父でフリーランス歴8年目、主にPMO・サポート業務をメインに案件をこなしています。Webライターとしても活動中。

PythonのWebフレームワークにはDjango、Flaskが良く使用されますが、今回はFastAPIというフレームワークを紹介したいと思います。 FastAPI は、Pythonの標準である型ヒントに基づいてPython 3.6 以降でAPI を構築するための、モダンで、高速(高パフォーマンス)な、Web フレームワークです。

FastAPIの特徴とDjangoとの比較について

・パフォーマスが高く、処理が早い

FastAPIはPythonの有名なWebフレームワークのDjangoパフォーマンスを比較しても、NodeJSやGoと同じくらいにパフォーマンスが高いと言われており、Djangoよりも処理が早いとされています。

・コードが書きやすく、バグ等も見つけやすい

コーディングもDjangoに比べて書きやすい特徴もあり、コードによる重複も最小限にしていることから、ヒューマンエラーよるバグも削減と開発速度の向上が見込まれています。

・習得にそれほど時間がかからない

FastAPIはDjangoに比較して簡単に習得できるようにデザインもされていることから、ドキュメントに読む時間やその他調査にかかる時間も短縮されます。

必要条件:Python 3.6以上 ※開発環境(動作はMac環境を使用しています。) OS: MacOS Big Sur 11.4 Python: 3.9.7 Django: 3.1.7 IDE: PyCharm &nbsp; Pycharmを起動して、左下の「terminal」をクリック

(Macのデスクトップの右上の虫眼鏡マークから「ターミナル」起動→指定した階層に移動でも構いません)

ターミナル上で以下のコマンドを入力してください。 pip install fastapi 以下のように「Successfully〜」と表示されれば問題なくFastAPIはインストールされています。

次に以下のコマンドを入力後、エンターキーを押してください。 pip install uvicorn こちらも問題なく、エラーメッセージが表示されなければ正常にインストールされています。

任意のディレクトリ配下にmain.pyを作成して、以下のコードを入力します。 main.py &nbsp;

&nbsp;以下のコマンドを実行します。 uvicorn main:app --reload &nbsp; ブラウザのURLバーに <a href="http://localhost:8000/" target="_blank" rel="noopener noreferrer">http://localhost:8000/</a> を入力してください。

{"Hello":"World"}と表示されていますね。 &nbsp; 先程作成した、main.pyの5行目から7行目にて @app.get("/") def read_root():　 　&nbsp; &nbsp;&nbsp;return {"Hello": "World"} @app.get("/") →@app.get("/")と書くことで、localhost:8000以降のURLを指定するパスになります。 ("/")と書くことにより、localhost:8000で動く関数ということになります。 def read_root(): return {"Hello": "World"} →@app.get("/")と書いてありますので、 uvicorn main:app –reload Webサーバーを起動した際にWebブラウザにて localhost:8000と入力した時に動く関数ということになります。 &nbsp; こちらのサンプルではread_rootという関数名にしていますが、任意の関数名に変えていただいても構いません。 returnも{"Hello": "World"}とありますが、こちらも任意の文字列に変えてもよいです。

では次にブラウザのURLバーにて <a href="http://localhost:8000/items/10?q=sample_fastapi" target="_blank" rel="noopener noreferrer">http://localhost:8000/items/10?q=sample_fastapi</a> を入力してください。

このように表示されていれば成功です。

解説をしていきます。 main.pyに記載をした@app.get("/")と@app.get("/items/{item_id}")の2つ関数がありますが、WebブラウザのURLにて、localhost:8000以降の/&nbsp;と&nbsp;/items/{item_id}のパスで HTTP リクエストを受けます。 /items/{item_id}&nbsp;パスのパスパラメータ&nbsp;item_id&nbsp;は&nbsp;int&nbsp;でなければなりません。 <a href="http://localhost:8000/items/10?q=sample_fastapi" target="_blank" rel="noopener noreferrer">http://localhost:8000/items/10?q=sample_fastapi</a> →こちらの10という数値がint型指定です。 パス&nbsp;/items/{item_id}&nbsp;はオプションの&nbsp;str&nbsp;クエリパラメータ&nbsp;q&nbsp;を持ちます。 <a href="http://localhost:8000/items/10?q=sample_fastapi" target="_blank" rel="noopener noreferrer">http://localhost:8000/items/10?q=sample_fastapi</a> →sample_fastapiの箇所がstr型となります。 @app.get("/items/{item_id}") def readitem(itemid: int, q: str = None): 　　&nbsp;return{"item_id": item_id,&nbsp;&nbsp;"q": q} 今回使用したURLですと、 http://localhost:8000/items/10 →10がread_item_idの第一引数の、item_id: intの箇所で <a href="http://localhost:8000/items/10?q=sample_fastapi" target="_blank" rel="noopener noreferrer">http://localhost:8000/items/10?q=sample_fastapi</a> →sample_fastapiがread_item_idの第二引数のq: str = Noneの箇所になります。 &nbsp; 試しに<a style="color:black" href="http://localhost:8000/items/%7bitem_id%7d" target="_blank" rel="noopener noreferrer">http://localhost:8000/items/{item_id}</a>の{item_id}の箇所にて、int(数値)以外の値を入れてみましょう。 WebブラウザでURLバーにて以下を入力してみてください。 <a href="http://localhost:8000/items/sample?q=sample" target="_blank" rel="noopener noreferrer">http://localhost:8000/items/sample?q=sample</a>

value is not a valid integer〜とエラーメッセージが出力されましたね。 &nbsp; では次に行きましょう。 WebブラウザのURLバーで以下を入力してください。 http://localhost:8000/docs &nbsp;

こちらの画面が表示されましたと思います。 こちらは自動対話型APIドキュメントです。 &nbsp; 次は以下のURLをWebブラウザで表示させてください。 http://localhost:8000/redoc

代替の自動ドキュメントが表示されます。

アップグレードの実装(PUTリクエスト)

PUTリクエストからボディを受け取る実装を進めます。 main.pyを修正しますので、黄色の部分を追加してください。 &nbsp; &nbsp; &nbsp; &nbsp; main.py &nbsp; from fastapi import FastAPI from pydantic import BaseModel app = FastAPI() class Item(BaseModel): &nbsp;&nbsp;&nbsp; name: str &nbsp;&nbsp;&nbsp; price: float &nbsp;&nbsp;&nbsp; is_offer: bool = None @apgep.t("/") def read_root(): &nbsp;&nbsp;&nbsp; return {"Hello": "World"} @app.get("/items/{item_id}") def read_item(item_id: int, q: str = None): &nbsp;&nbsp;&nbsp; return {"item_id": item_id, "q": q} @app.put("/items/{item_id}") def update_item(item_id: int, item: Item): &nbsp;&nbsp;&nbsp; return {"item_name": item.name, "item_id": item_id}

次は以下のURLをWebブラウザで表示させてください。 http://localhost:8000/docs

item_idに任意の数値を入力し ※画面の例の10以外の数値でも可

ユーザインターフェースはAPIと通信をして、パラメータを送信し、結果を取得して、画面下部に表示されます。 &nbsp; 次は以下のURLをクリックしてください。 <a href="http://localhost:8000/redoc" target="_blank" rel="noopener noreferrer">http://localhost:8000/redoc</a>

代替のAPIにも新しいクエリパラメータやボディが反映されています

このようにFastAPIは関数のパラメータとして、パラメータやボディ の型を宣言して、簡単にAPIエンドポイント定義と実装が可能になります。 &nbsp; &nbsp; 参考URL <a href="https://fastapi.tiangolo.com/ja" target="_blank" rel="noopener noreferrer">https://fastapi.tiangolo.com/ja</a>

PythonのWebフレームワークFastAPIの紹介

中川　彰吾

フリーランスSEで色々なWeb系の案件に参画中。言語はPythonやRuby
自宅でもパフォーマンスが落ちない様、リモートワーク中心の生活を過ごしながら、
IT技術だけでなく、英語や株式投資など学習中。


こんにちは！&nbsp;&nbsp;&nbsp;&nbsp;タカトです。 &nbsp; 今回は数多くSES事業を主とする会社が存在する中で、私がお世話になっているグラントホープをオススメする理由について解説します。 私自身、フリーランス歴は8年ですがグラントホープでお世話になってるのは2年目と実は短かったりします。 5年間は全く違うところで案件を紹介頂いており、正直行こうかどうか悩んだ背景もあります。今回はそんな悩みも踏まえてオススメの理由についてお話していきます！

グラントホープってどういう会社？

2016年設立の新しい会社でSES事業・キャリアアドバイザー事業を主としている会社です。設立して6年目ですが売上高は年々更新されており、2021年は24億。在籍しているフリーランスも数多く、年齢層も20〜40代と若々しい会社です。

私自身、グラントホープを選ぶまでは正直悩んだ

私は無料査定（詳細は事項で）を行ってから半年ほど保留にしてました。 &nbsp; 理由として、年収は上がったのですが色々な事情を考慮して案件を紹介して貰えるか不安だったからです。（私の場合は、高稼働は不可だったので） &nbsp; また、スキルに対する自信もそこまでなかったので「その額を貰うだけの活躍ができるのか？」という変にネガティブな状態になり、保留にしてました。 &nbsp; 今思うと、転職に似てるのかなと感じました。

結果的に半年悩んだ後、「入ってから色々考えよう！」という結論に至り、グラントホープさんにお世話になることを決めました。

実際グラントホープに入ってみて、どうだったか

5年間お世話になった会社以上に融通も利き、働きやすいです。 &nbsp; 年収もアップしましたし、サポートも手厚いので、早く会社を変えておけばよかったなぁと後悔したぐらい。 &nbsp; また、フリーランスと思えない福利厚生がしっかりしてるのでこの点は他社に負けないと思います。

グラントホープを選んだ6つの理由

私がグラントホープを選んだ理由は大きく6つあります。

グラントホープに入るにあたって、事前にスキルシートを提出して年収の査定ができます。 &nbsp; これで自分の年収が事前に分かるというワケです。 &nbsp; しかも今だとLINEで無料査定できるのが有難いですね。 &nbsp; 手順は本当に簡単で、経歴書を送るだけ。 &nbsp; 私の頃は対面でやっていた部分もあり、今も場合によっては対面になることもあるかもしれません。

2.査定結果が想像以上に良かった

私の場合ですが、年収が300万ほど上がりました。 &nbsp; 前の会社も安いワケではなかったのですが、想像以上の上がり幅だったのでかなり驚きました。 &nbsp; これだけ上がるのにも理由があって、グラントホープの場合、中間マージンの割合がかなり低いと思います。 &nbsp; とにかくエンジニアに還元するというのを大前提にしているため、結構な割合で年収アップできます。 &nbsp; しかもちゃんと経験値を積んで、単価の高い案件に参画することも出来て、更に年収アップが狙えるのもポイントです。

3.査定したからといって無理な勧誘・催促が一切ない

査定は正直、気軽にできます。 &nbsp; その後、入るかどうかは完全にゆだねてくれますし、無理な勧誘がありません。 &nbsp; ほとんどの会社は査定後「早めに動いた方が…」と言ったりしますが、グラントホープはちゃんと考える時間を頂けます。 &nbsp; 査定結果が良くても色々考えてしまうのが本音です。 &nbsp; 環境面、人間関係など、一旦冷静になって判断した方が良いのでそれが出来るのがいいですね。

4.キャリアも踏まえて案件を紹介してくれる

フリーランスとはいえ、ちゃんとキャリアを積むことが大事です。 &nbsp; 出来ることの幅が広がりますし、自分が「こういうことがやりたい、こういう方向に進んでいきたい」というのがあれば、それに合った案件に参画が可能です。 &nbsp; それだけの案件数がありますし、何よりこちらのことを考えて動いて貰えます。 &nbsp; キャリアプランを立てながら年収アップも狙えるので、普通の会社員の昇給と同じ感覚で給料アップが可能です。

フリーランスでは珍しく、国保ではなく社保に加入可能です。（任意） &nbsp; この二つの違いは、国民健康保険は加入者本人が保険料を全額負担します。 一方社会保険は、保険料の半分を加入先の会社・事業主が負担してくれます。 &nbsp; また、社会保険には、国民健康保険にはない扶養制度が設けられており、所得額の少ない家族を自分の扶養者として健康保険に加入させることができます。 &nbsp; これで家族の保険料が抑えられます。 &nbsp; それ以外でも最近は美容脱毛、エステを安価で受けられたり、今後は飲食・娯楽・レジャー・eラーニング・健康面など活用できる福利厚生が充実していく予定です。 &nbsp; フリーランスに欠かせない確定申告のサポートもありますし、最近ではライター業向けのSEO講座というのもあります。（2022年3月現在、無料） &nbsp; 正直、これだけ充実している会社は正社員の会社でも中々ないと思います。 &nbsp; それだけフリーランスにとってもメリットを考えてくれている会社というわけです。

6.案件参画後もサポートが手厚い

案件に参画したら、お終い！というワケではありません。 &nbsp; 一週間後、参画後の状況確認。何か問題があればすぐ連絡くださいなど、割と手厚いです。 &nbsp; 相談してもちゃんと向き合って話を聞いてくれますし、すぐに動いてくれるので私自身、現場で何があればすぐに連絡して相談したりしてます。

メリットばかり言ってしまうと疑いたくなるのが人間です。 &nbsp; なので、私が入った時に戸惑ったことを解説していきます。

1.案件紹介が複数の営業さんから来る

2022年3月現在、案件紹介について複数の営業さんから連絡が来ます。 &nbsp; しかも嬉しいことに結構な頻度で案件紹介の連絡がきます。 &nbsp; 私が最初いた会社は一人の営業さんから紹介頂いていました。 &nbsp; 紹介頂いて面談→ダメだったら次という流れだったため、複数から案件紹介があった時は驚きました。 &nbsp; ただ、この複数の方から紹介頂くやり方の方が平行で面談もできますし、早々と参画案件が決まります。（早ければ案件紹介頂いてから一週間で決まることもしばしば） &nbsp; 慣れればなんて事はないですが、慣れるまではちょっと大変に感じるかもしれません。

2.自分の中の優先順位をしっかり決めておくこと

案件を選んでいくにあたって必ず優先順を決める必要があります。 &nbsp; ・稼働を低くしたい ・高単価の案件に参画したい ・通勤時間を短くしたい ・キャリアアップをしたいので成長できそうな案件に参画したい &nbsp; などなど、全部を満たすというよりは何を優先してそれに合う案件を見つけるかが大事になるので優先順位はしっかり決めておきましょう。

まとめ：迷うぐらいなら年収査定して貰った方が良い→だって無料だもん

いかがだったでしょうか？まだまだ迷っていたり、とは言っても・・・というのが正直あると思います。 &nbsp; ですが査定自体は無料です。 &nbsp; ある意味、自分の市場価値がタダで分かるということなので、これ自体はやっておいて損はないと思います。 &nbsp; やった結果、微妙だったなら今の会社を継続すれば良いですしね。 &nbsp; 一度きりの人生、自分の価値をより高められる環境でキャリアと年収を伸ばしてみてはいかがでしょうか。

忖度なし！グラントホープをオススメする6つの理由！

皆さん、こんにちは。 Sgiです。 今回はエンジニアに是非活用していただきたいサービスがありますので、この記事を執筆致します。 最後まで読んでいただけると嬉しいです。

年収査定ってやったことありますか？

筆者がおすすめしたいサービスとは「年収無料査定」です。 これ、あまり見かけないですよね？ 正社員SEはまた話が別ですが、フリーランスSEは一般的に &nbsp; エージェントへ登録 ↓ 面談（ヒアリング） ↓ 案件紹介 ↓ お客さんと面談 ↓ 合格 ↓ 契約 &nbsp; という流れでお仕事が決定します。 &nbsp;

しかし今回ご紹介する年収無料査定の違いは図の通りです。

こちらの図を見ていただければ分かりやすいですが、 エージェントでのヒアリングの時点で自分の報酬額がおおよそ分かる仕組みとなっています。

どうやって査定してもらえる？

そもそもどうやって査定額をだしているのか。 気になったので色々聞いてきました。 &nbsp; &nbsp; この年収無料査定をするには、事前に &nbsp; ①&nbsp;&nbsp;&nbsp;技術経歴書 ②&nbsp;&nbsp;&nbsp;プロフィール &nbsp; を作成する必要があります。 エンジニアなら誰もが作成したことがあるはずです。 それをこちらの会社フォーマットに書き直すだけで完了となります。 &nbsp; 年収無料査定をヒアリング前にすることで、より具体的な希望条件の話ができる、という仕組みのようです。 &nbsp; &nbsp; どうやって査定額を出しているのか、謎ですよね。 どんどん解説していきます。

こちらの会社で実際にご成約されたエンジニアのスキル感・契約単価をもとに査定額をだしているそうです。 &nbsp; 査定額と契約時に決定した単価の誤差は月額換算で「約2万円前後」だとか。 これは正確すぎる…。 &nbsp; 会社の実績に基づいた査定額ということでした。 &nbsp;

実際にご成約された方の年収アップ事例

これは一般論ですが、IT業界の場合 正社員からフリーランスに転身した場合、年収は約1,5～2倍以上になります。 &nbsp; 理由は割愛していきます。 &nbsp; 今からお見せする事例も、査定額と契約時の単価（月額）の誤差はやはり2万円前後のようです。 それでは一気にお見せいたします！！ &nbsp; 今回はスキル感も教えていただけましたので、ご参考までに見ていただければと思います。

こうみると、皆さん年収が確実にUPしているのがわかります。 &nbsp; &nbsp; 他エージェントは契約が確定するまで自分の報酬額が不明瞭ですが、 こちらの会社は案件を選ぶ前に自分のスキル感ではどれくらい報酬が貰えるのかが分かるため、収入が不安定と思われがちなフリーランスですが 先の見通しがつくことがメリットになりますね。

査定後にヒアリング→案件紹介をしてもらうメリット

こちらは私が思うことですが、以下4点です。 &nbsp; ①&nbsp;&nbsp;&nbsp;&nbsp;金額が分かることで収入の見通しがつく ②&nbsp;&nbsp;&nbsp;&nbsp;単価をあげるために何をするべきなのか、ヒアリングに相談できる ③&nbsp;&nbsp;&nbsp;&nbsp;具体的な希望が言える ④&nbsp;&nbsp;&nbsp;&nbsp;希望に沿った案件を紹介してもらえる＝ミスマッチが少ない &nbsp; 順にお話させていただきます。

①	金額が分かることで収入の見通しがつく

先ほども少し触れましたが、フリーランスは収入が不安定、と世間一般的には思われています。 しかし、実際にはエージェントを利用することで大半のエンジニアは安定した収入を得ることが出来ます。なぜならエージェントの営業マンが案件を探してくれるからです。 &nbsp; その案件も、事前に報酬額がわかることで収入の見通しがつくため大半の不安は払拭されるはずです。

②	単価をあげるために何をするべきなのか、ヒアリング時に相談できる

査定をすると、おおよその自分の単価がわかります。 査定の金額をふまえて、もしくは将来的にもっと稼ぎたい！というエンジニアは多くいるはずです。 単価を上げるためには、当然スキルアップする必要があります。 スキルアップし、上流工程に参画したり、リーダー業務を行ったり、色々なチャンスがある案件を紹介してもらうことが可能になるはずです。

単価が明瞭になることで、自分のスキル感や立ち位置など、市場価値が見えてくるはずです。 その中で、 「単価を上げたいのでスキルアップできる案件にアサインしてほしい」 「今までリーダー業務ばかり任されてきたけど、本当はプログラマーがいい」 など、より自分のやりたいことを優先させた希望が言えるはずです。 &nbsp; 実際にアサインされるかはエージェントの営業力や個人の面談力にもよりますが、どこのエージェントでも自分の希望はしっかりと伝えるべきです。

④	希望に沿った案件を紹介してもらえる＝ミスマッチが少ない

これに関しては少し論点がずれますが、ヒアリングの時点で自分の希望をエージェントに伝えきれない場合にミスマッチが起こってしまいます。 &nbsp; 案件のミスマッチはエンジニアにとって結構な痛手となります。 「せっかくフリーランスになったのに、希望していた案件にアサインされない・・・」 &nbsp; なんて、そんなもったいないことしてはいけません。 やりたくないことに時間も労力を費やすのはナンセンスですから、しっかり自分の希望を伝えましょう。 ミスマッチが起こらず、やりたい案件にアサインされ、単価もアップ、スキルも習得出来たら最高ですよね。

・・・この会社、一体どちら様？

お待たせいたしました。 今までお話してきたサービスを展開しているのは このメディアサイトを運営している<a href="https://www.granthope.jp/" target="_blank" rel="noopener noreferrer">株式会社グラントホープ</a>さんです。 <img src="https://images.microcms-assets.io/assets/03df7942ab184c4fb92ae2a6d548e115/398019c5b09d483c82b4f1aaaf3d0c72/image.png" alt="">

グラントホープさんの特徴は、まず今回ご紹介させていただいた、年収無料査定。 そしてヒアリングには結構力をいれているようで、まさにエンジニアファースト。 &nbsp; しっかりヒアリングをするからこそ、やりたい案件がどんどん紹介される営業力。 &nbsp; 年収無料査定から最短3日でご成約された方もいらっしゃるそうです。 &nbsp; &nbsp; この年収無料査定は、誰でも実施できるようですよ。 &nbsp; ※フリーランスなので、未経験者は対象外のようです。 	ご実績が２年ある方が対象です。

いろんなフリーランスのエージェント会社がありますが、 それぞれの特徴をふまえて活用していきましょう。 &nbsp; 私個人的な意見としては、無料年収査定はおすすめです。 正社員の方は、フリーランスに転身した場合、今の自分のスキルではどれくらい貰えるのか。 フリーランスの方は、単純にエージェントによって単価が異なりますので比較対象として活用していただけばと思います。 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; これは豆知識？かもしれませんが グラントホープさんは役員の皆さんは、全員元フリーランスエンジニアのようです。 元フリーランスエンジニアによる、フリーランスエンジニアのための会社でありたい。 &nbsp; そんな強い思いがあるそうです。 &nbsp; 拙い文章でしたが、最後まで読んでいただきありがとうございました。

エンジニア必見！一度は全員試すべき年収無料査定？！

何かしらのアプリケーションを作る際、必要な機能をすべて自作することは稀かと思います。 開発者はほかの開発者が作成したライブラリやAPIを活用し、アプリケーションのユニークな部分にリソースを割くことで、日々の工数を削減したり完成度を高めたりしています。 そんな開発者にとって大きな手助けとなるのがAPIマーケットプレイスです。 今回は楽天市場や楽天証券など、さまざまなWebサービスを手がける楽天グループが、開発者に向けて展開しているRakuten Rapid APIをご紹介します。

大別すると以下の機能を持っています。

作ったAPIをほかの開発者が利用できるようにRakuten Rapid API上に公開できます。 無料か有料、または一定の使用量までは無料で使用可能なフリーミアムAPIとして公開できます。 有料、またはフリーミアムで公開した場合は、ほかの開発者の使用量に応じて報酬を得ることができるので、APIによってはマネタイズが可能です。

ほかの開発者が作ったAPIの検索・利用できます。 前項にあるように、APIが有料の場合やフリーミアムの場合はクレジットカードの登録が必要になります。 Rakuten Rapid API上で公開されているAPIはブラウザ上でテストできるので、気になるAPIを見つけたらすぐに試すことができます。

それでは、実際に使用するまでの流れをご紹介していきましょう。

ユーザー登録はGitHubアカウント、Googleアカウント、Rakuten Rapid APIのユニークアカウントのいずれかで行うことができます。 楽天のサービスというと楽天IDで登録するイメージが強いのですが、やはり開発者向けのサービスはそれとは別の枠として考えられているようです。 今回はGitHubアカウントと連携して使用することにしました。 2021年6月現在では、GitHubのリポジトリと連携して——というような機能はないようですが、いずれ実装されるとうれしいですね。

フリーワード検索のほか、カテゴリで絞り込むこともできます。 検索結果にはユーザーの人気度によるレーティング、応答時間、平均稼働率が表示されています。 アプリケーションによっては応答時間や安定稼働をシビアに求められるものもあるので、機能や人気度以外の指標が見られるのはとても良いですね。

今回はテキストの感情分析を行うText-ProcessingというAPIを使ってみることにしました。このAPIはフリーミアムに設定されているので、無料利用枠を超えた際に利用料金が発生します。 したがって、使用する前に料金支払いに使用されるクレジットカードの登録が必要です。

余談ですが、楽天カードでの支払いにしようとしたところ、なぜかエラーが発生してしまい進めなくなってしまいました。別のカード情報を入力したところ正常に登録できたので、一部のカードでは認証が通らない不具合が発生しているのかもしれません。

それでは実際に使ってみましょう。 今回は<a style="color:#1155cc" href="https://ja.wikipedia.org/wiki/%E3%82%A2%E3%83%A1%E3%83%AA%E3%82%AB%E6%98%A0%E7%94%BB%E3%81%AE%E5%90%8D%E3%82%BB%E3%83%AA%E3%83%95%E3%83%99%E3%82%B9%E3%83%88100" target="_blank" rel="noopener noreferrer">アメリカ映画の名セリフベスト100</a>から、筆者の敬愛するクリント・イーストウッド氏演じるハリー・キャラハンの名台詞である You've got to ask yourself one question:'Do I feel lucky?'Well, do ya, punk? を分析し、ダーティ・ハリーの気持ちを理解してみます。

ややネガティブよりな結果が得られました。 このセリフは犯人に44マグナムを突きつけているシーンでの発言なので、ここでポジティブ過ぎる結果が出るのはいただけません。 そう考えると、ある意味妥当と言えます。 もうひとつ、今度は地獄の黙示録からビル・キルゴア中佐が放った名台詞 I love the smell of napalm in the morning. をテストしてみましょう。日本語に訳すと「朝のナパーム（弾）の香りは格別だ」というところですね。

ラベルはneutralになっていますが、pos値も大分高いです。 いくらなんでも朝のナパーム弾の香りで気分が高揚するというのはいかがなものかと思うので、 napalmをcoffeeに変えて試してみます。

pos値が下がってしまいました。 どうやらキルゴア大佐はコーヒーよりナパーム弾の方がお好みのようです。

今回は使用したAPIに問題があったのか、若干疑問の残る形での実験になってしまいました。 ですが、Rakuten Rapid APIには、ほかにも1万を超えるAPIが登録されているので、きっと開発者のみなさんのお気に召すものがあるはずです。 自作のアプリを作る際のヒントにもなると思うので、ぜひ一度使ってみてください。

楽天グループが提供するAPIマーケットプレイス Rakuten Rapid APIってどんなサービス？

Rakuten Rapid APIのご紹介

Takumi.K

サービス開発にも携わるフリーランスフロントエンドエンジニア。

フロントエンドエンジニアとしてフリーランスで活動している久米と申します。 IaaS型クラウドにおけるシェア1位のAWS。かくいう私も<a style="color:#1155cc" href="https://engineer-first.net/history-of-web-frontend-2021" target="_blank" rel="noopener noreferrer">以前執筆した記事</a>で紹介しているように、本サイト「エンジニアファースト」の実装でもAWSを用いています。また他の業務では、フロントエンドエンジニアと名乗っておきながら、API GatewayやAppSyncを用いたAPI実行時の処理などを中心に、バックエンド開発などさまざまな場面でAWSを活用しています。 昨年末（2020年12月）にAWSが提供する「AWS SDK for JavaScript」のバージョン3が公開され、ある程度実際の開発でも使用してみたので、今回はその概要やバージョン2からの書き換え方法などを紹介していきます。

まず最初にバージョンについての注意事項です。 本記事では「AWS SDK for JavaScript」のバージョン3についての記事となりますが、既存のAWS SDKをアップデートして使用するわけではありません。npmパッケージ自体が既存のものとは別のものになっています。 v2

v3（本記事で扱うものはこちら）

使用方法などは後ほどご紹介いたしますが、詳しくは下記の各種バージョンのGitHubリポジトリをご参照ください。 <a style="color:#1155cc" href="https://github.com/aws/aws-sdk-js" target="_blank" rel="noopener noreferrer">AWS SDK for JavaScript v2</a> <a style="color:#1155cc" href="https://github.com/aws/aws-sdk-js-v3" target="_blank" rel="noopener noreferrer">AWS SDK for JavaScript v3</a> バージョン3から新たに追加された主な機能は下記になります。 <blockquote>・ 新しいミドルウェアスタック ・TypeScriptに対する充実したサポート ・必要なパッケージのみの分割インポート対応 引用元：<a style="color:#1155cc" href="https://aws.amazon.com/jp/about-aws/whats-new/2020/12/aws-sdk-javascript-version-3-generally-available/" target="_blank" rel="noopener noreferrer">AWS SDK for JavaScript バージョン 3 が一般公開を開始</a></blockquote> 具体的な内容をひとつずつ見ていきましょう。

参考：<a style="color:#1155cc" href="https://aws.amazon.com/jp/blogs/developer/middleware-stack-modular-aws-sdk-js/" target="_blank" rel="noopener noreferrer">Introducing Middleware Stack in Modular AWS SDK for JavaScript | Amazon Web Services</a> データの送信時などに動作するミドルウェアに、任意のアクションの追加などができるようになりました。 具体的な活用方法としては、通信が行われる際にカスタムヘッダーにメタデータを追加する方法などが紹介されています。

このような処理のように、SDKの動作をカスタマイズすることによって、リクエストのデバッグなどが容易になるとのことです。

TypeScriptに対する充実したサポート

参考：<a style="color:#1155cc" href="https://aws.amazon.com/jp/blogs/developer/first-class-typescript-support-in-modular-aws-sdk-for-javascript/" target="_blank" rel="noopener noreferrer">First-class TypeScript support in modular AWS SDK for JavaScript | Amazon Web Services</a> 以前のバージョン2でも型定義自体は提供していましたが、それらは開発後に利用者の要望を元に追加で定義したものであり、SDK自体がTypeScriptによって記述されたものではありませんでした。そのため、型定義がコードの記述と正確に紐づけられたものではなく、型定義との齟齬（そご）が生じる可能性を捨て切れませんでした。 また、「<a style="color:#1155cc" href="https://engineer-first.net/history-of-web-frontend-2021#index-3" target="_blank" rel="noopener noreferrer">技術遷移から見る現代のWebアプリケーションに求められるフロントエンド</a>」の記事でも紹介したように、近年ではバックエンドでTypeScriptを採用するケースも増え、開発の現場ではよりいっそう、型定義の重要性が高まっています。 今回のバージョンから上記のような問題や、昨今のトレンド、各企業のTypeScript採用の流れを加味した上で、TypeScriptによる開発を行ったことで、SDKの品質向上を図ったとのことです。 下記のように各種IDEでより正確なコード補完が行われ、開発体験の向上にもつながっています。 例）Visual Studio Code

SDKの開発をTypeScriptで行ったことにより、APIドキュメントの正確性も担保されました。 ドキュメントの生成には<a style="color:#1155cc" href="https://typedoc.org/" target="_blank" rel="noopener noreferrer">TypeDoc</a>を使用することでコードの変更を元に反映することが可能になっているとのことです。

必要なパッケージのみの分割インポート対応

参考：<a style="color:#1155cc" href="https://aws.amazon.com/jp/blogs/developer/modular-packages-in-aws-sdk-for-javascript/" target="_blank" rel="noopener noreferrer">Modular packages in AWS SDK for JavaScript | AWS Developer Tools Blog</a> バージョン2では単一のAWSサービス、例えばS3のみを操作する場合でもAWS SDK全体をインストールする必要がありました。 バージョン3からは下記のように使用するAWSのサービスごとにインストールすることができ、プロジェクトファイルの軽量化に大きく貢献します。 v2

v3

その他にも高レベルの操作を行う関数、ユーティリティ関数などの使用がより簡潔になっています。 前述のような各サービスのクライアントに加え、<code>@aws-sdk/lib-〇〇</code>、<code>@aws-sdk/util-〇〇</code>のようなプレフィックス付きのモジュールをそれぞれの機能ごとに使用することができ、必要な機能だけを扱うことで軽量化が図れます。

本記事公開時点ではAWS SDKのバージョン3はリリースしてから日が浅いため、AWS SDKを使用したネット上で散見される多くの記述例では、バージョン2を用いた記述が多く見受けられます。 今回はそれらの知見を活用するためにも、バージョン3への書き換えを実際に行っていきます。 本記事ではS3からデータを取得する際の記述を例に見てみましょう。 v2

上記をご覧いただければわかる通り、関数の使用方法が変更されただけで基本的なデータの流れはバージョン2と遜色ないものが多いです。 <a style="color:#1155cc" href="https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/index.html" target="_blank" rel="noopener noreferrer">AWS SDK for JavaScript V3 API リファレンスガイド</a>で各サービスや関数ごとに情報が記載されているので、詳しくはそちらをご参照ください。 個人的にうれしい変更点が非同期処理を行う場合の記述です。 上記のようなasync/awaitの記述を行う際、バージョン2では<code>getObject</code>の処理結果から明示的に<code>promise()</code>を実行する必要があったのが、<code>client.send(new Command())</code>の形で記述することで、より簡潔に行えるようになりました。 上記のような処理ではリクエストの結果を元に任意の処理を行うことも多いので、非常にありがたいですね。

前項のようにバージョン2の記述と互換性のあるものであれば問題はありませんが、処理によってはそうでないものも存在します。 前項同様、S3での処理を見てみましょう。

バージョン2では<code>maxRetries</code>という値を指定することで処理の再試行回数の指定ができました。 しかし、バージョン3では上記の<code>maxRetries</code>は<code>maxAttempts</code>に名前が変更されています。

上記のように単純に名称変更のみで対応できるもの以外にも、非推奨となり使用できなくなった機能や型定義が変更されているものもあるので、書き換えを行う際には注意が必要です。 <a style="color:#1155cc" href="https://github.com/aws/aws-sdk-js-v3/blob/main/UPGRADING.md" target="_blank" rel="noopener noreferrer">AWS SDKのリポジトリに変更点をまとめて</a>あるので、<a style="color:#1155cc" href="https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/index.html" target="_blank" rel="noopener noreferrer">AWS SDK for JavaScript V3 API リファレンスガイド</a>と合わせて使用する機能をしっかり確認した上で書き換えを行ってください。

AWSは<a style="color:#1155cc" href="https://engineer-first.net/jobs/tag/aws" target="_blank" rel="noopener noreferrer">本サイトで掲載している案件</a>でも非常に多くの企業が採用しているように、今後もそれらを扱える人材の価値は高まっていくと思います。 今回ご紹介した「AWS SDK for JavaScript」バージョン3を始め、AWSは新たなサービスのリリースや機能のアップデートを繰り返しているので、日々キャッチアップを行って扱える技術の幅を広げていきましょう。

2020年12月にAWS SDK for JavaScriptのバージョン3が公開されました。今回はその変更内容の紹介と、バージョン2からの書き換えを実際に行っていきます。

AWS SDK for JavaScript v3のアップデート概要と、旧バージョンからの書き換え

久米大輔/Mei（Crogic）

Web・音楽を中心としたデジタルコンテンツ制作を行うCrogicの代表。
フリーランスのフロントエンドエンジニア・作編曲家として活動している。
Mei名義でVocalとしても活動中。

Bilbase株式会社代表の佐藤です。 <a style="color:#1155cc" href="https://engineer-first.net/fat-model-workarounds" target="_blank" rel="noopener noreferrer">前回</a>の記事ではファットモデルに陥るサイクルとその回避方法について書かせていただきましたが、今回は続編として、ファットコントローラーについてふれていきたいと思います。初学者の方にもわかりやすいように書いていきます！ 皆さんはプロジェクトでファットコントローラーを経験したことがあるでしょうか？ 多言語で経験を積んでいる方は割と回避しやすいものですが、Railsからプログラミングを始める方はハマりやすいポイントかも知れませんね。

・とりあえずビジネスロジックをモデルに移すことを意識する。 ・同時進行でリファクタリングするのは諦めて、コントローラーを綺麗にすることに集中する。 初学者の方にありがちな失敗として、目の前にある問題以外のことにも気を取られすぎてしまい、結局どこから手をつければいいかわからなくなるということが挙げられます。慣れていない方は、まず目の前の課題から解決して、コンパクトに学習とリファクタリングを進めていきましょう！ <a style="color:#1155cc" href="https://engineer-first.net/fat-model-workarounds" target="_blank" rel="noopener noreferrer">前回のファットモデル解消法</a>でもお話しましたが、エンジニアリングをする中で、最初に抑えておくべき部分を見落としがちな方は一定数いらっしゃると思います。 「もうわかってるから問題ないよ〜」という方はこの記事をスキップしてもらって大丈夫です。 見直しを含めて、もう一度さらっておきたい方々はどうぞご一読ください。 では早速中身を見ていきましょう！

めっちゃそもそもの話をしていきます。 Ruby on RailsはMVCアーキテクチャに基づいて3つの要素で構成されています。 「MVC」の「C」が今回登場するコントローラーです。 ここではコントローラーの役割についてサクッと見ていきましょう。

ご覧の通りコントローラーは全体の処理の中で中間地点に位置しています。 つまりコントローラーの役割は「仲介役」ということです。 【もう少し詳細なコントローラーの役割】<ul><li>ブラウザからのリクエストを受け取る</li><li>データをモデルに要求する</li><li>データの追加、変更をモデルに指示する</li><li>適切なViewを選ぶ</li><li>データをViewに渡す</li></ul>

なぜファットコントローラーに陥るのか

ファットコントローラーに陥る原因はただひとつだけ。 実は前項で書かせていただいた「仲介役」という役割を忘れてしまったときに起こるケースです。 一度理解してしまえばファットコントローラーは簡単に攻略できるので、気張らずに頑張りましょう。 まずは下記の図で「Railsがファットモデルに辿り着くまで」をご覧ください。 こちらは前回書かせていただいた、「<a style="color:#1155cc" href="https://engineer-first.net/fat-model-workarounds" target="_blank" rel="noopener noreferrer">Railsのファットモデル3つの対処法</a>」でも使用した図です。今回の対象はステージ2のコントローラーですね。 RailsではSkinny Controller, Fat Modelという方針が推奨されていますが、初学者にとっては「なんのこっちゃ」だと思います。

解説 1,まず、ほかのフレームワークをさわったことがない初心者にとって陥りやすい問題がファットビュー。最終的に画面に表示される内容に関するコードが書き込まれるためビューにロジックを書き込んでしまうケースも見られます。 2,問題はここ、Railsに慣れ始めたエンジニアが陥るファットコントローラー。モデルに書くべき処理とコントローラーで必要な処理の使い分けがうまくできずに、コントローラーにロジックが集中するケース。ビューをスリムにすることはできたが、モデルやモジュールをうまく使いこなせていない、コントローラーのコードに無駄が多い場合に陥りやすいです。 3,しっかりModelにロジックを寄せていった結果、待ち構えているのがファットモデルです。Viewとコントローラーをスッキリできた分Modelにロジックが集まるのは当然ですよね。 コントローラーで何をどこまでやればいいのかわからない、ファットコントローラーの状況になってしまいます。

今すぐ使える【3つのファットコントローラー解消方法】

ここでは紹介できる数も限られてきますので、基本的な考え方の手順を3つだけ紹介していければと思います。

まずは膨れ上がったコントローラーのロジックをすべてモデルへ移行する気持ちで進めましょう。最初から細かいことを考えるよりも構造が整理されている方が大切です。 ❏ポイント ・publicメソッドはアクション（APIモードの場合はAPI）だけにして、それ以外のメソッドはモデルへ移す ・モデルへの移行とリファクタリングは切り分けて考える ❏メリット モデルに処理を集めることで、結果的にそのモデルの規模感がわかるので、モデル自体の改修が必要か、今後の方針も検討することができるようになる点でいいと思います。

条件に応じてコントローラーで処理を分けたいこともあると思いますが、そのためにメソッドが膨らむと、とんでもなく見通しが悪くなるので注意が必要です。 この内容はモデルでもモジュールでもいえることですので、早めに意識しておくことをおすすめします。 ❏ポイント ・before_actionを使う ・繰り返し使う処理はメソッド化してモデルへ ❏メリット before_actionを使用することによって、コードの行数を減らすことにつなげられます。それだけでなく「DRY」の原則に従ってソフトウェア開発を進めることにもつながると思います。 DRYは「Don’t Repeat Yourself」の略で、ただ「繰り返さない」という受け取り方よりも「開発全体において情報を重複させない」という認識でいてもらったほうがいいかと思います。（この辺りもまた別記事で書いていきます） コントローラーでbefore_actionを定義することによって、アクションの前に処理を差し込むとができます。一般的には、複数のアクションで共通している処理に関してはbefore_actionで定義するようにしましょう。 before_actionに関しての使用例は以下に記載させていただきました。

Railsにはコードを最適化するためのrubocopというgemが存在します。

こちらコマンドで.rbファイルを解析して、修正するべきコードを表示してくれます。

とすることでそのファイルだけの解析もしてくれます。

-aオプションを付けることで自動的にコードを修正してくれるという便利な使い方もあるので覚えておくといいかもしれません！ ❏ポイント ・実装中やプルリク作成前に必ずrubocopでエラーが出ないことを確認する ❏メリット rubocopで同じようなことを注意されることがありますが、何回か注意されるとどのように修正するべきか自然にわかるようになるため、スキルアップにもつながりやすく、読みやすいコードを書くことができるようになります。 ❏導入手順 1. 以下をGemfileに記載

2.&nbsp; bundle install後、ターミナルで以下のコマンドを叩いて修正箇所を確認

記事を読んでいただきありがとうございました！ 今回の内容の中で「自分のプロジェクトで課題がありそうだな」と思う方は、「モデルを太らせること」を念頭においてコードを書き進めてみてください！ また、その際には前回の記事<a style="color:#5d639e" href="https://engineer-first.net/fat-model-workarounds" target="_blank" rel="noopener noreferrer">「Railsのファットモデル 3つの対処法」</a>を読んで、参考にしていただくといいと思います。

今回はRails初学者がつまづきやすい、ファットコントローラーに陥るサイクルと、その回避方法についてお話していきます。

Railsのファットコントローラー 3つの対処法

佐藤元典（Bilbase株式会社）

Web開発を通じて建設企業の課題解決を行うBilbase株式会社 代表。バックエンドエンジニアを経て現在はプロジェクト統括も行っています。グラントホープさんを通してエンジニアメンバーも募集予定！

業務でコードを書く際、似たような処理を別の業務で実装した経験がある方も多いのではないでしょうか。中には、それを自作のライブラリとして作成して、GitHubで管理するという形を取っている方もおられるでしょう。 では、実際にそれを複数のプロジェクトで使用する際はどのように行っているでしょうか。 今やほとんどのエンジニアが使っているGitHubですが、その機能のひとつにGitHub Packagesと呼ばれるパッケージホスティングサービスがあります。 今回はこちらを利用して、自作のJavaScript関数をnpmライブラリとして管理する手順をご紹介します。

以前はGitHub Package Registryと呼ばれていたこのホスティングサービスですが、ひとことで言ってしまえば「作成したソフトウェアをGitHub上でパッケージとして管理することで、さまざまなプロジェクトで使えるようにしたよ」というものです。 プライベートリポジトリではプランによって料金が異なりますが、フリープランであってもストレージ容量500MBかつ月間データ転送量1GBまでであれば無料で使えます。 パブリックリポジトリに至っては完全に無料。太っ腹です。

GitHub Packagesに自作関数をデプロイする

今回はTypeScriptを使って簡単な関数を実装し、それを自分専用のライブラリとして作ってみましょう。

まずはPackage.jsonに以下の内容を記述していきます。 ついでにnpm installもやっておきましょう。

@{GitHubのユーザーネーム}/{リポジトリ名}

ここで、いくつか重要なフィールドをピックアップして解説します。 name @{GitHubのユーザーネーム}/{リポジトリ名}の形で入力します。 実際にライブラリをインストールする際も$ npm install @{GitHubのユーザーネーム}/{リポジトリ名}という形式になります。 version ライブラリ自体のバージョンを管理します。今回はとりあえず0.0.1としておきました。 main ライブラリが別のモジュールから呼び出された際に、どのファイルを参照するかを設定します。 今回はトランスパイルされた後のJSファイルを参照するので、dist/main.jsを指定しました。 typesフィールド ライブラリの型定義ファイルを指定します。 publishConfig npmで扱えるようにするため、registryに<a style="color:#1155cc" href="https://npm.pkg.github.com" target="_blank" rel="noopener noreferrer">https://npm.pkg.github.com</a>を指定します。 また、今回は自分専用＝プライベートなライブラリなので、accessにはrestrictedを指定しておきます。 ちなみに複数のレジストリで公開したい場合は、publishConfigフィールドではなく.npmrcに記述する形になります。

今回は最小限の設定だけ記述しました。

リポジトリを作成する際、Node.jsのgitignoreテンプレートを選択している場合は不要ですが、もしそうでなければ.gitignoreにdistディレクトリを追加しておきましょう。 こちらはトランスパイル後のJSファイルと型定義ファイルが格納される予定ですが、トランスパイル自体は後述するGitHub Actionsで行います。

今回は「引数として与えられた文字列の奇数番目だけを抽出した文字列を返す」という関数を作ってみます。

こんな感じでしょうか。 すごく簡単な内容ですが、これならビルドの時間も短いので練習にはもってこいです。

GitHub ActionsでPublishの設定を行い、Packageとして公開する

最後に、プッシュされたら自動でトランスパイル＆Packageとして公開するGitHub Actionsを設定します。 .github/workflows/publish.ymlとして以下の内容を記述した設定ファイルを追加しましょう。

この際、secrets.GITHUB_TOKENという値を利用していますが、これは各リポジトリにデフォルトで備わっているトークンなので個別に設定する必要はありません。 ここまでの内容でプッシュしてみましょう。 リポジトリのActionタブを開くと、すでに先ほど設定したアクションが終了していました。

Codeタブに戻ってみるとPackagesの欄が追加されており、先ほどプッシュした内容がv0.0.1として正常にデプロイされたことがわかります。

デプロイされたライブラリを使う

次にデプロイされたライブラリを実際のプロジェクトに導入して利用する手順をご紹介します。

今回はプライベートなパッケージを対象としているので、それにアクセスするためのトークンを発行する必要があります。 <a style="color:#1155cc" href="https://docs.github.com/ja/github/authenticating-to-github/creating-a-personal-access-token" target="_blank" rel="noopener noreferrer">公式の解説</a>に従って設定ページを開きましょう。

パッケージの読み取りを行うだけなので、スコープはread:packagesにのみチェックを入れます。 NoteはわかりやすいようにREAD_PACKAGESとしてみました。

Personal Access Tokenを発行したら、適当なプロジェクトを作成し、プロジェクトルートに.npmrcを作成して以下の内容を記述します。

これでプライベートなパッケージにアクセスできるようになりました。 あとは通常のNPMモジュールインストールと同様にnpm installすれば、node_modulesディレクトリにインストールされます。

それでは実際に使ってみます。 以下のスクリプトを実行し、AAAAと表示されれば成功です。

期待通りに動きました。 関数名にマウスオーバーすると型の情報も見られるので、型定義ファイルもきちんと参照できているようです。

ここで先ほど実装したライブラリに、「奇数番目or偶数番目の文字列を引数によって選択できる」という新機能を実装したくなりました。 早速実装してみましょう。

新機能を追加したのでマイナーアップデートという扱いにしましょう。 手動で書き換えることもできますが、npmにはパッケージのバージョンを管理するコマンドがあるのでそれを利用します。

gitのログを確認してみましょう。 package.jsonのバージョンが更新され、v0.1.0として新たにタグが作成されていると思います。この状態でプッシュしましょう。

Releaseの欄が2 tagsになり、Packages欄のバージョンも0.1.0になっています。 どうやらきちんとアップデートできたようです。

昨今はnpmライブラリが充実しており、欲しい機能は探せば見つかることが多いと思います。 しかし、公開されているライブラリでは機能が不足していたり、不要な機能が多すぎたりする場合、自作のライブラリで解決するという手段は選択肢として大いにあると思います。 そんなときには、ぜひGitHub Packagesを利用して便利に使いまわしていきましょう。

GitHubの機能である「GitHub Packages」を利用し、自作のJavaScript関数をnpmライブラリとして管理する手順をご紹介します。

GitHub Packagesを使って自作ライブラリを管理しよう

はじめまして、Bilbase株式会社代表の佐藤です。 皆さんはファットモデルについて聞いたことはあるでしょうか？ 最近個人的に質問を頂くことがあるのですが、その中でいくつか共通している質問があります。それは、「ファットモデルの回避方法」についてです。 今回は、そんなファットモデルの回避方法の一部についてお話ししようと思います。 本記事では以下の内容をお話していきます。

・ファットモデル自体は問題でなく、モデルに書くべきではない処理が多いことが問題。 ・モデルに書くべき処理が多く、コード量が多いのは問題ではない。 最終的には上記の結論に至ったわけですが、「割と当たり前の結論になったな〜」と言うのが私の感想です（笑）。 しかし、今回この内容で書く機会が得られてよかったとも思っています。 なぜなら当たり前の中にこそ、落とし穴は潜んでいるものだからです。 この言葉に思い当たることがあるエンジニアの方は一定数いらっしゃると思います。 だからこそ、自分をほんの少しだけ疑いつつ、当記事を読み進めていただけるとうれしいです。 では早速中身を見ていきましょう！

今回は1~2年経験を積んだRailsエンジニアがつまづきやすい、ファットモデルに陥るサイクルとその回避方法についてお話していきます。フリーランスを目指す方は、ぜひご一読下さい。

カテゴリー:【エンジニア】の記事一覧