対談内容について、下記の図解にまとめてます。 セイト先生の運営する、AIプログラミングスクールSiiDはこちら↓ <a href="https://bug-fix.org/siid" target="_blank" rel="noopener noreferrer">https://bug-fix.org/siid</a>

丸山・セイト先生コラボ対談【2026年最新・AIとフリーランスエンジニアの最前線】

グラントホープ

グラントホープのライターです

↓まだチャンネル登録をしていない人はこちらから！↓<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技術だけでなく、英語や株式投資など学習中。


皆さん、こんにちは。 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; 拙い文章でしたが、最後まで読んでいただきありがとうございました。

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

フリーランスは毎年確定申告をすることで税金が確定します。 &nbsp; フリーランスと会社員の大きな違いは、事業にかかったお金を「経費」として売上から控除できる点です。 フリーランスはその年の経費を計上することで、税金を抑えることができます。 &nbsp; しかし確定申告をしたことがないと、「何が経費になるのか？」がわからない方も多いと思います。 当然ですが使ったお金がすべて経費になることはありません。線引きがあります。 &nbsp; 今回はフリーランスが経費として計上できるものについて解説します。

まずあらためて経費とは何かを確認しましょう。 &nbsp; 「経費」とは事業を行う上でかかった費用のことです。必要経費とも言います。 「経費で落とす」というのは「経費として計上する」という意味で捉えて問題ありません。 &nbsp; 経費を計上すると結果的に所得税や住民税が安くなります。 なぜなら、これらの税金は下記の計算式から算出される「課税所得金額」で決まるからです。 &nbsp; 売上 - 経費 - 控除 = 課税所得金額 &nbsp; つまり、経費が大きくなるほど課税所得金額は低くなるので、税金が安くなる。ということです。 &nbsp; 一般的に、会社員よりもフリーランスの方が税制面で有利とされている背景には「経費」があるからでしょう。 &nbsp; 会社員は一部例外はありますが、基本的に経費の計上は認められていません。 その代わりに「給与所得控除」というものが一定の計算式に基づき所得から控除されています。 &nbsp; しかし、所得に応じて控除額が決まる会社員よりも、 自分の意志で所得をある程度コントロールできるフリーランスの方が税制面では有利となるわけです。

続いて経費として認められている代表的な項目について解説します。

自宅で事業を行っている方が対象です。 &nbsp; 賃貸に住んでいる場合、「按分」といって家賃のいくらかの割合分を経費に出来ます。 按分をする理由は、自宅には事業用とプライベート用の両面があり、100%の経費の計上ができないからです。 &nbsp; 良く用いられる計算は「床面積」で仕事をしている空間の割合を出す方式です。 他にも仕事の実働時間分を経費にするという、時間の割合で計算するやり方もあります。 &nbsp; もし自宅が持ち家の場合は減価償却費、管理費、利息などが経費の対象になります。

自宅のインターネットの使用量などは通信費として計上できます。（在宅で仕事をしている場合） 他にはスマホで仕事関係の人とのやり取りによって発生した費用も計上が可能です。 &nbsp; しかし先ほど書いたようにこちらも按分が必要です。スマホを仕事だけに使用しているとは考えづらいからです。 使用している時間等で按分するのが良いでしょう。

水道、電気、ガス代については、事業に必要な費用なら経費に計上できます。 ITエンジニアの方であれば電気代が関わってくるかもしれません。 &nbsp; もし経費に計上する場合はここでも按分が必要なケースがほとんどです。 地代家賃で計算した割合で電気代も同様に考えると良いでしょう。

事業に関する交通費、宿泊費は経費として計上できます。 &nbsp; たとえば取引先との打ち合わせで出張したときのガソリン代・電車代・飛行機代や、ホテル代などです。 電車移動の場合は都度領収書を発行できないときもあるので、私は使用履歴を出力して領収書代わりにしています。

取引先等の接待や、飲み会などについては接待交際費として計上できます。 &nbsp; 時々迷われる方もいるのですが、「仕事のため」と明確な理由があれば、たとえキャバクラで支払ったお金でも経費にできます。 ですからこの場合は、自信を持って計上して問題ありません。 &nbsp; しかしこの接待交際費ですが、不正が多いとされる項目なので税務署側もしっかり見てくるでしょう。 もちろん接待交際費に限らずですが、くれぐれもプライベートな交際費の経費計上はやめましょう。

文房具や封筒などの消耗品は経費で計上ができます。 私は文房具は使いませんが、業務用PCを清掃する用のエアーダスター等はこちらの経費で計上しています。

減価償却という概念があります。長期にわたり使用するものは単年の経費で計上せず、耐用年数に応じて計上するという考え方です。 10万円を超えるものは減価償却となります。 &nbsp; たとえば業務用に20万円のPCを購入したとします。基本的にPCは長期にわたって使用するものですから、減価償却となります。 PCの耐用年数は4年です。購入金額を耐用年数で割った金額を経費として、4年間毎年申告していくことになります。 &nbsp; 例：20万円のPCの場合 20 ÷ 4 = 5万円　を4年間経費として計上する。 &nbsp; ちなみに「耐用年数」は品目により異なります。詳しくは<a style="color:#1155cc" href="https://www.keisan.nta.go.jp/h29yokuaru/aoiroshinkoku/hitsuyokeihi/genkashokyakuhi/taiyonensuhyo.html" target="_blank" rel="noopener noreferrer">こちら</a>を参考にしてください。 &nbsp; なお、青色申告の場合は30万円以下のものなら全額を経費に計上できます。

名称通り仕事を外注した場合は、外注工賃として経費に計上することができます。

