微信門戶應用管理系統,採用基於 MVC + Bootstrap + Ajax + Enterprise Library的技術路線,界面層採用Boostrap + Metronic組合的前端框架,數據訪問層支持Oracle、SQLServer、MySQL、PostgreSQL等資料庫。框架以MVC5,... ...
微信門戶應用管理系統,採用基於 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,然後保存成功即可,如下界面所示。