Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
github: high-cde
custom:
- "https://x-zdos.it/sponsor"
- "https://ko-fi.com/zdos"
- "https://cloudx.zdos.dev/support"
message: >
Supporta lo sviluppo di xCLOUD Enterprise e contribuisci alla crescita dell’ecosistema CloudX × ZDOS.
Il progetto evolve il Developer Hub in una piattaforma moderna, modulare e orientata alle imprese.
Sponsorizzando aiuti l’espansione dei moduli Nexus, Terminal, Portal, DSN Layer e delle integrazioni enterprise.
Empty file added .nojekyll
Empty file.
3 changes: 3 additions & 0 deletions BRANDING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
xCLOUD by ZDOS
Business Layer · DSN Compatible
Integrato con CloudX Portal e DSN Wallet.
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
MIT License

Copyright (c) 2025 Bitrix24
Copyright (c) 2025 xCLOUD

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
156 changes: 101 additions & 55 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,90 +1,136 @@
<img src="./b24devhub-header.png" alt="Bitrix24 Developer Hub" width="1195"/>
🚀 xCLOUD · Enterprise Fork
![License](LICENSE)
![Status]()
![CloudX]()
![Blockchain Ready]()
![Made for ZDOS]()

Welcome to the central hub for Bitrix24 developer tools. This repository offers a curated collection of official SDKs, UI kits, examples, and application templates to streamline your development process with the Bitrix24 platform.
Un fork avanzato di xCLOUD, ottimizzato per ambienti moderni, integrabile con sistemi blockchain e progettato per essere parte del CloudX Business Layer.

## 📚 Table of Contents
Questa versione mantiene la compatibilità con l’architettura originale, ma introduce un approccio più modulare, pulito e orientato all’automazione.

