Update README.md

README.md

@@ -1,6 +1,6 @@
 # id-validator
 
-> 介绍
+> **中华人民共和国居民身份证**、**中华人民共和国港澳居民居住证**以及**中华人民共和国台湾居民居住证**号码验证工具。
 
 ![Tests](https://github.com/guanguans/id-validator/workflows/Tests/badge.svg)
 ![Check & fix styling](https://github.com/guanguans/id-validator/workflows/Check%20&%20fix%20styling/badge.svg)
@@ -11,16 +11,68 @@
 
 ## Requirement
 
-* Go >= 1.6
+* Go >= 1.11
 
 ## Installation
 
 ``` shell script
-$ go get ...
+$ go get -u github.com/guanguans/id-validator
 ```
 
 ## Usage
 
+``` go
+package main
+
+import (
+	"github.com/guanguans/id-validator"
+
+	"gopkg.in/ffmt.v1"
+)
+
+func main() {
+
+	// 验证身份证号合法性
+	ffmt.P(idvalidator.IsValid("440308199901101512"))  // 大陆居民身份证18位
+	ffmt.P(idvalidator.IsValid("610104620927690"))     // 大陆居民身份证15位
+	ffmt.P(idvalidator.IsValid("810000199408230021"))  // 港澳居民居住证18位
+	ffmt.P(idvalidator.IsValid("830000199201300022"))  // 台湾居民居住证18位
+
+	// 获取身份证号信息
+	ffmt.P(idvalidator.GetInfo("440308199901101512"))
+	// []interface {}[
+	// 	github.com/guanguans/id-validator.IdInfo{          // 身份证号信息
+	// 		AddressCode: int(440308)                           // 地址码
+	// 		Abandoned:   int(0)                                // 地址码是否废弃：1为废弃的，0为正在使用的
+	// 		Address:     string("广东省深圳市盐田区")             // 地址
+	// 		AddressTree: []string[                             // 省市区三级列表
+	//			string("广东省")                                    // 省
+	//			string("深圳市")                                    // 市
+	//			string("盐田区")                                    // 区
+	//		]
+	// 		Birthday:      <1999-01-10 00:00:00 +0000 UTC>     // 出生日期
+	// 		Constellation: string("摩羯座")                     // 星座
+	// 		ChineseZodiac: string("卯兔")                       // 生肖
+	// 		Sex:           int(1)                              // 性别：1为男性，0为女性
+	// 		Length:        int(18)                             // 号码长度
+	// 		CheckBit:      string("2")                         // 校验码
+	// 	}
+	// 	<nil>                                              // 错误信息
+	// ]
+
+	// 生成可通过校验的假身份证号
+	ffmt.P(idvalidator.FakeId()) // 随机生成
+	ffmt.P(idvalidator.FakeRequireId(true, "江苏省", "200001", 1)) // 生成出生于2000年1月江苏省的男性居民身份证
+
+	// 15位号码升级为18位
+	ffmt.P(idvalidator.UpgradeId("610104620927690"))
+	// []interface {}[
+	// 	string("610104196209276908") // 升级后号码
+	// 	<nil>                        // 错误信息
+	// ]
+}
+```
+
 ## Testing
 
 ``` bash
@@ -44,6 +96,21 @@ Please review [our security policy](../../security/policy) on how to report secu
 * [guanguans](https://github.com/guanguans)
 * [All Contributors](../../contributors)
 
+## 相关项目
+
+* [PHP 版本](https://github.com/jxlwqq/id-validator)
+* [Python 版本](https://github.com/jxlwqq/id-validator.py)
+* [Ruby 版本](https://github.com/renyijiu/id_validator)
+* [JavaScript 版本](https://github.com/mc-zone/IDValidator)
+
+## 参考资料
+
+* [中华人民共和国公民身份号码](https://zh.wikipedia.org/wiki/中华人民共和国公民身份号码)
+* [中华人民共和国民政部：行政区划代码](http://www.mca.gov.cn/article/sj/xzqh/)
+* [中华人民共和国行政区划代码历史数据集](https://github.com/jxlwqq/address-code-of-china)
+* [国务院办公厅关于印发《港澳台居民居住证申领发放办法》的通知](http://www.gov.cn/zhengce/content/2018-08/19/content_5314865.htm)
+* [港澳台居民居住证](https://zh.wikipedia.org/wiki/港澳台居民居住证)
+
 ## License
 
 The MIT License (MIT). Please see [License File](LICENSE) for more information.

id_validator.go

@@ -19,7 +19,7 @@ type IdInfo struct {
 	ChineseZodiac string
 	Sex           int
 	Length        int
-	CheckBit      int
+	CheckBit      string
 }
 
 // 验证身份证号合法性
@@ -79,9 +79,6 @@ func GetInfo(id string) (IdInfo, error) {
 	// 长度
 	length, _ := strconv.Atoi(code["type"])
 
-	// Bit码
-	checkBit, _ := strconv.Atoi(code["checkBit"])
-
 	return IdInfo{
 		AddressCode:   addressCode,
 		Abandoned:     abandoned,
@@ -92,7 +89,7 @@ func GetInfo(id string) (IdInfo, error) {
 		ChineseZodiac: GetChineseZodiac(code["birthdayCode"]),
 		Sex:           sex,
 		Length:        length,
-		CheckBit:      checkBit,
+		CheckBit:      code["checkBit"],
 	}, nil
 }
 
@@ -102,6 +99,10 @@ func FakeId() string {
 }
 
 // 按要求生成假身份证号码
+// isEighteen 是否生成18位号码
+// address    省市县三级地区官方全称：如`北京市`、`台湾省`、`香港特别行政区`、`深圳市`、`黄浦区`
+// birthday   出生日期：如 `2000`、`198801`、`19990101`
+// sex        性别：1为男性，0为女性
 func FakeRequireId(isEighteen bool, address string, birthday string, sex int) string {
 	// 生成地址码
 	addressCode := GeneratorAddressCode(address)