こちらも名称通り、広告宣伝にかかった費用を計上することができます。 &nbsp; といってもITエンジニアの場合はあまり広告宣伝費は計上しないと思いますが、 今の時代でしたら事業用のSNSアカウントのアイコンイラストを描いてもらった場合は広告宣伝費となるでしょう。 &nbsp; 他にも一般的なところで言えば、名刺やポートフォリオ作成にかかったお金も経費になりますね。

既存の項目のいずれにも属さないけど、事業に必要な出費があった場合には雑費として計上できます。 &nbsp; あまり雑費を計上することはないかと思いますが、一応覚えておいて損はないです。

事業と関係ないプライベートな出費はもちろん経費としては認められていません。 &nbsp; 自分の食費や趣味、事業と関わりのない友人との飲み会などを経費として計上するのはNGです。

所得税や住民税は経費として認められていません。 これらは所得を計算した結果確定する税金だからです。 &nbsp; しかしすべての税金が経費計上できないということはありません。 &nbsp; 印紙税や、個人事業税などは経費として認められています。 事業を行うにあたって必要な税金だからですね。 &nbsp; 他にも税金の種目はたくさんあるので、どの税金が経費になるのか・ならないのかよく調べてみると良いでしょう。 自分が思わず払っていた税金が必要経費に含まれているかもしれません。

いかがでしたか？ 今回は経費についての基本を解説しました。 &nbsp; 初めて見ると項目が多すぎて大変に思えますが、1つ1つを分割して考えるとそこまで難しいことではありませんので安心してください。 &nbsp; フリーランスは会社員と比べて税制面でメリットが大きいということを実感いただけたかと思います。 賢く節税をして自分の資産を守っていきましょう。

これは経費になる？フリーランスになるなら知っておきたい経費のコト

Souta

Web系エンジニアとして活動。共同で開発した音声型ナレッジ共有ツール「decci」を2021年9月β版ローンチ。弱小ブログ運営中。暇だったので当メディアのライターにもチャレンジ。人間の思考に興味関心がありそういう系の本を読むのが好き。

今回の記事のWebフレームワークの紹介_2では、テンプレートを利用してブラウザ上に表示させる内容を紹介しました。 この記事ではもう少し詳しい解説をしていきたいと思います。

テンプレートの配置場所について

※開発環境(動作はMac環境を使用しています。) OS: MacOS Big Sur 11.4 Python: 3.9.7 Django: 3.1.7 IDE: PyCharm &nbsp; 前回の記事では sample_django/sample_dango/の配下のsettings.pyの54行目付近のTEMPLATESの環境変数にて、以下の記述をしました。 settings.py os.path.join(BASE_DIR, 'templates') &nbsp;

プロジェクト配下のtemplatesというディレクトリの下に、テンプレートのファイル(htmlファイル)を配置しました。 しかし、今後プロジェクト配下にアプリケーションが増えることを想定して、templatesの配下をアプリケーションごとに分けてhtmlファイルを設置したいという場面が出てくるかもしれません。 templatesの直下でなく、templatesの配下にさらにディレクトリを作成して、画面上に表示してみようと思います。 &nbsp; sample_djangoの配下のtemplatesディレクトリの配下に以下のディレクトリを新規作成してください。 その後、既存で置いてある、hello_world.htmlのファイルを新規で作成したディレクトリのhello_world_1とhello_world_2の配下に設置してください。 sample_djangoのプロジェクト配下 templates/hello_world_1/hello_world.html &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;/hello_world_2/hello_world.html &nbsp; &nbsp; 新規ディレクトリ

作成したディレクトリ配下にhtmlファイルを設置

この状態でWebサーバを起動してみましょう。 起動後、Webブラウザでlocalhost:8000にアクセスしてください。

当然ながらエラーが出ます。 TemplateDoesNotExist at/でテンプレートファイルが見つからないことでエラーが出ております。 &nbsp; settings.pyのTEMPLATEの環境変数にて、 os.path.join(BASE_DIR, 'templates') と記載をしています。 現状のsetting.pyの書き方では、templatesの配下にhtmlファイルを設置してあると想定しているからです。 templatesの配下に新規でディレクトリを作成して、元々あったhtmlファイルを作成したディレクトリ配下に設置しているため、読み込めるファイルが見つからないということが起こっています。 &nbsp; setting.pyのTEMPLATEの中身を以下のように修正すれば表示はされるのですが、 setting.py os.path.join(BASE_DIR, 'hello_world_1/templates') アプリケーションが増えることを想定するとこれでは意味がないです。 ですので、呼び出し側のviews.pyを編集してtemplatesの配下にあるディレクトリを指定して呼び出す実装をしたいと思います。

テンプレート配下にあるディレクトリを指定して呼び出す実装について

ではhello_worldの配下のview.pyを開いてください。 一度以下のように実装をしてみてください。 import os from django.shortcuts import render def index(request): &nbsp;&nbsp;&nbsp;sample_data = {'sample': 'サンプル'} &nbsp;&nbsp;&nbsp;#return render(request, 'hello_world.html', sample_data) &nbsp;&nbsp;&nbsp;return render(request, os.path.join('hello_world_1', 'hello_world.html'), sample_data) 変更場所としては、 1行目のimport&nbsp; osの追加 6行目のコメントアウト 7行目のreturn&nbsp; render(request, os.path.join('hello_world_1', 'hello_world.html', sample_data) の追加 &nbsp; こちらでWebサーバーを起動して、ブラウザでlocalhost:8000と入力してください。

今度は問題なく表示されていると思います。 今回は7行目にrenderの第二引数にos.path.join('hello_world_1', 'hello_world.html') と入力しました。 こちらについて解説をしたいと思います。

