@prodoctors/contracts 1.13.0 → 1.15.0

package/proto/payment.proto

@@ -0,0 +1,145 @@
+syntax = "proto3";
+
+package payment.v1;
+
+import "google/protobuf/timestamp.proto";
+import "common.proto";
+
+// Onlayn to'lov provayderi.
+enum PaymentProvider {
+  PAYMENT_PROVIDER_UNSPECIFIED = 0;
+  PAYMENT_PROVIDER_VIA = 1;
+}
+
+// To'lov oqimi.
+enum PaymentFlow {
+  PAYMENT_FLOW_UNSPECIFIED = 0;
+  // Hisob-faktura: mijoz provayder tomonida to'laydi (karta bizdan o'tmaydi).
+  PAYMENT_FLOW_INVOICE = 1;
+  // Karta tokeni bilan ushlab turish, olib ketishda yechish.
+  PAYMENT_FLOW_HOLD = 2;
+}
+
+// To'lov holati.
+enum PaymentStatus {
+  PAYMENT_STATUS_UNSPECIFIED = 0;
+  PAYMENT_STATUS_PENDING = 1;
+  PAYMENT_STATUS_HELD = 2;
+  PAYMENT_STATUS_PAID = 3;
+  PAYMENT_STATUS_CANCELLED = 4;
+  PAYMENT_STATUS_FAILED = 5;
+  PAYMENT_STATUS_REFUNDED = 6;
+}
+
+message Payment {
+  string id = 1;
+  string web_order_id = 2;
+
+  PaymentProvider provider = 3;
+  PaymentFlow flow = 4;
+  PaymentStatus status = 5;
+
+  string amount = 6;
+  string currency = 7;
+
+  // Bizning idempotentlik kalitimiz.
+  string external_id = 8;
+  // Provayder hisob-fakturasi (`inv_...`).
+  optional string invoice_id = 9;
+  // Provayder tranzaksiyasi (`trx_...`).
+  optional string transaction_id = 10;
+  // Mijozni yo'naltirish uchun to'lov sahifasi (bo'lsa).
+  optional string payment_url = 11;
+  // Karta niqobi (oxirgi raqamlar). To'liq PAN saqlanmaydi.
+  optional string card_mask = 12;
+
+  optional google.protobuf.Timestamp paid_at = 13;
+  optional string failure_reason = 14;
+
+  google.protobuf.Timestamp created_at = 15;
+  google.protobuf.Timestamp updated_at = 16;
+}
+
+message StartPaymentRequest {
+  string web_order_id = 1;
+  // Ko'rsatilmasa INVOICE ishlatiladi.
+  PaymentFlow flow = 2;
+
+  // HOLD oqimi uchun majburiy.
+  optional string card_token = 3;
+
+  optional string receiver_phone = 4;
+  optional string receiver_email = 5;
+}
+
+message GetPaymentByOrderRequest {
+  string web_order_id = 1;
+}
+
+// Provayder callback'i yoki UI polling — holatni provayderdan tortadi.
+message SyncPaymentRequest {
+  // Ikkalasidan biri: bizning to'lov id yoki provayder tranzaksiya/invoice id.
+  optional string payment_id = 1;
+  optional string external_id = 2;
+  optional string provider_reference = 3;
+}
+
+// HOLD → yechish (dori berilganda).
+message ConfirmPaymentRequest {
+  string payment_id = 1;
+}
+
+// HOLD → qaytarish (bron bekor/muddati o'tganda).
+message CancelPaymentRequest {
+  string payment_id = 1;
+  optional string reason = 2;
+}
+
+// --- Karta kiritish (karta SAQLANMAYDI) ---
+//
+// Oqim: RegisterCard (karta ma'lumoti) -> mijozga SMS -> ConfirmCard (kod)
+// -> olingan token DARHOL hold yaratishga ishlatiladi va tashlab yuboriladi.
+// PAN hech qayerda saqlanmaydi va loglanmaydi.
+
+message RegisterCardRequest {
+  string web_order_id = 1;
+  // Karta raqami — faqat provayderga uzatiladi, saqlanmaydi.
+  string pan = 2;
+  string exp_month = 3;
+  string exp_year = 4;
+  string phone = 5;
+}
+
+message RegisterCardResponse {
+  string payment_id = 1;
+  string verify_id = 2;
+  // SMS yuborilgan raqam niqobi (mijozga ko'rsatish uchun).
+  string phone_mask = 3;
+}
+
+message ConfirmCardRequest {
+  string payment_id = 1;
+  string verify_code = 2;
+}
+
+message ResendCardCodeRequest {
+  string payment_id = 1;
+}
+
+message ResendCardCodeResponse {
+  string verify_id = 1;
+  string phone_mask = 2;
+}
+
+service PaymentService {
+  rpc StartPayment(StartPaymentRequest) returns (Payment);
+  rpc GetPayment(common.v1.IdRequest) returns (Payment);
+  rpc GetPaymentByOrder(GetPaymentByOrderRequest) returns (Payment);
+  rpc SyncPayment(SyncPaymentRequest) returns (Payment);
+  rpc ConfirmPayment(ConfirmPaymentRequest) returns (Payment);
+  rpc CancelPayment(CancelPaymentRequest) returns (Payment);
+
+  rpc RegisterCard(RegisterCardRequest) returns (RegisterCardResponse);
+  rpc ConfirmCard(ConfirmCardRequest) returns (Payment);
+  rpc ResendCardCode(ResendCardCodeRequest) returns (ResendCardCodeResponse);
+}

