Andreas Hilbig
a01bfabfba
This commit upgrades the project to Node.js 24 (LTS) and performs a major refactoring of the documentation to support both advanced users and AI-based automation (MCP). Changes: - Environment & CI/CD: - Set Node.js version to >=24 in package.json and .nvmrc. - Updated Dockerfile to use Node 24 base image. - Updated @types/node to ^24.10.9. - Documentation: - Refactored README.md with comprehensive technical reference, configuration details, and Zabbix-to-GraphQL mapping. - Created docs/howtos/cookbook.md with practical recipes for common tasks and AI test generation. - Updated docs/howtos/mcp.md to emphasize GraphQL's advantages for AI agents and Model Context Protocol. - Added readme.improvement.plan.md to track documentation evolution. - Enhanced all how-to guides with improved cross-references and up-to-date information. - Guidelines: - Updated .junie/guidelines.md with Node 24 requirements and enhanced commit message standards (Conventional Commits 1.0.0). - Infrastructure & Code: - Updated docker-compose.yml with Apollo MCP server integration. - Refined configuration and schema handling in src/api/ and src/datasources/. - Synchronized generated TypeScript types with schema updates.
27 lines
1.3 KiB
Markdown
27 lines
1.3 KiB
Markdown
# How-To Guides
|
|
|
|
This directory contains detailed guides on how to use and extend the Zabbix GraphQL API.
|
|
|
|
## Available Guides
|
|
|
|
### 🍳 [Cookbook](./cookbook.md)
|
|
Practical, step-by-step recipes for common tasks, designed for both humans and AI-based test generation.
|
|
|
|
### 📊 [Schema and Schema Extension](./schema.md)
|
|
Learn about the GraphQL schema structure, how Zabbix entities map to GraphQL types, and how to use the dynamic schema extension system.
|
|
|
|
### 🗂️ [Hierarchical Data Mapping](./hierarchical_data_mapping.md)
|
|
Understand how the API automatically maps flat Zabbix item keys into nested GraphQL objects using hierarchical resolvers and type hinting.
|
|
|
|
### 🔐 [Roles and Permissions Extension](./permissions.md)
|
|
Discover how the permission system works, how to define permission levels using Zabbix template groups, and how to query user permissions.
|
|
|
|
### 🏷️ [Zabbix Tags Usage](./tags.md)
|
|
Learn how Zabbix tags are used for device classification, host categorization, and as metadata within the GraphQL API.
|
|
|
|
### 🤖 [MCP & Agent Integration](./mcp.md)
|
|
Discover how to integrate the Zabbix GraphQL API with the Model Context Protocol (MCP) to enable LLMs and autonomous agents to interact with your Zabbix data efficiently.
|
|
|
|
---
|
|
|
|
For practical examples of GraphQL operations, check the [Sample Queries](../queries/) directory.
|