Skip to content
VNEN

Điều kiện tiên quyết

Những thứ cần có trước khi Data Explorer chạy ổn: runtime, app metadata database, quyền mạng, và quyền truy cập tới các target databases.

Runtime

Node.js 20.x LTS được khuyên dùng. Frontend build bằng Vite 7.x.

Persistence

Một PostgreSQL riêng cho metadata app và một Redis instance cho cache, queue, notifications, presence, và throttling.

Security

JWT secret mạnh, ENCRYPTION_KEY đúng 32 ký tự, và outbound HTTPS tới AI providers nếu bạn bật AI routing.

Yêu cầu hệ thống

Repo production chạy với full-stack TypeScript, npm, PostgreSQL metadata database, migration Prisma đã commit và Redis endpoint ổn định cho cache, background jobs, search index, notifications, cùng rate limiting.

Node.js

Khuyên dùng Node.js 20.x LTS cho dev và production builds.

Package Manager

npm là đường được dùng nhiều nhất trong repo hiện tại. Tránh trộn nhiều package manager để khỏi lệch lockfile.

Prisma sync

Production áp dụng migration PostgreSQL đã commit bằng `npx prisma migrate deploy`; chỉ dùng `db push` cho prototype local có thể bỏ đi.

Ma trận tương thích database

EnginePhiên bảnGhi chú
PostgreSQL12+SQL workspace chính, health checks, explain, dashboards.
MySQL / MariaDB5.7 / 8.0+SQL workspace, guardrails, saved queries, AI context.
MariaDB10.6+Drop-in của MySQL: CRUD/query, views, functions, TLS toggle riêng cho server không SSL.
CockroachDBv23+PostgreSQL wire-compatible: query/CRUD qua strategy riêng (port 26257), metrics qua crdb_internal.
SQL Server2017+SQL workspace, metadata explorer, AI-assisted query flow.
MongoDB6+NoSQL workspace và document exploration.
MongoDB Atlas (SRV)CurrentAtlas SRV parsing, SSRF-aware validation, NoSQL workspace.

Điều kiện mạng

  • AI providers

    Backend cần outbound HTTPS (443) tới provider bạn bật: Gemini, OpenRouter, Groq, Cerebras, hoặc Beeknoee. Nếu key thiếu hoặc provider không reach được, lane đó sẽ bị loại khỏi chuỗi chạy thay vì được giả vờ là đang sẵn sàng.

  • Redis / dịch vụ nội bộ

    Nếu `REDIS_URL` không hoạt động, các lớp như BullMQ, throttling, presence, notification stream, và một phần caching/search sẽ không ổn định. Đây không chỉ là “optional optimization” nữa trong cấu trúc repo hiện tại.

  • Target databases

    Host chạy backend phải reach được các database đích. Nếu mạng trường/công ty chặn 5432, 3306, hoặc 27017, cả local dev lẫn app web đều có thể fail reachability.

  • App ports

    Local dev mặc định dùng 5173 cho frontend và 3001 cho backend API. Production thường đặt frontend sau Vercel và backend sau Render hoặc nginx.

Trước đóCài đặtTiếp theo Biến môi trường

Sẵn sàng khám phá dữ liệu?

Tham gia cộng đồng trên GitHub để đóng góp cho IDE cơ sở dữ liệu địa phương thông minh nhất.

Mở Ứng dụng