VNKR

Đóng Góp Mã Nguồn Cho Cộng Đồng

VNKR được xây dựng với tinh thần mã nguồn mở — mọi người đều có thể đóng góp để làm cho nền tảng này tốt hơn, dành cho cộng đồng.

GitHub Repository Liên hệ trực tiếp

TẠI SAO ĐÓNG GÓP?

Phục vụ cộng đồng

Code bạn đóng góp sẽ trực tiếp cải thiện trải nghiệm của hàng nghìn người đọc tin tức mỗi ngày.

Được ghi nhận

Tên bạn sẽ được ghi vào danh sách Contributors và hiển thị công khai trên trang này.

Học & thực chiến

Làm việc với Laravel, PHP, JavaScript thực tế — portfolio xịn cho CV của bạn.

CÔNG NGHỆ SỬ DỤNG

Laravel 10

PHP Framework chính

PHP 8.2

Backend language

MySQL

Cơ sở dữ liệu

Blade Templates

Template engine

Bootstrap 5

CSS Framework

Vite + JS

Asset bundler

Redis

Caching layer

REST API

API /api/v1/

CÁCH THAM GIA ĐÓNG GÓP

1

Fork & Clone Repository

git clone https://github.com/thekingbao/vnkr.vn.git
cd vnkr.vn
cp .env.example .env
composer install && npm install

2

Tạo Branch Mới

git checkout -b feature/ten-tinh-nang
# hoặc: bugfix/mo-ta-loi

3

Viết Code & Commit

git add .
git commit -m "feat: mô tả ngắn gọn thay đổi"
# Dùng Conventional Commits: feat/fix/docs/refactor

4

Tạo Pull Request

Push branch lên GitHub và tạo Pull Request về nhánh main. Mô tả rõ những gì bạn thay đổi và lý do. PTB sẽ review và merge trong vòng 72 giờ.

NHỮNG GÌ ĐANG CẦN ĐÓNG GÓP

Báo lỗi (Bug Reports)

Lỗi hiển thị trên mobile
Lỗi logic xử lý bình luận
Vấn đề SEO meta tags
Bất kỳ lỗi nào bạn gặp

Tính năng mới (Features)

Hệ thống thông báo (notifications)
Dark mode
Tính năng tìm kiếm nâng cao
PWA / offline support

Tài liệu (Documentation)

Viết hướng dẫn cài đặt
Dịch tài liệu kỹ thuật
Viết wiki cho developer
Code comments & docblocks

Giao diện (UI/UX)

Cải thiện responsive design
Tối ưu Core Web Vitals
Thiết kế component mới
Accessibility (a11y)

QUY TẮC ĐÓNG GÓP

Viết code sạch, có comment rõ ràng

Tuân theo PSR-12 (PHP) và codebase hiện tại

Một PR giải quyết một vấn đề duy nhất

Test thủ công trước khi tạo PR

Không break tính năng đang hoạt động

Không commit file .env hoặc credentials

Không đưa vào ads, tracking, spyware

Không thêm dependency không cần thiết

Sẵn sàng đóng góp?

Mỗi dòng code bạn đóng góp là một viên gạch xây dựng cộng đồng VNKR tốt hơn. Cùng nhau tạo ra nền tảng thông tin mà mọi người đều xứng đáng có.

Xem trên GitHub Liên hệ PTB

Nhà đóng góp code sẽ nhận badge "Contributor VNKR" và được ghi nhận vĩnh viễn.