From 8eac71e65c9568a6adb3640cc687cf4a03a10bbd Mon Sep 17 00:00:00 2001
From: Pavel Sinitsin <spavelit@list.ru>
Date: Sun, 8 Sep 2024 14:25:11 +0300
Subject: [PATCH] Add README and LICENSE files

Introduce initial README.md with project setup, usage instructions, and method documentation for the IEK business platform API client. Additionally, include the MIT license information in LICENSE.md.
---
 LICENSE.md |  21 +++++++++
 README.md  | 133 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 154 insertions(+)
 create mode 100644 LICENSE.md
 create mode 100644 README.md

diff --git a/LICENSE.md b/LICENSE.md
new file mode 100644
index 0000000..cee8b6b
--- /dev/null
+++ b/LICENSE.md
@@ -0,0 +1,21 @@
+Лицензия MIT (MIT)
+
+Авторские права (c) 2024 Павел Синицин
+
+Настоящим предоставляется бесплатное разрешение любому лицу, получившему копию
+этого программного обеспечения и сопутствующей документации (в дальнейшем "Программное обеспечение"), использовать
+Программное обеспечение без ограничений, включая неограниченное право на использование, копирование, изменение, слияние,
+публикацию, распространение, сублицензирование и/или продажу копий
+Программного обеспечения, а также лицам, которым предоставляется данное Программное обеспечение, при соблюдении
+следующих условий:
+
+Указанное выше уведомление об авторских правах и данное разрешение должны быть включены во все
+копии или значительные части этого Программного обеспечения.
+
+Программное обеспечение предоставляется "КАК ЕСТЬ", без каких-либо гарантий, явных или
+подразумеваемых, включая, но не ограничиваясь, гарантии товарной пригодности, пригодности
+для конкретной цели и ненарушения прав. Ни в коем случае авторы или
+владельцы авторских прав не несут ответственности за любые претензии, убытки или другие обязательства, будь то в иске по
+договору, деликту или ином,
+возникающем из, связанного с Программным обеспечением или использования Программного обеспечения или других действий с
+Программным обеспечением.
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7846f9d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,133 @@
+# API клиент бизнес-платформы IEK
+
+## Содержание
+
+- [Начало работы](#начало-работы)
+- [Установка](#установка)
+- [Использование](#использование)
+- [Доступные методы](#доступные-методы)
+- [Используемые инструменты](#используемые-инструменты)
+- [Авторы](#авторы)
+- [Лицензия](#лицензия)
+
+## Начало работы
+
+Эти инструкции помогут вам запустить копию проекта на вашем локальном компьютере для целей разработки и тестирования.
+
+
+
+#### Установка Go
+
+Убедитесь, что у вас установлена последняя версия Go. Инструкции по установке можно найти на официальном
+сайте [Go](https://golang.org/doc/install).
+
+Пример:
+
+```sh
+go version go1.23.1
+```
+
+
+### Установка
+
+Пошаговая инструкция по созданию окружения.
+
+1. Установите проект с помощью `go get`
+   ```sh
+   go get -u gitea.24example.ru/spavelit/bpiek
+   ```
+2. Установите зависимости
+   ```sh
+   go mod tidy
+   ```
+
+### Использование
+
+Инструкции по использованию вашего проекта.
+
+#### Запуск приложения
+
+Пример:
+
+```sh
+go run main.go
+```
+
+#### Пример использования
+
+Примечание:
+Добавьте пример кода, чтобы пользователи могли быстро начать работу с вашим проектом.
+
+```go
+package main
+
+import (
+	"encoding/json"
+	"fmt"
+	bpiek "gitea.24example.ru/spavelit/bpiek/api"
+)
+
+func main() {
+	credentials := bpiek.Credentials{
+		Username: "mail@example.ru",
+		Password: "password",
+	}
+
+	api := bpiek.NewApi(credentials)
+	
+	result, err := api.GetRemainsAndPlanresidues()
+	if err != nil {
+		panic(err)
+	}
+
+	b, _ := json.MarshalIndent(result[1], "", "  ")
+	fmt.Print(string(b))
+}
+```
+
+### Доступные методы
+
+В данном разделе приведены основные методы, доступные в API клиенте для бизнес-платформы IEK:
+
+1. `NewApi(credentials bpiek.Credentials)`
+    - Создает новый экземпляр API клиента с предоставленными учетными данными.
+
+2. `GetParentCategories() ([]model.Category, error)`
+    - Возвращает массив категорий каталога 1-ого уровня.
+
+3. `GetCategories() ([]model.Category, error)`
+    - Возвращает массив с категориями.
+
+4. `GetTreeCategories() ([]model.TreeCategories, error)`
+    - Возвращает дерево категорий.
+
+5. `GetProducts() ([]model.Product, error)`
+    - Возвращает массив с продукцией.
+
+6. `GetProductByArticle(article string) (model.Product, error)`
+    - Возвращает товар по артикулу.
+
+7. `GetRemainsAndPlanresidues() ([]model.ShortProduct, error)`
+    - Возвращает массив, в котором содержатся актуальные цены
+      и остатки товаров.
+
+
+Эти методы могут использоваться для взаимодействия с бизнес-платформой IEK в рамках вашего проекта. Подробная
+документация каждого метода доступна в исходниках или официальной документации БП IEK.
+
+
+## Используемые инструменты
+
+Список инструментов и библиотек, которые использовались при создании проекта.
+
+* [GoLang](https://golang.org/) - Язык программирования.
+* [Resty](https://github.com/go-resty/resty) - Simple HTTP and REST client library for Go.
+
+
+## Авторы
+
+* **Павел Синицин** - *Rosar-L* - [Gitea](https://gitea.24example.ru/spavelit/)
+
+## Лицензия
+
+Этот проект лицензирован под лицензией MIT - подробности смотрите в файле [LICENSE.md](LICENSE.md).
\ No newline at end of file