package/proto/prescription.proto

@@ -17,6 +17,9 @@ message SearchPrescriptionRequest {
   optional string birth_date = 6; // YYYY-MM-DD
   optional bool is_confidant = 7;
   optional string qr = 8; // "prescription-{patient_id}-{safe_code}" — parse qilinadi
+  // Retseptni ochayotgan farmatsevt. DMED tokeni har bir shaxsga alohida
+  // bog'langani uchun (retsept berish DMED'da shaxsga yoziladi) majburiy.
+  string account_id = 9;
 }
 
 // Bizning katalogdagi mos mahsulot (filialda mavjud stock bilan).
@@ -73,6 +76,8 @@ message DispenseRequest {
   optional string marking_code = 5;
   int32 drug_amount = 6;
   int64 price = 7;
+  // Dorini beruvchi farmatsevt — DMED tokeni shu shaxsniki.
+  string account_id = 8;
 }
 
 message CheckIssueResponse {
@@ -86,7 +91,42 @@ message IssueResponse {
   string message = 3;
 }
 
+// --- DMED hisobini ulash (OAuth2 Authorization Code) ---
+// Token har bir farmatsevtga alohida saqlanadi.
+
+message DmedAccountRequest {
+  string account_id = 1;
+}
+
+message DmedAuthorizeUrlResponse {
+  // Farmatsevt shu manzilga yo'naltiriladi (DMED login sahifasi).
+  string authorize_url = 1;
+  // CSRF himoyasi uchun; callback'da qaytib keladi.
+  string state = 2;
+}
+
+message CompleteDmedConnectionRequest {
+  string account_id = 1;
+  string code = 2;
+}
+
+message DmedConnectionStatus {
+  bool connected = 1;
+  optional string dmed_email = 2;
+  // Access token qachon tugashi (ISO 8601).
+  optional string expires_at = 3;
+}
+
 service PrescriptionService {
+  // DMED hisobini ulash: login manzilini beradi.
+  rpc ConnectDmed(DmedAccountRequest) returns (DmedAuthorizeUrlResponse);
+  // Callback'dan kelgan `code` ni tokenga almashtirib saqlaydi.
+  rpc CompleteDmedConnection(CompleteDmedConnectionRequest) returns (DmedConnectionStatus);
+  // Ulanish holati (POS "ulangan/ulanmagan" ko'rsatishi uchun).
+  rpc GetDmedStatus(DmedAccountRequest) returns (DmedConnectionStatus);
+  // Ulanishni uzish.
+  rpc DisconnectDmed(DmedAccountRequest) returns (DmedConnectionStatus);
+
   // Retsept qidirish + bizdagi mos stockni topish.
   rpc SearchPrescription(SearchPrescriptionRequest) returns (SearchPrescriptionResponse);
   // Berishdan oldin DMED'da tekshirish.

package/proto/reservation.proto

@@ -1,207 +1,224 @@
-syntax = "proto3";
-
-package reservation.v1;
-
-import "google/protobuf/timestamp.proto";
-import "common.proto";
-
-enum WebReservationStatus {
-  WEB_RESERVATION_STATUS_UNSPECIFIED = 0;
-  WEB_RESERVATION_STATUS_CREATED = 1;
-  WEB_RESERVATION_STATUS_CONFIRMED = 2;
-  WEB_RESERVATION_STATUS_READY = 3;
-  WEB_RESERVATION_STATUS_COMPLETED = 4;
-  WEB_RESERVATION_STATUS_CANCELLED = 5;
-  WEB_RESERVATION_STATUS_EXPIRED = 6;
-}
-
-enum WebOrderStatus {
-  WEB_ORDER_STATUS_UNSPECIFIED = 0;
-  WEB_ORDER_STATUS_CREATED = 1;
-  WEB_ORDER_STATUS_CONFIRMED = 2;
-  WEB_ORDER_STATUS_READY = 3;
-  WEB_ORDER_STATUS_COMPLETED = 4;
-  WEB_ORDER_STATUS_CANCELLED = 5;
-  WEB_ORDER_STATUS_EXPIRED = 6;
-}
-
-message WebReservation {
-  string id = 1;
-  string reservation_number = 2;
-  WebReservationStatus status = 3;
-
-  string product_id = 4;
-  string product_batch_id = 5;
-  string branch_id = 6;
-  optional string customer_id = 7;
-
-  optional string order_id = 8;
-
-  string product_name = 9;
-  string pharmacy_name = 10;
-
-  string customer_name = 11;
-  string phone = 12;
-  optional string comment = 13;
-  optional string city = 14;
-
-  int32 quantity = 15;
-  string unit_price = 16;
-  string total_price = 17;
-  string source = 18;
-
-  google.protobuf.Timestamp created_at = 19;
-  google.protobuf.Timestamp expires_at = 20;
-  google.protobuf.Timestamp updated_at = 21;
-}
-
-message CreateWebReservationRequest {
-  string product_id = 1;
-  string product_batch_id = 2;
-  string branch_id = 3;
-
-  optional string order_id = 4;
-
-  string product_name = 5;
-  string pharmacy_name = 6;
-
-  string customer_name = 7;
-  string phone = 8;
-  optional string comment = 9;
-  optional string city = 10;
-
-  int32 quantity = 11;
-  string unit_price = 12;
-  string total_price = 13;
-  optional string source = 14;
-}
-
-message ListWebReservationsRequest {
-  common.v1.PaginationRequest pagination = 1;
-  optional WebReservationStatus status = 2;
-  optional string branch_id = 3;
-  optional string phone = 4;
-  optional string reservation_number = 5;
-  optional string order_id = 6;
-}
-
-message ListWebReservationsResponse {
-  repeated WebReservation items = 1;
-  common.v1.PaginationMeta meta = 2;
-}
-
-message UpdateWebReservationStatusRequest {
-  string id = 1;
-  WebReservationStatus status = 2;
-}
-
-message WebOrderItem {
-  string id = 1;
-  string reservation_id = 2;
-
-  string product_id = 3;
-  string product_batch_id = 4;
-  string branch_id = 5;
-
-  string product_name = 6;
-  string pharmacy_name = 7;
-
-  int32 quantity = 8;
-  string unit_price = 9;
-  string total_price = 10;
-
-  WebReservationStatus status = 11;
-}
-
-message WebOrder {
-  string id = 1;
-  string order_number = 2;
-  WebOrderStatus status = 3;
-
-  string customer_name = 4;
-  string phone = 5;
-  optional string comment = 6;
-  optional string city = 7;
-
-  string source = 8;
-  int32 total_items = 9;
-  string total_price = 10;
-
-  google.protobuf.Timestamp created_at = 11;
-  google.protobuf.Timestamp expires_at = 12;
-  google.protobuf.Timestamp updated_at = 13;
-
-  repeated WebOrderItem items = 14;
-
-  // Buyurtma bajariladigan dorixona (bitta order = bitta filial).
-  optional string branch_id = 15;
-  optional string pharmacy_name = 16;
-}
-
-message GetWebOrderByNumberRequest {
-  string order_number = 1;
-}
-
-message FulfillWebOrderRequest {
-  string order_id = 1;
-  optional string cashier_id = 2;
-  string payment_method = 3; // PaymentMethod (CASH/CARD/...)
-  optional string paid_amount = 4;
-}
-
-message CreateWebOrderItem {
-  string product_id = 1;
-  string product_batch_id = 2;
-  string branch_id = 3;
-
-  string product_name = 4;
-  string pharmacy_name = 5;
-
-  int32 quantity = 6;
-  string unit_price = 7;
-  string total_price = 8;
-}
-
-message CreateWebOrderRequest {
-  string customer_name = 1;
-  string phone = 2;
-  optional string comment = 3;
-  optional string city = 4;
-  optional string source = 5;
-
-  repeated CreateWebOrderItem items = 6;
-}
-
-message ListWebOrdersRequest {
-  common.v1.PaginationRequest pagination = 1;
-  optional WebOrderStatus status = 2;
-  optional string phone = 3;
-  optional string order_number = 4;
-  optional string branch_id = 5;
-}
-
-message ListWebOrdersResponse {
-  repeated WebOrder items = 1;
-  common.v1.PaginationMeta meta = 2;
-}
-
-message UpdateWebOrderStatusRequest {
-  string id = 1;
-  WebOrderStatus status = 2;
-}
-
-service WebReservationService {
-  rpc CreateWebReservation(CreateWebReservationRequest) returns (WebReservation);
-  rpc GetWebReservation(common.v1.IdRequest) returns (WebReservation);
-  rpc ListWebReservations(ListWebReservationsRequest) returns (ListWebReservationsResponse);
-  rpc UpdateWebReservationStatus(UpdateWebReservationStatusRequest) returns (WebReservation);
-}
-
-service WebOrderService {
-  rpc CreateWebOrder(CreateWebOrderRequest) returns (WebOrder);
-  rpc GetWebOrder(common.v1.IdRequest) returns (WebOrder);
-  rpc GetWebOrderByNumber(GetWebOrderByNumberRequest) returns (WebOrder);
-  rpc ListWebOrders(ListWebOrdersRequest) returns (ListWebOrdersResponse);
-  rpc UpdateWebOrderStatus(UpdateWebOrderStatusRequest) returns (WebOrder);
-  rpc FulfillWebOrder(FulfillWebOrderRequest) returns (WebOrder);
-}
+syntax = "proto3";
+
+package reservation.v1;
+
+import "google/protobuf/timestamp.proto";
+import "common.proto";
+
+enum WebReservationStatus {
+  WEB_RESERVATION_STATUS_UNSPECIFIED = 0;
+  WEB_RESERVATION_STATUS_CREATED = 1;
+  WEB_RESERVATION_STATUS_CONFIRMED = 2;
+  WEB_RESERVATION_STATUS_READY = 3;
+  WEB_RESERVATION_STATUS_COMPLETED = 4;
+  WEB_RESERVATION_STATUS_CANCELLED = 5;
+  WEB_RESERVATION_STATUS_EXPIRED = 6;
+}
+
+enum WebOrderStatus {
+  WEB_ORDER_STATUS_UNSPECIFIED = 0;
+  WEB_ORDER_STATUS_CREATED = 1;
+  WEB_ORDER_STATUS_CONFIRMED = 2;
+  WEB_ORDER_STATUS_READY = 3;
+  WEB_ORDER_STATUS_COMPLETED = 4;
+  WEB_ORDER_STATUS_CANCELLED = 5;
+  WEB_ORDER_STATUS_EXPIRED = 6;
+}
+
+message WebReservation {
+  string id = 1;
+  string reservation_number = 2;
+  WebReservationStatus status = 3;
+
+  string product_id = 4;
+  string product_batch_id = 5;
+  string branch_id = 6;
+  optional string customer_id = 7;
+
+  optional string order_id = 8;
+
+  string product_name = 9;
+  string pharmacy_name = 10;
+
+  string customer_name = 11;
+  string phone = 12;
+  optional string comment = 13;
+  optional string city = 14;
+
+  int32 quantity = 15;
+  string unit_price = 16;
+  string total_price = 17;
+  string source = 18;
+
+  google.protobuf.Timestamp created_at = 19;
+  google.protobuf.Timestamp expires_at = 20;
+  google.protobuf.Timestamp updated_at = 21;
+}
+
+message CreateWebReservationRequest {
+  string product_id = 1;
+  string product_batch_id = 2;
+  string branch_id = 3;
+
+  optional string order_id = 4;
+
+  string product_name = 5;
+  string pharmacy_name = 6;
+
+  string customer_name = 7;
+  string phone = 8;
+  optional string comment = 9;
+  optional string city = 10;
+
+  int32 quantity = 11;
+  string unit_price = 12;
+  string total_price = 13;
+  optional string source = 14;
+}
+
+message ListWebReservationsRequest {
+  common.v1.PaginationRequest pagination = 1;
+  optional WebReservationStatus status = 2;
+  optional string branch_id = 3;
+  optional string phone = 4;
+  optional string reservation_number = 5;
+  optional string order_id = 6;
+}
+
+message ListWebReservationsResponse {
+  repeated WebReservation items = 1;
+  common.v1.PaginationMeta meta = 2;
+}
+
+message UpdateWebReservationStatusRequest {
+  string id = 1;
+  WebReservationStatus status = 2;
+}
+
+message WebOrderItem {
+  string id = 1;
+  string reservation_id = 2;
+
+  string product_id = 3;
+  string product_batch_id = 4;
+  string branch_id = 5;
+
+  string product_name = 6;
+  string pharmacy_name = 7;
+
+  int32 quantity = 8;
+  string unit_price = 9;
+  string total_price = 10;
+
+  WebReservationStatus status = 11;
+}
+
+message WebOrder {
+  string id = 1;
+  string order_number = 2;
+  WebOrderStatus status = 3;
+
+  string customer_name = 4;
+  string phone = 5;
+  optional string comment = 6;
+  optional string city = 7;
+
+  string source = 8;
+  int32 total_items = 9;
+  string total_price = 10;
+
+  google.protobuf.Timestamp created_at = 11;
+  google.protobuf.Timestamp expires_at = 12;
+  google.protobuf.Timestamp updated_at = 13;
+
+  repeated WebOrderItem items = 14;
+
+  // Buyurtma bajariladigan dorixona (bitta order = bitta filial).
+  optional string branch_id = 15;
+  optional string pharmacy_name = 16;
+
+  // Onlayn to'lov. Bo'lmasa — dorixonada naqd/karta bilan to'lanadi.
+  optional WebOrderPayment payment = 17;
+}
+
+// Buyurtmaning onlayn to'lovi (bo'lsa). To'liq tafsilot payment.v1 da —
+// bu yerda ro'yxat/kartochkada ko'rsatish uchun zarur minimum.
+message WebOrderPayment {
+  string id = 1;
+  // PENDING | HELD | PAID | CANCELLED | FAILED | REFUNDED
+  string status = 2;
+  string amount = 3;
+  optional string card_mask = 4;
+  optional google.protobuf.Timestamp paid_at = 5;
+  // Fiskal chek yuborilganmi (yuborilmagan bo'lsa — sabab `receipt_error`).
+  optional google.protobuf.Timestamp receipt_sent_at = 6;
+  optional string receipt_error = 7;
+}
+
+message GetWebOrderByNumberRequest {
+  string order_number = 1;
+}
+
+message FulfillWebOrderRequest {
+  string order_id = 1;
+  optional string cashier_id = 2;
+  string payment_method = 3; // PaymentMethod (CASH/CARD/...)
+  optional string paid_amount = 4;
+}
+
+message CreateWebOrderItem {
+  string product_id = 1;
+  string product_batch_id = 2;
+  string branch_id = 3;
+
+  string product_name = 4;
+  string pharmacy_name = 5;
+
+  int32 quantity = 6;
+  string unit_price = 7;
+  string total_price = 8;
+}
+
+message CreateWebOrderRequest {
+  string customer_name = 1;
+  string phone = 2;
+  optional string comment = 3;
+  optional string city = 4;
+  optional string source = 5;
+
+  repeated CreateWebOrderItem items = 6;
+}
+
+message ListWebOrdersRequest {
+  common.v1.PaginationRequest pagination = 1;
+  optional WebOrderStatus status = 2;
+  optional string phone = 3;
+  optional string order_number = 4;
+  optional string branch_id = 5;
+}
+
+message ListWebOrdersResponse {
+  repeated WebOrder items = 1;
+  common.v1.PaginationMeta meta = 2;
+}
+
+message UpdateWebOrderStatusRequest {
+  string id = 1;
+  WebOrderStatus status = 2;
+}
+
+service WebReservationService {
+  rpc CreateWebReservation(CreateWebReservationRequest) returns (WebReservation);
+  rpc GetWebReservation(common.v1.IdRequest) returns (WebReservation);
+  rpc ListWebReservations(ListWebReservationsRequest) returns (ListWebReservationsResponse);
+  rpc UpdateWebReservationStatus(UpdateWebReservationStatusRequest) returns (WebReservation);
+}
+
+service WebOrderService {
+  rpc CreateWebOrder(CreateWebOrderRequest) returns (WebOrder);
+  rpc GetWebOrder(common.v1.IdRequest) returns (WebOrder);
+  rpc GetWebOrderByNumber(GetWebOrderByNumberRequest) returns (WebOrder);
+  rpc ListWebOrders(ListWebOrdersRequest) returns (ListWebOrdersResponse);
+  rpc UpdateWebOrderStatus(UpdateWebOrderStatusRequest) returns (WebOrder);
+  rpc FulfillWebOrder(FulfillWebOrderRequest) returns (WebOrder);
+}