os.path.joinというのはパスの要素を結合するものというものです。 setting.pyの環境変数にも記載がありますが、 setting.py os.path.join(BASE_DIR, 'templates') この書き方は第一引数にBASE_DIR、第二引数にtemplatesを指定しております。 つまり/BASE_DIR(プロジェクト配下)/templatesディレクトリ を指していることになります。 view.pyの7行目に戻ってみましょう。 return render(request, os.path.join('hello_world_1', 'hello_world.html'), sample_data) &nbsp; この例ですと、op.path.joinの第一引数にhello_world、第二引数にhello_world.htmlを指定しています。 &nbsp; setting.pyのos.path.joinに(BASE_DIR, 'templetes')となりますので、 /BASE_DIR(プロジェクト配下)/templates/hello_world_1/hello_world.html を指定していることになります。 &nbsp; ではviews.pyの7行目をコメントアウトしてください。 8行目に以下を入れてください。 return render(request, os.path.join('hello_world_2', 'hello_world.html'), sample_data) &nbsp; ブラウザでlocalhost:8000を入れて表示させてください。

同じように表示されていると思います。 この書き方で、views.py側でos.path.joinを指定することにより、templates配下にディレクトリを分けたとしても呼び出せる方法を記載しました。

views.pyの作成した関数の戻り値でreturn render(〜)と記載をしています。 renderについて解説をしていきます。 renderのメソッドは指定したテンプレートにデータを反映し、レンダリングしたHttpResponseオブジェクトを返すということになります。 Renderを使用するにはviews.pyファイルにて、 from django.shortcuts import render &nbsp; の記載をしないと使用できません。 &nbsp; return render(request, os.path.join('hello_world_2', 'hello_world.html'), sample_data) こちらの例で行きますと、 第一引数にrequest 第二引数にos.path.join('hello_world_2', 'hello_world.html'), 第三引数にsample_data とあります。 &nbsp; 第一引数のrequestとありますが、views.pyでindexという関数を作成しています。 def index(request):と定義していて、index関数の引数はrequestとなっているので、 そのままindex関数の引数を入れれば良いです。 &nbsp; 第二引数は表示させたいテンプレートを入れます。 この書き方ですと、templetes/hello_world_2/hello_world.htmlをブラウザ上で表示します。 &nbsp; 第三引数のsample_dataですがこちらは5行目にsample_data = {'sample': 'サンプル} とありますので、sample_dataの変数を第二引数に入れたtempletes/hello_world_2/hello_world.htmlに表示させる処理になります。

redirectも紹介させていただきます。 views.pyのimport文にて from django.shortcuts import renderの右側に , redirect の追記をしてください。 from django.shortcuts import render, redirect index関数の中の5行目以降を全てコメントアウトしてください。 その後一番下に以下を入力してください。 return redirect("https://yahoo.co.jp") そして、Webブラウザ上でlocalhost:8000を入力してください。

Yahooのページにリダイレクトしましたよね。 redirect(リダイレクトしたいURL) かっこの中にリダイレクトしたいURLを入力することにより、関数が呼び出された際にリダイレクトするという機能です。

urls.pyのファイルの役割ですが、djangoの中で、ブラウザのHTTPリクエストに対してどの処理を行うか制御するものになります。 &nbsp; 4行目にurlpatternsがあります。 5行目に path('', views.index, name='index') とあります。こちらはurlpatternsの中に記載するもので、urlpatternsはルーティングを制御するものになります。 pathの使用方法ですが、 第一引数にURL 第二引数に関数(クラス) 第三引数にname=名称 という使い方です。 &nbsp; 第一引数はURLの指定で path('', views.index, name='index') こちらの例ですと''となっています。 localhost:8000以降のURLを指定します。 例えば第一引数に path('hello_world', views.index, name='index'), という書き方をすればブラウザ上で localhost:8000/hello_world と入れれば第二引数にのindexが呼び出されるということになります。 &nbsp; 第二引数は上でも書きましたが、第一引数のリクエストされたURLの関数が実行されるということです。 &nbsp; 第三引数はURLの名称で今回はやりませんでしたので、詳しくは別の記事で紹介させていただきたいです。 簡単に説明すると、こちらは必須ではないですが、テンプレート側のHTMLファイルの{% url name%}と記載して、URL先の指定が簡単になるメリットがあります。

前回の記事で実装した内容をもう少し細かく解説してみました。 template配下の複数のディレクトリのテンプレートの呼び出す実装 os.path.joinの説明 renderの説明 redirectの説明 urls.pyのurlpatternsとpathの説明 &nbsp; 参考URL <a href="https://docs.djangoproject.com/ja/3.2/intro/tutorial03/" target="_blank" rel="noopener noreferrer">https://docs.djangoproject.com/ja/3.2/intro/tutorial03/</a>

PythonのWebフレームワーク『Django』の紹介Ver.2【解説編】

oskn259と申します。 最近は開発プロジェクトの進行や、中長期のソフトウェア開発のアンチパターンに興味を持っているのですが、先日良い記事を見かけたのでそれを解説していこうと思います。 ソースの記事はこちらです。 <a href="https://www.swyx.io/optimize-for-change/ " target="_blank" rel="noopener noreferrer">How To Optimize for Change</a> 複雑さの回避について思うところが僕と近かったので、翻訳も兼ねて纏めていきます。 また、今回の内容はこちらで書いた記事の修正版でもあります。 <a href="https://blog.oskn259.com/article/optimize_for_requirement_change" target="_blank" rel="noopener noreferrer">https://blog.oskn259.com/article/optimize_for_requirement_change</a>

ソフトウェアは将来の変更も含めて仕様みたいなもの。 これに対応するためのポイントは以下の通り。 <ul><li> 通常の変更の想定に留める</li><li> 単純な値のみを扱う</li><li> 変更距離を最小化する</li><li>エラーを早期発見するDevOps</li></ul>

あなたがMagic Money Corpを運営していて、以下のコードが利益を生んでいるとします。 js let input = { step1: 'collect underpants' } doStuff(input)&nbsp; profit(input) // $$$!!! `doStuff`に問題が見つかり、一時的にロジックから削除しなくてはいけなくなりました。 しかし、これをコメントアウトした瞬間、`profit`内部がエラーまみれになって資金源が絶たれてしまいました！ 元々は`doStuff`内部で`input`に様々な更新が加えられており、`profit`ではその更新が前提となる処理をしていました。 そこで`doStuff`がコメントアウトされてしまったため、不整合が生じてしまったということです。 では、`input`をImmutableにすればどうでしょうか？ js let input = ImmutableMap({ step1: 'collect underpants' }) doStuff(input) profit(input) // $$$!!! これなら<code>doStuff</code>をコメントアウトしても、<code>profit</code>の動作には影響ありません！ これは一例ですが、このような、変更しやすい設計とはどういうものなのでしょうか？

なぜ「変更しやすい設計」なのか

改めて、変更しやすい設計は以下のような理由で求められます。 <ul><li> 削除しづらいコードは、削除しやすい他のコードを駆逐し続ける</li><li> 削除しづらいコードは、修正を重ねる過程で技術的負債になる</li></ul> この考えは、以下の概念から派生したものです。 <ul><li><a href="https://twitter.com/cramforce/status/1139925981051801600" target="_blank" rel="noopener noreferrer"> リプレースしやすいシステムは、リプレースしづらいシステムに置き換えられてゆく</a></li><li><a href="https://programmingisterrible.com/post/139222674273/how-to-write-disposable-code-in-large-systems" target="_blank" rel="noopener noreferrer">拡張しやすいコードではなく、削除しやすいコードを書く</a></li></ul> ソフトウェア開発において仕様が固まっていることがベストですが、現実の開発においてそうはいきません。 むしろ、要求が変化すること自体が仕様とも言えます。 開発者はこのことに気を配りながら、「削除しやすい」状態を保たねばなりません。&nbsp;&nbsp;

通常の変更(common change)に留めて想定する

もし、全てが変更されうる、としたら一体どうやってシステムを構成すれば良いでしょう？ 将来の変更に対する過剰な想定は、コード量を倍にも増やしてしまいます。

クライアント要求の微妙なブレに対応できる程度に収め、システムデザインやアーキテクチャを変更するような事態までは考えない、 というのは一つの方法として良さそうです。 ごく稀な変更に関しては、それは作り直すための理由となり得る、という点もあります。 また、根本からの変更を要求されるような場面は、そもそも予想しやすいという事もあります。 クライアント要求の微妙なブレに対応できる程度に収め、システムデザインやアーキテクチャを変更するような事態までは考えない、 というのは一つの方法として良さそうです。 ごく稀な変更に関しては、それは作り直すための理由となり得る、という点もあります。 また、根本からの変更を要求されるような場面は、そもそも予想しやすいという事もあります。

こうした想定のもと「変更しやすい設計」を実現するには、以下のような実装が求められます。 <ul><li>削除しやすい</li><li>切り貼りしやすい</li><li>抽象化を介して機能の作成、削除ができる</li></ul> <a href="https://www.infoq.com/presentations/Simple-Made-Easy/" target="_blank" rel="noopener noreferrer">https://www.infoq.com/presentations/Simple-Made-Easy/</a> Simplicityについて説いたこの資料によれば、オブジェクトやインスタンスを受け渡している箇所において、代わりにそれをimmutableでシンプルな値として渡すように変換できます。 このことであらゆる種類の潜在的なバグを回避できるということです。 このことを突き詰めると、イミュータブル化、関数型プログラミング、といった実践的な概念を得ることができます。 単純さを追求すると計算的なコストを支払うことになりますが、キャッシュ等の方法で軽減することはできます。

以下の図は、複雑さをよく表しています。

複雑さとは、要素が編み込まれてしまいほどくのが難しいことであって、単一の要素から複雑さが生まれることはありません。 言い変えれば、順番に依存している状態のことを複雑であると言います。 順番にはたとえば以下のようなものがあります。 <ul><li>命令の実行順</li></ul> &nbsp;- コードの行数を入れ替えることによって全体の動作が変化する<ul><li>プロセスの実行管理による順番</li></ul> &nbsp;- OSによるコンテキストスイッチで、どのプロセスが先に実行されるかが変わる<ul><li>ファイルの記述順</li></ul>&nbsp; - あるファイルのコードを変更した場合、他の数々のファイルが変更を要求される<ul><li>引数の順番</li></ul> &nbsp;- 与える引数の順番によって関数の動作が変化する また、複雑さは「変更距離(edit distance)」を用いて定量化できます。 <ul><li>もし引数の順番を変更したら、その関数を使用しているすべての箇所を書き直す必要がある</li><li>ステートレスなコンポーネントに新たに状態を追加し、全ての呼び出し元を精査せねばならない</li><li>非同期的なデータの取得が追加された際、いくつものコンポーネントやredux定義をまたいで変更しなくてはならない</li></ul> 複雑さの式が存在するわけではないにしろ、開発者は感覚としてこれを知っていて、現にプロジェクトの進行に影響を与えています。 また、見えないコストとして、コードの変更自体が苦痛なのでイノベーションが生まれなくなるという点もあります。 端的には、変更しやすいコードとは、要素を「編み込む」ことができない設計のことを言います。

複雑さを可能な限り排除したとして、本質的な機能に関わる複雑さは当然残ります。&nbsp;&nbsp; こうした排除できない複雑さへの対処として、短いスパンでフィードバックを得ることが有効です。&nbsp;&nbsp;

このことは<a href="https://devops.com/shift-left-can-you-be-left-out/" target="_blank" rel="noopener noreferrer">Shift Left</a>という単語で表されており、 具体的には以下のような要素を指します。&nbsp;&nbsp; <ul><li>リファクタ時にエラー箇所を指摘できるユニットテスト</li><li>型情報によるチェック</li><li>15分以下で完了するデプロイ</li><li>本番環境を再現できるローカル環境</li><li> <a href="https://www.replay.io/" target="_blank" rel="noopener noreferrer">replay.io</a>などの、リアルタイムに値を再現できるデバッグツール</li></ul>

ビジネスが成長したり世の中のニーズが変更すれば、求められる要件も変わっていきます。 ただし、コードの変更のしすぎはそれ自体が良くない結果を招きます。&nbsp;&nbsp; 変更のしすぎとは安定性よりも速度を重視した状態のことで、あらゆるものがすぐに変わっていく様子はユーザーに動揺を与えます。

いかがでしたでしょうか？ 筆者が元の記事の意図を拾いきれず散らかった部分もあるので、気になる方はぜひ元記事も読んでみてください。 複雑さとは要素が絡み合った状態であり、順番に依存しないことが複雑さ回避への道、という考えは色んなところで使えそうですね。 最近では宣言的、状態の記述、といった概念も現れていますが、まさにこうした考えに基づいているのかもしれません。

現役フルスタックWebエンジニアが解説！変更に強い設計をしましょうというお話

oskn259

WEBフルスタックエンジニアとして、新規開発、保守全般業務を並行して請け負う。
経験を活かし、WEB開発進行のコンサル業も行う。
直近のメイン業務は金融系サービスのPdM。
重要なのはトンカチを使えることではなく、頑丈な家が建つこと。

oskn259と申します。 昨今ではテスト駆動開発という言葉も浸透して、全くテストの無いシステムというのは減ってきているように思います。 筆者は最近、テスト駆動開発の名著である<a href="https://www.amazon.co.jp/%E3%83%86%E3%82%B9%E3%83%88%E9%A7%86%E5%8B%95%E9%96%8B%E7%99%BA-Kent-Beck/dp/4274217884" target="_blank" rel="noopener noreferrer">こちら</a>を読み終わったのですが、世にあるイメージと本に書かれている内容に差があるように感じました。 テストが書かれているからTDDなのでしょうか？ テストを先に書くからTDDなのでしょうか？ 正確にはそのどちらでもないようです。 今回はそのさわりの部分を解説していきます。 今回の記事は、こちらで書いた内容の修正版でもあります。 <a href="https://blog.oskn259.com/article/review_tdd" target="_blank" rel="noopener noreferrer">https://blog.oskn259.com/article/review_tdd</a>

イメージとして僕も知ってはいましたが、その時の僕のTDDに対する認識としてはこうでした。 <ul><li>テストを始めに全て書く</li><li>それをパスするようなコードを以って完成とする</li><li>仕様をテストという形で記載するので、開発者感での認識の齟齬を防止できる</li></ul> 実はこの認識こそ、TDDのごく一側面だけを切り取った代物だったのです。&nbsp;

フィボナッチ数列を生成するメソッドを作ってみましょう。 まずは、これぐらいなら即作れるだろう、というレベルのテストを書きます。

0を入力したら、そのフィボナッチ数である0が返るというテストです。 これを満たす実装は以下の通りです。

はい、簡単ですね。 言いたいことは分かります。 でもTDDではこれで良いんです。 常にテスト結果をグリーンに保ち、その後、すぐにグリーンにできる一歩を踏み出すのです。 はじめの一歩として<code>fib(0) === 0</code>を完成させたわけです。 では次なる一歩として<code>fib(1) === 1</code>となるテストを追加しましょう。

追加した部分のテストが落ちてしまうようです。 これが通るように実装を修正してみましょう。

・・・ 言いたいことは分かります。 でもTDDではこれで良いんです。 常にテスト結果をグリーンに保ち、その後、すぐにグリーンにできる一歩を踏み出すのです。 同じように進めていきます。&nbsp;&nbsp;

次なる一歩として、<code>fib(2), fib(3)</code>を追加しました。 テストが揃ってきたので、ここでリファクタを行います。 TDDにおけるリファクタとは、重複を排除することです。 このケースにおける重複とはなんでしょうか？ 例えば、テスト上の2という数字と実装での2という数字が重複しています。 このように、実装とテスト両方にわたって観察し、重複を探し出します。 では、重複を解消するにはどうするのでしょうか？ まず、実装上の<code>return 2</code>の2とは何でしょうか？ これはフィボナッチ数を計算する機能ですから、この2はそれ以前のフィボナッチ数である<code>1</code>と<code>1</code>を加算したものとなります。

このとき<code>return 1 + 1</code>の前者の1は、<code>expect(fib(1)).toBe(1);</code>としてテスト上に記載されている<code>fib(1)</code>の結果をベタ書きしたものです。 後者の2については<code>fib(2)</code>の結果です。 つまり、これらの<code>1</code>は重複しているのです！ 重複しない形に書き直しましょう。

より小さなステップでTDDを進めたければ、<code>return fib(2) - fib(1);</code>を挟んでも良いですが、ここでは少し大股に歩を進めました。 このようにして、フィボナッチ数を計算する機能がテストと共に完成します。

先のフィボナッチ数のケースが示す通り、TDDにおいてテストと実装はどちらが先ということはなく、両輪で進めていくものです。 これは僕が知っている「テストファースト」の概念を大きく修正してくれました。 要件全てをテストとして表現してそれをパスするコードを模索するというのは、（やり方としてアリだとは思いますが）それはTDDではないようです。 最初の一歩を踏み出すために小さなテストを書くことこそがテストファーストなのです。 またこれまで、完成したコードをより良いものにしていくという意味でリファクタという言葉を使っていましたが、TDDの文脈においてリファクタとは、重複を排除する開発過程のことを指しています。 言うなれば、TDDは単なる制約や手続きではなく思考のプロセスと言った方が近そうです。 こうした思考プロセスがなぜ有効なのかは100%解明されていませんし、本書でも明確にはされていませんが、TDDのサイクルを回すことで優れた設計に辿り着いたという例は多いようです。

振る舞い駆動開発(BDD) と テスト駆動開発(TDD)

そもそもテストとは、エラーになるであろう操作を意図的に行ってそうしたケースの存在を示すことですが、TDDにおけるテストでは現状の立ち位置を確認する役割と言えそうです。 それは本当にテストか？ 間違った理解を世に広めていないか？ という議論があり用語が一新されました。 その結果生まれたのがBDDで、<code>assertion</code> -&gt; <code>expect</code> や<code>test class</code> -&gt; <code>spec</code>のように、振る舞いを定義するという前提の単語が使用されるようになっています。 機能として両者は等しく、用語のみが入れ替わっています。

TDDなのでテストは完璧、ではない

リリースのために必要なテストは、 以下の軸に沿って4象限に分類できます。 <ul><li>技術面 &lt;-&gt; ビジネス面</li><li>チームの支援 &lt;-&gt; 製品の批評</li></ul> TDDで記述するテストは、技術面でチームを支援するものと言えそうです。 要するに、まだ3種類のテストが残っているのです。 具体的には、以下のようなテストが残されています。 <ul><li>セキュリティ検査</li><li>負荷検証</li><li>顧客による手動受け入れテスト</li><li>自動化されたストーリーテスト</li></ul>

フィボナッチ数の例で記述したようなユニットテストだけでなく、受け入れ条件のような大きい単位に対してもTDDは可能であるとされています。 アジャイルにおけるユーザーストーリーをテストとして記述するのです。 この場合、ユーザーストーリーを表す 「外側」のテストと、コーディング時に並行して記述する「内側」のテストの2つが存在することになります。 外側テストをパスするために、内側テストと実装の両輪でコードを書き進めるというイメージですね。 この「外側」テスト向けフレームワークとして、cucumberなどが挙げられます。 <a href="https://cucumber.io/" target="_blank" rel="noopener noreferrer">https://cucumber.io/</a>

今となっては随分浸透したTDDですが、今回本を読んでみて、簡単に習得できるものではないなという感想でした。 感覚や経験の占める割合が多いと思います。 フィボナッチ数の例にしても、以下のような事柄について決まった方法がなく、コーダーの経験に委ねられているのです。 <ul><li>一歩の大きさはどれぐらいが適切か？</li><li>そもそもその一歩として何を選ぶべきか？</li><li>どのタイミングでリファクタを始めるのか？</li></ul> この感覚を掴んでTDDの恩恵を真に受けるためには、いくらか経験が必要そうです。

本書にも記載がありましたが、重要なのは自分やPJにとっての最適解を見つけることです。 TDDでないからイケてない、ではありませんし、足し算のメソッドに100個のテストを書くのが適切とも思えません。 みんなが言ってるからではなく、自身の置かれた現状に最適な使い方を模索できると良いですね。 その結果、TDDは今回は不要ということもあり得るでしょう。 重要なのは、一つのスキルとして持っておくことです。

やはりお前らの言うテスト駆動開発は間違っている　

前回の記事では画面にHello Worldと表示をさせました。 今回の記事では、テンプレートの表示をしてみたいと思います。

テンプレートを利用してブラウザ上に表示させる

前回の記事では、簡単なWebページを表示させました。 しかし、ページの内容をテキストで表示させるというのは、実際Webサービスを運用する上であまり現実的ではないですし、見た目もあまり良くありません。 そのために、この記事ではHTMLファイルを作成して、画面に表示をさせる実装をしていきます。

※前提条件: 前回の記事にてDjangoの新規プロジェクト作成済みで、localhost:8000にてHello Worldが表示されていること ※開発環境(動作はMac環境を使用しています。) OS: MacOS Big Sur 11.4 Python: 3.9.7 Django: 3.1.7 IDE: PyCharm &nbsp; 前回ではsample_djangoというプロジェクトで作成をしましたので、sample_djangoとして解説を進めます。 別のプロジェクト名で作成した場合は読み替えてください。 &nbsp; sample_django/sample_dango/の配下のsettings.pyを開いてください。

settings.pyを開いたら、54行目付近のTEMPLATESの環境変数の中身を修正します。 DIRSの中に以下を入力してください。 settings.py os.path.join(BASE_DIR, 'templates') &nbsp;

このようにディレクトリの指定を行いました。 DIRSの中にos.path.join(BASE_DIR, 'templates')と入れることによりtemplateファイル(HTMLファイル)を入れることという意味になります。 BASE_DIRという引数を入れていますが、こちらはDjangoに用意されているという変数になります。 os.path.joinの第二引数に、'templates'についてはプロジェクト配下にあるディレクトリを指しています。もしアプリケーションの開発を進める上でディレクトリを変更することがあれば、settings.pyの環境変数の中身を変更して進めて開発を進めてください。

先程settings.pyに指定した、templatesディレクトリの作成に入ります。 os.path.join(BASE_DIR, 'templates')と記載しましたので、プロジェクト配下(manage.pyと同じ階層)に作成します。 ※Pycharmの操作でしたら、プロジェクト配下で右クリック→new→directoryをクリック ディクレクトリ名はtemplatesとしてください。

次にtemplatesディレクトリ配下でhtmlファイルを新規作成します。 templatesの上で右クリック→new→HTML Fileをクリック ファイル名はhello_worldとします。

PyCharmで作成すると、自動的にファイルの中身が入っております。

hello_world.htmlの&lt;body&gt;と&lt;/ body &gt;の間に以下の追記をしてください。 &nbsp; &lt;h1&gt;Hello_World&lt;/h1&gt; &lt;h2&gt;Hello_World&lt;/h2&gt; &lt;h3&gt;Hello_World&lt;/h3&gt; &lt;h4&gt;Hello_World&lt;/h4&gt; &lt;h5&gt;Hello_World&lt;/h5&gt; &nbsp; &nbsp; こちらの操作でtemplateファイルの準備ができました。 &nbsp;

次はviews.pyのファイルを編集していきます。 前回の記事で作成した、views.pyのファイルを開いてください。 階層は Sample_django/hello_world/views.py の場所にあります。 &nbsp;

views.pyの編集に入ります。 1行目のこちらの行を削除して下さい。 from django.http import HttpResponse 削除した1行目の箇所に以下のように書き換えてください。 from django.shortcuts import render &nbsp; そして、index関数の中身の5行目にて以下の文を削除してください。 return HttpResponse("Hello_world") 削除した箇所に以下の文を入れてください。 return render(request, 'hello_world.html') ※renderの第二引数はtemplates配下の呼び出したいHTMLファイルを指定しています。 Hello_world.html以外のファイルを作成した場合は書き換えてください。 &nbsp; &nbsp; &nbsp; &nbsp; views.pyの完成図 &nbsp; from django.shortcuts import render def index(request): &nbsp;&nbsp;&nbsp; return render(request, 'hello_world.html') &nbsp; これでviews.pyの編集は完了です。

次にurls.pyファイルの編集ですが、前回の記事の通りに進めていれば、こちらは編集不要であるかと思います。 &nbsp; 以下のようになっていればOKです。 urls.py from django.urls import path from . import views urlpatterns = [ &nbsp;&nbsp;&nbsp; path('', views.index, name='index'), ] &nbsp; ※views.pyの中の関数名がindex以外になっている場合は、pathの第２引数のviews.indexのindexの箇所を適切な関数名に書き換えてください。

ターミナルでsample_djangoの配下まで移動をして、以下のコマンドを実行してください。 python manage.py runserver &nbsp; ターミナルの画面

Webブラウザ(safariやchromeなど)のURLバーにlocalhost:8000を打ち込んでください。 以下のように表示されていれば成功です。

templateで変数を使用して表示させる

上記ではHTMLファイルで書いたものをそのまま表示しました。 templateの中にあるHTMLファイルは表示させるだけでなく、views.pyで定義した変数を使用して表示させることもできます。 &nbsp; では、hello_worldの配下のviews.pyの return render(request, 'hello_world.html') こちらの1行上に以下の文を入れてください。 sample_data = {'sample': 'サンプル'} こちらは辞書型でkeyがsample、valueがサンプルとしています。 return render(request, 'hello_world.html' こちらの第３引数に、先程定義したsample_dataを入れてください。 return render(request, 'hello_world.html', sample_data)

次にtemplatesディレクトリ配下のhello_world.htmlファイルですが、場所は&lt;body&gt;と&lt;/body&gt;の間でしたら、どこでも良いのですが、こちらの記事では12行目付近の &lt;h5&gt;Hello_World&lt;/h5&gt; の下に &lt;p&gt;{{sample}}&lt;/p&gt; と記載してください。 こちらはviews.pyで定義した、 sample_data = {'sample': 'サンプル'} sample_dataのkeyを指定して出力するので、{{sample}}という書き方になります。 &nbsp; ではもう一度、Webサーバーを起動してみてください。 python manage.py runserver 起動したら、Webブラウザlocalhost:8000上で以下のように表示されていれば成功です。

HTMLファイルで{{sample}}のキーを指定してます。 sample_data = {'sample': 'サンプル'} 表示結果はvalueのサンプルになります。

今回の記事では作成したテンプレートを利用して、HTMLのファイルをブラウザ上に表示させる方法を紹介しました。 手順としては １. setting.pyのDIRSの中にos.path.join(BASE_DIR, 'templates')の記載 ２. プロジェクト配下にtemplateディレクトリを作成して、そのディレクトリの中に表示させたいhtmlファイルを作成する ３. views.pyファイルにrenderのインポート文を追記し、使用する関数の戻り値にrendaerの第二引数を２で作成したhtmlファイルを指定する。 ４. urls.pyファイルにて、３で編集した関数を紐づけるように編集する ５. templatesでviews.pyで作成した変数を表示させるには、{{変数のキー名}}で表示をさせる &nbsp; &nbsp; 参考URL <a href="https://docs.djangoproject.com/ja/3.2/intro/tutorial03/" target="_blank" rel="noopener noreferrer">https://docs.djangoproject.com/ja/3.2/intro/tutorial03/</a> <a href="https://docs.djangoproject.com/ja/3.2/intro/tutorial04/"> https://docs.djangoproject.com/ja/3.2/intro/tutorial04/</a>

PythonのWebフレームワーク『Django』の紹介Ver.2

皆さんは、システムエンジニアとしてどの工程を担当していますか？ 上流工程を担当していますか？それとも下流工程を担当していますか？ &nbsp; フリーランスで働く以前に、システムエンジニアとして働く以上、システム開発工程を理解しておく必要があります。 &nbsp; そこで、シリーズ企画として、システム開発工程の概要から各工程の大切なこと、やっていく上でのコツをこのシリーズ企画でお届けできたらと思います。 &nbsp; まずは、ver1として、システム開発工程の概要をお届けします。 &nbsp; ぜひ、工程について再確認したい方は、ぜひご覧ください。

まず、システム開発工程の全体像です。

こちらの図をご覧ください。

これは、ウォーターフォールモデルと呼ばれるシステム開発の流れです。 みなさんも慣れ親しんだ図ではないでしょうか？ &nbsp; ウォーターフォールモデルとは、システム開発に要する工程を順番に進めていく方法です。 あらかじめ定めた工程計画を順番にこなすイメージです。 &nbsp; 高いところから水が流れ落ちる滝のように、前工程に戻らない点が特徴であり、最もポピュラーな開発モデルです。 &nbsp; ウォーターフォールモデルの最大のメリットは、工程の後戻りがないので、スケジュール策定や進捗管理を比較的行いやすい点です。 また、最もメジャーな開発モデルであるため、経験者であればシステム開発しやすいメリットもあります。 &nbsp; そして、デメリットとしては原則前工程に戻ることができないため、後工程になって欠陥や変更があった場合に、大幅にシステム開発が遅れる可能性がある点です。 大幅な納期遅れが生じる結果、市場の変化に対応しにくくなるデメリットも生じます。

では、もう一つ最近注目されている開発の流れにも目を向けてみましょう。

アジャイルモデルとは、素早くシステムを開発する方法の総称です。 最近、このモデルを使用するプロジェクトもあるので、聞いたことはあるのではないでしょうか？ &nbsp; アジャイル開発の工程では、顧客と開発会社同士の連携や協調、変化への対応を重視します。 &nbsp; 最大のメリットとしては、開発の期間を短縮化できる点です。 重要な機能からいち早くリリースできるので、素早い事業展開が可能になります。 &nbsp; またシステムを機能単位で開発するので、不具合や仕様変更にも柔軟かつ迅速に対応できる点もメリットとなります。 &nbsp; 顧客と開発者側が密にコミュニケーションを取りながらシステムを開発するので、理想的なシステムを作り上げることが出来るでしょう。 &nbsp; ただ、デメリットとして、厳密な計画を立てないので、スケジュール管理が難しいです。システム開発全体の管理が難しいので、管理次第では納期が遅れる危険があります。 &nbsp; この2つが、システム開発の流れでよく目にする形になります。このシリーズでは、ウォーターフォールモデルの流れを元に各工程のお話をしていきます。

システム開発は、要件定義という工程から始まります。 システム開発を依頼する側と開発する側が打ち合わせを行い、システムの性能・機能や運用方法などの「要件」を決定します。 システム開発を依頼する際、希望の機能や性能があるかと思います。その要求と開発会社側の認識にズレがある場合、結果的に希望とは異なるシステムになる恐れがありますので、認識のすり合わせが非常に重要です。

外部設計の工程では、システム使用者(ユーザー)の視点からシステムに必要な機能を洗い出し、それを基に大枠となるシステム設計を行います。 その際システムの仕様などが記された基本設計書を、ユーザー側が確認するケースもあります。

次に外部設計で決定した事項を基に、コンピュータでの実装を想定した上で、より詳細にシステムを設計します。 外部設計がユーザー視点からの設計である一方で、内部設計の工程ではコードやプログラムの設計など、開発者側からの視点でシステムを設計します。

内部設計での決定事項を基に、実際にプログラミング言語を用いて、システムを構築する工程になります。 家の建築で例えると、先ほどまでの工程が設計図の作成であった一方で、この工程以降は家を実際に建てる流れになります。

プログラミング工程が完了したら、実際に構築したプログラミングが作動するかをテストします。 システム開発では、小さい単位から大きい単位という流れでテストを行います。単体テストでは、プログラミングの対象単位(モジュール)ごとにテストします。

モジュール単位で問題が無ければ、各モジュール同士を結合してテストを行います。 例えば、データの受け渡しや画面の切り替わりなど、プログラム同士が正常に連携するかをテストします。

プログラム同士の連携が問題なければ、ユーザーが要求する機能や性能を満たしているかをテストする工程に入ります。 この工程では具体的に、処理速度や大量アクセスへの耐久などをテストします。

システムテストの工程に問題が無ければ、最後に運用テストを実施します。 運用テストでは、実際にシステムを運用する環境下で、開発したシステムに不具合がないかを確認します。

全てのテストをクリアしたら、完成したシステムをリリースする工程となります。

システムが完了したからといって、全ての工程が完了した訳ではありません。 なぜならシステムを使用し続ける過程で、何かしらの不具合が生じる場合があるからです。システムを効果的に活用し続ける為には、常にシステムを監視し、不具合が生じた際には即座に修正する必要があります。 &nbsp; この流れが、システム開発の流れになります。 1~3 の部分が、上流工程と言われることが多く、4~が下流工程といわれます。 ただ、下流工程に行くからと言って、上流工程が全く関わらないわけではなく、6~8の工程では、上流工程が密接に絡んできます。 その辺りは、次の記事からお話できればなと思います。

いかがでしたでしょうか？ 私は、システム開発の全行程を担当したことあります。どの工程に、こういう事を大切にしたいといけないということを、少しだけ感じられてると思いますので、次の記事から私の経験談も交えながら、お伝えしていこうと思います。 皆さんの今後の活躍のためになれば、幸いです。

【分かりやすく解説】システム開発工程ver1

土谷　貴志（つちたに　たかし）

システムエンジニアとして案件をこなしつつ、ライターとして執筆活動にもチャレンジ中。株式会社グラントホープ所属のフリーランスエンジニア。
システムエンジニアの他に、キャリアコンサルタントとして若者のキャリア支援や、LifeTime-Smileというコミュニティ運営など幅広く事業を展開中。
ごく稀に、コミュニティメンバーの記事を投稿するかも。お楽しみに！
LifeTime-Smile：https://www.lifetime-smile.com/


新着の記事一覧