微信門戶開發框架-使用指導說明書

微信門戶應用管理系統，采用基於 MVC + Bootstrap + Ajax + Enterprise Library的技術路線，界面層采用Boostrap + Metronic組合的前端框架，數據訪問層支持Oracle、SQLServer、MySQL、PostgreSQL等數據庫。框架以MVC5，C#4.5作為開發基礎，能夠部署在任何.NET服務器上，建議部署到阿里雲服務器。

1、環境准備

本框架采用C#開發，Web管理端采用基於 MVC + Bootstrap + Ajax + Enterprise Library的技術路線的架構，需要使用VS2017/2019進行開發，默認數據庫采用SQL Server，可以安裝SQL Server 2008R2及以上。

微信公眾號開發，一般需要進行相關的網頁頁面調試，請下載微信提供的《微信開發者工具》，下載地址為：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html。

框架開發一般還需要使用到代碼生成工具，工具可以從我公司的官網上下載（http://www.iqidi.com/Download/Database2SharpSetup.rar）。

 

2、模塊說明

整個框架項目包含了微信公眾號、企業微信、小程序三個部分內容，其中三者之間有一些相同的部分抽象出來放在一個公共的項目里面，然后公眾號、企業微信、小程序共享一個后台管理系統，這個后台系統主要就是實現賬號信息的配置、和微信后台事件的對接、以及權限和系統數據的管理維護等功能。

使用VS打開項目源碼后，解決方案的工程如下所示。

 

下面是對上面項目工程進行說明，方便理解其中各個模塊的意義。

編號	名稱	說明
01_Framework 目錄里面的項目，是框架的基礎內容，包括權限、字典、附件模塊的管理。
1	Security	權限管理模塊業務層。
2	Dictionary	字典管理模塊業務層。
3	Attachment	附件管理模塊業務層
4	Other	其他系統內容，如圖標、產品、測試用戶等基礎信息
02_Common目錄里面的項目，是公眾號/企業微信/小程序公用的部分，如賬號配置、基礎消息對象類，也可以是Web后台管理所需的模塊內容。
1	WHC.Common.API	提供一些第三方模塊的封裝，如郵件處理、短信處理以及一些第三方的應用擴展模塊等。
2	WHC.Common.Cache	基於CacheManager的接口處理的緩存接口，可以實現SystemRuntimeCache、Redis等緩存的整合。
3	WHC.Common.Data	提供常用模塊，需要對數據庫處理的模塊的封裝，包括一些如賬號、菜單、事件、消息內容等公用的數據存儲。
4	WHC.Common.Entity	提供常用模塊里面設計到的實體類信息。包括公眾號和企業微信都共同用到的對象類。
5	WHC.Common.Handler	多個IOC方式的模塊，可以在所需系統注冊使用。 自定義接口包含有測試處理接口、企業微信消息推送接口、設備信息二維碼掃碼接口、短信和郵件發送接口。 外部的插件業務接口包括：百度的地理位置解析接口、電影院信息查詢、天氣信息查詢、交通信息查詢、旅游信息查詢等。
03_Weixin 目錄里面的項目，是微信公眾號API相關的內容。
1	TestWeixin	是對公眾號的API封裝的項目模塊進行測試。
2	WHC.Weixin.API	針對微信公眾號API的單獨封裝。
3	WHC.Weixin.Data	結合數據庫存儲內容，對微信公眾號模塊的管理。這個模塊包含對WHC.Weixin.API的使用。
04_Corp目錄里面的項目，是對企業微信API的封裝和對數據庫管理模塊的封裝。
1	TestCorp	是對企業微信的API封裝的項目模塊進行測試。
2	WHC.Corp.API	針對微信企業微信API的單獨封裝。
3	WHC.Corp.Data	結合數據庫存儲內容，對企業微信模塊的管理。這個模塊包含對WHC.Corp.API的使用。
05_SmallApp目錄里面的項目，是對小程序API的封裝和對數據庫管理模塊的封裝。
1	TestSmallApp	是對小程序的API封裝的項目模塊進行測試。
2	WHC.SmallApp.API	針對小程序API的單獨封裝。
3	WHC.SmallApp.Data	結合數據庫存儲內容，對小程序模塊的管理。這個模塊包含對WHC. SmallApp.API的使用。
06_UI 是微信后台管理系統部分內容，包括后台管理系統及企業微信的管理客戶端程序。
1	WHC.Weixin.BootstrapUI	微信管理后台，包括對公眾號和企業微信的統一管理，實現各個模塊數據的同步和查看管理操作。
2	CorpManagement	基於C/S的Winform企業微信管理客戶端，可以方便管理企業微信的通訊錄的組織機構、標簽、人員信息，以及文本、圖片、語音、視頻等消息的發送功能。
07_His 是擴展的項目部分
1	WHC.His.Data	包含對醫療設備維修項目、處方審核項目等擴展項目的模塊管理。
其他模塊
1	公用類庫 WHC.Framework.Commons WHC.Framework.ControlUtil	提供日常各種開發操作的輔助類庫。 WHC.Framework.Commons項目是對常規.NET共用類庫的封裝使用，已達到統一、高效、方便的目的。 WHC.Framework.ControlUtil項目是對第三方組件的封裝使用，以及對整個框架各層抽象類的定義和封裝。
2	分頁類 WHC.Pager.Entity	這個是獨立定義的一個分頁參數對象，方便框架里面對數據進行分頁處理。
4	參數配置管理 SettingsProvider.Net	提供了一個第三方的配置信息的管理類。這個是在GitHub上的一款參數配置組件，能夠基於普通配置文件、ProgramData目錄文件、獨立存儲區文件等方式的配置文件存儲，它主要是基於Json格式進行的配置保存，因此我們還可以把它存儲到數據庫

 

