Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/devstackq/bazar
service to sale car
https://github.com/devstackq/bazar
docker gin-gonic golang postgres
Last synced: about 1 month ago
JSON representation
service to sale car
- Host: GitHub
- URL: https://github.com/devstackq/bazar
- Owner: devstackq
- Created: 2022-03-15T16:57:09.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2022-05-18T20:06:00.000Z (over 2 years ago)
- Last Synced: 2024-09-30T07:21:58.743Z (about 2 months ago)
- Topics: docker, gin-gonic, golang, postgres
- Language: Go
- Homepage: https://baz-ar.herokuapp.com/
- Size: 5.93 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.MD
Awesome Lists containing this project
README
bazar-platform
Golang/Postgres
запуск БД и приложения в докере
docker-compose up
swagger run
swag init -g ./server/server.go -d ./internal/ --parseInternal --output ./docs
Функциональность bazar-platform:
url : http://localhost:6969
-------------------------------
Админ панель(опционалка)in further:
/v1/any/:id :GET return 1 item
/v1/any :GET - return listItems
Вначале добавить, по убыванию:
Роли, Страну, Город, Юзера, Бренд, Модель и .т.д
Создание ролей(админ, продавец, покупатель, тд)
/v1/role : POST
Request : {name : "saler"}; Response{Status, Message}
|| insert into bazar_roles(name) values('saler');
Страна - Грузия, Оаэ, Россия...
header[access_token]
/v1/country : POST; {"name" : ""}; Response{Status, Message}
Город - Тбилииси, Дубай, Москоу
header[access_token]
/v1/city/:country_id : POST; {"name" : ""}; Response{Status, Message}
Бренд - Tesla, Toyota...
header[access_token]
/v1/brand : POST; {"name" : ""}; Response{Status, Message}
Модель - Model X3, S; Supra, Camry...
header[access_token]
/v1/model/:brand_id : POST; {"name" : ""}; Response{Status, Message}
Категории - Легковые, Мотоциклы, Яхты...
header[access_token]
/v1/category : POST; {"name" : ""}; Response{Status, Message}
Состояние - Новые, БУ, Битые
header[access_token]
/v1/state : POST; {"name" : ""}; Response{Status, Message}
Топливо - Дизель, Бензин, Электричество
header[access_token]
/v1/fuel : POST; {"name" : ""}; Response{Status, Message}
Трансмиссия - Акпп, Мкпп, Гибрид
header[access_token]
/v1/transmission : POST; {"name" : ""}; Response{Status, Message}
Привод - Передний, Задний, Полный
header[access_token]
/v1/drive_unit : POST; {"name" : ""}; Response{Status, Message}
Тип кузова - Седан, купе, кабриолет..
header[access_token]
/v1/body_type : POST; {"name" : ""}; Response{Status, Message}
Цвет - красный, белый...
header[access_token]
/v1/color : POST; {"name" : ""}; Response{Status, Message}
------------------------------
Создание юзера(продавец)
/v1/auth/signup : POST
Request:
{
"email": "[email protected]",
"username":"saler",
"phone":87471370784,
"first_name":"Glize",
"last_name":"Union",
"password":"123user",
"company" : "dillerX",
fetch(/v1/country) return list(countries)
"country": {
"id" : int
"city" : {
fetch(/v1/city/:countryID) return list(cities)
id: int
}
}
fetch(/v1/role) return list(roles)
"role" {
"id : int
}
}
Response {statusCode, Message, Set Header[access_token, refresh_token]}
------------------------------
Вход в систему
/v1/auth/signin : POST
Request:
{
string username
string password
}
Response {statusCode, Message, Header[access_token, refresh_token]}
------------------------------
Обновление access токена, при статусе 401
/v1/auth/refresh -> POST
Request(Header[refresh_token])
Response {statusCode, Message, Header[access_token, refresh_token]}
------------------------------
(Если refresh токен недействителен, то redirect на signin)
------------------------------
Выход из системы
/v1/auth/logout
Request(Header[access_token])
Response {statusCode, Message, Remove access/refresh token}
------------------------------
Профиль
Request : header[access_token]
/v1/profile : GET
/v1/machine/user?page_num=1 GET
Response: {
UserInfo
ListCreatedCarsByUserID
}
------------------------------
Создание машины
Прежде чем добавить машины: -> добавить в БД, админские crud(cateogry,model, brand, etc)
/v1/machine : POST
Request:
header[access_token]
Получить список полей с данными для : transmision, brand, category, etc -> fetch(v1/transmission, v1/category, etc...)
1.1
{
"title": "Sale the best car, because i need money",
"description": "this car bla bla...",
"year": 2009,
"price": 29500.1,
"odometer": 3000,
"horse_power": 200,
"volume": 3.5,
"transmission": {
"id": 1
},
"body_type": {
"id": 1
},
"color": {
"id": 1
},
"category": {
"id": 1
},
"brand": {
"id": 1,
"model": {
"id": 1
}
},
"state": {
"id": 1
},
"country": {
"id": 1,
"city": {
"id": 1
}
},
"fuel": {
"id": 1
},
"drive_unit": {
"id": 1
}
}
Response {Status, lastCarID}
async, await
1.2
Zатем выгрузка фото на файловый сервер
/v1/machine/upload/lastCarID
Request {key : MultipartFile}
Resonse : {Status, Message}
------------------------------
Главная:
Вернет список машин, по дате добавления
пагинация по query-param; page_num; по умолчанию = 1 ( выдает по 9 машин)
/v1/machine?page_num=2 : GET
Response{
[]Machine{...}
}
------------------------------
Пагинация
/v1/machine?page_num
limit = default 9
может с фильтром/сортировкой - работать
------------------------------
Карточка машины (Вернет машину по его ID)
/v1/machine/:id : GET
Response{
Machine{...}
}
------------------------------
Фильтрация, по категории, состоянию, бренду, модели
/v1/machine/filter query-param : ["category", "state", "brand", "model"] id
Response : {
[]Machine{...}
}
Фильтрация по цене - /v1/machine/filter query-param [priceTo/proceFrom] float
------------------------------
Поиск по title или description
/v1/machine/search/:POST query-param key_word
Response : {
[]Machine{...}
}
------------------------------
Сортировка, (может включать поля фильтрации)
/v1/machine/filter query-param : ["category", "state", "brand", "model", priceFrom, priceTo] +
sort_created_at/sort_price/sort_year/sort_odometer - asc/desc
------------------------------