Wanted Pre-onboarding 10월 FE 코스 4일차 실습

4일차 실습을 위한 스켈레톤 코드 및 샘플 서버입니다. 강의를 듣고 설명에 따라 실습을 진행해보세요!

CORS

로컬에서 CORS 요청을 허용할 수 있는 브라우저 페이지를 연 뒤, 해당 페이지에서 클라이언트를 실행하여 실습을 진행해 주세요.

의존성 설치

실습 4도 실습 3과 같이 서버 실행이 필요합니다. 다음 명령어를 이용해 필요한 의존성들을 설치합니다.

  $ yarn initialize

의존성 설치가 완료되었다면 서버와 클라이언트를 모두 실행하고 실습을 진행합니다.

서버 실행 방법

예제 서버에는 세션 로그인 기능이 구현되어 있습니다. 서버를 직접 수정하거나 할 필요는 없지만, 실습 진행을 위해 각자 로컬 환경에 서버를 실행하여야 합니다.

  # 서버 실행
  $ yarn server
  
  # 혹은 디렉토리 이동 후 직접 실행도 가능합니다. 위 명령어와 같은 내용입니다.
  $ cd server && yarn start

서버는 4000번 포트를 사용합니다. 서버가 정상적으로 실행되었다면 브라우저를 통해 localhost:4000에 접근하였을 때 'Hello World!'가 출력됩니다.

클라이언트 실행 방법

실습용 클라이언트는 (항상 그렇듯) Vite를 이용한 SPA 앱으로 구성되어 있습니다.

실행을 위해서는 프로젝트 루트에서 아래 명령어를 실행합니다.

  # 클라이언트 실행
  $ yarn client

  # 혹은 디렉토리 이동 후 직접 실행도 가능합니다. 위 명령어와 같은 내용입니다.
  $ cd client && yarn dev

API 스펙

서버에서는 다음과 같은 API를 제공합니다.

로그인 (POST /auth/login)
- body에 username과 password를 담아 전송합니다. 즉, 다음과 같이 호출합니다.
```
  const args = {
    username: 'blue',
    password: '1234!@#$' 
  }
 
  const loginRes = await fetch(`${ BASE_URL }/auth/login`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      credentials: 'include' // <- 중요! 세션 방식 로그인을 위해 꼭 설정해 주세요. 
    },
      body: JSON.stringify(args)
    })
```
- 로그인 성공시 세션에 유저 정보를 저장합니다.
- 성공 시 세션이 생성되며, 이후 별도 인증 없이 접근 가능한 /profile을 통해 유저 정보를 가져올 수 있습니다.
- 계정 정보는 다음과 같습니다.
  - username: blue, password: 1234!@#$
  - username: white, password: 1234!@#$
  - username: red, password: 1234!@#$
유저 정보 가져오기 (GET /profile)
- 세션에 저장된 유저 정보를 반환합니다.
- 유저
- credentials: 'include' 옵션을 활성화 하는 경우 별도 개발 없이도 자동으로 로그인 여부를 검증하므로, 유저 정보 수신 성공여부만 확인하면 됩니다.
- 반환되는 데이터 타입은 다음과 같습니다.
```
  interface User {
    userId: number
    username: string
    userInfo: {
      name: blueStragglr
      roles: ['user', 'admin'] // 새로 추가된 부분!
    }
  }
```

유저의 item 가져오기 (GET /items)

세션에 저장된 유저 정보를 확인하여 해당 유저 소유로 저장된 모든 item을 가져옵니다.

반환되는 데이터 타입은 다음과 같습니다.

export interface Item {
   id: number // pk
   owner: {
      userId: number
   },
   content: {
      title: string
      body: string
   }
}

const response: Items[] = [...]

모든 유저의 item 가져오기 (GET /all-items, admin 전용)
- 세션에 저장된 유저가 admin일 때만 호출할 수 있습니다.
- 서버에서 validation 하므로, 클라이언트에서는 별도로 필터링하지 않아도 됩니다.
- 반환되는 데이터 타입은 다음과 같습니다.
```
export interface Item {
   id: number // pk
   owner: {
      userId: number
   },
   content: {
      title: string
      body: string
   }
}

const response: Items[] = [...]
```
로그아웃 (POST, /logout)
- 현재 유저가 로그인되어 있는 세션을 destroy합니다.
- 응답으로 메시지가 오긴 하지만, 사용하지 않아도 됩니다.

ziyunn / pre_onboarding_4