Facility-Owner

Nội dung trong tài liệu ngoài những API kể ở trên, e có viết thêm tài liệu cho những API get master data từ Rakuichi. Những data này hiện tại đang được lấy trực tiếp từ database Rakuichi, e nghĩ sau này cũng sẽ chuyển qua call API nên viết luôn

https://app.swaggerhub.com/apis-docs/clmtnghia/RakuichiExternalAPI/1.0.0

E đang push tạm thời lên đây
https://app.swaggerhub.com/apis-docs/clmtnghia/RakuichiExternalAPI/1.0.0

a @dang dao review giúp e xem chỗ nào cần update. Xong hết e sẽ push lên git kia sau

@Nghia Nguyen a có review

1. api get order detail

• hình như e viết theo table design cũ có field facility id. update lại theo table design mới nhất hén.
• field block_address lấy từ đâu ? ( ko thấy trong table order)
• field power ở đâu ra ? ( ko thấy trong table order)
• e xem lại danh sách field response koi có dư/thiếu field nào nữa ko hén
• chỗ này sẽ lấy data từ order và order status ?

2. api get list order

• owner_no là field gì ?
• thiếu mấy field liên quan đến place
• a thấy thiếu nhiều field lắm. dò lại list field cho phép filter trên màn hình list hén. đảm bảo các field đó phải có trong api này

4. mấy cái api khác tại sao cần làm ? holiday-master, facility-categories...

→ Hiện tại facility owner đang select data trực tiếp từ table bên Rakuichi. E nghĩ sau này nên đổi qua call API hết nên những API này sẽ cần

order tại sao chia làm 2 api ?
a thấy chỉ cần 1 api update order là đủ rồi mà. nghiệp vụ có gì khác nhau sao ?
Rep:
E nghĩ 2 chỗ đó nghiệp vụ khác nhau nên tách ra 2 API.
API dùng để update status: API này chỉ thao tác trên table order_status
API update calendar khi update order: API này với payload là mảng các ngày được chọn, ko thao trên table order_status.

2 API thao tác trên các table khác nhau nên e nghĩ tách ra sẽ đỡ được đoạn if else. Sau này có thay đổi hay có bug cũng dễ điều tra hơn.

mấy cái comment ở trên e có update rồi nhưng mà chắc đợi e review lại các field trong response thêm lần nữa r dịch tài liệu qua tiếng Nhật

@Nghia Nguyen a có review thêm

1. api order list

• phần sort e ghi Directions: asc (ascending), desc (descending) là ý như thế nào ?
• trong response field cái pagination a thấy ko cần thiết. thêm 1 field hit để biết tổng data là được rồi. sau đó dựa vào offset với index để lấy là được rồi. bỏ field per_page luôn đi.
• tên field response đặt lại cho khớp với trong db hén

2. api order detail

• xem lại tên field mapping với trong db
• lấy thêm thông tin bên table order_date_prices

3. api order/status

• send mail là send từ owner system, chứ ko phải thông qua api. nên trong response của api e bỏ phần liên quan tới mail hén

4. 2 api liên quan tới place

• trong request params đổi tên place_id -> owner_place_id để phân biệt với id bên rakuichi

e sửa hết mấy ý trên đi rồi sắp xếp review với a 1 buổi. ok rồi thì mới dịch qua tiếng Nhật

Chỗ e host cái swagger hôm bữa hết hạn r. Nay e host trên source facility owner trên server dev luôn

https://facility-owner.columbusmantech.dev/api-docs/custom#/Orders/get_orders

trong request params đổi tên place_id -> owner_place_id để phân biệt với id bên rakuichi Field này đổi tên là owner_place_id để phân biệt thôi chứ lúc gọi từ Owner System qua Rakuichi System mình vẫn phải dùng field place.id mà đúng ko a? Chứ nếu dùng ownerPalceId có thể bị trùng

Các field trong API GET Order List và Order Detail e đang lấy theo các field trong table bên Owner System.
Ban đầu e lấy theo bên Rakuichi System nhưng có mấy field nó khác tên nên cũng ko biết nó là field nào bên đó.