From fc5b3a63c03903c9528dde9fe8eaf43d1c9bd020 Mon Sep 17 00:00:00 2001 From: Nikitin Aleksandr Date: Fri, 15 Mar 2024 16:30:07 +0300 Subject: [PATCH] =?UTF-8?q?=D1=81=D0=B4=D0=B5=D0=BB=D0=B0=D0=BB=20readme?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 13 ++++++++++--- readme.rus | 19 +++++++++++++------ 2 files changed, 23 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index cfc9504..0bbbbce 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,12 @@ in golang language to perform CRUD operations. A completely ready-made microservice is created that can be launched immediately. For each table in the Postgres SQL database, files will be created to perform crud operations: -create, read, update, save, delete (or delete + restore) +- Create(), Read(), Update(), Delete() (or Delete() + Restore(), if there is an is_deleted field) +- Save() - creating a new record when ID=0, or updating a record when ID<>0 +- ReadFromCache() - reading from cache or database +- Update_ColumnName() - changing only one column with the name ColumnName, +separate function for each column of each table + files are generated: 1. table - struct structure with all fields from the database, and gorm + json annotations Tables with fields in the database must be created manually in advance. @@ -45,11 +50,13 @@ the crud_generator file will appear in the bin folder - URL of your new service - and etc. -3. Launch crud_generator +3. Tables in the database must be created in advance, manually. + +4. Launch crud_generator A new folder with the name of your service will appear in the bin folder, with subfolders and finished files inside. -4. Fill in the configuration parameters in the .env file +5. Fill in the configuration parameters in the .env file Start microservice: make run diff --git a/readme.rus b/readme.rus index 3a2e82b..5aaed86 100644 --- a/readme.rus +++ b/readme.rus @@ -3,7 +3,12 @@ Создаётся полностью готовый микросервис, который можно сразу запустить. Для каждой таблицы в базе данных Postgres SQL будут сделаны файлы для выполнения crud операций: -create, read, update, save, delete (или delete + restore) +- Create(), Read(), Update(), Delete() (или Delete() + Restore() если есть поле is_deleted) +- Save() - создание новой записи при ID=0, или обновление записи при ID<>0 +- ReadFromCache() - чтение из кэша или базы данных +- Update_ColumnName() - изменение только одной колонки с именем ColumnName, +отдельная функция для каждой колонки каждой таблицы. + генерируются файлы: 1. table - структура struct со всеми полями из БД, и аннотациями gorm + json Таблицы с полями в базе данных должны быть созданы заранее вручную. @@ -22,7 +27,7 @@ create, read, update, save, delete (или delete + restore) 7. crud_starter - файл с функциями переключения на нужный протокол db или grpc или nrpc 8. main.go и другие .go файлы 9. Makefile - файл настройки запуска скриптов -10. .env - файл для зазполнения конфигурации микросервиса (параметры подключения к БД и др.) +10. .env - файл для заполнения конфигурации микросервиса (параметры подключения к БД и др.) Шаблоны кода хранятся в папке bin/templates. @@ -35,7 +40,7 @@ create, read, update, save, delete (или delete + restore) Порядок установки: 1. Скомпилировать этот репозиторий -make build +>make build в папке bin появится файл crud_generator 2. Заполнить найстройки в файле bin/templates/configs_/settings.txt @@ -44,13 +49,15 @@ make build - URL вашего нового сервиса - и др. -3. Запустить crud_generator +3. Таблицы в базе данных должны быть сделаны заранее, вручную. + +4. Запустить crud_generator В папке bin появится новая папка с именем вашего сервиса, с подпапками и готовыми файлами внутри. -4. Заполнить параметры конфигурации в файле .env +5. Заполнить параметры конфигурации в файле .env Запустить микросервис: -make run +>make run