cassandra-expert
π―Skillfrom vx-daniel/tb-docs-project
Analyzes and generates detailed documentation about Cassandra database configuration, schema design, and integration patterns within the ThingsBoard IoT platform's data persistence layer.
Installation
npx skills add https://github.com/vx-daniel/tb-docs-project --skill cassandra-expertSkill Details
Overview
# ThingsBoard Documentation Project
Internal technical documentation for the ThingsBoard IoT platform, derived from source code analysis. This documentation serves as a comprehensive guide for developers to understand, extend, and maintain ThingsBoard deployments.
Overview
```
tb-docs-project/
βββ docs/ # 115 markdown documentation files
βββ ref/
β βββ thingsboard-master/ # ThingsBoard platform source code
β βββ thingsboard.github.io-master/ # Official documentation source
βββ .claude/skills/ # 38 Claude Code skills for development
βββ CLAUDE.md # AI assistant instructions
```
Documentation Structure
The documentation is organized into 18 sections for logical progression from architecture to deployment:
| # | Section | Description | Files |
|---|---------|-------------|-------|
| 01 | [Architecture](docs/01-architecture/) | System design, topology, multi-tenancy | 3 |
| 02 | [Core Concepts](docs/02-core-concepts/) | Entities, data models, identity, provisioning, OTA, profiles | 13 |
| 03 | [Actor System](docs/03-actor-system/) | Concurrency, message-driven architecture | 4 |
| 04 | [Rule Engine](docs/04-rule-engine/) | Processing pipelines, node types, TBEL, queues, analytics | 14 |
| 05 | [Transport Layer](docs/05-transport-layer/) | Device protocols (MQTT, CoAP, HTTP, LwM2M, SNMP) | 9 |
| 06 | [API Layer](docs/06-api-layer/) | REST, WebSocket, RPC, alarms, notifications | 9 |
| 07 | [Data Persistence](docs/07-data-persistence/) | PostgreSQL, Cassandra, TimescaleDB, caching | 8 |
| 08 | [Message Queue](docs/08-message-queue/) | Kafka configuration, partitioning | 4 |
| 09 | [Security](docs/09-security/) | Authentication, authorization, rate limiting | 4 |
| 10 | [Frontend](docs/10-frontend/) | Angular architecture, widget system | 2 |
| 11 | [Microservices](docs/11-microservices/) | Service types, EDQS, JS Executor | 7 |
| 12 | [Edge](docs/12-edge/) | Edge computing, cloud sync | 4 |
| 13 | [IoT Gateway](docs/13-iot-gateway/) | Gateway architecture, protocol connectors | 3 |
| 14 | [Integrations](docs/14-integrations/) | Cloud, LoRaWAN, messaging platforms | 4 |
| 15 | [TBMQ](docs/15-tbmq/) | MQTT broker architecture | 3 |
| 16 | [Trendz](docs/16-trendz/) | Analytics, visualizations, predictions | 4 |
| 17 | [Mobile App](docs/17-mobile-app/) | Flutter app, customization | 3 |
| 18 | [Deployment](docs/18-deployment/) | Installation, configuration, monitoring | 4 |
Quick Start
Reading the Documentation
Start with these key documents based on your role:
For Platform Understanding:
- [Architecture Overview](docs/01-architecture/system-overview.md) - High-level system design
- [Multi-Tenancy](docs/01-architecture/multi-tenancy.md) - Tenant isolation model
- [Data Model](docs/02-core-concepts/data-model/) - Entity relationships
For Device Development:
- [Device Provisioning](docs/02-core-concepts/device-provisioning.md) - How devices join
- [Transport Layer](docs/05-transport-layer/) - MQTT, CoAP, HTTP protocols
- [Device API](docs/06-api-layer/device-api.md) - Telemetry and RPC
For Backend Development:
- [Rule Engine](docs/04-rule-engine/) - Data processing pipelines
- [Actor System](docs/03-actor-system/) - Concurrency model
- [Data Persistence](docs/07-data-persistence/) - Database configuration
For Operations:
- [Deployment](docs/18-deployment/) - Installation guides
- [Security](docs/09-security/) - Authentication and rate limiting
- [Hybrid Storage](docs/07-data-persistence/hybrid-storage.md) - Scaling decisions
Glossary
See [GLOSSARY.md](docs/GLOSSARY.md) for comprehensive terminology with Mermaid diagrams showing concept relationships.
Technology Stack
ThingsBoard Platform
| Component | Technology |
|-----------|------------|
| Backend | Java 17, Spring Boot 3.4.10 |
| Frontend | Angular 18.2.13, Angular Material |
| Message Queue | Kafka 3.9.1 |
| Databases | PostgreSQL, Cassandra, TimescaleDB |
| Prot
More from this repository5
Analyzes and generates detailed documentation for MQTT transport layer implementation, protocol specifics, and configuration patterns in ThingsBoard's IoT platform.
Automatically generates comprehensive configuration reference documentation by extracting and parsing configuration parameters and metadata from ThingsBoard's source code and configuration files.
Generates and validates GitLab CI/CD pipeline configurations for ThingsBoard project, ensuring best practices, syntax correctness, and optimal continuous integration workflow design.
Analyzes and extracts ThingsBoard log and performance metrics from ELK (Elasticsearch, Logstash, Kibana) stack to generate structured documentation insights about system behavior and performance ch...
Generates, validates, and provides expert-level guidance on JWT (JSON Web Token) implementation, configuration, and security best practices specifically for ThingsBoard's authentication and authori...