Fix/tests idempotent no truncate metrics mt

.github/workflows/cla.yml

@@ -0,0 +1,20 @@
+name: "CLA"
+
+permissions:
+  contents: read
+  pull-requests: write
+  actions: write
+  statuses: write
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_target:
+    types: [opened, closed, synchronize]
+
+jobs:
+  CLA-Lite:
+    name: "Signature"
+    uses: rdkcentral/cmf-actions/.github/workflows/cla.yml@v1
+    secrets:
+      PERSONAL_ACCESS_TOKEN: ${{ secrets.CLA_ASSISTANT }}

LICENSE

@@ -200,3 +200,30 @@
    See the License for the specific language governing permissions and
    limitations under the License.
 
+BSD-3 LICENSE
+
+   Copyright <YEAR> <COPYRIGHT HOLDER>
+
+   Redistribution and use in source and binary forms, with or without modification,
+   are permitted provided that the following conditions are met:
+
+   1. Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+
+   2. Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+
+   3. Neither the name of the copyright holder nor the names of its contributors
+      may be used to endorse or promote products derived from this software without
+      specific prior written permission.
+
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
+   EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+   OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
+   SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+   STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+   OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Makefile

@@ -17,24 +17,24 @@
 #
 GOARCH = $(shell go env GOARCH)
 GOOS = $(shell go env GOOS)
-
+REPO := github.com/rdkcentral/xconfadmin
 BRANCH ?= $(shell git rev-parse --abbrev-ref HEAD)
 Version ?= $(shell git log -1 --pretty=format:"%h")
 BUILDTIME := $(shell date -u +"%F_%T_%Z")
 
 all: build
 
-build:  ## Build a version
-	go build -v -ldflags="-X xconfadmin/common.BinaryBranch=${BRANCH} -X xconfadmin/common.BinaryVersion=${Version} -X xconfadmin/common.BinaryBuildTime=${BUILDTIME}" -o bin/xconfadmin-${GOOS}-${GOARCH} main.go
+build: ## Build a version
+	go build -v -ldflags="-X ${REPO}/common.BinaryBranch=${BRANCH} -X ${REPO}/common.BinaryVersion=${Version} -X ${REPO}/common.BinaryBuildTime=${BUILDTIME}" -o bin/xconfadmin-${GOOS}-${GOARCH} main.go
 
 test:
-	ulimit -n 10000 ; go test ./... -cover -count=1
+	bash contrib/scripts/run_tests_with_summary.sh
 
 localtest:
 	export RUN_IN_LOCAL=true ; go test ./... -cover -count=1 -failfast
 
 cover:
-	go test ./... -count=1 -coverprofile=coverage.out
+	go test ./... -count=1 -p 1 -coverprofile=coverage.out -timeout=45m
 
 html:
 	go tool cover -html=coverage.out
@@ -44,4 +44,4 @@ clean: ## Remove temporary files
 	go clean --testcache
 
 release:
-	go build -v -ldflags="-X xconfadmin/common.BinaryBranch=${BRANCH} -X xconfadmin/common.BinaryVersion=${Version} -X xconfadmin/common.BinaryBuildTime=${BUILDTIME}" -o bin/xconfadmin-${GOOS}-${GOARCH} main.go
+	go build -v -ldflags="-X ${REPO}/common.BinaryBranch=${BRANCH} -X ${REPO}/common.BinaryVersion=${Version} -X ${REPO}/common.BinaryBuildTime=${BUILDTIME}" -o bin/xconfadmin-${GOOS}-${GOARCH} main.go

NOTICE

