Andreas Hilbig
91a1523d71
This commit finalizes the documentation improvement plan by: - Centralizing reference material in README.md. - Creating a dedicated Technical Maintenance guide (docs/howtos/maintenance.md). - Creating a categorized Sample Queries & Mutations overview (docs/queries/README.md). - Eliminating redundant information across the doc set (DRY principle). - Optimizing cross-references between reference documentation and the Cookbook. - Updating the improvement plan to reflect all tasks as completed.
478 lines
No EOL
37 KiB
XML
478 lines
No EOL
37 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<project version="4">
|
|
<component name="AutoImportSettings">
|
|
<option name="autoReloadType" value="SELECTIVE" />
|
|
</component>
|
|
<component name="ChangeListManager">
|
|
<list default="true" id="d7a71994-2699-4ae4-9fd2-ee13b7f33d35" name="Changes" comment="docs: refactor documentation and upgrade to Node.js 24 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.">
|
|
<change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
|
|
<change beforePath="$PROJECT_DIR$/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/README.md" afterDir="false" />
|
|
</list>
|
|
<option name="SHOW_DIALOG" value="false" />
|
|
<option name="HIGHLIGHT_CONFLICTS" value="true" />
|
|
<option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
|
|
<option name="LAST_RESOLUTION" value="IGNORE" />
|
|
</component>
|
|
<component name="ComposerSettings">
|
|
<execution />
|
|
</component>
|
|
<component name="EmbeddingIndexingInfo">
|
|
<option name="cachedIndexableFilesCount" value="109" />
|
|
<option name="fileBasedEmbeddingIndicesEnabled" value="true" />
|
|
</component>
|
|
<component name="Git.Settings">
|
|
<option name="RECENT_BRANCH_BY_REPOSITORY">
|
|
<map>
|
|
<entry key="$PROJECT_DIR$" value="license" />
|
|
</map>
|
|
</option>
|
|
<option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
|
|
<option name="RESET_MODE" value="HARD" />
|
|
<option name="SWAP_SIDES_IN_COMPARE_BRANCHES" value="true" />
|
|
<option name="UPDATE_TYPE" value="REBASE" />
|
|
</component>
|
|
<component name="GitRewordedCommitMessages">
|
|
<option name="commitMessagesMapping">
|
|
<RewordedCommitMessageMapping>
|
|
<option name="originalMessage" value="docs: explain how to override HOST_GROUP_FILTER_DEFAULT and use wildcards - Added documentation on overriding 'HOST_GROUP_FILTER_DEFAULT' by explicitly setting the 'search_name' argument in the 'allHostGroups' query. - Explained the usage of the '*' wildcard in 'search_name' with a concrete example for subgroup matching." />
|
|
<option name="rewordedMessage" value="chore: add default filters for host and host group queries - Introduced `HOST_TYPE_FILTER_DEFAULT` and `HOST_GROUP_FILTER_DEFAULT` constants in the `Config` class. - Updated resolvers to use these defaults when `tag_hostType` or `search_name` arguments are not provided. - Added corresponding tests to verify default behavior in host and host group queries. - Added documentation on overriding 'HOST_GROUP_FILTER_DEFAULT' by explicitly setting the 'search_name' argument in the 'allHostGroups' query. - Explained the usage of the '*' wildcard in 'search_name' with a concrete example for subgroup matching." />
|
|
</RewordedCommitMessageMapping>
|
|
</option>
|
|
<option name="currentCommit" value="1" />
|
|
<option name="onto" value="2a8ff989f34d19353d1617393f4dec249971ef74" />
|
|
</component>
|
|
<component name="McpProjectServerCommands">
|
|
<commands />
|
|
<urls />
|
|
</component>
|
|
<component name="ProblemsViewState">
|
|
<option name="selectedTabId" value="CurrentFile" />
|
|
</component>
|
|
<component name="ProjectColorInfo">{
|
|
"associatedIndex": 2
|
|
}</component>
|
|
<component name="ProjectId" id="38BVb3VzSAGgMQsmn4rSydxQ56L" />
|
|
<component name="ProjectViewState">
|
|
<option name="autoscrollFromSource" value="true" />
|
|
<option name="autoscrollToSource" value="true" />
|
|
<option name="hideEmptyMiddlePackages" value="true" />
|
|
<option name="openDirectoriesWithSingleClick" value="true" />
|
|
<option name="showLibraryContents" value="true" />
|
|
</component>
|
|
<component name="PropertiesComponent">{
|
|
"keyToString": {
|
|
"NIXITCH_NIXPKGS_CONFIG": "",
|
|
"NIXITCH_NIX_CONF_DIR": "",
|
|
"NIXITCH_NIX_OTHER_STORES": "",
|
|
"NIXITCH_NIX_PATH": "",
|
|
"NIXITCH_NIX_PROFILES": "",
|
|
"NIXITCH_NIX_REMOTE": "",
|
|
"NIXITCH_NIX_USER_PROFILE_DIR": "",
|
|
"Node.js.index.ts.executor": "Run",
|
|
"RunOnceActivity.MCP Project settings loaded": "true",
|
|
"RunOnceActivity.ShowReadmeOnStart": "true",
|
|
"RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true",
|
|
"RunOnceActivity.git.unshallow": "true",
|
|
"RunOnceActivity.typescript.service.memoryLimit.init": "true",
|
|
"com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1": "true",
|
|
"git-widget-placeholder": "main",
|
|
"go.import.settings.migrated": "true",
|
|
"javascript.preferred.runtime.type.id": "node",
|
|
"junie.onboarding.icon.badge.shown": "true",
|
|
"last_opened_file_path": "//wsl.localhost/Ubuntu/home/ahilbig/git/vcr/zabbix-graphql-api/src",
|
|
"node.js.detected.package.eslint": "true",
|
|
"node.js.detected.package.tslint": "true",
|
|
"node.js.selected.package.eslint": "(autodetect)",
|
|
"node.js.selected.package.tslint": "(autodetect)",
|
|
"nodejs_interpreter_path": "wsl://Ubuntu@/home/ahilbig/.nvm/versions/node/v24.12.0/bin/node",
|
|
"nodejs_package_manager_path": "npm",
|
|
"npm.codegen.executor": "Run",
|
|
"npm.compile.executor": "Run",
|
|
"npm.copy-schema.executor": "Run",
|
|
"npm.prod.executor": "Run",
|
|
"npm.test.executor": "Run",
|
|
"settings.editor.selected.configurable": "ml.llm.mcp",
|
|
"settings.editor.splitter.proportion": "0.28812414",
|
|
"to.speed.mode.migration.done": "true",
|
|
"ts.external.directory.path": "\\\\wsl.localhost\\Ubuntu\\home\\ahilbig\\git\\vcr\\zabbix-graphql-api\\node_modules\\typescript\\lib",
|
|
"vue.rearranger.settings.migration": "true"
|
|
}
|
|
}</component>
|
|
<component name="RecapSpentCounter">
|
|
<option name="endsOfQuotaMs" value="1768327208764" />
|
|
<option name="spentUsd" value="0.04010335" />
|
|
</component>
|
|
<component name="RecapUselessUpdatesCounter">
|
|
<option name="suspendCountdown" value="0" />
|
|
</component>
|
|
<component name="RecentsManager">
|
|
<key name="CopyFile.RECENT_KEYS">
|
|
<recent name="\\wsl.localhost\Ubuntu\home\ahilbig\git\vcr\zabbix-graphql-api\src" />
|
|
<recent name="\\wsl.localhost\Ubuntu\home\ahilbig\git\vcr\zabbix-graphql-api\dist" />
|
|
<recent name="\\wsl.localhost\Ubuntu\home\ahilbig\git\vcr\zabbix-graphql-api\docs" />
|
|
<recent name="\\wsl.localhost\Ubuntu\home\ahilbig\git\vcr\zabbix-graphql-api\src\testdata\templates" />
|
|
<recent name="\\wsl.localhost\Ubuntu\home\ahilbig\git\vcr\zabbix-graphql-api\src\test" />
|
|
</key>
|
|
<key name="MoveFile.RECENT_KEYS">
|
|
<recent name="\\wsl.localhost\Ubuntu\home\ahilbig\git\vcr\zabbix-graphql-api\schema" />
|
|
</key>
|
|
</component>
|
|
<component name="RunManager" selected="Node.js.index.ts">
|
|
<configuration name="copy-schema" type="js.build_tools.npm" temporary="true" nameIsGenerated="true">
|
|
<package-json value="$PROJECT_DIR$/package.json" />
|
|
<command value="run" />
|
|
<scripts>
|
|
<script value="copy-schema" />
|
|
</scripts>
|
|
<node-interpreter value="project" />
|
|
<envs />
|
|
<method v="2" />
|
|
</configuration>
|
|
<configuration name="prod" type="js.build_tools.npm" temporary="true" nameIsGenerated="true">
|
|
<package-json value="$PROJECT_DIR$/package.json" />
|
|
<command value="run" />
|
|
<scripts>
|
|
<script value="prod" />
|
|
</scripts>
|
|
<node-interpreter value="project" />
|
|
<envs>
|
|
<env name="ADDITIONAL_RESOLVERS" value="SinglePanelDevice,FourPanelDevice,DistanceTrackerDevice" />
|
|
<env name="ADDITIONAL_SCHEMAS" value="./schema/extensions/display_devices.graphql,./schema/extensions/location_tracker_devices.graphql,./schema/extensions/location_tracker_commons.graphql" />
|
|
<env name="DEBUG" value="device-control-center-api:*" />
|
|
<env name="ZABBIX_PRIVILEGE_ESCALATION_TOKEN" value="$ZABBIX_AUTH_TOKEN_VCR_DEV$" />
|
|
<env name="ZABBIX_BASE_URL" value="http://cockpit.vcr.develop.hilbigit.com/" />
|
|
<env name="ZABBIX_PERMISSION_TEMPLATE_GROUP_NAME_PREFIX" value="Permissions" />
|
|
<env name="ZABBIX_ROADWORK_BASE_GROUP" value="Roadwork/Devices" />
|
|
</envs>
|
|
<EXTENSION ID="com.intellij.javascript.debugger.execution.StartBrowserRunConfigurationExtension">
|
|
<browser with-js-debugger="true" />
|
|
</EXTENSION>
|
|
<method v="2" />
|
|
</configuration>
|
|
<configuration name="test" type="js.build_tools.npm" temporary="true" nameIsGenerated="true">
|
|
<package-json value="$PROJECT_DIR$/package.json" />
|
|
<command value="run" />
|
|
<scripts>
|
|
<script value="test" />
|
|
</scripts>
|
|
<node-interpreter value="project" />
|
|
<envs />
|
|
<method v="2" />
|
|
</configuration>
|
|
<list>
|
|
<item itemvalue="Node.js.index.ts" />
|
|
<item itemvalue="npm.compile" />
|
|
<item itemvalue="npm.codegen" />
|
|
<item itemvalue="npm.test" />
|
|
<item itemvalue="npm.copy-schema" />
|
|
<item itemvalue="npm.prod" />
|
|
</list>
|
|
<recent_temporary>
|
|
<list>
|
|
<item itemvalue="npm.test" />
|
|
<item itemvalue="npm.prod" />
|
|
<item itemvalue="npm.copy-schema" />
|
|
<item itemvalue="npm.prod" />
|
|
<item itemvalue="npm.copy-schema" />
|
|
</list>
|
|
</recent_temporary>
|
|
</component>
|
|
<component name="SharedIndexes">
|
|
<attachedChunks>
|
|
<set>
|
|
<option value="bundled-js-predefined-d6986cc7102b-9b0f141eb926-JavaScript-WS-253.30387.83" />
|
|
</set>
|
|
</attachedChunks>
|
|
</component>
|
|
<component name="TaskManager">
|
|
<task active="true" id="Default" summary="Default task">
|
|
<changelist id="d7a71994-2699-4ae4-9fd2-ee13b7f33d35" name="Changes" comment="" />
|
|
<created>1768273021451</created>
|
|
<option name="number" value="Default" />
|
|
<option name="presentableId" value="Default" />
|
|
<updated>1768273021451</updated>
|
|
<workItem from="1768273025985" duration="11343000" />
|
|
<workItem from="1768380302361" duration="9751000" />
|
|
<workItem from="1768551040782" duration="6556000" />
|
|
<workItem from="1768913192173" duration="14627000" />
|
|
<workItem from="1769095609607" duration="1390000" />
|
|
<workItem from="1769256682556" duration="8928000" />
|
|
<workItem from="1769699975260" duration="75000" />
|
|
<workItem from="1769700092648" duration="5212000" />
|
|
<workItem from="1769724930397" duration="16056000" />
|
|
</task>
|
|
<task id="LOCAL-00001" summary="chore: Update IntelliJ workspace settings and add GitHub Actions workflow for Docker deployment">
|
|
<option name="closed" value="true" />
|
|
<created>1768310046741</created>
|
|
<option name="number" value="00001" />
|
|
<option name="presentableId" value="LOCAL-00001" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768310046741</updated>
|
|
</task>
|
|
<task id="LOCAL-00002" summary="chore: Update IntelliJ workspace settings and add GitHub Actions workflow for Docker deployment">
|
|
<option name="closed" value="true" />
|
|
<created>1768310076697</created>
|
|
<option name="number" value="00002" />
|
|
<option name="presentableId" value="LOCAL-00002" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768310076697</updated>
|
|
</task>
|
|
<task id="LOCAL-00003" summary="chore: Update IntelliJ workspace settings and add GitHub Actions workflow for Docker deployment">
|
|
<option name="closed" value="true" />
|
|
<created>1768310176163</created>
|
|
<option name="number" value="00003" />
|
|
<option name="presentableId" value="LOCAL-00003" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768310176163</updated>
|
|
</task>
|
|
<task id="LOCAL-00004" summary="chore: Add missing ".js" extensions to imports and improve Node.js compatibility for dynamic schema loading">
|
|
<option name="closed" value="true" />
|
|
<created>1768311738008</created>
|
|
<option name="number" value="00004" />
|
|
<option name="presentableId" value="LOCAL-00004" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768311738008</updated>
|
|
</task>
|
|
<task id="LOCAL-00005" summary="chore: Update IntelliJ workspace and fix Docker image tag in workflow">
|
|
<option name="closed" value="true" />
|
|
<created>1768312137448</created>
|
|
<option name="number" value="00005" />
|
|
<option name="presentableId" value="LOCAL-00005" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768312137448</updated>
|
|
</task>
|
|
<task id="LOCAL-00006" summary="chore: Add dry-run mode and configure logger for operation mode logging">
|
|
<option name="closed" value="true" />
|
|
<created>1768312304586</created>
|
|
<option name="number" value="00006" />
|
|
<option name="presentableId" value="LOCAL-00006" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768312304586</updated>
|
|
</task>
|
|
<task id="LOCAL-00007" summary="chore: Add test for Zabbix API arguments parsing">
|
|
<option name="closed" value="true" />
|
|
<created>1768312871708</created>
|
|
<option name="number" value="00007" />
|
|
<option name="presentableId" value="LOCAL-00007" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768312871708</updated>
|
|
</task>
|
|
<task id="LOCAL-00008" summary="chore: Replace copying of `schema.graphql` with `extensions` in Dockerfile">
|
|
<option name="closed" value="true" />
|
|
<created>1768313032612</created>
|
|
<option name="number" value="00008" />
|
|
<option name="presentableId" value="LOCAL-00008" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768313032612</updated>
|
|
</task>
|
|
<task id="LOCAL-00009" summary="chore: Move schema directory away from src; Migrate `extensions` to `schema` directory, update Dockerfile and configuration paths">
|
|
<option name="closed" value="true" />
|
|
<created>1768381426293</created>
|
|
<option name="number" value="00009" />
|
|
<option name="presentableId" value="LOCAL-00009" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768381426293</updated>
|
|
</task>
|
|
<task id="LOCAL-00010" summary="chore: Add `copy-schema` script, update Dockerfile schema path, and adjust npm prod workflow">
|
|
<option name="closed" value="true" />
|
|
<created>1768382917600</created>
|
|
<option name="number" value="00010" />
|
|
<option name="presentableId" value="LOCAL-00010" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768382917600</updated>
|
|
</task>
|
|
<task id="LOCAL-00011" summary="chore: Add `copy-schema` script, update Dockerfile schema path, and adjust npm prod workflow">
|
|
<option name="closed" value="true" />
|
|
<created>1768388782068</created>
|
|
<option name="number" value="00011" />
|
|
<option name="presentableId" value="LOCAL-00011" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768388782068</updated>
|
|
</task>
|
|
<task id="LOCAL-00012" summary="chore: Update Dockerfile CMD for schema path, log schema loading path in `schema.ts`, and adjust IntelliJ workspace">
|
|
<option name="closed" value="true" />
|
|
<created>1768396879810</created>
|
|
<option name="number" value="00012" />
|
|
<option name="presentableId" value="LOCAL-00012" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768396879810</updated>
|
|
</task>
|
|
<task id="LOCAL-00013" summary="chore: Update `tags` field schema to use `DeviceConfig`, enhance `isDevice` type check, and adjust IntelliJ workspace">
|
|
<option name="closed" value="true" />
|
|
<created>1768591454965</created>
|
|
<option name="number" value="00013" />
|
|
<option name="presentableId" value="LOCAL-00013" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768591454965</updated>
|
|
</task>
|
|
<task id="LOCAL-00014" summary="chore: Enhance schema with `DeviceConfig` tags resolver and update IntelliJ workspace adjustments">
|
|
<option name="closed" value="true" />
|
|
<created>1768592274523</created>
|
|
<option name="number" value="00014" />
|
|
<option name="presentableId" value="LOCAL-00014" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768592274523</updated>
|
|
</task>
|
|
<task id="LOCAL-00015" summary="chore: Add `allDevices` query resolver, update Zabbix device query handling, and enhance schema with `DeviceConfig` and `WidgetPreview` types">
|
|
<option name="closed" value="true" />
|
|
<created>1768925413032</created>
|
|
<option name="number" value="00015" />
|
|
<option name="presentableId" value="LOCAL-00015" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1768925413032</updated>
|
|
</task>
|
|
<task id="LOCAL-00016" summary="docs: enhance GraphQL schema documentation - Added comprehensive descriptions to all types, interfaces, and fields in 'schema/api_commons.graphql'. - Improved documentation for mutations and input/response types in 'schema/mutations.graphql'. - Added detailed descriptions for all queries and their arguments in 'schema/queries.graphql'. - Enhanced documentation for core Zabbix types and enums in 'schema/zabbix.graphql'. - Updated extension schemas under 'schema/extensions/' with proper GraphQL descriptions. - Verified schema validity via 'graphql-codegen' and ran all tests to ensure consistency.">
|
|
<option name="closed" value="true" />
|
|
<created>1769451540092</created>
|
|
<option name="number" value="00016" />
|
|
<option name="presentableId" value="LOCAL-00016" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1769451540092</updated>
|
|
</task>
|
|
<task id="LOCAL-00017" summary="chore: update Docker image path in workflows and README">
|
|
<option name="closed" value="true" />
|
|
<created>1769511960691</created>
|
|
<option name="number" value="00017" />
|
|
<option name="presentableId" value="LOCAL-00017" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1769511960691</updated>
|
|
</task>
|
|
<task id="LOCAL-00018" summary="docs: add Virtual Control Room (VCR) sample application info to README.md - Added a new section describing the Virtual Control Room (VCR) as a sample application. - Explained how VCR utilizes key API features like hierarchical mapping, dynamic authorization, mass provisioning, and data visualization. - Included a link to the technical product information PDF in the docs folder. - Added VCR to the Key Features list.">
|
|
<option name="closed" value="true" />
|
|
<created>1769514926656</created>
|
|
<option name="number" value="00018" />
|
|
<option name="presentableId" value="LOCAL-00018" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1769514926656</updated>
|
|
</task>
|
|
<task id="LOCAL-00019" summary="chore: update base host group name from "Baustellen-Devices" to "Roadwork" in code, tests, and documentation">
|
|
<option name="closed" value="true" />
|
|
<created>1769525714791</created>
|
|
<option name="number" value="00019" />
|
|
<option name="presentableId" value="LOCAL-00019" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1769525714791</updated>
|
|
</task>
|
|
<task id="LOCAL-00020" summary="chore: centralize configuration management using a new `Config` class - Replaced all direct `process.env` references with `Config` class constants. - Added `dotenv` package to manage environment variables. - Updated affected files, including schema loader, Zabbix API, resolvers, logging system, and integration points. - Improved maintainability and consistency in environment variable handling.">
|
|
<option name="closed" value="true" />
|
|
<created>1769531308340</created>
|
|
<option name="number" value="00020" />
|
|
<option name="presentableId" value="LOCAL-00020" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1769531308340</updated>
|
|
</task>
|
|
<task id="LOCAL-00021" summary="chore: add default filters for host and host group queries - Introduced `HOST_TYPE_FILTER_DEFAULT` and `HOST_GROUP_FILTER_DEFAULT` constants in the `Config` class. - Updated resolvers to use these defaults when `tag_hostType` or `search_name` arguments are not provided. - Added corresponding tests to verify default behavior in host and host group queries.">
|
|
<option name="closed" value="true" />
|
|
<created>1769535965694</created>
|
|
<option name="number" value="00021" />
|
|
<option name="presentableId" value="LOCAL-00021" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1769535965695</updated>
|
|
</task>
|
|
<task id="LOCAL-00022" summary="chore: add tests for schema and API config mocking - Added unit tests for schema loader, mocking Config variables and resolvers. - Added unit tests for Zabbix API configuration, verifying constants derived from Config. - Mocked relevant modules and filesystem behaviors to enable isolated testing. - Optimized imports on all files and include this within a new .junie/guidelines.md file">
|
|
<option name="closed" value="true" />
|
|
<created>1769582068426</created>
|
|
<option name="number" value="00022" />
|
|
<option name="presentableId" value="LOCAL-00022" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1769582068426</updated>
|
|
</task>
|
|
<task id="LOCAL-00023" summary="chore: update `.idea/workspace.xml` and project guidelines - Refined IntelliJ IDEA settings in `.idea/workspace.xml`, including updates to `ProblemsViewState` and `PropertiesComponent` for project consistency. - Renamed and expanded `.junie/guidelines.md` to reflect updated best practices, project structure, and development workflows.">
|
|
<option name="closed" value="true" />
|
|
<created>1769597550348</created>
|
|
<option name="number" value="00023" />
|
|
<option name="presentableId" value="LOCAL-00023" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1769597550348</updated>
|
|
</task>
|
|
<task id="LOCAL-00024" summary="chore: add MCP integration and refactor documentation into modular how-to guides - Moved GraphQL query samples into a new `docs/queries` directory for better organization. - Added new queries and mutations, including `createHost.graphql` and `GetApiVersion.graphql`. - Introduced `mcp-config.yaml` and updated `docker-compose.yml` for MCP integration. - Updated IntelliJ `.idea/workspace.xml` settings to reflect project changes. - Added new how-to guides (`docs/howtos`) for permissions, tags, MCP integration, and schema usage. - Enhanced tests by updating file paths and improving sample data locations. - Refined permissions and host group structures in `zabbix-hostgroups.ts` and `resolvers.ts`.">
|
|
<option name="closed" value="true" />
|
|
<created>1769730441542</created>
|
|
<option name="number" value="00024" />
|
|
<option name="presentableId" value="LOCAL-00024" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1769730441542</updated>
|
|
</task>
|
|
<task id="LOCAL-00025" summary="docs: refactor documentation and upgrade to Node.js 24 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.">
|
|
<option name="closed" value="true" />
|
|
<created>1769780136862</created>
|
|
<option name="number" value="00025" />
|
|
<option name="presentableId" value="LOCAL-00025" />
|
|
<option name="project" value="LOCAL" />
|
|
<updated>1769780136862</updated>
|
|
</task>
|
|
<option name="localTasksCounter" value="26" />
|
|
<servers />
|
|
</component>
|
|
<component name="TypeScriptGeneratedFilesManager">
|
|
<option name="version" value="3" />
|
|
</component>
|
|
<component name="Vcs.Log.Tabs.Properties">
|
|
<option name="TAB_STATES">
|
|
<map>
|
|
<entry key="MAIN">
|
|
<value>
|
|
<State>
|
|
<option name="FILTERS">
|
|
<map>
|
|
<entry key="branch">
|
|
<value>
|
|
<list>
|
|
<option value="public/main" />
|
|
</list>
|
|
</value>
|
|
</entry>
|
|
</map>
|
|
</option>
|
|
</State>
|
|
</value>
|
|
</entry>
|
|
</map>
|
|
</option>
|
|
</component>
|
|
<component name="VcsManagerConfiguration">
|
|
<MESSAGE value="chore: Add dry-run mode and configure logger for operation mode logging" />
|
|
<MESSAGE value="chore: Add test for Zabbix API arguments parsing" />
|
|
<MESSAGE value="chore: Replace copying of `schema.graphql` with `extensions` in Dockerfile" />
|
|
<MESSAGE value="chore: Move schema directory away from src; Migrate `extensions` to `schema` directory, update Dockerfile and configuration paths" />
|
|
<MESSAGE value="chore: Add `copy-schema` script, update Dockerfile schema path, and adjust npm prod workflow" />
|
|
<MESSAGE value="chore: Update Dockerfile CMD for schema path, log schema loading path in `schema.ts`, and adjust IntelliJ workspace" />
|
|
<MESSAGE value="chore: Use DeviceConfig type instead of JSONObject scalar for tags - attribute of devices" />
|
|
<MESSAGE value="chore: Use DeviceConfig type instead of JSONObject scalar for tags - attribute of devices " />
|
|
<MESSAGE value="chore: Update `tags` field schema to use `DeviceConfig`, enhance `isDevice` type check, and adjust IntelliJ workspace" />
|
|
<MESSAGE value="chore: Enhance schema with `DeviceConfig` tags resolver and update IntelliJ workspace adjustments" />
|
|
<MESSAGE value="docs: add README.md and LICENSE file - Created README.md with project purpose, features, installation guide, and usage samples. - Added LICENSE file with GNU Affero General Public License v3.0 to match Zabbix license. - Added license field to package.json." />
|
|
<MESSAGE value="chore: Add `allDevices` query resolver, update Zabbix device query handling, and enhance schema with `DeviceConfig` and `WidgetPreview` types" />
|
|
<MESSAGE value="docs: enhance GraphQL schema documentation - Added comprehensive descriptions to all types, interfaces, and fields in 'schema/api_commons.graphql'. - Improved documentation for mutations and input/response types in 'schema/mutations.graphql'. - Added detailed descriptions for all queries and their arguments in 'schema/queries.graphql'. - Enhanced documentation for core Zabbix types and enums in 'schema/zabbix.graphql'. - Updated extension schemas under 'schema/extensions/' with proper GraphQL descriptions. - Verified schema validity via 'graphql-codegen' and ran all tests to ensure consistency." />
|
|
<MESSAGE value="chore: update Docker image path in workflows and README" />
|
|
<MESSAGE value="docs: add Virtual Control Room (VCR) sample application info to README.md - Added a new section describing the Virtual Control Room (VCR) as a sample application. - Explained how VCR utilizes key API features like hierarchical mapping, dynamic authorization, mass provisioning, and data visualization. - Included a link to the technical product information PDF in the docs folder. - Added VCR to the Key Features list." />
|
|
<MESSAGE value="chore: update base host group name from "Baustellen-Devices" to "Roadwork" in code, tests, and documentation" />
|
|
<MESSAGE value="chore: centralize configuration management using a new `Config` class - Replaced all direct `process.env` references with `Config` class constants. - Added `dotenv` package to manage environment variables. - Updated affected files, including schema loader, Zabbix API, resolvers, logging system, and integration points. - Improved maintainability and consistency in environment variable handling." />
|
|
<MESSAGE value="chore: add default filters for host and host group queries - Introduced `HOST_TYPE_FILTER_DEFAULT` and `HOST_GROUP_FILTER_DEFAULT` constants in the `Config` class. - Updated resolvers to use these defaults when `tag_hostType` or `search_name` arguments are not provided. - Added corresponding tests to verify default behavior in host and host group queries." />
|
|
<MESSAGE value="chore: add default filters for host and host group queries - Introduced `HOST_TYPE_FILTER_DEFAULT` and `HOST_GROUP_FILTER_DEFAULT` constants in the `Config` class. - Updated resolvers to use these defaults when `tag_hostType` or `search_name` arguments are not provided. - Added corresponding tests to verify default behavior in host and host group queries. - Added documentation on overriding 'HOST_GROUP_FILTER_DEFAULT' by explicitly setting the 'search_name' argument in the 'allHostGroups' query. - Explained the usage of the '*' wildcard in 'search_name' with a concrete example for subgroup matching." />
|
|
<MESSAGE value="chore: add tests for schema and API config mocking - Added unit tests for schema loader, mocking Config variables and resolvers. - Added unit tests for Zabbix API configuration, verifying constants derived from Config. - Mocked relevant modules and filesystem behaviors to enable isolated testing. - Optimized imports on all files" />
|
|
<MESSAGE value="chore: add tests for schema and API config mocking - Added unit tests for schema loader, mocking Config variables and resolvers. - Added unit tests for Zabbix API configuration, verifying constants derived from Config. - Mocked relevant modules and filesystem behaviors to enable isolated testing. - Optimized imports on all files and include this within a new .junie/guidelines.md file" />
|
|
<MESSAGE value="chore: update `.idea/workspace.xml` and project guidelines - Refined IntelliJ IDEA settings in `.idea/workspace.xml`, including updates to `ProblemsViewState` and `PropertiesComponent` for project consistency. - Renamed and expanded `.junie/guidelines.md` to reflect updated best practices, project structure, and development workflows." />
|
|
<MESSAGE value="feat: add MCP integration and refactor documentation into modular how-to guides" - Moved query files to a centralized `docs/queries/` directory for better organization. - Added example files under `mcp/operations` to support MCP integration. - Introduced a `docker-compose.yml` file for easier local development and deployment of services. - Updated tests to reflect the relocation of query files. - Enhanced IntelliJ `.idea/workspace.xml` settings for project consistency. " />
|
|
<MESSAGE value="chore: add MCP integration and refactor documentation into modular how-to guides - Moved GraphQL query samples into a new `docs/queries` directory for better organization. - Added new queries and mutations, including `createHost.graphql` and `GetApiVersion.graphql`. - Introduced `mcp-config.yaml` and updated `docker-compose.yml` for MCP integration. - Updated IntelliJ `.idea/workspace.xml` settings to reflect project changes. - Added new how-to guides (`docs/howtos`) for permissions, tags, MCP integration, and schema usage. - Enhanced tests by updating file paths and improving sample data locations. - Refined permissions and host group structures in `zabbix-hostgroups.ts` and `resolvers.ts`." />
|
|
<MESSAGE value="docs: refactor documentation and upgrade to Node.js 24 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." />
|
|
<option name="LAST_COMMIT_MESSAGE" value="docs: refactor documentation and upgrade to Node.js 24 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." />
|
|
<option name="OPTIMIZE_IMPORTS_BEFORE_PROJECT_COMMIT" value="true" />
|
|
</component>
|
|
<component name="XDebuggerManager">
|
|
<breakpoint-manager>
|
|
<breakpoints>
|
|
<line-breakpoint enabled="true" type="javascript">
|
|
<url>file://$PROJECT_DIR$/src/datasources/zabbix-request.ts</url>
|
|
<line>133</line>
|
|
<option name="timeStamp" value="5" />
|
|
</line-breakpoint>
|
|
<line-breakpoint enabled="true" type="javascript">
|
|
<url>file://$PROJECT_DIR$/src/datasources/zabbix-request.ts</url>
|
|
<line>213</line>
|
|
<option name="timeStamp" value="6" />
|
|
</line-breakpoint>
|
|
</breakpoints>
|
|
</breakpoint-manager>
|
|
</component>
|
|
</project> |