https://github.com/aslon1213/reservations-api
YBKY saralash bosqichi topshirig'i - reservations
https://github.com/aslon1213/reservations-api
docker docker-compose gin-gonic golang gorm-orm mysql reservation-system testing
Last synced: 3 months ago
JSON representation
YBKY saralash bosqichi topshirig'i - reservations
- Host: GitHub
- URL: https://github.com/aslon1213/reservations-api
- Owner: aslon1213
- Created: 2023-06-16T05:55:08.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-06-25T20:32:05.000Z (almost 3 years ago)
- Last Synced: 2025-08-04T04:00:01.416Z (8 months ago)
- Topics: docker, docker-compose, gin-gonic, golang, gorm-orm, mysql, reservation-system, testing
- Language: Go
- Homepage:
- Size: 50.2 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Installation
- Birinchi navbatda kompyuteringizda Docker o'rnatilgan bo'lishi kerak. Bo'lmasa yuklab olish uchun https://www.docker.com . docker-compose.yml file turgan directoryda terminal ochib ushbu komandani tering.
`docker compose up -d --build `
- Bu mysql serverni containerini servis sifatida hosil qilib localhost:3305 ga ulaydi va go serverni containerini localhost:8080 ga ulaydi.
- xonalar haqida ushbu malu'motlar oldindan kiritiladi containerlar ishga tushganda
```json
{
"id": 1,
"name": "mytaxi",
"type": "focus",
"capacity": 1
},
{
"id": 2,
"name": "workly",
"type": "team",
"capacity": 5
},
{
"id": 3,
"name": "express24",
"type": "conference",
"capacity": 15
}
```
- Reservation API.postman_collection.json - postman uchun specificationlar
# YBKY saralash bosqichi topshirig'i
Impactt co-working markazi rezidentlariga majlis xonalarni oldindan oson band qilish uchun tizim yaratmoqchi va bunda sizning yordamingiz kerak.
Backend yo'nalishiga topshirganlar tizim uchun REST API tuzishi kerak bo'ladi. Frontend yo'nalishi qatnashchilaridan esa ushbu tizim uchun foydalanuvchi interfeysini yasash kutiladi.
## Tizimning funksional talablari:
- Xonalar haqida ma'lumot saqlash va taqdim qila olish;
- Xonani ko'rsatilgan vaqt oralig'i uchun band qila olish;
- Bir xonaning band qilingan vaqtlari ustma-ust tushmasligi kerak;
- Autentifikatsiya (login) imkoniyatini qo'shish talab qilinmaydi.
## Ko'p so'ralgan savollar:
- Qaysi dasturlash tilidan foydalanish kerak? Istalgan!
- Kutubxona va freymvorklardan foydalanish mumkinmi? Ha.
- Qaysi ma'lumotlar omboridan foydalanish mumkin? Fuksional talablarni qondiradigan istalgan ma'lumotlar omboridan foydalanishingiz mumkin.
## Loyihani topshirish uchun talablar.
- GitHubda `private` repozitoriya yarating
- Ishingizni bosqichma-bosqich `commit` qilib boring
- GitHub repozitoriyaning `settings` qismidan `ybky42` foydalanuvchisini `Collaborator` sifatida qo'shing.
- **20-iyunga qadar loyihani yakunlab, `Pull Request` yaratib, `ybky42` foydalanuvchisini `Reviewer` sifatida qo'shing.**
- Savollaringizni ushbu `gist` ostidagi izohlarda qoldiring.
---
## Mavjud xonalarni olish uchun API
```
GET /api/rooms
```
Parametrlar:
- `search`: Xona nomi orqali qidirish
- `type`: xona turi bo'yicha saralash (`focus`, `team`, `conference`)
- `page`: sahifa tartib raqami
- `page_size`: sahifadagi maksimum natijalar soni
HTTP 200
```json
{
"page": 1,
"count": 3,
"page_size": 10,
"results": [
{
"id": 1,
"name": "mytaxi",
"type": "focus",
"capacity": 1
},
{
"id": 2,
"name": "workly",
"type": "team",
"capacity": 5
},
{
"id": 3,
"name": "express24",
"type": "conference",
"capacity": 15
}
]
}
```
---
## Xonani id orqali olish uchun API
```
GET /api/rooms/{id}
```
HTTP 200
```json
{
"id": 3,
"name": "express24",
"type": "conference",
"capacity": 15
}
```
HTTP 404
```json
{
"error": "topilmadi"
}
```
---
## Xonaning bo'sh vaqtlarini olish uchun API
```
GET /api/rooms/{id}/availability
```
Parametrlar:
- `date`: sana (ko'rsatilmasa bugungi sana olinadi)
Response 200
```json
[
{
"start": "05-06-2023 9:00:00",
"end": "05-06-2023 11:00:00"
},
{
"start": "05-06-2023 13:00:00",
"end": "05-06-2023 18:00:00"
}
]
```
---
## Xonani band qilish uchun API
```
POST /api/rooms/{id}/book
```
```json
{
"resident": {
"name": "Anvar Sanayev"
},
"start": "05-06-2023 9:00:00",
"end": "05-06-2023 10:00:00"
}
```
---
HTTP 201: Xona muvaffaqiyatli band qilinganda
```json
{
"message": "xona muvaffaqiyatli band qilindi"
}
```
HTTP 410: Tanlangan vaqtda xona band bo'lganda
```json
{
"error": "uzr, siz tanlagan vaqtda xona band"
}
```