株式会社ゆめみ iOS 未経験者エンジニア向けコードチェック課題

概要

本エンドポイントは株式会社ゆめみ（以下弊社）が、弊社に iOS エンジニアを希望する未経験の方に出す課題のバックエンドです。未経験者の方はリファクタリングの課題もしくは本課題のいずれかを提出してください。本課題をお選びの方は、下記を詳しく読んだ上で課題に取り組んでください。

アプリ仕様

「あなたと相性のいい都道府県を占ってあげる！」をテーマに iPhone アプリを作ってください。API 仕様下記の通りです。

API 仕様

（詳細は OpenAPI のページもご参考にしてください）

• Base URL:

"https://yumemi-ios-junior-engineer-codecheck.app.swift.cloud"

• End Point:

"/my_fortune"

• HTTP Method:

"POST"

• HTTP Request Headers:

Key	Value
"API-Version"	"v1"

※"v1"を他の文字列で置き換えると EndPoint.APIVersion.InitializationError エラーになります；またこのヘッダーを省略すること自体は可能ですが、将来API仕様が変わる可能性があるため、入れることをお勧めします。

• HTTP Body:

Key	Type	Description	Sample Value
"name"	String	占う人の名前	"ゆめみん"
"birthday"	YearMonthDay（後述）	占う人の生年月日	-
"blood_type"	String	占う人の血液型	"ab"
"today"	YearMonthDay（後述）	今日の日付	-

YearMonthDay 型の仕様：

Key	Type	Description	Sample Value
"year"	Int	年	2000
"month"	Int	月	1
"day"	Int	日	27

JSON サンプル

        {
            "name": "ゆめみん",
            "birthday": {
                "year": 2000,
                "month": 1,
                "day": 27
            },
            "blood_type": "ab",
            "today": {
                "year": 2023,
                "month": 5,
                "day": 5
            }
        }

• Response Body

Key	Type	Description	Sample Value
"name"	String	都道府県の名前	"富山県"
"capital"	String	県庁所在地	"富山市"
"citizen_day"	MonthDay?（後述）	県民の日（もしあれば）	-
"has_coast_line"	Bool	海岸線があるかどうか	true
"logo_url"	String	ロゴのURL	"https://japan-map.com/wp-content/uploads/toyama.png"
"brief"	String	都道府県の概要	"富山県（とやまけん）は、日本の中部地方に位置する県。県庁所在地は富山市。\n中部地方の日本海側、新潟県を含めた場合の北陸地方のほぼ中央にある。\n※出典: フリー百科事典『ウィキペディア（Wikipedia）』"

MonthDay 型の仕様：

Key	Type	Description	Sample Value
"month"	Int	月	5
"day"	Int	日	9

JSON サンプル

        {
            "name": "富山県",
            "has_coast_line": true,
            "citizen_day": {
                "month": 5,
                "day": 9
            },
            "capital": "富山市",
            "logo_url": "https://japan-map.com/wp-content/uploads/toyama.png"
            "brief": "富山県（とやまけん）は、日本の中部地方に位置する県。県庁所在地は富山市。\n中部地方の日本海側、新潟県を含めた場合の北陸地方のほぼ中央にある。\n※出典: フリー百科事典『ウィキペディア（Wikipedia）』",
        }

環境

• IDE：基本最新の安定版（本概要最終更新時点では Xcode 14.3）
• Swift：基本最新の安定版（本概要最終更新時点では Swift 5.8）
• 開発ターゲット：基本最新の安定版（本概要最終更新時点では iOS 16.4）

動作

1. ユーザから名前、生年月日及び血液型を入力してもらいます。
2. 上記のデータと併せて、送信時の日付も一緒に入れて、上記の API に問い合わせてください。
3. 結果をもらったらその結果を表示してください。
1. そのうち logo_url の部分は、その URL をパースし、該当 URL から画像データを取得し、その画像を表示してください。

注意点

1. 必ず git でプロジェクトを管理し、git ホスティングサービスで提出してください。
1. ホスティングサービスは GitHub 推奨です。ただし git リポジトリーをそのまま zip 化して提出することは NG です。
2. git で提出してもらう理由は実装の途中経過を評価するためなので、いわゆるワンコミットの提出や、パッと全部やっつけた雑なコミットが含まれる提出物は評価できないため NG です。必ずコミット粒度を意識して作ってください。もちろんブランチ運用や PR 運用も高評価ポイントになります。
3. GitHub で提出時に公開リポジトリーで提出したくない場合は、提出時にその旨をキャスターさんに伝えてください、コードチェック担当者の GitHub アカウントを返送しますので該当者に Read 権限を付与してください。
2. UI の指定はありませんが、UI/UX への考慮も評価ポイントになります。
1. 特に Dark Mode や横画面など、iOS がデフォルトで利用可能な機能について気をつけてください。例えば Dark Mode で文字が読めないような実装は減点ポイントになります。
3. 上記の動作さえ満たす限り、機能の追加等はウェルカムです。
1. 例：占い結果をローカルに保存する、iPad/Mac 対応、などなど。
4. サードパーティーライブラリーの利用については、オープンソースのものに限り制限しません（むしろ推奨です）。
1. CocoaPods と Carthage についても利用 OK ですが、SwiftPM の方を推奨します。
5. SDK は UIKit および SwiftUI どちらでも OK です。
1. 両方の混在も OK です。
6. ChatGPTなどAIサービスの利用は禁止しておりません。
1. 利用にあたって工夫したプロンプトやソースコメント等をご提出頂くと加点評価する場合がございます。 (減点評価はありません)

参考記事

• 本特別課題の評価方法等に関しては、こちらの記事に詳しく書かれてありますので、ぜひご覧ください。
• CocoaPods の利用に関しては こちらの記事も参照ください。

その他注意

• 本課題はあくまで未経験者向けの特別課題です。中途採用のご応募では本課題を選択できません。
• 第二新卒等の場合は、エンジニア職経験がない方に限定せていただきます。
• 本課題を提出する場合、通常課題をこなす必要がありません。
• ただし課題の性質上、レビュー期間は通常課題より長めに設けさせていただきます（目安としておおよそ 1 週間です）。
• また通常課題と違い、明確なチケットに基づいた選考基準は現在ありません。あなたが思う「いいアプリ」を作ってください。
• 本課題は、iOS アプリ開発のスキルを選考するためのものです。そのため、本課題の内容をもとにしたアプリを App Store に公開することは禁止しております。

謝辞

各都道府県のロゴ画像は、日本地図無料イラスト素材集様の都道府県シルエット画像を利用しています。

本ページは、ChatGPTの協力で作成しました。