Skip to content

Commit

Permalink
[Docs] Update Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
kurtyoon committed Feb 21, 2024
1 parent a109e11 commit b4b8e22
Showing 1 changed file with 104 additions and 30 deletions.
134 changes: 104 additions & 30 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,40 +1,114 @@
# 2024-SolutionChallenge-IFU
2024 GDSC Solution Challenge IFU 레포지토리입니다.

2024 GDSC Solution Challenge IFU Repository.

# GitHub Role

해당 Repository는 다음과 같은 Convention을 따릅니다.
This Repository follows the following Convention.

## Commit Convention

| 커밋 유형 | 설명 |
| --- | --- |
| Feat | 새로운 기능 추가 |
| Fix | 버그 수정 |
| Docs | 문서 수정 |
| Style | 코드 formatting, 세미콜론 누락, 코드 자체의 변경이 없는 경우 |
| Refactor | 코드 리팩토링 |
| Test | 테스트 코드, 리팩토링 테스트 코드 추가 |
| Chore | 패키지 매니저 수정, 그 외 기타 수정 ex) .gitignore |
| Design | CSS 등 사용자 UI 디자인 변경 |
| Comment | 필요한 주석 추가 및 변경 |
| Rename | 파일 또는 폴더 명을 수정하거나 옮기는 작업만인 경우 |
| Remove | 파일을 삭제하는 작업만 수행한 경우 |
| !BREAKING CHANGE | 커다란 API 변경의 경우 |
| !HOTFIX | 급하게 치명적인 버그를 고쳐야 하는 경우 |
| Commit type | Description |
| ---------------- | ------------------------------------------------------------- |
| Feat | Add new features |
| Fix | Fix bugs |
| Docs | Modifying documents |
| Style | Code formatting, missing semicolons, no change of code itself |
| Refactor | Code Refactoring |
| Test | Test code, add refactoring test code |
| Chore | Modifying Package Manager, Other Modifications ex) .gitignore |
| Design | Change user UI design such as CSS |
| Comment | Add and change required annotations |
| Rename | Only to modify or move a file or folder name |
| Remove | If you have only done the job of deleting a file |
| !BREAKING CHANGE | For large API changes |
| !HOTFIX | If you need to fix a fatal bug in a hurry |

## PR Convention

| 아이콘 | 코드 | 설명 |
| --- | --- | --- |
| 🧑🏻‍🎨 | :art | 코드의 구조/형태 개선 |
| ⚡️ | :zap | 성능 개선 |
| 🔥 | :fire | 코드/파일 삭제 |
| 🐛 | :bug | 버그 수정 |
| 🚑 | :ambulance | 긴급 수정 |
|| :sparkles | 새 기능 |
| 💄 | :lipstick | UI/스타일 파일 추가/수정 |
|| :rewind | 변경 내용 되돌리기 |
| 🔀 | :twisted_rightwards_arrows | 브랜치 합병 |
| 💡 | :bulb | 주석 추가/수정 |
| 🗃 | :card_file_box | 데이터베이스 관련 수정 |
| Icon | Code | Description |
| ---- | -------------------------- | ---------------------------------- |
| 🧑🏻‍🎨 | :art | Structure/Form Improvement of Code |
| ⚡️ | :zap | Performance Improvement |
| 🔥 | :fire | Delete Code/File |
| 🐛 | :bug | bug fix |
| 🚑 | :ambulance | Urgent Correction |
|| :sparkles | New Features |
| 💄 | :lipstick | UI/Style File Add/Modify |
|| :rewind | Revolve Changes |
| 🔀 | :twisted_rightwards_arrows | Branch Merger |
| 💡 | :bulb | add/modify annotations |
| 🗃 | :card_file_box | Database-related modifications |

# How to use?

## Get Dependency

```sh
flutter pub get
```

## Make .env files in assets/config/.env

We require the following environmental variables.

```
GEMINI_API_KEY = It is your Gemini api key
CONCEPT_WEB_URL = It is IFU-Web url
```

## Run flutter which OS you want

Recommend OS is IOS or Android

```sh
flutter run IOS
flutter run Android
```

If you want to run IFU-Web

```
yarn && yarn start
```

## IFU-Hybrid Dependencies

```
flutter:
sdk: flutter
cupertino_icons: ^1.0.2
flutter_native_splash: ^2.3.10
get: ^4.6.6
flutter_localization: ^0.2.0
dotenv: ^4.2.0
flutter_dotenv: ^5.1.0
intl: ^0.18.1
flutter_svg: ^2.0.9
webview_flutter: ^4.7.0
flutter_chat_ui:
git:
url: https://github.com/kurtyoon/flutter_chat_ui.git
ref: main
dio: ^5.4.1
speech_to_text: ^6.6.0
flutter_tts: ^3.8.5
uuid: ^4.3.3
google_generative_ai: ^0.2.0
```

## IFU-Web Dependencies

```
@angular/animations: ^17.1.0,
@angular/common: ^17.1.0,
@angular/compiler: ^17.1.0,
@angular/core: ^17.1.0,
@angular/forms: ^17.1.0,
@angular/platform-browser: ^17.1.0,
@angular/platform-browser-dynamic: ^17.1.0,
@angular/router: ^17.1.0,
rxjs: ~7.8.0,
tslib: ^2.3.0,
zone.js: ~0.14.3
```

0 comments on commit b4b8e22

Please sign in to comment.