- [SDKs and Libraries](#sdks-and-libraries)
- [PHP SDK](#php-sdk)
- [JavaScript/Node.js SDK](#javascriptnodejs-sdk)
- [Python SDK](#python-sdk)
- [UI Tools](#ui-tools)
- [Bitrix24 UI Kit](#bitrix24-ui-kit)
- [Design Tokens](#design-tokens)
- [Icons](#icons)
- [Usage Examples](#usage-examples)
- [Application Templates](#application-templates)
- [Automation rules library](#automation-rules-library)
- [Documentation](#documentation)

## SDKs and Libraries

### PHP SDK

- **b24phpsdk**: The official PHP library for interacting with the Bitrix24 REST API. It supports both OAuth tokens and incoming webhooks, with features like automatic token renewal and offline queues.
---

[GitHub Repository](https://github.com/bitrix24/b24phpsdk). Find more details in the [documentation](https://apidocs.bitrix24.com/api-reference/b24phpsdk/index.html)
✨ Caratteristiche principali

### JavaScript/Node.js SDK
🔹 1. Compatibilità xCLOUD
- CRM completo
- Gestione attività e progetti
- Calendari, gruppi di lavoro, pipeline
- Moduli aziendali standard

- **b24jssdk**: The official JavaScript SDK for Bitrix24 REST API, compatible with both browser and Node.js environments. It supports modern JavaScript features and offers advantages over the traditional BX24.JS library.
🔹 2. Enterprise Hardening
- Struttura più pulita
- Separazione logica dei moduli
- Configurazioni centralizzate
- Miglioramenti per deploy CI/CD

[GitHub Repository](https://github.com/bitrix24/b24jssdk). Find more details in the [documentation](https://bitrix24.github.io/b24jssdk/)
🔹 3. Integrazione CloudX × ZDOS
Questo fork è pensato per essere parte del tuo ecosistema:

### Python SDK
- CloudX Portal → accesso centralizzato
- ZDOS → automazioni e micro‑servizi
- DSN Wallet → identità e firma digitale
- xCLOUD → business layer modulare

- **b24pydk**: The official Python library for interacting with the Bitrix24 REST API (beta version). It supports both OAuth tokens and incoming webhooks, with features like automatic token renewal and batch calls.
🔹 4. Blockchain Ready (DSN)
Supporto opzionale per:
- registrazione eventi on‑chain
- audit trail distribuito
- firma digitale
- integrazione con smart contract aziendali

[GitHub Repository](https://github.com/bitrix24/b24pysdk).

## UI Tools
---

### Bitrix24 UI Kit
🧩 Architettura

- **b24ui**: A UI kit for developing web applications using the Bitrix24 REST API, built on NUXT & VUE. It provides a set of reusable components to accelerate development.
`
xCLOUD-enterprise/
├── core/ # Moduli principali xCLOUD
├── modules/ # Estensioni e plugin
├── cloudx/ # Integrazioni con CloudX
│ ├── dsn/ # Adapter blockchain DSN
│ └── zdos/ # Automazioni e hooks
├── config/ # Configurazioni centralizzate
└── docs/ # Documentazione tecnica
`

[GitHub Repository](https://github.com/bitrix24/b24ui). Find more details in the [documentation](https://bitrix24.github.io/b24ui/)
---

### Design Tokens
⚙️ Installazione

- **b24style**: Design tokens for Bitrix24 UI Kit. Provides the ability to create application interfaces that closely match the Bitrix24 user interface using Tailwind CSS utility classes.
1. Clona il repository
`bash
git clone https://github.com/high-cde/xCLOUD-enterprise.git
cd xCLOUD-enterprise
`

[GitHub Repository](https://github.com/bitrix24/b24style). Find more details in the [documentation](https://bitrix24.github.io/b24style/)
2. Installa dipendenze
`bash
composer install
npm install
`

### Icons
3. Configura l’ambiente
`bash
cp .env.example .env
`

- **b24icons**: The library contains SVG icons for use in the interfaces of both local and mass-market applications for Bitrix24.
Modifica i parametri necessari:
- database
- URL
- DSN blockchain (opzionale)

[GitHub Repository](https://github.com/bitrix24/b24icons). Find more details in the [documentation](https://bitrix24.github.io/b24icons/)
---

## Usage Examples
🔗 Integrazioni Ecosistema

- **b24sdk-examples**: A collection of examples demonstrating the usage of various Bitrix24 SDKs and tools in real-world scenarios.
🌐 CloudX Portal
Accesso centralizzato:
https://x-zdos.it

[GitHub Repository](https://github.com/bitrix24/b24sdk-examples). Find more details in the [documentation](https://bitrix24.github.io/b24ui/)
🧠 ZDOS Automations
Micro‑servizi e workflow:
https://x-zdos.it/zdos

## Application Templates
💳 DSN Wallet
Identità digitale e firma:
https://wallet.x-zdos.it

Ready-to-use application templates that can be deployed quickly using Docker. These templates provide a foundation for building custom business logic on top of Bitrix24.
---

### Automation rules library
🛠️ Comandi Git utili

[This project](https://github.com/bitrix24/app-template-automation-rules) is a fully deployable application template featuring a library of Bitrix24 automation rules. It’s designed to work both as a local solution and as a scalable application for the Bitrix24 Marketplace.
`bash
git add .
git commit -m "Update"
git push
`

You’re getting a complete package here: the frontend is built with the UI Kit and B24JsSDK, while the backend is set up so you can simply add your own automation rule implementations without having to dig into architectural complexities. No need to reinvent the wheel — just take the foundation and customize it to fit your needs.
Per creare un branch:
`bash
git checkout -b feature/nome-feature
`

## Documentation
---

- **b24restdocs**: The official repository for Bitrix24 REST API documentation, offering comprehensive guides and references for developers.
📄 Licenza
Distribuito sotto licenza MIT.

[GitHub Repository](https://github.com/bitrix24/b24restdocs). Read [online version](https://apidocs.bitrix24.com/)
---

## Additional Resources
🤝 Contributi
Pull request e fork sono benvenuti.
Per integrazioni avanzate con CloudX × ZDOS, contattare l’amministratore del progetto.

- **crest**: CRest is a minimalistic PHP library for calling Bitrix24 REST methods via webhooks and OAuth 2.0.
---

[GitHub Repository](https://github.com/bitrix-tools/crest)
🧬 Roadmap
- [ ] Modulo CRM potenziato
- [ ] Dashboard CloudX unificata
- [ ] DSN Smart Contract Registry
- [ ] Automazioni ZDOS integrate
- [ ] UI rinnovata in stile neon‑minimal

---

This hub aims to simplify navigation through Bitrix24's development tools, enabling you to build robust integrations and applications efficiently.
21 changes: 21 additions & 0 deletions SECURITY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# Security Policy

## Supported Versions

Use this section to tell people about which versions of your project are
currently being supported with security updates.

| Version | Supported |
| ------- | ------------------ |
| 5.1.x | :white_check_mark: |
| 5.0.x | :x: |
| 4.0.x | :white_check_mark: |
| < 4.0 | :x: |

## Reporting a Vulnerability

Use this section to tell people how to report a vulnerability.

Tell them where to go, how often they can expect to get an update on a
reported vulnerability, what to expect if the vulnerability is accepted or
declined, etc.
6 changes: 6 additions & 0 deletions business/onEvent.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
import { recordOnChain } from "../services/chainAdapter.js";

export async function onBusinessEvent(type, data) {
console.log("[BUSINESS EVENT]", type, data);
await recordOnChain(type, data);
}
8 changes: 8 additions & 0 deletions config/chain.config.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
export const CHAIN_CONFIG = {
enabled: true,
network: "polygon",
rpcUrl: "https://polygon-rpc.com",
explorerBase: "https://polygonscan.com/tx/",
dsnTokenAddress: "0xDSN_TOKEN_ADDRESS",
businessRegistryAddress: "0xBUSINESS_REGISTRY_ADDRESS"
};
Loading