diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..8ee99cf --- /dev/null +++ b/.env.example @@ -0,0 +1,8 @@ +APP_NAME=xCLOUD OS +APP_ENV=development +APP_URL=https://high-cde.github.io/xCLOUD-by-zdos/ +API_URL=http://localhost:8080 +DATABASE_URL=sqlite:///data/xcloud.db +LOG_LEVEL=info +AI_ENABLED=false +DSN_ENABLED=false diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml new file mode 100644 index 0000000..5cb8c53 --- /dev/null +++ b/.github/FUNDING.yml @@ -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. diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml new file mode 100644 index 0000000..5c64be3 --- /dev/null +++ b/.github/workflows/pages.yml @@ -0,0 +1,34 @@ +name: Deploy xCLOUD OS to GitHub Pages + +on: + push: + branches: [main] + workflow_dispatch: + +permissions: + contents: read + pages: write + id-token: write + +concurrency: + group: pages + cancel-in-progress: true + +jobs: + deploy: + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + - name: Configure Pages + uses: actions/configure-pages@v5 + - name: Upload static site + uses: actions/upload-pages-artifact@v3 + with: + path: . + - name: Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@v4 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..64e0108 --- /dev/null +++ b/.gitignore @@ -0,0 +1,10 @@ +.env +.env.* +!.env.example +*.log +.DS_Store +node_modules/ +coverage/ +.vscode/ +.idea/ +secrets/ diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 0000000..e69de29 diff --git a/BRANDING.md b/BRANDING.md new file mode 100644 index 0000000..8c1d975 --- /dev/null +++ b/BRANDING.md @@ -0,0 +1,3 @@ +xCLOUD by ZDOS +Business Layer · DSN Compatible +Integrato con CloudX Portal e DSN Wallet. diff --git a/CNAME b/CNAME new file mode 100644 index 0000000..8a68c91 --- /dev/null +++ b/CNAME @@ -0,0 +1 @@ +xcloud-zdos.it diff --git a/LICENSE b/LICENSE index e930362..fbb3cd2 100644 --- a/LICENSE +++ b/LICENSE @@ -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 diff --git a/README.md b/README.md index 3c7a88b..310ac3c 100644 --- a/README.md +++ b/README.md @@ -1,90 +1,110 @@ -Bitrix24 Developer Hub +# 🚀 xCLOUD Enterprise by 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. +![License](https://img.shields.io/badge/License-MIT-blue.svg) +![Status](https://img.shields.io/badge/Status-Active-brightgreen.svg) +![Made for ZDOS](https://img.shields.io/badge/Made%20for-ZDOS-orange.svg) -## 📚 Table of Contents +**xCLOUD Enterprise** è un fork avanzato del Bitrix24 Developer Hub, completamente rebrandizzato e ottimizzato per l'ecosistema **CloudX × ZDOS**. Questa soluzione enterprise-ready include un **DSN Layer**, **Portal Fusion**, **Nexus**, **Terminal** e pipeline di sviluppo avanzate, fornendo una piattaforma robusta per la gestione aziendale e l'innovazione tecnologica. -- [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) +Questa versione mantiene la compatibilità con l’architettura originale, ma introduce un approccio più modulare, pulito e orientato all’automazione, con un focus specifico sull'integrazione blockchain e l'intelligenza artificiale. -## 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) - -### JavaScript/Node.js SDK - -- **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. - - [GitHub Repository](https://github.com/bitrix24/b24jssdk). Find more details in the [documentation](https://bitrix24.github.io/b24jssdk/) - -### Python SDK - -- **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. - - [GitHub Repository](https://github.com/bitrix24/b24pysdk). - -## UI Tools - -### Bitrix24 UI Kit - -- **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. - - [GitHub Repository](https://github.com/bitrix24/b24ui). Find more details in the [documentation](https://bitrix24.github.io/b24ui/) +--- -### Design Tokens +## ✨ Caratteristiche Principali + +### 🔹 1. Compatibilità Estesa +* **CRM Completo**: Gestione clienti, vendite e marketing. +* **Gestione Attività e Progetti**: Strumenti avanzati per la pianificazione e il monitoraggio. +* **Collaborazione Integrata**: Calendari, gruppi di lavoro e pipeline personalizzabili. +* **Moduli Aziendali Standard**: Funzionalità essenziali per ogni tipo di business. + +### 🔹 2. Enterprise Hardening +* **Architettura Pulita**: Struttura logica dei moduli e configurazioni centralizzate. +* **Ottimizzazione CI/CD**: Miglioramenti per deployment continui e integrazione continua. +* **Sicurezza Avanzata**: Implementazione di best practice per la protezione dei dati. + +### 🔹 3. Integrazione CloudX × ZDOS +Questo fork è progettato per essere un componente chiave del tuo ecosistema: +* **CloudX Portal**: Accesso centralizzato e unificato. +* **ZDOS Automations**: Micro-servizi e workflow intelligenti. +* **DSN Wallet**: Identità digitale e firma elettronica. +* **xCLOUD Business Layer**: Strato modulare per le operazioni aziendali. + +### 🔹 4. Blockchain Ready (DSN) +Supporto opzionale per l'integrazione con tecnologie blockchain: +* **Registrazione Eventi On-Chain**: Tracciabilità immutabile delle operazioni. +* **Audit Trail Distribuito**: Garanzia di trasparenza e integrità dei dati. +* **Firma Digitale**: Autenticazione sicura delle transazioni. +* **Smart Contract Aziendali**: Integrazione con logiche di business decentralizzate. -- **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. +--- - [GitHub Repository](https://github.com/bitrix24/b24style). Find more details in the [documentation](https://bitrix24.github.io/b24style/) +## 🧩 Architettura -### Icons +La struttura del progetto è organizzata per facilitare lo sviluppo e la manutenzione: -- **b24icons**: The library contains SVG icons for use in the interfaces of both local and mass-market applications for Bitrix24. +``` +xCLOUD-enterprise/ +│ +├── core/ # Moduli principali di xCLOUD +├── modules/ # Estensioni e plugin personalizzati +├── cloudx/ # Integrazioni specifiche con CloudX +│ ├── dsn/ # Adapter per la blockchain DSN +│ └── zdos/ # Automazioni e hooks ZDOS +├── config/ # Configurazioni centralizzate del sistema +└── docs/ # Documentazione tecnica e guide +``` - [GitHub Repository](https://github.com/bitrix24/b24icons). Find more details in the [documentation](https://bitrix24.github.io/b24icons/) +--- -## Usage Examples +## ⚙️ Installazione -- **b24sdk-examples**: A collection of examples demonstrating the usage of various Bitrix24 SDKs and tools in real-world scenarios. +Per iniziare con xCLOUD Enterprise, segui questi passaggi: - [GitHub Repository](https://github.com/bitrix24/b24sdk-examples). Find more details in the [documentation](https://bitrix24.github.io/b24ui/) +1. **Clona il repository**: + ```bash + git clone https://github.com/high-cde/xCLOUD-enterprise.git + cd xCLOUD-enterprise + ``` -## Application Templates +2. **Installa le dipendenze**: + ```bash + composer install + npm install + ``` -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. +3. **Configura l’ambiente**: + ```bash + cp .env.example .env + ``` + Modifica il file `.env` con i parametri necessari (database, URL, configurazioni DSN blockchain opzionali). -### Automation rules library +--- -[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. +## 🔗 Integrazioni Ecosistema ZDOS -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. +* **🌐 CloudX Portal**: Accesso centralizzato: [https://x-zdos.it](https://x-zdos.it) +* **🧠 ZDOS Automations**: Micro-servizi e workflow intelligenti: [https://x-zdos.it/zdos](https://x-zdos.it/zdos) +* **💳 DSN Wallet**: Identità digitale e firma: [https://wallet.x-zdos.it](https://wallet.x-zdos.it) -## Documentation +--- -- **b24restdocs**: The official repository for Bitrix24 REST API documentation, offering comprehensive guides and references for developers. +## 🤝 Contributi - [GitHub Repository](https://github.com/bitrix24/b24restdocs). Read [online version](https://apidocs.bitrix24.com/) +Pull request e fork sono benvenuti. Per integrazioni avanzate con CloudX × ZDOS, si prega di contattare l’amministratore del progetto. -## Additional Resources +--- -- **crest**: CRest is a minimalistic PHP library for calling Bitrix24 REST methods via webhooks and OAuth 2.0. +## 📄 Licenza - [GitHub Repository](https://github.com/bitrix-tools/crest) +Distribuito sotto licenza MIT. Vedi il file `LICENSE` per maggiori dettagli. --- -This hub aims to simplify navigation through Bitrix24's development tools, enabling you to build robust integrations and applications efficiently. +## 🧬 Roadmap + +* [ ] Modulo CRM potenziato +* [ ] Dashboard CloudX unificata +* [ ] DSN Smart Contract Registry +* [ ] Automazioni ZDOS integrate +* [ ] UI rinnovata in stile neon-minimal diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 0000000..034e848 --- /dev/null +++ b/SECURITY.md @@ -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. diff --git a/api/openapi.yaml b/api/openapi.yaml new file mode 100644 index 0000000..af2afe0 --- /dev/null +++ b/api/openapi.yaml @@ -0,0 +1,44 @@ +openapi: 3.0.3 +info: + title: xCLOUD OS Foundation API + version: 0.1.0 + description: Contract iniziale per workspace, missioni ed eventi aziendali. +paths: + /health: + get: + summary: Stato del servizio + responses: + '200': + description: Servizio disponibile + /api/v1/workspaces/{workspaceId}/missions: + get: + summary: Elenca le missioni del workspace + parameters: + - name: workspaceId + in: path + required: true + schema: {type: string} + responses: + '200': {description: Lista missioni} + '401': {description: Non autenticato} + /api/v1/workspaces/{workspaceId}/events: + post: + summary: Registra un evento operativo + parameters: + - name: workspaceId + in: path + required: true + schema: {type: string} + requestBody: + required: true + content: + application/json: + schema: + type: object + required: [event_type] + properties: + event_type: {type: string} + payload: {type: object} + responses: + '201': {description: Evento registrato} + '401': {description: Non autenticato} diff --git a/business/onEvent.js b/business/onEvent.js new file mode 100644 index 0000000..21b8e59 --- /dev/null +++ b/business/onEvent.js @@ -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); +} diff --git a/config/app.example.json b/config/app.example.json new file mode 100644 index 0000000..e5a7e7e --- /dev/null +++ b/config/app.example.json @@ -0,0 +1,21 @@ +{ + "name": "xCLOUD OS", + "version": "0.1.0", + "environment": "development", + "features": { + "missionControl": true, + "enterpriseGraph": true, + "crm": false, + "projects": false, + "finance": false, + "aiAgents": false, + "automations": false, + "enterpriseMemory": false, + "dsnTrustLayer": false + }, + "security": { + "requireAuthentication": true, + "auditLog": true, + "defaultRole": "viewer" + } +} diff --git a/config/chain.config.js b/config/chain.config.js new file mode 100644 index 0000000..fa17eb2 --- /dev/null +++ b/config/chain.config.js @@ -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" +}; diff --git a/database/schema.sql b/database/schema.sql new file mode 100644 index 0000000..fe1e619 --- /dev/null +++ b/database/schema.sql @@ -0,0 +1,41 @@ +-- xCLOUD OS minimal domain model: portable SQLite/PostgreSQL style +CREATE TABLE IF NOT EXISTS workspaces ( + id TEXT PRIMARY KEY, + name TEXT NOT NULL, + slug TEXT NOT NULL UNIQUE, + created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP +); + +CREATE TABLE IF NOT EXISTS users ( + id TEXT PRIMARY KEY, + workspace_id TEXT NOT NULL REFERENCES workspaces(id), + email TEXT NOT NULL, + display_name TEXT NOT NULL, + role TEXT NOT NULL DEFAULT 'viewer', + created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP, + UNIQUE(workspace_id, email) +); + +CREATE TABLE IF NOT EXISTS missions ( + id TEXT PRIMARY KEY, + workspace_id TEXT NOT NULL REFERENCES workspaces(id), + title TEXT NOT NULL, + domain TEXT NOT NULL, + status TEXT NOT NULL DEFAULT 'planned', + progress INTEGER NOT NULL DEFAULT 0 CHECK(progress BETWEEN 0 AND 100), + owner_id TEXT REFERENCES users(id), + created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP +); + +CREATE TABLE IF NOT EXISTS events ( + id TEXT PRIMARY KEY, + workspace_id TEXT NOT NULL REFERENCES workspaces(id), + event_type TEXT NOT NULL, + actor_id TEXT REFERENCES users(id), + payload_json TEXT NOT NULL DEFAULT '{}', + created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP +); + +CREATE INDEX IF NOT EXISTS idx_missions_workspace ON missions(workspace_id); +CREATE INDEX IF NOT EXISTS idx_events_workspace_time ON events(workspace_id, created_at); diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md new file mode 100644 index 0000000..48b7ad2 --- /dev/null +++ b/docs/ARCHITECTURE.md @@ -0,0 +1,13 @@ +# xCLOUD OS — Architettura fondativa + +## Principio + +xCLOUD OS è organizzato attorno a workspace multi-tenant, oggetti aziendali, eventi immutabili e missioni operative. L’interfaccia pubblica attuale è una demo statica; questo documento definisce il percorso verso un backend reale senza vincolare lo stack. + +## Confini MVP + +La prima release applicativa deve implementare autenticazione, workspace, ruoli, missioni, eventi, audit log e health check. Gli agenti AI, la blockchain DSN e le integrazioni esterne restano disattivati finché non esistono permessi, logging, test e budget operativo. + +## Regole + +Ogni richiesta deve avere un workspace esplicito. Ogni modifica rilevante deve produrre un evento. Nessun segreto deve essere versionato. Le azioni distruttive devono richiedere autorizzazione esplicita. Le feature sperimentali devono essere protette da flag. diff --git a/docs/OVERVIEW.md b/docs/OVERVIEW.md new file mode 100644 index 0000000..e483362 --- /dev/null +++ b/docs/OVERVIEW.md @@ -0,0 +1,34 @@ +# Overview tecnica: Xcloud By ZDOS + +## Scopo + +xCLOUD Enterprise — Fork evoluto del Bitrix24 Developer Hub, completamente rebrandizzato e ottimizzato per l’ecosistema CloudX × ZDOS. Include DSN Layer, Portal Fusion, Nexus, Terminal e pipeline enterprise-ready. Questa overview definisce il contesto operativo del repository, il suo ruolo nell'ecosistema e le convenzioni minime da seguire durante l'evoluzione del progetto. + +## Contesto architetturale + +Il repository è collegato alla visione **ZDOS / Z-GENESIS**, dove ogni componente dovrebbe avere un ruolo esplicito, dipendenze documentate e una superficie operativa comprensibile. La priorità è mantenere il progetto semplice da analizzare, sicuro da estendere e coerente con gli altri moduli. + +| Dimensione | Indicazione | +|---|---| +| Identità | `high-cde/xCLOUD-by-zdos` | +| Tecnologia principale | Shell/Linux | +| Stato repository | Fork | +| Visibilità | PUBLIC | + +## Convenzioni operative + +Ogni modifica dovrebbe essere piccola, tracciabile e accompagnata da una nota nel README o nella wiki quando introduce nuove funzionalità. Le configurazioni sensibili non devono essere versionate; per credenziali e token è necessario usare variabili d'ambiente o secret manager. + +## Qualità e manutenzione + +Il progetto dovrebbe evolvere verso una struttura con test automatici, controlli statici e changelog. Quando possibile, le decisioni architetturali importanti dovrebbero essere annotate nella wiki o in file `docs/ADR-*.md`. + +## Prossimi passi consigliati + +| Priorità | Azione | +|---|---| +| Alta | Verificare dipendenze, script di avvio e prerequisiti reali. | +| Alta | Definire o confermare la licenza del repository. | +| Media | Aggiungere esempi minimi di utilizzo o screenshot quando applicabile. | +| Media | Integrare test, lint e workflow CI. | +| Bassa | Pubblicare una roadmap con milestone e tag di release. | diff --git a/docs/ROADMAP_MVP.md b/docs/ROADMAP_MVP.md new file mode 100644 index 0000000..1b57880 --- /dev/null +++ b/docs/ROADMAP_MVP.md @@ -0,0 +1,21 @@ +# Roadmap MVP a costo minimo + +## Fase 0 — Fondazioni + +Repository, configurazione, schema dati, contratto API, baseline sicurezza, audit e CI. + +## Fase 1 — Core operativo + +Autenticazione, workspace, ruoli, CRUD missioni, eventi e audit log. + +## Fase 2 — Prodotto utile + +Enterprise Graph, CRM essenziale, dashboard con dati reali, notifiche e importazione CSV. + +## Fase 3 — Automazione controllata + +Workflow visuali, webhook, job queue, retry e approvazioni. + +## Fase 4 — Intelligence opzionale + +Agenti AI con budget, rate limit, approvazioni, tracciamento dei prompt e possibilità di disattivazione. diff --git a/docs/wiki/Architecture.md b/docs/wiki/Architecture.md new file mode 100644 index 0000000..fd5a5c0 --- /dev/null +++ b/docs/wiki/Architecture.md @@ -0,0 +1,18 @@ +# Architettura + +## Ruolo del repository + +xCLOUD Enterprise — Fork evoluto del Bitrix24 Developer Hub, completamente rebrandizzato e ottimizzato per l’ecosistema CloudX × ZDOS. Include DSN Layer, Portal Fusion, Nexus, Terminal e pipeline enterprise-ready. + +Il repository deve essere mantenuto come modulo comprensibile e tracciabile dell'ecosistema ZDOS / Z-GENESIS. Ogni componente dovrebbe avere responsabilità esplicite, confini chiari e dipendenze documentate. + +| Area | Descrizione | +|---|---| +| Identità | `high-cde/xCLOUD-by-zdos` | +| Tecnologia principale | Shell/Linux | +| Tipo | Fork | +| Visibilità | PUBLIC | + +## Principi + +La progettazione privilegia modularità, leggibilità e sicurezza operativa. I componenti sperimentali devono essere isolati, documentati e testati prima dell'uso in ambienti condivisi. diff --git a/docs/wiki/Home.md b/docs/wiki/Home.md new file mode 100644 index 0000000..0bf2200 --- /dev/null +++ b/docs/wiki/Home.md @@ -0,0 +1,17 @@ +# Xcloud By ZDOS + +Benvenuto nella wiki di **xCLOUD-by-zdos**. + +xCLOUD Enterprise — Fork evoluto del Bitrix24 Developer Hub, completamente rebrandizzato e ottimizzato per l’ecosistema CloudX × ZDOS. Include DSN Layer, Portal Fusion, Nexus, Terminal e pipeline enterprise-ready. + +## Indice + +| Pagina | Contenuto | +|---|---| +| [Architettura](Architecture) | Ruolo del repository, componenti e responsabilità. | +| [Guida operativa](Operations) | Avvio, manutenzione e controlli consigliati. | +| [Roadmap](Roadmap) | Evoluzione prevista e priorità. | + +## Stato della documentazione + +Questa wiki inizializza la base documentale del repository e fornisce un punto di partenza per futuri approfondimenti tecnici. diff --git a/docs/wiki/Operations.md b/docs/wiki/Operations.md new file mode 100644 index 0000000..22891a4 --- /dev/null +++ b/docs/wiki/Operations.md @@ -0,0 +1,18 @@ +# Guida operativa + +## Avvio + +Clona il repository e consulta il README per i comandi più adatti alla tecnologia rilevata. Prima dell'esecuzione, verifica sempre dipendenze, permessi e configurazioni locali. + +## Manutenzione + +| Attività | Frequenza consigliata | +|---|---| +| Verifica dipendenze | A ogni modifica significativa. | +| Aggiornamento documentazione | A ogni feature o cambio architetturale. | +| Controllo segreti | Prima di ogni push. | +| Revisione roadmap | Periodicamente, in base all'evoluzione del progetto. | + +## Sicurezza + +Non eseguire automazioni su sistemi non autorizzati. Conserva credenziali e token fuori dal repository e usa ambienti isolati per testare script sperimentali. diff --git a/docs/wiki/Roadmap.md b/docs/wiki/Roadmap.md new file mode 100644 index 0000000..591df24 --- /dev/null +++ b/docs/wiki/Roadmap.md @@ -0,0 +1,15 @@ +# Roadmap + +## Priorità + +| Priorità | Azione | Esito atteso | +|---|---|---| +| Alta | Consolidare README e wiki | Onboarding più chiaro. | +| Alta | Definire licenza e policy | Uso e contributi più sicuri. | +| Media | Aggiungere esempi e test | Maggiore affidabilità. | +| Media | Introdurre changelog | Tracciabilità delle release. | +| Bassa | Pubblicare diagrammi e ADR | Migliore governance tecnica. | + +## Nota + +La roadmap è intenzionalmente modulare: deve essere aggiornata quando il repository assume una direzione tecnica più specifica o raggiunge milestone concrete. diff --git a/index.html b/index.html new file mode 100644 index 0000000..4199ca1 --- /dev/null +++ b/index.html @@ -0,0 +1,10 @@ + + + +xCLOUD OS — Mission Control + + +
AC
Martedì, 2 settembre 2026 · Executive view

