NeuraVision이 제공하는 기능
NeuraVision은 AI 콘텐츠 생성 제품을 위한 백엔드 엔진입니다. 이 저장소에는 회원 대시보드, 백엔드 API, 인증, 자체 호스팅 분석 및 트래픽 분할 추적기의 서버 측 로직이 포함되어 있습니다.
이 내보내기에는 코드만 포함됩니다. 랜딩 페이지, 마케팅 콘텐츠, 미디어, 대시보드 에셋, 환경 파일, 데이터베이스 또는 사용자가 제출한 파일은 포함되지 않습니다.
프로젝트 구조
주요 디렉터리는 특정 백엔드 책임에 따라 구성되어 있습니다:
api/에는 다운로드, 생성 요청, OAuth 및 결제를 위한 백엔드 엔드포인트가 포함되어 있습니다.functions/는 인증, 이메일, SMS, 캡차 및 리뷰를 위한 공용 PHP 헬퍼를 제공합니다.lk/에는 회원 대시보드 백엔드 로직이 포함되어 있습니다.auth/,auth.php,register.php및logout.php는 로그인, 회원가입, Google 또는 Twitter OAuth 흐름을 구현합니다.chat/에는 지원 채팅 위젯 백엔드가 포함되어 있습니다.data/에는 캠페인 발송 및 CAPI 릴레이를 위한 예약 작업이 포함되어 있습니다.a/에는 자체 호스팅 분석 수집기와 지역 조회 로직이 포함되어 있습니다.PHPMailer/에는 벤더로 포함된 메일 라이브러리가 들어 있습니다.
하위 시스템별 설명은 ENGINE.md를 참조하세요. 이 문서에서는 실제로 작동하는 엔진 구성 요소와 데모 또는 리드 전용 영역을 구분해 설명합니다.
요구 사항 및 구성
NeuraVision은 nginx 또는 Apache 뒤에서 PHP 7.4 이상으로 실행됩니다. 저장소에는 SQLite를 사용하며 별도의 빌드 단계가 필요하지 않습니다.
구성은 환경 변수를 통해 제공됩니다. 저장소에는 광고 플랫폼, SMTP 또는 Resend, hCaptcha 및 Telegram 봇의 서비스 자격 증명을 포함해 필요한 설정을 설명하는 .env.example가 포함되어 있습니다.
구성 키를 비워 두면 관련 기능이 비활성화되므로 배포에 필요한 서비스만 구성할 수 있습니다. 실제 .env 파일이나 API 자격 증명을 소스 관리 시스템에 커밋하지 마세요.
설치 및 초기 설정
- 서버 또는 개발 머신에 저장소를 준비합니다.
- 예시 구성 파일을 로컬 환경 파일로 복사합니다:
cp .env.example .env.env를 열고 사용하려는 하위 시스템에 필요한 키를 입력합니다. 관련 변수 이름은ENGINE.md와 코드 전반의getenv(...)호출을 참조하세요.- 프로젝트 디렉터리에서 PHP 내장 개발 서버를 시작합니다:
php -S 127.0.0.1:8000배포 시에는 PHP 내장 개발 서버 대신 PHP-FPM과 nginx 또는 Apache가 프로젝트 폴더를 가리키도록 설정합니다.
SQLite 저장소
data/ 아래의 SQLite 데이터베이스는 애플리케이션이 첫 요청을 받으면 자동으로 생성됩니다. 각 모듈은 CREATE TABLE IF NOT EXISTS를 사용하므로 설정 과정에서 별도의 스키마 가져오기 단계가 필요하지 않습니다.
생성된 데이터베이스에는 사용자 계정, 추적기 이벤트 및 리뷰와 같은 애플리케이션 데이터가 포함될 수 있습니다. 데이터베이스 파일은 저장소 내보내기에 포함되지 않으며 소스 코드가 아닌 배포 데이터로 관리해야 합니다.
기본 사용법
로컬에서 백엔드 시작
환경을 구성한 후 로컬 서버를 시작합니다:
php -S 127.0.0.1:8000그런 다음 로컬 주소를 통해 애플리케이션에 접속하고, 구성에 따라 지원되는 인증, 대시보드, API, 채팅 또는 분석 흐름을 실행해 봅니다.
인증 구성
Google 또는 Twitter 로그인을 위해 필요한 OAuth 관련 환경 변수를 설정합니다. 인증 진입점은 auth/, auth.php, register.php 및 logout.php입니다. 배포에 포함되지 않는 제공자의 선택적 자격 증명은 비워 두세요.
서비스 기반 기능 활성화
필요한 통합만 구성합니다. 예를 들어 메일 전송에는 적절한 SMTP 또는 Resend 설정이 필요하고, 캡차, Telegram, 광고 플랫폼 및 CAPI 기능에는 각각 해당 자격 증명이 필요합니다. 키가 없거나 비어 있으면 이러한 선택적 기능은 비활성화된 상태로 유지됩니다.
고급 구성 및 운영
구성을 하위 시스템에 연결
모든 환경 변수를 필수 항목으로 취급하지 마세요. 먼저 .env.example에서 시작한 다음 ENGINE.md를 사용해 API, 인증, 예약 작업, 분석 수집기 또는 통신 기능에 해당하는 키를 확인합니다. 이렇게 하면 배포 구성을 최소화하고 문제 해결에 집중할 수 있습니다.
코드 전용 내보내기 이해
이 저장소에는 이미지, 동영상, CSS 및 JavaScript를 포함한 회원 대시보드의 시각적 에셋이 의도적으로 제외되어 있습니다. 랜딩 및 법률 페이지, 미디어, 글꼴, 국제화 문구, 업로드 파일, 채팅 세션, 채팅 재개 데이터, OAuth 상태 파일 및 SQLite 데이터베이스도 제외됩니다. 엔진을 완전한 제품에 통합할 때 이러한 리소스를 별도로 제공하거나 유지할 수 있도록 계획하세요.
올바른 호스팅 모델 사용
로컬 테스트에는 php -S를 사용합니다. 서버에 배포할 때는 PHP-FPM을 사용해 PHP 애플리케이션을 nginx 또는 Apache 뒤에서 실행하고, 저장소에 비밀 정보를 하드코딩하지 말고 서버 구성에서 환경 변수를 제공하세요.
출시 전 기능 상태 검토
프로젝트 문서에서는 실제로 작동하는 엔진 구성 요소와 데모 또는 리드 전용 기능을 구분합니다. 프로덕션에서 하위 시스템을 사용하기 전에 ENGINE.md를 검토하세요. 특히 생성 요청, 결제, 분석 또는 예약 작업과 관련된 통합을 계획할 때는 반드시 확인해야 합니다.
결론
NeuraVision은 SQLite 저장소, 환경 기반 구성, 인증, API, 대시보드 로직, 커뮤니케이션, 예약 작업 및 자체 호스팅 분석 기능을 제공하는 PHP 7.4 이상 백엔드입니다. 시작하려면 .env.example을 복사하고, 필요한 서비스를 구성한 다음, 로컬 테스트를 위해 PHP 서버를 실행하세요. 첫 번째 요청이 들어오면 애플리케이션이 SQLite 테이블을 생성합니다. 하위 시스템의 경계와 배포 준비 상태를 이해하려면 ENGINE.md를 사용하세요.