Introduction

Welcome to the IoT TeckFuture (SensoCAN) documentation. This platform is a comprehensive IoT solution designed for multi-tenant device management, data visualization, and automated rule processing.

Platform Architecture

SensoCAN is built on a robust, scalable architecture enabling real-time data processing and long-term storage.

• Multi-Tenancy: Built from the ground up to support multiple tenants (Organizations), each with their own isolated data, users, and devices.
• Time-Series Data: Utilizes TimescaleDB for high-performance storage and retrieval of sensor metrics.
• Real-Time Processing: Integrates with MQTT brokers for instant data ingestion and WebSockets (Reverb/Pusher) for live dashboard updates.
• Rule Engine: A flexible, node-based rule engine allows for complex logic to be applied to incoming data streams (e.g., "If Temperature > 50 AND Previous < 50, Send Alert").

Key Concepts

🏢 Tenants

A Tenant represents an organization or customer entity. All data (Devices, Users, Dashboards) is scooped to a Tenant.

• Plans: Tenants are assigned subscription plans that dictate their resource limits (User count, Device count, SMS quota, etc.).

📱 Devices & Sensors

• Device: Physical hardware (e.g., a GPS Tracker, Weather Station).
• Sensor: A specific data point on a device (e.g., "Temperature", "Battery Voltage"). Devices can have multiple sensors.
• Device Groups: Logical grouping of devices for easier management and visualization (e.g., "North Warehouse", "Truck Fleet A").

⚡ Rule Chains

The "brain" of the automation system. Rule Chains are visual flows that process incoming telemetry.

• Filters: Check conditions (e.g., "Is battery low?", "Is it weekend?").
• Actions: Perform tasks (e.g., "Send Email", "Log to Database", "Trigger Webhook").

🤖 AI Assistant

A conversational interface that lets you interact with your IoT infrastructure using natural language.

• Real-Time Insights: Ask about device status, sensor readings, and alerts instantly.
• Multi-Platform: Available in the web dashboard, Slack, and Microsoft Teams.
• Manager Analytics: Get fleet overviews, notification stats, and system health reports.

User Roles

The platform uses a strict Role-Based Access Control (RBAC) system:

Role	Scope	Description
Super Admin	System-Wide	Manages Tenants, Plans, and System Configuration. Can access Horizon (Queues) and Telescope (Debug).
Tenant Admin	Single Tenant	Full control over their organization's devices, users, and rules.
Manager	Single Tenant	Can manage devices and rules but has limited user management capabilities.
User	Single Tenant	Read-only access to dashboards and device status.
Consultant	Multi-Tenant	Special role for external auditors/analysts who need read-access across specific multiple tenants.

Getting Started

• For Users: Learn how to manage devices, sensors, and rule chains.
• For Developers: Learn how to connect devices, configure dashboards, and set up alerts.