data_stream/organ/hongkong_company_spider.md

+# **基本信息**
+```buildoutcfg
+香港企业补充
+```
+
+
+## 数据名称（中文）
+<!-- 该项数据的中文标准名称，后续沟通交流使用的规范名称，如：工商公示股东信息、失信被执行人、一般纳税人等-->
+### 
+```buildoutcfg
+香港企业
+```
+
+## 数据英文名称
+<!--英文名称，后续流程中所有涉及到英文名称均以此为准，如：partner、shixin、general_taxpayer等-->
+```text
+enterprise_hk
+```
+
+## 采集网站（采集入口）
+<!--采集的入口地址，不能只是一个网站域名，具体到该网站的数据入口-->
+```buildoutcfg
+官网PC端入口:
+https://www.icris.cr.gov.hk/csci/cps_criteria.do
+
+采集文件存放路径：
+/data/gravel_spiders/enterprise_hk_spider
+```
+
+
+
+## 采集频率及采集策略
+<!--说明该项数据更新频率，存量数据的更新频率及策略、新增数据的采集频率及策略-->
+
+### 存量更新策略
+<!--无需更新？每天全量更新？逐条轮询更新？多久更新完一轮？或其他-->
+```text
+
+目前全量更新一轮即可.
+
+```
+
+
+### 增量采集策略
+<!--新增数据怎么来？无需单独采集新增数据？-->
+```text
+1.新成立的主体
+2.补充的主体
+
+一周更新一次
+```
+
+---
+
+# **爬虫**
+```text
+香港企业补充爬虫 enterprise_hk_spider
+```
+
+## 责任人
+```text
+蒋家升
+```
+
+## 爬虫名称
+```text
+enterprise_hk_spider
+```
+
+<!--spider_name-->
+
+## 代码地址
+```text
+项目地址: 
+```
+
+## 队列名称及队列地址
+<!--redis host port db key 优先级说明-->
+-
+* redis host: redis://:utn@0818@bdp-mq-001.redis.rds.aliyuncs.com:6379/0
+* redis port: 6379
+* redis db: 0
+* redis key: 
+    * enterprise:hk
+
+### 优先级队列说明
+* enterprise:hk 支持队列优先级
+
+## 任务来源
+<!--说明爬虫任务的输入。如：来自某个数据库表等。如果来自某个数据库表则应该简要说明该表内的数据是如何维护的。-->
+```buildoutcfg
+```
+
+## 任务输入参数（样例）  
+其中CRNo（公司编号）为必需
+```json
+{
+    "CRNo": 446
+  }
+```
+
+### 任务样例
+<!--注意是爬虫拿到的完整任务，而不仅仅是task_params-->
+```buildoutcfg
+```
+
+### 任务参数说明
+<!--特有参数说明，通用参数比如spider_name,task_params,task_src,task_result等不需说明-->
+```json
+{
+    "CRNo": 446
+  }
+```
+
+> + 主要参数
+>   + CRNo: 公司编号
+
+
+## data_type说明
+<!--可能产生的data_type说明-->
+```buildoutcfg
+detail: 详情信息
+```
+
+## 爬虫结果的超级数据
+<!--包含所有字段的json数据，每个value都要有样例值-->
+```text
+同以下实际爬虫结果
+```
+
+## 实际爬虫结果的数据结构
+<!--可能与超级数据一致，可能不同的data_type的爬虫结果结构不同，超级数据是把所有data_type的结果组合在一起-->
+```json
+{
+  "data":
+  {
+    "company_code": "0000446",
+    "company_type": "私人股份有限公司",
+    "establish_date": "1922-06-00",
+    "company_status": "仍注册",
+    "remark": "",
+    "liquidation_mode": "",
+    "cancel_date": "",
+    "mortgage": "有",
+    "imp_matters": "",
+    "company_name": "堅穩工程有限公司",
+    "en_name": "KENWORTH ENGINEERING LIMITED",
+    "changes_hk":
+    [
+      {
+        "change_field": "使用名称",
+        "change_date": "2000-08-00",
+        "use_name": "堅穩工程有限公司",
+        "use_en_name": "KENWORTH ENGINEERING LIMITED"
+      },
+      {
+        "change_field": "使用名称",
+        "change_date": "1996-09-03",
+        "use_name": "太元堅穩工程有限公司",
+        "use_en_name": "UDL KENWORTH ENGINEERING LIMITED"
+      },
+      {
+        "change_field": "使用名称",
+        "change_date": "1988-08-05",
+        "use_name": "堅穩工程有限公司",
+        "use_en_name": "KENWORTH ENGINEERING LIMITED"
+      },
+      {
+        "change_field": "使用名称",
+        "change_date": "1988-03-08",
+        "use_name": "堅穩工程有限公司",
+        "use_en_name": "POLYGON ENGINEERING LIMITED"
+      },
+      {
+        "change_field": "使用名称",
+        "change_date": "1987-01-07",
+        "use_name": "",
+        "use_en_name": "POLYGON ENGINEERING LIMITED"
+      },
+      {
+        "change_field": "使用名称",
+        "change_date": "1982-07-06",
+        "use_name": "",
+        "use_en_name": "GILMAN ENGINEERING LIMITED"
+      },
+      {
+        "change_field": "使用名称",
+        "change_date": "1922-06-00",
+        "use_name": "",
+        "use_en_name": "JAMES H. BACKHOUSE LIMITED"
+      }
+    ]
+  },
+  "http_code": 200,
+  "error_msg": "",
+  "task_result": 1000,
+  "data_type": "detail",
+  "spider_start_time": "2021-09-10 17:10:21.044",
+  "spider_end_time": "2021-09-10 17:10:22",
+  "task_params":
+  {
+    "CRNo": 446
+  },
+  "metadata":
+  {},
+  "spider_name": "enterprise_hk_spider",
+  "spider_ip": "10.8.1.14"
+}
+```
+
+## 爬虫运行环境
+<!--udm模块？scrapy？或其他-->
+```buildoutcfg
+scrapy
+```
+
+
+## 爬虫部署信息
+<!--部署在哪些机器？每个机器多少进程？项目名称是什么？-->
+```buildoutcfg
+target: node_76,
+spider_name: enterprise_hk_spider 
+10个进程  
+```
+
+
+## Taskhub地址
+```buildoutcfg
+提交任务地址: 
+代码编写地址: 
+```
+
+## Taskhub调度规则说明
+```buildoutcfg
+task_result=1000    # 正常获取到详情任务
+task_result=1101    # 无结果信息
+task_result=9101    # 超时错误，需要进行重试，目前重试5次
+task_result=8000    # 参数错误
+```
+
+
+## 爬虫监控指标设计
+<!--监控爬虫正常运行的指标是什么？报警规则是什么？-->
+```buildoutcfg
+(先观察，待补充)
+索引: 
+监控频率: 
+监控起止时间: 
+报警条件: 
+报警群:  
+报警内容: 
+
+```
+
+---
+
+# **数据归集**
+
+## 责任人
+```html
+```
+
+
+## 数据归集方式
+
+- [ ] 爬虫直接写kafka
+
+- [ ] 爬虫写文件logstash采集
+
+## 爬虫结果目录
+```html
+```
+
+## 归集后存放目录
+```html
+```
+
+## logstash配置文件名称
+```html
+```
+
+## logstash文件采集type
+```html
+```
+
+## 数据归集的topic
+```
+```
+
+## ES日志索引及筛选条件
+```html
+
+```
+
+## 监控指标看板
+
+## 数据保留策略
+
+---
+
+# **数据清洗**
+
+## 责任人
+
+
+## 代码地址
+
+
+## 部署地址
+<!--机器及线上代码地址-->
+
+
+## 部署方法及说明
+<!--运行方法及运行命令、supervisor配置、supervisor的program等-->
+- [ ] crontab + data_pump
+- [ ] supervisor + data_pump
+- [ ] supervisor + consumer
+
+## 数据接收来源
+<!--来源于kafka还是归集的文件、topic的group？-->
+
+
+## 数据存储表地址
+
+* 数据库地址：
+* 表名：
\ No newline at end of file