3、模塊關系

 開發模塊划分包括：微信公眾號、企業微信、小程序幾個部分

 

這幾個部分又有一些基礎一樣的內容，抽取出來作為公共的項目。公眾號、企業微信、小程序公共部分內容如下所示。

 

 公眾號、企業微信、小程序幾個分類，它們包含了數據存儲的模塊內容，也包括了對應分類的微信API操作部分。數據管理模塊和API模塊調用關系如下所示。

 

微信界面項目，同樣是這幾個部分的組合。微信界面部分是前面模塊組件的綜合使用，在微信應用里面，一般需要使用80端口和微信服務器做交互，而這個同時往往也是我們項目的端口地址。 

 

 另外，微信框架還包括基礎類庫支持部分內容，包括權限管理、字典管理、附件管理等基礎內容。

 

 

微信開發，我們首先需要利用我們的語言（這里是利用C#語言），為所有用到的API接口實現進一步的封裝，方便使用，微信API模塊包含的內容很多，其中公眾號接口封裝包括內容如下所示。

 

 企業微信的API接口包含內容如下所示。

 

 

我們在WHC.Weixin.Data模塊里面，定義了包含公眾號的消息分派處理接口，這個分派接口是對接收來自微信服務器的各種消息事件進行響應；另外該模塊還包含一些常規的數據存儲，如關注用戶、菜單、文章內容等方面數據的存儲，如下所示。

同樣我們參考微信公眾號的做法，也是建立一個數據存儲管理的項目，作為微信消息事件的處理入口，同時也管理存儲一些必須的數據，包括需要同步的用戶、標簽、部門等數據。

 

4、微信公眾號配置

不管是微信公眾號，還是企業微信，都需要申請賬號才能使用，並且最好通過認證，這樣才能具有更多的接口權限使用。

微信公眾號的注冊申請參考文章：http://www.cnblogs.com/wuhuacong/p/3613826.html。

輸入賬號密碼，登錄微信公眾號后台https://mp.weixin.qq.com，然后掃碼確認登陸，在左側【開發】【基本配置】中獲取對應的賬號配置參數。

 

 

 

 在【修改配置】中進行修改內容，如下界面所示。

 

 然后啟動微信管理后台系統（一般啟動，本地地址為http://localhost:32973/Login/Index），如果部署在服務器后，請通過域名進行訪問即可。

登陸后台系統后，在【微信管理】【微信賬號配置】管理界面里面進行維護對應賬號信息，如下界面所示。 

 

 

 

 修改或者增加相關的公眾號賬號信息。（根據微信公眾號參數，錄入紅色方框的內容）

 

 再次回到剛才后台的界面，修改對應的URL，提交參數，如提示【提交成功】即可正確完成配置。

 

 

 

 5、企業微信配置

微信企業微信的注冊申請參考文章：http://www.cnblogs.com/wuhuacong/p/3991735.html。

企業微信后台登錄地址為：https://work.weixin.qq.com ，掃碼登錄進行獲取對應的參數，找到【我的企業】【企業信息】界面，如下界面所示。

 

 然后滾動到底部，找到對應的企業ID，如下界面所示，這個就是后面填寫需要用到的CorpID。

 

 

再次切換到【應用管理】【應用】選項卡里面。

 

 在應用底部，找到【創建應用】按鈕，創建一個新的應用；或者單擊進入現有的應用進行查看參數。

 

 查看創建了的應用信息，如下界面所示。

 

 

 

 記錄下前面的CorpID、CorpSecret、加密Token、加密秘鑰等參數。

然后啟動Web管理后台，登錄后台系統后，在【微信管理】【微信賬號配置】管理界面里面進行維護對應賬號信息，如下界面所示。

 

 在賬號管理界面里面，選擇企業微信，修改或者增加相關的賬號信息。

 

 

 

 再次回到企業微信后台，錄入上面獲得的接收URL，然后保存成功即可，如下界面所示。