Загрузка api server - Загрузка исходного кода api server

api server

AI Исходный код

1.0.0

Скачать

Важно: этот проект не требует обслуживания и в настоящее время не имеет возможности продолжать его обслуживание. Если вы заинтересованы в его поддержке, вы можете связаться со мной, и я сделаю все возможное, чтобы помочь.

Безопасный, мощный и простой в разработке корпоративный WeChat SCRM

Документация | Скриншоты | Установка |

Введение в проект

OpenSCRM — это высококачественная корпоративная система управления трафиком частного домена WeChat, основанная на Go и React.

Быстрый старт, запуск демо-проекта (docker-compose)

Мы полагаемся на docker-compose для запуска MySQL и Redis. Внутренний API api-сервера компилируется и запускается локально, а внешний интерфейс информационной панели также компилируется и запускается локально.

Запустите MySQL и Redis

докер-составить

Запустить API-сервер

conf/config.example.yaml -> conf/config.yaml // Просто измените поле SuperAdmin и измените остальные после запуска
Запустите main.go в корневом каталоге проекта.
адрес прослушивания API http://localhost:9001/

Запустите интерфейсную панель

git-клон https://github.com/openscrm/dashboard
Установите версию nodejs 16.20.2. Эту версию можно использовать только в других версиях. Для управления версией узла рекомендуется использовать nvm.
Необязательно, установите источник внутреннего зеркала пакета npm, см. https://npmmirror.com/.
npm install --legacy-peer-deps
запуск запуска npm

Посетите сайт

http://локальный хост:9000/

Настройте внутреннюю среду разработки (необязательно)

Установите языковую среду go

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.

Подпроект

Панель управления службой архивирования сеансов Enterprise Боковая панель WeChat H5

Особенности проекта

Высокая безопасность : Enterprise WeChat контролирует конфиденциальные данные всех сотрудников и клиентов компании, такие как номера телефонов, должности, теги клиентов, контактную информацию и т. д. В случае утечки удар по компании будет фатальным. Наша команда имеет обширный опыт веб-безопасности для обеспечения безопасности проектов.
Высокая производительность и высокая стабильность . Благодаря превосходным инженерным возможностям Go и простым и эффективным возможностям управления параллелизмом OpenSCRM обладает высокой производительностью и стабильностью, сравнимой с показателями ведущих поставщиков SaaS.
Уделяйте приоритетное внимание читабельности кода . Мы полностью согласны с мнением Google об управлении кодом. Завершение разработки проекта — это только начало. Дальнейшая работа заключается в обслуживании и итерациях. Только читаемый код может обеспечить высокое качество и эффективность последующих итераций. это также цель разработки языка Go. У нас очень полные комментарии к коду, и все коды стараются быть ясными и легко читаемыми.
Легкость разработки . Поскольку это проект с открытым исходным кодом, мы проделали большую работу, чтобы сделать его простым и легким в использовании, чтобы больше людей могли извлечь из него пользу. Мы делаем только необходимые абстракции (MVC) и избегаем введения новых концепций. Мы настаиваем на том, чтобы иметь как можно меньше зависимостей промежуточного программного обеспечения, полагаясь только на Mysql и Redis. Например, мы реализуем очередь задержки на основе Redis без введения Kafka, например, полнотекстовое извлечение реализовано на основе полнотекстового извлечения Mysql8 без введения; ЭС.

Разработчики Python, PHP и NodeJS могут с уверенностью использовать этот проект. В этом проекте была проделана большая работа, чтобы сделать его простым и легким для начала.

Скриншоты проекта

стек технологий

Стек серверных технологий

Идти
Джин
ГОРМ
Редис
MySQL >= 5.7

Стек интерфейсных технологий

Реагировать
Машинопись
Муравей Дизайн
Муравей Дизайн Про
Профессиональные компоненты

Структура каталогов

 ├─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

Отладка API

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

Заявление об авторских правах

OpenSCRM следует протоколу Apache2.0 и бесплатен для коммерческого использования.

Часто задаваемые вопросы

1. Инициализация не удалась и возникла ошибка "не разрешать доступ с вашего ip".

Пример ошибки:

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

Решение

Войдите в серверную часть администратора Enterprise WeChat->Безопасность и управление->Инструменты управления->Синхронизация книги контактов->Доверенный IP-адрес предприятия. Добавьте общедоступный IP-адрес, который обеспечивает доступ к интерфейсу Enterprise WeChat.

2. Подсказка интерфейса входа в систему: redirect_uri не соответствует настроенному доменному имени обратного вызова для завершения авторизации.

Причина ошибки

Для входа в систему Enterprise WeChat необходимо настроить авторизованное имя домена. Если доменное имя несовместимо, появится сообщение об этой ошибке. Демонстрационный сайт использует мою конфигурацию. Для завершения соответствующей настройки необходимо создать собственное приложение.

Решение 1 (для производственной среды)

Войдите в серверную часть администратора Enterprise WeChat->Управление приложениями->Приложение->Самостоятельно созданное приложение (ваше приложение)->Авторизованный вход в Enterprise WeChat->Авторизованный домен обратного вызова.