{"id":50324992,"url":"https://github.com/pathcosmos/tms-embed-web","last_synced_at":"2026-05-29T05:04:28.359Z","repository":{"id":315438918,"uuid":"1059508767","full_name":"pathcosmos/tms-embed-web","owner":"pathcosmos","description":"tms-embed-web","archived":false,"fork":false,"pushed_at":"2025-09-30T06:33:24.000Z","size":364,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-30T08:33:49.652Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pathcosmos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-18T14:37:49.000Z","updated_at":"2025-09-30T06:33:27.000Z","dependencies_parsed_at":"2025-09-18T17:22:53.319Z","dependency_job_id":"635be009-d44f-4060-a49d-092e08d87ef3","html_url":"https://github.com/pathcosmos/tms-embed-web","commit_stats":null,"previous_names":["pathcosmos/tms-embed-web"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pathcosmos/tms-embed-web","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pathcosmos%2Ftms-embed-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pathcosmos%2Ftms-embed-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pathcosmos%2Ftms-embed-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pathcosmos%2Ftms-embed-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pathcosmos","download_url":"https://codeload.github.com/pathcosmos/tms-embed-web/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pathcosmos%2Ftms-embed-web/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33637486,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-29T05:04:15.224Z","updated_at":"2026-05-29T05:04:28.322Z","avatar_url":"https://github.com/pathcosmos.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 차량 입출차 관리 시스템 (TMS Embed Web)\n\n모바일 웹 기반의 차량 입출차 관리 시스템으로, QR 코드를 통한 효율적인 차량 관리가 가능합니다.\n\n## 🚀 주요 기능\n\n- **차량 정보 입력**: 차량번호, 기사 이름, 기사 전화번호 입력\n- **입출차 구분**: 입차/출차 선택 기능\n- **개인정보 동의**: 개인정보 수집 및 활용 동의 절차\n- **QR 코드 생성**: 입력된 정보를 바탕으로 QR 코드 자동 생성\n- **모바일 최적화**: 반응형 디자인으로 모바일 환경에 최적화\n- **화면 밝기 안내**: QR 코드 스캔을 위한 화면 밝기 조절 안내\n\n## 🛠️ 기술 스택\n\n- **Frontend**: React 19 + TypeScript + Vite\n- **Styling**: Tailwind CSS\n- **Form Management**: React Hook Form + Zod\n- **QR Code**: qrcode.js\n- **Icons**: Lucide React\n\n## 📱 모바일 최적화\n\n- 반응형 디자인 (모바일 우선)\n- 터치 친화적 UI/UX\n- PWA 지원 (Progressive Web App)\n- 화면 밝기 조절 안내 기능\n\n## 🚀 시작하기\n\n### 설치\n\n```bash\nnpm install\n```\n\n### 개발 서버 실행\n\n```bash\nnpm run dev\n```\n\n### 빌드\n\n```bash\nnpm run build\n```\n\n### 미리보기\n\n```bash\nnpm run preview\n```\n\n## 📋 사용 방법\n\n1. **차량 정보 입력**\n   - 차량번호 (예: 12가3456)\n   - 기사 이름\n   - 기사 전화번호 (예: 010-1234-5678)\n   - 입차/출차 구분 선택\n\n2. **개인정보 동의**\n   - 개인정보 수집 및 활용 동의 약관 확인\n   - 동의 체크박스 선택\n\n3. **QR 코드 생성 및 표시**\n   - 입력된 정보를 바탕으로 QR 코드 자동 생성\n   - QR 코드를 스캔하여 입출차 처리\n\n## 🔧 화면 밝기 조절\n\n웹 브라우저 보안 정책상 직접적인 화면 밝기 조절은 불가능합니다. 대신:\n\n- QR 코드 표시 시 화면 밝기 조절 안내 메시지 표시\n- QR 코드 대비도 최적화 (흰 배경, 검은 QR코드)\n- 충분한 크기로 QR코드 표시\n\n## 📁 프로젝트 구조\n\n```\nsrc/\n├── components/          # 재사용 가능한 컴포넌트\n│   ├── VehicleForm.tsx     # 차량 정보 입력 폼\n│   ├── PrivacyConsent.tsx  # 개인정보 동의 컴포넌트\n│   └── QRCodeDisplay.tsx   # QR 코드 표시 컴포넌트\n├── data/               # 정적 데이터\n│   └── privacyPolicy.ts    # 개인정보 약관\n├── types/              # TypeScript 타입 정의\n│   └── index.ts\n├── utils/              # 유틸리티 함수\n│   ├── validation.ts       # 폼 검증 스키마\n│   └── qrCode.ts          # QR 코드 생성 유틸리티\n├── App.tsx             # 메인 앱 컴포넌트\n├── main.tsx           # 앱 진입점\n└── index.css          # 글로벌 스타일\n```\n\n## 🎨 UI/UX 특징\n\n- **모바일 우선 설계**: 320px 이상의 모든 모바일 기기 지원\n- **직관적인 인터페이스**: 단계별 안내와 명확한 버튼 배치\n- **접근성 고려**: 키보드 네비게이션 및 스크린 리더 지원\n- **한국어 최적화**: Pretendard 폰트 사용\n\n## 🔒 보안 및 개인정보\n\n- 개인정보 수집 및 활용에 대한 명시적 동의\n- 클라이언트 사이드 QR 코드 생성 (서버 전송 없음)\n- 입력 데이터 검증 및 오류 처리\n\n## 📱 PWA 지원\n\n- 모바일 앱과 유사한 사용자 경험\n- 홈 화면에 추가 가능\n- 오프라인에서도 기본 기능 사용 가능\n\n## 🚀 배포\n\n빌드된 파일은 `dist` 폴더에 생성되며, 정적 웹 서버에 배포할 수 있습니다.\n\n```bash\nnpm run build\n# dist 폴더의 내용을 웹 서버에 업로드\n```\n\n## 📄 라이선스\n\n이 프로젝트는 MIT 라이선스 하에 있습니다.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpathcosmos%2Ftms-embed-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpathcosmos%2Ftms-embed-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpathcosmos%2Ftms-embed-web/lists"}