Initialize application (v1.0.0)

.github/workflows/ci.yml

@@ -0,0 +1,146 @@
+---
+name: CI
+
+on:
+  push:
+    branches: [ "main" , "develop" ]
+    tags:
+      - 'v*'
+  pull_request:
+    branches: [ "main" ]
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  lint:
+    name: Lint Go Code
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.24'
+          cache: true
+
+      - name: Run golangci-lint
+        uses: golangci/golangci-lint-action@v6
+        with:
+          version: latest
+          args: --timeout=5m
+
+  build-binary:
+    name: Build Binary for Linux AMD64
+    runs-on: ubuntu-latest
+    needs: lint
+    if: startsWith(github.ref, 'refs/tags/v')
+
+    permissions:
+      contents: write
+      packages: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Verify tag is on main or develop branch
+        run: |
+          TAG_NAME="${GITHUB_REF#refs/tags/}"
+          if ! git branch -r --contains "$TAG_NAME" | grep -qE "origin/(main|develop)"; then
+            echo "Error: Tag $TAG_NAME is not on main or develop branch"
+            exit 1
+          fi
+          BRANCH=$(git branch -r --contains "$TAG_NAME" | grep -E "origin/(main|develop)" | head -1 | sed 's|origin/||' | tr -d ' ')
+          echo "Tag $TAG_NAME verified on $BRANCH branch"
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.24'
+          cache: true
+
+      - name: Get version from tag
+        id: version
+        run: |
+          VERSION="${GITHUB_REF#refs/tags/}"
+          echo "version=${VERSION}" >> $GITHUB_OUTPUT
+          echo "Tag version: ${VERSION}"
+
+      - name: Build binary
+        run: |
+          GOOS=linux GOARCH=amd64 go build \
+            -ldflags="-s -w -X 'apatit/internal/version.Version=${{ steps.version.outputs.version }}'" \
+            -o apatit-linux-amd64 \
+            ./cmd/apatit
+
+      - name: Create GitHub Release and Upload Binary
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            apatit-linux-amd64
+            locations.json
+          generate_release_notes: true
+          draft: false
+          prerelease: ${{ contains(github.ref, '-') }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  build-docker-image:
+    name: Build and Push Docker Image
+    runs-on: ubuntu-latest
+    needs: [lint, build-binary]
+    if: startsWith(github.ref, 'refs/tags/v')
+
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Verify tag is on main or develop branch
+        run: |
+          TAG_NAME="${GITHUB_REF#refs/tags/}"
+          if ! git branch -r --contains "$TAG_NAME" | grep -qE "origin/(main|develop)"; then
+            echo "Error: Tag $TAG_NAME is not on main or develop branch"
+            exit 1
+          fi
+          BRANCH=$(git branch -r --contains "$TAG_NAME" | grep -E "origin/(main|develop)" | head -1 | sed 's|origin/||' | tr -d ' ')
+          echo "Tag $TAG_NAME verified on $BRANCH branch"
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            VERSION=${{ steps.meta.outputs.version }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.gitignore

@@ -0,0 +1,2 @@
+.idea
+.vscode

CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+## [v1.0.0] - 2025-12-03
+
+### Added
+- Prometheus metrics exporter for Ping-Admin monitoring service
+- HTTP server with `/metrics` endpoint for Prometheus scraping
+- JSON stats API endpoints (`/stats?type=task` and `/stats?type=all`)
+- Support for multiple task monitoring with concurrent processing
+- Automatic metrics collection with configurable refresh intervals
+- Location name translation via `locations.json` file
+- Automatic cleanup of stale metrics when monitoring points are removed
+- Comprehensive Prometheus metrics:
+  - Exporter metrics (service info, refresh intervals, loops, errors)
+  - Monitoring point metrics (status, connection time, DNS lookup, server processing, total duration, speed, timestamps, staleness)
+- Configuration via command-line flags and environment variables
+- Docker image support with multi-stage build
+- Graceful shutdown handling with signal support
+- Request retry mechanism with configurable retry count
+- Randomized request delays to prevent API throttling
+- Rate limiting with configurable maximum requests per second (default: 2 requests/second)
+- Staleness detection and reporting for monitoring points
+- Support for English MP name translation
+- Docker Compose configuration for easy deployment
+- CI/CD workflow with linting and building

Dockerfile

@@ -0,0 +1,29 @@
+FROM golang:1.24-alpine AS build
+WORKDIR /app
+COPY go.mod go.sum ./
+RUN go mod download
+COPY . .
+ARG VERSION="v1.0.0"
+RUN go build -v -ldflags="-s -w -X 'apatit/internal/version.Version=${VERSION}'" -o /app/apatit ./cmd/apatit
+
+FROM alpine:3.21
+ARG VERSION="latest"
+
+RUN apk add --no-cache ca-certificates
+
+LABEL org.opencontainers.image.title="APATIT (Advanced Ping-Admin Tasks Indicators Transducer)"
+LABEL org.opencontainers.image.description="Transducer for Tasks Indicators from https://ping-admin.com/"
+LABEL org.opencontainers.image.source="https://github.com/ostrovok-tech/apatit"
+LABEL org.opencontainers.image.version="${VERSION}"
+
+COPY --from=build /app/apatit /usr/local/bin/apatit
+COPY locations.json /app/locations.json
+WORKDIR /app
+
+RUN addgroup -S appgroup && adduser -S appuser -G appgroup
+
+USER appuser
+EXPOSE 8080
+ENV LISTEN_ADDRESS=:8080
+
+ENTRYPOINT [ "apatit" ]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ostrovok! Tech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.