# B-06C Inquiry Product

###### tags: `biz`
> [name=RoyHuang]

------------------------------------------------------------------------
## API 清單

No | API | Desc | 執行順序 | 執行條件 | 參考
---|-----------------------------------------------------------------------------------------------|----------------------------|----------|---------------------------------------|--------------------
1 | [URI-B-06](https://hackmd.io/kN2BklaCTLihbd_X75r3tg?view#Prepare-biz-data) | Prepare biz data | 1 | page init | 無
2 | [URI-O-01](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-01-Prepare-appellation-data) | Prepare appellation data | 1 | page init | URI-054，需擴充
3 | [URI-O-02](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-02-Prepare-quantity-unit-data) | Prepare quantity unit data | 1 | page init | URI-054，需擴充
4 | [URI-O-03](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-03-Prepare-country-data) | Prepare country data | 1 | page init | URI-054，需擴充，欄位多加上國碼
5 | [URI-O-04](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-04-Prepare-state-data) | Prepare state data | None | when change coutnry list | URI-054
6 | [URI-O-05](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-05-Prepare-template-data) | Prepare template data | 1 | page init(offer to sell 不使用) | 無
7 | [URI-O-06](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-06-file-upload) | file upload | None | when submit and upload file have data | 無
8 | [URI-O-07](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-07-Prepare-password-rule-data) | Prepare password rule data | 1 | only 新會員，page init when no login | 無
9 | [URI-O-08](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-08-Check-password-rule) | Check password rule | None | only 新會員，when check | 無
10 | [URI-O-09](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-09-Check-email) | Check email | None | only 新會員，when check | URI-G-01
11 | [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data) | Prepare login data | None | when login | 無
12 | [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business) | add business | None | when submit | 無
13 | [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag) | Prepare language label tag | 1 | page init | URI-A-02
14 | [URI-O-21](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-21-Get-file-data-by-id) | Get file data by id | None | when login | 無

------------------------------------------------------------------------
## 原頁面網址
- https://www.ttstaging.com.tw/product/1896775
- 在 product CP 下商機，沒有獨立頁面

- 相關程式
- front
- com.hyweb.tt.cms.front.rest.ContactSupplierResource.java
- adm
- com.hyweb.tt.cms.cm.webservice.BizEnhanceWebservice.java

## 原頁面 URL 解析
- product CP URL
- https://www.ttstaging.com.tw/product/{productId}
- https://www.ttstaging.com.tw/product/{productName}-{productId}.html

No | Parameter | Type | Desc
---|-------------|--------|-----
1 | productId | int | 型錄id
2 | productName | string | 型錄名稱

------------------------------------------------------------------------
## 頁面解說
### 頁面區塊說明
以區塊方式說明使用到的 API

#### 登入

- B-06-01

No | API | Desc
---|-----------------------------------------------------------------------------------------------|---------------------------
1 | [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag) | Prepare language label tag

------------------------------------------------------------------------

- B-06-02

No | API | Desc
---|----------------------------------------------------------------------------|-----------------
1 | [URI-B-06](https://hackmd.io/kN2BklaCTLihbd_X75r3tg?view#Prepare-biz-data) | Prepare biz data

- B-06-03

No | API | Desc
---|----------------------------------------------------------------------------|-----------------
1 | [URI-B-06](https://hackmd.io/kN2BklaCTLihbd_X75r3tg?view#Prepare-biz-data) | Prepare biz data

- B-06-04

No | API | Desc
---|-----------------------------------------------------------------------------------------------|---------------------------
1 | [URI-O-02](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-02-Prepare-quantity-unit-data) | Prepare quantity unit data
2 | [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag) | Prepare language label tag

- B-06-05

No | API | Desc
---|-----------------------------------------------------------------------------------------------|---------------------------
1 | [URI-O-05](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-05-Prepare-template-data) | Prepare template data
2 | [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag) | Prepare language label tag

- B-06-06

No | API | Desc
---|-----------------------------------------------------------------------------------------------|---------------------------
1 | [URI-O-21](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-21-Get-file-data-by-id) | Get file data by id
2 | [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag) | Prepare language label tag

------------------------------------------------------------------------

- B-06-07

No | API | Desc
---|-----------------------------------------------------------------------------------------------|---------------------------
1 | [URI-O-01](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-01-Prepare-appellation-data) | Prepare appellation data
2 | [URI-O-03](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-03-Prepare-country-data) | Prepare country data
3 | [URI-O-04](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-04-Prepare-state-data) | Prepare state data
4 | [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data) | Prepare login data
5 | [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag) | Prepare language label tag

------------------------------------------------------------------------

- B-06-08

No | API | Desc
---|-----------------------------------------------------------------------------------------------|---------------------------
1 | [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data) | Prepare login data
2 | [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag) | Prepare language label tag

- B-06-09

No | API | Desc
---|-----------------------------------------------------------------------------------------------|---------------------------
1 | [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag) | Prepare language label tag

- B-06-10
無

- B-06-11

No | API | Desc
---|-----------------------------------------------------------------------------------------------|---------------------------
1 | [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business) | add business
2 | [URI-O-06](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-06-file-upload) | file upload
3 | [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag) | Prepare language label tag

#### 註冊
登入與註冊差別在於 Contact Information 顯示不同，其餘區塊皆同
- B-06-12

No | API | Desc
---|-----------------------------------------------------------------------------------------------|---------------------------
1 | [URI-O-01](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-01-Prepare-appellation-data) | Prepare appellation data
2 | [URI-O-03](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-03-Prepare-country-data) | Prepare country data
3 | [URI-O-04](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-04-Prepare-state-data) | Prepare state data
4 | [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data) | Prepare login data
5 | [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag) | Prepare language label tag
6 | [URI-O-07](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-07-Prepare-password-rule-data) | Prepare password rule data
7 | [URI-O-08](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-08-Check-password-rule) | Check password rule
8 | [URI-O-09](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-09-Check-email) | Check email

#### 未登入
- 與登入、註冊差別在於無 Contact Information

------------------------------------------------------------------------
### 頁面欄位說明

- 登入


- 註冊
- 以下只列出與登出差異部分


#### 藍1
Step 1 Fill in the form
- UI 邏輯: 下商機的頁面，文字需要 highlight
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  ez_step1 + fillintheform

#### 藍2
Step 2 Completion
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  ez_step2 + completion

#### 藍3
Mrs.李*** , HYWEB TECHNOLOGY CO., LTD.
- UI 邏輯: 聯絡人稱呼 + 英文逗號 + 聯絡人名稱
- 資料來源
- API： [URI-B-06](https://hackmd.io/kN2BklaCTLihbd_X75r3tg?view#Prepare-biz-data)

  contactTitleName + contactName + ',' + companyName

#### 藍4
型錄圖片
- 圖片尺寸: 100 x 100
- alt: 型錄圖片說明
- 資料來源
- API： [URI-B-06](https://hackmd.io/kN2BklaCTLihbd_X75r3tg?view#Prepare-biz-data)

  -- 型錄圖片
  productImgUrl

  -- alt
  productImgDesc

#### 藍5
型錄名稱
- UI 邏輯: click 要連結至 product cp url
- 資料來源
- API： [URI-B-06](https://hackmd.io/kN2BklaCTLihbd_X75r3tg?view#Prepare-biz-data)

  -- 型錄圖片
  productName
  
  -- product cp url
  productCpUrl

#### 藍6
Quantity
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  ez_quantity + ":"

#### 藍7
Quantity - field
- UI 邏輯
- require: N
- HTML field: number
- 預設是 null。若有填寫，至少 1，至多 999999999
- 整數
- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: N
- type: number(整數)

  quantity

#### 藍8
『-』
- UI 邏輯:
- click，Quantity 數量會減 1，至少為 1

#### 藍9
『+』
- UI 邏輯:
- click，Quantity 數量會加 1，至多為 999999999

#### 藍10
數量單位下拉列表
- UI 邏輯:
- require: N
- HTML field: select
- 預設是給第一個順位
- 資料來源
- API: [URI-O-02](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-02-Prepare-quantity-unit-data)

  -- Array(Object)
  label

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: N
- type: number(整數)

  quantity

#### 藍11
Estimated Purchase Amount USD
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  estimatedannualpurchases + ":"

#### 藍12
USD
- UI 邏輯: 寫死

#### 藍13
Estimated Purchase Amount USD - field
- UI 邏輯:
- require: N
- HTML field: number
- 預設是 null。若有填寫，至少 0，至多 999999999
- 整數、浮點數
- 原規則小數點沒限制位數，全依照瀏覽器支援程度而定
- 補：`input type="number"` 並非每一家瀏覽器都有實作，無實作會造成無法再欄位中輸入的動作，只能點選上下按鈕增加數字。(Safari 不支援)
- 新增商機
- API： [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: N
- type: number(整數、浮點數)

  purchaseAmount

#### 藍14
Message
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  message

#### 藍15
Insert a template
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  insertatemplate + ":"

#### 藍16
訊息範本
- UI 邏輯:
- click，會重游標所在新增此範本內容
- unclick，會移除掉最後一組此範本內容
- 資料來源
- API： [URI-O-05](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-05-Prepare-template-data)

  -- Array(Object)
  data

#### 藍17
Message - field
- UI 邏輯:
- require: Y
- HTML field: textarea
- 至多 1500 個字，超過不能填
- DB: CLOB
- 資料來源，預設值
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  businessmessagetextboxdefault

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: string

  message

#### 藍18
計算 Message 字數，0/1500
- UI 邏輯:
- 0，是動態計算，以字數計算
- 1500，是最大字數，寫死
- 數字超過移除，不顯示

#### 藍19
上傳附件
- UI 邏輯:
- require: N
- HTML field: file
- 使用套件: dropzone.js
- 檔案數量: 0 ~ 3個
- 檔案格式: htm, html, doc, docx, pdf, txt, jpg, gif, png, odt, ods
- 檔案容量: 10 MB
- click
- 有 privew 檔案功能。若有圖檔要顯示圖
- 滑鼠移標到檔案時，要顯示檔案名稱
- 需要有移除檔案功能，右上角有個『x』可移除
- ~~只有在 submit 送出時，才會上傳檔案至系統~~
- 直接上傳，目前先放入暫存檔案
- 新增附件
- API: [URI-O-06](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-06-file-upload)
- require: N
- type: file

  message

- 登入後，取得附件資料
- API: [URI-O-21](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-21-Get-file-data-by-id)
- require: 看有檔案id，才處理
- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: N
- type: string
- 商機附件id(至多3個，用逗號區隔)，Ex: `1,2,3`

  attachs

#### 藍20
Drop files here to upload
- UI 邏輯:
- dropzone.js 預設文字

#### 藍21
File formats
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  fileuploadlimit

#### 藍22
: htm, html, doc, docx, pdf, txt, jpg, gif, png, odt, ods. Max 3 files (10MB in total).
- 『: htm, html, doc, docx, pdf, txt, jpg, gif, png, odt, ods.』，寫死
- 『 (10MB in total).』
- 資料來源
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

      maxfileslimit

#### 藍23
Total size
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  totalsizet

#### 藍24
計算檔案大小
- UI 邏輯:
- 預設 0
- 以 MB 為單位計算

#### 藍25
Contact Information
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  contactinformation

#### 藍26
View and Modify、Collapse
- UI 邏輯
- HTML field: button
- 只有登入時會顯示
- 預設是合
- 合，顯示 View and Modify
- Full Name 下面那行都隱藏
- 開，顯示 Collapse
- View and Modify
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

    多語：viewandmodify

- Collapse
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

    collapse

#### 藍27
Email
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  email

#### 藍28
登入者 email - field
- UI 邏輯:
- require: Y
- HTML field: text
- 登入時，屬性為 readonly
- 註冊時，需檢查是否已存在
- DB: VARCHAR2(100 BYTE)
- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)

  data.userEmail

- 註冊時，需檢查是否已存在
- API: [URI-O-09](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-09-Check-email)
- 且需要驗證是否為合法的 email

  ok: code >= 0 
  error: code < 0

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: string

  quantity

#### 藍29
Full Name
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  fullname

#### 藍30
登入者稱謂 - field
- UI 邏輯
- require: Y
- HTML field: select
- 下拉選單可選擇稱呼列表，如沒資料預設給下第一個順位
- 登入時，會顯示此使用者的稱謂
- 資料來源，下拉選單
- API： [URI-O-01](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-01-Prepare-appellation-data)

  -- Array(Object)
  label

- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: number
- 用登入者稱謂id 比對下拉選單，有則選擇，無則給預設下拉選單第一個順位

  data.userTitleCode

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: string

  userTitleCode

#### 藍31 - field
登入者名稱
- require: Y
- HTML field: text
- 登入時，會顯示此使用者名稱
- DB: VARCHAR2(160 BYTE)
- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: string

  data.userName

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: string

  userName

#### 藍32
Company Name
- 資料來源
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  companyname

#### 藍33
Company Name - field
- UI 邏輯
- require: Y
- HTML field: text
- 登入時，會顯示公司名稱
- 若公司名稱是『individual buyer』，則藍34需打勾，且欄位會 readonly
- DB: VARCHAR2(250 BYTE)
- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: string

  data.companyName

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: string

  companyName

#### 藍34
『I'm an individual buyer』- field
- UI 邏輯
- require: Y
- HTML type: checkbox(單選)
- 預設是 unclick
- click，則此藍33 的值會改成『individual buyer』，且欄位會 readonly
- unclick，則此藍33 的值會清空，且移除 readonly

#### 藍35
I'm an individual buyer
- 資料來源
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  individualbuyer

#### 藍36
Country/Region
- 資料來源
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  countryregion

#### 藍37
Country/Region(公司所屬的國家) - field
- UI 邏輯
- require: Y
- HTML field: select
- 下拉選單可選擇國家列表，如沒資料預設給第一個順位
- 第一個選單是多語標籤 Select
- 若有異動下拉選單，
- (1) 連動 藍43 去撈取國家的州別清單資料
- (2) 將國碼寫入 藍49、藍53
- 登入會顯示此公司所屬的國家
- 移除 UI 邏輯
- 若是 註冊會員時，點選『台灣』
- 『submit』按鈕會 disabled，無法送出表單。只有非台灣的註冊會員可註冊並新增商機
- 下方會多出文字訊息
- For companies in Taiwan, please click here to register as member.
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

          registerintaiwan

- 請由此註冊成會員
- 寫死
- 點選會連結至 中文網註冊頁面(${中文網URL}/register/supplier)

- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  ez_pleaseselect

- 資料來源，下拉選單
- API： [URI-O-03](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-03-Prepare-country-data)

  -- Array(Object)
  label

- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: number
- 用公司所屬的國家id 比對下拉選單，有則選擇，無則給預設下拉選單第一個順位

  data.officeNationCode

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: string

  officeNationCode

#### 藍38
State/Province/City
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  stateprovincecity

#### <div style="color:red">藍39、藍40</div>
- 此二欄位是二擇一，必填

#### 藍39
State/Province/City(公司所屬的州別) - field
- UI 邏輯
- require: Y
- HTML field: select
- 下拉選單可選擇此國家的州別列表，如沒資料預設給第一個順位
- 第一個選單是多語標籤 Select
- 登入會顯示此公司所屬的州別
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  ez_pleaseselect

- 資料來源，下拉選單
- API： [URI-054](https://docs.google.com/spreadsheets/d/1I4Zbb8aJw4Ndt-e6Pw3pdBtQMZg1DNlHsRvg7YogstU/edit#gid=0)

  -- Array(Object)
  label

- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: number
- 用公司所屬的州別id 比對下拉選單，有則選擇，無則給預設下拉選單第一個順位

  data.officeStateCode

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: string

  officeStateCode

#### 藍40
Other State/Province/City
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  otherstateprovincecity

#### 藍41
Other State/Province/City(其他州別) - field
- UI 邏輯
- require: Y
- HTML field: text
- DB: VARCHAR2(100 BYTE)
- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: string

  data.officeOtherState

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: string

  officeOtherState

#### 藍42
Company Address
- API： [URI-O-03](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-03-Prepare-country-data)

  companyaddress

#### 藍43
Company Address(公司地址) - field
- UI 邏輯
- 必填
- HTML field: text
- 登入時，會顯示公司地址
- DB: VARCHAR2(255 BYTE)
- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: string

  officeAddredd

#### 藍44
Company Site
- 資料來源，多語標籤
- API： [URI-O-03](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-03-Prepare-country-data)

  companysite

#### 藍45
Company Site(公司網址) - field
- UI 邏輯
- require: Y
- HTML field: `url`
- placeholder: `http://`
- 登入時，會顯示公司網址
- 若公司名稱是『Not Available』，則藍46需打勾，且欄位會 readonly
- DB: VARCHAR2(500 BYTE)
- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: string

  data.officeAddress

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: string
- 需要驗證是否為合法的 url
- `https://` 或 `http://` 開頭即可
- jquery validator 會實作驗證 url rule，[參考](https://www.runoob.com/jquery/jquery-plugin-validate.html)

  officeAddredd

#### 藍46
『Not Available』- field
- UI 邏輯
- require: Y
- HTML field: checkbox(單選)
- 預設是 unclick
- click，則此藍45 的值會改成『Not Available』，且欄位會 readonly
- unclick，則此藍345 的值會清空，且移除 readonly

#### 藍47
Not Available
- 資料來源
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  notavailable

#### 藍48
Business Phone Number
- 資料來源
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  tel1

#### 藍49
Business Phone Number(公司電話 - 國碼) - field
- UI 邏輯
- require: N
- HTML field: text
- 登入時，會顯示公司電話 - 國碼
- 至多 3 碼
- DB: VARCHAR2(3 BYTE)
- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: string

  data.officeTelCountry

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: N
- type: string
- 需驗證字串為 0-9 的數字

  officeTelCountryCode

#### 藍50
Business Phone Number(公司電話) - field
- UI 邏輯
- require: N
- HTML field: text
- 登入時，會顯示公司電話
- 至多 20 碼
- DB: VARCHAR2(20 BYTE)
- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: string

  data.officeTel

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: N
- type: string
- 需驗證字串為 0-9 的數字

  officeTel

#### 藍51
Business Phone Number(公司電話 - 分機) - field
- UI 邏輯
- require: N
- HTML field: text
- 登入時，會顯示公司電話 - 分機
- 至多 10 碼
- DB: VARCHAR2(10 BYTE)
- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: string

  data.officeTelExt

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: N
- type: string
- 需驗證字串為 0-9 的數字

  officeTelExt

#### 藍52
Mobile Phone Number
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  mobilephone

#### 藍53
Mobile Phone Number(聯絡人手機 - 國碼) - field
- UI 邏輯
- require: N
- HTML field: text
- 登入時，會顯示聯絡人手機 - 國碼
- 至多 3 碼
- DB: VARCHAR2(3 BYTE)
- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: string

  data.userMobileCountry

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: N
- type: string
- 需驗證字串為 0-9 的數字

  mobileCountry

#### 藍54
Mobile Phone Number(聯絡人手機) - field
- UI 邏輯
- require: N
- HTML field: text
- 登入時，會顯示聯絡人手機
- DB: VARCHAR2(17 BYTE)
- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: string

  data.userMobile

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: N
- type: string
- 需驗證字串為 0-9 的數字

  mobile

#### 藍55
Changes will be automatically saved to your profile.
- 只有登入時顯示
- 資料來源
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  changeswillbeautomaticallysaved

#### 藍56
『Recommend other suppliers if this supplier doesn't reply.』- field
- UI 邏輯
- require: Y
- HTML field: checkbox(單選)
- 預設是 click
- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: boolean
- 若 checkbox 是 click，則為 true；反之，為 false

  recommendMatch

#### 藍57
Recommend other suppliers if this supplier doesn't reply.
- 資料來源
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  recommendmatchingsupplier

#### 藍58
『I'd like to show my email address to the suppliers I contact on Taiwantrade.com.』(TT聯繫的供應商，顯示我的email)- field
- UI 邏輯
- require: Y
- HTML field: checkbox(單選)
- 登入時，若使用者公司已勾選，則不顯示
- 資料來源，登入
- API: [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data)
- type: number
- 若 showBizEmailStatus == 1 則不顯示；反之，則顯示

  -- 1:開放、0:關閉、-1:未設定
  data.showBizEmailStatus

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: boolean
- 若 checkbox 是 click，則為 true；反之，為 false

  showBizEmail

#### 藍59
I'd like to show my email address to the suppliers I contact on Taiwantrade.com.
- 登入時，若使用者公司已勾選，則不顯示，參考 藍58 登入
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  idontlikeshowmyemail

#### 藍60
『I'd like to show my email address to the suppliers I contact on Taiwantrade.com.』的Tip
- click ，顯示燈箱，內容是多語
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  bytickingthisbox


#### 藍61
Keywords of products you are looking for
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  keywordsofproducts

#### 藍62
商機 keyword
- UI 邏輯
- require: N
- 1) HTML field: display data tag(by 設計師)
- placeholder: `new Keyword`
- ui 效果是設計師實作
- 可新增、移除
- 可設定 0 ~ n 組
- 2) HTML field: hidden
- 多組用逗號區隔
- DB: VARCHAR2(500 BYTE)，每一組為一筆record
- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: string
- 多則用逗號區隔，EX: `car,house,water`

  keywords

#### 藍63
- This helps to more precisely match your inquiry with potential suppliers.Use "," or "enter" to separate multiple keywords.
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  thishelpstomorepreciselymatch + useorentertoseparatemultiplekeywords

#### 藍64
google recaptcha
- UI 邏輯
- require: Y
- 目前使用 V2
- 需驗證合法性
- google key 放在 front(server)

#### 藍65
Submit
- UI 邏輯
- HTML field: : button
- 若未登入前，click 會顯示燈箱
- click 『Sign In』，會連結至 SSO 登入網站，登入後會導回此頁面
- click 『Create an account free』，會關閉燈箱，並顯示 Contact Information 區塊
- 登入後，可送出表單
- 表單驗證規則
- 必填欄位驗證
- google recaptcha 驗證
- 會先送出上傳檔案，回傳拿到上傳檔案id 後，才新增商機
- 商機新增成功後，會連結至商機成功頁面
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  ok

- 新增附件
- API: [URI-O-06](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-06-file-upload)
- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)

#### 藍101
Your email will be your Taiwantrade.com login.
- 只有註冊時顯示
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  suggestenterofficeemail

#### 藍102
Create Password
- 只有註冊時顯示
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  createapassword

#### 藍103
Password - field
- 只有註冊時顯示
- UI 邏輯
- require: Y
- HTML field: password
- 需檢查是否為合法的密碼
- DB: VARCHAR2(64 BYTE)
- 驗證密碼規則
- API: [URI-O-08](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-08-Check-password-rule)

  ok: code >= 0 
  error: code < 0

- 新增商機
- API: [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business)
- require: Y
- type: string

  userPassword

#### 藍104
密碼規則提示文字
- 只有註冊時顯示
- 資料來源，密碼規則
- API: [URI-O-07](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-07-Prepare-password-rule-data)
- type: string

#### 藍105
Confirm Password
- 只有註冊時顯示
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  confirmpassword

#### 藍106
Confirm Password - field
- 只有註冊時顯示
- UI 邏輯:
- require: Y
- HTML field: password
- 需檢查字串與 藍103 相同

#### 藍107
『I accept the Taiwantrade.com Membership Agreement, Terms of Use and Privacy Policy』(是否同意 TT Policy) - field
- 只有註冊時顯示
- UI 邏輯:
- require: Y
- field: checkbox(單選)
- 預設 unclick
- 必須勾選才合法

#### 藍108
I accept the Taiwantrade.com Membership Agreement, Terms of Use and Privacy Policy
- 只有註冊時顯示

- 『I accept the』
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  iacceptthe

- 『Taiwantrade.com Membership Agreement』
- click，需連結至 https://www.taiwantrade.com/mp/help#2
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  taiwantradecommembershipagreement

- 『,』
- 寫死逗號
- 『TTerms of Use』
- click，需連結至 https://www.taiwantrade.com/mp/help#3
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  termsofuse

- 『and』
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  and

- 『Privacy Policy』
- click，需連結至 https://www.taiwantrade.com/mp/help#4
- 資料來源，多語標籤
- API： [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag)

  privacypolicy

------------------------------------------------------------------------
### 頁面邏輯說明
- 下商機身份
- 新會員: 下商機時同時註冊
- 已知會員
- TT 會員
- 第三方註冊的會員
- 新會員和已知會員表單，差異:
- 新增: 密碼、密碼確認、接受 policy
- 移除: Contact Information 收合、藍55說明

- 登入前後差異
- 登入前，Contact Information 區塊不顯示
- 登入後，要保留登入前輸入欄位，除了上傳檔案外

- 商機成功會導入商機成功頁面

- 流程
- 未登入

graph TB;
  id1("未登入") --> id2("submit");
  id2 --> id3{"檢查是否<br>登入"};
  id3 --> id4("Sign In"); 
  id3 --> id5("Create an account free"); 
  id4 --> id6("submit");
  id5 --> id6("新增附件");
  id6 --> id7("新增商機");
  id7 --> id8("商機成功頁");

- 登入

graph LR;
  id1("登入") --> id2("submit");
  id2 --> id3("新增附件");
  id3 --> id4("新增商機");
  id4 --> id5("商機成功頁");

------------------------------------------------------------------------
### 頁面輸出

- 登入

No | API | Desc
---|-----------------------------------------------------------------------------------------------|---------------------------
1 | [URI-B-06](https://hackmd.io/kN2BklaCTLihbd_X75r3tg?view#Prepare-biz-data) | Prepare biz data
2 | [URI-O-01](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-01-Prepare-appellation-data) | Prepare appellation data
3 | [URI-O-02](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-02-Prepare-quantity-unit-data) | Prepare quantity unit data
4 | [URI-O-03](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-03-Prepare-country-data) | Prepare country data
5 | [URI-O-05](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-05-Prepare-template-data) | Prepare template data
6 | [URI-O-10](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-10-Prepare-login-data) | Prepare login data
7 | [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag) | Prepare language label tag
8 | [URI-O-21](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-21-Get-file-data-by-id) | Get file data by id

------------------------------------------------------------------------
- 註冊

No | API | Desc
---|-----------------------------------------------------------------------------------------------|---------------------------
1 | [URI-B-06](https://hackmd.io/kN2BklaCTLihbd_X75r3tg?view#Prepare-biz-data) | Prepare biz data
2 | [URI-O-01](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-01-Prepare-appellation-data) | Prepare appellation data
3 | [URI-O-02](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-02-Prepare-quantity-unit-data) | Prepare quantity unit data
4 | [URI-O-03](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-03-Prepare-country-data) | Prepare country data
5 | [URI-O-05](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-05-Prepare-template-data) | Prepare template data
6 | [URI-O-07](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-07-Prepare-password-rule-data) | Prepare password rule data
7 | [URI-O-17](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-17-Prepare-language-label-tag) | Prepare language label tag
8 | [URI-O-21](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-21-Get-file-data-by-id) | Get file data by id

------------------------------------------------------------------------
- 州別列表

No | API | Desc
---|---------------------------------------------------------------------------------------|-------------------
1 | [URI-O-04](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-04-Prepare-state-data) | Prepare state data

------------------------------------------------------------------------
- email驗證

No | API | Desc
---|--------------------------------------------------------------------------------|------------
1 | [URI-O-09](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-09-Check-email) | Check email

------------------------------------------------------------------------
- 密碼驗證

No | API | Desc
---|----------------------------------------------------------------------------------------|--------------------
1 | [URI-O-08](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-08-Check-password-rule) | Check password rule

------------------------------------------------------------------------
- file upload

No | API | Desc
---|--------------------------------------------------------------------------------|------------
1 | [URI-O-06](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-06-file-upload) | file upload

------------------------------------------------------------------------
- add business

No | API | Desc
---|---------------------------------------------------------------------------------|-------------
1 | [URI-O-11](https://hackmd.io/cCmvIP36SCyTsLbZCPrbhg?view#URI-O-11-add-business) | add business