Backend NeuraVision: Hướng dẫn thiết lập và sử dụng thực tế

NeuraVision cung cấp gì

NeuraVision là công cụ backend cho một sản phẩm tạo nội dung bằng AI. Kho lưu trữ này chứa logic phía máy chủ cho bảng điều khiển thành viên, các API backend, xác thực, cùng trình theo dõi phân tích và phân chia lưu lượng tự lưu trữ.

Bản xuất chỉ chứa mã nguồn. Bản này không bao gồm các landing page, nội dung tiếp thị, phương tiện truyền thông, tài nguyên bảng điều khiển, tệp môi trường, cơ sở dữ liệu hoặc tệp do người dùng gửi.

Cấu trúc dự án

Các thư mục chính tương ứng với những trách nhiệm backend cụ thể:

• api/ chứa các endpoint backend cho việc tải xuống, yêu cầu tạo nội dung, OAuth và thanh toán.
• functions/ cung cấp các hàm trợ giúp PHP dùng chung cho xác thực, email, SMS, captcha và đánh giá.
• lk/ chứa logic backend của bảng điều khiển thành viên.
• auth/, auth.php, register.php và logout.php triển khai các luồng đăng nhập, đăng ký và OAuth Google hoặc Twitter.
• chat/ chứa backend của tiện ích trò chuyện hỗ trợ.
• data/ chứa các tác vụ đã lập lịch để gửi chiến dịch và chuyển tiếp CAPI.
• a/ chứa trình thu thập phân tích tự lưu trữ và logic tra cứu địa lý.
• PHPMailer/ chứa thư viện email được tích hợp trong dự án.

Để xem mô tả theo từng hệ thống con, hãy tham khảo ENGINE.md. Tài liệu này giải thích phần nào là thành phần engine đang hoạt động và phần nào chỉ dành cho bản demo hoặc thu thập khách hàng tiềm năng.

Yêu cầu và cấu hình

NeuraVision chạy trên PHP 7.4 trở lên với nginx hoặc Apache. Ứng dụng sử dụng SQLite để lưu trữ và không yêu cầu bước build.

Cấu hình được cung cấp thông qua các biến môi trường. Kho lưu trữ bao gồm .env.example, trong đó ghi lại các thiết lập dự kiến, bao gồm thông tin xác thực dịch vụ cho các nền tảng quảng cáo, SMTP hoặc Resend, hCaptcha và bot Telegram.

Các khóa cấu hình để trống sẽ vô hiệu hóa tính năng liên quan, vì vậy bạn chỉ cần cấu hình những dịch vụ cần thiết cho quá trình triển khai. Không commit tệp .env thực tế hoặc thông tin xác thực API vào hệ thống quản lý mã nguồn.

Cài đặt và thiết lập ban đầu

1. Lấy kho lưu trữ về máy chủ hoặc máy phát triển.
2. Sao chép tệp cấu hình mẫu thành tệp môi trường cục bộ:

cp .env.example .env

1. Mở .env và điền các khóa cần thiết cho những hệ thống con bạn dự định sử dụng. Tham khảo ENGINE.md và các lệnh gọi getenv(...) trong toàn bộ mã nguồn để xác định tên biến tương ứng.
2. Khởi động máy chủ phát triển tích hợp của PHP từ thư mục dự án:

php -S 127.0.0.1:8000

Khi triển khai, hãy trỏ PHP-FPM và nginx hoặc Apache đến thư mục dự án thay vì sử dụng máy chủ phát triển tích hợp.

Lưu trữ SQLite

Cơ sở dữ liệu SQLite trong data/ sẽ được tự động tạo khi ứng dụng nhận yêu cầu đầu tiên. Mỗi mô-đun sử dụng CREATE TABLE IF NOT EXISTS, vì vậy quy trình thiết lập không có bước nhập schema riêng.

Các cơ sở dữ liệu được tạo có thể chứa dữ liệu ứng dụng như tài khoản người dùng, sự kiện trình theo dõi và đánh giá. Các tệp cơ sở dữ liệu không có trong bản xuất kho lưu trữ và nên được xử lý như dữ liệu triển khai thay vì mã nguồn.

