Unduh api server - unduh kode sumber api server

api server

Kode Sumber AI

1.0.0

Unduh

Penting: Proyek ini kurang pemeliharaan dan saat ini tidak memiliki kekuatan untuk melanjutkan pemeliharaan. Jika Anda tertarik untuk memeliharanya, Anda dapat menghubungi saya dan saya akan berusaha sebaik mungkin untuk membantu.

WeChat SCRM perusahaan yang aman, kuat, dan mudah dikembangkan

Dokumentasi |. Tangkapan Layar |. Demo |

Pengenalan proyek

OpenSCRM adalah sistem manajemen lalu lintas domain pribadi WeChat perusahaan berkualitas tinggi berdasarkan Go dan React

Mulai cepat, mulai proyek demo (docker-compose)

Kami mengandalkan docker-compose untuk memulai mysql dan redis. API back-end server api dikompilasi dan dimulai secara lokal, dan antarmuka front-end dasbor juga dikompilasi dan dimulai secara lokal.

Mulai mysql dan redis

komposisi buruh pelabuhan

Mulai api-server

conf/config.example.yaml -> conf/config.yaml // Cukup modifikasi kolom SuperAdmin, dan ubah yang lain setelah dijalankan
Mulai, jalankan main.go di direktori root proyek
alamat mendengarkan api http://localhost:9001/

Mulai dasbor front-end

git clone https://github.com/openscrm/dashboard
Instal nodejs versi 16.20.2. Versi ini hanya dapat digunakan. Versi lain akan memiliki masalah kompatibilitas.
Opsional, instal sumber mirror paket npm domestik, lihat https://npmmirror.com/
npm install --legacy-peer-deps
npm jalankan mulai

Kunjungi situs

http://localhost:9000/

Menyiapkan lingkungan pengembangan back-end (opsional)

Instal lingkungan bahasa go

https://go.dev/doc/install

Ubah file konfigurasi

conf/config.example.yaml -> conf/config.yaml

Mulai programnya

 go run main.go

Kunjungi situs

http://dashboard.dev.openscrm.cn:9000/

Membangun lingkungan pengembangan front-end

Lihat detailnya: https://github.com/openscrm/dashboard

Subproyek

Panel Manajemen Layanan Arsip Sesi Bilah Samping Perusahaan WeChat H5

Fitur proyek

Keamanan tinggi : WeChat Perusahaan mengontrol data sensitif seluruh karyawan dan pelanggan perusahaan, seperti nomor telepon, posisi, tag pelanggan, informasi kontak, dll. Jika bocor, pukulan bagi perusahaan akan berakibat fatal. Tim kami memiliki pengalaman keamanan web yang luas untuk memastikan keamanan proyek.
Kinerja tinggi dan stabilitas tinggi : Berkat kemampuan teknik Go yang luar biasa serta kemampuan kontrol konkurensi yang sederhana dan efektif, OpenSCRM memiliki kinerja dan stabilitas tinggi yang sebanding dengan vendor SaaS terkemuka.
Prioritaskan keterbacaan kode : Kami sangat setuju dengan pandangan Google tentang manajemen kode. Penyelesaian pengembangan proyek hanyalah permulaan proyek. Lebih banyak pekerjaan terletak pada pemeliharaan dan iterasi. Hanya kode yang dapat dibaca yang dapat memastikan kualitas tinggi dan efisiensi dari iterasi selanjutnya juga merupakan tujuan desain bahasa Go. Kami memiliki komentar kode yang sangat lengkap, dan semua kode diusahakan agar jelas dan mudah dibaca.
Mudah dikembangkan : Sebagai proyek sumber terbuka, agar lebih banyak orang dapat memperoleh manfaat dari proyek ini, kami telah melakukan banyak pekerjaan untuk membuat proyek ini sederhana dan mudah digunakan. Kami hanya membuat abstraksi yang diperlukan (MVC) dan menghindari pengenalan konsep baru. Kami bersikeras untuk memiliki ketergantungan middleware sesedikit mungkin, hanya mengandalkan Mysql dan Redis. Misalnya, kami menerapkan antrian penundaan berdasarkan Redis tanpa memperkenalkan Kafka; misalnya, pengambilan teks lengkap diimplementasikan berdasarkan pengambilan teks lengkap Mysql8 tanpa memperkenalkan ITU.

Pengembang Python, PHP, dan NodeJS dapat menggunakan proyek ini dengan percaya diri. Banyak pekerjaan telah dilakukan dalam proyek ini untuk membuatnya sederhana dan sangat mudah untuk memulai.

Tangkapan layar proyek

tumpukan teknologi

Tumpukan teknologi backend

Pergi
Gin
GORM
ulang
MySql >= 5.7

Tumpukan teknologi front-end

Bereaksi
Skrip Ketik
Desain Semut
Desain Semut Pro
Komponen Pro

Struktur direktori

 ├─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 测试代码

Tutorial instalasi

https://github.com/openscrm/api-server/wiki/%E5%AE%89%E8%A3%85%E6%95%99%E7%A8%8B

Proses debug API

docs目录包含postman导出文件，可方便调试api

Pernyataan hak cipta

OpenSCRM mengikuti protokol Apache2.0 dan gratis untuk penggunaan komersial

Pertanyaan Umum

1. Inisialisasi gagal dan terjadi kesalahan "tidak izinkan akses dari ip Anda".

Contoh kesalahan:

 get all departments from wx failedClientError { Code: 60020, Msg: "not allow to access from your ip, 错误

Larutan

Masuk ke backend administrator Enterprise WeChat->Keamanan dan Manajemen->Alat Manajemen->Sinkronisasi Buku Kontak->IP Tepercaya Perusahaan Tambahkan IP publik yang memungkinkan akses ke antarmuka WeChat Perusahaan

2. Prompt antarmuka masuk: redirect_uri tidak konsisten dengan nama domain panggilan balik penyelesaian otorisasi yang dikonfigurasi

Alasan kesalahan

Login pemindaian WeChat perusahaan perlu mengonfigurasi nama domain alamat login resmi. Jika nama domain tidak konsisten, kesalahan ini akan muncul. Situs demo menggunakan konfigurasi saya.

Solusi 1 (untuk lingkungan produksi)

Masuk ke backend administrator Enterprise WeChat->Manajemen Aplikasi->Aplikasi->Aplikasi yang dibuat sendiri (aplikasi Anda)->Login resmi WeChat Perusahaan->Domain panggilan balik resmi