document-parser

KO | EN

gitlite — search

#javascript #golang #go #android #machine-learning #rust #deep-learning #linux #docker #macos #awesome #security #openai #open-source

document-parser

(★ 18)

No description available.

document-parser Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 문서 파서 - AI 기반 문서 생성 도구

다양한 형식의 파일(Excel, PDF, CSV 등)을 업로드하여 AI로 자동 문서를 생성하는 Next.js 웹 애플리케이션입니다.

## 주요 기능

- 🤖 **AI 기반 문서 생성**: OpenAI GPT-4를 활용한 자동 문서 생성
- 📁 **다양한 파일 형식 지원**: Excel, CSV, PDF, TXT 등
- 📝 **템플릿 관리**: 커스텀 템플릿 생성 및 관리
- 🔐 **Supabase Auth**: 이메일/패스워드 및 Google OAuth 로그인
- 📱 **반응형 UI**: Tailwind CSS와 Shadcn UI 기반

## 기술 스택

- **Frontend**: Next.js 15 (App Router), TypeScript, Tailwind CSS, Shadcn UI
- **Backend**: tRPC, Supabase (PostgreSQL + Storage + Auth)
- **AI**: OpenAI GPT-4o, Vercel AI SDK
- **상태관리**: React Query, Zustand
- **배포**: Vercel

## 환경 설정

### 1. 프로젝트 클론 및 의존성 설치

```bash
git clone <repository-url>
cd document-parser
npm install
```

### 2. 환경 변수 설정

`.env.local` 파일을 생성하고 다음 환경 변수들을 설정하세요:

```env
# Supabase Configuration
NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key

# OpenAI Configuration (선택사항 - LLM 기능 사용 시 필요)
OPENAI_API_KEY=your_openai_api_key
```

### 3. Supabase 프로젝트 설정

#### 3.1 Supabase 프로젝트 생성

1. [Supabase](https://supabase.com)에서 새 프로젝트 생성
2. 프로젝트 URL과 anon key를 환경 변수에 설정

#### 3.2 데이터베이스 스키마 설정

```bash
# Supabase 마이그레이션 실행
# supabase/migrations/ 폴더의 SQL 파일들을 순서대로 실행
```

#### 3.3 Supabase Auth 설정

1. Supabase 대시보드 → Authentication → Settings
2. **Email 인증 설정**:

- Confirm email: 활성화 (선택사항)
   - Enable email confirmations: 체크 (선택사항)

3. **Google OAuth 설정** (선택사항):

- Google Cloud Console에서 OAuth 2.0 클라이언트 ID 생성
   - Authorized redirect URIs에 `https://your-project.supabase.co/auth/v1/callback` 추가
   - Supabase → Authentication → Providers → Google에서 설정
   - Client ID와 Client Secret 입력

4. **Site URL 설정**:
   - Development: `http://localhost:3000`
   - Production: `https://your-domain.com`

#### 3.4 RLS (Row Level Security) 정책 설정

데이터베이스의 각 테이블에 대해 적절한 RLS 정책을 설정해야 합니다:

```sql
-- users 테이블 RLS 정책 예시
ALTER TABLE users ENABLE ROW LEVEL SECURITY;

CREATE POLICY "Users can view own profile" ON users
    FOR SELECT USING (auth.uid() = id);

CREATE POLICY "Users can update own profile" ON users
    FOR UPDATE USING (auth.uid() = id);
```

### 4. 개발 서버 실행

```bash
npm run dev
```

[http://localhost:3000](http://localhost:3000)에서 애플리케이션을 확인할 수 있습니다.

## 사용 방법

### 1. 계정 생성 및 로그인

- 이메일/패스워드로 회원가입
- 또는 Google 계정으로 로그인

### 2. 템플릿 생성

- 템플릿 페이지에서 새 템플릿 생성
- Markdown 형식으로 문서 템플릿 작성
- 필드 매핑 설정

### 3. 문서 생성

- 문서 관리 페이지에서 파일 업로드
- 템플릿 선택
- AI가 자동으로 문서 생성

## 프로젝트 구조

```
src/
├── app/                    # Next.js App Router
│   ├── api/               # API 라우트
│   ├── auth/              # 인증 관련 페이지
│   ├── documents/         # 문서 관리 페이지
│   ├── templates/         # 템플릿 관리 페이지
│   └── login/             # 로그인 페이지
├── components/            # 재사용 가능한 컴포넌트
│   ├── ui/               # Shadcn UI 컴포넌트
│   ├── navigation/       # 네비게이션 컴포넌트
│   └── template/         # 템플릿 관련 컴포넌트
├── hooks/                # 커스텀 훅
├── lib/                  # 유틸리티 및 설정
│   ├── supabase/        # Supabase 클라이언트
│   ├── trpc/            # tRPC 설정
│   ├── llm/             # LLM 관련 유틸리티
│   └── types/           # TypeScript 타입 정의
└── middleware.ts         # Next.js 미들웨어 (인증)
```

## 개발 가이드

### 인증 플로우

1. 사용자가 로그인 시도
2. Supabase Auth가 인증 처리
3. 미들웨어가 세션 자동 새로고침
4. 보호된 라우트 접근 시 인증 상태 확인

### tRPC API 구조

- `template`: 템플릿 CRUD 작업
- `document`: 문서 생성 및 관리
- `version`: 템플릿 버전 관리

### 환경별 설정

- **Development**: localhost:3000
- **Production**: Vercel 자동 배포

## 배포

### Vercel 배포

1. Vercel에서 GitHub 저장소 연결
2. 환경 변수 설정
3. 자동 배포 확인

### 환경 변수 (Production)

- `NEXT_PUBLIC_SUPABASE_URL`
- `NEXT_PUBLIC_SUPABASE_ANON_KEY`
- `SUPABASE_SERVICE_ROLE_KEY`
- `OPENAI_API_KEY`

## 문제 해결

### 자주 발생하는 문제

1. **인증 오류**: Supabase URL과 키가 올바른지 확인
2. **CORS 오류**: Supabase Site URL 설정 확인
3. **OAuth 오류**: Google OAuth 설정 및 리다이렉트 URL 확인

### 로그 확인

- 브라우저 개발자 도구 콘솔
- Vercel 배포 로그
- Supabase 대시보드 로그

## 기여하기

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## 라이선스

이 프로젝트는 MIT 라이선스 하에 있습니다.

document-parser

document-parser Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

document-parser

document-parser Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README