배경 (Background)

• 프로젝트 목표 (Objective): 사용자을 식별하고 적절한 권한을 부여하기 위해 존재 한다.

설계 및 기술 자료 (Architecture and Technical Documentation)

<aside> 💡

🤔 이 섹션은 왜 필요한가요?

• 프로젝트를 어떻게 구현할 것인지 구체적인 기술 계획을 담습니다.
• API 명세, 데이터베이스 스키마(ERD), 시스템 구조, 사용 기술 등을 명시하여 개발자들이 참조할 수 있도록 합니다.
• 기술적인 결정과 그 근거를 기록하여 추후 유지보수나 변경 시 참고 자료로 활용됩니다. </aside>

데이터베이스 스키마 (ERD)

• https://www.erdcloud.com/d/WQz8csSSN3qhmBWiE
• 주요 테이블:
  • account: 계정 정보(로그인 정보)
  • users: 회원 정보(이름, 이메일, 전화번호, 유선전화 등)
• DDL (Data Definition Language):

CREATE TABLE `account` (
	`id`	INT	NOT NULL,
	`login_email`	VARCHAR(320)	NOT NULL,
	`logged_at`	TIMESTAMP	NULL,
	`created_at`	TIMESTAMP	NOT NULL,
	`deleted_at`	TIMESTAMP	NULL
);

CREATE TABLE `oauth` (
	`id`	INT	NOT NULL,
	`account_id`	INT	NOT NULL	COMMENT 'index',
	`provider`	VARCHAR(20)	NOT NULL,
	`provider_id`	VARCHAR(255)	NOT NULL
);

CREATE TABLE `refresh_token` (
	`Id`	INT	NOT NULL,
	`user_id`	INT	NOT NULL,
	`token_value`	VARCHAR(64)	NOT NULL	COMMENT 'SHA-256으로 해싱',
	`created_at`	TIMESTAMP	NOT NULL,
	`updated_at`	TIMESTAMP	NULL,
	`expiry_date`	TIMESTAMP	NULL	COMMENT '만료기간:생성일자로 부터 2주'
);

다만 refers_token은 이후 redis로 옮겨질 예정

redisTemplate.opsForValue().set("rt:" + newHashedToken, userId, 14, TimeUnit.DAYS)

API 명세 (API Specifications)

소셜 로그인 API

• API 명세:
  • POST /api/auth/login/{provider}