⚠️ レビューしてくださる方へ
- これは全体的なReadmeです。専用の仕様書は「簡易仕様書サンプルアプリ.txt」で別途用意しております。（このプロジェクトのルートディレクトリ部分にあります）ご確認いただけると幸いです。
| 店舗一覧(light) | 店舗一覧(dark) |
|---|---|
| 詳細(light) | 詳細(dark) |
|---|---|
| 結果なし | エラー |
|---|---|
Simulator.Screen.Recording.-.iPhone.15.Pro.-.2024-02-23.at.03.18.01.mp4
- スマートフォンの位置情報を取得する
- 取得した位置情報から現在地付近のレストラン情報を検索できる
- 検索結果は一覧で概要を表示する
- 検索閣下のアイテムをタップしたら、大まかな店舗の情報（店舗名、住所、営業時間、閉業日、カテゴリ名）を表示する
- ”お店の詳細を見る”ボタンを押すと、詳細画面に画面遷移し以下の情報を表示する。（マップ表示ボタン、 Webブラウザ表示ボタン、Googleで検索できるボタン、住所、営業時間、閉業日、ジャンル、食べ放題、飲み放題、コース、総席数、禁煙、平均予算、カード決済、駐車場、バリアフリー、その他設備、備考）
- エラー発生時の処理
- 画面回転・さまざまな画面サイズ対応
- ダークモードの対応
- 多言語対応（英語、日本語）
- IDE:Visual Studio Code 1.86.1
- Flutter: 3.19.1
- Dart: 3.3.0
- サポートするプラットフォーム: iOS/Android
flutter_riverpod:^2.4.10
name: kokorahenn_flutter
description: "Facility Search Application"
publish_to: 'none'
version: 0.1.0
environment:
sdk: '>=3.2.3 <4.0.0'
dependencies:
cupertino_icons: ^1.0.6
dio: ^5.4.0
envied: ^0.5.3
expansion_tile_card: ^3.0.0
flutter:
sdk: flutter
flutter_localization: ^0.2.0
flutter_overboard: ^3.1.3
flutter_riverpod: ^2.4.10
flutter_svg: ^2.0.9
freezed: ^2.4.7
freezed_annotation: ^2.4.1
geolocator: ^11.0.0
json_annotation: ^4.8.1
map_launcher: ^3.1.0
package_info_plus: ^5.0.1
retrofit: ^4.1.0
settings_ui: ^2.0.2
share_plus: ^7.2.2
shared_preferences: ^2.2.2
slang: ^3.29.0
slang_flutter: ^3.29.0
url_launcher: ^6.2.4
dev_dependencies:
build_runner: ^2.4.8
envied_generator: ^0.5.3
flutter_gen_runner: ^5.4.0
flutter_launcher_icons: "^0.13.1"
flutter_lints: ^2.0.0
flutter_native_splash: ^2.3.11
json_serializable: ^6.7.1
pedantic_mono: any
retrofit_generator: ^8.1.0
slang_build_runner: ^3.29.0
flutter_test:
sdk: flutter
flutter:
uses-material-design: true
assets:
- assets/images/
flutter_icons:
android: true
ios: true
remove_alpha_ios: true
image_path: "assets/images/app_icon.png"
flutter_native_splash:
color: '#f19a38'
image: 'assets/images/splash_icon.png'
color_dark: '#f19a38'
image_dark: 'assets/images/splash_icon.png'
fullscreen: true
android_12:
icon_background_color: '#f19a38'
image: 'assets/images/splash_icon.png'
icon_background_color_dark: '#f19a38'
image_dark: 'assets/images/splash_icon.png'
lib
│ ├── api # APIの処理を担当するディレクトリ
│ │ ├── client # APIクライアントの設定
│ │ └── service # APIからデータを取得するサービス層
│ ├── constants # アプリ全体で使用する定数を管理（後で消すかも）
│ ├── i18n # 多言語対応
│ ├── main.dart # アプリのエントリーポイント
│ ├── model # データモデルの定義
│ │ ├── dto # APIから受け取ったデータの形状を定義
│ │ └── response # APIからのレスポンスデータの形状を定義
│ ├── screens # アプリの各画面を構成するウィジェットを格納するディレクトリ
│ ├── theme # アプリのテーマ設定（色、テキストスタイルなど）を管理するディレクトリ
│ └── widgets # 再利用可能なウィジェットを格納するディレクトリ
│ ├── detail # 詳細画面で使用するウィジェットを格納するディレクトリ
│ └── search # 検索機能に関連するウィジェットを格納するディレクトリ
- リポジトリのクローン
$ git clone https://github.com/gadgelogger/kokorahenn_flutter.git
- Dartのインストール
$ brew tap dart-lang/dart
$ brew install dart
- fvmをインストール
$ dart pub global activate fvm
- fvmへのパスを通す
export PATH="$PATH":"$HOME/.pub-cache/bin"
- fvmのインストール確認
$ fvm --version
3.0.1
- ディレクトリへ移動
$ cd kokorahenn_flutter
- fvm読み込み
$ fvm install
- 依存関係を読み込む
$ fvm flutter pub get
- freezedなどのコード生成
$ fvm dart run build_runner build -d
- ビルドラン
$ fvm flutter run
- GithubActionを使用
developまたはmainブランチにプルリクエストが出された時に動作する- フォーマットが崩れていないか
- build_runnerでのファイルの生成
- 静的解析に引っ掛かっていないか（警告が出ないか）
- issueドリブンで開発をしました。
- プルリクエストベースで開発をしました。
- コードの可読性を重視して、Widgetを分割しました。
- シンプルかつスタイリッシュなデザインを意識しました。
- さまざまな方に使ってもらいたい気持ちがあるため多言語対応をしました。
- テストの知見が浅いため、テストの実装ができなかった。
- UnitTest/WidgetTest/IntegrationTestなどを実装して品質をさらに高めたい
- https://github.com/hukusuke1007/flutter_app_template/tree/main/layer_first/lib/presentation
- このような”テストしやすいコード”を意識して実装したい。
- アーキテクチャの知見がなかったため導入できなかった。
- MVC/MVVMなどあるが、MVCをこのアプリに取り入れようかと思う。
- 本格的にGithubActionのCIを使ったが、便利さが感じられていいなと思った。（リリースビルドまで自動化してみたい）
- ページネーション機能（１ページだけではなくスクロールし続けたら次のインデックスを取得できるようにしたい）
- 他のカテゴリで絞り込める機能（今回は期間の都合上、検索半径だけでしたがジャンルで絞り込みなどをできるようにしたい）
- 他のAPIに切り替えるようにしたい（リクルートだけではなくPlaceAPIなども使えるようにして、レストラン以外の検索もできるようにしたい）
- テストを実装して品質保証を上げたい
- アーキテクチャを考慮した実装を行いたい
- 全体的なデザインを向上させたい
| 現状 | 目標 |
|---|---|
アプリのアイコンにはLordiconを使用しました。