Nhà phát triển

Mã nguồn mở, phát triển công khai

Piranha là phần mềm tự do theo AGPL-3.0. Đọc nó, chạy nó, fork nó và gửi một thay đổi trở lại — cả hệ thống là của bạn để nhào nặn.

Tự do và mã nguồn mở

Cấp phép AGPL-3.0: phân phối lại và sửa đổi thoải mái. Điều khoản mạng giữ cho cả các bản fork được lưu trữ cũng mở, nên các cải tiến chảy ngược về tất cả mọi người.

Một stack web hiện đại

FastAPI + SQLite/Postgres ở backend; React + TypeScript + Vite ở phía trước; một tác nhân trên thành bể viết bằng Go và một bản dựng máy tính để bàn bằng Tauri. Thời gian thực qua WebSocket, định kiểu từ đầu đến cuối.

Ai cũng có thể đóng góp

Kiến trúc có tài liệu, một bộ kiểm thử kỹ lưỡng với ngưỡng bao phủ 95%, các rào chắn kiểu và lint, cùng hướng dẫn theo từng mảng khiến bản vá đầu tiên trong tầm với. Các báo cáo, định dạng và tính năng mới có sẵn lối đi đã trải nhựa.

Kiến trúc trụ vững

Các quy tắc phân lớp nghiêm ngặt — kho lưu trữ, dịch vụ, bộ định tuyến — được thực thi như những hàm thích nghi làm CI thất bại. Cấu trúc giữ gọn gàng khi hệ thống lớn lên, ngay từ trong thiết kế.

Dịch nó

Thêm một ngôn ngữ là thêm một cuốn từ điển — định tuyến, hướng viết và bộ chuyển đổi tự đi theo. Viết phải-sang-trái là một lối đi hạng nhất, chứ không phải nghĩ sau.

Kiểm thử nghiêm túc

Các khung kiểm thử đơn vị, tích hợp, đồng thời và giải vô địch từ đầu đến cuối chạy trong CI với một ngưỡng bao phủ. Các thay đổi hạ cánh bằng sự tự tin, chứ không phải khấn vái.

Nhảy vào

Clone kho mã, đọc AGENTS.md để nắm kiến trúc, và nhặt một issue dành cho người mới. Hoan nghênh các pull request.