server-development

Develop and extend the God-Kaiser server for ESP32 IoT orchestration.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Auto-one-Family/Automation-One --skill server-development
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: server-development
Source: https://github.com/Auto-one-Family/Automation-One/tree/main/.claude/skills/server-development
Command: npx skills add https://github.com/Auto-one-Family/Automation-One --skill server-development

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralizes and streamlines development of the God‑Kaiser server for ESP32-based IoT networks so that device logic, safety checks, data processing, and automation rules are implemented server-side instead of on constrained devices. It reduces duplication, enforces safety validation before actuator commands, and provides clear patterns for adding MQTT handlers, REST endpoints, database models, and integration tests.

Core Features & Use Cases

  • Service & API Expansion: Guidance to add new FastAPI routers, Pydantic schemas, DI-based services, and repository-backed business logic.
  • MQTT & Handlers: Instructions to implement and register MQTT topics, subscriber handlers, and publisher flows for sensor and actuator messages.
  • Database & Migrations: Patterns for SQLAlchemy models, repository queries, and Alembic migrations while preserving unique constraints and retention policies.
  • Safety, Simulation & Testing: How to use SafetyService validations, SimulationScheduler and Mock-ESP flows, and pytest integration to verify production behavior.
  • Use Case: Add a new sensor type with a processing library, persist readings, expose REST endpoints, and create logic rules that trigger actuator sequences with safety gating.

Quick Start

Ask the skill to add a new FastAPI endpoint that registers an ESP device with validation, repository usage, an Alembic migration, and a corresponding integration test.

Frequently Asked Questions about server-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new REST endpoint to a FastAPI service with SQLAlchemy and Alembic migrations?

To add a FastAPI REST endpoint, define a Pydantic schema, implement a dependency-injected service with repository-backed business logic, create a corresponding SQLAlchemy model, and generate an Alembic migration to preserve database integrity.

How do I implement MQTT handlers for ESP32 sensor processing and actuator control?

Implement MQTT handlers by registering subscriber topics for sensor messages and publisher flows for actuator commands, processing the data server-side to offload logic from constrained ESP32 IoT devices.

How does server-side safety validation work before sending actuator commands?

Safety validation uses a SafetyService to gate actuator sequences, ensuring that automation rules and commands pass runtime safety checks before execution to preserve operational safety.

Can I use pytest integration tests to verify FastAPI and MQTT automation logic?

Yes, you can write pytest integration tests alongside SimulationScheduler and Mock-ESP flows to verify production behavior for newly added services, REST endpoints, and MQTT handlers.

What is the best way to add a new sensor type to an IoT server with database persistence?

Add a new sensor type by creating a processing library, persisting readings via SQLAlchemy repository queries, exposing REST endpoints, and defining automation rules that trigger actuator sequences with safety gating.

When do I need Alembic migrations for SQLAlchemy models in IoT server development?

You need Alembic migrations whenever adding or modifying SQLAlchemy models to preserve unique constraints and retention policies while ensuring database integrity during server-side IoT orchestration expansion.