-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #7 from Suyeon-Stom-Hwang/fixREADME
Fix readme description
- Loading branch information
Showing
1 changed file
with
47 additions
and
25 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,34 +1,56 @@ | ||
# HCI 2024 Team project @SNU - AI Tutor service for English learning | ||
|
||
## To Be writed | ||
|
||
# React + TypeScript + Vite | ||
|
||
This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules. | ||
## Introduction | ||
SNU 2024 인간컴퓨터상호작용 과목에 대한 4 Team의 Team project 구현물에 대한 레포지토리입니다. | ||
|
||
## Developer environment | ||
이 프로젝트는 다음과 같은 환경에서 개발했습니다. | ||
|
||
- Language: TypeScript | ||
- Library & Framework : React / Vite | ||
|
||
## Getting start | ||
### Prerequisite | ||
#### Node.js & NPM | ||
React 및 Vite 프레임워크 사용을 위하여 Node.js version 18 이상이 권장됩니다. | ||
Node.js 설치 및 NPM 패키지 설치에 대한 자세한 내용은 https://nodejs.org/en 를 참고바랍니다. | ||
|
||
#### Open AI | ||
GPT 모델을 사용하기 위하여 OpenAI의 API key가 필요합니다. | ||
API key 획득에 대한 자세한 내용은 https://platform.openai.com/docs/quickstart 를 참고바랍니다. | ||
|
||
#### Web Browser | ||
최신 버전의 Chrome 및 Edge 브라우저 사용을 권장합니다. | ||
|
||
### Install & Run | ||
#### Clone git | ||
Git repository를 clone 하여 소스코드를 다운로드합니다. | ||
```bash | ||
git clone https://github.com/Suyeon-Stom-Hwang/HCI_Project.git | ||
cd HCI_Project | ||
``` | ||
|
||
Currently, two official plugins are available: | ||
#### Set API Key | ||
프로젝트 최상단에 `.env` 파일을 생성하고 다음과 같이 API key를 작성합니다. | ||
이 때 `.env` 파일이 없거나 유효한 API key가 입력되어 있지 않다면 시스템이 정상적으로 동작하지 않습니다. | ||
|
||
- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md) uses [Babel](https://babeljs.io/) for Fast Refresh | ||
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh | ||
``` | ||
VITE_OPENAI_API_KEY="your api key" | ||
``` | ||
|
||
## Expanding the ESLint configuration | ||
#### Run system | ||
아래 명령을 입력하여 필수 패키지 설치 및 시스템을 실행합니다. | ||
|
||
If you are developing a production application, we recommend updating the configuration to enable type aware lint rules: | ||
```bash | ||
npm install | ||
npm run dev | ||
``` | ||
|
||
- Configure the top-level `parserOptions` property like this: | ||
`npm run dev`가 성공하였다면 화면 상에 표시되는 `Local` 주소로 접속하여 시스템 사용을 시작합니다. | ||
```bash | ||
VITE v5.2.12 ready in 390 ms | ||
|
||
```js | ||
export default { | ||
// other rules... | ||
parserOptions: { | ||
ecmaVersion: 'latest', | ||
sourceType: 'module', | ||
project: ['./tsconfig.json', './tsconfig.node.json'], | ||
tsconfigRootDir: __dirname, | ||
}, | ||
} | ||
➜ Local: http://localhost:5173/ | ||
➜ Network: use --host to expose | ||
➜ press h + enter to show help | ||
``` | ||
|
||
- Replace `plugin:@typescript-eslint/recommended` to `plugin:@typescript-eslint/recommended-type-checked` or `plugin:@typescript-eslint/strict-type-checked` | ||
- Optionally add `plugin:@typescript-eslint/stylistic-type-checked` | ||
- Install [eslint-plugin-react](https://github.com/jsx-eslint/eslint-plugin-react) and add `plugin:react/recommended` & `plugin:react/jsx-runtime` to the `extends` list |