Initial commit: LLM Automation Docs & Remediation Engine v2.0

Features:
- Automated datacenter documentation generation
- MCP integration for device connectivity
- Auto-remediation engine with safety checks
- Multi-factor reliability scoring (0-100%)
- Human feedback learning loop
- Pattern recognition and continuous improvement
- Agentic chat support with AI
- API for ticket resolution
- Frontend React with Material-UI
- CI/CD pipelines (GitLab + Gitea)
- Docker & Kubernetes deployment
- Complete documentation and guides

v2.0 Highlights:
- Auto-remediation with write operations (disabled by default)
- Reliability calculator with 4-factor scoring
- Human feedback system for continuous learning
- Pattern-based progressive automation
- Approval workflow for critical actions
- Full audit trail and rollback capability

.gitlab-ci.yml

@@ -0,0 +1,268 @@
+# GitLab CI/CD Pipeline for Datacenter Documentation System
+
+stages:
+  - lint
+  - test
+  - build
+  - deploy
+  - docs
+
+variables:
+  POETRY_VERSION: "1.7.1"
+  PYTHON_VERSION: "3.10"
+  DOCKER_DRIVER: overlay2
+  DOCKER_TLS_CERTDIR: "/certs"
+  PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"
+  
+cache:
+  key: ${CI_COMMIT_REF_SLUG}
+  paths:
+    - .cache/pip
+    - .venv/
+
+# Template for Python jobs
+.python-base:
+  image: python:${PYTHON_VERSION}
+  before_script:
+    - pip install poetry==${POETRY_VERSION}
+    - poetry config virtualenvs.in-project true
+    - poetry install --no-root
+
+# Lint stage
+lint:black:
+  extends: .python-base
+  stage: lint
+  script:
+    - poetry run black --check src/ tests/
+  only:
+    - merge_requests
+    - main
+    - develop
+
+lint:ruff:
+  extends: .python-base
+  stage: lint
+  script:
+    - poetry run ruff check src/ tests/
+  only:
+    - merge_requests
+    - main
+    - develop
+
+lint:mypy:
+  extends: .python-base
+  stage: lint
+  script:
+    - poetry run mypy src/
+  allow_failure: true
+  only:
+    - merge_requests
+    - main
+    - develop
+
+# Test stage
+test:unit:
+  extends: .python-base
+  stage: test
+  services:
+    - redis:7-alpine
+    - postgres:15-alpine
+  variables:
+    POSTGRES_DB: testdb
+    POSTGRES_USER: test
+    POSTGRES_PASSWORD: test
+    REDIS_URL: redis://redis:6379/0
+    DATABASE_URL: postgresql://test:test@postgres:5432/testdb
+  script:
+    - poetry run pytest tests/unit -v --cov --cov-report=xml --cov-report=term
+  coverage: '/(?i)total.*? (100(?:\.0+)?\%|[1-9]?\d(?:\.\d+)?\%)$/'
+  artifacts:
+    reports:
+      coverage_report:
+        coverage_format: cobertura
+        path: coverage.xml
+    paths:
+      - htmlcov/
+    expire_in: 30 days
+  only:
+    - merge_requests
+    - main
+    - develop
+
+test:integration:
+  extends: .python-base
+  stage: test
+  services:
+    - redis:7-alpine
+    - postgres:15-alpine
+  variables:
+    POSTGRES_DB: testdb
+    POSTGRES_USER: test
+    POSTGRES_PASSWORD: test
+    REDIS_URL: redis://redis:6379/0
+    DATABASE_URL: postgresql://test:test@postgres:5432/testdb
+  script:
+    - poetry run pytest tests/integration -v
+  only:
+    - merge_requests
+    - main
+    - develop
+  when: manual
+
+# Security scanning
+security:bandit:
+  extends: .python-base
+  stage: test
+  script:
+    - poetry add --group dev bandit
+    - poetry run bandit -r src/ -f json -o bandit-report.json
+  artifacts:
+    paths:
+      - bandit-report.json
+    expire_in: 30 days
+  allow_failure: true
+  only:
+    - merge_requests
+    - main
+
+security:safety:
+  extends: .python-base
+  stage: test
+  script:
+    - poetry export -f requirements.txt --output requirements.txt --without-hashes
+    - poetry add --group dev safety
+    - poetry run safety check --file requirements.txt
+  allow_failure: true
+  only:
+    - merge_requests
+    - main
+
+# Build stage
+build:docker:api:
+  stage: build
+  image: docker:24.0.5
+  services:
+    - docker:24.0.5-dind
+  before_script:
+    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
+  script:
+    - docker build -f deploy/docker/Dockerfile.api -t $CI_REGISTRY_IMAGE/api:$CI_COMMIT_SHORT_SHA .
+    - docker build -f deploy/docker/Dockerfile.api -t $CI_REGISTRY_IMAGE/api:latest .
+    - docker push $CI_REGISTRY_IMAGE/api:$CI_COMMIT_SHORT_SHA
+    - docker push $CI_REGISTRY_IMAGE/api:latest
+  only:
+    - main
+    - tags
+
+build:docker:chat:
+  stage: build
+  image: docker:24.0.5
+  services:
+    - docker:24.0.5-dind
+  before_script:
+    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
+  script:
+    - docker build -f deploy/docker/Dockerfile.chat -t $CI_REGISTRY_IMAGE/chat:$CI_COMMIT_SHORT_SHA .
+    - docker build -f deploy/docker/Dockerfile.chat -t $CI_REGISTRY_IMAGE/chat:latest .
+    - docker push $CI_REGISTRY_IMAGE/chat:$CI_COMMIT_SHORT_SHA
+    - docker push $CI_REGISTRY_IMAGE/chat:latest
+  only:
+    - main
+    - tags
+
+build:docker:worker:
+  stage: build
+  image: docker:24.0.5
+  services:
+    - docker:24.0.5-dind
+  before_script:
+    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
+  script:
+    - docker build -f deploy/docker/Dockerfile.worker -t $CI_REGISTRY_IMAGE/worker:$CI_COMMIT_SHORT_SHA .
+    - docker build -f deploy/docker/Dockerfile.worker -t $CI_REGISTRY_IMAGE/worker:latest .
+    - docker push $CI_REGISTRY_IMAGE/worker:$CI_COMMIT_SHORT_SHA
+    - docker push $CI_REGISTRY_IMAGE/worker:latest
+  only:
+    - main
+    - tags
+
+build:frontend:
+  stage: build
+  image: node:20-alpine
+  script:
+    - cd frontend
+    - npm ci
+    - npm run build
+  artifacts:
+    paths:
+      - frontend/dist/
+    expire_in: 7 days
+  only:
+    - main
+    - tags
+
+# Deploy stage
+deploy:staging:
+  stage: deploy
+  image: bitnami/kubectl:latest
+  script:
+    - kubectl config use-context staging
+    - kubectl set image deployment/api api=$CI_REGISTRY_IMAGE/api:$CI_COMMIT_SHORT_SHA -n datacenter-docs
+    - kubectl set image deployment/chat chat=$CI_REGISTRY_IMAGE/chat:$CI_COMMIT_SHORT_SHA -n datacenter-docs
+    - kubectl set image deployment/worker worker=$CI_REGISTRY_IMAGE/worker:$CI_COMMIT_SHORT_SHA -n datacenter-docs
+    - kubectl rollout status deployment/api -n datacenter-docs
+    - kubectl rollout status deployment/chat -n datacenter-docs
+    - kubectl rollout status deployment/worker -n datacenter-docs
+  environment:
+    name: staging
+    url: https://staging-docs.company.local
+  only:
+    - main
+  when: manual
+
+deploy:production:
+  stage: deploy
+  image: bitnami/kubectl:latest
+  script:
+    - kubectl config use-context production
+    - kubectl set image deployment/api api=$CI_REGISTRY_IMAGE/api:$CI_COMMIT_SHORT_SHA -n datacenter-docs
+    - kubectl set image deployment/chat chat=$CI_REGISTRY_IMAGE/chat:$CI_COMMIT_SHORT_SHA -n datacenter-docs
+    - kubectl set image deployment/worker worker=$CI_REGISTRY_IMAGE/worker:$CI_COMMIT_SHORT_SHA -n datacenter-docs
+    - kubectl rollout status deployment/api -n datacenter-docs
+    - kubectl rollout status deployment/chat -n datacenter-docs
+    - kubectl rollout status deployment/worker -n datacenter-docs
+  environment:
+    name: production
+    url: https://docs.company.local
+  only:
+    - tags
+  when: manual
+
+# Documentation generation
+docs:generate:
+  extends: .python-base
+  stage: docs
+  script:
+    - poetry run python -m datacenter_docs.cli generate-all --dry-run
+  artifacts:
+    paths:
+      - output/
+    expire_in: 7 days
+  only:
+    - schedules
+    - main
+
+docs:publish:
+  stage: docs
+  image: node:20-alpine
+  script:
+    - npm install -g @gitbook/cli
+    - gitbook build ./docs
+    - gitbook pdf ./docs ./datacenter-docs.pdf
+  artifacts:
+    paths:
+      - _book/
+      - datacenter-docs.pdf
+    expire_in: 30 days
+  only:
+    - tags