Wrote documentation in English and Russian + README.md

Author: Hackitect7

README.md

@@ -0,0 +1,82 @@
+# DevOps Docker Project
+
+A beginner-friendly yet production-grade **CI/CD** demo project using **Docker**, **GitHub Actions**, **Flask**, **Node.js**, and **Nginx**.
+
+---
+
+![CI](https://github.com/Hackitect7/devops-docker-project/actions/workflows/docker-ci.yml/badge.svg) ![Docker Pulls](https://img.shields.io/docker/pulls/hackitect7/flask-api) ![Image Size](https://img.shields.io/docker/image-size/hackitect7/flask-api/latest) ![Last Commit](https://img.shields.io/github/last-commit/Hackitect7/devops-docker-project) ![License](https://img.shields.io/github/license/Hackitect7/devops-docker-project) ![Issues](https://img.shields.io/github/issues/Hackitect7/devops-docker-project)
+
+---
+
+## 🚀 Features
+
+- 🔧 CI/CD pipeline with **GitHub Actions**
+- 🐳 Docker-based development and deployment
+- 🔁 Reverse proxy with Nginx
+- 🐍 Flask backend API
+- 🚀 Node.js frontend
+- ☁️ Auto-push to **Docker Hub**
+
+---
+
+## ⚡ Quick Start
+
+```bash
+git clone https://github.com/Hackitect7/devops-docker-project.git
+cd devops-docker-project
+sudo docker compose up --build
+```
+
+Open in browser:
+
+<http://localhost/api> — Flask API
+
+<http://localhost:3000> — Node.js frontend
+
+<http://localhost> — Nginx reverse proxy (port 80)
+
+To stop services:
+
+```bash
+docker compose down
+```
+
+## 🧩 Project Structure
+
+```text
+/backend       - Flask API (Python)
+  app.py
+  Dockerfile
+
+/frontend      - Node.js frontend
+  index.js
+  Dockerfile
+
+/nginx         - Nginx config
+  nginx.conf
+  Dockerfile
+
+/.github/workflows/docker-ci.yml  - CI/CD pipeline
+```
+
+## 📚 Documentation
+
+[Documentation in English](./docs/en/SUMMARY.md)
+
+[Documentation in Russian](./docs/ru/SUMMARY.ru.md)
+
+## 📄 License
+
+This project is licensed under the MIT License. See [LICENSE](LICENSE).
+
+## 🤝 Contributing
+
+Pull requests are welcome. For major changes, please open an issue first.See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## 📬 **Contact Us:**
+
+💼 **LinkedIn:** [https://www.linkedin.com/in/aleksei-polovinkin-918603278/](https://www.linkedin.com/in/aleksei-polovinkin-918603278/)
+
+✉️ **Email:** [papulya2012@gmail.com](mailto:papulya2012@gmail.com)
+
+💬 **Telegram:** [@manfred251278](https://t.me/Manfred251278)

README.md/README.ru.md

@@ -0,0 +1,24 @@
+# 📘 ОПИСАНИЕ ПРОЕКТА
+
+Этот проект демонстрирует реализацию профессионального **CI/CD** пайплайна с использованием **Docker** и **GitHub Actions**.
+
+---
+
+## 🔍 Основные компоненты проекта
+
+Проект включает три контейнеризированных модуля:
+
+- **Backend**: Flask-приложение (Python API)
+- **Frontend**: веб-интерфейс на Node.js (Express)
+- **Reverse Proxy**: сервер на базе Nginx
+
+---
+
+## 🎯 Цель проекта
+
+Цель — продемонстрировать настройку **автоматической сборки**, **тестирования** и **публикации Docker-образов** в Docker Hub, а также локальный запуск сервисов через Docker Compose.
+
+Проект будет полезен:
+
+- 🔰 **Новичкам** — для изучения **DevOps**-практик, **GitHub Actions** и контейнеризации
+- 🧑‍💻 **Специалистам** — как шаблон для построения надёжного и масштабируемого **CI/CD**-процесса

docs/en/01_overview.md

@@ -0,0 +1,21 @@
+# ⚙️ REQUIREMENTS
+
+For the project to work successfully, you will need:
+
+- 🖥 **Operating system:** Linux, Windows or macOS
+
+- 💾 **Installed software:**
+  - 🐳 Docker version 20.10 and above
+  - 📦 Docker Compose version 1.29 and above
+  - 🔧 Git for working with the repository
+
+- 🔐 SSH client (usually built-in to Linux/macOS, Git Bash is recommended for Windows)
+
+- 👤 **Accounts:**
+  - ☁️ GitHub account for storing code and CI/CD setup
+  - 🐋 Docker Hub account for storing Docker images
+
+---
+
+✅ **Recommended versions:**
+It is recommended to use the latest stable versions software to avoid compatibility issues.

docs/en/02_requirements.md

@@ -0,0 +1,28 @@
+# ⚡ QUICK START
+
+To quickly start the project, follow these steps:
+
+📥 **Clone the repository:**
+
+```bash
+git clone git@github.com:Hackitect7/devops-docker-project.git
+cd devops-docker-project
+```
+
+🐳 **Start all services with Docker Compose:**
+
+```bash
+sudo docker compose up --build
+```
+
+🧪 **Test the applications:**
+
+- 🔗 Backend Flask API: <http://localhost:5000/api>
+- 🌐 Frontend Node.js: <http://localhost:3000>
+- 🚪 Nginx (reverse proxy): <http://localhost> (port 80)
+
+🛑 **To stop and To remove containers use:**
+
+```bash
+sudo docker compose down
+```