api server
1.0.0
ドキュメント | スクリーンショット インストール |
OpenSCRM は、 GoとReactをベースにした高品質のエンタープライズ WeChat プライベート ドメイン トラフィック管理システムです
mysql と redis の起動には docker-compose を使用します。 api-server バックエンド API はローカルでコンパイルされて開始され、ダッシュボード フロントエンド インターフェイスもローカルでコンパイルされて開始されます。
ドッカー構成アップ
http://ローカルホスト:9000/
https://go.dev/doc/install
conf/config.example.yaml -> conf/config.yaml
go run main.go
http://dashboard.dev.openscrm.cn:9000/
詳細については、https://github.com/openscrm/dashboard を参照してください。
セッション アーカイブ サービス管理パネル エンタープライズ WeChat H5 サイドバー
高いセキュリティ: エンタープライズ WeChat は、会社の全従業員と顧客の電話番号、役職、顧客タグ、連絡先情報などの機密データを管理します。漏洩すると、会社は致命的な打撃を受けます。私たちのチームには、プロジェクトのセキュリティを確保するための豊富な Web セキュリティの経験があります。
高性能と安定性: Go の優れたエンジニアリング能力とシンプルで効果的な同時実行制御機能のおかげで、OpenSCRM は主要な SaaS ベンダーに匹敵する高いパフォーマンスと安定性を備えています。
コードの可読性を優先する: コード管理に関する Google の見解に深く同意します。プロジェクト開発の完了は、メンテナンスと反復作業の始まりに過ぎません。これにより、可読性の高いコードだけが、後のイテレーションの高品質と効率を確保できます。これは Go 言語の設計目標でもあります。私たちは非常に完全なコード コメントを持っており、すべてのコードは明確で読みやすいように努めています。
開発が簡単: オープンソース プロジェクトとして、より多くの人がこのプロジェクトの恩恵を受けられるように、プロジェクトをシンプルで使いやすいものにするために多くの作業を行いました。 必要な抽象化 (MVC) のみを作成し、新しい概念の導入を避けます。私たちは、Mysql と Redis のみに依存するミドルウェアの依存関係をできるだけ少なくすることにこだわります。たとえば、Kafka を導入せずに、Redis に基づいて遅延キューを実装します。たとえば、フルテキスト検索は、Kafka を導入せずに Mysql8 のフルテキスト検索に基づいて実装します。エス。
Python、PHP、および NodeJS の開発者は、このプロジェクトを安心して使用できるように、このプロジェクトをシンプルかつ非常に簡単に開始できるようにするために多くの作業が行われています。
├─app
│ ├─callback 企业微信事件回调处理
│ │ ├─customer_event
│ │ ├─department_event
│ │ ├─group_chat_event
│ │ ├─msg_arch_event
│ │ ├─staff_event
│ │ └─tag_event
│ ├─constants 常量定义
│ ├─consumers 队列消费
│ ├─controller 控制器
│ ├─entities 消息实体，主要定义参数，请求，响应结构体
│ ├─middleware gin请求中间件
│ ├─models 数据库模型
│ ├─requests 请求定义
│ ├─responses 响应定义
│ ├─services 服务
│ ├─tasks 定时任务
├─bin 二进制文件
├─common 共同库
│ ├─app 基于Gin封装的常用请求响应处理函数
│ ├─delay_queue 基于Redis延迟队列
│ ├─ecode 错误码
│ ├─id_generator uuid生成
│ ├─log 日志
│ ├─redis redis操作库
│ ├─session session会话
│ ├─storage 存储
│ ├─util 常用工具函数
│ └─validator 请求验证
├─conf 配置文件
├─docker
│ ├─data
│ │ ├─dashboard
│ │ │ └─dist 管理后台构建的前端静态文件
│ │ ├─mysql
│ │ │ ├─conf mysql容器配置文件
│ │ │ └─db mysql容器数据文件
│ │ ├─nginx
│ │ │ ├─conf nginx容器配置文件
│ │ │ │ └─conf.d
│ │ │ └─logs
│ │ ├─redis
│ │ │ └─db redis容器数据文件
│ │ └─sidebar
│ │ └─dist 侧边栏构建的前端静态文件
│ └─lib 企业微信提供的会话存档动态链库
├─docs 文档
├─pkg 三方库
│ └─easywework 企业微信Api调用库
│ ├─errcodes 企业微信Api错误码
├─routers Gin路由
├─scripts 脚本
└─test 测试代码
https://github.com/openscrm/api-server/wiki/%E5%AE%89%E8%A3%85%E6%95%99%E7%A8%8B
docs目录包含postman导出文件，可方便调试api
OpenSCRM は Apache2.0 プロトコルに従っており、商用利用は無料です
get all departments from wx failedClientError { Code: 60020, Msg: "not allow to access from your ip, 错误
Enterprise WeChat 管理者バックエンドにログインします -> セキュリティと管理 -> 管理ツール -> 連絡先帳の同期 -> エンタープライズの信頼された IP エンタープライズ WeChat インターフェイスへのアクセスを許可するパブリック IP を追加します
エンタープライズ WeChat スキャン ログインでは、承認されたログイン アドレスのドメイン名を構成する必要があります。ドメイン名が一致しない場合、このエラーが表示されます。独自のアプリケーションを構築して、関連する構成を完了する必要があります。
エンタープライズ WeChat 管理者のバックエンドにログイン -> アプリケーション管理 -> アプリケーション -> 自作アプリケーション (アプリケーション) -> エンタープライズ WeChat 承認ログイン -> 承認コールバック ドメイン
nginx 構成を確認する docker/nginx/conf/conf.d/dashboard.conf
docker のホスト IP アドレスは 172.17.0.1 です。すべての docker サービスは、ホストへのデフォルトのリスニング ポートを設定ファイルで、ホストが必要な場所に 172.17.0.1 と入力します。