Cách sử dụng cơ bản

Khởi động backend cục bộ

Sau khi cấu hình môi trường, hãy khởi chạy máy chủ cục bộ:

php -S 127.0.0.1:8000

Sau đó truy cập ứng dụng qua địa chỉ cục bộ và kiểm tra các luồng xác thực, bảng điều khiển, API, trò chuyện hoặc phân tích được hỗ trợ bởi cấu hình của bạn.

Cấu hình xác thực

Thiết lập các biến môi trường liên quan đến OAuth cần thiết cho đăng nhập Google hoặc Twitter. Các điểm vào xác thực bao gồm auth/, auth.php, register.php và logout.php. Để trống thông tin xác thực tùy chọn khi nhà cung cấp đó không thuộc phạm vi triển khai của bạn.

Bật các tính năng dựa trên dịch vụ

Chỉ cấu hình những tích hợp bạn cần. Ví dụ, tính năng gửi email yêu cầu các thiết lập SMTP hoặc Resend phù hợp, trong khi captcha, Telegram, nền tảng quảng cáo và CAPI yêu cầu thông tin xác thực tương ứng. Các khóa bị thiếu hoặc để trống sẽ giữ những khả năng tùy chọn đó ở trạng thái vô hiệu hóa.

Cấu hình và vận hành nâng cao

Ánh xạ cấu hình với các hệ thống con

Không nên xem mọi biến môi trường đều là bắt buộc. Hãy bắt đầu với .env.example, sau đó sử dụng ENGINE.md để xác định khóa nào thuộc về API, xác thực, tác vụ đã lập lịch, trình thu thập phân tích hoặc các tính năng liên lạc. Cách này giúp giảm thiểu cấu hình triển khai và tập trung hơn khi xử lý sự cố.

Hiểu về bản xuất chỉ chứa mã nguồn

Kho lưu trữ này cố ý loại trừ các tài nguyên trực quan của bảng điều khiển thành viên, bao gồm hình ảnh, video, CSS và JavaScript. Kho cũng loại trừ các trang landing và pháp lý, phương tiện truyền thông, phông chữ, nội dung bản địa hóa, tệp tải lên, phiên trò chuyện, bản tiếp tục trò chuyện, tệp trạng thái OAuth và cơ sở dữ liệu SQLite. Hãy dự kiến cung cấp hoặc duy trì riêng các tài nguyên này khi tích hợp engine vào một sản phẩm hoàn chỉnh.

Sử dụng mô hình lưu trữ phù hợp

Sử dụng php -S để kiểm thử cục bộ. Khi triển khai trên máy chủ, hãy chạy ứng dụng PHP phía sau nginx hoặc Apache với PHP-FPM và cung cấp các biến môi trường thông qua cấu hình máy chủ thay vì hardcode thông tin bí mật vào kho lưu trữ.

Kiểm tra trạng thái tính năng trước khi ra mắt

Tài liệu dự án phân biệt các thành phần engine đang hoạt động thực tế với chức năng demo hoặc chỉ dành cho thu thập khách hàng tiềm năng. Hãy xem lại ENGINE.md trước khi dựa vào một hệ thống con trong môi trường production, đặc biệt khi lập kế hoạch tích hợp xoay quanh yêu cầu tạo nội dung, thanh toán, phân tích hoặc các tác vụ đã lập lịch.

Kết luận

NeuraVision cung cấp backend PHP 7.4+ với bộ nhớ SQLite, cấu hình dựa trên môi trường, xác thực, các API, logic bảng điều khiển, hệ thống liên lạc, tác vụ theo lịch và phân tích tự lưu trữ. Để bắt đầu, hãy sao chép .env.example, cấu hình các dịch vụ cần thiết, khởi chạy máy chủ PHP để kiểm thử cục bộ và để ứng dụng tự tạo các bảng SQLite trong yêu cầu đầu tiên. Sử dụng ENGINE.md để hiểu ranh giới giữa các phân hệ và mức độ sẵn sàng triển khai.