添加接口描述 sql

houxiao

2017-03-15 eb7979921b7c5033cebc031365c56267fce60155

 VisitFace/document/erdb api½Ó¿ÚÃèÊö.txt

@@ -44,17 +44,17 @@


enum ImageTypeID

{

   Face1 = 1,  // æ­£é¢ç…§ç‰‡1

   Face2 = 2,  // æ­£é¢ç…§ç‰‡2

   FaceLSide = 2,  // ï¼ˆä¸»ä½“观察，<=45度）左侧脸照片

   FaceRSide = 3,  // ï¼ˆä¸»ä½“观察，<=45度）右侧脸照片

   FaceTSide = 4,  // ï¼ˆä¸»ä½“观察，<=45度）顶侧脸照片

   FaceBSide = 5,  // ï¼ˆä¸»ä½“观察，<=45度）底侧脸照片

   FaceUploaded = 2, // ä¸Šä¼ ç…§ç‰‡

   Icon, // å›¾æ ‡

   IdentificationCard, // èº«ä»½è¯ç…§ç‰‡

   BusinessCard, // åç‰‡ç…§ç‰‡

   OtherCard,

   Face1 = 1,  // æ­£é¢ç…§ç‰‡1（存放到EmployeeFace/VisitFace表）

   Face2 = 2,  // æ­£é¢ç…§ç‰‡2（存放到EmployeeFace/VisitFace表）

   FaceLSide,  // ï¼ˆä¸»ä½“观察，<=45度）左侧脸照片（存放到EmployeeFace/VisitFace表）

   FaceRSide,  // ï¼ˆä¸»ä½“观察，<=45度）右侧脸照片（存放到EmployeeFace/VisitFace表）

   FaceTSide,  // ï¼ˆä¸»ä½“观察，<=45度）顶侧脸照片（存放到EmployeeFace/VisitFace表）

   FaceBSide,  // ï¼ˆä¸»ä½“观察，<=45度）底侧脸照片（存放到EmployeeFace/VisitFace表）

   FaceUploaded, // ä¸Šä¼ ç…§ç‰‡ï¼ˆå­˜æ”¾åˆ°EmployeeFace/VisitFace表）

   Icon, // å›¾æ ‡ï¼ˆå­˜æ”¾åˆ°Image表）

   IdentificationCard, // èº«ä»½è¯ç…§ç‰‡ï¼ˆå­˜æ”¾åˆ°Image表）

   BusinessCard, // åç‰‡ç…§ç‰‡ï¼ˆå­˜æ”¾åˆ°Image表）

   OtherCard, // å…¶ä»–证件（存放到Image表）

}



1.2. StatusID

@@ -241,7 +241,6 @@
   name : "",

   companyName : "",

   // ...

   imgIdentity : "image base64"

}

Response:

{

@@ -249,24 +248,35 @@
   personID : 123

}



2.4. æ³¨å†Œäººè„¸

a) find by name, (IdentityTypeID, identity), phone ... from Person

b) if Person exists return error

c) else insert into Person

d) companyID = (select * from or insert Company where name = "$companyName")



2.4. æ³¨å†Œè®¿å®¢äººè„¸(visit face register)

Request:

{

   registerCompanyID : 123,

   personID : 123,

   imgs : [ "image base64" ] // å¯¹åº”一个人的若干个人脸图像

   imgs : { ImageTypeID : "image base64" } // å¯¹åº”一个人的若干个人脸图像

}

Response:

{

   faceIDs : [ 123 ]

}



a)select exists(*) from person where id="$personID"

b)if not exists return error

c)保存imgIdentity/Icon等到文件存储，并插入Image表；保存人脸图到VisitFace，VisitFace.imagePath = ä¿å­˜imgs到文件存储

d)调用人脸识别服务[faceids]=(registerCompanyID, dbid=0, img)

e)对于每一个faceid，insert into VisitFace ("$FaceID", $PersonID, "$VisitFace.imagePath")



3. æ¥è®¿ç™»è®°

3.1. èŽ·å¾—来访人员列表

返回按姓名缩写升序的结果

Request:

{

   companyID : 123, // è®¾å¤‡æ‰€åœ¨å­¦æ ¡ID

   companyID : 123, // è®¾å¤‡æ‰€åœ¨å­¦æ ¡ID，0表示所有公司，仅供管理接口使用

   beginPage : 0,

   endPage : 0

}

@@ -274,10 +284,19 @@
[

   {

      personID : 123,

      RegisterCompanyID : 123,

      name : "aaa",

      img : "image url" // éžå­—符串表示使用默认图标

   }

]



set @companyID =1;

select vs.person_id, vs.register_company_id, pe.name, img.image_type, img.image_path

  from visit_stat vs join person pe

  on (@companyID=0 or vs.register_company_id = @companyID) and (vs.person_id = pe.id)

  left outer join Image img

  on (pe.id = img.person_id and img.image_type=8) -- icon

  limit ...



3.2. èŽ·å¾—被访人员列表

返回按姓名缩写升序的结果

@@ -343,6 +362,8 @@
Response:

成功/错误结果



insert or update VisitStat



3.5. èŽ·å¾—拜访事由选项列表

Request:

{