initialization

Author: DenisLopatin

.gitattributes

@@ -0,0 +1,10 @@
+/tests export-ignore
+.github export-ignore
+
+.gitignore export-ignore
+.gitattributes export-ignore
+CONTRIBUTING.md export-ignore
+package.json export-ignore
+package-lock.json export-ignore
+playwright.config.ts export-ignore
+docker-compose-dev.yml export-ignore

.github/workflows/playwright.yml

@@ -0,0 +1,50 @@
+name: Playwright Tests
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+jobs:
+  test:
+    timeout-minutes: 90
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        php-version: [ '7.4', '8.0', '8.1', '8.2', '8.3', '8.4' ]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Build PHP-FPM images with cache
+        uses: docker/build-push-action@v6
+        with:
+          context: server/config/php-fpm/${{ matrix.php-version }}
+          file: server/config/php-fpm/${{ matrix.php-version }}/Dockerfile
+          build-args: |
+            PHP_VERSION=${{ matrix.php-version }}
+            UID=1000
+            GID=1000
+          load: true
+          tags: local/php-fpm:${{ matrix.php-version }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Install dependencies
+        run: npm ci
+      - name: Install Playwright Browsers
+        run: npx playwright install --with-deps
+
+      - name: Run tests
+        run: npm run tests ${{ matrix.php-version }}
+
+      - uses: actions/upload-artifact@v4
+        if: ${{ always() }}
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 30

.gitignore

@@ -0,0 +1,9 @@
+.idea
+
+/node_modules/
+
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/
+/playwright/.auth/

CONTRIBUTING.md

@@ -0,0 +1,72 @@
+# Contributing Guide
+
+We welcome your interest in developing this project! We appreciate any contribution, whether it's fixing bugs, adding 
+new features, or improving documentation. To make the process as smooth as possible, please review this guide.
+
+## How to Contribute
+
+The basic process for making changes is as follows:
+
+1.  **Fork the repository:** Create your own copy of the repository on GitHub.
+2.  **Clone the fork:** `git clone https://github.com/YOUR_USERNAME/DenisLopatin-server.git`
+3.  **Create a branch:** Create a new branch for your changes (`git checkout -b feature/my-new-feature` or `git checkout -b fix/bug-fix`).
+4.  **Make changes:** Write code, fix a bug, update configuration.
+5.  **Test:** Ensure your changes haven't broken existing functionality. Run the Playwright tests (see the "Testing" section).
+6.  **Commit changes:** `git commit -m "feat: Add support for a new service"` (try to follow [Conventional Commits](https://www.conventionalcommits.org/) if possible).
+7.  **Push changes to your fork:** `git push origin feature/my-new-feature`
+8.  **Create a Pull Request (PR):** Open a PR from your branch to the `main` branch of the main repository.
+
+## Reporting Bugs (Issues)
+
+If you find a bug:
+
+1.  **Check existing Issues:** Perhaps this bug has already been reported.
+2.  **Create a new Issue:** If the bug hasn't been reported, create a new Issue with a clear and descriptive title.
+3.  **Describe the problem:**
+    * Specify your Docker version, Docker Compose version, and your OS.
+    * Describe the steps to reproduce the error.
+    * Describe the expected and actual behavior.
+    * Attach error logs (`docker logs <container_name>`) or screenshots if necessary.
+
+## Suggesting Enhancements (Feature Requests)
+
+If you have an idea to improve the project:
+
+1.  **Check existing Issues:** Perhaps a similar idea is already being discussed.
+2.  **Create a new Issue:** Describe your idea, explain the problem it solves, and why it would be beneficial for the project.
+
+## Setting Up the Development Environment
+
+Before making changes, you need to set up the project locally. Detailed instructions are in the [README.md](README.md) file.
+
+## Code Style and Configuration
+
+* **Docker Configurations:** Try to follow the existing style in `docker-compose.yml` and `Dockerfile`s. Use comments for non-trivial solutions.
+* **Bash Scripts:** Use `set -euo pipefail`. Break down complex logic into functions. Add comments.
+* **Playwright Tests:** Follow the structure and style of existing tests. Use reliable selectors and explicit assertions (`expect`).
+
+## Testing
+
+The project uses Playwright for E2E testing.
+
+* **Running tests:** Use the command `npm test`.
+* **Adding/Updating tests:** If your changes affect functionality covered by tests, update them. If you add new functionality, please add tests for it as well.
+
+Ensure all tests pass successfully before creating a Pull Request.
+
+To run the full project test cycle, execute the command `./tests/tests.sh`. Enter the system's `root` user password when 
+prompted; this is necessary to create entries in `/etc/hosts` on WSL/Linux or `/private/etc/hosts` on macOS.
+
+## Pull Requests (PR)
+
+* **Description:** Provide a clear description of what your PR does and what problem it solves. Reference the related Issue (e.g., `Fixes #123`).
+* **Small PRs:** Try to make small, focused PRs. They are easier to review and merge.
+* **Passing Tests:** Ensure all automated checks (GitHub Actions, if configured) and local tests pass.
+* **Review:** Be prepared for discussion and making changes based on the review feedback.
+
+## License
+
+By contributing to this project, you agree that your changes will be licensed under the [MIT License](LICENSE) used by
+this project.
+
+Thank you for your contribution!

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [year] [fullname]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.