Wrote documentation in Russian, translated all texts from Russian to English in descriptions and comments

Author: Hackitect7

.dockerignore

@@ -0,0 +1,34 @@
+# Don't include git info
+.git
+.gitignore
+
+# Node.js
+frontend/node_modules
+npm-debug.log
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+env/
+venv/
+
+# Docker
+.dockerignore
+Dockerfile*
+
+# macOS / Windows
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Editor configs
+.vscode/
+.idea/
+
+# Env files
+.env
+.env.*

.github/workflows/docker-ci.yml

@@ -1,57 +1,57 @@
-# ---------------------------------------------------------------
+# -----------------------------------------------------------------------------
 # 📦 GitHub Actions: docker-ci.yml
-# Назначение: автоматическая сборка и публикация Docker-образов 
-# при каждом push в ветку `main`.
-# Используется CI/CD (Continuous Integration & Delivery).
+# Purpose: Automatically build and publish Docker images 
+# on every push to the `main` branch.
+# This is a CI/CD workflow (Continuous Integration & Delivery).
 #
-# Что делает:
-# 1. Клонирует код проекта.
-# 2. Логинится в Docker Hub.
-# 3. Собирает backend и frontend образы.
-# 4. Загружает их в Docker Hub.
-# ---------------------------------------------------------------
+# What it does:
+# 1. Clones the project code.
+# 2. Logs into Docker Hub.
+# 3. Builds backend and frontend Docker images.
+# 4. Pushes these images to Docker Hub.
+# -----------------------------------------------------------------------------
 
-name: Docker CI  # Имя workflow, которое отображается на GitHub
+name: Docker CI  # Workflow name shown on GitHub
 
 on:
   push:
-    branches: [ main ]  # 👉 Запускать только при пуше в ветку "main"
+    branches: [ main ]  # 👉 Run only when pushing to the "main" branch
 
 jobs:
-  build:  # 👷 Название задачи (job)
-    runs-on: ubuntu-latest  # 🔧 GitHub Actions запустит виртуальный сервер с Ubuntu
+  build:  # 👷 Job name
+    runs-on: ubuntu-latest  # 🔧 GitHub Actions will run on an Ubuntu VM
 
-    steps:  # 📋 Шаги, которые будут выполняться последовательно
+    steps:  # 📋 Steps executed sequentially
 
-      - name: Checkout code  # 🧾 Шаг 1: Склонировать репозиторий
-        uses: actions/checkout@v3  # 📥 GitHub официальная экшн для checkout
+      - name: Checkout code  # 🧾 Step 1: Clone the repository
+        uses: actions/checkout@v3  # 📥 Official GitHub checkout action
 
-      - name: Set up Docker Buildx  # 🧰 Шаг 2: Настроить Buildx — надстройка Docker для расширенной сборки
-        uses: docker/setup-buildx-action@v3  # 📦 Action для установки buildx
+      - name: Set up Docker Buildx  # 🧰 Step 2: Setup Buildx — Docker extension for advanced builds
+        uses: docker/setup-buildx-action@v3  # 📦 Action to install buildx
 
-      - name: Login to Docker Hub  # 🔐 Шаг 3: Авторизация в Docker Hub для загрузки образов
-        uses: docker/login-action@v3  # 🛂 Официальный способ логина
+      - name: Login to Docker Hub  # 🔐 Step 3: Authenticate to Docker Hub to push images
+        uses: docker/login-action@v3  # 🛂 Official login method
         with:
-          username: ${{ secrets.DOCKER_USERNAME }}  # 🔒 Имя пользователя берется из секретов GitHub
-          password: ${{ secrets.DOCKER_PASSWORD }}  # 🔒 Токен/пароль тоже из секретов (безопасно)
+          username: ${{ secrets.DOCKER_USERNAME }}  # 🔒 Username from GitHub secrets
+          password: ${{ secrets.DOCKER_PASSWORD }}  # 🔒 Password or token from secrets (secure)
 
-      - name: Build and push backend  # ⚙️ Шаг 4: Собрать и отправить backend-образ
-        uses: docker/build-push-action@v5  # 🛠️ Action для сборки и загрузки Docker образов
+      - name: Build and push backend  # ⚙️ Step 4: Build and push backend image
+        uses: docker/build-push-action@v5  # 🛠️ Build and push Docker images
         with:
-          context: ./backend  # 📁 Контекст сборки — папка backend
-          tags: ${{ secrets.DOCKER_USERNAME }}/flask-api:latest  # 🏷️ Имя образа: dockerhub_user/flask-api
-          push: true  # 📤 Обязательно загрузить образ после сборки
+          context: ./backend  # 📁 Build context — backend folder
+          tags: ${{ secrets.DOCKER_USERNAME }}/flask-api:latest  # 🏷️ Image name: dockerhub_user/flask-api
+          push: true  # 📤 Push the image after build
 
