📌 이름 기반 가명 생성기 (Name-based Alias Generator)

사용자가 입력한 한글 이름의 구조를 분석하여 규칙 기반 알고리즘으로 한국식 가명을 생성하는 웹 서비스입니다.

단순 랜덤 문자열 생성이 아닌 이름 길이·중간 글자·성별 조건을 반영해 가명을 생성하도록 설계했습니다.

📌 주요 기능

이름 구조 분석

입력된 이름에서 중간 글자를 추출

4글자 이상일 경우 가운데 2글자 중 1글자를 랜덤 선택

한국식 성씨 적용

김, 이, 박 등 단성(1글자 성)

남궁, 제갈, 선우 등 복성(2글자 성) 포함

성별 분리 로직

성별(F/M)에 따라 서로 다른 이름 끝 글자 후보군 사용

실제 한국 이름에서 자주 사용되는 음절 기반 설계

웹 UI 제공

브라우저에서 이름 입력 → 버튼 클릭으로 가명 생성

FastAPI 서버와 비동기 통신(fetch API)

🛠 기술 스택 Backend : Python, FastAPI Frontend : HTML, CSS, Vanilla JavaScript API : RESTful POST API (/nickname) Server : Uvicorn (local development)

📌 API 구조 POST /nickname

Request Body

{ "name": "오나연", "gender": "F" }

Response

{ "ok": true, "alias": "김나원", "input_name": "오나연", "gender": "F" }

설계 포인트

입력 데이터를 그대로 사용하지 않고, 문자열 길이와 위치 기반 조건 분기 로직을 적용

동일한 입력이라도 조건(성별, 이름 길이)에 따라 서로 다른 결과가 나오도록 알고리즘 설계

프론트엔드와 백엔드의 역할을 분리하여 API 중심 구조로 구현

📌 실행 방법 (로컬)

가상환경 활성화

venv\Scripts\activate

서버 실행

python -m uvicorn main:app --reload

브라우저 접속:

http://127.0.0.1:8000

💡 향후 개선 사항

동일한 입력에 대해 결과를 고정하는 deterministic 모드 추가

방문자 수 및 요청 횟수 통계 API 구현

클라우드 환경(Render 등) 배포

📌 프로젝트 의의

입력 데이터를 단순히 랜덤 처리하지 않고, 조건 기반 문자열 분석 로직을 직접 설계하여 규칙 기반 데이터 생성 API를 구현한 첫 백엔드 프로젝트입니다.