# TiDB-X Support Spec Bundle

This directory is organized by feature point rather than by document type.

## Directory Structure

- top-level `0x-*.md` files:
  the canonical TiDB-X feature docs, organized by functional area
- `check/`:
  verification and regression-check materials tied to this feature bundle
- `troubleshooting/`:
  deployment notes and operational troubleshooting references
- `release/`:
  release-time assets and report templates used by this feature bundle

## Read Order

1. `01-overview.md`
2. `02-cluster-metadata-and-service-plan.md`
3. `03-datasource-routing-and-query-semantics.md`
4. `04-metric-output-and-coverage.md`
5. `05-validation-and-rollout.md`
6. `06-tidb-mgmt-migration-design.md`
7. `07-pipeline-backfill-batching-design.md`
8. `08-pipeline-update-design.md`
9. `troubleshooting/alicloud-ingress-alb-dns-deployment-notes.md`

## What Changed in This Feature

- cluster metadata source moved from `core-svc` to `tidb-mgmt`
- service-plan-aware datasource routing was added for Premium / Essential / Starter
- TiDB-X query matcher logic was added for `tidb_cluster_id`, `cluster_id`, and `keyspace_id`
- TiDB-X exported metrics now use instance-level product semantics
- rollout, regression validation, and operational safeguards were added for launch
- Alibaba Cloud ALB, Ingress, cert-manager, and DNS bootstrap behavior was documented

## Recommended Usage

- Read the top-level docs first to understand the refactor by feature point.
- Open `check/` when doing regression review or sign-off work.
- Open `release/` when recording or collecting rollout evidence.