mirror of https://github.com/Vateron-Media/XC_VM.git synced 2026-04-13 08:28:32 +00:00

Files

Divarion-D d8717d2499 ci: extract PHP syntax check into reusable script

- Add tools/php_syntax_check.sh (supports full scan + single-file mode)
- CI workflow now calls the shared script
- All 6 agents updated to reference the script
- CONTRIBUTING.md: add Pre-Commit Checks section
- Exclude src/bin/* (third-party stubs) from lint

2026-03-15 13:49:18 +03:00

3.4 KiB

Raw Blame History

Contributing to the Project

Thank you for considering contributing to this project! Follow these guidelines to make the process smooth for everyone.

📌 General Guidelines

Minimally use AI
Follow the project's coding style and best practices.
Ensure your changes are well-documented.
Write meaningful commit messages.
Keep pull requests focused on a single change.
If you are refactoring and are not sure if the code is unused elsewhere, comment it out. It will be removed after the release.

🛠️ Installation

To install the panel, follow these steps:

Update system

sudo apt update && sudo apt full-upgrade -y

Install dependencies
```
sudo apt install -y python3-pip unzip
```

Download latest release

latest_version=$(curl -s https://api.github.com/repos/Vateron-Media/XC_VM/releases/latest | grep '"tag_name":' | cut -d '"' -f 4)
wget "https://github.com/Vateron-Media/XC_VM/releases/download/${latest_version}/XC_VM.zip"

Unpack and install
```
unzip XC_VM.zip
sudo python3 install
```

✨ Code Standards

Use K&R coding style for PHP.
Follow best practices for Python and Bash scripts.
Avoid unused functions and redundant code.

🔍 Pre-Commit Checks

Before committing, run the PHP syntax checker:

bash tools/php_syntax_check.sh

This is the same check that CI runs. You can also check a single file:

bash tools/php_syntax_check.sh src/domain/Device/EnigmaService.php

Do not submit PRs with syntax errors — CI will reject them.

🔥 Submitting a Pull Request

Fork the repository and create a new branch:
```
git checkout -b feature/your-feature
```

Make your changes and commit them:

git commit -m "Add feature: description"

Push your branch:
```
git push origin feature/your-feature
```
Open a pull request on GitHub.

Code Reviews:

All PRs must be reviewed by at least 2 maintainers. Address review comments before merging.

🚀 Reporting Issues

Use GitHub Issues to report bugs and suggest features.
Provide clear steps to reproduce issues.
Attach relevant logs or error messages.

🔀 Branch Naming Conventions

To maintain a clean and organized repository, follow these branch naming conventions:

Title	Template	Example
Features	`feature/<short-description>`	`feature/user-authentication`
Bug Fixes	`fix/<short-description>`	`fix/login-bug`
Hotfixes	`hotfix/<short-description>`	`hotfix/critical-error`
Refactoring	`refactor/<short-description>`	`refactor/code-cleanup`
Testing	`test/<short-description>`	`test/api-endpoints`
Documentation	`docs/<short-description>`	`docs/documentation-api`

🌟 Recognition

Your GitHub profile will be added to CONTRIBUTORS.md

Thank you for contributing! 🎉

3.4 KiB Raw Blame History