-      - name: Build and push frontend  # ⚙️ Шаг 5: Собрать и отправить frontend-образ
-        uses: docker/build-push-action@v5  # 🛠️ То же самое, но для фfrontend
+      - name: Build and push frontend  # ⚙️ Step 5: Build and push frontend image
+        uses: docker/build-push-action@v5  # 🛠️ Same as above, for frontend
         with:
-          context: ./frontend  # 📁 Контекст сборки — папка frontend
-          tags: ${{ secrets.DOCKER_USERNAME }}/node-frontend:latest  # 🏷️ Имя образа: dockerhub_user/node-frontend
-          push: true  # 📤 Загружаем в Docker Hub
+          context: ./frontend  # 📁 Build context — frontend folder
+          tags: ${{ secrets.DOCKER_USERNAME }}/node-frontend:latest  # 🏷️ Image name: dockerhub_user/node-frontend
+          push: true  # 📤 Push the image to Docker Hub
 
-      - name: Build and push nginx  # ⚙️ Шаг 6: Собрать и отправить nginx-образ
-        uses: docker/build-push-action@v5  # 🛠️ То же самое, но для  nginx
+      - name: Build and push nginx  # ⚙️ Step 6: Build and push nginx image
+        uses: docker/build-push-action@v5  # 🛠️ Same, for nginx
         with:
-          context: ./nginx  # 📁 Контекст сборки — папка nginx
-          tags: ${{ secrets.DOCKER_USERNAME }}/nginx:latest  # 🏷️ Имя образа: dockerhub_user/nginx
-          push: true  # 📤 Загружаем в Docker Hub
+          context: ./nginx  # 📁 Build context — nginx folder
+          tags: ${{ secrets.DOCKER_USERNAME }}/nginx:latest  # 🏷️ Image name: dockerhub_user/nginx
+          push: true  # 📤 Push the image to Docker Hub

.gitignore

@@ -1,48 +1,48 @@
 # ========== Node.js ==========
-# Игнорировать папку с зависимостями фронтенда
+# Ignore frontend dependency folder
 frontend/node_modules/
-# npm временные файлы
+# npm temporary files
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 
 # ========== Python ==========
-# Кеш-компиляции Python
+# Python bytecode cache
 __pycache__/
 *.py[cod]
 *.pyo
 
-# Виртуальное окружение Python, если создавал
+# Python virtual environments (if used)
 venv/
 env/
 
 # ========== Docker ==========
-# Исключить временные файлы Docker (если такие появятся)
+# Ignore temporary Docker files (if any appear)
 *.pid
 *.seed
 *.pid.lock
 
 # ========== System ==========
-# Файлы IDE и редакторов
+# IDE/editor config files
 .vscode/
 .idea/
 
-# Файлы macOS и Windows
+# macOS and Windows system files
 .DS_Store
 Thumbs.db
 
 # ========== Git ==========
-# Git hooks и временные файлы
+# Git hooks and temporary merge files
 *.orig
 
 # ========== Logs ==========
 *.log
 
-# ========== Secret configs (по желанию) ==========
-# .env файлы, если хранишь пароли локально
+# ========== Secret configs (optional) ==========
+# Ignore .env files if storing local secrets
 .env
 .env.*
 
-# ========== Build outputs (если собираешь фронтенд) ==========
+# ========== Build outputs (if building frontend) ==========
 frontend/dist/
 frontend/build/

CONTRIBUTING.md

@@ -0,0 +1,40 @@
+# Contributing Guide
+
+👋 Welcome! Thank you for considering contributing to this project.
+
+## 📌 Purpose
+
+This project is created for educational purposes and as part of my professional portfolio. Contributions are welcome if they help improve clarity, documentation, or functionality — especially for beginners learning Docker and CI/CD.
+
+## 🧱 Project Structure
+
+- `backend/` — Flask API
+- `frontend/` — Node.js frontend
+- `nginx/` — Nginx reverse proxy
+- `.github/workflows/` — GitHub Actions CI/CD
+- `docker-compose.yml` — Local setup
+- `README.md` / `README.ru.md` — Documentation
+
+## ✅ How to Contribute
+
+1. **Fork** the repository
+2. **Create a branch**: `git checkout -b feature/your-feature-name`
+3. **Make changes**, write clear comments
+4. **Test** your changes locally with Docker
+5. **Commit**: `git commit -m "Add useful feature"`
+6. **Push** to your fork and open a **Pull Request**
+
+## 💬 Issues & Suggestions
+
+Feel free to open issues for:
+- Bugs
+- Suggestions for improvement
+- Questions from beginners (they are welcome!)
+
+## 📄 License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.
+
+---
+
+Thanks again for being here and supporting open learning!

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 hackitect7
+
+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.