From db44030c9f19bba5b71a8018b2f2ecf6513b9c73 Mon Sep 17 00:00:00 2001
From: ITQ <itq.dev@ya.ru>
Date: Mon, 27 Oct 2025 22:18:12 +0300
Subject: [PATCH] docs: added project README.md

---
 README.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/README.md b/README.md
index 5933068..9eb55b8 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,58 @@
 # Order service
+
+Golang microservice to manage orders.
+
+## Prerequisites
+
+Ensure you have the following installed on your system:
+
+- Golang (>=1.24)
+- protoc (Protocol Buffers compiler)
+- make (latest version recommended)
+
+## Installation
+
+### 1. Clone the project
+
+### 2. Go to the project directory
+
+### 3. Install dependencies
+
+```bash
+make i
+```
+
+### 4. Customize environment
+
+```bash
+cp .env.example .env
+```
+
+And setup env vars according to your needs.
+
+## Configuration
+
+```bash
+GRPC_PORT=50051        # gRPC server port
+LOG_LEVEL=info         # logging severity (debug, info, warn, error)
+```
+
+## Running
+
+### Build + run
+
+```bash
+make run
+```
+
+### Build
+
+```bash
+make build
+```
+
+### gRPC code generation
+
+```bash
+make generate
+```