Buongiorno, Alessandro.

Il tuo sistema operativo aziendale ha elaborato 1.284 eventi. Qui trovi ciò che richiede attenzione, decisione o azione.

Salute operativaLive
92/100 +6,4%
Nessuna criticità bloccante rilevata

ZDOS Ecosystem

Surfaces collegate · verificabili
Ricavi previsti
€ 248.6K+18,2% vs mese scorso
Opportunità attive
478 ad alta probabilità
Cash flow · 30 giorni
€ 86.4KSopra la previsione
Ore automatizzate
184h+31,5% questo mese

Segnali da esaminare

4 nuovi · ordinati per impatto
!
Progetto Atlas in ritardo di 4 giorni

Delta non ha confermato la consegna. Impatto stimato: €18.000.

Rischio alto
Opportunità da €42.000 non contattata

Acme Industries ha consultato 6 documenti di offerta in 48 ore.

Azione consigliata
Automazione completata con successo

Il flusso di onboarding ha liberato 12,5 ore questa settimana.

Impatto positivo

Agenti xCLOUD

7 online
S
Sales AgentQualifica 12 nuovi lead
● Attivo
O
Operations AgentMonitora 8 progetti
● Attivo
F
Finance AgentForecast liquidità aggiornato
● Attivo
K
Knowledge AgentMemoria sincronizzata 2m fa
● Attivo

