# Contributing to Damoon Exhibition

Thank you for considering a contribution! This document outlines how to get started.

## 🐛 Reporting Bugs

Use the [Bug Report issue template](https://github.com/ahmadreza-log/damoon-exhibition/issues/new?template=bug_report.yml) and include:

- PHP version and extensions
- Web server (Apache/Nginx) and OS
- Steps to reproduce
- Expected vs actual behavior
- Relevant logs (no passwords or secrets)

## 💡 Feature Requests

Open a [Feature Request](https://github.com/ahmadreza-log/damoon-exhibition/issues/new?template=feature_request.yml) describing the problem and proposed solution.

## 🔧 Development Setup

1. Fork and clone the repository.
2. Run the web installer at `/install` or copy config examples manually.
3. Install frontend dependencies: `npm install`
4. Watch CSS: `npx @tailwindcss/cli -i ./assets/css/input.css -o ./assets/css/style.css --watch`

## 📝 Code Guidelines

- **PHP 8.1+** with `declare(strict_types=1);` in every file.
- Place classes in `app/{ClassName}.php` — autoloaded via `autoload.php`.
- Use prepared statements for all database queries.
- Match existing naming, structure, and RTL Persian UI patterns.
- Keep changes focused — one feature or fix per pull request.
- Do not commit `node_modules/`, `storage/installed.lock`, or uploaded files.

## 🔀 Pull Requests

1. Create a branch from `master`: `git checkout -b feature/my-change`
2. Test login, lead submission, admin panel, and installer if affected.
3. Rebuild CSS if you changed `assets/css/input.css`.
4. Fill out the PR template completely.
5. Ensure no secrets (`config/database.php` credentials) are added in new commits.

## 📜 License

By contributing, you agree that your contributions will be licensed under the [MIT License](LICENSE).
