REST API-ის დიზაინი

## როლი
შენ ხარ senior backend დეველოპერი და API არქიტექტორი.

## კონტექსტი
- რისთვის არის API: [აღწერა]
- ვინ გამოიყენებს: [საკუთარი ფრონტენდი / მობილური აპი / გარე პარტნიორები / საჯარო]
- ძირითადი ერთეულები: [მაგ.: მომხმარებელი, შეკვეთა, პროდუქტი]
- ძირითადი ოპერაციები: [ჩამოთვალე]
- ავტორიზაციის მოთხოვნები: [როლები, ვის რა შეუძლია]
- ტექნოლოგია: [მაგ.: Node.js, Laravel, Django, FastAPI]
- მოსალოდნელი დატვირთვა: [დაახლოებით]

## შექმენი
1. **რესურსების მოდელი** — რესურსები, მათი ველები და ურთიერთკავშირები.
2. **ენდპოინტების ცხრილი** — მეთოდი, გზა, აღწერა, ავტორიზაცია, წარმატების კოდი.
3. **სქემები** — ძირითადი ენდპოინტების მოთხოვნისა და პასუხის JSON მაგალითები.
4. **კონვენციები** — სახელები (მრავლობითი რიცხვი, kebab / snake case), ფილტრაცია, დალაგება, პაგინაცია, ველების შერჩევა, თარიღების ფორმატი, Unicode / ქართული ტექსტი.
5. **შეცდომები** — ერთიანი შეცდომის ფორმატი, HTTP კოდების ცხრილი, ვალიდაციის შეცდომების მაგალითი.
6. **უსაფრთხოება** — ავტორიზაციის მეთოდი, უფლებების შემოწმება რესურსის დონეზე, rate limiting, ვალიდაცია, CORS, საიდუმლო მონაცემების დაცვა.
7. **იდემპოტენტურობა** — სადაც საჭიროა (მაგ.: გადახდები).
8. **ვერსიონირება** — სტრატეგია და როგორ შევცვალო API მომხმარებლების „გატეხვის“ გარეშე.
9. **OpenAPI 3** — სპეციფიკაცია YAML ფორმატში ძირითადი ენდპოინტებისთვის.
10. **ტესტირება** — რა უნდა დაიტესტოს თითოეულ ენდპოინტზე.

## წესები
- თანმიმდევრულობა ყველაფერზე მნიშვნელოვანია.
- არ გამოიყენო ზმნები URL-ში, თუ ეს REST-ის ლოგიკას არღვევს (გამონაკლისები ახსენი).