eralchemy/eralchemy

🧩 Công cụ sinh sơ đồ quan hệ thực thể từ database hay model SQLAlchemy

Tạo sơ đồ ER chỉ bằng một lệnh, hỗ trợ đầy đủ các loại database và format đầu ra phổ biến.

eralchemy là một công cụ Python sinh sơ đồ ER (Entity-Relationship) từ database thực tế hoặc từ model SQLAlchemy. Dự án hỗ trợ đọc từ database (SQLite, PostgreSQL, MySQL...), file markdown mô tả schema, hoặc trực tiếp từ đối tượng SQLAlchemy Base, đồng thời xuất ra nhiều định dạng như PDF, PNG, SVG, Graphviz code, markdown, hoặc Mermaid.

✨ Điểm nổi bật

• Hỗ trợ nhiều nguồn dữ liệu: kết nối trực tiếp tới database qua URL SQLAlchemy, đọc từ file markdown .er, hoặc lấy schema từ model SQLAlchemy.
• Đa dạng định dạng đầu ra: xuất ra PDF, PNG, SVG, file Graphviz .dot, markdown, hoặc Mermaid tùy chọn.
• Cài đặt linh hoạt: hỗ trợ cài qua pip hoặc conda, tùng hợp với thư viện graphviz hoặc pygraphviz.
• Lọc và tùy chỉnh: có thể loại trừ bảng hoặc cột không mong muốn, chỉ định schema cụ thể khi làm việc với database lớn.
• Cấu hình render linh hoạt: hỗ trợ thiết lập crowfoot, top-bottom layout, sao thay vì gạch dưới cho primary key qua config toàn cục.
• Kiến trúc mô-đun: dễ dàng mở rộng để hỗ trợ thêm ORM/ODM khác nhờ lớp trung gian chung.

💡 Vì sao đáng chú ý

Khác với các công cụ chỉ vẽ sơ đồ từ file markup, eralchemy có thế mạnh là đọc trực tiếp từ database đang chạy, giúp sinh sơ đồ chính xác và luôn đồng bộ với schema thực tế. Đây là lợi thế lớn khi cần tài liệu hóa hệ thống database hiện có mà không cần viết tay file mô tả.

Thích hợp cho các developer và architect cần nhanh chóng sinh tài liệu database, kiểm tra cấu trúc schema, hoặc chuẩn bị slide/demo có hình ảnh sơ đồ ER trực quan.

#ERD #Database #SQLAlchemy #Python #OpenSource #TiniX