Missioni in esecuzione

Vedi registro completo →
COMMERCIALE72%

Recupero clienti inattivi

Sales Agent12/16 clienti
OPERATIONS48%

Onboarding Acme Industries

Operations AgentFase 3/6
FINANZA91%

Chiusura forecast Q3

Finance AgentRevisione finale
AI
xCLOUD Brain ha aggiornato la priorità di 3 missioni · 6 minuti fa
diff --git a/scripts/healthcheck.sh b/scripts/healthcheck.sh new file mode 100755 index 0000000..b3fba19 --- /dev/null +++ b/scripts/healthcheck.sh @@ -0,0 +1,10 @@ +#!/usr/bin/env bash +set -euo pipefail +ROOT="$(cd "$(dirname "$0")/.." && pwd)" +test -s "$ROOT/index.html" +test -s "$ROOT/.github/workflows/pages.yml" +test -s "$ROOT/database/schema.sql" +test -s "$ROOT/api/openapi.yaml" +grep -q 'xCLOUD OS' "$ROOT/index.html" +grep -q 'missionControl' "$ROOT/config/app.example.json" +printf 'xCLOUD OS foundation: OK\n' diff --git a/security/SECURITY_BASELINE.md b/security/SECURITY_BASELINE.md new file mode 100644 index 0000000..1b8485d --- /dev/null +++ b/security/SECURITY_BASELINE.md @@ -0,0 +1,10 @@ +# Security baseline + +1. Non salvare token o password nel repository. +2. Usare variabili d’ambiente o un secret manager. +3. Applicare ruoli minimi: viewer, member, manager, admin. +4. Registrare login, accessi, modifiche e azioni distruttive nell’audit log. +5. Validare input e payload JSON lato server. +6. Limitare CORS, rate limit e dimensione delle richieste. +7. Eseguire backup prima delle migrazioni. +8. Disattivare AI e DSN finché non sono configurati permessi, costi e retention. diff --git a/services/chainAdapter.js b/services/chainAdapter.js new file mode 100644 index 0000000..875a20d --- /dev/null +++ b/services/chainAdapter.js @@ -0,0 +1,11 @@ +import { CHAIN_CONFIG } from "../config/chain.config.js"; + +export async function recordOnChain(eventType, payload) { + if (!CHAIN_CONFIG.enabled) return; + console.log("[CHAIN EVENT]", eventType, payload); + + // Hook futuro: + // - firma lato wallet + // - invio a smart contract + // - relay opzionale +} diff --git a/tests/smoke.sh b/tests/smoke.sh new file mode 100755 index 0000000..096c2ea --- /dev/null +++ b/tests/smoke.sh @@ -0,0 +1,8 @@ +#!/usr/bin/env bash +set -euo pipefail +ROOT="$(cd "$(dirname "$0")/.." && pwd)" +"$ROOT/scripts/healthcheck.sh" +if command -v git >/dev/null 2>&1; then + git -C "$ROOT" diff --check +fi +printf 'Smoke tests: OK\n' diff --git a/update.sh b/update.sh new file mode 100755 index 0000000..b1a4e17 --- /dev/null +++ b/update.sh @@ -0,0 +1,6 @@ +cat > index.html << 'EOT' +xCLOUD · CloudX Portal · Enterprise Premium