@@ -19,4 +19,10 @@ This product includes software developed at Comcast (http://www.comcast.com/).
 The component may include material which is licensed under other licenses / copyrights as
 listed below. Your use of this material within the component is also subject to the terms and
 conditions of these licenses. The LICENSE file contains the text of all the licenses which apply
-within this component.
+within this component.
+
+Copyright 2012 The Go Authors. All rights reserved.
+Licensed under the BSD-3 License
+
+Copyright (c) 2023 The Gorilla Authors. All rights reserved.
+Licensed under the BSD-3 License

README.md

@@ -1,33 +1,253 @@
-# xconfadmin
+# XConf Admin
 
-This project is to implement a configuration management server. RDK devices download configurations from this server during bootup or notified when updates are available.
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Go Version](https://img.shields.io/badge/Go-1.23%2B-blue.svg)](https://golang.org/)
+[![Build Status](https://img.shields.io/badge/Build-Passing-green.svg)]()
 
+XConf Admin is a comprehensive configuration management server designed for RDK (Reference Design Kit) devices. It provides a centralized platform for managing device configurations, firmware updates, telemetry settings, and various administrative functions across RDK deployments.
 
-## Install go
+## 🚀 Features
 
-This project is written and tested with Go **1.23***
+- **Configuration Management**: Centralized management of device configurations
+- **Firmware Management**: Control firmware distribution and updates
+- **Telemetry Services**: Manage telemetry profiles and data collection
+- **Device Control Manager (DCM)**: Handle device control and settings
+- **Feature Management**: Control feature flags and rules
+- **Authentication & Authorization**: JWT-based security with role-based access control
+- **RESTful API**: Comprehensive REST API for all operations
+- **Metrics & Monitoring**: Built-in Prometheus metrics support
+- **Canary Deployments**: Support for gradual rollouts
 
-## Build the binary
-```shell
-cd $HOME/go/src/github.com/comcast-cl/xconfadmin
-make
+## 📋 Prerequisites
+
+- **Go 1.23+**: This project requires Go version 1.23 or later
+- **Cassandra**: For data persistence (configure in config file)
+- **Git**: For version control and building
+
+## 🛠️ Installation
+
+### 1. Clone the Repository
+
+```bash
+git clone https://github.com/rdkcentral/xconfadmin.git
+cd xconfadmin
+```
+
+### 2. Install Dependencies
+
+```bash
+go mod download
+```
+
+### 3. Build the Application
+
+```bash
+make build
+```
+
+This will create a binary `bin/xconfadmin-{OS}-{ARCH}` (e.g., `bin/xconfadmin-linux-amd64`)
+
+## ⚙️ Configuration
+
+### Environment Variables
+
+Set the following required environment variables:
+
+```bash
+export SAT_CLIENT_ID='your_client_id'
+export SAT_CLIENT_SECRET='your_client_secret'
+export SECURITY_TOKEN_KEY='your_security_token_key'
+```
+
+### Configuration File
+
+Create a configuration file based on the sample provided:
+
+```bash
+cp config/sample_xconfadmin.conf config/xconfadmin.conf
 ```
-**bin/xconfadmin-linux-amd64** will be created. 
 
-## Run the application
-The application includes an API to notify RDK devices to download updated configurations from this server. A JWT token is required to communicate with service. The credentials are passed to the application through environment variables. A configuration file can be passed as an argument when the application starts. config/sample_xconfadmin.conf is an example. 
+Edit the configuration file to match your environment settings including:
+- Server port and timeouts
+- Database connection details
+- Logging configuration
+- Authentication settings
+- Service endpoints
 
+## 🚀 Running the Application
 
-```shell
-export SAT_CLIENT_ID='xxxxxx'
-export SAT_CLIENT_SECRET='yyyyyy'
-export SECURITY_TOKEN_KEY='zzzzzz'
+### 1. Create Log Directory
+
+```bash
 mkdir -p /app/logs/xconfadmin
-cd $HOME/go/src/github.com/comcast-cl/xconfadmin
-bin/xconfadmin-linux-amd64 -f config/sample_xconfadmin.conf
 ```
 
-```shell
-curl http://localhost:9000/api/v1/version
-{"status":200,"message":"OK","data":{"code_git_commit":"2ac7ff4","build_time":"Thu Feb 14 01:57:26 2019 UTC","binary_version":"317f2d4","binary_branch":"develop","binary_build_time":"2021-02-10_18:26:49_UTC"}}
+### 2. Start the Server
+
+```bash
+bin/xconfadmin-linux-amd64 -f config/xconfadmin.conf
+```
+
+### 3. Verify Installation
+
+Test the server is running:
+
+```bash
+curl http://localhost:9001/api/v1/version
+```
+
+Expected response:
+```json
+{
+  "status": 200,
+  "message": "OK",
+  "data": {
+    "code_git_commit": "abc123",
+    "build_time": "2025-09-08T10:00:00Z",
+    "binary_version": "v1.0.0",
+    "binary_branch": "main",
+    "binary_build_time": "2025-09-08_10:00:00_UTC"
+  }
+}
+```
+
+## 📖 API Documentation
+
+The XConf Admin server provides several API endpoints organized by functionality:
+
+### Core APIs
+
+- **Version**: `GET /version` - Get application version info
+- **Health**: `GET /healthz`  - Health check endpoint
+- **Metrics**: `GET /metrics` - Prometheus metrics
+
+### Administrative APIs
+
+- **Authentication**: `/auth/*` - Authentication and authorization
+- **Firmware**: `/firmware/*` - Firmware management
+- **DCM**: `/dcm/*` - Device Control Manager
+- **Telemetry**: `/telemetry/*` - Telemetry configuration
+- **Features**: `/feature/*` - Feature management
+- **Settings**: `/setting/*` - Various device settings
+
+### Example API Calls
+
+```bash
+# Get firmware configurations
+curl -H "Authorization: Bearer <token>" http://localhost:9001/api/firmware/configs
+
+# Update device settings
+curl -X POST -H "Authorization: Bearer <token>" \
+     -H "Content-Type: application/json" \
+     -d '{"key":"value"}' \
+     http://localhost:9001/api/dcm/settings
+```
+
+## 🏗️ Project Structure
+
+```
+xconfadmin/
+├── adminapi/             # Admin API handlers and business logic
+│   ├── auth/             # Authentication and authorization
+│   ├── canary/           # Canary deployment management
+│   ├── change/           # Change management
+│   ├── configuration/    # Configuration management APIs and logic
+│   ├── dcm/              # Device Control Manager
+│   ├── firmware/         # Firmware management
+│   ├── lockdown/         # Lockdown and recooking logic
+│   ├── queries/          # Query handlers
+│   ├── rfc/              # Remote Feature Control
+│   ├── setting/          # Settings management
+│   ├── telemetry/        # Telemetry services
+│   └── xcrp/             # XConf Configuration Rollback Platform (XCRP) logic
+├── common/               # Common utilities and constants
+├── config/               # Configuration files
+├── http/                 # HTTP utilities and middleware
+├── shared/               # Shared components
+├── taggingapi/           # Tagging API 
+└── util/                 # Utility functions
+```
+
+## 🧪 Testing
+
+### Run All Tests
+
+```bash
+make test
+```
+
+### Run Tests Locally
+
+```bash
+make localtest
+```
+
+### Generate Coverage Report
+
+```bash
+make cover
+make html
+```
+
+## 🔧 Development
+
+### Build for Development
+
+```bash
+make build
+```
+
+### Clean Build Artifacts
+
+```bash
+make clean
 ```
+
+### Release Build
+
+```bash
+make release
+```
+
+## 📊 Monitoring
+
+XConf Admin includes built-in monitoring capabilities:
+
+- **Prometheus Metrics**: Available at `/metrics` endpoint
+- **Health Checks**: Available at `/health` endpoint
+- **Structured Logging**: JSON-formatted logs with configurable levels
+- **Request Tracing**: Optional OpenTelemetry integration
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.
+
+### Development Workflow
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Run the test suite
+6. Submit a pull request
+
+## 📄 License
+
+This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
+
+## 🆘 Support
+
+For support and questions:
+
+- Create an issue in the GitHub repository
+- Check the [documentation](docs/)
+- Review existing issues and discussions
+
+## 🔗 Related Projects
+
+- [xconfwebconfig](https://github.com/rdkcentral/xconfwebconfig) - Web configuration service
+- [RDK Central](https://github.com/rdkcentral) - RDK Central organization
+
+---
+
+**Note**: This is a configuration management server for RDK devices. Ensure proper security measures are in place when deploying in production environments.