fix: update expected local time format in WeCom SMS values test

feat: add WeCom message push notifications

.env.example

@@ -1,4 +1,6 @@
-# VoCat no longer stores administrator credentials in .env.
-# Initialize a new Docker database with the bootstrap-admin command documented
-# at the top of docker-compose.yml. Keep this file only for optional, non-secret
-# Compose substitutions added by an operator.
+# Copy this file to .env and fill in real values before `docker compose up -d`.
+# .env is gitignored; .env.example is tracked as a template.
+
+# Admin password for the web UI. REQUIRED — the server refuses to start safely
+# without it once exposed. Pick a strong password.
+VOCAT_ADMIN_PASSWORD=change-me-to-a-strong-password

.gitattributes

@@ -1 +0,0 @@
-*.sh text eol=lf

.github/ISSUE_TEMPLATE/issue_report.yml

@@ -1,75 +0,0 @@
-name: Issue Report
-description: Report a bug or problem with VoCat. Please answer every question below.
-title: "[Issue]: "
-labels: ["triage"]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Thanks for taking the time to open an issue. Please fill in all the fields
-        below so we can triage and handle your report as quickly as possible.
-
-  - type: checkboxes
-    id: searched-existing
-    attributes:
-      label: Existing Issues
-      description: Have you searched through past Issues (both open and closed) to check whether this problem, or a similar one, has already been reported?
-      options:
-        - label: I have searched past Issues and found no similar report.
-          required: true
-
-  - type: textarea
-    id: description
-    attributes:
-      label: What happened?
-      description: Describe the problem you encountered and what you expected to happen instead.
-      placeholder: A clear and concise description of the issue...
-    validations:
-      required: true
-
-  - type: dropdown
-    id: priority
-    attributes:
-      label: Suggested Priority
-      description: In your opinion, what priority should this issue be handled with?
-      options:
-        - Low
-        - Medium
-        - High
-    validations:
-      required: true
-
-  - type: dropdown
-    id: area
-    attributes:
-      label: Affected Area
-      description: Do you think this is a frontend or backend error?
-      options:
-        - Frontend
-        - Backend
-        - Not sure
-    validations:
-      required: true
-
-  - type: checkboxes
-    id: abuse-mcc-acknowledgement
-    attributes:
-      label: Acknowledgement
-      description: Please read and confirm the following before submitting.
-      options:
-        - label: >-
-            I understand that this repository will not modify any feature code on
-            behalf of abusers in order to enable abuse, and that this service must
-            not be used in regions with MCC=460; any issues
-            arising from such use will not be resolved.
-          required: true
-
-  - type: textarea
-    id: error-messages
-    attributes:
-      label: Error Messages
-      description: Did you encounter any error messages? If so, please paste them here.
-      placeholder: Paste any relevant error output or logs...
-      render: shell
-    validations:
-      required: false

.github/workflows/docker.yml

@@ -15,50 +15,7 @@ env:
   IMAGE_NAME: ${{ github.repository }}
 
 jobs:
-  smoke:
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - platform: linux/amd64
-            arch: amd64
-          - platform: linux/arm64
-            arch: arm64
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v3
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: Build ${{ matrix.platform }} smoke image
-        uses: docker/build-push-action@v6
-        with:
-          context: .
-          file: ./Dockerfile
-          platforms: ${{ matrix.platform }}
-          load: true
-          push: false
-          tags: vocat-smoke:${{ matrix.arch }}
-          build-args: |
-            VERSION=0.0.0-smoke
-            BUILD_TIME=${{ github.event.repository.updated_at }}
-          cache-from: type=gha
-
-      - name: Verify ${{ matrix.platform }} runtime and smart-card stack
-        run: |
-          docker run --rm --platform '${{ matrix.platform }}' \
-            vocat-smoke:${{ matrix.arch }} version
-          docker run --rm --platform '${{ matrix.platform }}' \
-            --entrypoint /bin/sh vocat-smoke:${{ matrix.arch }} -c \
-            'command -v pcscd && test -d /usr/lib/pcsc/drivers'
-
   build-and-push:
-    needs: smoke
     runs-on: ubuntu-latest
     steps:
       - name: Checkout

.github/workflows/pr-size-limit.yml

@@ -1,282 +0,0 @@
-name: Pull request size limit
-
-on:
-  pull_request_target:
-    branches:
-      - master
-    types:
-      - opened
-      - synchronize
-      - reopened
-      - ready_for_review
-
-permissions:
-  contents: read
-  pull-requests: write
-  issues: write
-
-concurrency:
-  group: pr-size-limit-${{ github.event.pull_request.number }}
-  cancel-in-progress: true
-
-jobs:
-  enforce-size-limit:
-    # 保持这个名字不变，这样你 Ruleset 里的 Required Check 不需要修改
-    name: Enforce 5,000-line limit
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-
-    env:
-      MAX_CHANGED_LINES: "5000"
-      PR_NUMBER: ${{ github.event.pull_request.number }}
-      BASE_REF: ${{ github.event.pull_request.base.ref }}
-      GH_TOKEN: ${{ github.token }}
-
-    steps:
-      - name: Checkout trusted base repository
-        uses: actions/checkout@v7
-        with:
-          fetch-depth: 0
-          persist-credentials: false
-
-      - name: Check conflicts and pull request size
-        shell: bash
-        run: |
-          set -euo pipefail
-
-          echo "Checking PR #${PR_NUMBER}"
-          echo "Base branch: ${BASE_REF}"
-
-          ############################################################
-          # Helper: comment on and close rejected PR
-          ############################################################
-
-          reject_pr() {
-            local message="$1"
-
-            echo "::error::${message}"
-
-            COMMENT_PAYLOAD="$(
-              jq -nc \
-                --arg body "${message}" \
-                '{body: $body}'
-            )"
-
-            echo "Posting rejection comment..."
-
-            curl \
-              --fail-with-body \
-              --silent \
-              --show-error \
-              --request POST \
-              --header "Accept: application/vnd.github+json" \
-              --header "Authorization: Bearer ${GH_TOKEN}" \
-              --header "X-GitHub-Api-Version: 2022-11-28" \
-              "${GITHUB_API_URL}/repos/${GITHUB_REPOSITORY}/issues/${PR_NUMBER}/comments" \
-              --data "${COMMENT_PAYLOAD}" \
-              >/dev/null
-
-            echo "Closing PR #${PR_NUMBER}..."
-
-            curl \
-              --fail-with-body \
-              --silent \
-              --show-error \
-              --request PATCH \
-              --header "Accept: application/vnd.github+json" \
-              --header "Authorization: Bearer ${GH_TOKEN}" \
-              --header "X-GitHub-Api-Version: 2022-11-28" \
-              "${GITHUB_API_URL}/repos/${GITHUB_REPOSITORY}/pulls/${PR_NUMBER}" \
-              --data '{"state":"closed"}' \
-              >/dev/null
-
-            exit 1
-          }
-
-          ############################################################
-          # Fetch target branch and PR HEAD
-          ############################################################
-
-          echo "Fetching base branch and PR head..."
-
-          git fetch --no-tags --force origin \
-            "+refs/heads/${BASE_REF}:refs/remotes/origin/base-pr-check" \
-            "+refs/pull/${PR_NUMBER}/head:refs/remotes/origin/pr-${PR_NUMBER}"
-
-          BASE_COMMIT="$(
-            git rev-parse refs/remotes/origin/base-pr-check
-          )"
-
-          PR_COMMIT="$(
-            git rev-parse refs/remotes/origin/pr-${PR_NUMBER}
-          )"
-
-          echo "Base commit: ${BASE_COMMIT}"
-          echo "PR commit:   ${PR_COMMIT}"
-
-          ############################################################
-          # STEP 1: Reject PRs with merge conflicts
-          ############################################################
-
-          echo
-          echo "Checking for merge conflicts..."
-
-          set +e
-
-          git merge-tree \
-            --write-tree \
-            --quiet \
-            "${BASE_COMMIT}" \
-            "${PR_COMMIT}"
-
-          MERGE_STATUS=$?
-
-          set -e
-
-          if [[ "${MERGE_STATUS}" -eq 1 ]]; then
-
-            {
-              echo "### Pull request policy"
-              echo
-              echo "- Merge conflicts: ❌ Detected"
-              echo "- Result: Rejected"
-            } >> "${GITHUB_STEP_SUMMARY}"
-
-            reject_pr "This pull request has merge conflicts with the current master branch and cannot be accepted. Please update your branch with the latest master, resolve all merge conflicts locally, and submit a conflict-free pull request."
-
-          elif [[ "${MERGE_STATUS}" -ne 0 ]]; then
-
-            echo "::error::Unable to determine whether the pull request can be merged."
-            echo "git merge-tree returned status ${MERGE_STATUS}."
-
-            {
-              echo "### Pull request policy"
-              echo
-              echo "- Merge conflict check: ⚠️ Error"
-              echo "- Result: Check failed"
-            } >> "${GITHUB_STEP_SUMMARY}"
-
-            exit 1
-
-          fi
-
-          echo "No merge conflicts detected."
-
-          ############################################################
-          # STEP 2: Determine merge base
-          ############################################################
-
-          if ! MERGE_BASE="$(
-            git merge-base "${BASE_COMMIT}" "${PR_COMMIT}"
-          )"; then
-
-            echo "::error::Unable to determine merge base."
-
-            {
-              echo "### Pull request policy"
-              echo
-              echo "- Merge conflicts: ✅ None"
-              echo "- Diff calculation: ⚠️ Failed"
-            } >> "${GITHUB_STEP_SUMMARY}"
-
-            exit 1
-
-          fi
-
-          echo "Merge base: ${MERGE_BASE}"
-
-          ############################################################
-          # STEP 3: Calculate actual PR changed lines
-          ############################################################
-
-          NUMSTAT_FILE="$(mktemp)"
-
-          git diff \
-            --no-ext-diff \
-            --no-textconv \
-            --numstat \
-            "${MERGE_BASE}" \
-            "${PR_COMMIT}" \
-            > "${NUMSTAT_FILE}"
-
-          ADDITIONS="$(
-            awk '
-              $1 ~ /^[0-9]+$/ {
-                total += $1
-              }
-
-              END {
-                print total + 0
-              }
-            ' "${NUMSTAT_FILE}"
-          )"
-
-          DELETIONS="$(
-            awk '
-              $2 ~ /^[0-9]+$/ {
-                total += $2
-              }
-
-              END {
-                print total + 0
-              }
-            ' "${NUMSTAT_FILE}"
-          )"
-
-          CHANGED_FILES="$(
-            awk '
-              END {
-                print NR + 0
-              }
-            ' "${NUMSTAT_FILE}"
-          )"
-
-          CHANGED_LINES=$((ADDITIONS + DELETIONS))
-
-          ############################################################
-          # Action summary
-          ############################################################
-
-          {
-            echo "### Pull request policy"
-            echo
-            echo "- Merge conflicts: ✅ None"
-            echo "- Changed files: ${CHANGED_FILES}"
-            echo "- Additions: ${ADDITIONS}"
-            echo "- Deletions: ${DELETIONS}"
-            echo "- Total changed lines: ${CHANGED_LINES}"
-            echo "- Maximum allowed: ${MAX_CHANGED_LINES}"
-          } >> "${GITHUB_STEP_SUMMARY}"
-
-          echo
-          echo "Changed files: ${CHANGED_FILES}"
-          echo "Additions: ${ADDITIONS}"
-          echo "Deletions: ${DELETIONS}"
-          echo "Total changed lines: ${CHANGED_LINES}"
-          echo "Limit: ${MAX_CHANGED_LINES}"
-
-          ############################################################
-          # STEP 4: Reject oversized PRs
-          ############################################################
-
-          if (( CHANGED_LINES > MAX_CHANGED_LINES )); then
-
-            reject_pr "This pull request changes ${CHANGED_LINES} lines (${ADDITIONS} additions + ${DELETIONS} deletions) across ${CHANGED_FILES} files, exceeding the repository limit of ${MAX_CHANGED_LINES} changed lines. It has been closed automatically. Please split the changes into smaller pull requests."
-
-          fi
-
-          ############################################################
-          # PASS
-          ############################################################
-
-          echo
-          echo "Pull request passed all policy checks."
-          echo "No merge conflicts."
-          echo "Changed lines: ${CHANGED_LINES}/${MAX_CHANGED_LINES}."
-
-          {
-            echo
-            echo "### Result"
-            echo
-            echo "✅ Pull request passed."
-          } >> "${GITHUB_STEP_SUMMARY}"

.github/workflows/release.yml

@@ -93,9 +93,6 @@ jobs:
         with:
           name: web-dist
           path: web/dist
-      - name: Set up QEMU for ARM64 runtime smoke test
-        if: matrix.goarch == 'arm64'
-        uses: docker/setup-qemu-action@v3
       - name: Build ${{ matrix.target }}
         env:
           GOOS: linux
@@ -113,14 +110,6 @@ jobs:
             -o "$OUTPUT" \
             ./cmd/vocat
           chmod 0755 "$OUTPUT"
-          if readelf -l "$OUTPUT" | grep -q 'Requesting program interpreter'; then
-            echo "ERROR: $OUTPUT unexpectedly requires a dynamic loader" >&2
-            readelf -l "$OUTPUT" >&2
-            exit 1
-          fi
-          case "${{ matrix.goarch }}" in
-            amd64|arm64) "$OUTPUT" version ;;
-          esac
       - name: Upload ${{ matrix.target }}
         uses: actions/upload-artifact@v4
         with:

.gitignore

@@ -10,7 +10,6 @@
 *.dll
 *.so
 *.dylib
-/fix
 
 # ---- Cookie / secret files (NEVER commit) ----
 vc.jar

Dockerfile

@@ -36,7 +36,7 @@ RUN CGO_ENABLED=0 GOOS=${TARGETOS:-linux} GOARCH=${TARGETARCH} go build \
 
 # ---- Stage 3: minimal runtime ----
 FROM alpine:3.20
-RUN apk add --no-cache ca-certificates ccid iproute2 pcsc-lite tzdata && \
+RUN apk add --no-cache ca-certificates tzdata && \
     addgroup -S -g 1000 vocat && \
     adduser -S -D -H -u 1000 -G vocat vocat
 
@@ -44,19 +44,14 @@ RUN mkdir -p /opt/vocat/bin /opt/vocat/data && \
     chown -R vocat:vocat /opt/vocat
 
 COPY --from=go-builder /out/vocat /opt/vocat/bin/vocat
-COPY scripts/docker-entrypoint.sh /usr/local/bin/vocat-entrypoint
 
 # Symlink into /usr/local/bin so `docker exec <ctr> vocat ...` finds it via $PATH.
-RUN ln -s /opt/vocat/bin/vocat /usr/local/bin/vocat && \
-    chmod 0755 /usr/local/bin/vocat-entrypoint
+RUN ln -s /opt/vocat/bin/vocat /usr/local/bin/vocat
 
-# Hardware access and the bundled pcscd daemon require root inside the
-# container. The container already needs host networking and privileged device
-# access for modem, QMI, IPsec, and hot-plug support.
-USER root
+USER vocat
 VOLUME ["/opt/vocat/data"]
 EXPOSE 7575
 ENV VOCAT_ADDR=0.0.0.0:7575 \
     VOCAT_DATABASE_PATH=/opt/vocat/data/vocat.db
 
-ENTRYPOINT ["/usr/local/bin/vocat-entrypoint"]
+ENTRYPOINT ["/opt/vocat/bin/vocat"]

LICENSES/quectel-qmi-go-MIT.txt

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 iniwex5
-
-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.

NOTICE

@@ -1,10 +0,0 @@
-VoCat uses the following Go module for native Qualcomm QMI support:
-
-  github.com/iniwex5/quectel-qmi-go v0.6.0
-  Distribution: https://proxy.golang.org/github.com/iniwex5/quectel-qmi-go/@v/v0.6.0.zip
-  Documentation and license metadata: https://pkg.go.dev/github.com/iniwex5/[email protected]
-  License: MIT
-  Copyright: Copyright (c) 2026 iniwex5
-
-The full MIT license text is included in:
-LICENSES/quectel-qmi-go-MIT.txt

README.md

@@ -22,7 +22,7 @@
   <img alt="GitHub Actions" src="https://img.shields.io/badge/GitHub_Actions-Release-2088FF?style=flat-square&logo=githubactions&logoColor=white">
 </p>
 
-**English** | [العربية](docs/README.ar.md) | [简体中文](docs/README.zh-CN.md) | [繁體中文](docs/README.zh-TW.md) | [Français](docs/README.fr.md) | [Русский](docs/README.ru.md) | [Español](docs/README.es.md) | [日本語](docs/README.ja.md)
+**English** | [简体中文](docs/README.zh-CN.md)
 
 Vocat is an open-source web control panel and engineering toolkit for Quectel EC20/EC25-class cellular modems. It combines modem discovery, live radio status, AT and USSD terminals, SMS, WiFi Calling, eSIM management, network selection, proxy routing, notifications, audit logs, and release automation in one self-contained service.
 
@@ -46,7 +46,7 @@ The backend is written in Go, the interface is built with React and TypeScript,
 | Card policy | ICCID-based WiFi Calling and flight-mode behavior with immediate policy application. |
 | Proxy routing | Upstream SOCKS routing, device bindings, country rules, TCP reachability checks, and UDP Associate checks for WiFi Calling data paths. |
 | Notifications | New inbound SMS forwarding through Telegram, Bark, email, Pushplus, and signed webhooks. Each SMS is delivered as an individual notification. |
-| Telegram bot | Device status, installed-profile listing and switching, WiFi Calling controls, and SMS sending. Sensitive actions require administrator confirmation. |
+| Telegram bot | Device status, installed-profile listing and switching, WiFi Calling controls, SMS sending, timed dialing with automatic hang-up, call status, answer, and hang-up commands. Sensitive actions require administrator confirmation. |
 | Operations | Authentication, CSRF protection, access policies, audit events, live logs, log retention, health checks, responsive layout, dark mode, and English/Chinese application UI. |
 | Distribution | Static Linux binaries, systemd installation script, self-update with SHA-256 verification, Docker image, GHCR publishing, and GitHub Actions release builds. |
 
@@ -65,24 +65,10 @@ Available features depend on the module firmware, USB composition, SIM/eSIM capa
 
 ### One-click Linux installation
 
-As root (including OpenWrt/Kwrt, where `sudo` is normally absent):
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash
-```
-
-From a normal user on a distribution with sudo:
-
 ```bash
 curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | sudo bash
 ```
 
-Check the host's VoWiFi/XFRM prerequisites without installing VoCat:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash -s -- --check-env
-```
-
 Install a specific version:
 
 ```bash
@@ -90,12 +76,6 @@ curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/i
 sudo bash install.sh 0.0.2
 ```
 
-VoWiFi IMS requires Linux XFRM/IPsec. On OpenWrt/Kwrt the installer attempts
-to install matching `ip-full`, `kmod-ipsec`, `kmod-ipsec4/6`,
-`kmod-crypto-authenc`, AES-CBC and SHA1 packages from the firmware's own feed.
-If matching kernel modules are unavailable, use a firmware that includes them;
-never force-install kmods built for a different kernel.
-
 The installer:
 
 - detects `amd64`, `386`, `arm64`, `aarch64`, or `armv7`;
@@ -130,11 +110,9 @@ Verify and install it:
 sha256sum -c SHA256SUMS --ignore-missing
 sudo install -d -m 0755 /opt/vocat/bin /opt/vocat/data
 sudo install -m 0755 vocat-linux-amd64 /opt/vocat/bin/vocat
-read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | sudo /opt/vocat/bin/vocat bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
 sudo env \
   VOCAT_DATABASE_PATH=/opt/vocat/data/vocat.db \
+  VOCAT_ADMIN_PASSWORD=change-this-password \
   /opt/vocat/bin/vocat serve
 ```
 
@@ -151,20 +129,13 @@ continue seeing USB hot-plug events, run Vocat in hardware-access mode:
 ```bash
 docker pull ghcr.io/mengmengcode/vocat:latest
 
-read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | docker run --rm -i \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  --entrypoint /opt/vocat/bin/vocat \
-  ghcr.io/mengmengcode/vocat:latest bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-
 docker run -d \
   --name vocat \
   --restart unless-stopped \
   --network host \
   --privileged \
   --user 0:0 \
+  -e VOCAT_ADMIN_PASSWORD=change-this-password \
   -v vocat-data:/opt/vocat/data \
   -v /dev:/dev \
   -v /sys:/sys:ro \
@@ -175,28 +146,18 @@ Open `http://<server-address>:7575` after the container starts. Host networking
 is required so QMI network interfaces remain visible to Vocat, while privileged
 device access is required for serial ports, QMI control nodes, TUN interfaces,
 network configuration, and devices added after the container starts. The
-`/dev` bind mount makes new `ttyUSB*`, `ttyACM*`, `cdc-wdm*`, and MHI
-`wwan*` nodes visible without recreating the container.
+`/dev` bind mount makes new `ttyUSB*`, `ttyACM*`, and `cdc-wdm*` nodes visible
+without recreating the container.
 
 This mode intentionally gives Vocat broad access to the host's devices and
 network stack. Use it only on a trusted Linux host. The automatic discovery
-identifies supported Quectel USB modems (USB vendor ID `2c7c`) and PCIe/MHI
-modems exposed through the Linux WWAN subsystem; it does not identify arbitrary
-modem layouts. Mapping only individual nodes with `--device`, such as
-`/dev/ttyUSB2`, `/dev/cdc-wdm0`, or `/dev/wwan0qmi0`, limits the container to
-those fixed nodes and does not provide complete multi-device or hot-plug discovery.
+currently identifies supported Quectel USB modems (USB vendor ID `2c7c`), not
+arbitrary modem brands. Mapping only individual nodes with `--device`, such as
+`/dev/ttyUSB2` and `/dev/cdc-wdm0`, limits the container to those fixed nodes
+and does not provide complete multi-device or hot-plug discovery.
 
 The GHCR image is published for `linux/amd64` and `linux/arm64`.
 
-### USB SIM readers
-
-USB SIM readers use the Linux PC/SC service. The one-click installer installs
-and starts `pcscd` plus the CCID driver automatically on supported package
-managers. On Debian/Ubuntu, the equivalent manual setup is
-`apt install pcscd libccid`. If USB sees a CCID reader but PC/SC is unavailable,
-VoCat keeps the reader visible in the add-device dialog and reports the missing
-service or driver instead of silently hiding it.
-
 ## Configuration
 
 Vocat reads an optional JSON configuration file from `VOCAT_CONFIG`, then applies `VOCAT_*` environment variables. Environment variables take precedence.
@@ -205,6 +166,8 @@ Vocat reads an optional JSON configuration file from `VOCAT_CONFIG`, then applie
 | --- | --- | --- |
 | `VOCAT_ADDR` | `0.0.0.0:7575` | HTTP listen address. |
 | `VOCAT_DATABASE_PATH` | `./data/vocat.db` | SQLite database path. |
+| `VOCAT_ADMIN_USERNAME` | `admin` | Initial administrator username. |
+| `VOCAT_ADMIN_PASSWORD` | `admin` | Initial administrator password. Change it before exposing the service. |
 | `VOCAT_SESSION_TTL` | `24h` | Authentication session lifetime. |
 | `VOCAT_SECURE_COOKIES` | `false` | Marks session cookies as secure when HTTPS is used. |
 | `VOCAT_SHUTDOWN_TIMEOUT` | `10s` | Graceful shutdown timeout. |
@@ -212,10 +175,6 @@ Vocat reads an optional JSON configuration file from `VOCAT_CONFIG`, then applie
 | `VOCAT_REPO` | `MengMengCode/VoCat` | Trusted GitHub repository used by the self-updater, in `owner/name` form. |
 | `GITHUB_TOKEN` | empty | Optional GitHub token for private repositories or higher API limits. |
 
-Administrator credentials are stored only in SQLite. Initialize an empty
-database once with `vocat bootstrap-admin`; environment variables and JSON
-configuration cannot set or overwrite the administrator username or password.
-
 Do not store Telegram tokens, SMTP passwords, webhook secrets, SIM credentials, or other private data in the repository. Configure them through the application settings or protected environment files.
 
 ## Telegram bot
@@ -228,9 +187,13 @@ When Telegram notifications are enabled and both Chat ID and Admin ID are config
 /switch <device> <iccid>
 /wfc <device> <status|on|off|reconnect>
 /sms <device> <number> <message>
+/call <device> <number> <seconds>
+/calls <device>
+/answer <device>
+/hangup <device>
 ```
 
-Profile switching and SMS submission use one-time confirmation buttons. The bot does not expose eSIM download, delete, or rename commands.
+Profile switching, SMS submission, and dialing use one-time confirmation buttons. Timed dialing performs the modem call action and automatically hangs up after 1–600 seconds; it does not capture or process call audio. The bot does not expose eSIM download, delete, or rename commands.
 
 ## Updating
 
@@ -353,5 +316,3 @@ cd web && npm run build
 ## License
 
 See [LICENSE](LICENSE).
-
-[![MengMengCode/VoCat Star History](https://mengmeng.meteor-history.com/api/embed/MengMengCode/VoCat.svg?sig=sdeXRVxAoY3yLWgXL7JViY2USYIN3t9neJ6ScPvgUAo&theme=light&style=xkcd&color=dd4528&background=ffffff&textColor=000000&width=900&height=600&lineWidth=3&showTitle=true&showLegend=true&showDots=false&v=0.0.14)](https://meteor-history.com)

cmd/vocat/bootstrap_admin.go

@@ -1,60 +0,0 @@
-package main
-
-import (
-	"bufio"
-	"context"
-	"errors"
-	"flag"
-	"fmt"
-	"io"
-	"os"
-	"strings"
-	"time"
-
-	"vocat/internal/auth"
-	"vocat/internal/store"
-)
-
-func runBootstrapAdmin(args []string) error {
-	flags := flag.NewFlagSet("bootstrap-admin", flag.ContinueOnError)
-	flags.SetOutput(io.Discard)
-	databasePath := flags.String("database", "/opt/vocat/data/vocat.db", "database path")
-	username := flags.String("username", "admin", "administrator username")
-	if err := flags.Parse(args); err != nil || flags.NArg() != 0 {
-		return errors.New("usage: vocat bootstrap-admin [--database path] [--username name]")
-	}
-	reader := bufio.NewReader(os.Stdin)
-	password, err := reader.ReadString('\n')
-	if err != nil && !errors.Is(err, io.EOF) {
-		return fmt.Errorf("read password: %w", err)
-	}
-	password = strings.TrimSuffix(strings.TrimSuffix(password, "\n"), "\r")
-	if password == "" {
-		return errors.New("bootstrap password cannot be empty")
-	}
-	adminUsername := strings.TrimSpace(*username)
-	if len(adminUsername) < 1 || len(adminUsername) > 64 || strings.ContainsAny(adminUsername, "\r\n\t") {
-		return errors.New("bootstrap username must contain between 1 and 64 characters without control whitespace")
-	}
-	ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
-	defer cancel()
-	database, err := store.Open(ctx, strings.TrimSpace(*databasePath))
-	if err != nil {
-		return err
-	}
-	defer database.Close()
-	service, err := auth.New(database, auth.Options{SessionTTL: 24 * time.Hour})
-	if err != nil {
-		return err
-	}
-	created, err := service.EnsureAdminIfMissing(ctx, adminUsername, password)
-	if err != nil {
-		return err
-	}
-	if created {
-		fmt.Println("created")
-	} else {
-		fmt.Println("exists")
-	}
-	return nil
-}

cmd/vocat/bootstrap_admin_test.go

@@ -1,57 +0,0 @@
-package main
-
-import (
-	"context"
-	"os"
-	"path/filepath"
-	"testing"
-	"time"
-
-	"vocat/internal/auth"
-	"vocat/internal/store"
-)
-
-func TestBootstrapAdminOnlyInitializesAnEmptyDatabase(t *testing.T) {
-	path := filepath.Join(t.TempDir(), "vocat.db")
-	withBootstrapStdin(t, "first-secure-password\n", func() {
-		if err := runBootstrapAdmin([]string{"--database", path}); err != nil {
-			t.Fatal(err)
-		}
-	})
-	withBootstrapStdin(t, "second-secure-password\n", func() {
-		if err := runBootstrapAdmin([]string{"--database", path}); err != nil {
-			t.Fatal(err)
-		}
-	})
-	database, err := store.Open(context.Background(), path)
-	if err != nil {
-		t.Fatal(err)
-	}
-	defer database.Close()
-	service, err := auth.New(database, auth.Options{SessionTTL: time.Hour})
-	if err != nil {
-		t.Fatal(err)
-	}
-	if _, err := service.Login(context.Background(), "admin", "first-secure-password"); err != nil {
-		t.Fatalf("initial password was overwritten: %v", err)
-	}
-}
-
-func withBootstrapStdin(t *testing.T, input string, action func()) {
-	t.Helper()
-	original := os.Stdin
-	file, err := os.CreateTemp(t.TempDir(), "stdin")
-	if err != nil {
-		t.Fatal(err)
-	}
-	if _, err := file.WriteString(input); err != nil {
-		t.Fatal(err)
-	}
-	if _, err := file.Seek(0, 0); err != nil {
-		t.Fatal(err)
-	}
-	os.Stdin = file
-	t.Cleanup(func() { os.Stdin = original; _ = file.Close() })
-	action()
-	os.Stdin = original
-}

cmd/vocat/install_script_test.go

@@ -1,31 +0,0 @@
-package main
-
-import (
-	"os"
-	"strings"
-	"testing"
-)
-
-func TestInstallerValidatesDatabaseBeforeReplacingBinary(t *testing.T) {
-	scriptBytes, err := os.ReadFile("../../scripts/install.sh")
-	if err != nil {
-		t.Fatal(err)
-	}
-	script := string(scriptBytes)
-	mainStart := strings.LastIndex(script, "# --- Main ")
-	if mainStart < 0 {
-		t.Fatal("installer main section not found")
-	}
-	main := script[mainStart:]
-	validateAt := strings.Index(main, `bootstrap_admin "${VOCAT_TMP}/vocat"`)
-	installAt := strings.Index(main, "install_binary")
-	if validateAt < 0 {
-		t.Fatal("installer does not validate the database with the downloaded binary")
-	}
-	if installAt < 0 {
-		t.Fatal("installer does not install the downloaded binary")
-	}
-	if validateAt > installAt {
-		t.Fatal("installer replaces the current binary before validating database compatibility")
-	}
-}

cmd/vocat/instance_lock_linux.go

@@ -1,45 +0,0 @@
-//go:build linux
-
-package main
-
-import (
-	"errors"
-	"fmt"
-	"os"
-	"path/filepath"
-
-	"golang.org/x/sys/unix"
-)
-
-func lockServerInstance(databasePath string) (*os.File, error) {
-	// The modem, PC/SC reader, XFRM policies and listener are host resources,
-	// not database resources. Lock per OS user so a diagnostic instance using a
-	// different VOCAT_DATABASE_PATH cannot silently steal the same AT port from
-	// the managed service. Prefer /run because systemd's PrivateTmp would
-	// otherwise hide the managed service's lock from a manually started process.
-	// The UID-specific directory still permits intentionally isolated users to
-	// operate independently; development hosts without writable /run fall back
-	// to TempDir.
-	uid := os.Geteuid()
-	directory := filepath.Join("/run", fmt.Sprintf("vocat-%d", uid))
-	if uid == 0 {
-		directory = "/run/vocat"
-	}
-	if err := os.MkdirAll(directory, 0o700); err != nil {
-		directory = os.TempDir()
-	}
-	path := filepath.Join(directory, "vocat-server.lock")
-	fd, err := unix.Open(path, unix.O_CREAT|unix.O_RDWR|unix.O_CLOEXEC|unix.O_NOFOLLOW, 0o600)
-	if err != nil {
-		return nil, fmt.Errorf("open server instance lock: %w", err)
-	}
-	file := os.NewFile(uintptr(fd), path)
-	if err := unix.Flock(fd, unix.LOCK_EX|unix.LOCK_NB); err != nil {
-		_ = file.Close()
-		if errors.Is(err, unix.EWOULDBLOCK) || errors.Is(err, unix.EAGAIN) {
-			return nil, errors.New("another vocat server already controls this host's modem resources")
-		}
-		return nil, fmt.Errorf("lock server instance: %w", err)
-	}
-	return file, nil
-}

cmd/vocat/instance_lock_linux_test.go

@@ -1,26 +0,0 @@
-//go:build linux
-
-package main
-
-import (
-	"path/filepath"
-	"strings"
-	"testing"
-)
-
-func TestServerInstanceLockRejectsSecondProcess(t *testing.T) {
-	firstDatabase := filepath.Join(t.TempDir(), "vocat.db")
-	first, err := lockServerInstance(firstDatabase)
-	if err != nil {
-		t.Fatal(err)
-	}
-	defer first.Close()
-	secondDatabase := filepath.Join(t.TempDir(), "other.db")
-	second, err := lockServerInstance(secondDatabase)
-	if second != nil {
-		second.Close()
-	}
-	if err == nil || !strings.Contains(err.Error(), "already controls this host") {
-		t.Fatalf("second lock error = %v", err)
-	}
-}

cmd/vocat/instance_lock_other.go

@@ -1,12 +0,0 @@
-//go:build !linux
-
-package main
-
-import (
-	"os"
-	"path/filepath"
-)
-
-func lockServerInstance(databasePath string) (*os.File, error) {
-	return os.OpenFile(filepath.Join(filepath.Dir(databasePath), ".vocat.lock"), os.O_CREATE|os.O_RDWR, 0o600)
-}

cmd/vocat/main.go

@@ -27,8 +27,6 @@ import (
 	"vocat/internal/extensions"
 	"vocat/internal/httpsmode"
 	"vocat/internal/loghub"
-	"vocat/internal/modem"
-	"vocat/internal/pcsc"
 	"vocat/internal/server"
 	"vocat/internal/store"
 	"vocat/internal/update"
@@ -90,13 +88,6 @@ func main() {
 			logger.Error("develop failed", "error", err)
 			os.Exit(2)
 		}
-	case "bootstrap-admin":
-		// Installer-only command. The password is read from stdin so it never
-		// appears in argv, an environment file, or process listings.
-		if err := runBootstrapAdmin(rest); err != nil {
-			logger.Error("bootstrap admin failed", "error", err)
-			os.Exit(1)
-		}
 	case "help", "-h", "--help":
 		printUsage(os.Stdout)
 	default:
@@ -120,11 +111,12 @@ func run(logger *slog.Logger, logs *loghub.Hub) error {
 	if err != nil {
 		return fmt.Errorf("load configuration: %w", err)
 	}
-	instanceLock, err := lockServerInstance(cfg.DatabasePath)
-	if err != nil {
-		return err
+	if cfg.UsesDefaultCredentials() {
+		logger.Warn(
+			"default admin credentials are active; set VOCAT_ADMIN_PASSWORD before exposing the service",
+		)
 	}
-	defer instanceLock.Close()
+
 	startupContext, cancelStartup := context.WithTimeout(context.Background(), 15*time.Second)
 	defer cancelStartup()
 
@@ -184,15 +176,15 @@ func run(logger *slog.Logger, logs *loghub.Hub) error {
 	if err != nil {
 		return err
 	}
-	if _, adminErr := database.CurrentAdmin(startupContext); adminErr != nil {
-		if errors.Is(adminErr, store.ErrNotFound) {
-			return errors.New("administrator is not initialized; run vocat bootstrap-admin before starting the service")
-		}
-		return fmt.Errorf("read administrator: %w", adminErr)
+	if err := authService.EnsureAdmin(
+		startupContext,
+		cfg.AdminUsername,
+		cfg.AdminPassword,
+	); err != nil {
+		return err
 	}
 
-	cardReaders := pcsc.New()
-	deviceManager, err := device.NewManager(device.Options{CardReaders: cardReaders})
+	deviceManager, err := device.NewManager(device.Options{})
 	if err != nil {
 		return fmt.Errorf("create device manager: %w", err)
 	}
@@ -228,7 +220,6 @@ func run(logger *slog.Logger, logs *loghub.Hub) error {
 		logger,
 		database,
 		deviceManager,
-		cardReaders,
 	)
 	if err != nil {
 		return fmt.Errorf("configure VoWiFi runtime: %w", err)
@@ -371,12 +362,6 @@ func configureDeviceBackends(
 		if mapErr != nil {
 			continue
 		}
-		if config.DeviceType == store.DeviceTypeUSBSIMReader {
-			if err := manager.SetSIMPin(entry.ID, config.SIMPIN); err != nil {
-				logger.Warn("configure USB SIM reader", "device_id", config.ID, "error", err)
-			}
-			continue
-		}
 		if err := manager.SetBackend(entry.ID, config.DeviceBackend); err != nil {
 			logger.Warn("configure device backend", "device_id", config.ID, "backend", config.DeviceBackend, "error", err)
 		}
@@ -399,9 +384,6 @@ func restoreDefaultCellularRadios(
 	}
 	mapper := integration.ATMapper{Store: database, Devices: manager}
 	for _, config := range configs {
-		if config.DeviceType == store.DeviceTypeUSBSIMReader {
-			continue
-		}
 		if config.VoWiFiEnabled {
 			continue
 		}
@@ -449,9 +431,6 @@ func restoreConfiguredCellularData(
 	}
 	mapper := integration.ATMapper{Store: database, Devices: manager}
 	for _, config := range configs {
-		if config.DeviceType == store.DeviceTypeUSBSIMReader {
-			continue
-		}
 		if !config.NetworkEnabled || config.VoWiFiEnabled {
 			continue
 		}
@@ -503,9 +482,6 @@ func disableAllDeveloperCellularData(
 	}
 	mapper := integration.ATMapper{Store: database, Devices: manager}
 	for _, config := range configs {
-		if config.DeviceType == store.DeviceTypeUSBSIMReader {
-			continue
-		}
 		entry, err := mapper.Get(config.ID)
 		if err != nil {
 			continue
@@ -560,13 +536,12 @@ func configureVoWiFiRuntime(
 	logger *slog.Logger,
 	database *store.Store,
 	deviceManager *device.Manager,
-	cardReaders *pcsc.Service,
 ) (*vowifiruntime.Manager, error) {
 	mapper := integration.ATMapper{
 		Store:   database,
 		Devices: deviceManager,
 	}
-	ec20Adapter, err := vowifi.NewEC20Adapter(mapper, vowifi.EC20AdapterOptions{
+	adapter, err := vowifi.NewEC20Adapter(mapper, vowifi.EC20AdapterOptions{
 		// The test deployment is deliberately non-cellular. VoWiFi teardown
 		// may restore CFUN, but it must never reactivate a PDP context.
 		RestoreCellularData: false,
@@ -581,16 +556,6 @@ func configureVoWiFiRuntime(
 	if err != nil {
 		return nil, err
 	}
-	pcscAdapter, err := vowifi.NewPCSCAdapter(cardReaders, func(ctx context.Context, deviceID string) (pcsc.Selector, string, error) {
-		config, resolveErr := database.Device(ctx, strings.TrimSpace(deviceID))
-		if resolveErr != nil {
-			return pcsc.Selector{}, "", resolveErr
-		}
-		return pcsc.Selector{USBPath: config.USBPath, ReaderName: config.ControlDevice}, config.SIMPIN, nil
-	})
-	if err != nil {
-		return nil, err
-	}
 	projector := integration.StateProjector{
 		Store:   database,
 		Devices: mapper,
@@ -603,10 +568,6 @@ func configureVoWiFiRuntime(
 			if err != nil {
 				return nil, fmt.Errorf("load device %q VoWiFi config: %w", deviceID, err)
 			}
-			adapter := vowifiDeviceAdapter(ec20Adapter)
-			if deviceConfig.DeviceType == store.DeviceTypeUSBSIMReader {
-				adapter = pcscAdapter
-			}
 			return newVoWiFiOrchestrator(deviceConfig, database, adapter)
 		},
 	})
@@ -623,18 +584,12 @@ func configureVoWiFiRuntime(
 		}
 		if deviceConfig.VoWiFiEnabled {
 			if entry, mapErr := mapper.Get(deviceConfig.ID); mapErr == nil {
-				flightErr := protectVoWiFiStartupRadio(ctx, deviceManager, entry.ID)
+				flightContext, cancelFlight := context.WithTimeout(ctx, 10*time.Second)
+				_, flightErr := deviceManager.SetFlight(flightContext, entry.ID, true)
+				cancelFlight()
 				if flightErr != nil {
-					// A modem can be temporarily unavailable while OpenWrt/procd is
-					// restarting the service (notably after loading XFRM modules). Do
-					// not take the Web/API service down with it: the orchestrator below
-					// remains fail-closed and its runtime manager retries until CFUN=4
-					// can be established.
-					logger.Warn(
-						"VoWiFi startup radio protection deferred to automatic retry",
-						"device_id", deviceConfig.ID,
-						"error", flightErr,
-					)
+					_ = manager.Close(context.Background())
+					return nil, fmt.Errorf("protect device %q before VoWiFi startup: %w", deviceConfig.ID, flightErr)
 				}
 			}
 			if _, err := manager.RequestEnabled(deviceConfig.ID, true); err != nil {
@@ -646,66 +601,10 @@ func configureVoWiFiRuntime(
 	return manager, nil
 }
 
-const (
-	vowifiStartupRadioAttempts = 3
-	vowifiStartupRadioDelay    = time.Second
-)
-
-type flightModeSetter interface {
-	SetFlight(context.Context, string, bool) (device.FlightResult, error)
-}
-
-func protectVoWiFiStartupRadio(ctx context.Context, manager flightModeSetter, physicalID string) error {
-	return protectVoWiFiStartupRadioWithRetry(
-		ctx,
-		manager,
-		physicalID,
-		vowifiStartupRadioAttempts,
-		vowifiStartupRadioDelay,
-	)
-}
-
-func protectVoWiFiStartupRadioWithRetry(
-	ctx context.Context,
-	manager flightModeSetter,
-	physicalID string,
-	attempts int,
-	delay time.Duration,
-) error {
-	var lastErr error
-	for attempt := 0; attempt < attempts; attempt++ {
-		flightContext, cancel := context.WithTimeout(ctx, 10*time.Second)
-		_, lastErr = manager.SetFlight(flightContext, physicalID, true)
-		cancel()
-		if lastErr == nil {
-			return nil
-		}
-		if attempt+1 == attempts {
-			break
-		}
-		timer := time.NewTimer(delay)
-		select {
-		case <-ctx.Done():
-			if !timer.Stop() {
-				<-timer.C
-			}
-			return errors.Join(lastErr, ctx.Err())
-		case <-timer.C:
-		}
-	}
-	return lastErr
-}
-
-type vowifiDeviceAdapter interface {
-	vowifi.SIMIdentityReader
-	vowifi.AKAProvider
-	vowifi.RadioController
-}
-
 func newVoWiFiOrchestrator(
 	deviceConfig store.Device,
 	database *store.Store,
-	adapter vowifiDeviceAdapter,
+	adapter *vowifi.EC20Adapter,
 ) (*vowifi.Orchestrator, error) {
 	apn := deviceConfig.APN
 	if apn == "" {
@@ -716,13 +615,9 @@ func newVoWiFiOrchestrator(
 		return nil, fmt.Errorf("device %q IKE provider: %w", deviceConfig.ID, err)
 	}
 	imsProvider, err := ims.NewProvider(adapter, ims.Config{
-		// The userspace SWu data plane carries protected P-CSCF signalling over
-		// TCP by default. UK PLMN 234-10 exposes its P-CSCF over UDP/5060 on SWu.
+		// The userspace SWu data plane currently carries the protected P-CSCF
+		// signalling path over TCP.
 		Transport: "tcp",
-		TransportByPLMN: map[string]string{
-			"23410":  "udp",
-			"234010": "udp",
-		},
 		// Some Vodafone UK SIM profiles leave AT+CSCA empty; Vodafone publishes
 		// this service-centre number for manual SMS setup.
 		SMSCenter: "+447785016005",
@@ -837,20 +732,11 @@ func provisionDiscoveredDevices(
 	}
 	for _, discovered := range manager.List() {
 		candidate := discovered.Candidate
-		deviceType := provisionedDeviceType(candidate)
 		backend := "at"
 		control := candidate.ATPort.OpenPath()
-		esimTransport := backend
 		if candidate.QMIControl != "" {
 			backend = "qmi"
 			control = candidate.QMIControl
-			esimTransport = backend
-		}
-		if candidate.HardwareKind == pcsc.HardwareKind {
-			backend = "pcsc"
-			control = candidate.ReaderName
-			deviceType = store.DeviceTypeUSBSIMReader
-			esimTransport = "pcsc"
 		}
 		name := candidate.Product
 		if name == "" || strings.EqualFold(name, "Android") {
@@ -859,7 +745,6 @@ func provisionDiscoveredDevices(
 		if err := database.UpsertDevice(ctx, store.Device{
 			ID:             discovered.ID,
 			Name:           name,
-			DeviceType:     deviceType,
 			Interface:      candidate.NetworkInterface,
 			ControlDevice:  control,
 			ATPort:         candidate.ATPort.OpenPath(),
@@ -870,7 +755,7 @@ func provisionDiscoveredDevices(
 			StopBits:       1,
 			Parity:         "none",
 			DeviceBackend:  backend,
-			ESIMTransport:  esimTransport,
+			ESIMTransport:  backend,
 			NetworkEnabled: false,
 			SMSEnabled:     true,
 			VoWiFiEnabled:  true,
@@ -881,15 +766,6 @@ func provisionDiscoveredDevices(
 	return nil
 }
 
-func provisionedDeviceType(candidate modem.Candidate) string {
-	controlName := filepath.Base(filepath.Clean(candidate.QMIControl))
-	if candidate.HardwareKind == "wwan" &&
-		strings.HasPrefix(controlName, "wwan") && strings.Contains(controlName, "qmi") {
-		return store.DeviceTypeWiFi410
-	}
-	return store.DeviceTypePCIeEC20EC25
-}
-
 // persistLogsToStore subscribes to the live log hub and durably appends every
 // entry to the log_events table, so runtime logs survive restarts and can be
 // pruned by the configured retention policy.
@@ -952,7 +828,7 @@ func pollDeviceSnapshots(
 		var refreshGroup sync.WaitGroup
 		refreshSlots := make(chan struct{}, 4)
 		for _, entry := range entries {
-			if !entry.Discovered || entry.Candidate.DiscoveryIssue != "" {
+			if !entry.Discovered {
 				continue
 			}
 			entry := entry
@@ -1055,7 +931,6 @@ func reconcileCardPolicies(
 	manager *device.Manager,
 	vowifiManager *vowifiruntime.Manager,
 ) {
-	observedCards := make(map[string]string)
 	reconcile := func() {
 		policies, policyListErr := database.ListCardPolicies(ctx)
 		if policyListErr == nil {
@@ -1078,26 +953,12 @@ func reconcileCardPolicies(
 		for _, config := range configs {
 			entry, mapErr := mapper.Get(config.ID)
 			if mapErr != nil || entry.Snapshot == nil {
-				if config.DeviceType == store.DeviceTypeUSBSIMReader && observedCards[config.ID] != "missing" {
-					if state, stateErr := vowifiManager.State(config.ID); stateErr == nil && state.ICCID != "" {
-						_, _ = vowifiManager.RequestReconnect(config.ID)
-					}
-					observedCards[config.ID] = "missing"
-				}
 				continue
 			}
 			iccid := strings.TrimSpace(entry.Snapshot.ICCID)
 			if iccid == "" {
-				if config.DeviceType == store.DeviceTypeUSBSIMReader && observedCards[config.ID] != "missing" {
-					if state, stateErr := vowifiManager.State(config.ID); stateErr == nil && state.ICCID != "" {
-						_, _ = vowifiManager.RequestReconnect(config.ID)
-					}
-					observedCards[config.ID] = "missing"
-				}
 				continue
 			}
-			previousObserved := observedCards[config.ID]
-			observedCards[config.ID] = iccid
 			policy, policyErr := database.CardPolicy(ctx, iccid)
 			if policyErr != nil {
 				continue
@@ -1140,8 +1001,6 @@ func reconcileCardPolicies(
 					_, _ = vowifiManager.RequestEnabled(config.ID, true)
 				case state.ICCID != "" && !strings.EqualFold(strings.TrimSpace(state.ICCID), iccid):
 					_, _ = vowifiManager.RequestReconnect(config.ID)
-				case config.DeviceType == store.DeviceTypeUSBSIMReader && previousObserved == "missing":
-					_, _ = vowifiManager.RequestReconnect(config.ID)
 				}
 				continue
 			}

cmd/vocat/main_test.go

@@ -217,24 +217,3 @@ func TestEnforceCardRegionIgnoresUnknownOrNotReadySIM(t *testing.T) {
 		t.Fatalf("expected no card policies, got %d", len(policies))
 	}
 }
-
-func TestProvisionedDeviceTypeRecognizesNativeWWAN(t *testing.T) {
-	native := modem.Candidate{
-		HardwareKind: "wwan",
-		USBPath:      "/sys/devices/pci0000:00/0000:00:00.0/wwan/wwan0",
-		QMIControl:   "/dev/wwan0qmi0",
-		ATPort:       modem.Port{Path: "/dev/wwan0at0"},
-	}
-	if got := provisionedDeviceType(native); got != store.DeviceTypeWiFi410 {
-		t.Fatalf("native WWAN type = %q, want %q", got, store.DeviceTypeWiFi410)
-	}
-
-	usb := modem.Candidate{
-		USBPath:    "/sys/bus/usb/devices/1-6",
-		QMIControl: "/dev/cdc-wdm0",
-		ATPort:     modem.Port{Path: "/dev/ttyUSB2"},
-	}
-	if got := provisionedDeviceType(usb); got != store.DeviceTypePCIeEC20EC25 {
-		t.Fatalf("USB modem type = %q, want %q", got, store.DeviceTypePCIeEC20EC25)
-	}
-}

cmd/vocat/menu.go

@@ -22,8 +22,9 @@ import (
 	"vocat/internal/update"
 )
 
-// envFilePath carries non-secret service settings such as the Web listen port.
-// Administrator credentials live exclusively in the database.
+// envFilePath is the systemd EnvironmentFile that carries VOCAT_ADMIN_PASSWORD.
+// EnsureAdmin reseeds the DB from it on every start, so change-password must
+// rewrite it or the next restart reverts the password.
 const envFilePath = "/etc/vocat/env"
 
 // legacyEnvFilePath was used by the standalone deploy/vocat.service. Keep it
@@ -50,8 +51,8 @@ const uiPreferencesSettingKey = "ui.preferences"
 // rc) and VOCAT_DATABASE_PATH is unset, so config.Load() would resolve a
 // CWD-relative ./data/vocat.db — a different, empty database than
 // /opt/vocat/data/vocat.db the service uses. This loads the installed env file
-// and pins VOCAT_DATABASE_PATH to the install default, without overriding any
-// value the operator already exported. Legacy credential entries are ignored.
+// for VOCAT_ADMIN_PASSWORD and pins VOCAT_DATABASE_PATH to the install default,
+// without overriding any value the operator already exported.
 func loadMenuEnv() {
 	if _, ok := os.LookupEnv("VOCAT_DATABASE_PATH"); !ok {
 		_ = os.Setenv("VOCAT_DATABASE_PATH", defaultDatabasePath)
@@ -67,9 +68,6 @@ func loadMenuEnv() {
 				continue
 			}
 			key := strings.TrimSpace(line[:eq])
-			if key == "VOCAT_ADMIN_USERNAME" || key == "VOCAT_ADMIN_PASSWORD" || key == "VOCAT_ADMIN_PASSWORD_B64" {
-				continue
-			}
 			val := strings.TrimSpace(line[eq+1:])
 			if _, ok := os.LookupEnv(key); !ok {
 				_ = os.Setenv(key, val)
@@ -88,7 +86,7 @@ func menuEnvFilePath() string {
 	return envFilePath
 }
 
-// runMenu is the interactive lifecycle menu: toggle language, reset credentials,
+// runMenu is the interactive lifecycle menu: toggle language, change password,
 // change the Web listener port, restart the systemd unit, self-update, or fully
 // uninstall vocat. It must run as root on the host (needs systemctl + the 0600
 // env file). Docker deployments do not use it.
@@ -128,7 +126,7 @@ func runMenu(logger *slog.Logger) error {
 				fmt.Println(menu.errorPrefix(err))
 			}
 		case "2":
-			if err := menuResetAdminCredentials(reader, menu); err != nil {
+			if err := menuChangePassword(reader, menu, logger); err != nil {
 				fmt.Println(menu.errorPrefix(err))
 			}
 		case "3":
@@ -193,12 +191,13 @@ func loadMenuLanguage() (string, error) {
 	return "en", nil
 }
 
-func menuResetAdminCredentials(reader *bufio.Reader, m *menu) error {
+func menuChangePassword(reader *bufio.Reader, m *menu, logger *slog.Logger) error {
 	cfg, err := config.Load()
 	if err != nil {
 		return fmt.Errorf("%w: %v", errMenuConfig, err)
 	}
-	ctx := context.Background()
+	ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
+	defer cancel()
 
 	database, err := store.Open(ctx, cfg.DatabasePath)
 	if err != nil {
@@ -210,18 +209,11 @@ func menuResetAdminCredentials(reader *bufio.Reader, m *menu) error {
 	if err != nil {
 		return fmt.Errorf("%w: %v", errMenuAuth, err)
 	}
-	admin, err := database.CurrentAdmin(ctx)
+
+	fmt.Print(m.currentPassword())
+	currentPw, err := readPasswordMasked()
 	if err != nil {
-		return fmt.Errorf("%w: %v", errMenuStore, err)
-	}
-	fmt.Print(m.newUsername(admin.Username))
-	username, err := reader.ReadString('\n')
-	if err != nil {
-		return fmt.Errorf("read administrator username: %w", err)
-	}
-	username = strings.TrimSpace(username)
-	if username == "" {
-		username = admin.Username
+		return err
 	}
 	fmt.Print(m.newPassword())
 	newPw, err := readPasswordMasked()
@@ -237,9 +229,19 @@ func menuResetAdminCredentials(reader *bufio.Reader, m *menu) error {
 	if newPw != confirmPw {
 		return errPasswordsDiffer
 	}
-	if err := authService.ResetAdminCredentials(ctx, username, newPw); err != nil {
+	if err := authService.ChangePassword(ctx, cfg.AdminUsername, currentPw, newPw); err != nil {
+		if errors.Is(err, auth.ErrInvalidCredentials) {
+			return errCurrentWrong
+		}
 		return fmt.Errorf("%w: %v", errMenuAuth, err)
 	}
+	// Persist the new plaintext to the env file so the next EnsureAdmin (on
+	// restart) agrees with the hash we just wrote to the DB. Without this the
+	// restart reverts the password to whatever the env file still holds.
+	if err := rewriteEnvPassword(newPw); err != nil {
+		logger.Error("menu: password changed in DB but env file rewrite failed; restart will revert", "error", err)
+		return fmt.Errorf("%w: %v", errMenuEnvWrite, err)
+	}
 	fmt.Println(m.passwordChanged())
 	return nil
 }
@@ -256,15 +258,20 @@ func readPasswordMasked() (string, error) {
 	return string(bytes), nil
 }
 
+// rewriteEnvPassword replaces (or appends) the VOCAT_ADMIN_PASSWORD line in the
+// systemd EnvironmentFile and keeps the file 0600. The replacement is atomic:
+// the temp file lives in the same directory so os.Rename stays on one
+// filesystem.
+func rewriteEnvPassword(newPassword string) error {
+	return rewriteEnvValue(menuEnvFilePath(), "VOCAT_ADMIN_PASSWORD", newPassword)
+}
+
 // rewriteEnvValue replaces or appends one systemd EnvironmentFile value. The
 // write is atomic and rejects line breaks so one setting cannot inject another.
 func rewriteEnvValue(path, name, value string) error {
 	if name == "" || strings.ContainsAny(name, "=\r\n\x00") || strings.ContainsAny(value, "\r\n\x00") {
 		return errors.New("invalid environment setting")
 	}
-	if strings.HasPrefix(name, "VOCAT_ADMIN_") {
-		return errors.New("administrator credentials cannot be stored in the environment file")
-	}
 	key := name + "="
 	var lines []string
 	if data, err := os.ReadFile(path); err == nil {
@@ -275,17 +282,12 @@ func rewriteEnvValue(path, name, value string) error {
 
 	replaced := false
 	for i, line := range lines {
-		if strings.HasPrefix(line, "VOCAT_ADMIN_USERNAME=") || strings.HasPrefix(line, "VOCAT_ADMIN_PASSWORD=") || strings.HasPrefix(line, "VOCAT_ADMIN_PASSWORD_B64=") {
-			lines[i] = ""
-			continue
-		}
 		if strings.HasPrefix(line, key) {
 			lines[i] = key + value
 			replaced = true
 			break
 		}
 	}
-	lines = compactNonEmptyLines(lines)
 	if !replaced {
 		lines = append(lines, key+value)
 	}
@@ -296,16 +298,6 @@ func rewriteEnvValue(path, name, value string) error {
 	return writeEnvFileAtomic(path, []byte(content))
 }
 
-func compactNonEmptyLines(lines []string) []string {
-	result := lines[:0]
-	for _, line := range lines {
-		if line != "" {
-			result = append(result, line)
-		}
-	}
-	return result
-}
-
 func writeEnvFileAtomic(path string, content []byte) error {
 	dirIndex := strings.LastIndexAny(path, "/\\")
 	if dirIndex < 0 {
@@ -523,7 +515,6 @@ func menuUpdate(m *menu, logger *slog.Logger) error {
 	}
 	fmt.Println(m.updateChecking())
 	if err := update.Run(logger, []string{"--repo", repo}); err != nil {
-		logger.Error("menu update failed", "error", err)
 		return fmt.Errorf("%w: %v", errUpdateFailed, err)
 	}
 	return nil
@@ -563,6 +554,7 @@ func menuUninstall(reader *bufio.Reader, m *menu) error {
 
 // menu-local sentinel errors so callers can map them to localized messages.
 var (
+	errCurrentWrong       = errors.New("menu: current password is incorrect")
 	errPasswordsDiffer    = errors.New("menu: passwords do not match")
 	errNoSystemctl        = errors.New("menu: systemctl not found")
 	errRestartFailed      = errors.New("menu: restart failed")
@@ -570,6 +562,7 @@ var (
 	errMenuConfig         = errors.New("menu: load configuration")
 	errMenuStore          = errors.New("menu: open database")
 	errMenuAuth           = errors.New("menu: auth service")
+	errMenuEnvWrite       = errors.New("menu: write env file")
 	errMenuPortWrite      = errors.New("menu: write Web port")
 	errInvalidWebPort     = errors.New("menu: invalid Web port")
 	errWebPortUnavailable = errors.New("menu: Web port unavailable")
@@ -587,17 +580,17 @@ func (m *menu) msg(key string) string {
 	table := map[string][2]string{
 		"title":               {"vocat 管理菜单", "vocat management menu"},
 		"opt_lang":            {"1) 切换中英文", "1) Toggle language"},
-		"opt_change":          {"2) 修改账号密码", "2) Change admin credentials"},
+		"opt_change":          {"2) 修改账号密码", "2) Change admin password"},
 		"opt_port":            {"3) 修改 Web 监听端口", "3) Change Web listening port"},
 		"opt_restart":         {"4) 重启软件", "4) Restart software"},
 		"opt_update":          {"5) 更新软件", "5) Update software"},
 		"opt_uninstall":       {"0) 卸载软件", "0) Uninstall software"},
 		"prompt":              {"请选择: ", "Select: "},
 		"invalid":             {"无效选项，请重试。按 Ctrl+C 退出。", "Invalid choice, try again. Press Ctrl+C to exit."},
-		"new_username":        {"新用户名（直接回车保留 %s）: ", "New username (Enter to keep %s): "},
-		"new_pw":              {"新密码: ", "New password: "},
+		"cur_pw":              {"当前密码: ", "Current password: "},
+		"new_pw":              {"新密码 (至少 12 位): ", "New password (min 12 chars): "},
 		"confirm_pw":          {"确认新密码: ", "Confirm new password: "},
-		"pw_changed":          {"管理员账号密码已修改，现有 Web 会话已退出。", "Administrator credentials changed; existing Web sessions were signed out."},
+		"pw_changed":          {"密码已修改。重启后仍然有效。", "Password changed. Survives restart."},
 		"current_web_address": {"当前 Web 监听地址: %s", "Current Web listening address: %s"},
 		"new_web_port":        {"新端口 (1-65535，直接回车取消，当前 %s): ", "New port (1-65535, Enter to cancel, current %s): "},
 		"web_port_cancelled":  {"已取消修改端口。", "Web port change cancelled."},
@@ -631,12 +624,10 @@ func (m *menu) msg(key string) string {
 	return entry[zh]
 }
 
-func (m *menu) title() string   { return m.msg("title") }
-func (m *menu) prompt() string  { return m.msg("prompt") }
-func (m *menu) invalid() string { return m.msg("invalid") }
-func (m *menu) newUsername(current string) string {
-	return fmt.Sprintf(m.msg("new_username"), current)
-}
+func (m *menu) title() string           { return m.msg("title") }
+func (m *menu) prompt() string          { return m.msg("prompt") }
+func (m *menu) invalid() string         { return m.msg("invalid") }
+func (m *menu) currentPassword() string { return m.msg("cur_pw") }
 func (m *menu) newPassword() string     { return m.msg("new_pw") }
 func (m *menu) confirmPassword() string { return m.msg("confirm_pw") }
 func (m *menu) passwordChanged() string { return m.msg("pw_changed") }
@@ -671,6 +662,11 @@ func (m *menu) options() []string {
 
 func (m *menu) errorPrefix(err error) string {
 	switch {
+	case errors.Is(err, errCurrentWrong):
+		if m.lang == "en" {
+			return "Current password is incorrect."
+		}
+		return "当前密码不正确。"
 	case errors.Is(err, errPasswordsDiffer):
 		if m.lang == "en" {
 			return "Passwords do not match."
@@ -687,11 +683,10 @@ func (m *menu) errorPrefix(err error) string {
 		}
 		return "重启失败。"
 	case errors.Is(err, errUpdateFailed):
-		detail := strings.TrimPrefix(err.Error(), errUpdateFailed.Error()+": ")
 		if m.lang == "en" {
-			return "Update failed: " + detail
+			return "Update failed."
 		}
-		return "更新失败: " + detail
+		return "更新失败。"
 	case errors.Is(err, errMenuConfig):
 		if m.lang == "en" {
 			return "Failed to load configuration."
@@ -707,6 +702,11 @@ func (m *menu) errorPrefix(err error) string {
 			return "Auth service error."
 		}
 		return "认证服务错误。"
+	case errors.Is(err, errMenuEnvWrite):
+		if m.lang == "en" {
+			return "Password changed in DB, but the env file rewrite failed — restart will revert it. Check " + menuEnvFilePath() + "."
+		}
+		return "数据库密码已修改，但环境变量文件写入失败——重启后将回滚。请检查 " + menuEnvFilePath() + "。"
 	case errors.Is(err, errInvalidWebPort):
 		if m.lang == "en" {
 			return "Invalid port. Enter a number from 1 to 65535."

cmd/vocat/menu_test.go

@@ -53,15 +53,12 @@ func TestRewriteEnvValuePreservesOtherSettings(t *testing.T) {
 		t.Fatal(err)
 	}
 	got := string(content)
-	if strings.Contains(got, "VOCAT_ADMIN_PASSWORD") || !strings.Contains(got, "VOCAT_ADDR=0.0.0.0:8080\n") || strings.Contains(got, ":7575") {
+	if !strings.Contains(got, "VOCAT_ADMIN_PASSWORD=secret\n") || !strings.Contains(got, "VOCAT_ADDR=0.0.0.0:8080\n") || strings.Contains(got, ":7575") {
 		t.Fatalf("rewritten env = %q", got)
 	}
 	if err := rewriteEnvValue(path, "VOCAT_ADDR", "0.0.0.0:9000\nVOCAT_ADMIN_PASSWORD=changed"); err == nil {
 		t.Fatal("environment line injection was accepted")
 	}
-	if err := rewriteEnvValue(path, "VOCAT_ADMIN_PASSWORD", "changed-password"); err == nil {
-		t.Fatal("administrator credential was accepted for the environment file")
-	}
 }
 
 func TestMenuIncludesWebPortOptionInBothLanguages(t *testing.T) {
@@ -72,20 +69,3 @@ func TestMenuIncludesWebPortOptionInBothLanguages(t *testing.T) {
 		}
 	}
 }
-
-func TestMenuCredentialResetPromptsDoNotRequestCurrentPassword(t *testing.T) {
-	for _, lang := range []string{"zh", "en"} {
-		menu := newMenu(lang)
-		prompts := strings.Join([]string{
-			menu.newUsername("admin"),
-			menu.newPassword(),
-			menu.confirmPassword(),
-		}, "\n")
-		if strings.Contains(strings.ToLower(prompts), "current password") || strings.Contains(prompts, "当前密码") {
-			t.Fatalf("%s credential reset still requests the current password: %q", lang, prompts)
-		}
-		if !strings.Contains(prompts, "admin") {
-			t.Fatalf("%s username prompt does not show the current username: %q", lang, prompts)
-		}
-	}
-}

cmd/vocat/vowifi_startup_test.go

@@ -1,56 +0,0 @@
-package main
-
-import (
-	"context"
-	"errors"
-	"testing"
-
-	"vocat/internal/device"
-)
-
-type startupFlightSetter struct {
-	errors []error
-	calls  int
-	id     string
-}
-
-func (setter *startupFlightSetter) SetFlight(
-	_ context.Context,
-	id string,
-	enabled bool,
-) (device.FlightResult, error) {
-	setter.calls++
-	setter.id = id
-	if !enabled {
-		return device.FlightResult{}, errors.New("expected flight mode to be enabled")
-	}
-	if setter.calls <= len(setter.errors) {
-		return device.FlightResult{}, setter.errors[setter.calls-1]
-	}
-	return device.FlightResult{CurrentMode: 4, FlightMode: true, RadioOff: true}, nil
-}
-
-func TestProtectVoWiFiStartupRadioRetriesTransientFailure(t *testing.T) {
-	transient := errors.New("modem is reopening")
-	setter := &startupFlightSetter{errors: []error{transient, transient}}
-	if err := protectVoWiFiStartupRadioWithRetry(
-		context.Background(), setter, "quectel-1", 3, 0,
-	); err != nil {
-		t.Fatalf("protect startup radio: %v", err)
-	}
-	if setter.calls != 3 || setter.id != "quectel-1" {
-		t.Fatalf("SetFlight calls = %d, id = %q", setter.calls, setter.id)
-	}
-}
-
-func TestProtectVoWiFiStartupRadioReturnsLastFailure(t *testing.T) {
-	first := errors.New("first")
-	last := errors.New("last")
-	setter := &startupFlightSetter{errors: []error{first, last}}
-	err := protectVoWiFiStartupRadioWithRetry(
-		context.Background(), setter, "quectel-1", 2, 0,
-	)
-	if !errors.Is(err, last) || setter.calls != 2 {
-		t.Fatalf("protect startup radio = %v after %d calls", err, setter.calls)
-	}
-}

docker-compose.yml

@@ -1,12 +1,9 @@
 # VoCat Docker Compose deployment.
 #
-# First-time setup (password is read from stdin and stored only in SQLite):
-#   docker compose pull
-#   read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-#   printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | docker compose run --rm -T \
-#     --entrypoint /opt/vocat/bin/vocat vocat bootstrap-admin
-#   unset VOCAT_BOOTSTRAP_PASSWORD
-#   docker compose up -d
+# First-time setup:
+#   cp .env.example .env        # then edit VOCAT_ADMIN_PASSWORD
+#   docker compose pull         # fetch the prebuilt GHCR image
+#   docker compose up -d        # start
 #
 # Build locally from this repo instead of using the GHCR image:
 #   docker compose up -d --build
@@ -38,26 +35,26 @@ services:
     # reachable on the host IP without explicit mapping.
     network_mode: host
 
-    # Modem/QMI/USB-reader hot-plug uses dynamic character devices. Privileged
-    # mode mirrors the documented hardware-access docker run command and also
-    # supplies the raw-socket/netlink permissions needed by VoWiFi/IPsec.
-    privileged: true
-    user: "0:0"
+    # VoWiFi / eSIM / IMS paths need raw sockets (IPsec, netlink). The systemd
+    # unit grants CAP_NET_ADMIN + CAP_NET_RAW; mirror that here.
+    cap_add:
+      - NET_ADMIN
+      - NET_RAW
 
     environment:
       # Marks the process as containerized: the web UI then advertises
       # "pull new image" instead of attempting an in-place binary update.
       VOCAT_CONTAINER: docker
-      # VOCAT_ADDR / VOCAT_DATABASE_PATH are set in the Dockerfile. Admin
-      # credentials are stored only in SQLite and are not process environment.
+      # VOCAT_ADDR / VOCAT_DATABASE_PATH are set in the Dockerfile; override
+      # only if you want non-default values. Sensitive values come from .env.
+      VOCAT_ADMIN_PASSWORD: ${VOCAT_ADMIN_PASSWORD:?set VOCAT_ADMIN_PASSWORD in .env}
 
     volumes:
-      # SQLite database + persistent state.
+      # SQLite database + persistent state. Named volume (not a bind mount)
+      # because the container runs as uid 1000 (vocat) while a bind-mounted
+      # host dir would be root-owned and unwritable. Docker gives the named
+      # volume the image's uid 1000 ownership automatically.
       - vocat-data:/opt/vocat/data
-      # Required for modem, MHI/WWAN and PC/SC USB-reader discovery, including
-      # devices added after the container starts.
-      - /dev:/dev
-      - /sys:/sys:ro
 
 volumes:
   vocat-data:

docs/README.ar.md

@@ -1,341 +0,0 @@
-<p align="center">
-  <img src="../web/public/favicon.svg" width="96" alt="Vocat">
-</p>
-
-<h1 align="center">VoCat</h1>
-
-<p align="center">
-  <img alt="Go" src="https://img.shields.io/badge/Go-1.25-00ADD8?style=flat-square&logo=go&logoColor=white">
-  <img alt="React" src="https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=111111">
-  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.8-3178C6?style=flat-square&logo=typescript&logoColor=white">
-  <img alt="Vite" src="https://img.shields.io/badge/Vite-7-646CFF?style=flat-square&logo=vite&logoColor=white">
-  <img alt="Tailwind CSS" src="https://img.shields.io/badge/Tailwind_CSS-3-06B6D4?style=flat-square&logo=tailwindcss&logoColor=white">
-  <img alt="SQLite" src="https://img.shields.io/badge/SQLite-Embedded-003B57?style=flat-square&logo=sqlite&logoColor=white">
-</p>
-
-<p align="center">
-  <img alt="Linux" src="https://img.shields.io/badge/Linux-amd64_%7C_386_%7C_arm64_%7C_aarch64_%7C_armv7-FCC624?style=flat-square&logo=linux&logoColor=111111">
-  <img alt="Docker" src="https://img.shields.io/badge/Docker-Multi--Arch-2496ED?style=flat-square&logo=docker&logoColor=white">
-  <img alt="WiFi Calling" src="https://img.shields.io/badge/WiFi_Calling-IMS_SMS-7B1FA2?style=flat-square">
-  <img alt="eSIM" src="https://img.shields.io/badge/eSIM-LPA_%2F_eUICC-009688?style=flat-square">
-  <img alt="Telegram" src="https://img.shields.io/badge/Telegram-Bot-26A5E4?style=flat-square&logo=telegram&logoColor=white">
-  <img alt="GitHub Actions" src="https://img.shields.io/badge/GitHub_Actions-Release-2088FF?style=flat-square&logo=githubactions&logoColor=white">
-</p>
-
-[English](../README.md) | **العربية** | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [Français](README.fr.md) | [Русский](README.ru.md) | [Español](README.es.md) | [日本語](README.ja.md)
-
-Vocat هي لوحة تحكم ويب مفتوحة المصدر ومجموعة أدوات هندسية لمودمات Quectel الخلوية من فئة EC20/EC25. تجمع في خدمة واحدة مكتفية ذاتيًا بين اكتشاف المودم، وحالة الراديو المباشرة، وطرفيات AT وUSSD، والرسائل القصيرة SMS، وWiFi Calling، وإدارة eSIM، واختيار الشبكة، والتوجيه عبر البروكسي، والإشعارات، وسجلات التدقيق، وأتمتة الإصدارات.
-
-الواجهة الخلفية مكتوبة بلغة Go، والواجهة مبنية باستخدام React وTypeScript، وتُضمَّن واجهة الإنتاج الأمامية داخل الملف الثنائي لـ Go. يحتوي ملف تنفيذي واحد على تطبيق الويب ويستخدم SQLite للحالة الدائمة.
-
-<p align="center">
-  <img src="../img/image.png">
-  <img src="../img/image-1.png">
-</p>
-
-## الميزات
-
-| المجال | ما يوفره Vocat |
-| --- | --- |
-| إدارة الأجهزة | اكتشاف تلقائي عبر المنفذ التسلسلي/USB، دعم عدة مودمات، أسماء أجهزة مألوفة، تحديثات مباشرة للنظرة العامة، إعادة تشغيل الوحدة، وضع الطيران، وضوابط وضع شبكة USB. |
-| الراديو والشبكة | حالة التسجيل، المشغّل، مقاييس الإشارة، RSRP/RSRQ/SINR، وضع الشبكة، النطاق، القناة، فحص المشغّلين، والاختيار التلقائي أو اليدوي للشبكة. |
-| AT وUSSD | طرفية AT تفاعلية، سجل الأوامر، استجابات المودم الخام، تدفقات بدء/متابعة/إلغاء USSD، والإبلاغ الواضح عن أخطاء المودم. |
-| الرسائل القصيرة | إرسال مباشر للرسائل الخلوية ورسائل IMS، المزامنة الواردة، التعامل مع الرسائل متعددة الأجزاء، تقارير التسليم، سجل المحادثات، حالة عدم القراءة، الطوابع الزمنية، وحالة التسليم لكل رسالة. |
-| WiFi Calling | إنشاء نفق IKEv2/ePDG، مصادقة EAP-AKA، تسجيل IMS، رسائل IMS القصيرة، ضوابط إعادة الاتصال، تشخيصات الحالة، والتوجيه لكل جهاز. |
-| eSIM وeUICC | اكتشاف eUICC، ومعلومات EID والإنتاج، والبيانات الوصفية للشهادات، وجرد متعدد لـ eUICC، وقائمة الملفات الشخصية المثبتة، وعمليات التمكين/التعطيل/التبديل، وعمليات التنزيل وإعادة التسمية والحذف عندما تدعمها البطاقة. |
-| سياسة البطاقة | سلوك WiFi Calling ووضع الطيران بناءً على ICCID مع تطبيق فوري للسياسة. |
-| التوجيه عبر البروكسي | توجيه SOCKS صاعد، ربط الأجهزة، قواعد الدول، فحوصات الوصول عبر TCP، وفحوصات UDP Associate لمسارات بيانات WiFi Calling. |
-| الإشعارات | إعادة توجيه الرسائل القصيرة الواردة الجديدة عبر Telegram وBark والبريد الإلكتروني وPushplus وwebhooks الموقّعة. يتم تسليم كل رسالة كإشعار منفصل. |
-| بوت Telegram | حالة الجهاز، قائمة الملفات الشخصية المثبتة وتبديلها، ضوابط WiFi Calling، وإرسال الرسائل القصيرة. تتطلب الإجراءات الحساسة تأكيد المسؤول. |
-| العمليات | المصادقة، الحماية من CSRF، سياسات الوصول، أحداث التدقيق، السجلات المباشرة، الاحتفاظ بالسجلات، فحوصات الصحة، تخطيط متجاوب، الوضع الداكن، وواجهة مستخدم بالإنجليزية/الصينية. |
-| التوزيع | ملفات Linux الثنائية الثابتة، سكربت تثبيت systemd، تحديث ذاتي مع التحقق من SHA-256، صورة Docker، النشر إلى GHCR، وبنى إصدارات GitHub Actions. |
-
-## الأجهزة المدعومة
-
-يستهدف Vocat وحدات Quectel المبنية على Qualcomm والتي توفر واجهات AT وQMI والمنفذ التسلسلي وشبكة USB المتوافقة، بما في ذلك:
-
-- Quectel EC20
-- Quectel EC25
-- عائلة Quectel EG25
-- وحدات EG600 المتوافقة وذات الصلة
-
-تعتمد الميزات المتاحة على برنامج الوحدة الثابت (firmware)، وتكوين USB، وقدرات SIM/eSIM، وتعريفات المضيف، والشبكة اللاسلكية، وإعدادات المشغّل.
-
-## التثبيت
-
-### تثبيت Linux بنقرة واحدة
-
-بصفتك root (بما في ذلك OpenWrt/Kwrt، حيث يكون `sudo` غير موجود عادةً):
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash
-```
-
-من مستخدم عادي على توزيعة تحتوي على sudo:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | sudo bash
-```
-
-تحقق من متطلبات VoWiFi/XFRM على المضيف دون تثبيت VoCat:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash -s -- --check-env
-```
-
-تثبيت إصدار محدد:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh -o install.sh
-sudo bash install.sh 0.0.2
-```
-
-يتطلب VoWiFi IMS وجود Linux XFRM/IPsec. على OpenWrt/Kwrt يحاول المثبّت
-تثبيت الحزم المطابقة `ip-full` و`kmod-ipsec` و`kmod-ipsec4/6`
-و`kmod-crypto-authenc` وAES-CBC وSHA1 من مستودع البرنامج الثابت نفسه.
-إذا لم تكن وحدات النواة المطابقة متاحة، فاستخدم برنامجًا ثابتًا يتضمنها؛
-ولا تفرض أبدًا تثبيت kmods مبنية لنواة مختلفة.
-
-المثبّت:
-
-- يكتشف `amd64` أو `386` أو `arm64` أو `aarch64` أو `armv7`؛
-- ينزّل الملف الثنائي المطابق من GitHub Release؛
-- يتحقق منه مقابل `SHA256SUMS`؛
-- يثبّت Vocat في `/opt/vocat`؛
-- ينشئ خدمة systemd محصّنة بوصول الأجهزة والشبكة الذي يتطلبه Vocat؛
-- يخزّن إعدادات وقت التشغيل في `/etc/vocat/env`؛
-- يولّد كلمة مرور مسؤول أولية عشوائية عند التثبيت الأول.
-
-بعد التثبيت، افتح:
-
-```text
-http://<عنوان-الخادم>:7575
-```
-
-### التثبيت اليدوي للملف الثنائي
-
-نزّل الملف الثنائي المطابق و`SHA256SUMS` من GitHub Releases:
-
-| المنصة | ملف الإصدار |
-| --- | --- |
-| Linux x86-64 | `vocat-linux-amd64` |
-| Linux x86 32-بت | `vocat-linux-386` |
-| Linux ARM64 | `vocat-linux-arm64` |
-| Linux AArch64 | `vocat-linux-aarch64` |
-| Linux ARMv7 | `vocat-linux-armv7` |
-
-تحقق منه وثبّته:
-
-```bash
-sha256sum -c SHA256SUMS --ignore-missing
-sudo install -d -m 0755 /opt/vocat/bin /opt/vocat/data
-sudo install -m 0755 vocat-linux-amd64 /opt/vocat/bin/vocat
-read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | sudo /opt/vocat/bin/vocat bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-sudo env \
-  VOCAT_DATABASE_PATH=/opt/vocat/data/vocat.db \
-  /opt/vocat/bin/vocat serve
-```
-
-يشغّل هذا الأمر اليدوي Vocat في المقدمة. استخدم `vocat serve` حتى
-يبدأ العملية الخادم مباشرةً؛ إن تشغيل `vocat` دون وسائط بصفتك root
-على TTY يفتح بدلاً من ذلك قائمة الإدارة التفاعلية. استخدم المثبّت بنقرة
-واحدة عند الحاجة إلى خدمة systemd مُدارة وإعادة تشغيل تلقائية.
-
-### Docker
-
-لمضيف Linux الذي يجب أن يكتشف كل مودم Quectel مدعوم متصل ويواصل
-رؤية أحداث التوصيل الساخن لـ USB، شغّل Vocat في وضع الوصول إلى الأجهزة:
-
-```bash
-docker pull ghcr.io/mengmengcode/vocat:latest
-
-read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | docker run --rm -i \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  --entrypoint /opt/vocat/bin/vocat \
-  ghcr.io/mengmengcode/vocat:latest bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-
-docker run -d \
-  --name vocat \
-  --restart unless-stopped \
-  --network host \
-  --privileged \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  -v /dev:/dev \
-  -v /sys:/sys:ro \
-  ghcr.io/mengmengcode/vocat:latest
-```
-
-افتح `http://<عنوان-الخادم>:7575` بعد بدء الحاوية. شبكة المضيف
-مطلوبة حتى تبقى واجهات شبكة QMI مرئية لـ Vocat، بينما الوصول المميّز إلى الأجهزة
-مطلوب للمنافذ التسلسلية، وعقد تحكم QMI، وواجهات TUN، وإعدادات الشبكة، والأجهزة
-المضافة بعد بدء الحاوية. يجعل تركيب `/dev` العقد الجديدة `ttyUSB*` و`ttyACM*` و`cdc-wdm*`
-مرئية دون إعادة إنشاء الحاوية.
-
-يمنح هذا الوضع عمدًا Vocat وصولاً واسعًا إلى أجهزة المضيف ومكدس الشبكة.
-استخدمه فقط على مضيف Linux موثوق. يتعرف الاكتشاف التلقائي حاليًا على مودمات
-Quectel USB المدعومة (معرّف الشركة المصنعة USB `2c7c`)، وليس على ماركات مودم عشوائية.
-إن تركيب العقد الفردية فقط باستخدام `--device`، مثل `/dev/ttyUSB2` و`/dev/cdc-wdm0`،
-يحصر الحاوية في تلك العقد الثابتة ولا يوفر اكتشافًا كاملاً متعدد الأجهزة أو بالتوصيل الساخن.
-
-تُنشر صورة GHCR لـ `linux/amd64` و`linux/arm64`.
-
-## الإعدادات
-
-يقرأ Vocat ملف إعدادات JSON اختياريًا من `VOCAT_CONFIG`، ثم يطبق متغيرات البيئة `VOCAT_*`. متغيرات البيئة لها الأولوية.
-
-| متغير البيئة | الافتراضي | الوصف |
-| --- | --- | --- |
-| `VOCAT_ADDR` | `0.0.0.0:7575` | عنوان الاستماع HTTP. |
-| `VOCAT_DATABASE_PATH` | `./data/vocat.db` | مسار قاعدة بيانات SQLite. |
-| `VOCAT_SESSION_TTL` | `24h` | مدة صلاحية جلسة المصادقة. |
-| `VOCAT_SECURE_COOKIES` | `false` | يضع علامة آمنة على ملفات تعريف ارتباط الجلسة عند استخدام HTTPS. |
-| `VOCAT_SHUTDOWN_TIMEOUT` | `10s` | مهلة الإيقاف السلس. |
-| `VOCAT_MAX_REQUEST_BODY_BYTES` | `1048576` | الحد الأقصى لحجم جسم طلب API. |
-| `VOCAT_REPO` | `MengMengCode/VoCat` | مستودع GitHub الموثوق الذي يستخدمه المحدّث الذاتي، بصيغة `owner/name`. |
-| `GITHUB_TOKEN` | فارغ | رمز GitHub اختياري للمستودعات الخاصة أو حدود API أعلى. |
-
-لا تخزّن رموز Telegram، أو كلمات مرور SMTP، أو أسرار webhook، أو بيانات اعتماد SIM، أو بيانات خاصة أخرى في المستودع. قم بإعدادها عبر إعدادات التطبيق أو ملفات البيئة المحمية.
-
-## بوت Telegram
-
-عند تفعيل إشعارات Telegram وإعداد كلٍّ من Chat ID وAdmin ID، يدعم البوت:
-
-```text
-/status [الجهاز]
-/esim <الجهاز>
-/switch <الجهاز> <iccid>
-/wfc <الجهاز> <status|on|off|reconnect>
-/sms <الجهاز> <الرقم> <الرسالة>
-```
-
-تستخدم عمليتا تبديل الملفات الشخصية وإرسال الرسائل القصيرة أزرار تأكيد لمرة واحدة. لا يعرض البوت أوامر تنزيل أو حذف أو إعادة تسمية eSIM.
-
-## التحديث
-
-تحقق من وجود GitHub Release أحدث:
-
-```bash
-vocat update --check --repo MengMengCode/VoCat
-```
-
-ثبّت أحدث إصدار:
-
-```bash
-sudo vocat update --repo MengMengCode/VoCat
-```
-
-ينزّل المحدّث الملف الثنائي المطابق لبنية Linux الحالية، ويتحقق منه باستخدام `SHA256SUMS` المنشور، ويستبدل الملف التنفيذي بشكل ذري، ويعيد تشغيل خدمة systemd `vocat` عند توفرها.
-
-لتثبيتات Docker:
-
-```bash
-docker pull ghcr.io/mengmengcode/vocat:latest
-```
-
-أعد إنشاء الحاوية بعد سحب الصورة الجديدة.
-
-## التطوير
-
-المتطلبات:
-
-- Go 1.25 أو أحدث
-- Node.js 20 أو أحدث
-- npm
-
-تشغيل خادم تطوير الواجهة الأمامية:
-
-```bash
-cd web
-npm install
-npm run dev
-```
-
-بناء الواجهة الأمامية المضمّنة وتشغيل الواجهة الخلفية:
-
-```bash
-cd web
-npm run build
-cd ..
-go run ./cmd/vocat
-```
-
-تشغيل جميع الاختبارات:
-
-```bash
-go test ./...
-```
-
-بناء ملف ثنائي للإنتاج:
-
-```bash
-go build -trimpath -ldflags "-s -w" -o vocat ./cmd/vocat
-```
-
-## أتمتة الإصدارات
-
-يؤدي دفع وسم الإصدار إلى بدء سير عملَي GitHub Actions:
-
-- `release-binaries` يبني وينشر ملفات `amd64` و`386` و`arm64` و`aarch64` و`armv7` الثنائية مع `SHA256SUMS`.
-- `docker` يبني وينشر صورة متعددة البنى إلى GitHub Container Registry.
-
-```bash
-git tag v0.2.0
-git push origin v0.2.0
-```
-
-## بنية المشروع
-
-```text
-cmd/vocat/                  نقطة دخول التطبيق وCLI
-internal/device/            اكتشاف المودم والتحكم في الأجهزة
-internal/modem/             جلسة AT ومعالجة الاستجابات
-internal/server/            واجهة HTTP API والإشعارات وخادم الويب المضمّن
-internal/store/             التخزين الدائم SQLite
-internal/update/            المحدّث الذاتي لـ GitHub Release
-internal/vowifi/            بيئة تشغيل IKE وEAP-AKA وIMS وWiFi Calling
-scripts/install.sh          مثبّت ومحدّث Linux
-web/src/                    الواجهة الأمامية React وTypeScript
-.github/workflows/          أتمتة إصدارات الملفات الثنائية وDocker
-```
-
-## الاستخدام المسؤول
-
-يمكن أن تؤثر عمليات المودم الخلوي وeSIM في خدمة المشترك، والملفات الشخصية المخزنة، وتسجيل الشبكة، وحالة الأجهزة. احتفظ بنسخ احتياطية، وراجع الإجراءات المدمّرة بعناية، واستخدم البرنامج فقط في بيئات قانونية يُسمح لك فيها بتشغيل الأجهزة وموارد الشبكة المتصلة.
-
-لا يتجاوز Vocat مصادقة المشغّل، أو سياسة الشبكة، أو أمان الأجهزة، أو متطلبات الثقة لـ eSIM. إن دعم عملية ما يعني أن Vocat يمكن أن يطلبها من المودم أو eUICC؛ وقد يرفضها الجهاز أو الملف الشخصي أو الشبكة أو المشغّل مع ذلك.
-
-## المساهمة
-
-نرحّب بالمسائل (issues) وطلبات السحب (pull requests). حافظ على التغييرات مركّزة، وأضِف الاختبارات حيثما أمكن، وتجنّب إيداع بيانات الاعتماد أو بيانات المشتركين، ووثّق بوضوح السلوك الخاص بالأجهزة.
-
-قبل إرسال تغيير:
-
-```bash
-go test ./...
-cd web && npm run build
-```
-
-## شكر وتقدير
-- [Nodeseek.com](https://www.nodeseek.com) — مجتمع مكرّس للخوادم
-- [Linux.do](https://linux.do) — مجتمع تقني ملهم
-- [iniwex5](https://github.com/iniwex5) — إرشادات الأسلوب والوظائف
-
-## ادعُني إلى فنجان قهوة
-
-| الشبكة | العنوان |
-| ------- | ------- |
-| USDT-TRON (TRC20) | `TQQAbboBoU8h5xX4YCA1rqWJU2WjK3seSg` |
-| USDT-BSC (BEP20) | `0xdbfcd4a462550d6ff06d09cbd89026c6b145d9c4` |
-| USDT-Polygon | `0xdbfcd4a462550d6ff06d09cbd89026c6b145d9c4` |
-
-## الرخصة
-
-انظر [LICENSE](../LICENSE).
-
-[![MengMengCode/VoCat Star History](https://mengmeng.meteor-history.com/api/embed/MengMengCode/VoCat.svg?sig=sdeXRVxAoY3yLWgXL7JViY2USYIN3t9neJ6ScPvgUAo&theme=light&style=xkcd&color=dd4528&background=ffffff&textColor=000000&width=900&height=600&lineWidth=3&showTitle=true&showLegend=true&showDots=false&v=0.0.14)](https://meteor-history.com)

docs/README.es.md

@@ -1,343 +0,0 @@
-<p align="center">
-  <img src="../web/public/favicon.svg" width="96" alt="Vocat">
-</p>
-
-<h1 align="center">VoCat</h1>
-
-<p align="center">
-  <img alt="Go" src="https://img.shields.io/badge/Go-1.25-00ADD8?style=flat-square&logo=go&logoColor=white">
-  <img alt="React" src="https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=111111">
-  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.8-3178C6?style=flat-square&logo=typescript&logoColor=white">
-  <img alt="Vite" src="https://img.shields.io/badge/Vite-7-646CFF?style=flat-square&logo=vite&logoColor=white">
-  <img alt="Tailwind CSS" src="https://img.shields.io/badge/Tailwind_CSS-3-06B6D4?style=flat-square&logo=tailwindcss&logoColor=white">
-  <img alt="SQLite" src="https://img.shields.io/badge/SQLite-Embedded-003B57?style=flat-square&logo=sqlite&logoColor=white">
-</p>
-
-<p align="center">
-  <img alt="Linux" src="https://img.shields.io/badge/Linux-amd64_%7C_386_%7C_arm64_%7C_aarch64_%7C_armv7-FCC624?style=flat-square&logo=linux&logoColor=111111">
-  <img alt="Docker" src="https://img.shields.io/badge/Docker-Multi--Arch-2496ED?style=flat-square&logo=docker&logoColor=white">
-  <img alt="WiFi Calling" src="https://img.shields.io/badge/WiFi_Calling-IMS_SMS-7B1FA2?style=flat-square">
-  <img alt="eSIM" src="https://img.shields.io/badge/eSIM-LPA_%2F_eUICC-009688?style=flat-square">
-  <img alt="Telegram" src="https://img.shields.io/badge/Telegram-Bot-26A5E4?style=flat-square&logo=telegram&logoColor=white">
-  <img alt="GitHub Actions" src="https://img.shields.io/badge/GitHub_Actions-Release-2088FF?style=flat-square&logo=githubactions&logoColor=white">
-</p>
-
-[English](../README.md) | [العربية](README.ar.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [Français](README.fr.md) | [Русский](README.ru.md) | **Español** | [日本語](README.ja.md)
-
-Vocat es un panel de control web de código abierto y un conjunto de herramientas de ingeniería para módems celulares Quectel de clase EC20/EC25. Combina, en un único servicio autocontenido, el descubrimiento de módems, el estado de radio en vivo, terminales AT y USSD, SMS, WiFi Calling, gestión de eSIM, selección de red, enrutamiento por proxy, notificaciones, registros de auditoría y automatización de versiones.
-
-El backend está escrito en Go, la interfaz está construida con React y TypeScript, y el frontend de producción está incrustado en el binario de Go. Un único ejecutable contiene la aplicación web y utiliza SQLite para el estado persistente.
-
-<p align="center">
-  <img src="../img/image.png">
-  <img src="../img/image-1.png">
-</p>
-
-## Funcionalidades
-
-| Área | Lo que proporciona Vocat |
-| --- | --- |
-| Gestión de dispositivos | Descubrimiento serie/USB automático, soporte para múltiples módems, nombres de dispositivo amigables, actualizaciones en vivo de la vista general, reinicio del módulo, modo avión y controles del modo de red USB. |
-| Radio y red | Estado de registro, operador, métricas de señal, RSRP/RSRQ/SINR, modo de red, banda, canal, búsqueda de operadores y selección de red automática o manual. |
-| AT y USSD | Terminal AT interactivo, historial de comandos, respuestas sin procesar del módem, flujos de inicio/continuación/cancelación de USSD y reporte claro de errores del módem. |
-| SMS | Envío directo de SMS celulares e IMS, sincronización entrante, manejo multiparte, informes de entrega, historial de conversaciones, estado de no leído, marcas de tiempo y estado de entrega por mensaje. |
-| WiFi Calling | Establecimiento de túnel IKEv2/ePDG, autenticación EAP-AKA, registro IMS, SMS IMS, controles de reconexión, diagnósticos de estado y enrutamiento por dispositivo. |
-| eSIM y eUICC | Descubrimiento de eUICC, EID e información de producción, metadatos de certificados, inventario multi-eUICC, lista de perfiles instalados, operaciones de habilitar/deshabilitar/cambiar, y operaciones de descarga, renombrado y eliminación cuando la tarjeta lo admite. |
-| Política de tarjeta | Comportamiento de WiFi Calling y modo avión basado en ICCID con aplicación inmediata de la política. |
-| Enrutamiento por proxy | Enrutamiento SOCKS ascendente, vinculaciones de dispositivos, reglas por país, comprobaciones de accesibilidad TCP y comprobaciones UDP Associate para las rutas de datos de WiFi Calling. |
-| Notificaciones | Reenvío de nuevos SMS entrantes a través de Telegram, Bark, correo electrónico, Pushplus y webhooks firmados. Cada SMS se entrega como una notificación individual. |
-| Bot de Telegram | Estado del dispositivo, lista y cambio de perfiles instalados, controles de WiFi Calling y envío de SMS. Las acciones sensibles requieren confirmación del administrador. |
-| Operaciones | Autenticación, protección CSRF, políticas de acceso, eventos de auditoría, registros en vivo, retención de registros, comprobaciones de salud, diseño adaptable, modo oscuro e interfaz de usuario en inglés/chino. |
-| Distribución | Binarios estáticos de Linux, script de instalación systemd, autoactualización con verificación SHA-256, imagen Docker, publicación en GHCR y compilaciones de versión de GitHub Actions. |
-
-## Hardware compatible
-
-Vocat está dirigido a módulos Quectel basados en Qualcomm que exponen interfaces AT, QMI, serie y de red USB compatibles, incluyendo:
-
-- Quectel EC20
-- Quectel EC25
-- Familia Quectel EG25
-- Módulos EG600 compatibles y relacionados
-
-Las funciones disponibles dependen del firmware del módulo, la composición USB, las capacidades SIM/eSIM, los controladores del host, la red de radio y la configuración del operador.
-
-## Instalación
-
-### Instalación en Linux con un clic
-
-Como root (incluyendo OpenWrt/Kwrt, donde `sudo` normalmente está ausente):
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash
-```
-
-Desde un usuario normal en una distribución con sudo:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | sudo bash
-```
-
-Comprobar los prerrequisitos de VoWiFi/XFRM del host sin instalar VoCat:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash -s -- --check-env
-```
-
-Instalar una versión específica:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh -o install.sh
-sudo bash install.sh 0.0.2
-```
-
-VoWiFi IMS requiere Linux XFRM/IPsec. En OpenWrt/Kwrt el instalador intenta
-instalar los paquetes coincidentes `ip-full`, `kmod-ipsec`, `kmod-ipsec4/6`,
-`kmod-crypto-authenc`, AES-CBC y SHA1 desde el propio feed del firmware.
-Si no hay módulos de kernel coincidentes disponibles, use un firmware que los incluya;
-nunca fuerce la instalación de kmods compilados para un kernel diferente.
-
-El instalador:
-
-- detecta `amd64`, `386`, `arm64`, `aarch64` o `armv7`;
-- descarga el binario de GitHub Release correspondiente;
-- lo verifica contra `SHA256SUMS`;
-- instala Vocat en `/opt/vocat`;
-- crea un servicio systemd reforzado con el acceso a hardware y red requerido por Vocat;
-- almacena la configuración en tiempo de ejecución en `/etc/vocat/env`;
-- genera una contraseña de administrador inicial aleatoria en la primera instalación.
-
-Después de la instalación, abra:
-
-```text
-http://<dirección-del-servidor>:7575
-```
-
-### Instalación manual del binario
-
-Descargue el binario correspondiente y `SHA256SUMS` desde GitHub Releases:
-
-| Plataforma | Archivo de versión |
-| --- | --- |
-| Linux x86-64 | `vocat-linux-amd64` |
-| Linux x86 32 bits | `vocat-linux-386` |
-| Linux ARM64 | `vocat-linux-arm64` |
-| Linux AArch64 | `vocat-linux-aarch64` |
-| Linux ARMv7 | `vocat-linux-armv7` |
-
-Verifíquelo e instálelo:
-
-```bash
-sha256sum -c SHA256SUMS --ignore-missing
-sudo install -d -m 0755 /opt/vocat/bin /opt/vocat/data
-sudo install -m 0755 vocat-linux-amd64 /opt/vocat/bin/vocat
-read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | sudo /opt/vocat/bin/vocat bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-sudo env \
-  VOCAT_DATABASE_PATH=/opt/vocat/data/vocat.db \
-  /opt/vocat/bin/vocat serve
-```
-
-Este comando manual ejecuta Vocat en primer plano. Use `vocat serve` para que el
-proceso inicie el servidor directamente; ejecutar `vocat` sin argumentos como root
-en un TTY abre en su lugar el menú de gestión interactivo. Use el instalador de
-un clic cuando se requiera un servicio systemd gestionado y reinicio automático.
-
-### Docker
-
-Para un host Linux que debe descubrir cada módem Quectel compatible conectado y
-seguir viendo los eventos de conexión en caliente USB, ejecute Vocat en modo de acceso a hardware:
-
-```bash
-docker pull ghcr.io/mengmengcode/vocat:latest
-
-read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | docker run --rm -i \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  --entrypoint /opt/vocat/bin/vocat \
-  ghcr.io/mengmengcode/vocat:latest bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-
-docker run -d \
-  --name vocat \
-  --restart unless-stopped \
-  --network host \
-  --privileged \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  -v /dev:/dev \
-  -v /sys:/sys:ro \
-  ghcr.io/mengmengcode/vocat:latest
-```
-
-Abra `http://<dirección-del-servidor>:7575` después de que el contenedor se inicie. La red del host
-es necesaria para que las interfaces de red QMI permanezcan visibles para Vocat, mientras que el
-acceso privilegiado a dispositivos es necesario para los puertos serie, los nodos de control QMI,
-las interfaces TUN, la configuración de red y los dispositivos añadidos después de que el contenedor
-se inicie. El montaje bind de `/dev` hace visibles los nuevos nodos `ttyUSB*`, `ttyACM*` y `cdc-wdm*`
-sin recrear el contenedor.
-
-Este modo otorga intencionadamente a Vocat un amplio acceso a los dispositivos y a la pila de red
-del host. Úselo solo en un host Linux de confianza. El descubrimiento automático identifica
-actualmente los módems USB Quectel compatibles (ID de fabricante USB `2c7c`), no marcas de módems
-arbitrarias. Mapear solo nodos individuales con `--device`, como `/dev/ttyUSB2` y `/dev/cdc-wdm0`,
-limita el contenedor a esos nodos fijos y no proporciona un descubrimiento completo de múltiples
-dispositivos o de conexión en caliente.
-
-La imagen GHCR se publica para `linux/amd64` y `linux/arm64`.
-
-## Configuración
-
-Vocat lee un archivo de configuración JSON opcional desde `VOCAT_CONFIG` y luego aplica las variables de entorno `VOCAT_*`. Las variables de entorno tienen prioridad.
-
-| Variable de entorno | Predeterminado | Descripción |
-| --- | --- | --- |
-| `VOCAT_ADDR` | `0.0.0.0:7575` | Dirección de escucha HTTP. |
-| `VOCAT_DATABASE_PATH` | `./data/vocat.db` | Ruta de la base de datos SQLite. |
-| `VOCAT_SESSION_TTL` | `24h` | Duración de la sesión de autenticación. |
-| `VOCAT_SECURE_COOKIES` | `false` | Marca las cookies de sesión como seguras cuando se usa HTTPS. |
-| `VOCAT_SHUTDOWN_TIMEOUT` | `10s` | Tiempo de espera de apagado ordenado. |
-| `VOCAT_MAX_REQUEST_BODY_BYTES` | `1048576` | Tamaño máximo del cuerpo de solicitud de la API. |
-| `VOCAT_REPO` | `MengMengCode/VoCat` | Repositorio de GitHub de confianza usado por el autoactualizador, en formato `owner/name`. |
-| `GITHUB_TOKEN` | vacío | Token de GitHub opcional para repositorios privados o límites de API más altos. |
-
-No almacene tokens de Telegram, contraseñas SMTP, secretos de webhook, credenciales SIM u otros datos privados en el repositorio. Configúrelos a través de los ajustes de la aplicación o archivos de entorno protegidos.
-
-## Bot de Telegram
-
-Cuando las notificaciones de Telegram están habilitadas y tanto el Chat ID como el Admin ID están configurados, el bot admite:
-
-```text
-/status [dispositivo]
-/esim <dispositivo>
-/switch <dispositivo> <iccid>
-/wfc <dispositivo> <status|on|off|reconnect>
-/sms <dispositivo> <número> <mensaje>
-```
-
-El cambio de perfil y el envío de SMS usan botones de confirmación de un solo uso. El bot no expone comandos de descarga, eliminación o renombrado de eSIM.
-
-## Actualización
-
-Comprobar si hay una GitHub Release más reciente:
-
-```bash
-vocat update --check --repo MengMengCode/VoCat
-```
-
-Instalar la última versión:
-
-```bash
-sudo vocat update --repo MengMengCode/VoCat
-```
-
-El actualizador descarga el binario que coincide con la arquitectura Linux actual, lo verifica con el `SHA256SUMS` publicado, reemplaza el ejecutable de forma atómica y reinicia el servicio systemd `vocat` cuando está disponible.
-
-Para instalaciones Docker:
-
-```bash
-docker pull ghcr.io/mengmengcode/vocat:latest
-```
-
-Recrear el contenedor después de descargar la nueva imagen.
-
-## Desarrollo
-
-Requisitos:
-
-- Go 1.25 o más reciente
-- Node.js 20 o más reciente
-- npm
-
-Ejecutar el servidor de desarrollo del frontend:
-
-```bash
-cd web
-npm install
-npm run dev
-```
-
-Compilar el frontend incrustado e iniciar el backend:
-
-```bash
-cd web
-npm run build
-cd ..
-go run ./cmd/vocat
-```
-
-Ejecutar todas las pruebas:
-
-```bash
-go test ./...
-```
-
-Compilar un binario de producción:
-
-```bash
-go build -trimpath -ldflags "-s -w" -o vocat ./cmd/vocat
-```
-
-## Automatización de versiones
-
-Hacer push de una etiqueta de versión inicia dos flujos de trabajo de GitHub Actions:
-
-- `release-binaries` compila y publica los binarios `amd64`, `386`, `arm64`, `aarch64` y `armv7` más `SHA256SUMS`.
-- `docker` compila y publica una imagen multiarquitectura en GitHub Container Registry.
-
-```bash
-git tag v0.2.0
-git push origin v0.2.0
-```
-
-## Estructura del proyecto
-
-```text
-cmd/vocat/                  Punto de entrada de la aplicación y CLI
-internal/device/            Descubrimiento de módems y control de dispositivos
-internal/modem/             Sesión AT y manejo de respuestas
-internal/server/            API HTTP, notificaciones y servidor web incrustado
-internal/store/             Persistencia SQLite
-internal/update/            Autoactualizador de GitHub Release
-internal/vowifi/            Runtime de IKE, EAP-AKA, IMS y WiFi Calling
-scripts/install.sh          Instalador y actualizador de Linux
-web/src/                    Frontend en React y TypeScript
-.github/workflows/          Automatización de versiones de binarios y Docker
-```
-
-## Uso responsable
-
-Las operaciones con módems celulares y eSIM pueden afectar el servicio del abonado, los perfiles almacenados, el registro de red y el estado del hardware. Mantenga copias de seguridad, revise con cuidado las acciones destructivas y use el software solo en entornos legales donde tenga permiso para operar el hardware y los recursos de red conectados.
-
-Vocat no elude la autenticación del operador, la política de red, la seguridad del hardware ni los requisitos de confianza de eSIM. El soporte de una operación significa que Vocat puede solicitarla al módem o al eUICC; el dispositivo, el perfil, la red o el operador aún pueden rechazarla.
-
-## Contribuir
-
-Las incidencias y pull requests son bienvenidas. Mantenga los cambios enfocados, incluya pruebas cuando sea práctico, evite confirmar credenciales o datos de abonados, y documente claramente el comportamiento específico del hardware.
-
-Antes de enviar un cambio:
-
-```bash
-go test ./...
-cd web && npm run build
-```
-
-## Agradecimientos
-- [Nodeseek.com](https://www.nodeseek.com) — Una comunidad dedicada a los servidores
-- [Linux.do](https://linux.do) — Una comunidad tecnológica inspiradora
-- [iniwex5](https://github.com/iniwex5) — Guías de estilo y funcionalidad
-
-## Invítame a un café
-
-| Red | Dirección |
-| ------- | ------- |
-| USDT-TRON (TRC20) | `TQQAbboBoU8h5xX4YCA1rqWJU2WjK3seSg` |
-| USDT-BSC (BEP20) | `0xdbfcd4a462550d6ff06d09cbd89026c6b145d9c4` |
-| USDT-Polygon | `0xdbfcd4a462550d6ff06d09cbd89026c6b145d9c4` |
-
-## Licencia
-
-Consulte [LICENSE](../LICENSE).
-
-[![MengMengCode/VoCat Star History](https://mengmeng.meteor-history.com/api/embed/MengMengCode/VoCat.svg?sig=sdeXRVxAoY3yLWgXL7JViY2USYIN3t9neJ6ScPvgUAo&theme=light&style=xkcd&color=dd4528&background=ffffff&textColor=000000&width=900&height=600&lineWidth=3&showTitle=true&showLegend=true&showDots=false&v=0.0.14)](https://meteor-history.com)

docs/README.fr.md

@@ -1,343 +0,0 @@
-<p align="center">
-  <img src="../web/public/favicon.svg" width="96" alt="Vocat">
-</p>
-
-<h1 align="center">VoCat</h1>
-
-<p align="center">
-  <img alt="Go" src="https://img.shields.io/badge/Go-1.25-00ADD8?style=flat-square&logo=go&logoColor=white">
-  <img alt="React" src="https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=111111">
-  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.8-3178C6?style=flat-square&logo=typescript&logoColor=white">
-  <img alt="Vite" src="https://img.shields.io/badge/Vite-7-646CFF?style=flat-square&logo=vite&logoColor=white">
-  <img alt="Tailwind CSS" src="https://img.shields.io/badge/Tailwind_CSS-3-06B6D4?style=flat-square&logo=tailwindcss&logoColor=white">
-  <img alt="SQLite" src="https://img.shields.io/badge/SQLite-Embedded-003B57?style=flat-square&logo=sqlite&logoColor=white">
-</p>
-
-<p align="center">
-  <img alt="Linux" src="https://img.shields.io/badge/Linux-amd64_%7C_386_%7C_arm64_%7C_aarch64_%7C_armv7-FCC624?style=flat-square&logo=linux&logoColor=111111">
-  <img alt="Docker" src="https://img.shields.io/badge/Docker-Multi--Arch-2496ED?style=flat-square&logo=docker&logoColor=white">
-  <img alt="WiFi Calling" src="https://img.shields.io/badge/WiFi_Calling-IMS_SMS-7B1FA2?style=flat-square">
-  <img alt="eSIM" src="https://img.shields.io/badge/eSIM-LPA_%2F_eUICC-009688?style=flat-square">
-  <img alt="Telegram" src="https://img.shields.io/badge/Telegram-Bot-26A5E4?style=flat-square&logo=telegram&logoColor=white">
-  <img alt="GitHub Actions" src="https://img.shields.io/badge/GitHub_Actions-Release-2088FF?style=flat-square&logo=githubactions&logoColor=white">
-</p>
-
-[English](../README.md) | [العربية](README.ar.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | **Français** | [Русский](README.ru.md) | [Español](README.es.md) | [日本語](README.ja.md)
-
-Vocat est un panneau de contrôle web open-source et une boîte à outils d'ingénierie pour les modems cellulaires Quectel de classe EC20/EC25. Il réunit, dans un service autonome unique, la découverte de modems, l'état radio en direct, les terminaux AT et USSD, les SMS, la WiFi Calling, la gestion eSIM, la sélection de réseau, le routage par proxy, les notifications, les journaux d'audit et l'automatisation des versions.
-
-Le backend est écrit en Go, l'interface est construite avec React et TypeScript, et le frontend de production est intégré dans le binaire Go. Un seul exécutable contient l'application web et utilise SQLite pour l'état persistant.
-
-<p align="center">
-  <img src="../img/image.png">
-  <img src="../img/image-1.png">
-</p>
-
-## Fonctionnalités
-
-| Domaine | Ce que Vocat fournit |
-| --- | --- |
-| Gestion des appareils | Découverte série/USB automatique, prise en charge de plusieurs modems, noms d'appareils conviviaux, mises à jour en direct de la vue d'ensemble, redémarrage du module, mode avion et contrôles du mode réseau USB. |
-| Radio et réseau | État d'enregistrement, opérateur, métriques de signal, RSRP/RSRQ/SINR, mode réseau, bande, canal, recherche d'opérateurs et sélection de réseau automatique ou manuelle. |
-| AT et USSD | Terminal AT interactif, historique des commandes, réponses brutes du modem, flux de démarrage/poursuite/annulation USSD et rapport d'erreurs modem clair. |
-| SMS | Envoi direct de SMS cellulaires et IMS, synchronisation entrante, gestion des messages multiparties, rapports de livraison, historique des conversations, état non lu, horodatages et statut de livraison par message. |
-| WiFi Calling | Établissement de tunnel IKEv2/ePDG, authentification EAP-AKA, enregistrement IMS, SMS IMS, contrôles de reconnexion, diagnostics d'état et routage par appareil. |
-| eSIM et eUICC | Découverte eUICC, EID et informations de production, métadonnées de certificat, inventaire multi-eUICC, liste des profils installés, opérations d'activation/désactivation/commutation, ainsi que téléchargement, renommage et suppression lorsque la carte le permet. |
-| Politique de carte | Comportement WiFi Calling et mode avion basé sur l'ICCID avec application immédiate de la politique. |
-| Routage par proxy | Routage SOCKS amont, liaisons d'appareils, règles par pays, vérifications d'accessibilité TCP et vérifications UDP Associate pour les chemins de données WiFi Calling. |
-| Notifications | Transfert des nouveaux SMS entrants via Telegram, Bark, e-mail, Pushplus et webhooks signés. Chaque SMS est livré comme une notification individuelle. |
-| Bot Telegram | État de l'appareil, liste et commutation des profils installés, contrôles WiFi Calling et envoi de SMS. Les actions sensibles nécessitent une confirmation de l'administrateur. |
-| Exploitation | Authentification, protection CSRF, politiques d'accès, événements d'audit, journaux en direct, rétention des journaux, vérifications de santé, mise en page réactive, mode sombre et interface utilisateur en anglais/chinois. |
-| Distribution | Binaires Linux statiques, script d'installation systemd, auto-mise à jour avec vérification SHA-256, image Docker, publication GHCR et builds de version GitHub Actions. |
-
-## Matériel pris en charge
-
-Vocat cible les modules Quectel à base Qualcomm qui exposent des interfaces AT, QMI, série et réseau USB compatibles, notamment :
-
-- Quectel EC20
-- Quectel EC25
-- Famille Quectel EG25
-- Modules EG600 compatibles et apparentés
-
-Les fonctionnalités disponibles dépendent du firmware du module, de la composition USB, des capacités SIM/eSIM, des pilotes hôtes, du réseau radio et de la configuration de l'opérateur.
-
-## Installation
-
-### Installation Linux en un clic
-
-En tant que root (y compris OpenWrt/Kwrt, où `sudo` est normalement absent) :
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash
-```
-
-Depuis un utilisateur normal sur une distribution disposant de sudo :
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | sudo bash
-```
-
-Vérifier les prérequis VoWiFi/XFRM de l'hôte sans installer VoCat :
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash -s -- --check-env
-```
-
-Installer une version spécifique :
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh -o install.sh
-sudo bash install.sh 0.0.2
-```
-
-VoWiFi IMS nécessite Linux XFRM/IPsec. Sur OpenWrt/Kwrt, le programme d'installation tente
-d'installer les paquets correspondants `ip-full`, `kmod-ipsec`, `kmod-ipsec4/6`,
-`kmod-crypto-authenc`, AES-CBC et SHA1 depuis le dépôt du firmware lui-même.
-Si des modules noyau correspondants ne sont pas disponibles, utilisez un firmware qui les inclut ;
-ne forcez jamais l'installation de kmods compilés pour un noyau différent.
-
-Le programme d'installation :
-
-- détecte `amd64`, `386`, `arm64`, `aarch64` ou `armv7` ;
-- télécharge le binaire GitHub Release correspondant ;
-- le vérifie par rapport à `SHA256SUMS` ;
-- installe Vocat sous `/opt/vocat` ;
-- crée un service systemd renforcé disposant des accès matériel et réseau requis par Vocat ;
-- stocke la configuration d'exécution dans `/etc/vocat/env` ;
-- génère un mot de passe administrateur initial aléatoire lors de la première installation.
-
-Après l'installation, ouvrez :
-
-```text
-http://<adresse-du-serveur>:7575
-```
-
-### Installation manuelle du binaire
-
-Téléchargez le binaire correspondant et `SHA256SUMS` depuis GitHub Releases :
-
-| Plateforme | Fichier de version |
-| --- | --- |
-| Linux x86-64 | `vocat-linux-amd64` |
-| Linux x86 32 bits | `vocat-linux-386` |
-| Linux ARM64 | `vocat-linux-arm64` |
-| Linux AArch64 | `vocat-linux-aarch64` |
-| Linux ARMv7 | `vocat-linux-armv7` |
-
-Vérifiez-le et installez-le :
-
-```bash
-sha256sum -c SHA256SUMS --ignore-missing
-sudo install -d -m 0755 /opt/vocat/bin /opt/vocat/data
-sudo install -m 0755 vocat-linux-amd64 /opt/vocat/bin/vocat
-read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | sudo /opt/vocat/bin/vocat bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-sudo env \
-  VOCAT_DATABASE_PATH=/opt/vocat/data/vocat.db \
-  /opt/vocat/bin/vocat serve
-```
-
-Cette commande manuelle exécute Vocat au premier plan. Utilisez `vocat serve` pour que le
-processus démarre directement le serveur ; exécuter `vocat` sans argument en tant que root
-sur un TTY ouvre plutôt le menu de gestion interactif. Utilisez le programme d'installation
-en un clic lorsqu'un service systemd géré et un redémarrage automatique sont requis.
-
-### Docker
-
-Pour un hôte Linux qui doit découvrir chaque modem Quectel pris en charge connecté et
-continuer à voir les événements de branchement à chaud USB, exécutez Vocat en mode d'accès matériel :
-
-```bash
-docker pull ghcr.io/mengmengcode/vocat:latest
-
-read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | docker run --rm -i \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  --entrypoint /opt/vocat/bin/vocat \
-  ghcr.io/mengmengcode/vocat:latest bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-
-docker run -d \
-  --name vocat \
-  --restart unless-stopped \
-  --network host \
-  --privileged \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  -v /dev:/dev \
-  -v /sys:/sys:ro \
-  ghcr.io/mengmengcode/vocat:latest
-```
-
-Ouvrez `http://<adresse-du-serveur>:7575` après le démarrage du conteneur. Le réseau de l'hôte
-est requis pour que les interfaces réseau QMI restent visibles par Vocat, tandis que l'accès
-privilégié aux périphériques est requis pour les ports série, les nœuds de contrôle QMI, les
-interfaces TUN, la configuration réseau et les périphériques ajoutés après le démarrage du
-conteneur. Le montage bind de `/dev` rend les nouveaux nœuds `ttyUSB*`, `ttyACM*` et `cdc-wdm*`
-visibles sans recréer le conteneur.
-
-Ce mode donne intentionnellement à Vocat un large accès aux périphériques et à la pile réseau
-de l'hôte. Ne l'utilisez que sur un hôte Linux de confiance. La découverte automatique
-identifie actuellement les modems USB Quectel pris en charge (ID fabricant USB `2c7c`), et non
-des marques de modems arbitraires. Le mappage de nœuds individuels uniquement avec `--device`,
-comme `/dev/ttyUSB2` et `/dev/cdc-wdm0`, limite le conteneur à ces nœuds fixes et ne fournit
-pas une découverte multi-périphériques ou à chaud complète.
-
-L'image GHCR est publiée pour `linux/amd64` et `linux/arm64`.
-
-## Configuration
-
-Vocat lit un fichier de configuration JSON optionnel depuis `VOCAT_CONFIG`, puis applique les variables d'environnement `VOCAT_*`. Les variables d'environnement ont la priorité.
-
-| Variable d'environnement | Par défaut | Description |
-| --- | --- | --- |
-| `VOCAT_ADDR` | `0.0.0.0:7575` | Adresse d'écoute HTTP. |
-| `VOCAT_DATABASE_PATH` | `./data/vocat.db` | Chemin de la base de données SQLite. |
-| `VOCAT_SESSION_TTL` | `24h` | Durée de vie de la session d'authentification. |
-| `VOCAT_SECURE_COOKIES` | `false` | Marque les cookies de session comme sécurisés lorsque HTTPS est utilisé. |
-| `VOCAT_SHUTDOWN_TIMEOUT` | `10s` | Délai d'arrêt gracieux. |
-| `VOCAT_MAX_REQUEST_BODY_BYTES` | `1048576` | Taille maximale du corps de requête API. |
-| `VOCAT_REPO` | `MengMengCode/VoCat` | Dépôt GitHub de confiance utilisé par l'auto-updater, au format `owner/name`. |
-| `GITHUB_TOKEN` | vide | Jeton GitHub optionnel pour les dépôts privés ou des limites d'API plus élevées. |
-
-Ne stockez pas de jetons Telegram, mots de passe SMTP, secrets de webhook, identifiants SIM ou autres données privées dans le dépôt. Configurez-les via les paramètres de l'application ou des fichiers d'environnement protégés.
-
-## Bot Telegram
-
-Lorsque les notifications Telegram sont activées et que le Chat ID et l'Admin ID sont configurés, le bot prend en charge :
-
-```text
-/status [appareil]
-/esim <appareil>
-/switch <appareil> <iccid>
-/wfc <appareil> <status|on|off|reconnect>
-/sms <appareil> <numéro> <message>
-```
-
-La commutation de profil et l'envoi de SMS utilisent des boutons de confirmation à usage unique. Le bot n'expose pas les commandes de téléchargement, de suppression ou de renommage eSIM.
-
-## Mise à jour
-
-Vérifier l'existence d'une GitHub Release plus récente :
-
-```bash
-vocat update --check --repo MengMengCode/VoCat
-```
-
-Installer la dernière version :
-
-```bash
-sudo vocat update --repo MengMengCode/VoCat
-```
-
-L'updater télécharge le binaire correspondant à l'architecture Linux actuelle, le vérifie avec le `SHA256SUMS` publié, remplace l'exécutable de manière atomique et redémarre le service systemd `vocat` lorsqu'il est disponible.
-
-Pour les installations Docker :
-
-```bash
-docker pull ghcr.io/mengmengcode/vocat:latest
-```
-
-Recréez le conteneur après avoir tiré la nouvelle image.
-
-## Développement
-
-Prérequis :
-
-- Go 1.25 ou plus récent
-- Node.js 20 ou plus récent
-- npm
-
-Lancer le serveur de développement frontend :
-
-```bash
-cd web
-npm install
-npm run dev
-```
-
-Construire le frontend intégré et démarrer le backend :
-
-```bash
-cd web
-npm run build
-cd ..
-go run ./cmd/vocat
-```
-
-Exécuter tous les tests :
-
-```bash
-go test ./...
-```
-
-Construire un binaire de production :
-
-```bash
-go build -trimpath -ldflags "-s -w" -o vocat ./cmd/vocat
-```
-
-## Automatisation des versions
-
-Pousser un tag de version déclenche deux workflows GitHub Actions :
-
-- `release-binaries` construit et publie les binaires `amd64`, `386`, `arm64`, `aarch64` et `armv7` ainsi que `SHA256SUMS`.
-- `docker` construit et publie une image multi-architecture vers GitHub Container Registry.
-
-```bash
-git tag v0.2.0
-git push origin v0.2.0
-```
-
-## Structure du projet
-
-```text
-cmd/vocat/                  Point d'entrée de l'application et CLI
-internal/device/            Découverte de modems et contrôle des appareils
-internal/modem/             Session AT et gestion des réponses
-internal/server/            API HTTP, notifications et serveur web intégré
-internal/store/             Persistance SQLite
-internal/update/            Auto-updater GitHub Release
-internal/vowifi/            Runtime IKE, EAP-AKA, IMS et WiFi Calling
-scripts/install.sh          Installeur et updater Linux
-web/src/                    Frontend React et TypeScript
-.github/workflows/          Automatisation des versions binaires et Docker
-```
-
-## Utilisation responsable
-
-Les opérations sur les modems cellulaires et les eSIM peuvent affecter le service de l'abonné, les profils stockés, l'enregistrement réseau et l'état du matériel. Effectuez des sauvegardes, examinez attentivement les actions destructrices et n'utilisez le logiciel que dans des environnements légaux où vous êtes autorisé à exploiter le matériel et les ressources réseau connectés.
-
-Vocat ne contourne ni l'authentification de l'opérateur, ni la politique réseau, ni la sécurité matérielle, ni les exigences de confiance eSIM. La prise en charge d'une opération signifie que Vocat peut la demander au modem ou à l'eUICC ; l'appareil, le profil, le réseau ou l'opérateur peut toujours la refuser.
-
-## Contribution
-
-Les issues et pull requests sont les bienvenues. Gardez des changements ciblés, incluez des tests lorsque c'est possible, évitez de committer des identifiants ou des données d'abonnés, et documentez clairement les comportements spécifiques au matériel.
-
-Avant de soumettre un changement :
-
-```bash
-go test ./...
-cd web && npm run build
-```
-
-## Remerciements
-- [Nodeseek.com](https://www.nodeseek.com) — Une communauté dédiée aux serveurs
-- [Linux.do](https://linux.do) — Une communauté technologique inspirante
-- [iniwex5](https://github.com/iniwex5) — Directives de style et de fonctionnalité
-
-## Offrez-moi un café
-
-| Réseau | Adresse |
-| ------- | ------- |
-| USDT-TRON (TRC20) | `TQQAbboBoU8h5xX4YCA1rqWJU2WjK3seSg` |
-| USDT-BSC (BEP20) | `0xdbfcd4a462550d6ff06d09cbd89026c6b145d9c4` |
-| USDT-Polygon | `0xdbfcd4a462550d6ff06d09cbd89026c6b145d9c4` |
-
-## Licence
-
-Voir [LICENSE](../LICENSE).
-
-[![MengMengCode/VoCat Star History](https://mengmeng.meteor-history.com/api/embed/MengMengCode/VoCat.svg?sig=sdeXRVxAoY3yLWgXL7JViY2USYIN3t9neJ6ScPvgUAo&theme=light&style=xkcd&color=dd4528&background=ffffff&textColor=000000&width=900&height=600&lineWidth=3&showTitle=true&showLegend=true&showDots=false&v=0.0.14)](https://meteor-history.com)

docs/README.ja.md

@@ -1,325 +0,0 @@
-<p align="center">
-  <img src="../web/public/favicon.svg" width="96" alt="Vocat">
-</p>
-
-<h1 align="center">VoCat</h1>
-
-<p align="center">
-  <img alt="Go" src="https://img.shields.io/badge/Go-1.25-00ADD8?style=flat-square&logo=go&logoColor=white">
-  <img alt="React" src="https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=111111">
-  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.8-3178C6?style=flat-square&logo=typescript&logoColor=white">
-  <img alt="Vite" src="https://img.shields.io/badge/Vite-7-646CFF?style=flat-square&logo=vite&logoColor=white">
-  <img alt="Tailwind CSS" src="https://img.shields.io/badge/Tailwind_CSS-3-06B6D4?style=flat-square&logo=tailwindcss&logoColor=white">
-  <img alt="SQLite" src="https://img.shields.io/badge/SQLite-Embedded-003B57?style=flat-square&logo=sqlite&logoColor=white">
-</p>
-
-<p align="center">
-  <img alt="Linux" src="https://img.shields.io/badge/Linux-amd64_%7C_386_%7C_arm64_%7C_aarch64_%7C_armv7-FCC624?style=flat-square&logo=linux&logoColor=111111">
-  <img alt="Docker" src="https://img.shields.io/badge/Docker-Multi--Arch-2496ED?style=flat-square&logo=docker&logoColor=white">
-  <img alt="WiFi Calling" src="https://img.shields.io/badge/WiFi_Calling-IMS_SMS-7B1FA2?style=flat-square">
-  <img alt="eSIM" src="https://img.shields.io/badge/eSIM-LPA_%2F_eUICC-009688?style=flat-square">
-  <img alt="Telegram" src="https://img.shields.io/badge/Telegram-Bot-26A5E4?style=flat-square&logo=telegram&logoColor=white">
-  <img alt="GitHub Actions" src="https://img.shields.io/badge/GitHub_Actions-Release-2088FF?style=flat-square&logo=githubactions&logoColor=white">
-</p>
-
-[English](../README.md) | [العربية](README.ar.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [Français](README.fr.md) | [Русский](README.ru.md) | [Español](README.es.md) | **日本語**
-
-Vocat は、Quectel EC20/EC25 クラスのセルラーモデム向けのオープンソース Web コントロールパネル兼エンジニアリングツールキットです。モデムの検出、ライブの無線ステータス、AT / USSD ターミナル、SMS、WiFi Calling、eSIM 管理、ネットワーク選択、プロキシルーティング、通知、監査ログ、リリース自動化を、自己完結型の単一サービスに統合しています。
-
-バックエンドは Go で書かれ、インターフェースは React と TypeScript で構築され、本番フロントエンドは Go バイナリに埋め込まれています。単一の実行ファイルに Web アプリケーション全体が含まれ、永続的な状態には SQLite を使用します。
-
-<p align="center">
-  <img src="../img/image.png">
-  <img src="../img/image-1.png">
-</p>
-
-## 機能
-
-| 領域 | Vocat が提供する機能 |
-| --- | --- |
-| デバイス管理 | シリアル/USB の自動検出、複数モデムのサポート、わかりやすいデバイス名、概要のライブ更新、モジュールの再起動、機内モード、USB ネットワークモードの制御。 |
-| 無線とネットワーク | 登録ステータス、オペレーター、信号指標、RSRP/RSRQ/SINR、ネットワークモード、バンド、チャネル、オペレータースキャン、自動または手動のネットワーク選択。 |
-| AT と USSD | 対話型 AT ターミナル、コマンド履歴、モデムの生出力、USSD の開始/継続/キャンセルフロー、明確なモデムエラーレポート。 |
-| SMS | セルラーおよび IMS SMS の直接送信、受信同期、マルチパート処理、配信レポート、会話履歴、未読状態、タイムスタンプ、メッセージごとの配信ステータス。 |
-| WiFi Calling | IKEv2/ePDG トンネルの確立、EAP-AKA 認証、IMS 登録、IMS SMS、再接続制御、ステータス診断、デバイスごとのルーティング。 |
-| eSIM と eUICC | eUICC の検出、EID と製造情報、証明書メタデータ、複数 eUICC のインベントリ、インストール済みプロファイルの一覧、有効化/無効化/切り替え操作、およびカードが対応している場合のダウンロード、名前変更、削除操作。 |
-| カードポリシー | ICCID ベースの WiFi Calling および機内モードの動作で、ポリシーが即時に適用されます。 |
-| プロキシルーティング | アップストリーム SOCKS ルーティング、デバイスバインディング、国別ルール、TCP 到達性チェック、WiFi Calling データパス向けの UDP Associate チェック。 |
-| 通知 | Telegram、Bark、メール、Pushplus、署名付き Webhook を介した新着 SMS の転送。各 SMS は個別の通知として配信されます。 |
-| Telegram ボット | デバイスステータス、インストール済みプロファイルの一覧と切り替え、WiFi Calling 制御、SMS 送信。機密性の高い操作には管理者の確認が必要です。 |
-| 運用 | 認証、CSRF 保護、アクセスポリシー、監査イベント、ライブログ、ログ保持、ヘルスチェック、レスポンシブレイアウト、ダークモード、英語/中国語のアプリケーション UI。 |
-| 配布 | 静的 Linux バイナリ、systemd インストールスクリプト、SHA-256 検証付きの自己更新、Docker イメージ、GHCR 公開、GitHub Actions リリースビルド。 |
-
-## 対応ハードウェア
-
-Vocat は、互換性のある AT、QMI、シリアル、USB ネットワークインターフェースを公開する Qualcomm ベースの Quectel モジュールを対象としています。対象には以下が含まれます:
-
-- Quectel EC20
-- Quectel EC25
-- Quectel EG25 ファミリー
-- 互換性のある EG600 および関連モジュール
-
-利用可能な機能は、モジュールのファームウェア、USB 構成、SIM/eSIM の機能、ホストドライバー、無線ネットワーク、キャリア設定によって異なります。
-
-## インストール
-
-### ワンクリック Linux インストール
-
-root として(`sudo` が通常存在しない OpenWrt/Kwrt を含む):
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash
-```
-
-sudo を持つディストリビューションの一般ユーザーから:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | sudo bash
-```
-
-VoCat をインストールせずに、ホストの VoWiFi/XFRM 前提条件を確認する:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash -s -- --check-env
-```
-
-特定のバージョンをインストールする:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh -o install.sh
-sudo bash install.sh 0.0.2
-```
-
-VoWiFi IMS には Linux XFRM/IPsec が必要です。OpenWrt/Kwrt では、インストーラーはファームウェア自身のフィードから、一致する `ip-full`、`kmod-ipsec`、`kmod-ipsec4/6`、`kmod-crypto-authenc`、AES-CBC、SHA1 パッケージのインストールを試みます。一致するカーネルモジュールが利用できない場合は、それらを含むファームウェアを使用してください。別のカーネル向けにビルドされた kmod を強制的にインストールしてはいけません。
-
-インストーラーは次を行います:
-
-- `amd64`、`386`、`arm64`、`aarch64`、`armv7` を検出します;
-- 一致する GitHub Release バイナリをダウンロードします;
-- `SHA256SUMS` と照合して検証します;
-- Vocat を `/opt/vocat` にインストールします;
-- Vocat が必要とするハードウェアおよびネットワークアクセスを持つ強化された systemd サービスを作成します;
-- 実行時設定を `/etc/vocat/env` に保存します;
-- 初回インストール時にランダムな初期管理者パスワードを生成します。
-
-インストール後、次を開きます:
-
-```text
-http://<サーバーアドレス>:7575
-```
-
-### 手動バイナリインストール
-
-一致するバイナリと `SHA256SUMS` を GitHub Releases からダウンロードします:
-
-| プラットフォーム | リリースファイル |
-| --- | --- |
-| Linux x86-64 | `vocat-linux-amd64` |
-| Linux x86 32 ビット | `vocat-linux-386` |
-| Linux ARM64 | `vocat-linux-arm64` |
-| Linux AArch64 | `vocat-linux-aarch64` |
-| Linux ARMv7 | `vocat-linux-armv7` |
-
-検証してインストールします:
-
-```bash
-sha256sum -c SHA256SUMS --ignore-missing
-sudo install -d -m 0755 /opt/vocat/bin /opt/vocat/data
-sudo install -m 0755 vocat-linux-amd64 /opt/vocat/bin/vocat
-read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | sudo /opt/vocat/bin/vocat bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-sudo env \
-  VOCAT_DATABASE_PATH=/opt/vocat/data/vocat.db \
-  /opt/vocat/bin/vocat serve
-```
-
-この手動コマンドは Vocat をフォアグラウンドで実行します。プロセスがサーバーを直接起動するように `vocat serve` を使用してください。TTY で root として引数なしで `vocat` を実行すると、代わりに対話型管理メニューが開きます。管理対象の systemd サービスと自動再起動が必要な場合は、ワンクリックインストーラーを使用してください。
-
-### Docker
-
-接続されているすべてのサポート対象 Quectel モデムを検出し、USB ホットプラグイベントを継続的に認識する必要がある Linux ホストでは、Vocat をハードウェアアクセスモードで実行します:
-
-```bash
-docker pull ghcr.io/mengmengcode/vocat:latest
-
-read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | docker run --rm -i \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  --entrypoint /opt/vocat/bin/vocat \
-  ghcr.io/mengmengcode/vocat:latest bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-
-docker run -d \
-  --name vocat \
-  --restart unless-stopped \
-  --network host \
-  --privileged \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  -v /dev:/dev \
-  -v /sys:/sys:ro \
-  ghcr.io/mengmengcode/vocat:latest
-```
-
-コンテナの起動後に `http://<サーバーアドレス>:7575` を開きます。QMI ネットワークインターフェースが Vocat から見えるようにするにはホストネットワークが必要であり、シリアルポート、QMI 制御ノード、TUN インターフェース、ネットワーク設定、コンテナ起動後に追加されたデバイスには特権デバイスアクセスが必要です。`/dev` バインドマウントにより、コンテナを再作成せずに新しい `ttyUSB*`、`ttyACM*`、`cdc-wdm*` ノードが見えるようになります。
-
-このモードは意図的に Vocat にホストのデバイスとネットワークスタックへの広範なアクセスを付与します。信頼できる Linux ホストでのみ使用してください。自動検出は現在、サポート対象の Quectel USB モデム(USB ベンダー ID `2c7c`)のみを識別し、任意のモデムブランドは識別しません。`--device` で `/dev/ttyUSB2` や `/dev/cdc-wdm0` などの個別ノードのみをマッピングすると、コンテナはそれらの固定ノードに限定され、完全なマルチデバイスまたはホットプラグ検出は提供されません。
-
-GHCR イメージは `linux/amd64` と `linux/arm64` 向けに公開されています。
-
-## 設定
-
-Vocat は `VOCAT_CONFIG` からオプションの JSON 設定ファイルを読み込み、次に `VOCAT_*` 環境変数を適用します。環境変数が優先されます。
-
-| 環境変数 | デフォルト | 説明 |
-| --- | --- | --- |
-| `VOCAT_ADDR` | `0.0.0.0:7575` | HTTP リッスンアドレス。 |
-| `VOCAT_DATABASE_PATH` | `./data/vocat.db` | SQLite データベースパス。 |
-| `VOCAT_SESSION_TTL` | `24h` | 認証セッションの有効期間。 |
-| `VOCAT_SECURE_COOKIES` | `false` | HTTPS 使用時にセッション Cookie をセキュアとしてマークします。 |
-| `VOCAT_SHUTDOWN_TIMEOUT` | `10s` | グレースフルシャットダウンのタイムアウト。 |
-| `VOCAT_MAX_REQUEST_BODY_BYTES` | `1048576` | API リクエストボディの最大サイズ。 |
-| `VOCAT_REPO` | `MengMengCode/VoCat` | 自己更新機能が使用する信頼された GitHub リポジトリ(`owner/name` 形式)。 |
-| `GITHUB_TOKEN` | 空 | プライベートリポジトリやより高い API レート制限のためのオプションの GitHub トークン。 |
-
-Telegram トークン、SMTP パスワード、Webhook シークレット、SIM 認証情報、その他のプライベートデータをリポジトリに保存しないでください。アプリケーション設定または保護された環境ファイルを通じて設定してください。
-
-## Telegram ボット
-
-Telegram 通知が有効で、Chat ID と Admin ID の両方が設定されている場合、ボットは以下をサポートします:
-
-```text
-/status [デバイス]
-/esim <デバイス>
-/switch <デバイス> <iccid>
-/wfc <デバイス> <status|on|off|reconnect>
-/sms <デバイス> <番号> <メッセージ>
-```
-
-プロファイルの切り替えと SMS の送信には、ワンタイム確認ボタンが使用されます。ボットは eSIM のダウンロード、削除、名前変更コマンドを公開しません。
-
-## 更新
-
-より新しい GitHub Release を確認する:
-
-```bash
-vocat update --check --repo MengMengCode/VoCat
-```
-
-最新リリースをインストールする:
-
-```bash
-sudo vocat update --repo MengMengCode/VoCat
-```
-
-アップデーターは、現在の Linux アーキテクチャに一致するバイナリをダウンロードし、公開された `SHA256SUMS` で検証し、実行ファイルをアトミックに置き換え、利用可能な場合は `vocat` systemd サービスを再起動します。
-
-Docker インストールの場合:
-
-```bash
-docker pull ghcr.io/mengmengcode/vocat:latest
-```
-
-新しいイメージをプルした後、コンテナを再作成します。
-
-## 開発
-
-要件:
-
-- Go 1.25 以降
-- Node.js 20 以降
-- npm
-
-フロントエンド開発サーバーを実行する:
-
-```bash
-cd web
-npm install
-npm run dev
-```
-
-埋め込みフロントエンドをビルドしてバックエンドを起動する:
-
-```bash
-cd web
-npm run build
-cd ..
-go run ./cmd/vocat
-```
-
-すべてのテストを実行する:
-
-```bash
-go test ./...
-```
-
-本番バイナリをビルドする:
-
-```bash
-go build -trimpath -ldflags "-s -w" -o vocat ./cmd/vocat
-```
-
-## リリース自動化
-
-バージョンタグをプッシュすると、2 つの GitHub Actions ワークフローが開始されます:
-
-- `release-binaries` は `amd64`、`386`、`arm64`、`aarch64`、`armv7` バイナリと `SHA256SUMS` をビルドして公開します。
-- `docker` はマルチアーキテクチャイメージをビルドして GitHub Container Registry に公開します。
-
-```bash
-git tag v0.2.0
-git push origin v0.2.0
-```
-
-## プロジェクト構成
-
-```text
-cmd/vocat/                  アプリケーションのエントリポイントと CLI
-internal/device/            モデム検出とデバイス制御
-internal/modem/             AT セッションと応答処理
-internal/server/            HTTP API、通知、埋め込み Web サーバー
-internal/store/             SQLite 永続化
-internal/update/            GitHub Release 自己更新機能
-internal/vowifi/            IKE、EAP-AKA、IMS、WiFi Calling ランタイム
-scripts/install.sh          Linux インストーラーとアップデーター
-web/src/                    React と TypeScript のフロントエンド
-.github/workflows/          バイナリと Docker のリリース自動化
-```
-
-## 責任ある使用
-
-セルラーモデムおよび eSIM の操作は、加入者サービス、保存されたプロファイル、ネットワーク登録、ハードウェア状態に影響を与える可能性があります。バックアップを保持し、破壊的な操作を慎重に確認し、接続されたハードウェアとネットワークリソースを操作することが許可されている合法的な環境でのみソフトウェアを使用してください。
-
-Vocat は、キャリア認証、ネットワークポリシー、ハードウェアセキュリティ、eSIM の信頼要件をバイパスしません。操作のサポートは、Vocat がモデムまたは eUICC にそれを要求できることを意味します。デバイス、プロファイル、ネットワーク、またはキャリアがそれを拒否する場合があります。
-
-## コントリビューション
-
-Issue や Pull Request を歓迎します。変更は焦点を絞り、可能な場合はテストを含め、認証情報や加入者データをコミットしないようにし、ハードウェア固有の動作を明確に文書化してください。
-
-変更を提出する前に:
-
-```bash
-go test ./...
-cd web && npm run build
-```
-
-## 謝辞
-- [Nodeseek.com](https://www.nodeseek.com) — サーバーに特化したコミュニティ
-- [Linux.do](https://linux.do) — 刺激的なテックコミュニティ
-- [iniwex5](https://github.com/iniwex5) — スタイルと機能のガイドライン
-
-## コーヒーをおごってください
-
-| ネットワーク | アドレス |
-| ------- | ------- |
-| USDT-TRON (TRC20) | `TQQAbboBoU8h5xX4YCA1rqWJU2WjK3seSg` |
-| USDT-BSC (BEP20) | `0xdbfcd4a462550d6ff06d09cbd89026c6b145d9c4` |
-| USDT-Polygon | `0xdbfcd4a462550d6ff06d09cbd89026c6b145d9c4` |
-
-## ライセンス
-
-[LICENSE](../LICENSE) を参照してください。
-
-[![MengMengCode/VoCat Star History](https://mengmeng.meteor-history.com/api/embed/MengMengCode/VoCat.svg?sig=sdeXRVxAoY3yLWgXL7JViY2USYIN3t9neJ6ScPvgUAo&theme=light&style=xkcd&color=dd4528&background=ffffff&textColor=000000&width=900&height=600&lineWidth=3&showTitle=true&showLegend=true&showDots=false&v=0.0.14)](https://meteor-history.com)

docs/README.ru.md

@@ -1,342 +0,0 @@
-<p align="center">
-  <img src="../web/public/favicon.svg" width="96" alt="Vocat">
-</p>
-
-<h1 align="center">VoCat</h1>
-
-<p align="center">
-  <img alt="Go" src="https://img.shields.io/badge/Go-1.25-00ADD8?style=flat-square&logo=go&logoColor=white">
-  <img alt="React" src="https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=111111">
-  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.8-3178C6?style=flat-square&logo=typescript&logoColor=white">
-  <img alt="Vite" src="https://img.shields.io/badge/Vite-7-646CFF?style=flat-square&logo=vite&logoColor=white">
-  <img alt="Tailwind CSS" src="https://img.shields.io/badge/Tailwind_CSS-3-06B6D4?style=flat-square&logo=tailwindcss&logoColor=white">
-  <img alt="SQLite" src="https://img.shields.io/badge/SQLite-Embedded-003B57?style=flat-square&logo=sqlite&logoColor=white">
-</p>
-
-<p align="center">
-  <img alt="Linux" src="https://img.shields.io/badge/Linux-amd64_%7C_386_%7C_arm64_%7C_aarch64_%7C_armv7-FCC624?style=flat-square&logo=linux&logoColor=111111">
-  <img alt="Docker" src="https://img.shields.io/badge/Docker-Multi--Arch-2496ED?style=flat-square&logo=docker&logoColor=white">
-  <img alt="WiFi Calling" src="https://img.shields.io/badge/WiFi_Calling-IMS_SMS-7B1FA2?style=flat-square">
-  <img alt="eSIM" src="https://img.shields.io/badge/eSIM-LPA_%2F_eUICC-009688?style=flat-square">
-  <img alt="Telegram" src="https://img.shields.io/badge/Telegram-Bot-26A5E4?style=flat-square&logo=telegram&logoColor=white">
-  <img alt="GitHub Actions" src="https://img.shields.io/badge/GitHub_Actions-Release-2088FF?style=flat-square&logo=githubactions&logoColor=white">
-</p>
-
-[English](../README.md) | [العربية](README.ar.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [Français](README.fr.md) | **Русский** | [Español](README.es.md) | [日本語](README.ja.md)
-
-Vocat — это веб-панель управления с открытым исходным кодом и набор инженерных инструментов для сотовых модемов Quectel класса EC20/EC25. Она объединяет в одном автономном сервисе обнаружение модемов, состояние радиосвязи в реальном времени, терминалы AT и USSD, SMS, WiFi Calling, управление eSIM, выбор сети, маршрутизацию через прокси, уведомления, журналы аудита и автоматизацию релизов.
-
-Бэкенд написан на Go, интерфейс построен на React и TypeScript, а производственный фронтенд встроен в бинарный файл Go. Один исполняемый файл содержит веб-приложение и использует SQLite для постоянного хранения состояния.
-
-<p align="center">
-  <img src="../img/image.png">
-  <img src="../img/image-1.png">
-</p>
-
-## Возможности
-
-| Область | Что предоставляет Vocat |
-| --- | --- |
-| Управление устройствами | Автоматическое обнаружение по последовательному порту/USB, поддержка нескольких модемов, понятные имена устройств, обновление обзора в реальном времени, перезапуск модуля, авиарежим и управление режимом USB-сети. |
-| Радио и сеть | Статус регистрации, оператор, метрики сигнала, RSRP/RSRQ/SINR, режим сети, диапазон, канал, сканирование операторов и автоматический или ручной выбор сети. |
-| AT и USSD | Интерактивный AT-терминал, история команд, необработанные ответы модема, потоки запуска/продолжения/отмены USSD и понятные сообщения об ошибках модема. |
-| SMS | Прямая отправка сотовых и IMS SMS, входящая синхронизация, обработка составных сообщений, отчёты о доставке, история диалогов, статус непрочитанных, метки времени и статус доставки каждого сообщения. |
-| WiFi Calling | Установка туннеля IKEv2/ePDG, аутентификация EAP-AKA, регистрация IMS, IMS SMS, управление переподключением, диагностика состояния и маршрутизация по устройствам. |
-| eSIM и eUICC | Обнаружение eUICC, EID и производственная информация, метаданные сертификатов, инвентарь нескольких eUICC, список установленных профилей, операции включения/отключения/переключения, а также загрузка, переименование и удаление при поддержке картой. |
-| Политика карты | Поведение WiFi Calling и авиарежима на основе ICCID с немедленным применением политики. |
-| Маршрутизация через прокси | Восходящая маршрутизация SOCKS, привязки устройств, правила по странам, проверки доступности TCP и проверки UDP Associate для путей передачи данных WiFi Calling. |
-| Уведомления | Пересылка новых входящих SMS через Telegram, Bark, электронную почту, Pushplus и подписанные вебхуки. Каждое SMS доставляется как отдельное уведомление. |
-| Telegram-бот | Статус устройства, список и переключение установленных профилей, управление WiFi Calling и отправка SMS. Чувствительные действия требуют подтверждения администратора. |
-| Эксплуатация | Аутентификация, защита CSRF, политики доступа, события аудита, журналы в реальном времени, хранение журналов, проверки работоспособности, адаптивная вёрстка, тёмный режим и интерфейс на английском/китайском. |
-| Дистрибуция | Статические бинарные файлы Linux, скрипт установки systemd, самообновление с проверкой SHA-256, образ Docker, публикация в GHCR и сборки релизов GitHub Actions. |
-
-## Поддерживаемое оборудование
-
-Vocat ориентирован на модули Quectel на базе Qualcomm, которые предоставляют совместимые интерфейсы AT, QMI, последовательный порт и USB-сеть, включая:
-
-- Quectel EC20
-- Quectel EC25
-- Семейство Quectel EG25
-- Совместимые модули EG600 и родственные
-
-Доступные функции зависят от прошивки модуля, конфигурации USB, возможностей SIM/eSIM, драйверов хоста, радиосети и настроек оператора.
-
-## Установка
-
-### Установка в Linux одной командой
-
-От имени root (включая OpenWrt/Kwrt, где `sudo` обычно отсутствует):
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash
-```
-
-От обычного пользователя в дистрибутиве с sudo:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | sudo bash
-```
-
-Проверить предварительные требования VoWiFi/XFRM на хосте без установки VoCat:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash -s -- --check-env
-```
-
-Установить конкретную версию:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh -o install.sh
-sudo bash install.sh 0.0.2
-```
-
-VoWiFi IMS требует Linux XFRM/IPsec. В OpenWrt/Kwrt установщик пытается
-установить соответствующие пакеты `ip-full`, `kmod-ipsec`, `kmod-ipsec4/6`,
-`kmod-crypto-authenc`, AES-CBC и SHA1 из собственного репозитория прошивки.
-Если соответствующие модули ядра недоступны, используйте прошивку, которая их включает;
-никогда не устанавливайте принудительно kmod, собранные для другого ядра.
-
-Установщик:
-
-- определяет `amd64`, `386`, `arm64`, `aarch64` или `armv7`;
-- загружает соответствующий бинарный файл GitHub Release;
-- проверяет его по `SHA256SUMS`;
-- устанавливает Vocat в `/opt/vocat`;
-- создаёт усиленный сервис systemd с доступом к оборудованию и сети, необходимым Vocat;
-- хранит конфигурацию времени выполнения в `/etc/vocat/env`;
-- генерирует случайный начальный пароль администратора при первой установке.
-
-После установки откройте:
-
-```text
-http://<адрес-сервера>:7575
-```
-
-### Ручная установка бинарного файла
-
-Загрузите соответствующий бинарный файл и `SHA256SUMS` из GitHub Releases:
-
-| Платформа | Файл релиза |
-| --- | --- |
-| Linux x86-64 | `vocat-linux-amd64` |
-| Linux x86 32-бит | `vocat-linux-386` |
-| Linux ARM64 | `vocat-linux-arm64` |
-| Linux AArch64 | `vocat-linux-aarch64` |
-| Linux ARMv7 | `vocat-linux-armv7` |
-
-Проверьте и установите его:
-
-```bash
-sha256sum -c SHA256SUMS --ignore-missing
-sudo install -d -m 0755 /opt/vocat/bin /opt/vocat/data
-sudo install -m 0755 vocat-linux-amd64 /opt/vocat/bin/vocat
-read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | sudo /opt/vocat/bin/vocat bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-sudo env \
-  VOCAT_DATABASE_PATH=/opt/vocat/data/vocat.db \
-  /opt/vocat/bin/vocat serve
-```
-
-Эта ручная команда запускает Vocat в переднем плане. Используйте `vocat serve`, чтобы
-процесс сразу запустил сервер; запуск `vocat` без аргументов от имени root
-в TTY вместо этого открывает интерактивное меню управления. Используйте установку
-одной командой, когда требуется управляемый сервис systemd и автоматический перезапуск.
-
-### Docker
-
-Для хоста Linux, который должен обнаруживать каждый подключённый поддерживаемый модем Quectel и
-продолжать видеть события горячего подключения USB, запустите Vocat в режиме доступа к оборудованию:
-
-```bash
-docker pull ghcr.io/mengmengcode/vocat:latest
-
-read -rsp "Admin password: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | docker run --rm -i \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  --entrypoint /opt/vocat/bin/vocat \
-  ghcr.io/mengmengcode/vocat:latest bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-
-docker run -d \
-  --name vocat \
-  --restart unless-stopped \
-  --network host \
-  --privileged \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  -v /dev:/dev \
-  -v /sys:/sys:ro \
-  ghcr.io/mengmengcode/vocat:latest
-```
-
-Откройте `http://<адрес-сервера>:7575` после запуска контейнера. Сеть хоста
-необходима, чтобы сетевые интерфейсы QMI оставались видимыми для Vocat, а привилегированный
-доступ к устройствам необходим для последовательных портов, узлов управления QMI, интерфейсов
-TUN, настройки сети и устройств, добавленных после запуска контейнера. Монтирование `/dev`
-делает новые узлы `ttyUSB*`, `ttyACM*` и `cdc-wdm*` видимыми без пересоздания контейнера.
-
-Этот режим намеренно предоставляет Vocat широкий доступ к устройствам и сетевому стеку
-хоста. Используйте его только на доверенном хосте Linux. Автоматическое обнаружение
-в настоящее время определяет поддерживаемые USB-модемы Quectel (USB vendor ID `2c7c`), а не
-произвольные марки модемов. Монтирование только отдельных узлов с помощью `--device`, таких как
-`/dev/ttyUSB2` и `/dev/cdc-wdm0`, ограничивает контейнер этими фиксированными узлами и не
-обеспечивает полное обнаружение нескольких устройств или горячего подключения.
-
-Образ GHCR публикуется для `linux/amd64` и `linux/arm64`.
-
-## Конфигурация
-
-Vocat читает необязательный JSON-файл конфигурации из `VOCAT_CONFIG`, затем применяет переменные окружения `VOCAT_*`. Переменные окружения имеют приоритет.
-
-| Переменная окружения | По умолчанию | Описание |
-| --- | --- | --- |
-| `VOCAT_ADDR` | `0.0.0.0:7575` | Адрес прослушивания HTTP. |
-| `VOCAT_DATABASE_PATH` | `./data/vocat.db` | Путь к базе данных SQLite. |
-| `VOCAT_SESSION_TTL` | `24h` | Время жизни сессии аутентификации. |
-| `VOCAT_SECURE_COOKIES` | `false` | Помечает cookie сессии как безопасные при использовании HTTPS. |
-| `VOCAT_SHUTDOWN_TIMEOUT` | `10s` | Тайм-аут корректного завершения работы. |
-| `VOCAT_MAX_REQUEST_BODY_BYTES` | `1048576` | Максимальный размер тела запроса API. |
-| `VOCAT_REPO` | `MengMengCode/VoCat` | Доверенный репозиторий GitHub, используемый самообновлятором, в формате `owner/name`. |
-| `GITHUB_TOKEN` | пусто | Необязательный токен GitHub для приватных репозиториев или более высоких лимитов API. |
-
-Не храните токены Telegram, пароли SMTP, секреты вебхуков, учётные данные SIM или другие приватные данные в репозитории. Настраивайте их через параметры приложения или защищённые файлы окружения.
-
-## Telegram-бот
-
-Когда уведомления Telegram включены и настроены Chat ID и Admin ID, бот поддерживает:
-
-```text
-/status [устройство]
-/esim <устройство>
-/switch <устройство> <iccid>
-/wfc <устройство> <status|on|off|reconnect>
-/sms <устройство> <номер> <сообщение>
-```
-
-Переключение профилей и отправка SMS используют одноразовые кнопки подтверждения. Бот не предоставляет команды загрузки, удаления или переименования eSIM.
-
-## Обновление
-
-Проверить наличие более нового GitHub Release:
-
-```bash
-vocat update --check --repo MengMengCode/VoCat
-```
-
-Установить последний релиз:
-
-```bash
-sudo vocat update --repo MengMengCode/VoCat
-```
-
-Обновлятор загружает бинарный файл, соответствующий текущей архитектуре Linux, проверяет его по опубликованному `SHA256SUMS`, атомарно заменяет исполняемый файл и перезапускает сервис systemd `vocat`, когда он доступен.
-
-Для установок Docker:
-
-```bash
-docker pull ghcr.io/mengmengcode/vocat:latest
-```
-
-Пересоздайте контейнер после загрузки нового образа.
-
-## Разработка
-
-Требования:
-
-- Go 1.25 или новее
-- Node.js 20 или новее
-- npm
-
-Запустить сервер разработки фронтенда:
-
-```bash
-cd web
-npm install
-npm run dev
-```
-
-Собрать встроенный фронтенд и запустить бэкенд:
-
-```bash
-cd web
-npm run build
-cd ..
-go run ./cmd/vocat
-```
-
-Запустить все тесты:
-
-```bash
-go test ./...
-```
-
-Собрать производственный бинарный файл:
-
-```bash
-go build -trimpath -ldflags "-s -w" -o vocat ./cmd/vocat
-```
-
-## Автоматизация релизов
-
-Отправка тега версии запускает два рабочих процесса GitHub Actions:
-
-- `release-binaries` собирает и публикует бинарные файлы `amd64`, `386`, `arm64`, `aarch64` и `armv7` вместе с `SHA256SUMS`.
-- `docker` собирает и публикует мультиархитектурный образ в GitHub Container Registry.
-
-```bash
-git tag v0.2.0
-git push origin v0.2.0
-```
-
-## Структура проекта
-
-```text
-cmd/vocat/                  Точка входа приложения и CLI
-internal/device/            Обнаружение модемов и управление устройствами
-internal/modem/             Сессия AT и обработка ответов
-internal/server/            HTTP API, уведомления и встроенный веб-сервер
-internal/store/             Постоянное хранение SQLite
-internal/update/            Самообновлятор GitHub Release
-internal/vowifi/            Среда выполнения IKE, EAP-AKA, IMS и WiFi Calling
-scripts/install.sh          Установщик и обновлятор Linux
-web/src/                    Фронтенд на React и TypeScript
-.github/workflows/          Автоматизация релизов бинарных файлов и Docker
-```
-
-## Ответственное использование
-
-Операции с сотовыми модемами и eSIM могут влиять на обслуживание абонента, сохранённые профили, регистрацию в сети и состояние оборудования. Делайте резервные копии, внимательно проверяйте деструктивные действия и используйте программное обеспечение только в законных средах, где вам разрешено работать с подключённым оборудованием и сетевыми ресурсами.
-
-Vocat не обходит аутентификацию оператора, сетевую политику, аппаратную безопасность или требования доверия eSIM. Поддержка операции означает, что Vocat может запросить её у модема или eUICC; устройство, профиль, сеть или оператор всё равно могут её отклонить.
-
-## Участие в разработке
-
-Мы приветствуем issues и pull request'ы. Делайте изменения сфокусированными, по возможности добавляйте тесты, избегайте коммита учётных данных или данных абонентов и чётко документируйте поведение, специфичное для оборудования.
-
-Перед отправкой изменения:
-
-```bash
-go test ./...
-cd web && npm run build
-```
-
-## Благодарности
-- [Nodeseek.com](https://www.nodeseek.com) — Сообщество, посвящённое серверам
-- [Linux.do](https://linux.do) — Вдохновляющее технологическое сообщество
-- [iniwex5](https://github.com/iniwex5) — Руководства по стилю и функциональности
-
-## Угостите меня кофе
-
-| Сеть | Адрес |
-| ------- | ------- |
-| USDT-TRON (TRC20) | `TQQAbboBoU8h5xX4YCA1rqWJU2WjK3seSg` |
-| USDT-BSC (BEP20) | `0xdbfcd4a462550d6ff06d09cbd89026c6b145d9c4` |
-| USDT-Polygon | `0xdbfcd4a462550d6ff06d09cbd89026c6b145d9c4` |
-
-## Лицензия
-
-См. [LICENSE](../LICENSE).
-
-[![MengMengCode/VoCat Star History](https://mengmeng.meteor-history.com/api/embed/MengMengCode/VoCat.svg?sig=sdeXRVxAoY3yLWgXL7JViY2USYIN3t9neJ6ScPvgUAo&theme=light&style=xkcd&color=dd4528&background=ffffff&textColor=000000&width=900&height=600&lineWidth=3&showTitle=true&showLegend=true&showDots=false&v=0.0.14)](https://meteor-history.com)

docs/README.zh-CN.md

@@ -22,7 +22,7 @@
   <img alt="GitHub Actions" src="https://img.shields.io/badge/GitHub_Actions-Release-2088FF?style=flat-square&logo=githubactions&logoColor=white">
 </p>
 
-[English](../README.md) | [العربية](README.ar.md) | **简体中文** | [繁體中文](README.zh-TW.md) | [Français](README.fr.md) | [Русский](README.ru.md) | [Español](README.es.md) | [日本語](README.ja.md)
+[English](../README.md) | **简体中文**
 
 Vocat 是一款面向 Quectel EC20/EC25 系列蜂窝模组的开源 Web 控制面板与工程工具套件。它在一个自包含的服务中整合了模组发现、实时射频状态、AT 与 USSD 终端、短信、WiFi Calling(WiFi 通话)、eSIM 管理、网络选择、代理路由、通知、审计日志以及发布自动化。
 
@@ -46,7 +46,7 @@ Vocat 是一款面向 Quectel EC20/EC25 系列蜂窝模组的开源 Web 控制
 | 卡策略 | 基于 ICCID 的 WiFi Calling 与飞行模式行为,策略即时应用。 |
 | 代理路由 | 上游 SOCKS 路由、设备绑定、国家规则、TCP 可达性检查以及面向 WiFi Calling 数据路径的 UDP Associate 检查。 |
 | 通知 | 通过 Telegram、Bark、邮件、Pushplus 以及签名 Webhook 转发新入站短信,每条短信单独推送。 |
-| Telegram 机器人 | 设备状态、已安装配置文件列表与切换、WiFi Calling 控制以及短信发送。敏感操作需要管理员确认。 |
+| Telegram 机器人 | 设备状态、已安装配置文件列表与切换、WiFi Calling 控制、短信发送、定时拨号并自动挂断、通话状态、接听与挂断命令。敏感操作需要管理员确认。 |
 | 运维 | 鉴权、CSRF 防护、访问策略、审计事件、实时日志、日志留存、健康检查、响应式布局、深色模式以及中英文应用界面。 |
 | 分发 | 静态 Linux 二进制、systemd 安装脚本、带 SHA-256 校验的自更新、Docker 镜像、GHCR 发布以及 GitHub Actions 发布构建。 |
 
@@ -65,24 +65,10 @@ Vocat 面向基于高通芯片、并暴露兼容 AT、QMI、串口与 USB 网络
 
 ### Linux 一键安装
 
-已是 root（包括默认没有 `sudo` 的 OpenWrt/Kwrt）：
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash
-```
-
-普通 Linux 用户且系统装有 sudo：
-
 ```bash
 curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | sudo bash
 ```
 
-只检查 VoWiFi/XFRM 环境，不安装 VoCat：
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash -s -- --check-env
-```
-
 安装指定版本:
 
 ```bash
@@ -90,8 +76,6 @@ curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/i
 sudo bash install.sh 0.0.2
 ```
 
-VoWiFi IMS 必须使用 Linux XFRM/IPsec。OpenWrt/Kwrt 上安装脚本会从当前固件自己的软件源尝试安装严格匹配的 `ip-full`、`kmod-ipsec`、`kmod-ipsec4/6`、`kmod-crypto-authenc`、AES-CBC 和 SHA1 组件。若软件源没有与当前内核匹配的模块，必须更换包含这些组件的固件，禁止强装其他内核版本的 kmod。
-
 安装程序会:
 
 - 检测 `amd64`、`386`、`arm64` 或 `armv7` 架构;
@@ -125,11 +109,9 @@ http://<服务器地址>:7575
 sha256sum -c SHA256SUMS --ignore-missing
 sudo install -d -m 0755 /opt/vocat/bin /opt/vocat/data
 sudo install -m 0755 vocat-linux-amd64 /opt/vocat/bin/vocat
-read -rsp "管理员密码: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | sudo /opt/vocat/bin/vocat bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
 sudo env \
   VOCAT_DATABASE_PATH=/opt/vocat/data/vocat.db \
+  VOCAT_ADMIN_PASSWORD=change-this-password \
   /opt/vocat/bin/vocat serve
 ```
 
@@ -142,20 +124,13 @@ sudo env \
 ```bash
 docker pull ghcr.io/mengmengcode/vocat:latest
 
-read -rsp "管理员密码: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | docker run --rm -i \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  --entrypoint /opt/vocat/bin/vocat \
-  ghcr.io/mengmengcode/vocat:latest bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-
 docker run -d \
   --name vocat \
   --restart unless-stopped \
   --network host \
   --privileged \
   --user 0:0 \
+  -e VOCAT_ADMIN_PASSWORD=change-this-password \
   -v vocat-data:/opt/vocat/data \
   -v /dev:/dev \
   -v /sys:/sys:ro \
@@ -168,13 +143,6 @@ docker run -d \
 
 GHCR 镜像发布为 `linux/amd64` 与 `linux/arm64`。
 
-### USB SIM 读卡器
-
-USB SIM 读卡器通过 Linux PC/SC 服务访问。一键安装脚本会在支持的软件包管理器上
-自动安装并启动 `pcscd` 和 CCID 驱动；Debian/Ubuntu 手动安装命令为
-`apt install pcscd libccid`。如果 USB 已识别 CCID 读卡器但 PC/SC 尚未就绪，
-VoCat 会继续在添加设备窗口显示该硬件，并明确提示缺少服务或驱动，不再静默隐藏。
-
 ## 配置
 
 Vocat 先从 `VOCAT_CONFIG` 读取可选的 JSON 配置文件,再应用 `VOCAT_*` 环境变量。环境变量优先级更高。
@@ -183,6 +151,8 @@ Vocat 先从 `VOCAT_CONFIG` 读取可选的 JSON 配置文件,再应用 `VOCAT_*
 | --- | --- | --- |
 | `VOCAT_ADDR` | `0.0.0.0:7575` | HTTP 监听地址。 |
 | `VOCAT_DATABASE_PATH` | `./data/vocat.db` | SQLite 数据库路径。 |
+| `VOCAT_ADMIN_USERNAME` | `admin` | 初始管理员用户名。 |
+| `VOCAT_ADMIN_PASSWORD` | `admin` | 初始管理员密码。暴露服务前请务必修改。 |
 | `VOCAT_SESSION_TTL` | `24h` | 鉴权会话有效期。 |
 | `VOCAT_SECURE_COOKIES` | `false` | 在使用 HTTPS 时将会话 Cookie 标记为安全。 |
 | `VOCAT_SHUTDOWN_TIMEOUT` | `10s` | 优雅关闭超时时间。 |
@@ -190,9 +160,6 @@ Vocat 先从 `VOCAT_CONFIG` 读取可选的 JSON 配置文件,再应用 `VOCAT_*
 | `VOCAT_REPO` | `MengMengCode/VoCat` | 自更新器使用的受信任 GitHub 仓库，格式为 `owner/name`。 |
 | `GITHUB_TOKEN` | 空 | 可选的 GitHub token,用于私有仓库或更高的 API 限额。 |
 
-管理员账号和密码只保存在 SQLite 数据库中。空数据库需要执行一次
-`vocat bootstrap-admin` 完成初始化；环境变量和 JSON 配置都不能设置或覆盖管理员凭据。
-
 请勿将 Telegram token、SMTP 密码、Webhook 密钥、SIM 凭据或其他私密数据存放在仓库中。请通过应用设置或受保护的环境文件来配置它们。
 
 ## Telegram 机器人
@@ -205,9 +172,13 @@ Vocat 先从 `VOCAT_CONFIG` 读取可选的 JSON 配置文件,再应用 `VOCAT_*
 /switch <设备> <iccid>
 /wfc <设备> <status|on|off|reconnect>
 /sms <设备> <号码> <内容>
+/call <设备> <号码> <秒数>
+/calls <设备>
+/answer <设备>
+/hangup <设备>
 ```
 
-配置文件切换与短信提交使用一次性确认按钮。机器人不暴露 eSIM 下载、删除或重命名命令。
+配置文件切换、短信提交与拨号使用一次性确认按钮。定时拨号会执行模组拨号动作,并在 1–600 秒后自动挂断;不会捕获或处理通话音频。机器人不暴露 eSIM 下载、删除或重命名命令。
 
 ## 更新
 

docs/README.zh-TW.md

@@ -1,325 +0,0 @@
-<p align="center">
-  <img src="../web/public/favicon.svg" width="96" alt="Vocat">
-</p>
-
-<h1 align="center">VoCat</h1>
-
-<p align="center">
-  <img alt="Go" src="https://img.shields.io/badge/Go-1.25-00ADD8?style=flat-square&logo=go&logoColor=white">
-  <img alt="React" src="https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=111111">
-  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.8-3178C6?style=flat-square&logo=typescript&logoColor=white">
-  <img alt="Vite" src="https://img.shields.io/badge/Vite-7-646CFF?style=flat-square&logo=vite&logoColor=white">
-  <img alt="Tailwind CSS" src="https://img.shields.io/badge/Tailwind_CSS-3-06B6D4?style=flat-square&logo=tailwindcss&logoColor=white">
-  <img alt="SQLite" src="https://img.shields.io/badge/SQLite-Embedded-003B57?style=flat-square&logo=sqlite&logoColor=white">
-</p>
-
-<p align="center">
-  <img alt="Linux" src="https://img.shields.io/badge/Linux-amd64_%7C_386_%7C_arm64_%7C_aarch64_%7C_armv7-FCC624?style=flat-square&logo=linux&logoColor=111111">
-  <img alt="Docker" src="https://img.shields.io/badge/Docker-Multi--Arch-2496ED?style=flat-square&logo=docker&logoColor=white">
-  <img alt="WiFi Calling" src="https://img.shields.io/badge/WiFi_Calling-IMS_SMS-7B1FA2?style=flat-square">
-  <img alt="eSIM" src="https://img.shields.io/badge/eSIM-LPA_%2F_eUICC-009688?style=flat-square">
-  <img alt="Telegram" src="https://img.shields.io/badge/Telegram-Bot-26A5E4?style=flat-square&logo=telegram&logoColor=white">
-  <img alt="GitHub Actions" src="https://img.shields.io/badge/GitHub_Actions-Release-2088FF?style=flat-square&logo=githubactions&logoColor=white">
-</p>
-
-[English](../README.md) | [العربية](README.ar.md) | [简体中文](README.zh-CN.md) | **繁體中文** | [Français](README.fr.md) | [Русский](README.ru.md) | [Español](README.es.md) | [日本語](README.ja.md)
-
-Vocat 是一款面向 Quectel EC20/EC25 系列行動通訊模組的開源 Web 控制面板與工程工具套件。它在單一自包含的服務中整合了模組探索、即時射頻狀態、AT 與 USSD 終端、簡訊、WiFi Calling(WiFi 通話)、eSIM 管理、網路選擇、代理路由、通知、稽核日誌以及發佈自動化。
-
-後端使用 Go 撰寫,介面採用 React 與 TypeScript 建構,生產環境前端被嵌入進 Go 二進位檔中。單一可執行檔即包含完整的 Web 應用,並使用 SQLite 進行持久化儲存。
-
-<p align="center">
-  <img src="../img/image.png">
-  <img src="../img/image-1.png">
-</p>
-
-## 功能
-
-| 領域 | Vocat 提供的能力 |
-| --- | --- |
-| 裝置管理 | 自動序列埠/USB 探索、多模組支援、裝置友善名稱、概覽即時更新、模組重新啟動、飛航模式以及 USB 網路卡模式控制。 |
-| 射頻與網路 | 註冊狀態、電信業者、訊號指標、RSRP/RSRQ/SINR、網路模式、頻段、通道、電信業者掃描以及自動/手動選網。 |
-| AT 與 USSD | 互動式 AT 終端、指令歷史、原始模組回應、USSD 發起/繼續/取消流程以及清晰的模組錯誤回報。 |
-| 簡訊 | 行動通訊與 IMS 簡訊直接傳送、接收同步、長簡訊合併、送達報告、對話歷史、未讀狀態、時間戳以及逐則訊息的送達狀態。 |
-| WiFi Calling | IKEv2/ePDG 隧道建立、EAP-AKA 驗證、IMS 註冊、IMS 簡訊、重新連線控制、狀態診斷以及依裝置路由。 |
-| eSIM 與 eUICC | eUICC 探索、EID 與生產資訊、憑證中繼資料、多 eUICC 清單、已安裝設定檔列表、啟用/停用/切換操作,以及在卡片支援時進行下載、重新命名與刪除。 |
-| 卡片策略 | 基於 ICCID 的 WiFi Calling 與飛航模式行為,策略即時套用。 |
-| 代理路由 | 上游 SOCKS 路由、裝置綁定、國家規則、TCP 可達性檢查以及面向 WiFi Calling 資料路徑的 UDP Associate 檢查。 |
-| 通知 | 透過 Telegram、Bark、電子郵件、Pushplus 以及簽章 Webhook 轉發新接收簡訊,每則簡訊個別推送。 |
-| Telegram 機器人 | 裝置狀態、已安裝設定檔列表與切換、WiFi Calling 控制以及簡訊傳送。敏感操作需要管理員確認。 |
-| 維運 | 驗證、CSRF 防護、存取策略、稽核事件、即時日誌、日誌保留、健康檢查、響應式版面、深色模式以及中英文應用介面。 |
-| 發佈 | 靜態 Linux 二進位檔、systemd 安裝腳本、具 SHA-256 校驗的自我更新、Docker 映像、GHCR 發佈以及 GitHub Actions 發佈建置。 |
-
-## 支援的硬體
-
-Vocat 面向基於高通晶片、並暴露相容 AT、QMI、序列埠與 USB 網路介面的 Quectel 模組,包括:
-
-- Quectel EC20
-- Quectel EC25
-- Quectel EG25 系列
-- 相容的 EG600 及相關模組
-
-可用功能取決於模組韌體、USB 複合裝置配置、SIM/eSIM 能力、主機驅動、無線網路以及電信業者配置。
-
-## 安裝
-
-### Linux 一鍵安裝
-
-已是 root（包括預設沒有 `sudo` 的 OpenWrt/Kwrt）：
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash
-```
-
-一般 Linux 使用者且系統裝有 sudo：
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | sudo bash
-```
-
-只檢查 VoWiFi/XFRM 環境，不安裝 VoCat：
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh | bash -s -- --check-env
-```
-
-安裝指定版本:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/MengMengCode/VoCat/master/scripts/install.sh -o install.sh
-sudo bash install.sh 0.0.2
-```
-
-VoWiFi IMS 必須使用 Linux XFRM/IPsec。OpenWrt/Kwrt 上安裝腳本會從目前韌體自己的軟體源嘗試安裝嚴格匹配的 `ip-full`、`kmod-ipsec`、`kmod-ipsec4/6`、`kmod-crypto-authenc`、AES-CBC 和 SHA1 元件。若軟體源沒有與目前核心匹配的模組,必須更換包含這些元件的韌體,禁止強裝其他核心版本的 kmod。
-
-安裝程式會:
-
-- 偵測 `amd64`、`386`、`arm64`、`aarch64` 或 `armv7` 架構;
-- 下載對應的 GitHub Release 二進位檔;
-- 對照 `SHA256SUMS` 進行校驗;
-- 將 Vocat 安裝到 `/opt/vocat`;
-- 建立具有 Vocat 所需硬體與網路存取權限的強化版 systemd 服務;
-- 將執行時配置存放在 `/etc/vocat/env`;
-- 首次安裝時產生隨機初始管理員密碼。
-
-安裝完成後開啟:
-
-```text
-http://<伺服器位址>:7575
-```
-
-### 手動二進位安裝
-
-從 GitHub Releases 下載對應的二進位檔與 `SHA256SUMS`:
-
-| 平台 | 發佈檔案 |
-| --- | --- |
-| Linux x86-64 | `vocat-linux-amd64` |
-| Linux x86 32 位元 | `vocat-linux-386` |
-| Linux ARM64 | `vocat-linux-arm64` |
-| Linux AArch64 | `vocat-linux-aarch64` |
-| Linux ARMv7 | `vocat-linux-armv7` |
-
-校驗並安裝:
-
-```bash
-sha256sum -c SHA256SUMS --ignore-missing
-sudo install -d -m 0755 /opt/vocat/bin /opt/vocat/data
-sudo install -m 0755 vocat-linux-amd64 /opt/vocat/bin/vocat
-read -rsp "管理員密碼: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | sudo /opt/vocat/bin/vocat bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-sudo env \
-  VOCAT_DATABASE_PATH=/opt/vocat/data/vocat.db \
-  /opt/vocat/bin/vocat serve
-```
-
-該手動指令會在前台執行 Vocat。請使用 `vocat serve` 以直接啟動伺服器；在 TTY 下以 root 執行無參數的 `vocat` 會進入互動式管理選單。如需託管的 systemd 服務與自動重新啟動,請使用一鍵安裝腳本。
-
-### Docker
-
-如果 Linux 主機需要探索每一個接入的受支援 Quectel 模組,並持續感知 USB 熱插拔事件,請以硬體存取模式執行 Vocat:
-
-```bash
-docker pull ghcr.io/mengmengcode/vocat:latest
-
-read -rsp "管理員密碼: " VOCAT_BOOTSTRAP_PASSWORD; echo
-printf '%s\n' "$VOCAT_BOOTSTRAP_PASSWORD" | docker run --rm -i \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  --entrypoint /opt/vocat/bin/vocat \
-  ghcr.io/mengmengcode/vocat:latest bootstrap-admin
-unset VOCAT_BOOTSTRAP_PASSWORD
-
-docker run -d \
-  --name vocat \
-  --restart unless-stopped \
-  --network host \
-  --privileged \
-  --user 0:0 \
-  -v vocat-data:/opt/vocat/data \
-  -v /dev:/dev \
-  -v /sys:/sys:ro \
-  ghcr.io/mengmengcode/vocat:latest
-```
-
-容器啟動後開啟 `http://<伺服器位址>:7575`。主機網路是必需的,這樣 QMI 網路介面才能對 Vocat 可見;而特權裝置存取是序列埠、QMI 控制節點、TUN 介面、網路配置以及容器啟動後新增裝置所必需的。`/dev` 掛載使新的 `ttyUSB*`、`ttyACM*` 和 `cdc-wdm*` 節點無需重建容器即可見。
-
-該模式有意賦予 Vocat 對主機裝置與網路堆疊的廣泛存取權限,僅在受信任的 Linux 主機上使用。自動探索目前僅識別受支援的 Quectel USB 模組(USB 廠商 ID `2c7c`),不識別任意品牌的模組。僅用 `--device` 映射單一節點(例如 `/dev/ttyUSB2` 與 `/dev/cdc-wdm0`)會將容器限定在這些固定節點上,無法提供完整的多裝置或熱插拔探索。
-
-GHCR 映像發佈為 `linux/amd64` 與 `linux/arm64`。
-
-## 配置
-
-Vocat 先從 `VOCAT_CONFIG` 讀取可選的 JSON 配置檔,再套用 `VOCAT_*` 環境變數。環境變數優先級更高。
-
-| 環境變數 | 預設值 | 說明 |
-| --- | --- | --- |
-| `VOCAT_ADDR` | `0.0.0.0:7575` | HTTP 監聽位址。 |
-| `VOCAT_DATABASE_PATH` | `./data/vocat.db` | SQLite 資料庫路徑。 |
-| `VOCAT_SESSION_TTL` | `24h` | 驗證工作階段有效期。 |
-| `VOCAT_SECURE_COOKIES` | `false` | 在使用 HTTPS 時將工作階段 Cookie 標記為安全。 |
-| `VOCAT_SHUTDOWN_TIMEOUT` | `10s` | 優雅關閉逾時時間。 |
-| `VOCAT_MAX_REQUEST_BODY_BYTES` | `1048576` | API 請求主體最大位元組數。 |
-| `VOCAT_REPO` | `MengMengCode/VoCat` | 自我更新器使用的受信任 GitHub 倉庫,格式為 `owner/name`。 |
-| `GITHUB_TOKEN` | 空 | 可選的 GitHub token,用於私有倉庫或更高的 API 限額。 |
-
-請勿將 Telegram token、SMTP 密碼、Webhook 金鑰、SIM 憑證或其他私密資料存放在倉庫中。請透過應用設定或受保護的環境檔來配置它們。
-
-## Telegram 機器人
-
-啟用 Telegram 通知並配置好 Chat ID 與 Admin ID 後,機器人支援:
-
-```text
-/status [裝置]
-/esim <裝置>
-/switch <裝置> <iccid>
-/wfc <裝置> <status|on|off|reconnect>
-/sms <裝置> <號碼> <內容>
-```
-
-設定檔切換與簡訊提交使用一次性確認按鈕。機器人不暴露 eSIM 下載、刪除或重新命名命令。
-
-## 更新
-
-檢查是否有更新的 GitHub Release:
-
-```bash
-vocat update --check --repo MengMengCode/VoCat
-```
-
-安裝最新發佈版:
-
-```bash
-sudo vocat update --repo MengMengCode/VoCat
-```
-
-更新器會下載與目前 Linux 架構匹配的二進位檔,使用已發佈的 `SHA256SUMS` 進行校驗,原子性地替換可執行檔,並在可用時重新啟動 `vocat` systemd 服務。
-
-Docker 安裝的更新方式:
-
-```bash
-docker pull ghcr.io/mengmengcode/vocat:latest
-```
-
-拉取新映像後重建容器。
-
-## 開發
-
-依賴要求:
-
-- Go 1.25 或更新版本
-- Node.js 20 或更新版本
-- npm
-
-執行前端開發伺服器:
-
-```bash
-cd web
-npm install
-npm run dev
-```
-
-建構嵌入的前端並啟動後端:
-
-```bash
-cd web
-npm run build
-cd ..
-go run ./cmd/vocat
-```
-
-執行全部測試:
-
-```bash
-go test ./...
-```
-
-建構生產二進位檔:
-
-```bash
-go build -trimpath -ldflags "-s -w" -o vocat ./cmd/vocat
-```
-
-## 發佈自動化
-
-推送版本標籤會觸發兩個 GitHub Actions 工作流程:
-
-- `release-binaries` 建構並發佈 `amd64`、`386`、`arm64`、`aarch64` 與 `armv7` 二進位檔及 `SHA256SUMS`。
-- `docker` 建構並向 GitHub Container Registry 發佈多架構映像。
-
-```bash
-git tag v0.2.0
-git push origin v0.2.0
-```
-
-## 專案結構
-
-```text
-cmd/vocat/                  應用入口與 CLI
-internal/device/            模組探索與裝置控制
-internal/modem/             AT 工作階段與回應處理
-internal/server/            HTTP API、通知與內嵌 Web 伺服器
-internal/store/             SQLite 持久化
-internal/update/            GitHub Release 自我更新器
-internal/vowifi/            IKE、EAP-AKA、IMS 與 WiFi Calling 執行時
-scripts/install.sh          Linux 安裝與更新腳本
-web/src/                    React 與 TypeScript 前端
-.github/workflows/          二進位檔與 Docker 發佈自動化
-```
-
-## 合規使用
-
-行動通訊模組與 eSIM 操作可能影響用戶服務、已儲存的設定檔、網路註冊以及硬體狀態。請做好備份,謹慎審視破壞性操作,並僅在您被允許操作所連接的硬體與網路資源的合法環境中使用本軟體。
-
-Vocat 不會繞過電信業者驗證、網路策略、硬體安全或 eSIM 信任要求。支援某項操作意味著 Vocat 能夠向模組或 eUICC 發起該請求;但裝置、設定檔、網路或電信業者仍可能拒絕。
-
-## 貢獻
-
-歡迎提交 Issue 與 Pull Request。請保持改動聚焦,在可行處附帶測試,避免提交憑證或用戶資料,並清晰地說明硬體相關行為。
-
-提交改動前:
-
-```bash
-go test ./...
-cd web && npm run build
-```
-
-## 致謝
-- [Nodeseek.com](https://www.nodeseek.com) — 專注伺服器的社群
-- [Linux.do](https://linux.do) — 富有啟發的技術社群
-- [iniwex5](https://github.com/iniwex5) — 風格與功能指南
-
-## 請我喝杯咖啡
-
-| 網路 | 位址 |
-| ------- | ------- |
-| USDT-TRON (TRC20) | `TQQAbboBoU8h5xX4YCA1rqWJU2WjK3seSg` |
-| USDT-BSC (BEP20) | `0xdbfcd4a462550d6ff06d09cbd89026c6b145d9c4` |
-| USDT-Polygon | `0xdbfcd4a462550d6ff06d09cbd89026c6b145d9c4` |
-
-## 授權條款
-
-參見 [LICENSE](../LICENSE)。
-
-[![MengMengCode/VoCat Star History](https://mengmeng.meteor-history.com/api/embed/MengMengCode/VoCat.svg?sig=sdeXRVxAoY3yLWgXL7JViY2USYIN3t9neJ6ScPvgUAo&theme=light&style=xkcd&color=dd4528&background=ffffff&textColor=000000&width=900&height=600&lineWidth=3&showTitle=true&showLegend=true&showDots=false&v=0.0.14)](https://meteor-history.com)

go.mod

@@ -4,11 +4,10 @@ go 1.25.0
 
 require (
 	github.com/coder/websocket v1.8.15
-	github.com/iniwex5/quectel-qmi-go v0.6.0
 	go.bug.st/serial v1.6.4
-	golang.org/x/crypto v0.52.0
+	golang.org/x/crypto v0.41.0
 	golang.org/x/sys v0.47.0
-	golang.org/x/term v0.43.0
+	golang.org/x/term v0.34.0
 	modernc.org/sqlite v1.38.2
 )
 
@@ -19,8 +18,6 @@ require (
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/ncruces/go-strftime v0.1.9 // indirect
 	github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect
-	github.com/stretchr/testify v1.10.0 // indirect
-	github.com/warthog618/sms v0.3.0 // indirect
 	golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b // indirect
 	modernc.org/libc v1.66.3 // indirect
 	modernc.org/mathutil v1.7.1 // indirect

go.sum

@@ -2,7 +2,6 @@ github.com/coder/websocket v1.8.15 h1:6B2JPeOGlpff2Uz6vOEH1Vzpi0iUz20A+lPVhPHtNU
 github.com/coder/websocket v1.8.15/go.mod h1:NX3SzP+inril6yawo5CQXx8+fk145lPDC6pumgx0mVg=
 github.com/creack/goselect v0.1.2 h1:2DNy14+JPjRBgPzAd1thbQp4BSIihxcBf0IXhQXDRa0=
 github.com/creack/goselect v0.1.2/go.mod h1:a/NhLweNvqIYMuxcMOuWY516Cimucms3DglDzQP3hKY=
-github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY=
@@ -11,29 +10,20 @@ github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e h1:ijClszYn+mADRFY17k
 github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e/go.mod h1:boTsfXsheKC2y+lKOCMpSfarhxDeIzfZG1jqGcPl3cA=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
 github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
-github.com/iniwex5/quectel-qmi-go v0.6.0 h1:zWZc9jeNMy7+USFRBbfdShnjzSryyYnCw7NPw4ubaIg=
-github.com/iniwex5/quectel-qmi-go v0.6.0/go.mod h1:6AlSY+Yj4MqJOsZ8cNrq99AzT9MlaopADnJtSRiyAfE=
-github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
-github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
 github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
 github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
 github.com/ncruces/go-strftime v0.1.9 h1:bY0MQC28UADQmHmaF5dgpLmImcShSi2kHU9XLdhx/f4=
 github.com/ncruces/go-strftime v0.1.9/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls=
-github.com/niemeyer/pretty v0.0.0-20200227124842-a10e7caefd8e/go.mod h1:zD1mROLANZcx1PVRCS0qkT7pwLkGfwJo4zjcN/Tysno=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE=
 github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo=
-github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
-github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4=
-github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
-github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-github.com/warthog618/sms v0.3.0 h1:LYAb5ngmu2qjNExgji3B7xi2tIZ9+DsuE9pC5xs4wwc=
-github.com/warthog618/sms v0.3.0/go.mod h1:+bYZGeBxu003sxD5xhzsrIPBAjPBzTABsRTwSpd7ld4=
+github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk=
+github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
 go.bug.st/serial v1.6.4 h1:7FmqNPgVp3pu2Jz5PoPtbZ9jJO5gnEnZIvnI1lzve8A=
 go.bug.st/serial v1.6.4/go.mod h1:nofMJxTeNVny/m6+KaafC6vJGj3miwQZ6vW4BZUGJPI=
-golang.org/x/crypto v0.52.0 h1:RMs7fP2rXdep0CftQlK8Uf+kibLm7qkCcradZWYz988=
-golang.org/x/crypto v0.52.0/go.mod h1:1QgfPxDqh0T2M/elOJtp9RvuR95kVjir0e6/BvEmGbc=
+golang.org/x/crypto v0.41.0 h1:WKYxWedPGCTVVl5+WHSSrOBT0O8lx32+zxmHxijgXp4=
+golang.org/x/crypto v0.41.0/go.mod h1:pO5AFd7FA68rFak7rOAGVuygIISepHftHnr8dr6+sUc=
 golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b h1:M2rDM6z3Fhozi9O7NWsxAkg/yqS/lQJ6PmkyIV3YP+o=
 golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b/go.mod h1:3//PLf8L/X+8b4vuAfHzxeRUl04Adcb341+IGKfnqS8=
 golang.org/x/mod v0.25.0 h1:n7a+ZbQKQA/Ysbyb0/6IbB1H/X41mKgbhfv7AfG/44w=
@@ -43,14 +33,10 @@ golang.org/x/sync v0.15.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
 golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.47.0 h1:o7XGOvZQCADBQQ4Y7VNq2dRWQR7JmOUW8Kxx4ZsNgWs=
 golang.org/x/sys v0.47.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
-golang.org/x/term v0.43.0 h1:S4RLU2sB31O/NCl+zFN9Aru9A/Cq2aqKpTZJ6B+DwT4=
-golang.org/x/term v0.43.0/go.mod h1:lrhlHNdQJHO+1qVYiHfFKVuVioJIheAc3fBSMFYEIsk=
+golang.org/x/term v0.34.0 h1:O/2T7POpk0ZZ7MAzMeWFSg6S5IpWd/RXDlM9hgM3DR4=
+golang.org/x/term v0.34.0/go.mod h1:5jC53AEywhIVebHgPVeg0mj8OD3VO9OzclacVrqpaAw=
 golang.org/x/tools v0.34.0 h1:qIpSLOxeCYGg9TrcJokLBG4KFA6d795g0xkBkiESGlo=
 golang.org/x/tools v0.34.0/go.mod h1:pAP9OwEaY1CAW3HOmg3hLZC5Z0CCmzjAF2UQMSqNARg=
-gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/check.v1 v1.0.0-20200227125254-8fa46927fb4f/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
-gopkg.in/yaml.v2 v2.2.8/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 modernc.org/cc/v4 v4.26.2 h1:991HMkLjJzYBIfha6ECZdjrIYz2/1ayr+FL8GN+CNzM=

internal/auth/service.go

@@ -1,7 +1,6 @@
 package auth
 
 import (
-	"bytes"
 	"context"
 	"crypto/rand"
 	"crypto/sha256"
@@ -21,13 +20,8 @@ var (
 	ErrInvalidCredentials = errors.New("invalid credentials")
 	ErrUnauthorized       = errors.New("unauthorized")
 	ErrInvalidCSRF        = errors.New("invalid csrf token")
-	ErrEmptyPassword      = errors.New("password cannot be empty")
 )
 
-const bcryptPasswordLimit = 72
-
-var longPasswordHashPrefix = []byte("$vocat-sha256$")
-
 type Options struct {
 	SessionTTL time.Duration
 	BcryptCost int
@@ -91,14 +85,14 @@ func (s *Service) EnsureAdmin(ctx context.Context, username string, password str
 	current, err := s.store.CurrentAdmin(ctx)
 	if err == nil &&
 		current.Username == username &&
-		comparePassword(current.PasswordHash, password) == nil {
+		bcrypt.CompareHashAndPassword(current.PasswordHash, []byte(password)) == nil {
 		return nil
 	}
 	if err != nil && !errors.Is(err, store.ErrNotFound) {
 		return fmt.Errorf("auth: read configured admin: %w", err)
 	}
 
-	passwordHash, err := hashPassword(password, s.bcryptCost)
+	passwordHash, err := bcrypt.GenerateFromPassword([]byte(password), s.bcryptCost)
 	if err != nil {
 		return fmt.Errorf("auth: hash admin password: %w", err)
 	}
@@ -108,50 +102,16 @@ func (s *Service) EnsureAdmin(ctx context.Context, username string, password str
 	return nil
 }
 
-// EnsureAdminIfMissing initializes the administrator only for a new database.
-// Once an administrator exists, the database is the sole credential source;
-// process configuration must never overwrite a password changed through the UI
-// or CLI on a later restart.
-func (s *Service) EnsureAdminIfMissing(ctx context.Context, username string, password string) (bool, error) {
-	if _, err := s.store.CurrentAdmin(ctx); err == nil {
-		return false, nil
-	} else if !errors.Is(err, store.ErrNotFound) {
-		return false, fmt.Errorf("auth: read configured admin: %w", err)
-	}
-	if err := s.EnsureAdmin(ctx, username, password); err != nil {
-		return false, err
-	}
-	return true, nil
-}
-
-// ResetAdminCredentials replaces the single administrator without requiring
-// the previous credentials. It is intended for trusted local recovery flows
-// such as the root-only management CLI. Store.SetAdmin atomically revokes all
-// existing sessions when the credentials change.
-func (s *Service) ResetAdminCredentials(ctx context.Context, username string, password string) error {
-	username = strings.TrimSpace(username)
-	if len(username) < 1 || len(username) > 64 || strings.ContainsAny(username, "\r\n\t") {
-		return errors.New("administrator username must contain between 1 and 64 characters without control whitespace")
-	}
-	if password == "" {
-		return ErrEmptyPassword
-	}
-	if err := s.EnsureAdmin(ctx, username, password); err != nil {
-		return fmt.Errorf("auth: reset administrator credentials: %w", err)
-	}
-	return nil
-}
-
 func (s *Service) Login(ctx context.Context, username string, password string) (Credentials, error) {
 	admin, err := s.store.AdminByUsername(ctx, strings.TrimSpace(username))
 	if errors.Is(err, store.ErrNotFound) {
-		_ = comparePassword(s.dummyHash, password)
+		_ = bcrypt.CompareHashAndPassword(s.dummyHash, []byte(password))
 		return Credentials{}, ErrInvalidCredentials
 	}
 	if err != nil {
 		return Credentials{}, fmt.Errorf("auth: find admin: %w", err)
 	}
-	if comparePassword(admin.PasswordHash, password) != nil {
+	if bcrypt.CompareHashAndPassword(admin.PasswordHash, []byte(password)) != nil {
 		return Credentials{}, ErrInvalidCredentials
 	}
 
@@ -290,24 +250,24 @@ func (s *Service) ChangePassword(
 	currentPassword string,
 	newPassword string,
 ) error {
-	if newPassword == "" {
-		return ErrEmptyPassword
+	if len(newPassword) < 12 || len(newPassword) > 1024 {
+		return errors.New("new password must contain between 12 and 1024 characters")
 	}
 	admin, err := s.store.AdminByUsername(ctx, strings.TrimSpace(username))
 	if errors.Is(err, store.ErrNotFound) {
-		_ = comparePassword(s.dummyHash, currentPassword)
+		_ = bcrypt.CompareHashAndPassword(s.dummyHash, []byte(currentPassword))
 		return ErrInvalidCredentials
 	}
 	if err != nil {
 		return fmt.Errorf("auth: find admin: %w", err)
 	}
-	if comparePassword(admin.PasswordHash, currentPassword) != nil {
+	if bcrypt.CompareHashAndPassword(admin.PasswordHash, []byte(currentPassword)) != nil {
 		return ErrInvalidCredentials
 	}
-	if comparePassword(admin.PasswordHash, newPassword) == nil {
+	if bcrypt.CompareHashAndPassword(admin.PasswordHash, []byte(newPassword)) == nil {
 		return errors.New("new password must differ from the current password")
 	}
-	passwordHash, err := hashPassword(newPassword, s.bcryptCost)
+	passwordHash, err := bcrypt.GenerateFromPassword([]byte(newPassword), s.bcryptCost)
 	if err != nil {
 		return fmt.Errorf("auth: hash new password: %w", err)
 	}
@@ -317,36 +277,6 @@ func (s *Service) ChangePassword(
 	return nil
 }
 
-// hashPassword keeps ordinary bcrypt hashes compatible with existing
-// installations. bcrypt rejects inputs longer than 72 bytes, so only longer
-// passwords use a tagged SHA-256 pre-hash before bcrypt.
-func hashPassword(password string, cost int) ([]byte, error) {
-	material := []byte(password)
-	longPassword := len(material) > bcryptPasswordLimit
-	if longPassword {
-		digest := sha256.Sum256(material)
-		material = digest[:]
-	}
-	passwordHash, err := bcrypt.GenerateFromPassword(material, cost)
-	if err != nil {
-		return nil, err
-	}
-	if !longPassword {
-		return passwordHash, nil
-	}
-	return append(append([]byte(nil), longPasswordHashPrefix...), passwordHash...), nil
-}
-
-func comparePassword(passwordHash []byte, password string) error {
-	material := []byte(password)
-	if bytes.HasPrefix(passwordHash, longPasswordHashPrefix) {
-		digest := sha256.Sum256(material)
-		material = digest[:]
-		passwordHash = passwordHash[len(longPasswordHashPrefix):]
-	}
-	return bcrypt.CompareHashAndPassword(passwordHash, material)
-}
-
 func randomToken() (string, error) {
 	buffer := make([]byte, 32)
 	if _, err := rand.Read(buffer); err != nil {

internal/auth/service_test.go

@@ -3,7 +3,6 @@ package auth
 import (
 	"context"
 	"errors"
-	"strings"
 	"testing"
 	"time"
 
@@ -97,91 +96,3 @@ func TestEnsureAdminRevokesSessionOnPasswordChange(t *testing.T) {
 		t.Fatalf("login with new password: %v", err)
 	}
 }
-
-func TestResetAdminCredentialsChangesUsernameAndPasswordWithoutOldPassword(t *testing.T) {
-	ctx := context.Background()
-	service := newTestService(t)
-	credentials, err := service.Login(ctx, "admin", "correct-password")
-	if err != nil {
-		t.Fatal(err)
-	}
-
-	if err := service.ResetAdminCredentials(ctx, "new-admin", "replacement-password"); err != nil {
-		t.Fatalf("ResetAdminCredentials() error = %v", err)
-	}
-	if _, err := service.Login(ctx, "admin", "correct-password"); !errors.Is(err, ErrInvalidCredentials) {
-		t.Fatalf("old credentials error = %v, want ErrInvalidCredentials", err)
-	}
-	if _, err := service.Login(ctx, "new-admin", "replacement-password"); err != nil {
-		t.Fatalf("new credentials login error = %v", err)
-	}
-	if _, err := service.Authenticate(ctx, credentials.SessionToken); !errors.Is(err, ErrUnauthorized) {
-		t.Fatalf("old session error = %v, want ErrUnauthorized", err)
-	}
-}
-
-func TestResetAdminCredentialsValidatesInput(t *testing.T) {
-	service := newTestService(t)
-	for _, test := range []struct {
-		name     string
-		username string
-		password string
-	}{
-		{name: "empty username", password: "replacement-password"},
-		{name: "control whitespace", username: "bad\tname", password: "replacement-password"},
-		{name: "empty password", username: "admin", password: ""},
-	} {
-		t.Run(test.name, func(t *testing.T) {
-			if err := service.ResetAdminCredentials(context.Background(), test.username, test.password); err == nil {
-				t.Fatal("ResetAdminCredentials() accepted invalid input")
-			}
-		})
-	}
-}
-
-func TestResetAdminCredentialsAcceptsPasswordsWithoutComplexityRules(t *testing.T) {
-	ctx := context.Background()
-	for _, password := range []string{"1", strings.Repeat("x", 256)} {
-		service := newTestService(t)
-		if err := service.ResetAdminCredentials(ctx, "admin", password); err != nil {
-			t.Fatalf("ResetAdminCredentials(%d-byte password) error = %v", len(password), err)
-		}
-		if _, err := service.Login(ctx, "admin", password); err != nil {
-			t.Fatalf("Login(%d-byte password) error = %v", len(password), err)
-		}
-	}
-}
-
-func TestChangePasswordAcceptsPasswordsWithoutComplexityRules(t *testing.T) {
-	ctx := context.Background()
-	for _, password := range []string{"1", strings.Repeat("long-password-", 32)} {
-		service := newTestService(t)
-		if err := service.ChangePassword(ctx, "admin", "correct-password", password); err != nil {
-			t.Fatalf("ChangePassword(%d-byte password) error = %v", len(password), err)
-		}
-		if _, err := service.Login(ctx, "admin", password); err != nil {
-			t.Fatalf("Login(%d-byte password) error = %v", len(password), err)
-		}
-	}
-}
-
-func TestEnsureAdminIfMissingDoesNotOverwriteChangedPassword(t *testing.T) {
-	ctx := context.Background()
-	service := newTestService(t)
-	if err := service.ChangePassword(ctx, "admin", "correct-password", "changed-password"); err != nil {
-		t.Fatal(err)
-	}
-	created, err := service.EnsureAdminIfMissing(ctx, "admin", "stale-config-password")
-	if err != nil {
-		t.Fatal(err)
-	}
-	if created {
-		t.Fatal("existing administrator was reported as newly created")
-	}
-	if _, err := service.Login(ctx, "admin", "changed-password"); err != nil {
-		t.Fatalf("database password was overwritten: %v", err)
-	}
-	if _, err := service.Login(ctx, "admin", "stale-config-password"); !errors.Is(err, ErrInvalidCredentials) {
-		t.Fatalf("stale configured password became active: %v", err)
-	}
-}

internal/config/config.go

@@ -19,6 +19,8 @@ const maxConfigBytes = 1 << 20
 type Config struct {
 	Address             string
 	DatabasePath        string
+	AdminUsername       string
+	AdminPassword       string
 	SessionTTL          time.Duration
 	SecureCookies       bool
 	ShutdownTimeout     time.Duration
@@ -26,25 +28,25 @@ type Config struct {
 }
 
 type fileConfig struct {
-	Address      *string `json:"address"`
-	DatabasePath *string `json:"database_path"`
-	// Retain the legacy keys only so upgrades do not reject an existing config
-	// file. They are deliberately ignored: administrator credentials are read
-	// exclusively from SQLite.
-	LegacyAdminUsername *string `json:"admin_username"`
-	LegacyAdminPassword *string `json:"admin_password"`
+	Address             *string `json:"address"`
+	DatabasePath        *string `json:"database_path"`
+	AdminUsername       *string `json:"admin_username"`
+	AdminPassword       *string `json:"admin_password"`
 	SessionTTL          *string `json:"session_ttl"`
 	SecureCookies       *bool   `json:"secure_cookies"`
 	ShutdownTimeout     *string `json:"shutdown_timeout"`
 	MaxRequestBodyBytes *int64  `json:"max_request_body_bytes"`
 }
 
-// Default returns the non-secret process configuration. Administrator
-// credentials are initialized separately and stored only in SQLite.
+// Default returns a configuration suitable for a first local deployment.
+// Operators should replace the bootstrap password through
+// VOCAT_ADMIN_PASSWORD before exposing the service.
 func Default() Config {
 	return Config{
 		Address:             "0.0.0.0:7575",
 		DatabasePath:        "./data/vocat.db",
+		AdminUsername:       "admin",
+		AdminPassword:       "admin",
 		SessionTTL:          24 * time.Hour,
 		SecureCookies:       false,
 		ShutdownTimeout:     10 * time.Second,
@@ -114,6 +116,12 @@ func applyFile(cfg *Config, values fileConfig) error {
 	if values.DatabasePath != nil {
 		cfg.DatabasePath = *values.DatabasePath
 	}
+	if values.AdminUsername != nil {
+		cfg.AdminUsername = *values.AdminUsername
+	}
+	if values.AdminPassword != nil {
+		cfg.AdminPassword = *values.AdminPassword
+	}
 	if values.SessionTTL != nil {
 		duration, err := time.ParseDuration(*values.SessionTTL)
 		if err != nil {
@@ -146,6 +154,8 @@ func applyEnvironment(cfg *Config) error {
 
 	applyString("VOCAT_ADDR", &cfg.Address)
 	applyString("VOCAT_DATABASE_PATH", &cfg.DatabasePath)
+	applyString("VOCAT_ADMIN_USERNAME", &cfg.AdminUsername)
+	applyString("VOCAT_ADMIN_PASSWORD", &cfg.AdminPassword)
 
 	if value, ok := os.LookupEnv("VOCAT_SESSION_TTL"); ok {
 		duration, err := time.ParseDuration(value)
@@ -193,6 +203,16 @@ func (cfg Config) Validate() error {
 	if strings.TrimSpace(cfg.DatabasePath) == "" {
 		return errors.New("database_path must not be empty")
 	}
+	username := strings.TrimSpace(cfg.AdminUsername)
+	if username == "" || len(username) > 64 {
+		return errors.New("admin_username must contain between 1 and 64 characters")
+	}
+	if strings.ContainsAny(username, "\r\n\t") {
+		return errors.New("admin_username must not contain control whitespace")
+	}
+	if cfg.AdminPassword == "" {
+		return errors.New("admin_password must not be empty")
+	}
 	if cfg.SessionTTL < 5*time.Minute || cfg.SessionTTL > 30*24*time.Hour {
 		return errors.New("session_ttl must be between 5m and 720h")
 	}
@@ -204,3 +224,9 @@ func (cfg Config) Validate() error {
 	}
 	return nil
 }
+
+// UsesDefaultCredentials reports whether the documented bootstrap credentials
+// are still active.
+func (cfg Config) UsesDefaultCredentials() bool {
+	return cfg.AdminUsername == "admin" && cfg.AdminPassword == "admin"
+}

internal/config/config_test.go

@@ -13,7 +13,6 @@ var configEnvironment = []string{
 	"VOCAT_DATABASE_PATH",
 	"VOCAT_ADMIN_USERNAME",
 	"VOCAT_ADMIN_PASSWORD",
-	"VOCAT_ADMIN_PASSWORD_B64",
 	"VOCAT_SESSION_TTL",
 	"VOCAT_SECURE_COOKIES",
 	"VOCAT_SHUTDOWN_TIMEOUT",
@@ -40,6 +39,9 @@ func TestLoadDefaults(t *testing.T) {
 	if cfg.Address != "0.0.0.0:7575" {
 		t.Fatalf("Address = %q", cfg.Address)
 	}
+	if !cfg.UsesDefaultCredentials() {
+		t.Fatal("expected bootstrap credentials")
+	}
 }
 
 func TestLoadFileThenEnvironmentOverride(t *testing.T) {
@@ -48,6 +50,8 @@ func TestLoadFileThenEnvironmentOverride(t *testing.T) {
 	content := []byte(`{
 		"address": "127.0.0.1:8000",
 		"database_path": "/tmp/from-file.db",
+		"admin_username": "operator",
+		"admin_password": "from-file",
 		"session_ttl": "2h",
 		"secure_cookies": false,
 		"shutdown_timeout": "12s",
@@ -68,7 +72,7 @@ func TestLoadFileThenEnvironmentOverride(t *testing.T) {
 	if cfg.Address != "0.0.0.0:9000" || !cfg.SecureCookies {
 		t.Fatalf("environment override not applied: %+v", cfg)
 	}
-	if cfg.SessionTTL != 2*time.Hour {
+	if cfg.AdminUsername != "operator" || cfg.SessionTTL != 2*time.Hour {
 		t.Fatalf("file values not applied: %+v", cfg)
 	}
 }
@@ -86,24 +90,6 @@ func TestLoadRejectsUnknownJSONField(t *testing.T) {
 	}
 }
 
-func TestLoadIgnoresLegacyAdministratorConfiguration(t *testing.T) {
-	clearConfigEnvironment(t)
-	path := filepath.Join(t.TempDir(), "vocat.json")
-	if err := os.WriteFile(path, []byte(`{
-		"admin_username": "legacy-admin",
-		"admin_password": "legacy-password"
-	}`), 0o600); err != nil {
-		t.Fatal(err)
-	}
-	t.Setenv("VOCAT_CONFIG", path)
-	t.Setenv("VOCAT_ADMIN_USERNAME", "environment-admin")
-	t.Setenv("VOCAT_ADMIN_PASSWORD", "environment-password")
-
-	if _, err := Load(); err != nil {
-		t.Fatalf("Load() rejected ignored legacy credentials: %v", err)
-	}
-}
-
 func TestLoadRejectsInvalidEnvironment(t *testing.T) {
 	clearConfigEnvironment(t)
 	t.Setenv("VOCAT_SESSION_TTL", "tomorrow")

internal/developer/settings.go

@@ -27,9 +27,9 @@ const (
 	DeviceLimitSettingKey = "developer.device_limit"
 	SMSHourlyLimitKey     = "developer.sms_hourly_limit"
 	DefaultDeviceLimit    = 5
-	MaxDeviceLimit        = 10
+	MaxDeviceLimit        = 128
 	DefaultSMSHourlyLimit = 10
-	MaxSMSHourlyLimit     = 20
+	MaxSMSHourlyLimit     = 1000
 )
 
 func DeviceLimit(ctx context.Context, database *store.Store, enabled bool) int {
@@ -43,12 +43,9 @@ func DeviceLimit(ctx context.Context, database *store.Store, enabled bool) int {
 	var document struct {
 		Limit int `json:"limit"`
 	}
-	if json.Unmarshal(setting.Value, &document) != nil || document.Limit < 1 {
+	if json.Unmarshal(setting.Value, &document) != nil || document.Limit < 1 || document.Limit > MaxDeviceLimit {
 		return DefaultDeviceLimit
 	}
-	if document.Limit > MaxDeviceLimit {
-		return MaxDeviceLimit
-	}
 	return document.Limit
 }
 
@@ -73,12 +70,9 @@ func SMSHourlyLimit(ctx context.Context, database *store.Store) int {
 	var document struct {
 		Limit int `json:"limit"`
 	}
-	if json.Unmarshal(setting.Value, &document) != nil || document.Limit < 1 {
+	if json.Unmarshal(setting.Value, &document) != nil || document.Limit < 1 || document.Limit > MaxSMSHourlyLimit {
 		return DefaultSMSHourlyLimit
 	}
-	if document.Limit > MaxSMSHourlyLimit {
-		return MaxSMSHourlyLimit
-	}
 	return document.Limit
 }
 

internal/developer/settings_test.go

@@ -19,10 +19,10 @@ func TestResetExperimentalRestoresDefaults(t *testing.T) {
 		t.Fatal(err)
 	}
 	defer database.Close()
-	if err := SetDeviceLimit(ctx, database, 8); err != nil {
+	if err := SetDeviceLimit(ctx, database, 24); err != nil {
 		t.Fatal(err)
 	}
-	if err := SetSMSHourlyLimit(ctx, database, 18); err != nil {
+	if err := SetSMSHourlyLimit(ctx, database, 42); err != nil {
 		t.Fatal(err)
 	}
 	enabled, _ := json.Marshal(map[string]bool{"enabled": true})
@@ -92,34 +92,10 @@ func TestSetSMSHourlyLimitValidatesRange(t *testing.T) {
 	if SetSMSHourlyLimit(ctx, database, 0) == nil || SetSMSHourlyLimit(ctx, database, MaxSMSHourlyLimit+1) == nil {
 		t.Fatal("out-of-range SMS hourly limit was accepted")
 	}
-	if err := SetSMSHourlyLimit(ctx, database, 15); err != nil {
+	if err := SetSMSHourlyLimit(ctx, database, 25); err != nil {
 		t.Fatal(err)
 	}
-	if got := SMSHourlyLimit(ctx, database); got != 15 {
-		t.Fatalf("SMS hourly limit = %d, want 15", got)
-	}
-}
-
-func TestStoredLimitsAboveHardMaximumAreClamped(t *testing.T) {
-	ctx := context.Background()
-	database, err := store.Open(ctx, filepath.Join(t.TempDir(), "vocat.db"))
-	if err != nil {
-		t.Fatal(err)
-	}
-	defer database.Close()
-	for key, limit := range map[string]int{
-		DeviceLimitSettingKey: 99,
-		SMSHourlyLimitKey:     99,
-	} {
-		value, _ := json.Marshal(map[string]int{"limit": limit})
-		if err := database.UpsertAppSetting(ctx, store.AppSetting{Key: key, Value: value}); err != nil {
-			t.Fatal(err)
-		}
-	}
-	if got := DeviceLimit(ctx, database, true); got != MaxDeviceLimit {
-		t.Fatalf("device limit = %d, want %d", got, MaxDeviceLimit)
-	}
-	if got := SMSHourlyLimit(ctx, database); got != MaxSMSHourlyLimit {
-		t.Fatalf("SMS hourly limit = %d, want %d", got, MaxSMSHourlyLimit)
+	if got := SMSHourlyLimit(ctx, database); got != 25 {
+		t.Fatalf("SMS hourly limit = %d, want 25", got)
 	}
 }

internal/device/carrier_db.go

@@ -14,41 +14,7 @@ import (
 var carrierDatabaseJSON []byte
 
 type carrierDatabase struct {
-	Carriers  map[string][]string `json:"c"`
-	Countries map[string]string   `json:"i"`
-	Rules     []carrierRule       `json:"r"`
-}
-
-type carrierRule struct {
-	Name          string   `json:"n"`
-	PLMNs         []string `json:"m"`
-	IMSIPatterns  []string `json:"x"`
-	SPNs          []string `json:"s"`
-	GID1Prefixes  []string `json:"g1"`
-	GID2Prefixes  []string `json:"g2"`
-	ICCIDPrefixes []string `json:"i"`
-}
-
-// CarrierIdentity contains the SIM-issued values used by Android's carrier
-// resolver. MNC length comes from EF_AD; GID values come from EF_GID1/2.
-type CarrierIdentity struct {
-	IMSI      string
-	ICCID     string
-	SPN       string
-	GID1      string
-	GID2      string
-	MNCLength int
-}
-
-// CountryForMCC returns the ISO alpha-2 country/territory code associated with
-// a three-digit mobile country code in the embedded Android carrier database.
-func CountryForMCC(mcc string) (string, bool) {
-	mcc = strings.TrimSpace(mcc)
-	if len(mcc) != 3 {
-		return "", false
-	}
-	country := strings.ToUpper(strings.TrimSpace(globalCarrierDatabase.Countries[mcc]))
-	return country, len(country) == 2
+	Carriers map[string][]string `json:"c"`
 }
 
 var globalCarrierDatabase = func() carrierDatabase {
@@ -98,121 +64,3 @@ func CarrierForIMSI(imsi string) (plmn, name, countryCode string, ok bool) {
 	}
 	return "", "", "", false
 }
-
-// CarrierForSIM applies the constrained Android carrier-ID rules before the
-// MCC/MNC fallback. This is important for MVNO and travel eSIM profiles where
-// several customer-facing carriers authenticate through the same home PLMN.
-func CarrierForSIM(identity CarrierIdentity) (plmn, name, countryCode string, ok bool) {
-	imsi := strings.TrimSpace(identity.IMSI)
-	if !decimalDigits(imsi, 5, 20) {
-		return "", "", "", false
-	}
-	plmns := carrierPLMNCandidates(imsi, identity.MNCLength)
-	bestScore := -1
-	for _, rule := range globalCarrierDatabase.Rules {
-		matchedPLMN := firstMatchingValue(rule.PLMNs, func(value string) bool {
-			return containsString(plmns, value)
-		})
-		if matchedPLMN == "" {
-			continue
-		}
-		score := 1 << 8
-		if len(rule.IMSIPatterns) > 0 {
-			if firstMatchingValue(rule.IMSIPatterns, func(pattern string) bool { return imsiPatternMatch(imsi, pattern) }) == "" {
-				continue
-			}
-			score += 1 << 7
-		}
-		if len(rule.ICCIDPrefixes) > 0 {
-			if firstMatchingValue(rule.ICCIDPrefixes, func(prefix string) bool { return strings.HasPrefix(identity.ICCID, prefix) }) == "" {
-				continue
-			}
-			score += 1 << 6
-		}
-		if len(rule.GID1Prefixes) > 0 {
-			if firstMatchingValue(rule.GID1Prefixes, func(prefix string) bool { return prefixFold(identity.GID1, prefix) }) == "" {
-				continue
-			}
-			score += 1 << 5
-		}
-		if len(rule.GID2Prefixes) > 0 {
-			if firstMatchingValue(rule.GID2Prefixes, func(prefix string) bool { return prefixFold(identity.GID2, prefix) }) == "" {
-				continue
-			}
-			score += 1 << 4
-		}
-		if len(rule.SPNs) > 0 {
-			if !containsFold(rule.SPNs, identity.SPN) {
-				continue
-			}
-			score += 1 << 1
-		}
-		if score > bestScore {
-			bestScore = score
-			plmn = matchedPLMN
-			name = strings.TrimSpace(rule.Name)
-		}
-	}
-	if bestScore >= 0 && name != "" {
-		countryCode, _ = CountryForMCC(plmn[:3])
-		return plmn, name, countryCode, true
-	}
-	return CarrierForIMSI(imsi)
-}
-
-func carrierPLMNCandidates(imsi string, mncLength int) []string {
-	if (mncLength == 2 || mncLength == 3) && len(imsi) >= 3+mncLength {
-		return []string{imsi[:3+mncLength]}
-	}
-	result := make([]string, 0, 2)
-	for _, length := range []int{6, 5} {
-		if len(imsi) >= length {
-			result = append(result, imsi[:length])
-		}
-	}
-	return result
-}
-
-func firstMatchingValue(values []string, match func(string) bool) string {
-	for _, value := range values {
-		if match(value) {
-			return value
-		}
-	}
-	return ""
-}
-
-func containsString(values []string, wanted string) bool {
-	for _, value := range values {
-		if value == wanted {
-			return true
-		}
-	}
-	return false
-}
-
-func containsFold(values []string, wanted string) bool {
-	for _, value := range values {
-		if strings.EqualFold(value, wanted) {
-			return true
-		}
-	}
-	return false
-}
-
-func prefixFold(value, prefix string) bool {
-	return strings.HasPrefix(strings.ToLower(strings.TrimSpace(value)), strings.ToLower(strings.TrimSpace(prefix)))
-}
-
-func imsiPatternMatch(imsi, pattern string) bool {
-	pattern = strings.TrimSpace(pattern)
-	if len(imsi) < len(pattern) {
-		return false
-	}
-	for index, value := range pattern {
-		if value != 'x' && value != 'X' && byte(value) != imsi[index] {
-			return false
-		}
-	}
-	return true
-}

internal/device/controls.go

@@ -274,13 +274,6 @@ func (manager *Manager) SetFlight(
 	if err := manager.validateActive(id, state); err != nil {
 		return FlightResult{}, err
 	}
-	if manager.candidateFor(state).HardwareKind == "pcsc" {
-		return FlightResult{PreviousMode: 4, CurrentMode: 4, FlightMode: true, RadioOff: true}, nil
-	}
-	if result, handled, err := manager.setNativeQMIFlight(ctx, id, state, enabled); handled {
-		manager.setResult(id, state, nil, err)
-		return result, err
-	}
 	client, err := manager.clientLocked(ctx, state, manager.candidateFor(state))
 	if err != nil {
 		manager.setResult(id, state, nil, err)

internal/device/controls_test.go

@@ -2,175 +2,9 @@ package device
 
 import (
 	"context"
-	"errors"
 	"testing"
-
-	"github.com/iniwex5/quectel-qmi-go/pkg/qmi"
-
-	"vocat/internal/modem"
 )
 
-type fakeQMIRadioSession struct {
-	mode       qmi.OperatingMode
-	getModes   []qmi.OperatingMode
-	setModes   []qmi.OperatingMode
-	getErr     error
-	setErr     error
-	closeCount int
-	iccid      string
-	iccidErr   error
-}
-
-func (session *fakeQMIRadioSession) GetOperatingMode(context.Context) (qmi.OperatingMode, error) {
-	if len(session.getModes) > 0 {
-		mode := session.getModes[0]
-		session.getModes = session.getModes[1:]
-		return mode, session.getErr
-	}
-	return session.mode, session.getErr
-}
-
-func (session *fakeQMIRadioSession) SetOperatingMode(_ context.Context, mode qmi.OperatingMode) error {
-	if session.setErr != nil {
-		return session.setErr
-	}
-	session.setModes = append(session.setModes, mode)
-	session.mode = mode
-	return nil
-}
-
-func (session *fakeQMIRadioSession) Close() error {
-	session.closeCount++
-	return nil
-}
-
-func (session *fakeQMIRadioSession) GetICCID(context.Context) (string, error) {
-	return session.iccid, session.iccidErr
-}
-
-func newStartedNativeQMITestManager(t *testing.T) (*Manager, *staticOpener, string) {
-	t.Helper()
-	const id = "wwan0"
-	opener := &staticOpener{client: &transcriptClient{}}
-	manager, err := NewManager(Options{
-		Discoverer: staticDiscoverer{candidates: []modem.Candidate{{
-			ID:               id,
-			Product:          "410 WiFi stick",
-			QMIControl:       "/dev/wwan0qmi0",
-			NetworkInterface: "wwan0",
-			ATPort: modem.Port{
-				Path: "/dev/wwan0at0",
-				Name: "wwan0at0",
-				Role: modem.PortRoleAT,
-			},
-		}}},
-		Opener: opener,
-	})
-	if err != nil {
-		t.Fatalf("NewManager: %v", err)
-	}
-	if err := manager.Start(context.Background()); err != nil {
-		t.Fatalf("Start: %v", err)
-	}
-	manager.mu.Lock()
-	manager.devices[id].snapshot = &Snapshot{
-		DeviceID:      id,
-		OperatingMode: 7,
-		ModeKnown:     true,
-		FlightMode:    true,
-		RadioOff:      true,
-	}
-	manager.mu.Unlock()
-	t.Cleanup(func() { _ = manager.Stop(context.Background()) })
-	return manager, opener, id
-}
-
-func TestSetFlightUsesQMIDMSForNativeWWAN(t *testing.T) {
-	manager, atOpener, id := newStartedNativeQMITestManager(t)
-	session := &fakeQMIRadioSession{mode: qmi.ModeOffline}
-	var openedPath string
-	manager.qmiRadioOpener = func(_ context.Context, path string) (qmiRadioSession, error) {
-		openedPath = path
-		return session, nil
-	}
-
-	disabled, err := manager.SetFlight(context.Background(), id, false)
-	if err != nil {
-		t.Fatalf("disable flight mode: %v", err)
-	}
-	if !disabled.Changed || disabled.PreviousMode != 7 || disabled.CurrentMode != 1 ||
-		disabled.FlightMode || disabled.RadioOff {
-		t.Fatalf("disable result = %#v", disabled)
-	}
-	enabled, err := manager.SetFlight(context.Background(), id, true)
-	if err != nil {
-		t.Fatalf("enable flight mode: %v", err)
-	}
-	if !enabled.Changed || enabled.PreviousMode != 1 || enabled.CurrentMode != 0 ||
-		!enabled.FlightMode || !enabled.RadioOff {
-		t.Fatalf("enable result = %#v", enabled)
-	}
-	if openedPath != "/dev/wwan0qmi0" {
-		t.Fatalf("QMI path = %q", openedPath)
-	}
-	if len(session.setModes) != 2 || session.setModes[0] != qmi.ModeOnline || session.setModes[1] != qmi.ModeLowPower {
-		t.Fatalf("QMI modes = %v", session.setModes)
-	}
-	if session.closeCount != 2 {
-		t.Fatalf("QMI close count = %d", session.closeCount)
-	}
-	if atOpener.openCount != 0 {
-		t.Fatalf("AT opener used %d times for native QMI flight mode", atOpener.openCount)
-	}
-	entry, err := manager.Get(id)
-	if err != nil {
-		t.Fatal(err)
-	}
-	if entry.Snapshot == nil || entry.Snapshot.OperatingMode != 0 || !entry.Snapshot.FlightMode {
-		t.Fatalf("snapshot = %#v", entry.Snapshot)
-	}
-}
-
-func TestSetFlightDoesNotFallBackToUnsupportedATWhenQMIUnavailable(t *testing.T) {
-	manager, atOpener, id := newStartedNativeQMITestManager(t)
-	wantErr := errors.New("QMI DMS unavailable")
-	manager.qmiRadioOpener = func(context.Context, string) (qmiRadioSession, error) {
-		return nil, wantErr
-	}
-
-	if _, err := manager.SetFlight(context.Background(), id, false); !errors.Is(err, wantErr) {
-		t.Fatalf("SetFlight error = %v, want %v", err, wantErr)
-	}
-	if atOpener.openCount != 0 {
-		t.Fatalf("AT opener used %d times after QMI failure", atOpener.openCount)
-	}
-}
-
-func TestSetFlightWaitsForAsynchronousQMIModeTransition(t *testing.T) {
-	manager, atOpener, id := newStartedNativeQMITestManager(t)
-	session := &fakeQMIRadioSession{
-		mode:     qmi.ModeShutdown,
-		getModes: []qmi.OperatingMode{qmi.ModeShutdown, qmi.ModeShutdown, qmi.ModeOnline},
-	}
-	manager.qmiRadioOpener = func(context.Context, string) (qmiRadioSession, error) {
-		return session, nil
-	}
-
-	result, err := manager.SetFlight(context.Background(), id, false)
-	if err != nil {
-		t.Fatalf("disable flight mode: %v", err)
-	}
-	if !result.Changed || result.PreviousMode != 7 || result.CurrentMode != 1 || result.FlightMode {
-		t.Fatalf("result = %#v", result)
-	}
-	if len(session.setModes) != 1 || session.setModes[0] != qmi.ModeOnline {
-		t.Fatalf("QMI modes = %v", session.setModes)
-	}
-	if atOpener.openCount != 0 {
-		t.Fatalf("AT opener used %d times during QMI transition", atOpener.openCount)
-	}
-}
-
 func TestSetFlightPreservesRawCFUNZero(t *testing.T) {
 	client := &transcriptClient{steps: []clientStep{
 		{command: "AT+CFUN?", response: okResponse("+CFUN: 0")},

internal/device/data.go

@@ -99,31 +99,6 @@ func (manager *Manager) SetNetwork(
 		if candidate.QMIControl == "" || candidate.NetworkInterface == "" {
 			return NetworkResult{}, fmt.Errorf("%w: QMI control device and network interface are required", ErrDataBackendUnavailable)
 		}
-		// OpenStick's native WWAN path must drive registration through QMI NAS.
-		// AT+COPS only updates the legacy AT facade on this firmware and can leave
-		// NAS in not-registered-searching, which then makes qmi-network report a
-		// generic-no-service call failure.
-		if request.Enabled && isNativeQMICandidate(candidate) {
-			registrationContext, cancel := context.WithTimeout(ctx, manager.scanTimeout)
-			registrationSession, openErr := manager.openNativeQMIRegistration(registrationContext, candidate)
-			if openErr != nil {
-				cancel()
-				manager.setResult(id, state, nil, openErr)
-				return NetworkResult{}, fmt.Errorf("prepare native QMI registration: %w", openErr)
-			}
-			registrationErr := ensureNativeQMIRegistration(
-				registrationContext,
-				registrationSession,
-				qmiRegistrationRequestAutomatic(),
-				true,
-			)
-			_ = registrationSession.Close()
-			cancel()
-			if registrationErr != nil {
-				manager.setResult(id, state, nil, registrationErr)
-				return NetworkResult{}, registrationErr
-			}
-		}
 		result, err := setQMINetwork(ctx, candidate, request.Enabled, apn, ipVersion, request.Username, request.Password, authentication)
 		if err != nil && (request.Username != "" || request.Password != "") {
 			// qmi-network output is outside our control and may echo values read
@@ -297,19 +272,6 @@ func usbNetModeName(mode int) string {
 }
 
 func (manager *Manager) OperatorSelection(ctx context.Context, id string) (OperatorSelection, error) {
-	state, err := manager.lookup(id)
-	if err != nil {
-		return OperatorSelection{}, err
-	}
-	candidate := manager.candidateFor(state)
-	if isNativeQMICandidate(candidate) {
-		state.opMu.Lock()
-		defer state.opMu.Unlock()
-		if err := manager.validateActive(id, state); err != nil {
-			return OperatorSelection{}, err
-		}
-		return manager.nativeQMIOperatorSelectionLocked(ctx, candidate)
-	}
 	response, err := manager.ExecuteAT(ctx, id, "AT+COPS?")
 	if err != nil {
 		return OperatorSelection{}, err
@@ -373,18 +335,6 @@ func (manager *Manager) SetOperatorSelection(
 	if err := manager.validateActive(id, state); err != nil {
 		return OperatorSelection{}, err
 	}
-	candidate := manager.candidateFor(state)
-	if isNativeQMICandidate(candidate) {
-		selection, err := manager.setNativeQMIOperatorSelectionLocked(
-			ctx,
-			candidate,
-			automatic,
-			plmn,
-			accessTechnologyValue,
-		)
-		manager.setResult(id, state, nil, err)
-		return selection, err
-	}
 	client, err := manager.clientLocked(ctx, state, manager.candidateFor(state))
 	if err != nil {
 		manager.setResult(id, state, nil, err)
@@ -485,12 +435,6 @@ func (manager *Manager) ReRegisterOperator(ctx context.Context, id string) (Oper
 	if err := manager.validateActive(id, state); err != nil {
 		return OperatorSelection{}, err
 	}
-	candidate := manager.candidateFor(state)
-	if isNativeQMICandidate(candidate) {
-		selection, err := manager.reRegisterNativeQMIOperatorLocked(ctx, candidate)
-		manager.setResult(id, state, nil, err)
-		return selection, err
-	}
 	client, err := manager.clientLocked(ctx, state, manager.candidateFor(state))
 	if err != nil {
 		manager.setResult(id, state, nil, err)

internal/device/esim.go

@@ -10,7 +10,6 @@ import (
 
 	"vocat/internal/i18n"
 	"vocat/internal/modem"
-	"vocat/internal/pcsc"
 )
 
 // eUICC / eSIM (LPA, SGP.22) access over the modem's AT+CSIM APDU passthrough.
@@ -191,11 +190,9 @@ func parseCSIM(response modem.Response) ([]byte, int, error) {
 
 // euiccChannel is an open logical channel to the eUICC's ISD-R.
 type euiccChannel struct {
-	manager      *Manager
-	id           string
-	channel      int
-	pcscSession  *pcsc.Session
-	resetOnClose bool
+	manager *Manager
+	id      string
+	channel int
 }
 
 // csimAPDUTimeout bounds a single AT+CSIM exchange. Loading a BoundProfilePackage
@@ -246,15 +243,6 @@ func (manager *Manager) openEuiccAID(ctx context.Context, id, aidHex string) (*e
 			return channel, nil
 		}
 		lastErr = err
-		if attempt == 0 && errors.Is(err, errNoLogicalChannel) &&
-			manager.releaseStaleEuiccChannel(ctx, id) {
-			// EC20 firmware exposes only one MANAGE CHANNEL slot. A canceled or
-			// interrupted APDU transaction can leave channel 1 allocated, after
-			// which every eSIM page load returns 6A81 until reboot. Closing the
-			// orphan while holding the shared UICC transaction lock makes the
-			// operation self-healing without disturbing an active AKA exchange.
-			continue
-		}
 		if !isTransientEuiccCME(err) {
 			return nil, err
 		}
@@ -271,24 +259,11 @@ func (manager *Manager) openEuiccAID(ctx context.Context, id, aidHex string) (*e
 	return nil, lastErr
 }
 
-func (manager *Manager) releaseStaleEuiccChannel(ctx context.Context, id string) bool {
-	_, sw, err := manager.csim(ctx, id, []byte{0x00, 0x70, 0x80, 0x01, 0x00})
-	return err == nil && sw == 0x9000
-}
-
 func (manager *Manager) openEuiccOnce(ctx context.Context, id string) (*euiccChannel, error) {
 	return manager.openEuiccOnceAID(ctx, id, isdRAID)
 }
 
 func (manager *Manager) openEuiccOnceAID(ctx context.Context, id, aidHex string) (*euiccChannel, error) {
-	state, lookupErr := manager.lookup(id)
-	if lookupErr != nil {
-		return nil, lookupErr
-	}
-	candidate := manager.candidateFor(state)
-	if candidate.HardwareKind == pcsc.HardwareKind {
-		return manager.openPCSCEuiccOnceAID(ctx, id, candidate, aidHex)
-	}
 	// MANAGE CHANNEL (open): 00 70 00 00 01 -> "<channel> 90 00". This EC20
 	// firmware requires the explicit one-byte expected length: Le=00 opens a
 	// channel but then rejects SELECT ISD-R at the AT+CSIM layer.
@@ -327,37 +302,6 @@ func (manager *Manager) openEuiccOnceAID(ctx context.Context, id, aidHex string)
 	return channel, nil
 }
 
-func (manager *Manager) openPCSCEuiccOnceAID(ctx context.Context, id string, candidate modem.Candidate, aidHex string) (*euiccChannel, error) {
-	session, err := manager.cardReaders.OpenSession(ctx, pcsc.Selector{
-		USBPath: candidate.USBPath, ReaderName: candidate.ReaderName,
-	})
-	if err != nil {
-		return nil, err
-	}
-	payload, sw, err := session.Transmit(ctx, []byte{0x00, 0x70, 0x00, 0x00, 0x01})
-	if err != nil || sw != 0x9000 || len(payload) != 1 {
-		session.Close()
-		if err != nil {
-			return nil, fmt.Errorf("esim: PC/SC MANAGE CHANNEL: %w", err)
-		}
-		return nil, errNoLogicalChannel
-	}
-	channel := &euiccChannel{manager: manager, id: id, channel: int(payload[0]), pcscSession: session}
-	aidHex = strings.ToUpper(strings.TrimSpace(aidHex))
-	aid, err := hex.DecodeString(aidHex)
-	if err != nil || len(aid) == 0 || len(aid) > 255 {
-		channel.close(context.Background())
-		return nil, fmt.Errorf("esim: invalid ISD-R AID %q", aidHex)
-	}
-	selectAID := append([]byte{byte(channel.channel), 0xA4, 0x04, 0x00, byte(len(aid))}, aid...)
-	_, selectSW, err := channel.transmit(ctx, selectAID, 0x00)
-	if err != nil || selectSW != 0x9000 {
-		channel.close(context.Background())
-		return nil, errNoEUICC
-	}
-	return channel, nil
-}
-
 // discoverEuiccAIDs detects eSTK multi-SE and alternate-ISD-R cards without
 // changing any profile state. The vendor product applet and candidate ISD-R
 // applications are selected only as read-only capability probes. Per
@@ -408,23 +352,7 @@ func isTransientEuiccCME(err error) bool {
 // close releases the logical channel (MANAGE CHANNEL close).
 func (channel *euiccChannel) close(ctx context.Context) {
 	closeAPDU := []byte{0x00, 0x70, 0x80, byte(channel.channel), 0x00}
-	_, _, _ = channel.exchange(ctx, closeAPDU)
-	if channel.pcscSession != nil {
-		if channel.resetOnClose {
-			_ = channel.pcscSession.CloseWithReset()
-		} else {
-			_ = channel.pcscSession.Close()
-		}
-		channel.pcscSession = nil
-	}
-}
-
-func (channel *euiccChannel) exchange(ctx context.Context, apdu []byte) ([]byte, int, error) {
-	if channel.pcscSession != nil {
-		payload, sw, err := channel.pcscSession.Transmit(ctx, apdu)
-		return payload, int(sw), err
-	}
-	return channel.manager.csim(ctx, channel.id, apdu)
+	_, _, _ = channel.manager.csim(ctx, channel.id, closeAPDU)
 }
 
 // transmit sends one APDU on the logical channel (CLA high nibble from insClass,
@@ -432,7 +360,7 @@ func (channel *euiccChannel) exchange(ctx context.Context, apdu []byte) ([]byte,
 // and returns the assembled payload.
 func (channel *euiccChannel) transmit(ctx context.Context, apdu []byte, insClass byte) ([]byte, int, error) {
 	apdu[0] = (apdu[0] & 0xF0) | byte(channel.channel)
-	payload, sw, err := channel.exchange(ctx, apdu)
+	payload, sw, err := channel.manager.csim(ctx, channel.id, apdu)
 	if err != nil {
 		return nil, 0, err
 	}
@@ -441,7 +369,7 @@ func (channel *euiccChannel) transmit(ctx context.Context, apdu []byte, insClass
 	for sw>>8 == 0x61 && guard < 24 {
 		guard++
 		getResponse := []byte{0x80 | byte(channel.channel), 0xC0, 0x00, 0x00, byte(sw & 0xFF)}
-		frag, nextSW, err := channel.exchange(ctx, getResponse)
+		frag, nextSW, err := channel.manager.csim(ctx, channel.id, getResponse)
 		if err != nil {
 			return nil, 0, err
 		}
@@ -615,8 +543,8 @@ func validProfileICCID(iccid string) bool {
 
 // ESIMListProfiles reads the eUICC profile list via ES10c GetProfilesInfo.
 func (manager *Manager) ESIMListProfiles(ctx context.Context, id string) (EsimInfo, error) {
-	manager.lockESIM()
-	defer manager.unlockESIM()
+	manager.esimMu.Lock()
+	defer manager.esimMu.Unlock()
 	if manager.esimRecoveryActive(id) {
 		if cached, ok := manager.cachedESIMInfo(id); ok {
 			return cached, nil
@@ -656,14 +584,14 @@ func (manager *Manager) ESIMSwitchProfile(ctx context.Context, id string, iccid
 	if err != nil {
 		return err
 	}
-	manager.lockESIM()
+	manager.esimMu.Lock()
 	if err := manager.waitForESIMRecovery(ctx, id); err != nil {
-		manager.unlockESIM()
+		manager.esimMu.Unlock()
 		return err
 	}
 	channel, err := manager.openEuiccAID(ctx, id, targetEuiccAID(aidHex))
 	if err != nil {
-		manager.unlockESIM()
+		manager.esimMu.Unlock()
 		return err
 	}
 
@@ -682,7 +610,6 @@ func (manager *Manager) ESIMSwitchProfile(ctx context.Context, id string, iccid
 	// Release the logical channel before any reset: openEuicc's csim holds
 	// opMu only for the duration of each APDU, so by here the lock is free.
 	closeContext, cancelClose := context.WithTimeout(context.Background(), csimAPDUTimeout)
-	channel.resetOnClose = channel.pcscSession != nil
 	channel.close(closeContext)
 	cancelClose()
 	if err != nil {
@@ -690,7 +617,7 @@ func (manager *Manager) ESIMSwitchProfile(ctx context.Context, id string, iccid
 		// detached reset is safe in either case and prevents an uncertain switch
 		// from leaving the modem's SIM cache unusable.
 		manager.startProfileSwitchRecovery(id)
-		manager.unlockESIM()
+		manager.esimMu.Unlock()
 		return err
 	}
 	// A transport SW 9000 only means the APDU reached the eUICC. The real outcome
@@ -699,11 +626,11 @@ func (manager *Manager) ESIMSwitchProfile(ctx context.Context, id string, iccid
 	result, ok := enableProfileResult(payload)
 	if !ok {
 		manager.startProfileSwitchRecovery(id)
-		manager.unlockESIM()
+		manager.esimMu.Unlock()
 		return fmt.Errorf("esim: unexpected EnableProfile response %s", strings.ToUpper(hex.EncodeToString(payload)))
 	}
 	if err := enableProfileResponseError(byte(result), payload); err != nil {
-		manager.unlockESIM()
+		manager.esimMu.Unlock()
 		return err
 	}
 	manager.markCachedProfileEnabled(id, iccid)
@@ -711,7 +638,7 @@ func (manager *Manager) ESIMSwitchProfile(ctx context.Context, id string, iccid
 	// a detached recovery so it survives an HTTP disconnect, but keep this API
 	// call pending until the live modem ICCID proves that the switch took effect.
 	manager.startProfileSwitchRecovery(id)
-	manager.unlockESIM()
+	manager.esimMu.Unlock()
 
 	verifyContext, cancelVerify := context.WithTimeout(context.WithoutCancel(ctx), profileSwitchVerificationTimeout(manager))
 	defer cancelVerify()
@@ -853,11 +780,9 @@ func (manager *Manager) renameCachedProfile(id, iccid, nickname string) {
 // initiating HTTP request. EC20 commonly drops the AT port while processing
 // CFUN=1,1, so the reset error is intentionally followed by discovery retries.
 func (manager *Manager) recoverAfterProfileSwitch(id string) {
-	if !manager.isPCSCDevice(id) {
-		resetContext, cancelReset := context.WithTimeout(context.Background(), manager.longTimeout)
-		_ = manager.rebootForProfileSwitch(resetContext, id)
-		cancelReset()
-	}
+	resetContext, cancelReset := context.WithTimeout(context.Background(), manager.longTimeout)
+	_ = manager.rebootForProfileSwitch(resetContext, id)
+	cancelReset()
 	manager.refreshAfterProfileSwitch(id)
 }
 
@@ -870,20 +795,6 @@ func (manager *Manager) recoverAfterProfileSwitch(id string) {
 // the next attempt. All errors are swallowed: this is best-effort self-healing
 // and setResult already records the last failure for the UI.
 func (manager *Manager) refreshAfterProfileSwitch(id string) {
-	if manager.isPCSCDevice(id) {
-		time.Sleep(750 * time.Millisecond)
-		for attempt := 0; attempt < 10; attempt++ {
-			ctx, cancel := context.WithTimeout(context.Background(), manager.commandTimeout*4)
-			_, _ = manager.Discover(ctx)
-			_, err := manager.Refresh(ctx, id)
-			cancel()
-			if err == nil {
-				return
-			}
-			time.Sleep(time.Second)
-		}
-		return
-	}
 	const (
 		settle   = 8 * time.Second
 		interval = 4 * time.Second
@@ -908,14 +819,6 @@ func (manager *Manager) refreshAfterProfileSwitch(id string) {
 	}
 }
 
-func (manager *Manager) isPCSCDevice(id string) bool {
-	state, err := manager.lookup(id)
-	if err != nil {
-		return false
-	}
-	return manager.candidateFor(state).HardwareKind == pcsc.HardwareKind
-}
-
 // enableProfileResult extracts the EnableProfile result code (tag 80) from the
 // ES10c response body. ok is false when no result code is present.
 func enableProfileResult(payload []byte) (int, bool) {
@@ -985,37 +888,25 @@ func (manager *Manager) verifySwitchedICCID(ctx context.Context, id, expected st
 	var lastICCID string
 	var lastErr error
 	for attempt := 0; attempt < attempts; attempt++ {
-		if manager.isPCSCDevice(id) {
-			snapshot, err := manager.Refresh(ctx, id)
-			if err == nil {
-				lastICCID = strings.TrimSpace(snapshot.ICCID)
-				if lastICCID == expected {
-					return nil
-				}
-				err = fmt.Errorf("reader still reports ICCID %s", lastICCID)
+		for _, command := range []string{"AT+CCID", "AT+QCCID"} {
+			commandContext, cancel := context.WithTimeout(ctx, manager.commandTimeout)
+			response, err := manager.ExecuteAT(commandContext, id, command)
+			cancel()
+			if err != nil {
+				lastErr = err
+				continue
 			}
-			lastErr = err
-		} else {
-			for _, command := range []string{"AT+CCID", "AT+QCCID"} {
-				commandContext, cancel := context.WithTimeout(ctx, manager.commandTimeout)
-				response, err := manager.ExecuteAT(commandContext, id, command)
-				cancel()
-				if err != nil {
-					lastErr = err
-					continue
-				}
-				live := parseICCIDIdentifier(response, []string{"+CCID:", "+QCCID:"}, 18, 22)
-				if live == "" {
-					lastErr = errors.New("modem response contained no valid ICCID")
-					continue
-				}
-				lastICCID = live
-				if live == expected {
-					return nil
-				}
-				lastErr = fmt.Errorf("modem still reports ICCID %s", live)
-				break
+			live := parseICCIDIdentifier(response, []string{"+CCID:", "+QCCID:"}, 18, 22)
+			if live == "" {
+				lastErr = errors.New("modem response contained no valid ICCID")
+				continue
 			}
+			lastICCID = live
+			if live == expected {
+				return nil
+			}
+			lastErr = fmt.Errorf("modem still reports ICCID %s", live)
+			break
 		}
 		if attempt+1 < attempts {
 			select {

internal/device/esim_delete.go

@@ -69,8 +69,8 @@ func (manager *Manager) ESIMDeleteProfile(ctx context.Context, id, iccid, aidHex
 	if err != nil {
 		return nil, err
 	}
-	manager.lockESIM()
-	defer manager.unlockESIM()
+	manager.esimMu.Lock()
+	defer manager.esimMu.Unlock()
 	if err := manager.waitForESIMRecovery(ctx, id); err != nil {
 		return nil, err
 	}

internal/device/esim_disable.go

@@ -63,8 +63,8 @@ func (manager *Manager) ESIMDisableProfile(ctx context.Context, id, iccid, aidHe
 	if err != nil {
 		return err
 	}
-	manager.lockESIM()
-	defer manager.unlockESIM()
+	manager.esimMu.Lock()
+	defer manager.esimMu.Unlock()
 	if err := manager.waitForESIMRecovery(ctx, id); err != nil {
 		return err
 	}

internal/device/esim_download.go

@@ -48,8 +48,8 @@ func (manager *Manager) ESIMDownloadProfile(ctx context.Context, id string, para
 		}
 	}
 
-	manager.lockESIM()
-	defer manager.unlockESIM()
+	manager.esimMu.Lock()
+	defer manager.esimMu.Unlock()
 
 	report("preflight", "正在检查 eUICC 剩余空间...", 10)
 	channel, err := manager.openEuiccAID(ctx, id, targetEuiccAID(params.AIDHex))
@@ -228,8 +228,8 @@ type EsimChipInfo struct {
 // ESIMChipInfo reads the eUICC's EID, EUICCInfo2, and configured addresses for
 // the chip header. It takes the eSIM lock like the other card ops.
 func (manager *Manager) ESIMChipInfo(ctx context.Context, id string) (*EsimChipInfo, error) {
-	manager.lockESIM()
-	defer manager.unlockESIM()
+	manager.esimMu.Lock()
+	defer manager.esimMu.Unlock()
 
 	var lastErr error
 	for _, aid := range manager.discoverEuiccAIDs(ctx, id) {
@@ -286,8 +286,8 @@ func readEsimChipInfo(ctx context.Context, channel *euiccChannel, aidHex string)
 // the inserted card. It is entirely read-only: only SELECT, GetProfilesInfo,
 // GetEuiccData, GetEuiccInfo2 and GetEuiccConfiguredAddresses are issued.
 func (manager *Manager) ESIMInventory(ctx context.Context, id string) ([]EsimInventoryEntry, error) {
-	manager.lockESIM()
-	defer manager.unlockESIM()
+	manager.esimMu.Lock()
+	defer manager.esimMu.Unlock()
 	if manager.esimRecoveryActive(id) {
 		return nil, errESIMRecovering
 	}

internal/device/esim_lpa.go

@@ -52,7 +52,7 @@ func (channel *euiccChannel) storeDataChained(ctx context.Context, derRequest []
 		if err != nil {
 			return nil, err
 		}
-		if !es10StatusOK(sw) {
+		if sw != 0x9000 {
 			return nil, fmt.Errorf("%w: SW=%04X", errESIMSW, sw)
 		}
 		assembled = append(assembled, payload...)
@@ -62,14 +62,6 @@ func (channel *euiccChannel) storeDataChained(ctx context.Context, derRequest []
 	return assembled, nil
 }
 
-// 91xx is a successful UICC result with a proactive SIM Toolkit command
-// pending. EnableProfile commonly returns it on direct PC/SC transports because
-// the requested refresh is delivered to the terminal rather than consumed by
-// modem firmware. Resetting the card after the operation applies that refresh.
-func es10StatusOK(sw int) bool {
-	return sw == 0x9000 || sw>>8 == 0x91
-}
-
 // getEUICCChallenge (ES10c, BF2E) returns the eUICC challenge bytes.
 func (channel *euiccChannel) getEUICCChallenge(ctx context.Context) ([]byte, error) {
 	payload, err := channel.es10(ctx, []byte{0xBF, 0x2E, 0x00})

internal/device/esim_lpa_test.go

@@ -155,16 +155,3 @@ func TestEuiccFreeNVRAM(t *testing.T) {
 		t.Fatalf("expected ok=false when extCardResource absent")
 	}
 }
-
-func TestES10StatusAcceptsProactiveRefresh(t *testing.T) {
-	for _, status := range []int{0x9000, 0x9100, 0x910B, 0x91FF} {
-		if !es10StatusOK(status) {
-			t.Fatalf("status %04X should be successful", status)
-		}
-	}
-	for _, status := range []int{0x6A82, 0x6985, 0x9200} {
-		if es10StatusOK(status) {
-			t.Fatalf("status %04X should fail", status)
-		}
-	}
-}

internal/device/esim_notifications.go

@@ -295,8 +295,8 @@ func (channel *euiccChannel) deliverPendingNotifications(ctx context.Context) er
 // ESIMNotifications returns the notifications retained across every eUICC
 // storage exposed by the physical card.
 func (manager *Manager) ESIMNotifications(ctx context.Context, id string) ([]EsimNotification, error) {
-	manager.lockESIM()
-	defer manager.unlockESIM()
+	manager.esimMu.Lock()
+	defer manager.esimMu.Unlock()
 	if err := manager.waitForESIMRecovery(ctx, id); err != nil {
 		return nil, err
 	}
@@ -331,8 +331,8 @@ func (manager *Manager) ESIMNotifications(ctx context.Context, id string) ([]Esi
 // ESIMRetryNotification sends one retained notification and removes it from the
 // eUICC only after the receiver returns the SGP.22 success acknowledgement.
 func (manager *Manager) ESIMRetryNotification(ctx context.Context, id, aidHex string, sequenceNumber uint64) error {
-	manager.lockESIM()
-	defer manager.unlockESIM()
+	manager.esimMu.Lock()
+	defer manager.esimMu.Unlock()
 	if err := manager.waitForESIMRecovery(ctx, id); err != nil {
 		return err
 	}

internal/device/esim_rename.go

@@ -49,8 +49,8 @@ func (manager *Manager) ESIMRenameProfile(ctx context.Context, id, iccid, nickna
 	if err != nil {
 		return err
 	}
-	manager.lockESIM()
-	defer manager.unlockESIM()
+	manager.esimMu.Lock()
+	defer manager.esimMu.Unlock()
 	if err := manager.waitForESIMRecovery(ctx, id); err != nil {
 		return err
 	}

internal/device/esim_test.go

@@ -294,46 +294,6 @@ func TestEUICCChannelStuckWrapsTransientCME(t *testing.T) {
 	}
 }
 
-func TestOpenEuiccRecoversOrphanedSingleLogicalChannel(t *testing.T) {
-	client := &transcriptClient{steps: []clientStep{
-		{
-			command:  `AT+CSIM=10,"0070000001"`,
-			response: okResponse(`+CSIM: 6,"006A81"`),
-		},
-		{
-			command:  `AT+CSIM=10,"0070800100"`,
-			response: okResponse(`+CSIM: 4,"9000"`),
-		},
-		{
-			command:  `AT+CSIM=10,"0070000001"`,
-			response: okResponse(`+CSIM: 6,"019000"`),
-		},
-		{
-			command: fmt.Sprintf(
-				`AT+CSIM=42,"01A4040010%s"`,
-				isdRAID,
-			),
-			response: okResponse(`+CSIM: 4,"9000"`),
-		},
-		{
-			command:  `AT+CSIM=10,"0070800100"`,
-			response: okResponse(`+CSIM: 4,"9000"`),
-		},
-	}}
-	manager, id := newStartedTestManager(t, client)
-
-	manager.lockESIM()
-	channel, err := manager.openEuiccAID(context.Background(), id, isdRAID)
-	if err == nil {
-		channel.close(context.Background())
-	}
-	manager.unlockESIM()
-	if err != nil {
-		t.Fatalf("open eUICC after orphaned channel: %v", err)
-	}
-	client.assertDone(t)
-}
-
 func TestWaitForESIMRecovery(t *testing.T) {
 	done := make(chan struct{})
 	manager := &Manager{esimRecoveries: map[string]chan struct{}{"dev": done}}

internal/device/flight_qmi.go

@@ -1,375 +0,0 @@
-package device
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"strings"
-	"sync"
-	"time"
-
-	"github.com/iniwex5/quectel-qmi-go/pkg/qmi"
-
-	"vocat/internal/qmiport"
-)
-
-type qmiRadioSession interface {
-	GetOperatingMode(context.Context) (qmi.OperatingMode, error)
-	SetOperatingMode(context.Context, qmi.OperatingMode) error
-	Close() error
-}
-
-type qmiRadioSessionOpener func(context.Context, string) (qmiRadioSession, error)
-
-type nativeQMIICCIDSession interface {
-	GetICCID(context.Context) (string, error)
-}
-
-// nativeQMIControl identifies the QMI control node exposed by native WWAN
-// devices. USB serial modems may also advertise a control path, but only the
-// wwanN/qmiN pairing is safe to operate through the native QMI path.
-func (manager *Manager) nativeQMIControl(id string) (string, bool, error) {
-	state, err := manager.lookup(id)
-	if err != nil {
-		return "", false, err
-	}
-	candidate := manager.candidateFor(state)
-	controlDevice := strings.TrimSpace(candidate.QMIControl)
-	deviceID := strings.TrimSpace(candidate.ID)
-	if !nativeQMIControlMatches(deviceID, controlDevice) {
-		return "", false, nil
-	}
-	return controlDevice, true, nil
-}
-
-type productionQMIRadioSession struct {
-	client *qmi.Client
-	dms    *qmi.DMSService
-	nas    *qmi.NASService
-	nasErr error
-	uimMu  sync.Mutex
-	uim    *qmi.UIMService
-	lease  *qmiport.Lease
-}
-
-// The native WWAN path uses the same QMI NAS client for radio wake-up,
-// operator selection, and registration.  Keep these methods optional on the
-// qmiRadioSession interface so the older transcript-backed tests and AT-only
-// devices do not need to grow a fake NAS implementation.
-func (session *productionQMIRadioSession) nasService() (*qmi.NASService, error) {
-	if session == nil {
-		return nil, errors.New("QMI NAS session is unavailable")
-	}
-	if session.nas == nil {
-		if session.nasErr != nil {
-			return nil, session.nasErr
-		}
-		return nil, errors.New("QMI NAS session is unavailable")
-	}
-	return session.nas, nil
-}
-
-func (session *productionQMIRadioSession) GetServingSystem(ctx context.Context) (*qmi.ServingSystem, error) {
-	nas, err := session.nasService()
-	if err != nil {
-		return nil, err
-	}
-	return nas.GetServingSystem(ctx)
-}
-
-func (session *productionQMIRadioSession) GetSystemSelectionPreference(ctx context.Context) (*qmi.SystemSelectionPreference, error) {
-	nas, err := session.nasService()
-	if err != nil {
-		return nil, err
-	}
-	return nas.GetSystemSelectionPreference(ctx)
-}
-
-func (session *productionQMIRadioSession) SetSystemSelectionPreference(ctx context.Context, pref qmi.SystemSelectionPreference) error {
-	nas, err := session.nasService()
-	if err != nil {
-		return err
-	}
-	return nas.SetSystemSelectionPreference(ctx, pref)
-}
-
-func (session *productionQMIRadioSession) InitiateNetworkRegister(ctx context.Context, req qmi.NASInitiateNetworkRegisterRequest) error {
-	nas, err := session.nasService()
-	if err != nil {
-		return err
-	}
-	return nas.InitiateNetworkRegister(ctx, req)
-}
-
-func (session *productionQMIRadioSession) ForceNetworkSearch(ctx context.Context) error {
-	nas, err := session.nasService()
-	if err != nil {
-		return err
-	}
-	return nas.ForceNetworkSearch(ctx)
-}
-
-func (session *productionQMIRadioSession) AttachDetach(ctx context.Context, attached bool) error {
-	nas, err := session.nasService()
-	if err != nil {
-		return err
-	}
-	return nas.AttachDetach(ctx, attached)
-}
-
-// openQMIRadioSession controls native WWAN radios through QMI DMS. OpenStick
-// 410 firmware rejects AT+CFUN=1 even though the equivalent DMS online request
-// is supported, so native WWAN devices must not fall back to the AT path.
-func openQMIRadioSession(ctx context.Context, controlDevice string) (qmiRadioSession, error) {
-	if ctx == nil {
-		ctx = context.Background()
-	}
-	openContext, cancel := context.WithTimeout(ctx, 15*time.Second)
-	defer cancel()
-	lease, err := qmiport.Acquire(openContext, controlDevice)
-	if err != nil {
-		return nil, err
-	}
-	opts := qmi.DefaultClientOptions()
-	opts.UseProxy = true
-	opts.Logf = func(qmi.ClientLogLevel, string, ...any) {}
-	client, err := qmi.NewClientWithOptions(openContext, controlDevice, opts)
-	if err != nil {
-		lease.Release()
-		return nil, err
-	}
-	dms, err := qmi.NewDMSServiceWithContext(openContext, client)
-	if err != nil {
-		_ = client.Close()
-		lease.Release()
-		return nil, err
-	}
-	// NAS is optional for ordinary radio controls. Some firmware exposes DMS
-	// but rejects NAS client allocation; keep radio control usable and report
-	// that limitation only to native registration/RF queries.
-	nas, nasErr := qmi.NewNASServiceWithContext(openContext, client)
-	return &productionQMIRadioSession{
-		client: client,
-		dms:    dms,
-		nas:    nas,
-		nasErr: nasErr,
-		lease:  lease,
-	}, nil
-}
-
-func (session *productionQMIRadioSession) GetICCID(ctx context.Context) (string, error) {
-	if session == nil || session.client == nil {
-		return "", errors.New("QMI UIM session is unavailable")
-	}
-	session.uimMu.Lock()
-	defer session.uimMu.Unlock()
-	if session.uim == nil {
-		uim, err := qmi.NewUIMServiceWithContext(ctx, session.client)
-		if err != nil {
-			return "", err
-		}
-		session.uim = uim
-	}
-	return session.uim.GetICCID(ctx)
-}
-
-func (session *productionQMIRadioSession) GetOperatingMode(ctx context.Context) (qmi.OperatingMode, error) {
-	return session.dms.GetOperatingMode(ctx)
-}
-
-func (session *productionQMIRadioSession) SetOperatingMode(ctx context.Context, mode qmi.OperatingMode) error {
-	return session.dms.SetOperatingMode(ctx, mode)
-}
-
-func (session *productionQMIRadioSession) Close() error {
-	if session == nil {
-		return nil
-	}
-	var closeErrors []error
-	session.uimMu.Lock()
-	if session.uim != nil {
-		closeErrors = append(closeErrors, session.uim.Close())
-		session.uim = nil
-	}
-	session.uimMu.Unlock()
-	if session.dms != nil {
-		closeErrors = append(closeErrors, session.dms.Close())
-		session.dms = nil
-	}
-	if session.nas != nil {
-		closeErrors = append(closeErrors, session.nas.Close())
-		session.nas = nil
-	}
-	if session.client != nil {
-		closeErrors = append(closeErrors, session.client.Close())
-		session.client = nil
-	}
-	if session.lease != nil {
-		session.lease.Release()
-		session.lease = nil
-	}
-	return errors.Join(closeErrors...)
-}
-
-func (manager *Manager) setNativeQMIFlight(
-	ctx context.Context,
-	id string,
-	state *managedDevice,
-	enabled bool,
-) (FlightResult, bool, error) {
-	controlDevice, native, err := manager.nativeQMIControl(id)
-	if err != nil {
-		return FlightResult{}, true, err
-	}
-	if !native {
-		return FlightResult{}, false, nil
-	}
-	if manager.qmiRadioOpener == nil {
-		return FlightResult{}, true, errors.New("QMI DMS radio control is unavailable")
-	}
-	if ctx == nil {
-		ctx = context.Background()
-	}
-	openContext, cancelOpen := manager.withTimeout(ctx, manager.commandTimeout*5)
-	session, err := manager.qmiRadioOpener(openContext, controlDevice)
-	cancelOpen()
-	if err != nil {
-		return FlightResult{}, true, fmt.Errorf("open QMI DMS radio control: %w", err)
-	}
-	defer session.Close()
-
-	readContext, cancelRead := manager.withTimeout(ctx, manager.commandTimeout)
-	previousQMI, err := session.GetOperatingMode(readContext)
-	cancelRead()
-	if err != nil {
-		return FlightResult{}, true, fmt.Errorf("read QMI operating mode: %w", err)
-	}
-	previous := qmiModeAsCFUN(previousQMI)
-	targetQMI := previousQMI
-	if enabled {
-		if !isQMIRadioOffMode(previousQMI) {
-			targetQMI = qmi.ModeLowPower
-		}
-	} else if previousQMI != qmi.ModeOnline {
-		targetQMI = qmi.ModeOnline
-	}
-	changed := targetQMI != previousQMI
-	if changed {
-		setContext, cancelSet := manager.withTimeout(ctx, manager.commandTimeout)
-		err = session.SetOperatingMode(setContext, targetQMI)
-		cancelSet()
-		if err != nil {
-			return FlightResult{
-				PreviousMode: previous,
-				CurrentMode:  previous,
-				FlightMode:   isQMIRadioOffMode(previousQMI),
-				RadioOff:     isQMIRadioOffMode(previousQMI),
-			}, true, fmt.Errorf("set QMI operating mode: %w", err)
-		}
-	}
-	currentQMI, err := manager.waitForQMIRadioState(ctx, session, enabled, targetQMI)
-	if err != nil {
-		currentRadioOff := isQMIRadioOffMode(currentQMI)
-		return FlightResult{
-			PreviousMode: previous,
-			CurrentMode:  qmiModeAsCFUN(currentQMI),
-			Changed:      changed,
-			FlightMode:   currentRadioOff,
-			RadioOff:     currentRadioOff,
-		}, true, err
-	}
-	current := qmiModeAsCFUN(currentQMI)
-	currentRadioOff := isQMIRadioOffMode(currentQMI)
-	manager.updateSnapshotMode(id, state, current)
-	if !enabled && !currentRadioOff {
-		// DMS Online is only the radio half of the recovery. Continue with a
-		// background NAS registration/PS-attach reconcile after the flight-mode
-		// transition without holding the radio QMI session open.
-		manager.startNativeQMIRegistrationReconcile(id)
-	}
-	return FlightResult{
-		PreviousMode: previous,
-		CurrentMode:  current,
-		Changed:      changed,
-		FlightMode:   currentRadioOff,
-		RadioOff:     currentRadioOff,
-	}, true, nil
-}
-
-func (manager *Manager) waitForQMIRadioState(
-	ctx context.Context,
-	session qmiRadioSession,
-	radioOff bool,
-	fallback qmi.OperatingMode,
-) (qmi.OperatingMode, error) {
-	verifyTimeout := manager.commandTimeout * 2
-	if verifyTimeout < 5*time.Second {
-		verifyTimeout = 5 * time.Second
-	}
-	verifyContext, cancel := manager.withTimeout(ctx, verifyTimeout)
-	defer cancel()
-	current := fallback
-	var lastErr error
-	for {
-		mode, err := session.GetOperatingMode(verifyContext)
-		if err == nil {
-			current = mode
-			lastErr = nil
-			if qmiModeMatchesFlight(mode, radioOff) {
-				return mode, nil
-			}
-		} else {
-			lastErr = err
-		}
-		timer := time.NewTimer(250 * time.Millisecond)
-		select {
-		case <-verifyContext.Done():
-			if !timer.Stop() {
-				select {
-				case <-timer.C:
-				default:
-				}
-			}
-			if lastErr != nil {
-				return current, fmt.Errorf("verify QMI operating mode: %w", lastErr)
-			}
-			return current, fmt.Errorf(
-				"QMI operating mode did not reach requested radio state (mode %d): %w",
-				current,
-				verifyContext.Err(),
-			)
-		case <-timer.C:
-		}
-	}
-}
-
-func qmiModeMatchesFlight(mode qmi.OperatingMode, radioOff bool) bool {
-	if radioOff {
-		return isQMIRadioOffMode(mode)
-	}
-	return mode == qmi.ModeOnline
-}
-
-func isQMIRadioOffMode(mode qmi.OperatingMode) bool {
-	switch mode {
-	case qmi.ModeLowPower, qmi.ModeOffline, qmi.ModeShutdown, qmi.ModePersistLow, qmi.ModeOnlyLowPower:
-		return true
-	default:
-		return false
-	}
-}
-
-// FlightResult and Snapshot historically expose AT+CFUN values. Preserve that
-// API contract while sourcing the real radio state from QMI DMS.
-func qmiModeAsCFUN(mode qmi.OperatingMode) int {
-	switch mode {
-	case qmi.ModeOnline:
-		return 1
-	case qmi.ModeLowPower, qmi.ModePersistLow:
-		return 0
-	case qmi.ModeOffline, qmi.ModeShutdown, qmi.ModeOnlyLowPower:
-		return 7
-	default:
-		return 1
-	}
-}

internal/device/identity_qmi.go

@@ -1,39 +0,0 @@
-package device
-
-import (
-	"context"
-	"errors"
-	"fmt"
-
-	"vocat/internal/modem"
-)
-
-func (manager *Manager) readNativeQMIICCID(ctx context.Context, candidate modem.Candidate) (string, error) {
-	if manager == nil || manager.qmiRadioOpener == nil {
-		return "", errors.New("QMI UIM ICCID reader is unavailable")
-	}
-	if candidate.QMIControl == "" {
-		return "", errors.New("QMI UIM control device is unavailable")
-	}
-	session, err := manager.qmiRadioOpener(ctx, candidate.QMIControl)
-	if err != nil {
-		return "", fmt.Errorf("open QMI UIM control: %w", err)
-	}
-	if session == nil {
-		return "", errors.New("QMI UIM control returned an empty session")
-	}
-	defer session.Close()
-	reader, ok := session.(nativeQMIICCIDSession)
-	if !ok {
-		return "", errors.New("QMI session does not expose UIM ICCID reading")
-	}
-	value, err := reader.GetICCID(ctx)
-	if err != nil {
-		return "", fmt.Errorf("read EF_ICCID: %w", err)
-	}
-	iccid := parseICCIDIdentifier(modem.Response{Lines: []string{value}}, nil, 18, 22)
-	if iccid == "" {
-		return "", errors.New("QMI UIM returned an invalid ICCID")
-	}
-	return iccid, nil
-}

internal/device/manager.go

@@ -10,7 +10,6 @@ import (
 	"time"
 
 	"vocat/internal/modem"
-	"vocat/internal/pcsc"
 )
 
 type Options struct {
@@ -20,12 +19,10 @@ type Options struct {
 	LongTimeout    time.Duration
 	SMSTimeout     time.Duration
 	ScanTimeout    time.Duration
-	CardReaders    *pcsc.Service
 }
 
 type Manager struct {
 	mu             sync.RWMutex
-	uiccMu         sync.Mutex // serializes all multi-command UICC/APDU transactions
 	esimMu         sync.Mutex // serializes eSIM card access (list/switch/download)
 	esimRecoveryMu sync.Mutex
 	esimRecoveries map[string]chan struct{}
@@ -37,32 +34,9 @@ type Manager struct {
 	longTimeout    time.Duration
 	smsTimeout     time.Duration
 	scanTimeout    time.Duration
-	cardReaders    *pcsc.Service
-
-	qmiRadioOpener                qmiRadioSessionOpener
-	nativeQMIRegistrationMu       sync.Mutex
-	nativeQMIRegistrationInFlight map[string]struct{}
-
-	started      bool
-	devices      map[string]*managedDevice
-	ussdSessions map[string]ussdSession
-}
-
-// LockUICC and UnlockUICC allow another in-process UICC client (currently the
-// VoWiFi AKA adapter) to share the same transaction boundary as eSIM ES10.
-// Individual AT commands are already serialized per modem, but a logical-
-// channel transaction spans several commands and must not be interleaved.
-func (manager *Manager) LockUICC()   { manager.uiccMu.Lock() }
-func (manager *Manager) UnlockUICC() { manager.uiccMu.Unlock() }
-
-func (manager *Manager) lockESIM() {
-	manager.esimMu.Lock()
-	manager.uiccMu.Lock()
-}
-
-func (manager *Manager) unlockESIM() {
-	manager.uiccMu.Unlock()
-	manager.esimMu.Unlock()
+	started        bool
+	devices        map[string]*managedDevice
+	ussdSessions   map[string]ussdSession
 }
 
 // ussdSession tracks an open USSD dialog on a device so a follow-up Continue or
@@ -85,7 +59,6 @@ type managedDevice struct {
 	discovered        bool
 	preFlightMode     *int
 	resetClientOnLock bool
-	simPIN            string
 }
 
 func NewManager(options Options) (*Manager, error) {
@@ -109,9 +82,6 @@ func NewManager(options Options) (*Manager, error) {
 		// AT+COPS=? can take well over a minute while the modem sweeps every band.
 		options.ScanTimeout = 150 * time.Second
 	}
-	if options.CardReaders == nil {
-		options.CardReaders = pcsc.New()
-	}
 	return &Manager{
 		discoverer:     options.Discoverer,
 		opener:         options.Opener,
@@ -119,11 +89,6 @@ func NewManager(options Options) (*Manager, error) {
 		longTimeout:    options.LongTimeout,
 		smsTimeout:     options.SMSTimeout,
 		scanTimeout:    options.ScanTimeout,
-		cardReaders:    options.CardReaders,
-
-		qmiRadioOpener:                openQMIRadioSession,
-		nativeQMIRegistrationInFlight: make(map[string]struct{}),
-
 		devices:        make(map[string]*managedDevice),
 		ussdSessions:   make(map[string]ussdSession),
 		esimRecoveries: make(map[string]chan struct{}),
@@ -181,24 +146,9 @@ func (manager *Manager) Discover(ctx context.Context) ([]Device, error) {
 	if ctx == nil {
 		ctx = context.Background()
 	}
-	candidates, modemErr := manager.discoverer.Discover(ctx)
-	readers, readerErr := manager.cardReaders.Readers(ctx)
-	if readerErr == nil {
-		for _, reader := range readers {
-			candidates = append(candidates, modem.Candidate{
-				ID: pcsc.DeviceID(reader), HardwareKind: pcsc.HardwareKind,
-				ReaderName: reader.Name, USBPath: reader.USBPath,
-				VendorID: reader.VendorID, ProductID: reader.ProductID,
-				Manufacturer: reader.Manufacturer, Product: reader.Product,
-				DiscoveryIssue: reader.DiscoveryIssue,
-			})
-		}
-	}
-	if modemErr != nil && readerErr != nil && !errors.Is(readerErr, pcsc.ErrUnsupported) && !errors.Is(readerErr, pcsc.ErrUnavailable) {
-		return nil, errors.Join(modemErr, readerErr)
-	}
-	if modemErr != nil && len(candidates) == 0 {
-		return nil, modemErr
+	candidates, err := manager.discoverer.Discover(ctx)
+	if err != nil {
+		return nil, err
 	}
 	seen := make(map[string]struct{}, len(candidates))
 
@@ -241,20 +191,7 @@ func (manager *Manager) Discover(ctx context.Context) ([]Device, error) {
 		state.opMu.Unlock()
 	}
 	manager.resetChangedClients()
-
-	// List retains previously discovered devices so configured hardware can be
-	// rendered as offline after it is unplugged. Discover, however, is a fresh
-	// physical scan and must only return devices that are present now. Returning
-	// the retained entries here allowed an unplugged modem to be selected and
-	// added again from the device discovery screen.
-	devices := manager.List()
-	present := devices[:0]
-	for _, entry := range devices {
-		if entry.Discovered {
-			present = append(present, entry)
-		}
-	}
-	return present, nil
+	return manager.List(), nil
 }
 
 func (manager *Manager) resetChangedClients() {
@@ -423,9 +360,6 @@ func (manager *Manager) Refresh(ctx context.Context, id string) (Snapshot, error
 		return Snapshot{}, err
 	}
 	candidate := manager.candidateFor(state)
-	if candidate.HardwareKind == pcsc.HardwareKind {
-		return manager.refreshCardReader(ctx, id, state, candidate)
-	}
 	backend := manager.backendFor(state)
 	client, err := manager.clientLocked(ctx, state, candidate)
 	if err != nil {
@@ -433,14 +367,7 @@ func (manager *Manager) Refresh(ctx context.Context, id string) (Snapshot, error
 		return Snapshot{}, err
 	}
 	previousICCID := state.lastICCID
-	var previousSnapshot *Snapshot
-	manager.mu.RLock()
-	if state.snapshot != nil {
-		copy := *state.snapshot
-		previousSnapshot = &copy
-	}
-	manager.mu.RUnlock()
-	snapshot, err := manager.readSnapshot(ctx, id, candidate, backend, previousICCID, previousSnapshot, client)
+	snapshot, err := manager.readSnapshot(ctx, id, candidate, backend, previousICCID, client)
 	if err == nil && strings.TrimSpace(snapshot.ICCID) != "" {
 		state.lastICCID = strings.TrimSpace(snapshot.ICCID)
 	}
@@ -448,60 +375,11 @@ func (manager *Manager) Refresh(ctx context.Context, id string) (Snapshot, error
 	return snapshot, err
 }
 
-func (manager *Manager) refreshCardReader(ctx context.Context, id string, state *managedDevice, candidate modem.Candidate) (Snapshot, error) {
-	result := Snapshot{
-		DeviceID: id, Port: candidate.ReaderName, Responsive: true,
-		Manufacturer: candidate.Manufacturer, Model: candidate.Product,
-		AccessTech: "Wi-Fi", RegistrationSource: "pcsc", OperatingMode: 4,
-		ModeKnown: true, FlightMode: true, RadioOff: true, UpdatedAt: time.Now().UTC(),
-	}
-	previousICCID := state.lastICCID
-	card, err := manager.cardReaders.Snapshot(ctx, pcsc.Selector{USBPath: candidate.USBPath, ReaderName: candidate.ReaderName}, state.simPIN)
-	if err != nil {
-		switch {
-		case errors.Is(err, pcsc.ErrNoCard):
-			result.SIMStatus = ""
-			err = nil
-		case errors.Is(err, pcsc.ErrPINRequired), errors.Is(err, pcsc.ErrPINTriesLow), errors.Is(err, pcsc.ErrPINRejected):
-			result.SIMStatus = "SIM PIN"
-			result.Warnings = []string{err.Error()}
-			err = nil
-		default:
-			manager.setResult(id, state, &result, err)
-			return result, err
-		}
-	} else {
-		result.SIMStatus = "READY"
-		result.SIMReady = true
-		result.ICCID = card.Identity.ICCID
-		result.IMSI = card.Identity.IMSI
-		result.SPN = card.Identity.SPN
-		result.MNCLength = card.Identity.MNCLength
-		result.SIMChanged = previousICCID != "" && !strings.EqualFold(previousICCID, result.ICCID)
-		state.lastICCID = result.ICCID
-	}
-	manager.setResult(id, state, &result, err)
-	return result, err
-}
-
-// SetSIMPin updates the in-memory PIN used for protected USIM files and AKA.
-// It is deliberately never retained in runtime snapshots or logs.
-func (manager *Manager) SetSIMPin(id, pin string) error {
-	manager.mu.Lock()
-	defer manager.mu.Unlock()
-	state := manager.devices[id]
-	if state == nil || !state.discovered {
-		return ErrNotFound
-	}
-	state.simPIN = strings.TrimSpace(pin)
-	return nil
-}
-
 // SetBackend selects which control plane supplies registration and data state.
 // AT remains available in either mode for UICC, RF, SMS, voice and diagnostics.
 func (manager *Manager) SetBackend(id, backend string) error {
 	backend = strings.ToLower(strings.TrimSpace(backend))
-	if backend != "at" && backend != "qmi" && backend != "pcsc" {
+	if backend != "at" && backend != "qmi" {
 		return fmt.Errorf("unsupported device backend %q", backend)
 	}
 	manager.mu.Lock()

internal/device/manager_test.go

@@ -6,68 +6,8 @@ import (
 	"testing"
 
 	"vocat/internal/modem"
-	"vocat/internal/pcsc"
 )
 
-type testPCSCBackend struct{ readers []pcsc.Reader }
-
-func (backend testPCSCBackend) Readers(context.Context) ([]pcsc.Reader, error) {
-	return append([]pcsc.Reader(nil), backend.readers...), nil
-}
-func (testPCSCBackend) Open(context.Context, pcsc.Selector) (pcsc.Card, error) {
-	return nil, pcsc.ErrNoCard
-}
-
-func TestManagerDiscoversWiFiCallingOnlyReaderWithoutATPort(t *testing.T) {
-	manager, err := NewManager(Options{
-		Discoverer: staticDiscoverer{}, Opener: &staticOpener{},
-		CardReaders: pcsc.NewWithBackend(testPCSCBackend{readers: []pcsc.Reader{{
-			Name: "Alcor Link AK9563 00 00", USBPath: "1-3", Product: "AK9563",
-		}}}),
-	})
-	if err != nil {
-		t.Fatal(err)
-	}
-	if err := manager.Start(context.Background()); err != nil {
-		t.Fatal(err)
-	}
-	t.Cleanup(func() { _ = manager.Stop(context.Background()) })
-	items := manager.List()
-	if len(items) != 1 || items[0].Candidate.HardwareKind != pcsc.HardwareKind || items[0].Candidate.HasATPort() {
-		t.Fatalf("discovered readers = %#v", items)
-	}
-	snapshot, err := manager.Refresh(context.Background(), items[0].ID)
-	if err != nil {
-		t.Fatal(err)
-	}
-	if !snapshot.Responsive || snapshot.SIMReady || snapshot.SIMStatus != "" || !snapshot.FlightMode {
-		t.Fatalf("reader snapshot = %#v", snapshot)
-	}
-}
-
-func TestManagerDiscoverReturnsOnlyCurrentlyPresentDevices(t *testing.T) {
-	manager, id := newStartedTestManager(t, nil)
-	if devices := manager.List(); len(devices) != 1 || devices[0].ID != id || !devices[0].Discovered {
-		t.Fatalf("initial devices = %#v", devices)
-	}
-
-	manager.discoverer = staticDiscoverer{}
-	present, err := manager.Discover(context.Background())
-	if err != nil {
-		t.Fatalf("Discover after unplug: %v", err)
-	}
-	if len(present) != 0 {
-		t.Fatalf("present devices after unplug = %#v, want none", present)
-	}
-
-	// The retained entry is still available to the configured-device dashboard,
-	// but is explicitly offline and cannot be offered by fresh discovery.
-	retained := manager.List()
-	if len(retained) != 1 || retained[0].ID != id || retained[0].Discovered {
-		t.Fatalf("retained devices after unplug = %#v", retained)
-	}
-}
-
 func TestManagerRefreshBuildsEC20Snapshot(t *testing.T) {
 	client := &transcriptClient{steps: []clientStep{
 		{
@@ -87,12 +27,6 @@ func TestManagerRefreshBuildsEC20Snapshot(t *testing.T) {
 		{command: "AT+QCCID", response: okResponse("+QCCID: 8986001234567890123F")},
 		{command: "AT+CIMI", response: okResponse("460001234567890")},
 		{command: "AT+CRSM=176,28486,0,0,17", response: okResponse(`+CRSM: 144,0,"00434D4343FFFFFFFFFFFFFFFFFFFFFFFF"`)},
-		{command: "AT+CRSM=192,28589,0,0,0", response: okResponse(`+CRSM: 144,0,"620680020004FFFF"`)},
-		{command: "AT+CRSM=176,28589,0,0,4", response: okResponse(`+CRSM: 144,0,"00000002"`)},
-		{command: "AT+CRSM=192,28478,0,0,0", response: okResponse(`+CRSM: 144,0,"620680020002FFFF"`)},
-		{command: "AT+CRSM=176,28478,0,0,2", response: okResponse(`+CRSM: 144,0,"0102"`)},
-		{command: "AT+CRSM=192,28479,0,0,0", response: okResponse(`+CRSM: 144,0,"620680020001FFFF"`)},
-		{command: "AT+CRSM=176,28479,0,0,1", response: okResponse(`+CRSM: 144,0,"FF"`)},
 		{command: "AT+CSQ", response: okResponse("+CSQ: 20,99")},
 		{
 			command: `AT+QENG="servingcell"`,
@@ -141,8 +75,7 @@ func TestManagerRefreshBuildsEC20Snapshot(t *testing.T) {
 	}
 	if snapshot.IMEI != "867123456789012" ||
 		snapshot.ICCID != "8986001234567890123" ||
-		snapshot.IMSI != "460001234567890" || snapshot.SPN != "CMCC" ||
-		snapshot.MNCLength != 2 || snapshot.GID1 != "0102" || snapshot.GID2 != "" {
+		snapshot.IMSI != "460001234567890" || snapshot.SPN != "CMCC" {
 		t.Fatalf("subscriber identifiers = %#v", snapshot)
 	}
 	if !snapshot.ModeKnown || snapshot.OperatingMode != 1 ||
@@ -164,59 +97,6 @@ func TestManagerRefreshBuildsEC20Snapshot(t *testing.T) {
 	client.assertDone(t)
 }
 
-func TestManagerRefreshReadsNativeWWANICCIDThroughQMIUIM(t *testing.T) {
-	client := &transcriptClient{steps: []clientStep{
-		{command: "ATI", response: okResponse("Qualcomm", "PCIe/MHI WWAN modem", "Revision: native-410")},
-		{command: "AT+CPIN?", response: okResponse("+CPIN: READY")},
-		{command: "AT+CCID", response: modem.Response{Final: "ERROR"}, err: errors.New("CCID unsupported")},
-		{command: "AT+QCCID", response: modem.Response{Final: "ERROR"}, err: errors.New("QCCID unsupported")},
-		{command: "AT+CIMI", response: okResponse("234159611274418")},
-		{command: "AT+CRSM=176,28486,0,0,17", response: okResponse(`+CRSM: 106,130,""`)},
-		{command: "AT+CRSM=192,28589,0,0,0", response: okResponse(`+CRSM: 106,130,""`)},
-		{command: "AT+CRSM=192,28478,0,0,0", response: okResponse(`+CRSM: 106,130,""`)},
-		{command: "AT+CRSM=192,28479,0,0,0", response: okResponse(`+CRSM: 106,130,""`)},
-		{command: "AT+CSQ", response: okResponse("+CSQ: 99,99")},
-		{command: `AT+QENG="servingcell"`, response: okResponse(`+QENG: "servingcell","SEARCH"`)},
-		{command: "AT+COPS?", response: okResponse("+COPS: 0")},
-		{command: "AT+CEREG?", response: okResponse("+CEREG: 0,2")},
-		{command: "AT+CGSN", response: okResponse("867123456789012")},
-		{command: "AT+CFUN?", response: okResponse("+CFUN: 1")},
-		{command: "AT+CNUM", response: okResponse(`+CNUM: "","+8613800138000",145`)},
-	}}
-	manager, err := NewManager(Options{
-		Discoverer: staticDiscoverer{candidates: []modem.Candidate{{
-			ID:               "mhi-wwan0",
-			Product:          "PCIe/MHI WWAN modem",
-			QMIControl:       "/dev/wwan0qmi0",
-			NetworkInterface: "wwan0",
-			ATPort:           modem.Port{Path: "/dev/wwan0at0", Name: "wwan0at0", Role: modem.PortRoleAT},
-		}}},
-		Opener: &staticOpener{client: client},
-	})
-	if err != nil {
-		t.Fatal(err)
-	}
-	if err := manager.Start(context.Background()); err != nil {
-		t.Fatal(err)
-	}
-	t.Cleanup(func() { _ = manager.Stop(context.Background()) })
-	manager.qmiRadioOpener = func(context.Context, string) (qmiRadioSession, error) {
-		return &fakeQMIRadioSession{iccid: "89441000400316034372"}, nil
-	}
-	if err := manager.SetBackend("mhi-wwan0", "qmi"); err != nil {
-		t.Fatal(err)
-	}
-
-	snapshot, err := manager.Refresh(context.Background(), "mhi-wwan0")
-	if err != nil {
-		t.Fatalf("Refresh: %v", err)
-	}
-	if snapshot.ICCID != "89441000400316034372" || !snapshot.SIMReady {
-		t.Fatalf("native QMI identity = %#v", snapshot)
-	}
-	client.assertDone(t)
-}
-
 func TestParseSPNASCIIAndUCS2(t *testing.T) {
 	if got := parseSPN(okResponse(`+CRSM: 144,0,"004C6562617261FFFFFFFFFFFFFFFFFFFF"`)); got != "Lebara" {
 		t.Fatalf("ASCII SPN = %q", got)
@@ -281,12 +161,6 @@ func TestManagerForcesRFOffBeforeInspectingChangedSIMNetwork(t *testing.T) {
 		{command: "AT+CFUN=4", response: okResponse()},
 		{command: "AT+CIMI", response: okResponse("234150000000002")},
 		{command: "AT+CRSM=176,28486,0,0,17", response: okResponse(`+CRSM: 144,0,"004C6562617261FFFFFFFFFFFFFFFFFFFF"`)},
-		{command: "AT+CRSM=192,28589,0,0,0", response: okResponse(`+CRSM: 144,0,"620680020004FFFF"`)},
-		{command: "AT+CRSM=176,28589,0,0,4", response: okResponse(`+CRSM: 144,0,"00000002"`)},
-		{command: "AT+CRSM=192,28478,0,0,0", response: okResponse(`+CRSM: 144,0,"620680020001FFFF"`)},
-		{command: "AT+CRSM=176,28478,0,0,1", response: okResponse(`+CRSM: 144,0,"FF"`)},
-		{command: "AT+CRSM=192,28479,0,0,0", response: okResponse(`+CRSM: 144,0,"620680020001FFFF"`)},
-		{command: "AT+CRSM=176,28479,0,0,1", response: okResponse(`+CRSM: 144,0,"FF"`)},
 		{command: "AT+CSQ", response: okResponse("+CSQ: 99,99")},
 		{command: `AT+QENG="servingcell"`, response: okResponse(`+QENG: "servingcell","SEARCH"`)},
 		{command: "AT+COPS?", response: okResponse("+COPS: 0")},

internal/device/region.go

@@ -22,13 +22,6 @@ var BlockedMCCs = map[string]string{
 // code. The MCC is the leading three digits and the MNC the following two or
 // three. Empty strings are returned for an unusable IMSI.
 func CardMCCMNC(imsi string) (mcc string, mnc string) {
-	return CardMCCMNCWithLength(imsi, 0)
-}
-
-// CardMCCMNCWithLength uses the MNC length advertised by EF_AD when available.
-// Without it the historical three-digit behavior is retained for callers that
-// have only an IMSI.
-func CardMCCMNCWithLength(imsi string, mncLength int) (mcc string, mnc string) {
 	digits := strings.TrimSpace(imsi)
 	if len(digits) < 5 ||
 		strings.IndexFunc(digits, func(r rune) bool { return !unicode.IsDigit(r) }) >= 0 {
@@ -36,11 +29,8 @@ func CardMCCMNCWithLength(imsi string, mncLength int) (mcc string, mnc string) {
 	}
 	mcc = digits[:3]
 	mnc = digits[3:]
-	if mncLength != 2 && mncLength != 3 {
-		mncLength = 3
-	}
-	if len(mnc) > mncLength {
-		mnc = mnc[:mncLength]
+	if len(mnc) > 3 {
+		mnc = mnc[:3]
 	}
 	return mcc, mnc
 }

internal/device/region_test.go

@@ -23,9 +23,6 @@ func TestCardMCCMNC(t *testing.T) {
 	if mcc, _ := CardMCCMNC("460001234567890"); mcc != "460" {
 		t.Fatalf("CardMCCMNC mcc = %q, want 460", mcc)
 	}
-	if mcc, mnc := CardMCCMNCWithLength("454006395879502", 2); mcc != "454" || mnc != "00" {
-		t.Fatalf("CardMCCMNCWithLength = (%q, %q), want (454, 00)", mcc, mnc)
-	}
 	for _, bad := range []string{"", "4600", "4600X1234"} {
 		if mcc, _ := CardMCCMNC(bad); mcc != "" {
 			t.Fatalf("CardMCCMNC(%q) mcc = %q, want empty", bad, mcc)

internal/device/registration_native_qmi.go

@@ -1,702 +0,0 @@
-package device
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"path/filepath"
-	"strconv"
-	"strings"
-	"time"
-
-	"github.com/iniwex5/quectel-qmi-go/pkg/qmi"
-
-	"vocat/internal/modem"
-)
-
-// nativeQMIRegistrationSession is the QMI NAS control surface used by
-// OpenStick WWAN devices.  It deliberately stays separate from
-// qmiRadioSession so AT-only devices and existing radio-control fakes do not
-// acquire a mandatory NAS implementation.
-type nativeQMIRegistrationSession interface {
-	qmiRadioSession
-	GetServingSystem(context.Context) (*qmi.ServingSystem, error)
-	GetSystemSelectionPreference(context.Context) (*qmi.SystemSelectionPreference, error)
-	SetSystemSelectionPreference(context.Context, qmi.SystemSelectionPreference) error
-	InitiateNetworkRegister(context.Context, qmi.NASInitiateNetworkRegisterRequest) error
-	ForceNetworkSearch(context.Context) error
-	AttachDetach(context.Context, bool) error
-}
-
-const (
-	nativeQMIRegistrationPollInterval               = 2 * time.Second
-	nativeQMIRegistrationMaxAttempts                = 45
-	nativeQMIRegistrationRadioCycleAfterAttempts    = 30
-	nativeQMIRegistrationUnsupportedCycleAfterTries = 3
-	nativeQMIRegistrationBackgroundTimeout          = 45 * time.Second
-)
-
-func isNativeQMICandidate(candidate modem.Candidate) bool {
-	deviceID := strings.TrimSpace(candidate.ID)
-	control := strings.TrimSpace(candidate.QMIControl)
-	return nativeQMIControlMatches(deviceID, control)
-}
-
-func nativeQMIControlMatches(deviceID, control string) bool {
-	deviceID = strings.TrimSpace(deviceID)
-	control = strings.TrimSpace(control)
-	if deviceID == "" || control == "" {
-		return false
-	}
-	prefix := ""
-	switch {
-	case strings.HasPrefix(deviceID, "wwan"):
-		prefix = deviceID + "qmi"
-	case strings.HasPrefix(deviceID, "mhi-wwan"):
-		prefix = "wwan" + strings.TrimPrefix(deviceID, "mhi-wwan") + "qmi"
-	default:
-		return false
-	}
-	return strings.HasPrefix(filepath.Base(control), prefix)
-}
-
-func (manager *Manager) openNativeQMIRegistration(
-	ctx context.Context,
-	candidate modem.Candidate,
-) (nativeQMIRegistrationSession, error) {
-	if manager == nil || manager.qmiRadioOpener == nil {
-		return nil, errors.New("QMI NAS registration is unavailable")
-	}
-	control := strings.TrimSpace(candidate.QMIControl)
-	if control == "" {
-		return nil, errors.New("QMI NAS registration control device is unavailable")
-	}
-	session, err := manager.qmiRadioOpener(ctx, control)
-	if err != nil {
-		return nil, err
-	}
-	nas, ok := session.(nativeQMIRegistrationSession)
-	if !ok {
-		_ = session.Close()
-		return nil, errors.New("QMI radio session does not expose NAS registration control")
-	}
-	return nas, nil
-}
-
-// startNativeQMIRegistrationReconcile continues registration after a radio
-// transition. Bringing DMS online only proves that the RF switch completed;
-// NAS may still report searching or PS detached seconds later, so the
-// registration sequence continues after SetFlight returns. The per-device
-// guard prevents repeated UI/poll callbacks from opening competing sessions.
-func (manager *Manager) startNativeQMIRegistrationReconcile(id string) bool {
-	if manager == nil {
-		return false
-	}
-	state, err := manager.lookup(id)
-	if err != nil {
-		return false
-	}
-	candidate := manager.candidateFor(state)
-	if !isNativeQMICandidate(candidate) {
-		return false
-	}
-	manager.nativeQMIRegistrationMu.Lock()
-	if _, running := manager.nativeQMIRegistrationInFlight[id]; running {
-		manager.nativeQMIRegistrationMu.Unlock()
-		return false
-	}
-	manager.nativeQMIRegistrationInFlight[id] = struct{}{}
-	manager.nativeQMIRegistrationMu.Unlock()
-	go func() {
-		defer func() {
-			manager.nativeQMIRegistrationMu.Lock()
-			delete(manager.nativeQMIRegistrationInFlight, id)
-			manager.nativeQMIRegistrationMu.Unlock()
-		}()
-		ctx, cancel := context.WithTimeout(context.Background(), nativeQMIRegistrationBackgroundTimeout)
-		defer cancel()
-		_, _ = manager.ReRegisterOperator(ctx, id)
-	}()
-	return true
-}
-
-func qmiOperatorSelectionFromPreference(pref *qmi.SystemSelectionPreference) (OperatorSelection, error) {
-	if pref == nil {
-		return OperatorSelection{}, errors.New("QMI returned an empty system-selection preference")
-	}
-	accessTechnology := qmiAccessTechnologyFromModePreference(pref.ModePreference)
-	if pref.HasManualNetworkSelection {
-		mcc := fmt.Sprintf("%03d", pref.ManualNetworkSelection.MCC)
-		mncWidth := 2
-		if pref.ManualNetworkSelection.IncludesPCSDigit {
-			mncWidth = 3
-		}
-		mnc := fmt.Sprintf("%0*d", mncWidth, pref.ManualNetworkSelection.MNC)
-		return OperatorSelection{
-			Mode:             1,
-			Format:           2,
-			Operator:         mcc + mnc,
-			AccessTechnology: accessTechnology,
-		}, nil
-	}
-	return OperatorSelection{Mode: 0, AccessTechnology: accessTechnology}, nil
-}
-
-func qmiManualRegisterRequest(
-	plmn string,
-	accessTechnologyValue *int,
-) (qmi.NASInitiateNetworkRegisterRequest, error) {
-	mcc, mnc, includesPCSDigit, err := qmiPLMNParts(plmn)
-	if err != nil {
-		return qmi.NASInitiateNetworkRegisterRequest{}, err
-	}
-	rat := uint8(0)
-	if accessTechnologyValue != nil {
-		if *accessTechnologyValue < 0 || *accessTechnologyValue > 9 {
-			return qmi.NASInitiateNetworkRegisterRequest{}, errors.New("invalid operator access technology")
-		}
-		rat = qmiRATFromATCode(*accessTechnologyValue)
-		if rat == 0 {
-			return qmi.NASInitiateNetworkRegisterRequest{}, errors.New("unsupported operator access technology")
-		}
-	}
-	return qmi.NASInitiateNetworkRegisterRequest{
-		Mode:              qmi.NASNetworkRegisterManual,
-		MCC:               mcc,
-		MNC:               mnc,
-		IncludesPCSDigit:  includesPCSDigit,
-		RadioAccessTech:   rat,
-		ChangeDuration:    qmi.NASChangeDurationPermanent,
-		HasChangeDuration: true,
-	}, nil
-}
-
-func qmiPLMNParts(plmn string) (mcc, mnc uint16, includesPCSDigit bool, err error) {
-	plmn = strings.TrimSpace(plmn)
-	if !decimalPLMN(plmn) {
-		return 0, 0, false, errors.New("operator PLMN must contain 5 or 6 digits")
-	}
-	mccValue, parseErr := strconv.ParseUint(plmn[:3], 10, 16)
-	if parseErr != nil {
-		return 0, 0, false, fmt.Errorf("parse operator MCC: %w", parseErr)
-	}
-	mncValue, parseErr := strconv.ParseUint(plmn[3:], 10, 16)
-	if parseErr != nil {
-		return 0, 0, false, fmt.Errorf("parse operator MNC: %w", parseErr)
-	}
-	return uint16(mccValue), uint16(mncValue), len(plmn) == 6, nil
-}
-
-func qmiManualSelectionPreference(plmn string) (qmi.SystemSelectionPreference, qmi.ManualNetworkSelection, error) {
-	return qmiManualSelectionPreferenceWithRAT(plmn, nil)
-}
-
-func qmiManualSelectionPreferenceWithRAT(
-	plmn string,
-	accessTechnologyValue *int,
-) (qmi.SystemSelectionPreference, qmi.ManualNetworkSelection, error) {
-	mcc, mnc, includesPCSDigit, err := qmiPLMNParts(plmn)
-	if err != nil {
-		return qmi.SystemSelectionPreference{}, qmi.ManualNetworkSelection{}, err
-	}
-	selection := qmi.ManualNetworkSelection{
-		MCC:              mcc,
-		MNC:              mnc,
-		IncludesPCSDigit: includesPCSDigit,
-	}
-	pref := qmi.SystemSelectionPreference{
-		NetworkSelectionPreference:    qmi.NASNetworkSelectionManual,
-		HasNetworkSelectionPreference: true,
-		ManualNetworkSelection:        selection,
-		HasManualNetworkSelection:     true,
-		ChangeDuration:                qmi.NASChangeDurationPermanent,
-		HasChangeDuration:             true,
-	}
-	if accessTechnologyValue != nil {
-		modePreference, ok := qmiModePreferenceFromATCode(*accessTechnologyValue)
-		if !ok {
-			return qmi.SystemSelectionPreference{}, qmi.ManualNetworkSelection{}, errors.New("unsupported operator access technology")
-		}
-		pref.ModePreference = modePreference
-		pref.HasModePreference = true
-	}
-	return pref, selection, nil
-}
-
-func qmiRATFromATCode(value int) uint8 {
-	switch value {
-	case 0, 3: // GSM / EDGE
-		return 0x04
-	case 2, 4, 5, 6: // UTRAN / HSDPA / HSUPA / HSPA
-		return 0x05
-	case 7: // LTE
-		return 0x08
-	case 9: // NR5G
-		return 0x0C
-	default:
-		return 0
-	}
-}
-
-func qmiModePreferenceFromATCode(value int) (uint16, bool) {
-	switch value {
-	case 0, 3: // GSM / EDGE
-		return qmi.NASRatModePreferenceGSM, true
-	case 2, 4, 5, 6: // UTRAN / HSDPA / HSUPA / HSPA
-		return qmi.NASRatModePreferenceUMTS, true
-	case 7: // LTE
-		return qmi.NASRatModePreferenceLTE, true
-	case 9: // NR5G
-		return qmi.NASRatModePreferenceNR5G, true
-	default:
-		return 0, false
-	}
-}
-
-func qmiRATFromServingRadioInterface(value uint8) uint8 {
-	switch value {
-	case 4, 5, 8:
-		return value
-	case 10: // NAS serving-system NR5G value
-		return 0x0C
-	default:
-		return 0
-	}
-}
-
-func qmiRATFromModePreference(value uint16) uint8 {
-	switch {
-	case value&qmi.NASRatModePreferenceNR5G != 0:
-		return 0x0C
-	case value&qmi.NASRatModePreferenceLTE != 0:
-		return 0x08
-	case value&qmi.NASRatModePreferenceUMTS != 0:
-		return 0x05
-	case value&qmi.NASRatModePreferenceGSM != 0:
-		return 0x04
-	default:
-		return 0
-	}
-}
-
-func qmiAccessTechnologyFromModePreference(value uint16) string {
-	switch {
-	case value&qmi.NASRatModePreferenceNR5G != 0:
-		return "NR5G"
-	case value&qmi.NASRatModePreferenceLTE != 0:
-		return "LTE"
-	case value&qmi.NASRatModePreferenceUMTS != 0:
-		return "UTRAN"
-	case value&qmi.NASRatModePreferenceGSM != 0:
-		return "GSM"
-	default:
-		return ""
-	}
-}
-
-func qmiRegistrationRequestAutomatic() qmi.NASInitiateNetworkRegisterRequest {
-	return qmi.NASInitiateNetworkRegisterRequest{
-		Mode:              qmi.NASNetworkRegisterAutomatic,
-		ChangeDuration:    qmi.NASChangeDurationPermanent,
-		HasChangeDuration: true,
-	}
-}
-
-func qmiSelectionAutomaticPreference() qmi.SystemSelectionPreference {
-	return qmi.SystemSelectionPreference{
-		NetworkSelectionPreference:    qmi.NASNetworkSelectionAutomatic,
-		HasNetworkSelectionPreference: true,
-		ChangeDuration:                qmi.NASChangeDurationPermanent,
-		HasChangeDuration:             true,
-	}
-}
-
-func isUnsupportedQMIRegistrationCommand(err error, messageID uint16) bool {
-	qmiErr := qmi.GetQMIError(err)
-	if qmiErr == nil || qmiErr.Service != qmi.ServiceNAS || qmiErr.MessageID != messageID {
-		return false
-	}
-	switch qmiErr.ErrorCode {
-	case qmi.QMIErrMalformedMsg,
-		qmi.QMIErrInvalidRegisterAction,
-		qmi.QMIErrNoEffect,
-		qmi.QMIErrNotSupported,
-		qmi.QMIErrInvalidQmiCmd,
-		qmi.QMIErrOpDeviceUnsupported:
-		return true
-	default:
-		return false
-	}
-}
-
-func isUnsupportedQMIForceSearch(err error) bool {
-	qmiErr := qmi.GetQMIError(err)
-	if qmiErr == nil || qmiErr.Service != qmi.ServiceNAS || qmiErr.MessageID != qmi.NASForceNetworkSearch {
-		return false
-	}
-	return qmiErr.ErrorCode == qmi.QMIErrNotSupported ||
-		qmiErr.ErrorCode == qmi.QMIErrInvalidQmiCmd ||
-		qmiErr.ErrorCode == qmi.QMIErrOpDeviceUnsupported
-}
-
-func isUnsupportedQMISelectionCommand(err error) bool {
-	qmiErr := qmi.GetQMIError(err)
-	if qmiErr == nil || qmiErr.Service != qmi.ServiceNAS || qmiErr.MessageID != qmi.NASSetSystemSelectionPreference {
-		return false
-	}
-	switch qmiErr.ErrorCode {
-	case qmi.QMIErrMalformedMsg,
-		qmi.QMIErrInvalidRegisterAction,
-		qmi.QMIErrNoEffect,
-		qmi.QMIErrNotSupported,
-		qmi.QMIErrInvalidQmiCmd,
-		qmi.QMIErrOpDeviceUnsupported:
-		return true
-	default:
-		return false
-	}
-}
-
-func qmiRegistrationStateRegistered(state qmi.RegistrationState) bool {
-	return state == qmi.RegStateRegistered || state == qmi.RegStateRoaming
-}
-
-func nativeQMIRegistrationRadioCycleThreshold(forceSearchUnsupported bool) int {
-	if forceSearchUnsupported {
-		return nativeQMIRegistrationUnsupportedCycleAfterTries
-	}
-	return nativeQMIRegistrationRadioCycleAfterAttempts
-}
-
-// triggerNativeQMIManualRegistration applies the manual preference that was
-// written by the caller and starts a fresh NAS search.  On the OpenStick 410
-// firmware, NAS_FORCE_NETWORK_SEARCH is the reliable trigger; sending
-// NAS_INITIATE_NETWORK_REGISTER with RadioAccessTech=0 is rejected as an
-// invalid profile.  Older firmware may not expose force-search, so fall back
-// to an explicit RAT (or the current serving RAT) when that command is not
-// supported.
-func triggerNativeQMIManualRegistration(
-	ctx context.Context,
-	session nativeQMIRegistrationSession,
-	request *qmi.NASInitiateNetworkRegisterRequest,
-	serving *qmi.ServingSystem,
-) (forceSearchIssued bool, forceSearchUnsupported bool, err error) {
-	if request == nil {
-		return false, false, errors.New("QMI manual registration request is unavailable")
-	}
-	if err := session.ForceNetworkSearch(ctx); err == nil {
-		return true, false, nil
-	} else if !isUnsupportedQMIForceSearch(err) {
-		return false, false, fmt.Errorf("force QMI network search: %w", err)
-	}
-
-	forceSearchUnsupported = true
-	if request.RadioAccessTech == 0 && serving != nil {
-		request.RadioAccessTech = qmiRATFromServingRadioInterface(serving.RadioInterface)
-	}
-	if request.RadioAccessTech == 0 {
-		return false, true, errors.New("QMI manual registration requires a supported radio access technology")
-	}
-	if err := session.InitiateNetworkRegister(ctx, *request); err != nil {
-		return false, true, fmt.Errorf("initiate manual QMI network registration: %w", err)
-	}
-	return false, true, nil
-}
-
-// ensureNativeQMIRegistration runs the NAS registration sequence used on
-// OpenStick.  The modem's AT+COPS surface on this firmware only changes
-// presentation; it does not reliably drive this NAS state machine.
-func ensureNativeQMIRegistration(
-	ctx context.Context,
-	session nativeQMIRegistrationSession,
-	request qmi.NASInitiateNetworkRegisterRequest,
-	setAutomatic bool,
-) error {
-	return ensureNativeQMIRegistrationForTarget(ctx, session, request, setAutomatic, nil)
-}
-
-// ensureNativeQMIRegistrationForTarget is the manual-lock variant of the
-// registration sequence. A modem can remain registered on the old PLMN while
-// it processes a new manual request, so a successful registered/PS-attached
-// state is only authoritative when it is on the requested PLMN.
-func ensureNativeQMIRegistrationForTarget(
-	ctx context.Context,
-	session nativeQMIRegistrationSession,
-	request qmi.NASInitiateNetworkRegisterRequest,
-	setAutomatic bool,
-	target *qmi.ManualNetworkSelection,
-) error {
-	if ctx == nil {
-		ctx = context.Background()
-	}
-	if session == nil {
-		return errors.New("QMI NAS registration session is unavailable")
-	}
-	if request.Mode == 0 {
-		request = qmiRegistrationRequestAutomatic()
-	}
-
-	mode, err := session.GetOperatingMode(ctx)
-	if err != nil {
-		return fmt.Errorf("read QMI operating mode: %w", err)
-	}
-	if mode == qmi.ModeLowPower || mode == qmi.ModeOffline || mode == qmi.ModeShutdown || mode == qmi.ModeReset {
-		if err := session.SetOperatingMode(ctx, qmi.ModeOnline); err != nil {
-			return fmt.Errorf("restore QMI online mode: %w", err)
-		}
-		if err := waitNativeQMIRegistration(ctx); err != nil {
-			return fmt.Errorf("wait for QMI online mode: %w", err)
-		}
-		mode, err = session.GetOperatingMode(ctx)
-		if err != nil {
-			return fmt.Errorf("recheck QMI operating mode: %w", err)
-		}
-		if mode == qmi.ModeLowPower || mode == qmi.ModeOffline || mode == qmi.ModeShutdown || mode == qmi.ModeReset {
-			return fmt.Errorf("QMI operating mode remained non-online after recovery: %d", mode)
-		}
-	}
-
-	if setAutomatic {
-		if err := session.SetSystemSelectionPreference(ctx, qmiSelectionAutomaticPreference()); err != nil {
-			// Some OpenStick firmware accepts the preference but reports an
-			// unsupported result for an optional NAS TLV. The explicit NAS register
-			// below remains the authoritative trigger.
-			if !isUnsupportedQMISelectionCommand(err) {
-				return fmt.Errorf("restore automatic QMI NAS selection: %w", err)
-			}
-		}
-	}
-	registerIssued := false
-	forceSearchIssued := false
-	radioCycleIssued := false
-	forceSearchUnsupported := false
-	manualTarget := target != nil && request.Mode == qmi.NASNetworkRegisterManual
-	for attempt := 1; attempt <= nativeQMIRegistrationMaxAttempts; attempt++ {
-		serving, servingErr := session.GetServingSystem(ctx)
-		if servingErr != nil {
-			if err := waitNativeQMIRegistration(ctx); err != nil {
-				return fmt.Errorf("read QMI serving system: %w", servingErr)
-			}
-			continue
-		}
-		if serving == nil {
-			return errors.New("QMI serving system returned no data")
-		}
-		if qmiRegistrationStateRegistered(serving.RegistrationState) {
-			if target == nil || qmiServingSystemMatchesTarget(serving, *target) {
-				if serving.PSAttached {
-					return nil
-				}
-				if err := session.AttachDetach(ctx, true); err != nil {
-					return fmt.Errorf("attach QMI packet service: %w", err)
-				}
-			} else if !registerIssued {
-				if manualTarget {
-					var triggerErr error
-					forceSearchIssued, forceSearchUnsupported, triggerErr = triggerNativeQMIManualRegistration(
-						ctx, session, &request, serving,
-					)
-					if triggerErr != nil {
-						return triggerErr
-					}
-				} else if err := session.InitiateNetworkRegister(ctx, request); err != nil {
-					return fmt.Errorf("initiate QMI network registration: %w", err)
-				}
-				registerIssued = true
-			}
-		} else if serving.RegistrationState == qmi.RegStateDenied {
-			return errors.New("QMI network registration was denied")
-		} else if !registerIssued {
-			if manualTarget {
-				var triggerErr error
-				forceSearchIssued, forceSearchUnsupported, triggerErr = triggerNativeQMIManualRegistration(
-					ctx, session, &request, serving,
-				)
-				if triggerErr != nil {
-					return triggerErr
-				}
-			} else if err := session.InitiateNetworkRegister(ctx, request); err != nil {
-				if !(setAutomatic && isUnsupportedQMIRegistrationCommand(err, qmi.NASInitiateNetworkRegister)) {
-					return fmt.Errorf("initiate QMI network registration: %w", err)
-				}
-			}
-			registerIssued = true
-		}
-
-		searching := serving.RegistrationState == qmi.RegStateSearching
-		if target != nil && qmiRegistrationStateRegistered(serving.RegistrationState) && !qmiServingSystemMatchesTarget(serving, *target) {
-			searching = true
-		}
-		if searching && registerIssued && !forceSearchIssued && !forceSearchUnsupported && attempt >= 2 {
-			forceSearchIssued = true
-			if err := session.ForceNetworkSearch(ctx); err != nil {
-				if isUnsupportedQMIForceSearch(err) {
-					forceSearchUnsupported = true
-				} else {
-					return fmt.Errorf("force QMI network search: %w", err)
-				}
-			}
-		}
-		radioCycleAfter := nativeQMIRegistrationRadioCycleThreshold(forceSearchUnsupported)
-		if searching && registerIssued && !radioCycleIssued && attempt >= radioCycleAfter {
-			radioCycleIssued = true
-			if err := session.SetOperatingMode(ctx, qmi.ModeLowPower); err == nil {
-				_ = waitNativeQMIRegistration(ctx)
-				_ = session.SetOperatingMode(ctx, qmi.ModeOnline)
-				registerIssued = false
-			}
-		}
-		if err := waitNativeQMIRegistration(ctx); err != nil {
-			return err
-		}
-	}
-	return fmt.Errorf("QMI network registration/PS attach timed out after %d attempts", nativeQMIRegistrationMaxAttempts)
-}
-
-func qmiServingSystemMatchesTarget(serving *qmi.ServingSystem, target qmi.ManualNetworkSelection) bool {
-	return serving != nil && serving.MCC == target.MCC && serving.MNC == target.MNC
-}
-
-func waitNativeQMIRegistration(ctx context.Context) error {
-	timer := time.NewTimer(nativeQMIRegistrationPollInterval)
-	defer timer.Stop()
-	select {
-	case <-ctx.Done():
-		return ctx.Err()
-	case <-timer.C:
-		return nil
-	}
-}
-
-func (manager *Manager) nativeQMIOperatorSelectionLocked(
-	ctx context.Context,
-	candidate modem.Candidate,
-) (OperatorSelection, error) {
-	session, err := manager.openNativeQMIRegistration(ctx, candidate)
-	if err != nil {
-		return OperatorSelection{}, fmt.Errorf("open QMI NAS operator selection: %w", err)
-	}
-	defer session.Close()
-	pref, err := session.GetSystemSelectionPreference(ctx)
-	if err != nil {
-		return OperatorSelection{}, fmt.Errorf("read QMI system selection preference: %w", err)
-	}
-	return qmiOperatorSelectionFromPreference(pref)
-}
-
-func (manager *Manager) setNativeQMIOperatorSelectionLocked(
-	ctx context.Context,
-	candidate modem.Candidate,
-	automatic bool,
-	plmn string,
-	accessTechnologyValue *int,
-) (OperatorSelection, error) {
-	session, err := manager.openNativeQMIRegistration(ctx, candidate)
-	if err != nil {
-		return OperatorSelection{}, fmt.Errorf("open QMI NAS operator selection: %w", err)
-	}
-	defer session.Close()
-
-	if automatic {
-		request := qmiRegistrationRequestAutomatic()
-		if err := ensureNativeQMIRegistration(ctx, session, request, true); err != nil {
-			return OperatorSelection{}, err
-		}
-		pref, err := session.GetSystemSelectionPreference(ctx)
-		if err != nil {
-			return OperatorSelection{}, fmt.Errorf("read QMI system selection preference: %w", err)
-		}
-		return qmiOperatorSelectionFromPreference(pref)
-	}
-	request, err := qmiManualRegisterRequest(plmn, accessTechnologyValue)
-	if err != nil {
-		return OperatorSelection{}, err
-	}
-	preference, target, err := qmiManualSelectionPreferenceWithRAT(plmn, accessTechnologyValue)
-	if err != nil {
-		return OperatorSelection{}, err
-	}
-	// InitiateNetworkRegister is only a one-shot trigger on this firmware. The
-	// manual preference must be written separately or the next reconcile will
-	// read automatic selection and undo the requested lock.
-	if err := session.SetSystemSelectionPreference(ctx, preference); err != nil {
-		return OperatorSelection{}, fmt.Errorf("set manual QMI network selection: %w", err)
-	}
-	if err := ensureNativeQMIRegistrationForTarget(ctx, session, request, false, &target); err != nil {
-		manager.restoreNativeQMISelectionAfterFailure(session, candidate.ID)
-		return OperatorSelection{}, err
-	}
-	actual, err := session.GetSystemSelectionPreference(ctx)
-	if err != nil {
-		manager.restoreNativeQMISelectionAfterFailure(session, candidate.ID)
-		return OperatorSelection{}, fmt.Errorf("verify manual QMI network selection: %w", err)
-	}
-	if actual == nil || !actual.HasManualNetworkSelection || actual.ManualNetworkSelection != target {
-		manager.restoreNativeQMISelectionAfterFailure(session, candidate.ID)
-		return OperatorSelection{}, fmt.Errorf("modem did not retain manual PLMN %s", strings.TrimSpace(plmn))
-	}
-	return qmiOperatorSelectionFromPreference(actual)
-}
-
-// restoreNativeQMISelectionAfterFailure prevents a failed manual lock from
-// leaving the modem in a searching/manual state.  The caller may already have
-// exhausted its request deadline, so rollback uses a fresh bounded context and
-// schedules the normal background reconcile as a second line of defence.
-func (manager *Manager) restoreNativeQMISelectionAfterFailure(
-	session nativeQMIRegistrationSession,
-	deviceID string,
-) {
-	if manager == nil || session == nil {
-		return
-	}
-	rollbackCtx, cancel := context.WithTimeout(context.Background(), manager.longTimeout)
-	defer cancel()
-	_ = session.SetSystemSelectionPreference(rollbackCtx, qmiSelectionAutomaticPreference())
-	_ = session.InitiateNetworkRegister(rollbackCtx, qmiRegistrationRequestAutomatic())
-	_ = session.ForceNetworkSearch(rollbackCtx)
-	if strings.TrimSpace(deviceID) != "" {
-		manager.startNativeQMIRegistrationReconcile(deviceID)
-	}
-}
-
-func (manager *Manager) reRegisterNativeQMIOperatorLocked(
-	ctx context.Context,
-	candidate modem.Candidate,
-) (OperatorSelection, error) {
-	session, err := manager.openNativeQMIRegistration(ctx, candidate)
-	if err != nil {
-		return OperatorSelection{}, fmt.Errorf("open QMI NAS re-registration: %w", err)
-	}
-	defer session.Close()
-	pref, err := session.GetSystemSelectionPreference(ctx)
-	if err != nil {
-		return OperatorSelection{}, fmt.Errorf("read QMI system selection preference: %w", err)
-	}
-	request := qmiRegistrationRequestAutomatic()
-	setAutomatic := true
-	selection := OperatorSelection{Mode: 0}
-	if pref != nil && pref.HasManualNetworkSelection {
-		setAutomatic = false
-		request.Mode = qmi.NASNetworkRegisterManual
-		request.MCC = pref.ManualNetworkSelection.MCC
-		request.MNC = pref.ManualNetworkSelection.MNC
-		request.IncludesPCSDigit = pref.ManualNetworkSelection.IncludesPCSDigit
-		request.ChangeDuration = qmi.NASChangeDurationPermanent
-		request.HasChangeDuration = true
-		if pref.HasModePreference {
-			request.RadioAccessTech = qmiRATFromModePreference(pref.ModePreference)
-		}
-		selection, err = qmiOperatorSelectionFromPreference(pref)
-		if err != nil {
-			return OperatorSelection{}, err
-		}
-	}
-	var target *qmi.ManualNetworkSelection
-	if pref != nil && pref.HasManualNetworkSelection {
-		target = &pref.ManualNetworkSelection
-	}
-	if err := ensureNativeQMIRegistrationForTarget(ctx, session, request, setAutomatic, target); err != nil {
-		return OperatorSelection{}, err
-	}
-	return selection, nil
-}

internal/device/registration_native_qmi_test.go

@@ -1,271 +0,0 @@
-package device
-
-import (
-	"context"
-	"testing"
-
-	"github.com/iniwex5/quectel-qmi-go/pkg/qmi"
-
-	"vocat/internal/modem"
-)
-
-type fakeNativeQMIRegistrationSession struct {
-	mode             qmi.OperatingMode
-	serving          []*qmi.ServingSystem
-	selection        *qmi.SystemSelectionPreference
-	setModes         []qmi.OperatingMode
-	setPreferences   []qmi.SystemSelectionPreference
-	registerRequests []qmi.NASInitiateNetworkRegisterRequest
-	forceSearches    int
-	forceSearchErr   error
-	registerErr      error
-	attachRequests   []bool
-	closeCount       int
-}
-
-func (session *fakeNativeQMIRegistrationSession) GetOperatingMode(context.Context) (qmi.OperatingMode, error) {
-	return session.mode, nil
-}
-
-func (session *fakeNativeQMIRegistrationSession) SetOperatingMode(_ context.Context, mode qmi.OperatingMode) error {
-	session.mode = mode
-	session.setModes = append(session.setModes, mode)
-	return nil
-}
-
-func (session *fakeNativeQMIRegistrationSession) Close() error {
-	session.closeCount++
-	return nil
-}
-
-func (session *fakeNativeQMIRegistrationSession) GetServingSystem(context.Context) (*qmi.ServingSystem, error) {
-	if len(session.serving) == 0 {
-		return &qmi.ServingSystem{RegistrationState: qmi.RegStateSearching}, nil
-	}
-	current := session.serving[0]
-	if len(session.serving) > 1 {
-		session.serving = session.serving[1:]
-	}
-	return current, nil
-}
-
-func (session *fakeNativeQMIRegistrationSession) GetSystemSelectionPreference(context.Context) (*qmi.SystemSelectionPreference, error) {
-	if session.selection == nil {
-		return &qmi.SystemSelectionPreference{}, nil
-	}
-	return session.selection, nil
-}
-
-func (session *fakeNativeQMIRegistrationSession) SetSystemSelectionPreference(_ context.Context, pref qmi.SystemSelectionPreference) error {
-	session.selection = &pref
-	session.setPreferences = append(session.setPreferences, pref)
-	return nil
-}
-
-func (session *fakeNativeQMIRegistrationSession) InitiateNetworkRegister(_ context.Context, req qmi.NASInitiateNetworkRegisterRequest) error {
-	session.registerRequests = append(session.registerRequests, req)
-	return session.registerErr
-}
-
-func (session *fakeNativeQMIRegistrationSession) ForceNetworkSearch(context.Context) error {
-	session.forceSearches++
-	return session.forceSearchErr
-}
-
-func (session *fakeNativeQMIRegistrationSession) AttachDetach(_ context.Context, attached bool) error {
-	session.attachRequests = append(session.attachRequests, attached)
-	return nil
-}
-
-func TestEnsureNativeQMIRegistrationDrivesNASSequence(t *testing.T) {
-	session := &fakeNativeQMIRegistrationSession{
-		mode: qmi.ModeLowPower,
-		serving: []*qmi.ServingSystem{
-			{RegistrationState: qmi.RegStateSearching},
-			{RegistrationState: qmi.RegStateSearching},
-			{RegistrationState: qmi.RegStateRegistered, PSAttached: false},
-			{RegistrationState: qmi.RegStateRegistered, PSAttached: true},
-		},
-	}
-
-	if err := ensureNativeQMIRegistration(context.Background(), session, qmiRegistrationRequestAutomatic(), true); err != nil {
-		t.Fatalf("ensure native QMI registration: %v", err)
-	}
-	if len(session.setModes) != 1 || session.setModes[0] != qmi.ModeOnline {
-		t.Fatalf("operating mode writes = %#v, want [online]", session.setModes)
-	}
-	if len(session.setPreferences) != 1 || !session.setPreferences[0].HasNetworkSelectionPreference ||
-		session.setPreferences[0].NetworkSelectionPreference != qmi.NASNetworkSelectionAutomatic {
-		t.Fatalf("selection writes = %#v, want automatic", session.setPreferences)
-	}
-	if len(session.registerRequests) != 1 || session.registerRequests[0].Mode != qmi.NASNetworkRegisterAutomatic {
-		t.Fatalf("registration requests = %#v, want one automatic request", session.registerRequests)
-	}
-	if session.forceSearches != 1 {
-		t.Fatalf("force-search count = %d, want 1", session.forceSearches)
-	}
-	if len(session.attachRequests) != 1 || !session.attachRequests[0] {
-		t.Fatalf("attach requests = %#v, want one attach", session.attachRequests)
-	}
-}
-
-func TestQMIManualRegisterRequestMapsPLMNAndRAT(t *testing.T) {
-	rat := 7
-	request, err := qmiManualRegisterRequest("46001", &rat)
-	if err != nil {
-		t.Fatalf("manual request: %v", err)
-	}
-	if request.Mode != qmi.NASNetworkRegisterManual || request.MCC != 460 || request.MNC != 1 ||
-		request.IncludesPCSDigit || request.RadioAccessTech != 0x08 || !request.HasChangeDuration ||
-		request.ChangeDuration != qmi.NASChangeDurationPermanent {
-		t.Fatalf("manual request = %#v", request)
-	}
-}
-
-func TestQMIManualSelectionPreferenceMapsPLMN(t *testing.T) {
-	pref, selection, err := qmiManualSelectionPreference("46001")
-	if err != nil {
-		t.Fatalf("manual preference: %v", err)
-	}
-	if pref.NetworkSelectionPreference != qmi.NASNetworkSelectionManual ||
-		!pref.HasNetworkSelectionPreference || !pref.HasManualNetworkSelection ||
-		!pref.HasChangeDuration || pref.ChangeDuration != qmi.NASChangeDurationPermanent {
-		t.Fatalf("manual preference = %#v", pref)
-	}
-	if selection.MCC != 460 || selection.MNC != 1 || selection.IncludesPCSDigit {
-		t.Fatalf("manual selection = %#v", selection)
-	}
-}
-
-func TestQMIManualSelectionPreferenceMapsRAT(t *testing.T) {
-	rat := 7
-	pref, _, err := qmiManualSelectionPreferenceWithRAT("46001", &rat)
-	if err != nil {
-		t.Fatalf("manual preference: %v", err)
-	}
-	if !pref.HasModePreference || pref.ModePreference != qmi.NASRatModePreferenceLTE {
-		t.Fatalf("manual preference mode = %#v, want LTE mode preference", pref)
-	}
-}
-
-func TestQMIManualRegisterRequestRejectsUnknownRAT(t *testing.T) {
-	rat := 1
-	if _, err := qmiManualRegisterRequest("46001", &rat); err == nil {
-		t.Fatal("manual request with unknown RAT must fail")
-	}
-}
-
-func TestEnsureNativeQMIRegistrationWaitsForManualTarget(t *testing.T) {
-	session := &fakeNativeQMIRegistrationSession{
-		mode: qmi.ModeOnline,
-		serving: []*qmi.ServingSystem{
-			{RegistrationState: qmi.RegStateRegistered, PSAttached: true, MCC: 460, MNC: 0},
-			{RegistrationState: qmi.RegStateSearching},
-			{RegistrationState: qmi.RegStateRegistered, PSAttached: false, MCC: 460, MNC: 1},
-			{RegistrationState: qmi.RegStateRegistered, PSAttached: true, MCC: 460, MNC: 1},
-		},
-	}
-	request, err := qmiManualRegisterRequest("46001", nil)
-	if err != nil {
-		t.Fatalf("manual request: %v", err)
-	}
-	target := qmi.ManualNetworkSelection{MCC: 460, MNC: 1}
-	if err := ensureNativeQMIRegistrationForTarget(context.Background(), session, request, false, &target); err != nil {
-		t.Fatalf("ensure manual registration: %v", err)
-	}
-	if len(session.registerRequests) != 0 {
-		t.Fatalf("registration requests = %#v, want force-search-only manual trigger", session.registerRequests)
-	}
-	if session.forceSearches != 1 {
-		t.Fatalf("force-search count = %d, want 1", session.forceSearches)
-	}
-	if len(session.attachRequests) != 1 || !session.attachRequests[0] {
-		t.Fatalf("attach requests = %#v, want one attach", session.attachRequests)
-	}
-}
-
-func TestEnsureNativeQMIRegistrationFallsBackWhenForceSearchUnsupported(t *testing.T) {
-	session := &fakeNativeQMIRegistrationSession{
-		serving: []*qmi.ServingSystem{
-			{RegistrationState: qmi.RegStateRegistered, PSAttached: true, RadioInterface: 8, MCC: 460, MNC: 0},
-			{RegistrationState: qmi.RegStateSearching},
-			{RegistrationState: qmi.RegStateRegistered, PSAttached: false, MCC: 460, MNC: 1},
-			{RegistrationState: qmi.RegStateRegistered, PSAttached: true, MCC: 460, MNC: 1},
-		},
-		forceSearchErr: &qmi.QMIError{
-			Service: qmi.ServiceNAS, MessageID: qmi.NASForceNetworkSearch,
-			Result: 0x0001, ErrorCode: qmi.QMIErrNotSupported,
-		},
-	}
-	request, err := qmiManualRegisterRequest("46001", nil)
-	if err != nil {
-		t.Fatalf("manual request: %v", err)
-	}
-	target := qmi.ManualNetworkSelection{MCC: 460, MNC: 1}
-	if err := ensureNativeQMIRegistrationForTarget(context.Background(), session, request, false, &target); err != nil {
-		t.Fatalf("ensure manual registration: %v", err)
-	}
-	if len(session.registerRequests) != 1 || session.registerRequests[0].RadioAccessTech != 8 {
-		t.Fatalf("registration requests = %#v, want one LTE fallback request", session.registerRequests)
-	}
-	if session.forceSearches != 1 {
-		t.Fatalf("force-search count = %d, want one unsupported attempt", session.forceSearches)
-	}
-}
-
-func TestNativeQMIRegistrationCyclesEarlyWhenForceSearchUnsupported(t *testing.T) {
-	if got := nativeQMIRegistrationRadioCycleThreshold(true); got != 3 {
-		t.Fatalf("unsupported force-search threshold = %d, want 3", got)
-	}
-	if got := nativeQMIRegistrationRadioCycleThreshold(false); got != 30 {
-		t.Fatalf("supported force-search threshold = %d, want 30", got)
-	}
-}
-
-func TestIsNativeQMICandidateRequiresOpenStickWWANPair(t *testing.T) {
-	tests := []struct {
-		name      string
-		candidate modem.Candidate
-		want      bool
-	}{
-		{
-			name: "native",
-			candidate: modem.Candidate{
-				ID:         "wwan0",
-				QMIControl: "/dev/wwan0qmi0",
-			},
-			want: true,
-		},
-		{
-			name: "mhi native discovery id",
-			candidate: modem.Candidate{
-				ID:         "mhi-wwan0",
-				QMIControl: "/dev/wwan0qmi0",
-			},
-			want: true,
-		},
-		{
-			name: "different control device",
-			candidate: modem.Candidate{
-				ID:         "wwan0",
-				QMIControl: "/dev/cdc-wdm0",
-			},
-			want: false,
-		},
-		{
-			name: "non native id",
-			candidate: modem.Candidate{
-				ID:         "usb0",
-				QMIControl: "/dev/usb0qmi0",
-			},
-			want: false,
-		},
-	}
-	for _, tt := range tests {
-		t.Run(tt.name, func(t *testing.T) {
-			if got := isNativeQMICandidate(tt.candidate); got != tt.want {
-				t.Fatalf("isNativeQMICandidate() = %v, want %v", got, tt.want)
-			}
-		})
-	}
-}

internal/device/scan_test.go

@@ -55,25 +55,6 @@ func TestCarrierForPLMNReturnsCountryCode(t *testing.T) {
 	}
 }
 
-func TestCountryForMCCUsesEmbeddedCountryIndex(t *testing.T) {
-	tests := map[string]string{
-		"234": "GB",
-		"262": "DE",
-		"310": "US",
-		"460": "CN",
-	}
-	for mcc, want := range tests {
-		if got, ok := CountryForMCC(mcc); !ok || got != want {
-			t.Errorf("CountryForMCC(%q) = (%q, %v), want %q", mcc, got, ok, want)
-		}
-	}
-	for _, invalid := range []string{"", "23", "999", "abcd"} {
-		if got, ok := CountryForMCC(invalid); ok || got != "" {
-			t.Errorf("CountryForMCC(%q) = (%q, %v), want unknown", invalid, got, ok)
-		}
-	}
-}
-
 func TestCarrierForIMSIHandlesTwoAndThreeDigitMNCs(t *testing.T) {
 	tests := []struct {
 		imsi        string
@@ -83,7 +64,6 @@ func TestCarrierForIMSIHandlesTwoAndThreeDigitMNCs(t *testing.T) {
 		{imsi: "234336570710174", wantPLMN: "23433", wantCountry: "GB"},
 		{imsi: "234159609054263", wantPLMN: "23415", wantCountry: "GB"},
 		{imsi: "234870123456789", wantPLMN: "23487", wantCountry: "GB"},
-		{imsi: "454006395879502", wantPLMN: "45400", wantCountry: "HK"},
 		{imsi: "310260123456789", wantPLMN: "310260", wantCountry: "US"},
 	}
 	for _, item := range tests {
@@ -93,20 +73,3 @@ func TestCarrierForIMSIHandlesTwoAndThreeDigitMNCs(t *testing.T) {
 		}
 	}
 }
-
-func TestCarrierForSIMUsesAndroidGIDRuleBeforePLMNFallback(t *testing.T) {
-	plmn, name, country, ok := CarrierForSIM(CarrierIdentity{
-		IMSI: "454006395879502", ICCID: "89852350126077295027",
-		SPN: "Saily", GID1: "536E617065", GID2: "536E617065000012", MNCLength: 2,
-	})
-	if !ok || plmn != "45400" || name != "Webbing" || country != "HK" {
-		t.Fatalf("CarrierForSIM exact rule = (%q, %q, %q, %v)", plmn, name, country, ok)
-	}
-
-	plmn, name, country, ok = CarrierForSIM(CarrierIdentity{
-		IMSI: "454006395879502", SPN: "Saily", MNCLength: 2,
-	})
-	if !ok || plmn != "45400" || name != "1O1O / csl / Club Sim" || country != "HK" {
-		t.Fatalf("CarrierForSIM generic fallback = (%q, %q, %q, %v)", plmn, name, country, ok)
-	}
-}

internal/device/snapshot.go

@@ -21,7 +21,6 @@ func (manager *Manager) readSnapshot(
 	candidate modem.Candidate,
 	backend string,
 	previousICCID string,
-	previousSnapshot *Snapshot,
 	client modem.Client,
 ) (Snapshot, error) {
 	snapshot := Snapshot{
@@ -56,23 +55,10 @@ func (manager *Manager) readSnapshot(
 	if ccidErr != nil {
 		ccid, ccidErr = manager.command(ctx, client, "AT+QCCID")
 	}
-	if ccidErr != nil && strings.EqualFold(strings.TrimSpace(backend), "qmi") && isNativeQMICandidate(candidate) {
-		qmiContext, cancelQMI := manager.withTimeout(ctx, manager.commandTimeout*5)
-		qmiICCID, qmiErr := manager.readNativeQMIICCID(qmiContext, candidate)
-		cancelQMI()
-		if qmiErr == nil {
-			snapshot.ICCID = qmiICCID
-			ccidErr = nil
-		} else {
-			snapshot.Warnings = append(snapshot.Warnings, "read ICCID via QMI UIM: "+qmiErr.Error())
-		}
-	}
 	if ccidErr != nil {
 		snapshot.Warnings = append(snapshot.Warnings, "read ICCID: "+ccidErr.Error())
 	} else {
-		if snapshot.ICCID == "" {
-			snapshot.ICCID = parseICCIDIdentifier(ccid, []string{"+CCID:", "+QCCID:"}, 18, 22)
-		}
+		snapshot.ICCID = parseICCIDIdentifier(ccid, []string{"+CCID:", "+QCCID:"}, 18, 22)
 	}
 	previousICCID = strings.TrimSpace(previousICCID)
 	if previousICCID != "" && snapshot.ICCID != "" && !strings.EqualFold(previousICCID, snapshot.ICCID) {
@@ -95,25 +81,6 @@ func (manager *Manager) readSnapshot(
 	if response, spnErr := manager.command(ctx, client, "AT+CRSM=176,28486,0,0,17"); spnErr == nil {
 		snapshot.SPN = parseSPN(response)
 	}
-	if previousSnapshot != nil && previousSnapshot.IdentityFilesRead &&
-		strings.EqualFold(strings.TrimSpace(previousSnapshot.ICCID), strings.TrimSpace(snapshot.ICCID)) {
-		snapshot.MNCLength = previousSnapshot.MNCLength
-		snapshot.GID1 = previousSnapshot.GID1
-		snapshot.GID2 = previousSnapshot.GID2
-		snapshot.IdentityFilesRead = true
-	} else {
-		// Android's carrier resolver does not identify MVNOs from MCC/MNC alone.
-		// Read these files once per inserted ICCID and cache even an empty result;
-		// repeatedly probing unsupported EFs would add avoidable modem traffic.
-		if efAD := manager.readTransparentSIMFile(ctx, client, 28589); len(efAD) >= 4 {
-			if length := int(efAD[3] & 0x0f); length == 2 || length == 3 {
-				snapshot.MNCLength = length
-			}
-		}
-		snapshot.GID1 = encodeSIMGroupID(manager.readTransparentSIMFile(ctx, client, 28478))
-		snapshot.GID2 = encodeSIMGroupID(manager.readTransparentSIMFile(ctx, client, 28479))
-		snapshot.IdentityFilesRead = true
-	}
 	if response, ok := optional("AT+CSQ"); ok {
 		snapshot.SignalRaw, snapshot.SignalPercent, snapshot.RSSIDBm = parseCSQ(response)
 	}
@@ -197,91 +164,6 @@ func (manager *Manager) readSnapshot(
 	return snapshot, nil
 }
 
-func (manager *Manager) readTransparentSIMFile(ctx context.Context, client modem.Client, fileID int) []byte {
-	response, err := manager.command(ctx, client, fmt.Sprintf("AT+CRSM=192,%d,0,0,0", fileID))
-	if err != nil {
-		return nil
-	}
-	size := transparentSIMFileSize(crsmPayload(response))
-	if size <= 0 || size > 64 {
-		return nil
-	}
-	response, err = manager.command(ctx, client, fmt.Sprintf("AT+CRSM=176,%d,0,0,%d", fileID, size))
-	if err != nil {
-		return nil
-	}
-	return crsmPayload(response)
-}
-
-func transparentSIMFileSize(payload []byte) int {
-	// USIM FCP templates contain file size in tag 0x80. Skip the outer 0x62
-	// template and walk its immediate TLVs.
-	content := payload
-	if len(content) >= 2 && content[0] == 0x62 {
-		length, header, ok := berLength(content[1:])
-		if !ok || 1+header+length > len(content) {
-			return 0
-		}
-		content = content[1+header : 1+header+length]
-	}
-	for offset := 0; offset+2 <= len(content); {
-		tag := content[offset]
-		length, header, ok := berLength(content[offset+1:])
-		start := offset + 1 + header
-		end := start + length
-		if !ok || end > len(content) {
-			break
-		}
-		if tag == 0x80 && (length == 1 || length == 2) {
-			size := 0
-			for _, value := range content[start:end] {
-				size = size<<8 | int(value)
-			}
-			return size
-		}
-		offset = end
-	}
-	// Legacy GSM GET RESPONSE data stores file size in bytes 2 and 3.
-	if len(payload) >= 4 && payload[0] != 0x62 {
-		return int(payload[2])<<8 | int(payload[3])
-	}
-	return 0
-}
-
-func berLength(value []byte) (length, header int, ok bool) {
-	if len(value) == 0 {
-		return 0, 0, false
-	}
-	if value[0] < 0x80 {
-		return int(value[0]), 1, true
-	}
-	count := int(value[0] & 0x7f)
-	if count == 0 || count > 2 || len(value) < count+1 {
-		return 0, 0, false
-	}
-	for _, item := range value[1 : count+1] {
-		length = length<<8 | int(item)
-	}
-	return length, count + 1, true
-}
-
-func encodeSIMGroupID(value []byte) string {
-	if len(value) == 0 {
-		return ""
-	}
-	allPadding := true
-	for _, item := range value {
-		if item != 0xff {
-			allPadding = false
-			break
-		}
-	}
-	if allPadding {
-		return ""
-	}
-	return strings.ToUpper(hex.EncodeToString(value))
-}
-
 func parseSPN(response modem.Response) string {
 	value := valueAfterPrefix(response, "+CRSM:")
 	fields := csvValues(value)

internal/device/types.go

@@ -11,7 +11,6 @@ var (
 	ErrNotStarted             = errors.New("device manager is not started")
 	ErrNotFound               = errors.New("device not found")
 	ErrNoATPort               = errors.New("device has no usable AT port")
-	ErrUnsupportedCapability  = errors.New("device does not support this capability")
 	ErrSMSPromptUnsupported   = errors.New("device AT client does not support SMS prompt mode")
 	ErrSMSInvalidRecipient    = errors.New("invalid SMS recipient")
 	ErrSMSEmpty               = errors.New("SMS text is empty")
@@ -105,10 +104,6 @@ type Snapshot struct {
 	ICCID              string      `json:"iccid"`
 	IMSI               string      `json:"imsi"`
 	SPN                string      `json:"spn,omitempty"`
-	MNCLength          int         `json:"mncLength,omitempty"`
-	GID1               string      `json:"gid1,omitempty"`
-	GID2               string      `json:"gid2,omitempty"`
-	IdentityFilesRead  bool        `json:"-"`
 	OperatingMode      int         `json:"operatingMode"`
 	ModeKnown          bool        `json:"modeKnown"`
 	FlightMode         bool        `json:"flightMode"`

internal/modem/discovery.go

@@ -38,10 +38,9 @@ func (d *SysFSDiscoverer) Discover(ctx context.Context) ([]Candidate, error) {
 	entries, err := os.ReadDir(usbRoot)
 	if err != nil {
 		if os.IsNotExist(err) {
-			entries = nil
-		} else {
-			return nil, fmt.Errorf("discover Quectel USB devices: %w", err)
+			return nil, nil
 		}
+		return nil, fmt.Errorf("discover Quectel USB devices: %w", err)
 	}
 
 	aliases := readSerialAliases(filepath.Join(d.DevRoot, "serial", "by-id"))
@@ -132,176 +131,10 @@ func (d *SysFSDiscoverer) Discover(ctx context.Context) ([]Candidate, error) {
 		state.candidate.ATPort = selectATPort(state.candidate.Ports)
 		result = append(result, state.candidate)
 	}
-	wwanCandidates, err := d.discoverWWAN(ctx)
-	if err != nil {
-		return nil, err
-	}
-	result = append(result, wwanCandidates...)
 	sort.Slice(result, func(i, j int) bool { return result[i].ID < result[j].ID })
 	return result, nil
 }
 
-type discoveredWWANDevice struct {
-	index    string
-	ports    []Port
-	qmiNames []string
-	sysPath  string
-}
-
-// discoverWWAN covers PCIe/MHI modems exposed through Linux's wwan subsystem,
-// for example /dev/wwan0at0 and /dev/wwan0qmi0. These devices do not appear on
-// the USB bus and therefore need a separate discovery path.
-func (d *SysFSDiscoverer) discoverWWAN(ctx context.Context) ([]Candidate, error) {
-	classRoot := filepath.Join(d.SysRoot, "class", "wwan")
-	classEntries, err := os.ReadDir(classRoot)
-	if err != nil {
-		if !os.IsNotExist(err) {
-			return nil, fmt.Errorf("discover PCIe/MHI WWAN devices: %w", err)
-		}
-		classEntries = nil
-	}
-
-	// Normal kernels expose these ports in /sys/class/wwan. Also inspect /dev
-	// because some downstream MHI packages create the character devices but do
-	// not populate the class directory in the host namespace/container.
-	portNames := make(map[string]struct{})
-	for _, entry := range classEntries {
-		portNames[entry.Name()] = struct{}{}
-	}
-	if devEntries, devErr := os.ReadDir(d.DevRoot); devErr == nil {
-		for _, entry := range devEntries {
-			if _, _, _, ok := parseWWANPortName(entry.Name()); ok {
-				portNames[entry.Name()] = struct{}{}
-			}
-		}
-	} else if !os.IsNotExist(devErr) {
-		return nil, fmt.Errorf("inspect WWAN device nodes: %w", devErr)
-	}
-	names := make([]string, 0, len(portNames))
-	for name := range portNames {
-		names = append(names, name)
-	}
-	sort.Strings(names)
-
-	groups := make(map[string]*discoveredWWANDevice)
-	for _, name := range names {
-		if err := ctx.Err(); err != nil {
-			return nil, err
-		}
-		index, kind, portIndex, ok := parseWWANPortName(name)
-		if !ok {
-			continue
-		}
-		group := groups[index]
-		if group == nil {
-			group = &discoveredWWANDevice{index: index}
-			groups[index] = group
-		}
-		classPath := filepath.Join(classRoot, name)
-		if resolved, resolveErr := filepath.EvalSymlinks(classPath); resolveErr == nil {
-			group.sysPath = filepath.Dir(resolved)
-		}
-		switch kind {
-		case "at":
-			group.ports = append(group.ports, Port{
-				Path: filepath.Join(d.DevRoot, name), Name: name,
-				InterfaceNumber: portIndex, Role: PortRoleAT,
-			})
-		case "qmi":
-			group.qmiNames = append(group.qmiNames, name)
-		}
-	}
-	result := make([]Candidate, 0, len(groups))
-	for _, group := range groups {
-		sort.Slice(group.ports, func(i, j int) bool {
-			return group.ports[i].InterfaceNumber < group.ports[j].InterfaceNumber
-		})
-		sort.Strings(group.qmiNames)
-		if len(group.ports) == 0 && len(group.qmiNames) == 0 {
-			continue
-		}
-		if group.sysPath == "" {
-			group.sysPath = filepath.Join(classRoot, "wwan"+group.index)
-		}
-		vendorID, productID := readPCIIdentity(group.sysPath, d.SysRoot)
-		manufacturer := ""
-		if vendorID == "17cb" {
-			manufacturer = "Qualcomm"
-		}
-		candidate := Candidate{
-			HardwareKind: "wwan", ID: "mhi-wwan" + group.index,
-			VendorID: vendorID, ProductID: productID, Manufacturer: manufacturer,
-			Product: "PCIe/MHI WWAN modem", USBPath: group.sysPath,
-			Ports: group.ports, NetworkInterface: selectWWANNetworkInterface(d.SysRoot, group.index),
-		}
-		if len(group.ports) > 0 {
-			candidate.ATPort = group.ports[0]
-		}
-		if len(group.qmiNames) > 0 {
-			candidate.QMIControl = filepath.Join(d.DevRoot, group.qmiNames[0])
-		}
-		result = append(result, candidate)
-	}
-	sort.Slice(result, func(i, j int) bool { return result[i].ID < result[j].ID })
-	return result, nil
-}
-
-func parseWWANPortName(name string) (index, kind string, portIndex int, ok bool) {
-	if !strings.HasPrefix(name, "wwan") {
-		return "", "", 0, false
-	}
-	rest := strings.TrimPrefix(name, "wwan")
-	cut := 0
-	for cut < len(rest) && rest[cut] >= '0' && rest[cut] <= '9' {
-		cut++
-	}
-	if cut == 0 {
-		return "", "", 0, false
-	}
-	index, rest = rest[:cut], rest[cut:]
-	for _, candidateKind := range []string{"at", "qmi"} {
-		if !strings.HasPrefix(rest, candidateKind) {
-			continue
-		}
-		numberText := strings.TrimPrefix(rest, candidateKind)
-		number, err := strconv.Atoi(numberText)
-		if err != nil || number < 0 {
-			return "", "", 0, false
-		}
-		return index, candidateKind, number, true
-	}
-	return "", "", 0, false
-}
-
-func selectWWANNetworkInterface(sysRoot, index string) string {
-	exact := "wwan" + index
-	if _, err := os.Stat(filepath.Join(sysRoot, "class", "net", exact)); err == nil {
-		return exact
-	}
-	entries, _ := os.ReadDir(filepath.Join(sysRoot, "class", "net"))
-	for _, entry := range entries {
-		if strings.HasPrefix(entry.Name(), exact) {
-			return entry.Name()
-		}
-	}
-	return ""
-}
-
-func readPCIIdentity(path, sysRoot string) (vendorID, productID string) {
-	root := filepath.Clean(sysRoot)
-	for current := filepath.Clean(path); current != "." && current != string(filepath.Separator); current = filepath.Dir(current) {
-		vendor := strings.TrimPrefix(strings.ToLower(readTrimmed(filepath.Join(current, "vendor"))), "0x")
-		device := strings.TrimPrefix(strings.ToLower(readTrimmed(filepath.Join(current, "device"))), "0x")
-		if vendor != "" && device != "" {
-			return vendor, device
-		}
-		if current == root {
-			break
-		}
-	}
-	return "", ""
-}
-
 func parseUSBInterfaceName(name string) (int, bool) {
 	_, suffix, ok := strings.Cut(name, ":")
 	if !ok {

internal/modem/discovery_test.go

@@ -235,80 +235,6 @@ func TestSysFSDiscoveryIgnoresNonQuectelUSB(t *testing.T) {
 	}
 }
 
-func TestSysFSDiscoveryFindsPCIeMHIWWANWithoutUSBBus(t *testing.T) {
-	root := t.TempDir()
-	sysRoot := filepath.Join(root, "sys")
-	devRoot := filepath.Join(root, "dev")
-	wwanRoot := filepath.Join(sysRoot, "class", "wwan")
-	for _, name := range []string{"wwan0at1", "wwan0qmi0", "wwan0at0"} {
-		mustMkdir(t, filepath.Join(wwanRoot, name))
-	}
-	mustMkdir(t, filepath.Join(sysRoot, "class", "net", "wwan0"))
-
-	candidates, err := NewSysFSDiscoverer(sysRoot, devRoot).Discover(context.Background())
-	if err != nil {
-		t.Fatal(err)
-	}
-	if len(candidates) != 1 {
-		t.Fatalf("candidates = %#v, want one MHI device", candidates)
-	}
-	candidate := candidates[0]
-	if candidate.ID != "mhi-wwan0" || candidate.HardwareKind != "wwan" {
-		t.Fatalf("identity = %#v", candidate)
-	}
-	if candidate.ATPort.Path != filepath.Join(devRoot, "wwan0at0") || candidate.ATPort.Role != PortRoleAT {
-		t.Fatalf("AT port = %#v", candidate.ATPort)
-	}
-	if candidate.QMIControl != filepath.Join(devRoot, "wwan0qmi0") {
-		t.Fatalf("QMI control = %q", candidate.QMIControl)
-	}
-	if candidate.NetworkInterface != "wwan0" {
-		t.Fatalf("network interface = %q", candidate.NetworkInterface)
-	}
-}
-
-func TestSysFSDiscoveryFindsWWANFromDevNodesWithoutClassDirectory(t *testing.T) {
-	root := t.TempDir()
-	sysRoot := filepath.Join(root, "sys")
-	devRoot := filepath.Join(root, "dev")
-	for _, name := range []string{"wwan2at0", "wwan2qmi0"} {
-		mustWrite(t, filepath.Join(devRoot, name), "")
-	}
-	mustMkdir(t, filepath.Join(sysRoot, "class", "net", "wwan2"))
-
-	candidates, err := NewSysFSDiscoverer(sysRoot, devRoot).Discover(context.Background())
-	if err != nil {
-		t.Fatal(err)
-	}
-	if len(candidates) != 1 {
-		t.Fatalf("candidates = %#v, want one WWAN device", candidates)
-	}
-	if candidates[0].ATPort.Path != filepath.Join(devRoot, "wwan2at0") ||
-		candidates[0].QMIControl != filepath.Join(devRoot, "wwan2qmi0") ||
-		candidates[0].NetworkInterface != "wwan2" {
-		t.Fatalf("candidate = %#v", candidates[0])
-	}
-}
-
-func TestParseWWANPortName(t *testing.T) {
-	for _, test := range []struct {
-		name, index, kind string
-		port              int
-		ok                bool
-	}{
-		{"wwan0at0", "0", "at", 0, true},
-		{"wwan12qmi3", "12", "qmi", 3, true},
-		{"wwan0", "", "", 0, false},
-		{"wwanXat0", "", "", 0, false},
-		{"cdc-wdm0", "", "", 0, false},
-	} {
-		index, kind, port, ok := parseWWANPortName(test.name)
-		if index != test.index || kind != test.kind || port != test.port || ok != test.ok {
-			t.Fatalf("parseWWANPortName(%q) = %q, %q, %d, %v", test.name, index, kind, port, ok)
-		}
-	}
-}
-
 func mustWrite(t *testing.T, path, value string) {
 	t.Helper()
 	mustMkdir(t, filepath.Dir(path))

internal/modem/serial.go

@@ -4,7 +4,6 @@ import (
 	"context"
 	"errors"
 	"fmt"
-	"path/filepath"
 
 	"go.bug.st/serial"
 )
@@ -22,22 +21,6 @@ func (opener SerialOpener) Open(ctx context.Context, port Port) (Client, error)
 	if path == "" {
 		return nil, errors.New("modem: candidate has no AT port")
 	}
-	if isNativeWWANATPath(path) {
-		rawPort, err := openNativeWWANATTransport(path)
-		if err != nil {
-			return nil, fmt.Errorf("open WWAN AT port %s: %w", path, err)
-		}
-		if err := rawPort.ResetInputBuffer(); err != nil {
-			_ = rawPort.Close()
-			return nil, fmt.Errorf("reset WWAN AT input buffer %s: %w", path, err)
-		}
-		session, err := NewSession(rawPort, opener.SessionOptions)
-		if err != nil {
-			_ = rawPort.Close()
-			return nil, err
-		}
-		return session, nil
-	}
 	baudRate := opener.BaudRate
 	if baudRate <= 0 {
 		baudRate = 115200
@@ -62,8 +45,3 @@ func (opener SerialOpener) Open(ctx context.Context, port Port) (Client, error)
 	}
 	return session, nil
 }
-
-func isNativeWWANATPath(path string) bool {
-	_, kind, _, ok := parseWWANPortName(filepath.Base(filepath.Clean(path)))
-	return ok && kind == "at"
-}

internal/modem/serial_test.go

@@ -1,24 +0,0 @@
-package modem
-
-import "testing"
-
-func TestIsNativeWWANATPath(t *testing.T) {
-	for _, path := range []string{
-		"/dev/wwan0at0",
-		"/dev/wwan12at3",
-	} {
-		if !isNativeWWANATPath(path) {
-			t.Errorf("isNativeWWANATPath(%q) = false", path)
-		}
-	}
-	for _, path := range []string{
-		"/dev/wwan0qmi0",
-		"/dev/ttyUSB2",
-		"/tmp/wwan-at",
-		"/dev/wwanat0",
-	} {
-		if isNativeWWANATPath(path) {
-			t.Errorf("isNativeWWANATPath(%q) = true", path)
-		}
-	}
-}

internal/modem/types.go

@@ -44,8 +44,6 @@ func (p Port) OpenPath() string {
 }
 
 type Candidate struct {
-	HardwareKind     string `json:"hardwareKind,omitempty"`
-	ReaderName       string `json:"readerName,omitempty"`
 	ID               string `json:"id"`
 	VendorID         string `json:"vendorId"`
 	ProductID        string `json:"productId"`
@@ -57,7 +55,6 @@ type Candidate struct {
 	Ports            []Port `json:"ports"`
 	QMIControl       string `json:"qmiControl,omitempty"`
 	NetworkInterface string `json:"networkInterface,omitempty"`
-	DiscoveryIssue   string `json:"discoveryIssue,omitempty"`
 }
 
 func (c Candidate) HasATPort() bool {

internal/modem/wwan_at_linux.go

@@ -1,161 +0,0 @@
-//go:build linux
-
-package modem
-
-import (
-	"errors"
-	"fmt"
-	"io"
-	"sync"
-	"time"
-
-	"golang.org/x/sys/unix"
-)
-
-// nativeWWANATTransport adapts a Linux WWAN AT character device to Session's
-// serial-like transport contract. WWAN ports are not TTYs, so termios ioctls
-// used by ordinary serial libraries fail even though raw AT read/write works.
-type nativeWWANATTransport struct {
-	mu          sync.RWMutex
-	fd          int
-	readTimeout time.Duration
-	closed      bool
-}
-
-func openNativeWWANATTransport(path string) (Transport, error) {
-	fd, err := unix.Open(path, unix.O_RDWR|unix.O_NONBLOCK|unix.O_NOCTTY|unix.O_CLOEXEC, 0)
-	if err != nil {
-		return nil, err
-	}
-	return &nativeWWANATTransport{fd: fd, readTimeout: -1}, nil
-}
-
-func (transport *nativeWWANATTransport) Read(buffer []byte) (int, error) {
-	transport.mu.RLock()
-	defer transport.mu.RUnlock()
-	if transport.closed {
-		return 0, io.ErrClosedPipe
-	}
-
-	deadline := time.Time{}
-	if transport.readTimeout >= 0 {
-		deadline = time.Now().Add(transport.readTimeout)
-	}
-	for {
-		timeout := -1
-		if !deadline.IsZero() {
-			remaining := time.Until(deadline)
-			if remaining <= 0 {
-				return 0, nil
-			}
-			timeout = int((remaining + time.Millisecond - 1) / time.Millisecond)
-		}
-		fds := []unix.PollFd{{Fd: int32(transport.fd), Events: unix.POLLIN}}
-		ready, err := unix.Poll(fds, timeout)
-		if errors.Is(err, unix.EINTR) {
-			continue
-		}
-		if err != nil {
-			return 0, err
-		}
-		if ready == 0 {
-			return 0, nil
-		}
-		if fds[0].Revents&(unix.POLLERR|unix.POLLHUP|unix.POLLNVAL) != 0 &&
-			fds[0].Revents&unix.POLLIN == 0 {
-			return 0, io.EOF
-		}
-		count, err := unix.Read(transport.fd, buffer)
-		if errors.Is(err, unix.EINTR) || errors.Is(err, unix.EAGAIN) {
-			continue
-		}
-		if count < 0 {
-			count = 0
-		}
-		return count, err
-	}
-}
-
-func (transport *nativeWWANATTransport) Write(buffer []byte) (int, error) {
-	transport.mu.RLock()
-	defer transport.mu.RUnlock()
-	if transport.closed {
-		return 0, io.ErrClosedPipe
-	}
-	for {
-		count, err := unix.Write(transport.fd, buffer)
-		if errors.Is(err, unix.EINTR) {
-			continue
-		}
-		if errors.Is(err, unix.EAGAIN) {
-			fds := []unix.PollFd{{Fd: int32(transport.fd), Events: unix.POLLOUT}}
-			if _, pollErr := unix.Poll(fds, 1000); pollErr != nil {
-				return 0, pollErr
-			}
-			continue
-		}
-		if count < 0 {
-			count = 0
-		}
-		return count, err
-	}
-}
-
-func (transport *nativeWWANATTransport) Drain() error {
-	transport.mu.RLock()
-	defer transport.mu.RUnlock()
-	if transport.closed {
-		return io.ErrClosedPipe
-	}
-	// WWAN character-device writes are handed to the modem synchronously and
-	// have no termios output queue to drain.
-	return nil
-}
-
-func (transport *nativeWWANATTransport) ResetInputBuffer() error {
-	transport.mu.RLock()
-	defer transport.mu.RUnlock()
-	if transport.closed {
-		return io.ErrClosedPipe
-	}
-	buffer := make([]byte, 4096)
-	for {
-		fds := []unix.PollFd{{Fd: int32(transport.fd), Events: unix.POLLIN}}
-		ready, err := unix.Poll(fds, 0)
-		if err != nil {
-			return err
-		}
-		if ready == 0 || fds[0].Revents&unix.POLLIN == 0 {
-			return nil
-		}
-		if _, err := unix.Read(transport.fd, buffer); err != nil {
-			if errors.Is(err, unix.EINTR) || errors.Is(err, unix.EAGAIN) {
-				continue
-			}
-			return err
-		}
-	}
-}
-
-func (transport *nativeWWANATTransport) SetReadTimeout(timeout time.Duration) error {
-	if timeout < -1 {
-		return fmt.Errorf("invalid read timeout %s", timeout)
-	}
-	transport.mu.Lock()
-	defer transport.mu.Unlock()
-	if transport.closed {
-		return io.ErrClosedPipe
-	}
-	transport.readTimeout = timeout
-	return nil
-}
-
-func (transport *nativeWWANATTransport) Close() error {
-	transport.mu.Lock()
-	defer transport.mu.Unlock()
-	if transport.closed {
-		return nil
-	}
-	transport.closed = true
-	return unix.Close(transport.fd)
-}

internal/modem/wwan_at_other.go

@@ -1,9 +0,0 @@
-//go:build !linux
-
-package modem
-
-import "fmt"
-
-func openNativeWWANATTransport(path string) (Transport, error) {
-	return nil, fmt.Errorf("native WWAN AT ports are unsupported on this platform: %s", path)
-}

internal/pcsc/backend_linux.go

@@ -1,249 +0,0 @@
-//go:build linux && (amd64 || arm64)
-
-package pcsc
-
-import (
-	"context"
-	"encoding/binary"
-	"encoding/hex"
-	"errors"
-	"fmt"
-	"net"
-	"os"
-	"path/filepath"
-	"strconv"
-	"strings"
-	"time"
-)
-
-type nativeBackend struct{ sysRoot string }
-
-func newNativeBackend() Backend { return &nativeBackend{sysRoot: "/sys"} }
-
-func (backend *nativeBackend) dial(ctx context.Context) (*pcscdClient, error) {
-	paths := []string{strings.TrimSpace(os.Getenv("PCSCLITE_CSOCK_NAME")), "/run/pcscd/pcscd.comm", "/var/run/pcscd/pcscd.comm"}
-	var failures []error
-	seen := make(map[string]bool)
-	for _, path := range paths {
-		if path == "" || seen[path] {
-			continue
-		}
-		seen[path] = true
-		conn, err := (&net.Dialer{Timeout: 5 * time.Second}).DialContext(ctx, "unix", path)
-		if err != nil {
-			failures = append(failures, err)
-			continue
-		}
-		client, err := establishPCSCD(ctx, conn)
-		if err == nil {
-			return client, nil
-		}
-		_ = conn.Close()
-		failures = append(failures, err)
-	}
-	return nil, fmt.Errorf("%w: pcscd socket is not reachable: %w", ErrUnavailable, errors.Join(failures...))
-}
-
-func (backend *nativeBackend) Readers(ctx context.Context) ([]Reader, error) {
-	physical := discoverUSBSmartCardReaders(backend.sysRoot, "pcsc_driver_missing")
-	client, err := backend.dial(ctx)
-	if err != nil {
-		if len(physical) > 0 {
-			for index := range physical {
-				physical[index].DiscoveryIssue = "pcsc_service_unavailable"
-			}
-			return physical, nil
-		}
-		return nil, err
-	}
-	defer client.closeContext(context.Background())
-	states, err := client.readers(ctx)
-	if err != nil {
-		return nil, err
-	}
-	readers := make([]Reader, 0, len(states))
-	for _, state := range states {
-		reader := Reader{
-			Name:        state.name,
-			CardPresent: state.state&pcscCardPresent != 0,
-			ATR:         strings.ToUpper(hex.EncodeToString(state.atr)),
-		}
-		if path, ok := backend.readerUSBPath(ctx, client, state.name); ok {
-			reader.USBPath = path
-			reader.VendorID = backend.readSysfsText(path, "idVendor")
-			reader.ProductID = backend.readSysfsText(path, "idProduct")
-			reader.Manufacturer = backend.readSysfsText(path, "manufacturer")
-			reader.Product = backend.readSysfsText(path, "product")
-		} else {
-			reader.USBPath = "pcsc:" + state.name
-		}
-		if reader.Product == "" {
-			reader.Product = strings.TrimSpace(strings.TrimSuffix(state.name, " 00 00"))
-		}
-		readers = append(readers, reader)
-	}
-	return mergePCSCAndUSBReaders(readers, physical), nil
-}
-
-func (backend *nativeBackend) readerUSBPath(ctx context.Context, client *pcscdClient, name string) (string, bool) {
-	card, _, err := client.connect(ctx, name, pcscShareDirect, 0)
-	if err != nil {
-		return "", false
-	}
-	disposition := uint32(pcscLeaveCard)
-	defer client.simpleCardCommand(context.Background(), pcscCmdDisconnect, card, &disposition)
-	attribute, err := client.getAttrib(ctx, card, pcscAttrChannelID)
-	if err != nil || len(attribute) < 4 {
-		return "", false
-	}
-	channel := binary.LittleEndian.Uint32(attribute[:4])
-	if channel>>16 != 0x0020 {
-		return "", false
-	}
-	bus, device := int((channel>>8)&0xff), int(channel&0xff)
-	usbRoot := filepath.Join(backend.sysRoot, "bus", "usb", "devices")
-	entries, err := os.ReadDir(usbRoot)
-	if err != nil {
-		return "", false
-	}
-	for _, entry := range entries {
-		if !entry.IsDir() && entry.Type()&os.ModeSymlink == 0 {
-			continue
-		}
-		path := filepath.Join(usbRoot, entry.Name())
-		entryBus, busErr := readSysfsInt(path, "busnum")
-		entryDevice, deviceErr := readSysfsInt(path, "devnum")
-		if busErr == nil && deviceErr == nil && entryBus == bus && entryDevice == device {
-			return entry.Name(), true
-		}
-	}
-	return "", false
-}
-
-func (backend *nativeBackend) Open(ctx context.Context, selector Selector) (Card, error) {
-	readers, err := backend.Readers(ctx)
-	if err != nil {
-		return nil, err
-	}
-	reader, ok := matchReader(readers, selector)
-	if !ok {
-		return nil, ErrReaderNotFound
-	}
-	if reader.DiscoveryIssue != "" {
-		return nil, fmt.Errorf("%w: %s", ErrUnavailable, reader.DiscoveryIssue)
-	}
-	if !reader.CardPresent {
-		return nil, ErrNoCard
-	}
-	client, err := backend.dial(ctx)
-	if err != nil {
-		return nil, err
-	}
-	handle, protocol, err := client.connect(ctx, reader.Name, pcscShareShared, pcscProtocolAny)
-	if err != nil {
-		_ = client.closeContext(context.Background())
-		return nil, err
-	}
-	if err := client.simpleCardCommand(ctx, pcscCmdBeginTransaction, handle, nil); err != nil {
-		disposition := uint32(pcscLeaveCard)
-		_ = client.simpleCardCommand(context.Background(), pcscCmdDisconnect, handle, &disposition)
-		_ = client.closeContext(context.Background())
-		return nil, fmt.Errorf("pcsc: begin card transaction: %w", err)
-	}
-	return &nativeCard{client: client, handle: handle, protocol: protocol}, nil
-}
-
-type nativeCard struct {
-	client   *pcscdClient
-	handle   int32
-	protocol uint32
-	closed   bool
-}
-
-func (card *nativeCard) Transmit(ctx context.Context, command []byte) ([]byte, uint16, error) {
-	if card == nil || card.client == nil || card.closed {
-		return nil, 0, errors.New("pcsc: card session is closed")
-	}
-	return card.transmit(ctx, append([]byte(nil), command...), 0)
-}
-
-func (card *nativeCard) TransmitRaw(ctx context.Context, command []byte) ([]byte, uint16, error) {
-	if card == nil || card.client == nil || card.closed {
-		return nil, 0, errors.New("pcsc: card session is closed")
-	}
-	response, err := card.client.transmit(ctx, card.handle, card.protocol, append([]byte(nil), command...))
-	if err != nil {
-		return nil, 0, err
-	}
-	if len(response) < 2 {
-		return nil, 0, errors.New("pcsc: APDU response omitted its status word")
-	}
-	last := len(response) - 2
-	return append([]byte(nil), response[:last]...), uint16(response[last])<<8 | uint16(response[last+1]), nil
-}
-
-func (card *nativeCard) transmit(ctx context.Context, command []byte, depth int) ([]byte, uint16, error) {
-	if depth > 8 {
-		return nil, 0, errors.New("pcsc: too many APDU continuations")
-	}
-	data, status, err := card.TransmitRaw(ctx, command)
-	if err != nil {
-		return nil, 0, err
-	}
-	sw1, sw2 := byte(status>>8), byte(status)
-	if sw1 == 0x6c && len(command) >= 5 {
-		retry := append([]byte(nil), command...)
-		retry[len(retry)-1] = sw2
-		return card.transmit(ctx, retry, depth+1)
-	}
-	if sw1 == 0x61 || sw1 == 0x9f {
-		more, sw, err := card.transmit(ctx, []byte{0x00, 0xc0, 0x00, 0x00, sw2}, depth+1)
-		if err != nil {
-			return nil, 0, err
-		}
-		return append(data, more...), sw, nil
-	}
-	return data, status, ctx.Err()
-}
-
-func (card *nativeCard) Close() error { return card.close(pcscLeaveCard) }
-
-func (card *nativeCard) CloseWithReset() error { return card.close(pcscResetCard) }
-
-func (card *nativeCard) close(disposition uint32) error {
-	if card == nil || card.closed {
-		return nil
-	}
-	card.closed = true
-	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
-	defer cancel()
-	var result []error
-	if card.client != nil {
-		if err := card.client.simpleCardCommand(ctx, pcscCmdEndTransaction, card.handle, &disposition); err != nil {
-			result = append(result, err)
-		}
-		if err := card.client.simpleCardCommand(ctx, pcscCmdDisconnect, card.handle, &disposition); err != nil {
-			result = append(result, err)
-		}
-		if err := card.client.closeContext(ctx); err != nil {
-			result = append(result, err)
-		}
-	}
-	return errors.Join(result...)
-}
-
-func (backend *nativeBackend) readSysfsText(usbPath, name string) string {
-	value, err := os.ReadFile(filepath.Join(backend.sysRoot, "bus", "usb", "devices", usbPath, name))
-	if err != nil {
-		return ""
-	}
-	return strings.TrimSpace(string(value))
-}
-
-func readSysfsInt(path, name string) (int, error) {
-	value, err := os.ReadFile(filepath.Join(path, name))
-	if err != nil {
-		return 0, err
-	}
-	return strconv.Atoi(strings.TrimSpace(string(value)))
-}

internal/pcsc/backend_stub.go

@@ -1,17 +0,0 @@
-//go:build !linux || (!amd64 && !arm64)
-
-package pcsc
-
-import "context"
-
-type unsupportedBackend struct{}
-
-func newNativeBackend() Backend { return unsupportedBackend{} }
-
-func (unsupportedBackend) Readers(context.Context) ([]Reader, error) {
-	return nil, ErrUnsupported
-}
-
-func (unsupportedBackend) Open(context.Context, Selector) (Card, error) {
-	return nil, ErrUnsupported
-}

internal/pcsc/pcscd_protocol.go

@@ -1,334 +0,0 @@
-package pcsc
-
-import (
-	"context"
-	"encoding/binary"
-	"errors"
-	"fmt"
-	"io"
-	"net"
-	"time"
-)
-
-// pcsc-lite exposes a small, versioned protocol over its local Unix socket.
-// Speaking that protocol directly keeps VoCat's Linux binaries fully static;
-// loading libpcsclite through dlopen would pull a glibc interpreter into an
-// otherwise CGO-free build and make it unusable on musl-based routers.
-const (
-	pcscProtocolMajor        = 4
-	pcscProtocolCurrentMinor = 6
-	pcscProtocolOldestMinor  = 4
-
-	pcscCmdEstablishContext = 0x01
-	pcscCmdReleaseContext   = 0x02
-	pcscCmdConnect          = 0x04
-	pcscCmdDisconnect       = 0x06
-	pcscCmdBeginTransaction = 0x07
-	pcscCmdEndTransaction   = 0x08
-	pcscCmdTransmit         = 0x09
-	pcscCmdGetAttrib        = 0x0f
-	pcscCmdVersion          = 0x11
-	pcscCmdGetReadersState  = 0x12
-
-	pcscScopeSystem      = 0x0002
-	pcscProtocolT0       = 0x0001
-	pcscProtocolT1       = 0x0002
-	pcscProtocolAny      = pcscProtocolT0 | pcscProtocolT1
-	pcscShareShared      = 0x0002
-	pcscShareDirect      = 0x0003
-	pcscLeaveCard        = 0x0000
-	pcscResetCard        = 0x0001
-	pcscCardPresent      = 0x0004
-	pcscAttrChannelID    = 0x00020110
-	pcscMaxReaderName    = 128
-	pcscMaxATR           = 33
-	pcscMaxReaders       = 16
-	pcscReaderStateSize  = 184
-	pcscGetSetBodySize   = 280
-	pcscMaxAttribute     = 264
-	pcscMaxAPDUResponse  = 65548
-	pcscDefaultIOTimeout = 30 * time.Second
-	pcscSuccess          = uint32(0)
-	pcscNoSmartcard      = uint32(0x8010000c)
-	pcscNoService        = uint32(0x8010001d)
-	pcscServiceStopped   = uint32(0x8010001e)
-	pcscNoReaders        = uint32(0x8010002e)
-)
-
-type pcscdClient struct {
-	conn        net.Conn
-	contextID   uint32
-	serverMinor int32
-}
-
-type pcscdReaderState struct {
-	name     string
-	state    uint32
-	atr      []byte
-	protocol uint32
-}
-
-func establishPCSCD(ctx context.Context, conn net.Conn) (*pcscdClient, error) {
-	client := &pcscdClient{conn: conn}
-	version := make([]byte, 12)
-	binary.LittleEndian.PutUint32(version[0:4], pcscProtocolMajor)
-	binary.LittleEndian.PutUint32(version[4:8], pcscProtocolCurrentMinor)
-	for {
-		if err := client.exchange(ctx, pcscCmdVersion, version); err != nil {
-			return nil, err
-		}
-		major := int32(binary.LittleEndian.Uint32(version[0:4]))
-		client.serverMinor = int32(binary.LittleEndian.Uint32(version[4:8]))
-		rv := binary.LittleEndian.Uint32(version[8:12])
-		if rv == pcscSuccess {
-			break
-		}
-		if rv != pcscServiceStopped || major != pcscProtocolMajor || client.serverMinor < pcscProtocolOldestMinor || client.serverMinor >= pcscProtocolCurrentMinor {
-			return nil, pcscError("negotiate protocol", rv)
-		}
-		// pcsc-lite answers a newer client's first probe with its own
-		// compatible minor version. Retry on the same connection with that
-		// value, matching libpcsclite's official fallback behavior.
-		binary.LittleEndian.PutUint32(version[0:4], pcscProtocolMajor)
-		binary.LittleEndian.PutUint32(version[4:8], uint32(client.serverMinor))
-		binary.LittleEndian.PutUint32(version[8:12], pcscSuccess)
-	}
-	if client.serverMinor < pcscProtocolOldestMinor {
-		return nil, fmt.Errorf("pcsc: unsupported pcscd protocol %d.%d", pcscProtocolMajor, client.serverMinor)
-	}
-	body := make([]byte, 12)
-	binary.LittleEndian.PutUint32(body[0:4], pcscScopeSystem)
-	if err := client.exchange(ctx, pcscCmdEstablishContext, body); err != nil {
-		return nil, err
-	}
-	if rv := binary.LittleEndian.Uint32(body[8:12]); rv != pcscSuccess {
-		return nil, pcscError("establish context", rv)
-	}
-	client.contextID = binary.LittleEndian.Uint32(body[4:8])
-	return client, nil
-}
-
-func (client *pcscdClient) exchange(ctx context.Context, command uint32, body []byte) error {
-	if client == nil || client.conn == nil {
-		return errors.New("pcsc: pcscd connection is closed")
-	}
-	if err := client.setDeadline(ctx); err != nil {
-		return err
-	}
-	header := make([]byte, 8)
-	binary.LittleEndian.PutUint32(header[0:4], uint32(len(body)))
-	binary.LittleEndian.PutUint32(header[4:8], command)
-	if err := writeAll(client.conn, header); err != nil {
-		return fmt.Errorf("pcsc: send command %02x: %w", command, err)
-	}
-	if len(body) > 0 {
-		if err := writeAll(client.conn, body); err != nil {
-			return fmt.Errorf("pcsc: send command body %02x: %w", command, err)
-		}
-		if _, err := io.ReadFull(client.conn, body); err != nil {
-			return fmt.Errorf("pcsc: receive command %02x: %w", command, err)
-		}
-	}
-	return nil
-}
-
-func (client *pcscdClient) send(ctx context.Context, command uint32, body, extra []byte) error {
-	if client == nil || client.conn == nil {
-		return errors.New("pcsc: pcscd connection is closed")
-	}
-	if err := client.setDeadline(ctx); err != nil {
-		return err
-	}
-	header := make([]byte, 8)
-	binary.LittleEndian.PutUint32(header[0:4], uint32(len(body)))
-	binary.LittleEndian.PutUint32(header[4:8], command)
-	if err := writeAll(client.conn, header); err != nil {
-		return err
-	}
-	if err := writeAll(client.conn, body); err != nil {
-		return err
-	}
-	return writeAll(client.conn, extra)
-}
-
-func (client *pcscdClient) setDeadline(ctx context.Context) error {
-	if err := ctx.Err(); err != nil {
-		return err
-	}
-	deadline := time.Now().Add(pcscDefaultIOTimeout)
-	if value, ok := ctx.Deadline(); ok && value.Before(deadline) {
-		deadline = value
-	}
-	return client.conn.SetDeadline(deadline)
-}
-
-func (client *pcscdClient) readers(ctx context.Context) ([]pcscdReaderState, error) {
-	if err := client.setDeadline(ctx); err != nil {
-		return nil, err
-	}
-	header := make([]byte, 8)
-	binary.LittleEndian.PutUint32(header[4:8], pcscCmdGetReadersState)
-	if err := writeAll(client.conn, header); err != nil {
-		return nil, fmt.Errorf("pcsc: request reader states: %w", err)
-	}
-	raw := make([]byte, pcscMaxReaders*pcscReaderStateSize)
-	if _, err := io.ReadFull(client.conn, raw); err != nil {
-		return nil, fmt.Errorf("pcsc: read reader states: %w", err)
-	}
-	result := make([]pcscdReaderState, 0, pcscMaxReaders)
-	for offset := 0; offset < len(raw); offset += pcscReaderStateSize {
-		state := raw[offset : offset+pcscReaderStateSize]
-		name := cString(state[:pcscMaxReaderName])
-		if name == "" {
-			continue
-		}
-		atrLen := int(binary.LittleEndian.Uint32(state[176:180]))
-		if atrLen < 0 || atrLen > pcscMaxATR {
-			atrLen = 0
-		}
-		result = append(result, pcscdReaderState{
-			name:     name,
-			state:    binary.LittleEndian.Uint32(state[132:136]),
-			atr:      append([]byte(nil), state[140:140+atrLen]...),
-			protocol: binary.LittleEndian.Uint32(state[180:184]),
-		})
-	}
-	return result, nil
-}
-
-func (client *pcscdClient) connect(ctx context.Context, reader string, share, protocols uint32) (int32, uint32, error) {
-	if len(reader) >= pcscMaxReaderName {
-		return 0, 0, errors.New("pcsc: reader name is too long")
-	}
-	body := make([]byte, 152)
-	binary.LittleEndian.PutUint32(body[0:4], client.contextID)
-	copy(body[4:132], reader)
-	binary.LittleEndian.PutUint32(body[132:136], share)
-	binary.LittleEndian.PutUint32(body[136:140], protocols)
-	if err := client.exchange(ctx, pcscCmdConnect, body); err != nil {
-		return 0, 0, err
-	}
-	if rv := binary.LittleEndian.Uint32(body[148:152]); rv != pcscSuccess {
-		return 0, 0, pcscError("connect reader", rv)
-	}
-	return int32(binary.LittleEndian.Uint32(body[140:144])), binary.LittleEndian.Uint32(body[144:148]), nil
-}
-
-func (client *pcscdClient) simpleCardCommand(ctx context.Context, command uint32, card int32, disposition *uint32) error {
-	size := 8
-	if disposition != nil {
-		size = 12
-	}
-	body := make([]byte, size)
-	binary.LittleEndian.PutUint32(body[0:4], uint32(card))
-	if disposition != nil {
-		binary.LittleEndian.PutUint32(body[4:8], *disposition)
-	}
-	if err := client.exchange(ctx, command, body); err != nil {
-		return err
-	}
-	if rv := binary.LittleEndian.Uint32(body[size-4:]); rv != pcscSuccess {
-		return pcscError("card command", rv)
-	}
-	return nil
-}
-
-func (client *pcscdClient) transmit(ctx context.Context, card int32, protocol uint32, command []byte) ([]byte, error) {
-	body := make([]byte, 32)
-	binary.LittleEndian.PutUint32(body[0:4], uint32(card))
-	binary.LittleEndian.PutUint32(body[4:8], protocol)
-	binary.LittleEndian.PutUint32(body[8:12], 8)
-	binary.LittleEndian.PutUint32(body[12:16], uint32(len(command)))
-	binary.LittleEndian.PutUint32(body[16:20], pcscProtocolAny)
-	binary.LittleEndian.PutUint32(body[20:24], 8)
-	binary.LittleEndian.PutUint32(body[24:28], pcscMaxAPDUResponse)
-	if err := client.send(ctx, pcscCmdTransmit, body, command); err != nil {
-		return nil, fmt.Errorf("pcsc: transmit APDU: %w", err)
-	}
-	if _, err := io.ReadFull(client.conn, body); err != nil {
-		return nil, fmt.Errorf("pcsc: receive APDU result: %w", err)
-	}
-	if rv := binary.LittleEndian.Uint32(body[28:32]); rv != pcscSuccess {
-		return nil, pcscError("transmit APDU", rv)
-	}
-	length := binary.LittleEndian.Uint32(body[24:28])
-	if length > pcscMaxAPDUResponse {
-		return nil, errors.New("pcsc: pcscd returned an oversized APDU")
-	}
-	response := make([]byte, length)
-	if _, err := io.ReadFull(client.conn, response); err != nil {
-		return nil, fmt.Errorf("pcsc: receive APDU: %w", err)
-	}
-	return response, nil
-}
-
-func (client *pcscdClient) getAttrib(ctx context.Context, card int32, attribute uint32) ([]byte, error) {
-	body := make([]byte, pcscGetSetBodySize)
-	binary.LittleEndian.PutUint32(body[0:4], uint32(card))
-	binary.LittleEndian.PutUint32(body[4:8], attribute)
-	binary.LittleEndian.PutUint32(body[272:276], pcscMaxAttribute)
-	if err := client.exchange(ctx, pcscCmdGetAttrib, body); err != nil {
-		return nil, err
-	}
-	if rv := binary.LittleEndian.Uint32(body[276:280]); rv != pcscSuccess {
-		return nil, pcscError("get reader attribute", rv)
-	}
-	length := binary.LittleEndian.Uint32(body[272:276])
-	if length > pcscMaxAttribute {
-		return nil, errors.New("pcsc: pcscd returned an oversized attribute")
-	}
-	return append([]byte(nil), body[8:8+length]...), nil
-}
-
-func (client *pcscdClient) closeContext(ctx context.Context) error {
-	if client == nil || client.conn == nil {
-		return nil
-	}
-	body := make([]byte, 8)
-	binary.LittleEndian.PutUint32(body[0:4], client.contextID)
-	err := client.exchange(ctx, pcscCmdReleaseContext, body)
-	if err == nil {
-		if rv := binary.LittleEndian.Uint32(body[4:8]); rv != pcscSuccess {
-			err = pcscError("release context", rv)
-		}
-	}
-	closeErr := client.conn.Close()
-	client.conn = nil
-	return errors.Join(err, closeErr)
-}
-
-func pcscError(operation string, code uint32) error {
-	switch code {
-	case pcscNoSmartcard:
-		return ErrNoCard
-	case pcscNoService, pcscServiceStopped:
-		return fmt.Errorf("%w: %s failed with PC/SC status %08X", ErrUnavailable, operation, code)
-	case pcscNoReaders:
-		return ErrReaderNotFound
-	default:
-		return fmt.Errorf("pcsc: %s failed with status %08X", operation, code)
-	}
-}
-
-func cString(value []byte) string {
-	for index, current := range value {
-		if current == 0 {
-			return string(value[:index])
-		}
-	}
-	return string(value)
-}
-
-func writeAll(writer io.Writer, value []byte) error {
-	for len(value) > 0 {
-		written, err := writer.Write(value)
-		if err != nil {
-			return err
-		}
-		if written == 0 {
-			return io.ErrUnexpectedEOF
-		}
-		value = value[written:]
-	}
-	return nil
-}

internal/pcsc/pcscd_protocol_test.go

@@ -1,127 +0,0 @@
-package pcsc
-
-import (
-	"bytes"
-	"context"
-	"encoding/binary"
-	"errors"
-	"io"
-	"net"
-	"testing"
-)
-
-func TestPCSCDClientLifecycleAndTransmit(t *testing.T) {
-	clientConn, serverConn := net.Pipe()
-	serverDone := make(chan error, 1)
-	go func() {
-		defer serverConn.Close()
-		serverDone <- servePCSCDTestSession(serverConn)
-	}()
-
-	client, err := establishPCSCD(context.Background(), clientConn)
-	if err != nil {
-		t.Fatalf("establishPCSCD: %v", err)
-	}
-	states, err := client.readers(context.Background())
-	if err != nil {
-		t.Fatalf("readers: %v", err)
-	}
-	if len(states) != 1 || states[0].name != "VoCat Test Reader 00 00" || states[0].state&pcscCardPresent == 0 {
-		t.Fatalf("states = %#v", states)
-	}
-	handle, protocol, err := client.connect(context.Background(), states[0].name, pcscShareShared, pcscProtocolAny)
-	if err != nil {
-		t.Fatalf("connect: %v", err)
-	}
-	if handle != 42 || protocol != pcscProtocolT1 {
-		t.Fatalf("handle/protocol = %d/%d", handle, protocol)
-	}
-	if err := client.simpleCardCommand(context.Background(), pcscCmdBeginTransaction, handle, nil); err != nil {
-		t.Fatalf("begin: %v", err)
-	}
-	response, err := client.transmit(context.Background(), handle, protocol, []byte{0x00, 0xa4, 0x00, 0x00})
-	if err != nil {
-		t.Fatalf("transmit: %v", err)
-	}
-	if !bytes.Equal(response, []byte{0x62, 0x02, 0x90, 0x00}) {
-		t.Fatalf("response = %x", response)
-	}
-	disposition := uint32(pcscLeaveCard)
-	if err := client.simpleCardCommand(context.Background(), pcscCmdEndTransaction, handle, &disposition); err != nil {
-		t.Fatalf("end: %v", err)
-	}
-	if err := client.simpleCardCommand(context.Background(), pcscCmdDisconnect, handle, &disposition); err != nil {
-		t.Fatalf("disconnect: %v", err)
-	}
-	if err := client.closeContext(context.Background()); err != nil {
-		t.Fatalf("close context: %v", err)
-	}
-	if err := <-serverDone; err != nil {
-		t.Fatalf("fake pcscd: %v", err)
-	}
-}
-
-func servePCSCDTestSession(conn net.Conn) error {
-	for {
-		header := make([]byte, 8)
-		if _, err := io.ReadFull(conn, header); err != nil {
-			return err
-		}
-		size := binary.LittleEndian.Uint32(header[0:4])
-		command := binary.LittleEndian.Uint32(header[4:8])
-		body := make([]byte, size)
-		if _, err := io.ReadFull(conn, body); err != nil {
-			return err
-		}
-		switch command {
-		case pcscCmdVersion:
-			binary.LittleEndian.PutUint32(body[0:4], pcscProtocolMajor)
-			binary.LittleEndian.PutUint32(body[4:8], pcscProtocolCurrentMinor)
-			if err := writeAll(conn, body); err != nil {
-				return err
-			}
-		case pcscCmdEstablishContext:
-			binary.LittleEndian.PutUint32(body[4:8], 7)
-			if err := writeAll(conn, body); err != nil {
-				return err
-			}
-		case pcscCmdGetReadersState:
-			states := make([]byte, pcscMaxReaders*pcscReaderStateSize)
-			copy(states, "VoCat Test Reader 00 00")
-			binary.LittleEndian.PutUint32(states[132:136], pcscCardPresent)
-			copy(states[140:143], []byte{0x3b, 0x00, 0x00})
-			binary.LittleEndian.PutUint32(states[176:180], 3)
-			binary.LittleEndian.PutUint32(states[180:184], pcscProtocolT1)
-			if err := writeAll(conn, states); err != nil {
-				return err
-			}
-		case pcscCmdConnect:
-			binary.LittleEndian.PutUint32(body[140:144], 42)
-			binary.LittleEndian.PutUint32(body[144:148], pcscProtocolT1)
-			if err := writeAll(conn, body); err != nil {
-				return err
-			}
-		case pcscCmdBeginTransaction, pcscCmdEndTransaction, pcscCmdDisconnect:
-			if err := writeAll(conn, body); err != nil {
-				return err
-			}
-		case pcscCmdTransmit:
-			commandBody := make([]byte, binary.LittleEndian.Uint32(body[12:16]))
-			if _, err := io.ReadFull(conn, commandBody); err != nil {
-				return err
-			}
-			response := []byte{0x62, 0x02, 0x90, 0x00}
-			binary.LittleEndian.PutUint32(body[24:28], uint32(len(response)))
-			if err := writeAll(conn, body); err != nil {
-				return err
-			}
-			if err := writeAll(conn, response); err != nil {
-				return err
-			}
-		case pcscCmdReleaseContext:
-			return writeAll(conn, body)
-		default:
-			return errors.New("unexpected fake pcscd command")
-		}
-	}
-}

internal/pcsc/service.go

@@ -1,613 +0,0 @@
-package pcsc
-
-import (
-	"bytes"
-	"context"
-	"crypto/sha256"
-	"encoding/hex"
-	"errors"
-	"fmt"
-	"strings"
-	"sync"
-)
-
-const usimAIDPrefix = "A0000000871002"
-
-type Service struct {
-	mu      sync.Mutex
-	backend Backend
-}
-
-// Session is an exclusive connection to one smart card. It is used by eUICC
-// operations which must keep the same PC/SC transaction and logical channel
-// alive across a sequence of APDUs.
-type Session struct {
-	service *Service
-	card    Card
-	closed  bool
-}
-
-func New() *Service {
-	return &Service{backend: newNativeBackend()}
-}
-
-func NewWithBackend(backend Backend) *Service {
-	return &Service{backend: backend}
-}
-
-func DeviceID(reader Reader) string {
-	identity := strings.TrimSpace(reader.USBPath)
-	if identity == "" {
-		identity = strings.TrimSpace(reader.Name)
-	}
-	sum := sha256.Sum256([]byte(identity))
-	return "reader-" + hex.EncodeToString(sum[:8])
-}
-
-func (service *Service) Readers(ctx context.Context) ([]Reader, error) {
-	if service == nil || service.backend == nil {
-		return nil, ErrUnavailable
-	}
-	service.mu.Lock()
-	defer service.mu.Unlock()
-	return service.backend.Readers(ctx)
-}
-
-// OpenSession opens one card and holds the service lock until Close. Callers
-// must close the returned session; this prevents AKA/identity reads from
-// interleaving with a stateful ES10 transaction.
-func (service *Service) OpenSession(ctx context.Context, selector Selector) (*Session, error) {
-	if service == nil || service.backend == nil {
-		return nil, ErrUnavailable
-	}
-	if err := selector.validate(); err != nil {
-		return nil, err
-	}
-	service.mu.Lock()
-	card, err := service.backend.Open(ctx, selector)
-	if err != nil {
-		service.mu.Unlock()
-		return nil, err
-	}
-	return &Session{service: service, card: card}, nil
-}
-
-// Transmit sends one raw APDU. Unlike the ordinary SIM helpers, it leaves
-// 61xx continuation handling to the eUICC logical-channel implementation so
-// GET RESPONSE uses the correct channel CLA.
-func (session *Session) Transmit(ctx context.Context, command []byte) ([]byte, uint16, error) {
-	if session == nil || session.card == nil || session.closed {
-		return nil, 0, errors.New("pcsc: card session is closed")
-	}
-	if raw, ok := session.card.(interface {
-		TransmitRaw(context.Context, []byte) ([]byte, uint16, error)
-	}); ok {
-		return raw.TransmitRaw(ctx, command)
-	}
-	return session.card.Transmit(ctx, command)
-}
-
-func (session *Session) Close() error {
-	return session.close(false)
-}
-
-// CloseWithReset resets the card while releasing the PC/SC connection. eUICC
-// EnableProfile requires this refresh boundary before the newly enabled USIM
-// application and ICCID become visible to subsequent callers.
-func (session *Session) CloseWithReset() error {
-	return session.close(true)
-}
-
-func (session *Session) close(reset bool) error {
-	if session == nil || session.closed {
-		return nil
-	}
-	session.closed = true
-	var err error
-	if resetter, ok := session.card.(interface{ CloseWithReset() error }); reset && ok {
-		err = resetter.CloseWithReset()
-	} else {
-		err = session.card.Close()
-	}
-	session.service.mu.Unlock()
-	return err
-}
-
-func (service *Service) Snapshot(ctx context.Context, selector Selector, pin string) (Snapshot, error) {
-	readers, err := service.Readers(ctx)
-	if err != nil {
-		return Snapshot{}, err
-	}
-	reader, ok := matchReader(readers, selector)
-	if !ok {
-		return Snapshot{}, ErrReaderNotFound
-	}
-	result := Snapshot{Reader: reader}
-	if reader.DiscoveryIssue != "" {
-		return result, fmt.Errorf("%w: %s", ErrUnavailable, reader.DiscoveryIssue)
-	}
-	if !reader.CardPresent {
-		return result, ErrNoCard
-	}
-	identity, err := service.ReadIdentity(ctx, selector, pin)
-	result.Identity = identity
-	return result, err
-}
-
-func (service *Service) ReadIdentity(ctx context.Context, selector Selector, pin string) (Identity, error) {
-	if service == nil || service.backend == nil {
-		return Identity{}, ErrUnavailable
-	}
-	if err := selector.validate(); err != nil {
-		return Identity{}, err
-	}
-	service.mu.Lock()
-	defer service.mu.Unlock()
-	card, err := service.backend.Open(ctx, selector)
-	if err != nil {
-		return Identity{}, err
-	}
-	defer card.Close()
-	return readIdentity(ctx, card, pin)
-}
-
-func (service *Service) CheckReady(
-	ctx context.Context,
-	selector Selector,
-	expectedICCID string,
-	pin string,
-) (string, error) {
-	if service == nil || service.backend == nil {
-		return "", ErrUnavailable
-	}
-	service.mu.Lock()
-	defer service.mu.Unlock()
-	card, err := service.backend.Open(ctx, selector)
-	if err != nil {
-		return "", err
-	}
-	defer card.Close()
-	iccid, err := readICCID(ctx, card)
-	if err != nil {
-		return "", err
-	}
-	if expected := strings.TrimSpace(expectedICCID); expected != "" && !strings.EqualFold(expected, iccid) {
-		return "", ErrCardChanged
-	}
-	aid, err := selectUSIM(ctx, card)
-	if err != nil {
-		return "", err
-	}
-	if err := verifyPIN(ctx, card, pin); err != nil {
-		return "", err
-	}
-	return strings.ToUpper(hex.EncodeToString(aid)), nil
-}
-
-func (service *Service) Authenticate(
-	ctx context.Context,
-	selector Selector,
-	expectedICCID string,
-	pin string,
-	challenge AKAChallenge,
-) (AKAResult, error) {
-	if service == nil || service.backend == nil {
-		return AKAResult{}, ErrUnavailable
-	}
-	service.mu.Lock()
-	defer service.mu.Unlock()
-	card, err := service.backend.Open(ctx, selector)
-	if err != nil {
-		return AKAResult{}, err
-	}
-	defer card.Close()
-	iccid, err := readICCID(ctx, card)
-	if err != nil {
-		return AKAResult{}, err
-	}
-	if expected := strings.TrimSpace(expectedICCID); expected != "" && !strings.EqualFold(expected, iccid) {
-		return AKAResult{}, ErrCardChanged
-	}
-	if _, err := selectUSIM(ctx, card); err != nil {
-		return AKAResult{}, err
-	}
-	if err := verifyPIN(ctx, card, pin); err != nil {
-		return AKAResult{}, err
-	}
-	apdu := make([]byte, 0, 40)
-	apdu = append(apdu, 0x00, 0x88, 0x00, 0x81, 0x22, 0x10)
-	apdu = append(apdu, challenge.RAND[:]...)
-	apdu = append(apdu, 0x10)
-	apdu = append(apdu, challenge.AUTN[:]...)
-	apdu = append(apdu, 0x00)
-	data, sw, err := card.Transmit(ctx, apdu)
-	if err != nil {
-		return AKAResult{}, errors.New("pcsc: USIM authentication transport failed")
-	}
-	if sw == 0x9862 {
-		return AKAResult{}, ErrAKARejected
-	}
-	if sw != 0x9000 {
-		return AKAResult{}, fmt.Errorf("pcsc: USIM authentication failed with status %04X", sw)
-	}
-	return parseAKAResponse(data)
-}
-
-func matchReader(readers []Reader, selector Selector) (Reader, bool) {
-	path := strings.TrimSpace(selector.USBPath)
-	name := strings.TrimSpace(selector.ReaderName)
-	for _, reader := range readers {
-		if path != "" && reader.USBPath == path {
-			return reader, true
-		}
-	}
-	for _, reader := range readers {
-		if name != "" && reader.Name == name {
-			return reader, true
-		}
-	}
-	return Reader{}, false
-}
-
-func readIdentity(ctx context.Context, card Card, pin string) (Identity, error) {
-	identity := Identity{PINTries: -1}
-	iccid, err := readICCID(ctx, card)
-	if err != nil {
-		return identity, err
-	}
-	identity.ICCID = iccid
-	aid, err := selectUSIM(ctx, card)
-	if err != nil {
-		return identity, err
-	}
-	identity.USIMAID = append([]byte(nil), aid...)
-	if err := verifyPIN(ctx, card, pin); err != nil {
-		identity.PINRequired = errors.Is(err, ErrPINRequired) || errors.Is(err, ErrPINTriesLow)
-		var pinErr *PINError
-		if errors.As(err, &pinErr) {
-			identity.PINTries = pinErr.Tries
-		}
-		return identity, err
-	}
-	if err := selectFile(ctx, card, []byte{0x6F, 0x07}); err != nil {
-		return identity, fmt.Errorf("pcsc: select EF_IMSI: %w", err)
-	}
-	imsiData, err := readBinary(ctx, card, 9)
-	if err != nil {
-		return identity, fmt.Errorf("pcsc: read EF_IMSI: %w", err)
-	}
-	identity.IMSI, err = decodeIMSI(imsiData)
-	if err != nil {
-		return identity, err
-	}
-	if _, selectErr := selectApplication(ctx, card, aid); selectErr == nil {
-		if selectErr = selectFile(ctx, card, []byte{0x6F, 0xAD}); selectErr == nil {
-			if data, readErr := readBinary(ctx, card, 4); readErr == nil && len(data) >= 4 {
-				length := int(data[3] & 0x0f)
-				if length == 2 || length == 3 {
-					identity.MNCLength = length
-				}
-			}
-		}
-	}
-	if _, selectErr := selectApplication(ctx, card, aid); selectErr == nil {
-		identity.SPN = readSPN(ctx, card)
-	}
-	if _, selectErr := selectApplication(ctx, card, aid); selectErr == nil {
-		identity.SMSC = readSMSC(ctx, card)
-	}
-	return identity, nil
-}
-
-func readICCID(ctx context.Context, card Card) (string, error) {
-	if err := selectMF(ctx, card); err != nil {
-		return "", err
-	}
-	if err := selectFile(ctx, card, []byte{0x2F, 0xE2}); err != nil {
-		return "", fmt.Errorf("pcsc: select EF_ICCID: %w", err)
-	}
-	data, err := readBinary(ctx, card, 10)
-	if err != nil {
-		return "", fmt.Errorf("pcsc: read EF_ICCID: %w", err)
-	}
-	value := decodeSwappedBCD(data, false)
-	if len(value) < 18 || len(value) > 22 {
-		return "", errors.New("pcsc: card returned an invalid ICCID")
-	}
-	return value, nil
-}
-
-func selectUSIM(ctx context.Context, card Card) ([]byte, error) {
-	if err := selectMF(ctx, card); err != nil {
-		return nil, err
-	}
-	if err := selectFile(ctx, card, []byte{0x2F, 0x00}); err != nil {
-		return nil, fmt.Errorf("pcsc: select EF_DIR: %w", err)
-	}
-	var usimAID []byte
-	for record := 1; record <= 32; record++ {
-		data, sw, err := card.Transmit(ctx, []byte{0x00, 0xB2, byte(record), 0x04, 0x00})
-		if err != nil {
-			return nil, err
-		}
-		if sw == 0x6A83 || sw == 0x9402 {
-			break
-		}
-		if sw != 0x9000 {
-			continue
-		}
-		aid := findTLV(data, 0x4F)
-		if len(aid) == 0 {
-			continue
-		}
-		if strings.HasPrefix(strings.ToUpper(hex.EncodeToString(aid)), usimAIDPrefix) {
-			usimAID = append([]byte(nil), aid...)
-			break
-		}
-	}
-	if len(usimAID) == 0 {
-		return nil, ErrUSIMUnavailable
-	}
-	if _, err := selectApplication(ctx, card, usimAID); err != nil {
-		return nil, err
-	}
-	return usimAID, nil
-}
-
-func selectMF(ctx context.Context, card Card) error {
-	_, sw, err := card.Transmit(ctx, []byte{0x00, 0xA4, 0x00, 0x04, 0x02, 0x3F, 0x00, 0x00})
-	return requireStatus("select MF", sw, err)
-}
-
-func selectFile(ctx context.Context, card Card, fileID []byte) error {
-	if len(fileID) != 2 {
-		return errors.New("pcsc: invalid file identifier")
-	}
-	apdu := []byte{0x00, 0xA4, 0x00, 0x04, 0x02, fileID[0], fileID[1], 0x00}
-	_, sw, err := card.Transmit(ctx, apdu)
-	return requireStatus("select file", sw, err)
-}
-
-func selectApplication(ctx context.Context, card Card, aid []byte) ([]byte, error) {
-	if len(aid) == 0 || len(aid) > 32 {
-		return nil, errors.New("pcsc: invalid USIM AID")
-	}
-	apdu := []byte{0x00, 0xA4, 0x04, 0x04, byte(len(aid))}
-	apdu = append(apdu, aid...)
-	apdu = append(apdu, 0x00)
-	data, sw, err := card.Transmit(ctx, apdu)
-	if err := requireStatus("select USIM application", sw, err); err != nil {
-		return nil, err
-	}
-	return data, nil
-}
-
-func readBinary(ctx context.Context, card Card, length int) ([]byte, error) {
-	if length <= 0 || length > 256 {
-		return nil, errors.New("pcsc: invalid binary read length")
-	}
-	le := byte(length)
-	if length == 256 {
-		le = 0
-	}
-	data, sw, err := card.Transmit(ctx, []byte{0x00, 0xB0, 0x00, 0x00, le})
-	if err := requireStatus("read binary", sw, err); err != nil {
-		return nil, err
-	}
-	return data, nil
-}
-
-func verifyPIN(ctx context.Context, card Card, pin string) error {
-	pin = strings.TrimSpace(pin)
-	if pin == "" {
-		return nil
-	}
-	if len(pin) < 4 || len(pin) > 8 || !decimalDigits(pin) {
-		return errors.New("pcsc: SIM PIN must contain 4 to 8 digits")
-	}
-	_, sw, err := card.Transmit(ctx, []byte{0x00, 0x20, 0x00, 0x01, 0x00})
-	if err != nil {
-		return errors.New("pcsc: SIM PIN status check failed")
-	}
-	if sw == 0x9000 {
-		return nil
-	}
-	tries := -1
-	if sw&0xFFF0 == 0x63C0 {
-		tries = int(sw & 0x000F)
-		if tries <= 2 {
-			return &PINError{Kind: ErrPINTriesLow, Tries: tries}
-		}
-	}
-	body := bytes.Repeat([]byte{0xFF}, 8)
-	copy(body, []byte(pin))
-	apdu := append([]byte{0x00, 0x20, 0x00, 0x01, 0x08}, body...)
-	_, sw, err = card.Transmit(ctx, apdu)
-	if err != nil {
-		return errors.New("pcsc: SIM PIN verification transport failed")
-	}
-	if sw == 0x9000 {
-		return nil
-	}
-	if sw&0xFFF0 == 0x63C0 {
-		return &PINError{Kind: ErrPINRejected, Tries: int(sw & 0x000F)}
-	}
-	return ErrPINRejected
-}
-
-func requireStatus(operation string, sw uint16, err error) error {
-	if err != nil {
-		return fmt.Errorf("pcsc: %s transport failed", operation)
-	}
-	if sw == 0x9000 {
-		return nil
-	}
-	if sw == 0x6982 || sw == 0x9804 {
-		return &PINError{Kind: ErrPINRequired, Tries: -1}
-	}
-	return fmt.Errorf("pcsc: %s failed with status %04X", operation, sw)
-}
-
-func decodeSwappedBCD(value []byte, dropFirstNibble bool) string {
-	var result strings.Builder
-	for _, octet := range value {
-		for _, nibble := range []byte{octet & 0x0F, octet >> 4} {
-			if dropFirstNibble {
-				dropFirstNibble = false
-				continue
-			}
-			if nibble == 0x0F {
-				return result.String()
-			}
-			if nibble > 9 {
-				return ""
-			}
-			result.WriteByte('0' + nibble)
-		}
-	}
-	return result.String()
-}
-
-func decodeIMSI(data []byte) (string, error) {
-	if len(data) < 2 {
-		return "", errors.New("pcsc: EF_IMSI is too short")
-	}
-	length := int(data[0])
-	if length <= 0 || length > len(data)-1 {
-		return "", errors.New("pcsc: EF_IMSI has an invalid length")
-	}
-	value := decodeSwappedBCD(data[1:1+length], true)
-	if len(value) < 10 || len(value) > 18 || !decimalDigits(value) {
-		return "", errors.New("pcsc: card returned an invalid IMSI")
-	}
-	return value, nil
-}
-
-func decimalDigits(value string) bool {
-	if value == "" {
-		return false
-	}
-	for _, character := range value {
-		if character < '0' || character > '9' {
-			return false
-		}
-	}
-	return true
-}
-
-func findTLV(data []byte, wanted byte) []byte {
-	for len(data) >= 2 {
-		tag := data[0]
-		data = data[1:]
-		length, consumed, ok := decodeTLVLength(data)
-		if !ok || consumed+length > len(data) {
-			return nil
-		}
-		value := data[consumed : consumed+length]
-		if tag == wanted {
-			return append([]byte(nil), value...)
-		}
-		if tag&0x20 != 0 {
-			if nested := findTLV(value, wanted); len(nested) > 0 {
-				return nested
-			}
-		}
-		data = data[consumed+length:]
-	}
-	return nil
-}
-
-func decodeTLVLength(data []byte) (length, consumed int, ok bool) {
-	if len(data) == 0 {
-		return 0, 0, false
-	}
-	if data[0]&0x80 == 0 {
-		return int(data[0]), 1, true
-	}
-	count := int(data[0] & 0x7F)
-	if count < 1 || count > 2 || len(data) < 1+count {
-		return 0, 0, false
-	}
-	length = 0
-	for _, octet := range data[1 : 1+count] {
-		length = length<<8 | int(octet)
-	}
-	return length, 1 + count, true
-}
-
-func parseAKAResponse(data []byte) (AKAResult, error) {
-	if len(data) < 2 {
-		return AKAResult{}, errors.New("pcsc: USIM returned a short AKA response")
-	}
-	switch data[0] {
-	case 0xDB:
-		res, rest, ok := takeLV(data[1:])
-		if !ok || len(res) < 4 || len(res) > 16 {
-			return AKAResult{}, errors.New("pcsc: USIM returned an invalid AKA RES")
-		}
-		ck, rest, ok := takeLV(rest)
-		if !ok || len(ck) != 16 {
-			return AKAResult{}, errors.New("pcsc: USIM returned an invalid AKA CK")
-		}
-		ik, rest, ok := takeLV(rest)
-		if !ok || len(ik) != 16 {
-			return AKAResult{}, errors.New("pcsc: USIM returned an invalid AKA IK")
-		}
-		if len(rest) > 0 {
-			kc, tail, valid := takeLV(rest)
-			if !valid || len(kc) != 8 || len(tail) != 0 {
-				return AKAResult{}, errors.New("pcsc: USIM returned invalid trailing AKA material")
-			}
-		}
-		return AKAResult{RES: append([]byte(nil), res...), CK: append([]byte(nil), ck...), IK: append([]byte(nil), ik...)}, nil
-	case 0xDC:
-		auts, tail, ok := takeLV(data[1:])
-		if !ok || len(auts) != 14 || len(tail) != 0 {
-			return AKAResult{}, errors.New("pcsc: USIM returned invalid AKA synchronization evidence")
-		}
-		return AKAResult{AUTS: append([]byte(nil), auts...), SynchronizationFailure: true}, nil
-	default:
-		return AKAResult{}, errors.New("pcsc: USIM returned an unsupported AKA response")
-	}
-}
-
-func takeLV(data []byte) (value, rest []byte, ok bool) {
-	if len(data) == 0 || int(data[0]) > len(data)-1 {
-		return nil, data, false
-	}
-	length := int(data[0])
-	return data[1 : 1+length], data[1+length:], true
-}
-
-func readSPN(ctx context.Context, card Card) string {
-	if err := selectFile(ctx, card, []byte{0x6F, 0x46}); err != nil {
-		return ""
-	}
-	data, err := readBinary(ctx, card, 17)
-	if err != nil || len(data) < 2 {
-		return ""
-	}
-	return strings.TrimSpace(strings.TrimRight(string(data[1:]), "\x00\xFF"))
-}
-
-func readSMSC(ctx context.Context, card Card) string {
-	if err := selectFile(ctx, card, []byte{0x6F, 0x42}); err != nil {
-		return ""
-	}
-	data, sw, err := card.Transmit(ctx, []byte{0x00, 0xB2, 0x01, 0x04, 0x00})
-	if err != nil || sw != 0x9000 || len(data) < 15 {
-		return ""
-	}
-	sca := data[len(data)-15 : len(data)-3]
-	if len(sca) < 2 || sca[0] < 2 || int(sca[0]) > len(sca)-1 {
-		return ""
-	}
-	digits := decodeSwappedBCD(sca[2:1+int(sca[0])], false)
-	if !decimalDigits(digits) {
-		return ""
-	}
-	if sca[1]&0x70 == 0x10 {
-		return "+" + digits
-	}
-	return digits
-}

internal/pcsc/service_test.go

@@ -1,102 +0,0 @@
-package pcsc
-
-import (
-	"bytes"
-	"context"
-	"errors"
-	"testing"
-)
-
-type scriptedReply struct {
-	data []byte
-	sw   uint16
-}
-
-type scriptedCard struct {
-	replies []scriptedReply
-	calls   [][]byte
-}
-
-type unavailableReaderBackend struct{}
-
-func (unavailableReaderBackend) Readers(context.Context) ([]Reader, error) {
-	return []Reader{{Name: "ACR38", USBPath: "2-1", DiscoveryIssue: "pcsc_service_unavailable"}}, nil
-}
-
-func (unavailableReaderBackend) Open(context.Context, Selector) (Card, error) {
-	return nil, errors.New("Open must not be called for a diagnostic-only reader")
-}
-
-func (card *scriptedCard) Transmit(_ context.Context, command []byte) ([]byte, uint16, error) {
-	card.calls = append(card.calls, append([]byte(nil), command...))
-	if len(card.replies) == 0 {
-		return nil, 0, errors.New("unexpected APDU")
-	}
-	reply := card.replies[0]
-	card.replies = card.replies[1:]
-	return append([]byte(nil), reply.data...), reply.sw, nil
-}
-
-func (*scriptedCard) Close() error { return nil }
-
-func TestDecodeIdentifiers(t *testing.T) {
-	if got := decodeSwappedBCD([]byte{0x98, 0x10, 0x32, 0x54, 0xF6}, false); got != "890123456" {
-		t.Fatalf("ICCID BCD = %q", got)
-	}
-	imsi, err := decodeIMSI([]byte{0x08, 0x19, 0x32, 0x54, 0x76, 0x98, 0x10, 0x32, 0x54})
-	if err != nil {
-		t.Fatal(err)
-	}
-	if imsi != "123456789012345" {
-		t.Fatalf("IMSI = %q", imsi)
-	}
-}
-
-func TestVerifyPINRefusesLowAttemptCount(t *testing.T) {
-	card := &scriptedCard{replies: []scriptedReply{{sw: 0x63C2}}}
-	err := verifyPIN(context.Background(), card, "1234")
-	if !errors.Is(err, ErrPINTriesLow) {
-		t.Fatalf("error = %v", err)
-	}
-	if len(card.calls) != 1 {
-		t.Fatalf("APDU calls = %d, PIN must not be submitted", len(card.calls))
-	}
-}
-
-func TestParseAKAResponse(t *testing.T) {
-	data := []byte{0xDB, 0x08, 1, 2, 3, 4, 5, 6, 7, 8, 0x10}
-	data = append(data, bytes.Repeat([]byte{0xAA}, 16)...)
-	data = append(data, 0x10)
-	data = append(data, bytes.Repeat([]byte{0xBB}, 16)...)
-	result, err := parseAKAResponse(data)
-	if err != nil {
-		t.Fatal(err)
-	}
-	if len(result.RES) != 8 || len(result.CK) != 16 || len(result.IK) != 16 || result.SynchronizationFailure {
-		t.Fatalf("unexpected AKA result: %#v", result)
-	}
-
-	syncResult, err := parseAKAResponse(append([]byte{0xDC, 0x0E}, bytes.Repeat([]byte{0xCC}, 14)...))
-	if err != nil {
-		t.Fatal(err)
-	}
-	if !syncResult.SynchronizationFailure || len(syncResult.AUTS) != 14 {
-		t.Fatalf("unexpected sync result: %#v", syncResult)
-	}
-}
-
-func TestDeviceIDUsesStableUSBPath(t *testing.T) {
-	a := DeviceID(Reader{Name: "reader 00 00", USBPath: "1-3"})
-	b := DeviceID(Reader{Name: "renamed reader", USBPath: "1-3"})
-	if a != b || a == "" {
-		t.Fatalf("device IDs = %q, %q", a, b)
-	}
-}
-
-func TestSnapshotRejectsPhysicalReaderUntilPCSCDIsReady(t *testing.T) {
-	service := NewWithBackend(unavailableReaderBackend{})
-	snapshot, err := service.Snapshot(context.Background(), Selector{USBPath: "2-1"}, "")
-	if !errors.Is(err, ErrUnavailable) || snapshot.Reader.USBPath != "2-1" {
-		t.Fatalf("Snapshot() = %#v, %v", snapshot, err)
-	}
-}

internal/pcsc/types.go

@@ -1,111 +0,0 @@
-package pcsc
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"strings"
-)
-
-const HardwareKind = "pcsc"
-
-var (
-	ErrUnsupported     = errors.New("pcsc: platform is not supported")
-	ErrUnavailable     = errors.New("pcsc: service is unavailable")
-	ErrReaderNotFound  = errors.New("pcsc: reader not found")
-	ErrNoCard          = errors.New("pcsc: no card is inserted")
-	ErrPINRequired     = errors.New("pcsc: SIM PIN is required")
-	ErrPINTriesLow     = errors.New("pcsc: refusing PIN verification because too few attempts remain")
-	ErrPINRejected     = errors.New("pcsc: SIM PIN was rejected")
-	ErrUSIMUnavailable = errors.New("pcsc: no usable USIM application was found")
-	ErrCardChanged     = errors.New("pcsc: card identity changed during authentication")
-	ErrAKARejected     = errors.New("pcsc: USIM rejected the network authentication token")
-)
-
-type Reader struct {
-	Name         string
-	USBPath      string
-	VendorID     string
-	ProductID    string
-	Manufacturer string
-	Product      string
-	CardPresent  bool
-	ATR          string
-	// DiscoveryIssue is set when USB sees a smart-card reader but pcscd cannot
-	// expose it yet. Keeping the physical reader visible lets the UI explain the
-	// missing service/driver instead of silently showing an empty device list.
-	DiscoveryIssue string
-}
-
-type Selector struct {
-	USBPath    string
-	ReaderName string
-}
-
-func (selector Selector) validate() error {
-	if strings.TrimSpace(selector.USBPath) == "" && strings.TrimSpace(selector.ReaderName) == "" {
-		return errors.New("pcsc: reader selector is empty")
-	}
-	return nil
-}
-
-type Identity struct {
-	ICCID       string
-	IMSI        string
-	MNCLength   int
-	USIMAID     []byte
-	SMSC        string
-	SPN         string
-	PINRequired bool
-	PINTries    int
-}
-
-type Snapshot struct {
-	Reader   Reader
-	Identity Identity
-}
-
-type AKAChallenge struct {
-	RAND [16]byte
-	AUTN [16]byte
-}
-
-type AKAResult struct {
-	RES                    []byte
-	CK                     []byte
-	IK                     []byte
-	AUTS                   []byte
-	SynchronizationFailure bool
-}
-
-type PINError struct {
-	Kind  error
-	Tries int
-}
-
-func (err *PINError) Error() string {
-	if err == nil {
-		return "pcsc: SIM PIN error"
-	}
-	if err.Tries >= 0 {
-		return fmt.Sprintf("%v (%d attempts remain)", err.Kind, err.Tries)
-	}
-	return err.Kind.Error()
-}
-
-func (err *PINError) Unwrap() error {
-	if err == nil {
-		return nil
-	}
-	return err.Kind
-}
-
-type Card interface {
-	Transmit(context.Context, []byte) ([]byte, uint16, error)
-	Close() error
-}
-
-type Backend interface {
-	Readers(context.Context) ([]Reader, error)
-	Open(context.Context, Selector) (Card, error)
-}

internal/pcsc/usb_discovery.go

@@ -1,97 +0,0 @@
-package pcsc
-
-import (
-	"fmt"
-	"os"
-	"path/filepath"
-	"sort"
-	"strings"
-)
-
-const usbSmartCardInterfaceClass = "0b"
-
-// discoverUSBSmartCardReaders finds physical USB CCID interfaces directly in
-// sysfs. It is a diagnostic fallback; APDU access still goes through pcscd.
-func discoverUSBSmartCardReaders(sysRoot, issue string) []Reader {
-	usbRoot := filepath.Join(filepath.Clean(sysRoot), "bus", "usb", "devices")
-	entries, err := os.ReadDir(usbRoot)
-	if err != nil {
-		return nil
-	}
-	deviceNames := make(map[string]struct{})
-	for _, entry := range entries {
-		name := entry.Name()
-		class := strings.ToLower(readTrimmedFile(filepath.Join(usbRoot, name, "bInterfaceClass")))
-		if deviceName, ok := smartCardUSBDeviceName(name, class); ok {
-			deviceNames[deviceName] = struct{}{}
-		}
-	}
-	result := make([]Reader, 0, len(deviceNames))
-	for deviceName := range deviceNames {
-		path := filepath.Join(usbRoot, deviceName)
-		vendorID := strings.ToLower(readTrimmedFile(filepath.Join(path, "idVendor")))
-		productID := strings.ToLower(readTrimmedFile(filepath.Join(path, "idProduct")))
-		if vendorID == "" || productID == "" {
-			continue
-		}
-		product := readTrimmedFile(filepath.Join(path, "product"))
-		if product == "" {
-			product = fmt.Sprintf("USB smart card reader %s:%s", vendorID, productID)
-		}
-		result = append(result, Reader{
-			Name: product, USBPath: deviceName,
-			VendorID: vendorID, ProductID: productID,
-			Manufacturer: readTrimmedFile(filepath.Join(path, "manufacturer")),
-			Product:      product, DiscoveryIssue: issue,
-		})
-	}
-	sort.Slice(result, func(i, j int) bool { return result[i].USBPath < result[j].USBPath })
-	return result
-}
-
-func smartCardUSBDeviceName(interfaceName, class string) (string, bool) {
-	deviceName, _, interfaceEntry := strings.Cut(interfaceName, ":")
-	return deviceName, interfaceEntry && deviceName != "" && strings.EqualFold(strings.TrimSpace(class), usbSmartCardInterfaceClass)
-}
-
-func readTrimmedFile(path string) string {
-	value, err := os.ReadFile(path)
-	if err != nil {
-		return ""
-	}
-	return strings.TrimSpace(string(value))
-}
-
-func mergePCSCAndUSBReaders(readers, physical []Reader) []Reader {
-	if len(readers) == 1 && len(physical) == 1 && strings.HasPrefix(readers[0].USBPath, "pcsc:") {
-		readers[0] = enrichPCSCReader(readers[0], physical[0])
-		return readers
-	}
-	seen := make(map[string]bool, len(readers))
-	for i := range readers {
-		seen[readers[i].USBPath] = true
-		for _, usbReader := range physical {
-			if readers[i].USBPath == usbReader.USBPath {
-				readers[i] = enrichPCSCReader(readers[i], usbReader)
-			}
-		}
-	}
-	for _, usbReader := range physical {
-		if !seen[usbReader.USBPath] {
-			readers = append(readers, usbReader)
-		}
-	}
-	return readers
-}
-
-func enrichPCSCReader(reader, physical Reader) Reader {
-	reader.USBPath = physical.USBPath
-	reader.VendorID = physical.VendorID
-	reader.ProductID = physical.ProductID
-	reader.Manufacturer = physical.Manufacturer
-	if reader.Product == "" {
-		reader.Product = physical.Product
-	}
-	reader.DiscoveryIssue = ""
-	return reader
-}

internal/pcsc/usb_discovery_test.go

@@ -1,61 +0,0 @@
-package pcsc
-
-import (
-	"os"
-	"path/filepath"
-	"runtime"
-	"testing"
-)
-
-func TestDiscoverUSBSmartCardReadersFindsACR38(t *testing.T) {
-	if runtime.GOOS == "windows" {
-		t.Skip("Windows filenames cannot represent Linux sysfs interface names containing a colon")
-	}
-	root := t.TempDir()
-	usbRoot := filepath.Join(root, "bus", "usb", "devices")
-	writeUSBTestFile(t, filepath.Join(usbRoot, "2-1", "idVendor"), "072f\n")
-	writeUSBTestFile(t, filepath.Join(usbRoot, "2-1", "idProduct"), "90cc\n")
-	writeUSBTestFile(t, filepath.Join(usbRoot, "2-1", "manufacturer"), "Advanced Card Systems\n")
-	writeUSBTestFile(t, filepath.Join(usbRoot, "2-1", "product"), "ACR38 SmartCard Reader\n")
-	writeUSBTestFile(t, filepath.Join(usbRoot, "2-1:1.0", "bInterfaceClass"), "0b\n")
-	writeUSBTestFile(t, filepath.Join(usbRoot, "3-1", "idVendor"), "2c7c\n")
-	writeUSBTestFile(t, filepath.Join(usbRoot, "3-1:1.0", "bInterfaceClass"), "ff\n")
-
-	readers := discoverUSBSmartCardReaders(root, "pcsc_service_unavailable")
-	if len(readers) != 1 {
-		t.Fatalf("readers = %#v", readers)
-	}
-	reader := readers[0]
-	if reader.USBPath != "2-1" || reader.VendorID != "072f" || reader.ProductID != "90cc" || reader.DiscoveryIssue != "pcsc_service_unavailable" {
-		t.Fatalf("reader = %#v", reader)
-	}
-}
-
-func TestSmartCardUSBDeviceName(t *testing.T) {
-	if name, ok := smartCardUSBDeviceName("2-1:1.0", "0B"); !ok || name != "2-1" {
-		t.Fatalf("smartCardUSBDeviceName() = %q, %v", name, ok)
-	}
-	if _, ok := smartCardUSBDeviceName("2-1:1.0", "ff"); ok {
-		t.Fatal("vendor-specific interface was accepted as CCID")
-	}
-}
-
-func TestMergePCSCAndSingleUSBReaderEnrichesFallbackPath(t *testing.T) {
-	readers := mergePCSCAndUSBReaders(
-		[]Reader{{Name: "ACS ACR38 00 00", USBPath: "pcsc:ACS ACR38 00 00", CardPresent: true}},
-		[]Reader{{Name: "ACR38", USBPath: "2-1", VendorID: "072f", ProductID: "90cc", DiscoveryIssue: "pcsc_driver_missing"}},
-	)
-	if len(readers) != 1 || readers[0].USBPath != "2-1" || readers[0].DiscoveryIssue != "" || !readers[0].CardPresent {
-		t.Fatalf("readers = %#v", readers)
-	}
-}
-
-func writeUSBTestFile(t *testing.T, path, value string) {
-	t.Helper()
-	if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
-		t.Fatal(err)
-	}
-	if err := os.WriteFile(path, []byte(value), 0o644); err != nil {
-		t.Fatal(err)
-	}
-}

internal/qmiport/lease.go

@@ -1,145 +0,0 @@
-// Package qmiport coordinates access to native Linux WWAN QMI control ports.
-package qmiport
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"os"
-	"path/filepath"
-	"sync"
-	"syscall"
-)
-
-type portHandle interface {
-	Close() error
-	Stat() (os.FileInfo, error)
-}
-
-type portOpener func(string) (portHandle, error)
-
-type entry struct {
-	gate chan struct{}
-
-	keeperMu sync.Mutex
-	keeper   portHandle
-}
-
-type coordinator struct {
-	mu      sync.Mutex
-	entries map[string]*entry
-	opener  portOpener
-}
-
-// Lease serializes one QMI transaction sequence for a control port. Release
-// does not close the keepalive descriptor: the old OpenStick 410 WWAN driver
-// removes DATA5_CNTL when the final descriptor closes, and does not reliably
-// recreate it until the modem is reset.
-type Lease struct {
-	entry *entry
-	once  sync.Once
-}
-
-var processCoordinator = newCoordinator(openPort)
-
-func newCoordinator(opener portOpener) *coordinator {
-	return &coordinator{
-		entries: make(map[string]*entry),
-		opener:  opener,
-	}
-}
-
-func openPort(path string) (portHandle, error) {
-	return os.OpenFile(path, os.O_RDWR|syscall.O_NONBLOCK|syscall.O_NOCTTY, 0)
-}
-
-// Acquire keeps path open for the process lifetime and grants exclusive QMI
-// access until the returned lease is released. A modem reset replaces the
-// device node; ensureKeeper detects that inode change and rearms the keepalive.
-func Acquire(ctx context.Context, path string) (*Lease, error) {
-	return processCoordinator.acquire(ctx, path)
-}
-
-func (coordinator *coordinator) acquire(ctx context.Context, path string) (*Lease, error) {
-	if ctx == nil {
-		ctx = context.Background()
-	}
-	path = filepath.Clean(path)
-	if path == "." || path == "" {
-		return nil, errors.New("QMI control path is required")
-	}
-	coordinator.mu.Lock()
-	item := coordinator.entries[path]
-	if item == nil {
-		item = &entry{gate: make(chan struct{}, 1)}
-		item.gate <- struct{}{}
-		coordinator.entries[path] = item
-	}
-	coordinator.mu.Unlock()
-
-	select {
-	case <-ctx.Done():
-		return nil, ctx.Err()
-	case <-item.gate:
-	}
-	if err := coordinator.ensureKeeper(path, item); err != nil {
-		item.gate <- struct{}{}
-		return nil, fmt.Errorf("keep QMI control port %s open: %w", path, err)
-	}
-	return &Lease{entry: item}, nil
-}
-
-func (coordinator *coordinator) ensureKeeper(path string, item *entry) error {
-	item.keeperMu.Lock()
-	defer item.keeperMu.Unlock()
-
-	currentInfo, err := os.Stat(path)
-	if err != nil {
-		return err
-	}
-	if item.keeper != nil {
-		keeperInfo, statErr := item.keeper.Stat()
-		if statErr == nil && os.SameFile(currentInfo, keeperInfo) {
-			return nil
-		}
-		_ = item.keeper.Close()
-		item.keeper = nil
-	}
-	keeper, err := coordinator.opener(path)
-	if err != nil {
-		return err
-	}
-	item.keeper = keeper
-	return nil
-}
-
-// Release allows the next QMI-UIM operation to use this control port.
-func (lease *Lease) Release() {
-	if lease == nil || lease.entry == nil {
-		return
-	}
-	lease.once.Do(func() {
-		lease.entry.gate <- struct{}{}
-	})
-}
-
-func (coordinator *coordinator) close() error {
-	coordinator.mu.Lock()
-	entries := make([]*entry, 0, len(coordinator.entries))
-	for _, item := range coordinator.entries {
-		entries = append(entries, item)
-	}
-	coordinator.entries = make(map[string]*entry)
-	coordinator.mu.Unlock()
-
-	var errs []error
-	for _, item := range entries {
-		item.keeperMu.Lock()
-		if item.keeper != nil {
-			errs = append(errs, item.keeper.Close())
-			item.keeper = nil
-		}
-		item.keeperMu.Unlock()
-	}
-	return errors.Join(errs...)
-}

internal/qmiport/lease_test.go

@@ -1,77 +0,0 @@
-package qmiport
-
-import (
-	"context"
-	"os"
-	"path/filepath"
-	"sync/atomic"
-	"testing"
-	"time"
-)
-
-func TestLeaseKeepsPortOpenAndSerializesUsers(t *testing.T) {
-	path := filepath.Join(t.TempDir(), "wwan0qmi0")
-	if err := os.WriteFile(path, nil, 0o600); err != nil {
-		t.Fatal(err)
-	}
-	var opens atomic.Int32
-	coordinator := newCoordinator(func(path string) (portHandle, error) {
-		opens.Add(1)
-		return os.OpenFile(path, os.O_RDWR, 0)
-	})
-	t.Cleanup(func() { _ = coordinator.close() })
-
-	first, err := coordinator.acquire(context.Background(), path)
-	if err != nil {
-		t.Fatalf("first acquire: %v", err)
-	}
-	ctx, cancel := context.WithTimeout(context.Background(), 20*time.Millisecond)
-	defer cancel()
-	if _, err := coordinator.acquire(ctx, path); err == nil {
-		t.Fatal("second acquire succeeded before the first lease was released")
-	}
-	first.Release()
-
-	second, err := coordinator.acquire(context.Background(), path)
-	if err != nil {
-		t.Fatalf("second acquire: %v", err)
-	}
-	second.Release()
-	if got := opens.Load(); got != 1 {
-		t.Fatalf("keepalive opens = %d, want 1", got)
-	}
-}
-
-func TestLeaseReopensReplacedDeviceNode(t *testing.T) {
-	directory := t.TempDir()
-	path := filepath.Join(directory, "wwan0qmi0")
-	if err := os.WriteFile(path, nil, 0o600); err != nil {
-		t.Fatal(err)
-	}
-	var opens atomic.Int32
-	coordinator := newCoordinator(func(path string) (portHandle, error) {
-		opens.Add(1)
-		return os.OpenFile(path, os.O_RDWR, 0)
-	})
-	t.Cleanup(func() { _ = coordinator.close() })
-
-	first, err := coordinator.acquire(context.Background(), path)
-	if err != nil {
-		t.Fatal(err)
-	}
-	first.Release()
-	if err := os.Remove(path); err != nil {
-		t.Fatal(err)
-	}
-	if err := os.WriteFile(path, nil, 0o600); err != nil {
-		t.Fatal(err)
-	}
-	second, err := coordinator.acquire(context.Background(), path)
-	if err != nil {
-		t.Fatal(err)
-	}
-	second.Release()
-	if got := opens.Load(); got != 2 {
-		t.Fatalf("keepalive opens = %d, want 2 after node replacement", got)
-	}
-}

internal/server/automatic_task_notifications.go

@@ -31,7 +31,6 @@ type automaticTaskNotification struct {
 }
 
 func (s *Server) notifyAutomaticTask(ctx context.Context, task store.AutomaticTask, run store.AutomaticTaskRun) {
-	ctx = s.notificationDestinationContext(ctx)
 	deviceLabel := task.DeviceID
 	if configured, err := s.store.Device(ctx, task.DeviceID); err == nil {
 		deviceLabel = firstNonEmpty(configured.Name, configured.ID)

internal/server/automatic_tasks.go

@@ -83,13 +83,7 @@ func (scheduler *automaticTaskScheduler) run() {
 }
 
 func (scheduler *automaticTaskScheduler) claim() {
-	var runs []store.AutomaticTaskRun
-	var err error
-	if scheduler.server.developerActive(scheduler.ctx) {
-		runs, err = scheduler.server.store.ClaimDueAutomaticTasks(scheduler.ctx, time.Now().UTC(), 50)
-	} else {
-		runs, err = scheduler.server.store.ClaimDueAvailableAutomaticTasks(scheduler.ctx, time.Now().UTC(), 50)
-	}
+	runs, err := scheduler.server.store.ClaimDueAutomaticTasks(scheduler.ctx, time.Now().UTC(), 50)
 	if err != nil {
 		scheduler.server.logger.Warn("claim automatic tasks", "error", err)
 		return
@@ -133,11 +127,6 @@ func (scheduler *automaticTaskScheduler) execute(run store.AutomaticTaskRun) {
 		_ = scheduler.server.store.UpdateAutomaticTaskRun(context.Background(), run)
 		return
 	}
-	if err := validateAutomaticTaskAvailability(scheduler.server.developerActive(scheduler.ctx), task.TaskType, task.Environment); err != nil {
-		run.Status, run.Error, run.FinishedAt = "failed", err.Error(), time.Now().UTC()
-		_ = scheduler.server.store.UpdateAutomaticTaskRun(context.Background(), run)
-		return
-	}
 	run.Status, run.StartedAt = "running", time.Now().UTC()
 	_ = scheduler.server.store.UpdateAutomaticTaskRun(context.Background(), run)
 	var output string
@@ -186,9 +175,6 @@ func (scheduler *automaticTaskScheduler) execute(run store.AutomaticTaskRun) {
 }
 
 func (s *Server) executeAutomaticTask(ctx context.Context, task store.AutomaticTask, progress automaticTaskProgress) (output string, err error) {
-	if err := validateAutomaticTaskAvailability(s.developerActive(ctx), task.TaskType, task.Environment); err != nil {
-		return "", automaticTaskExecutionError{err: err, retryable: false}
-	}
 	progress("正在检查设备和 eSIM Profile")
 	config, entry, physicalID, err := s.ensureAutomaticTaskProfile(ctx, task, progress)
 	if err != nil {
@@ -245,9 +231,6 @@ func (s *Server) ensureAutomaticTaskProfile(ctx context.Context, task store.Auto
 	if err != nil {
 		return store.Device{}, device.Device{}, "", fmt.Errorf("read device: %w", err)
 	}
-	if err := validateAutomaticTaskDeviceCapabilities(config, task.TaskType, task.Environment); err != nil {
-		return store.Device{}, device.Device{}, "", err
-	}
 	entry, physicalID, present := s.physicalForConfig(config)
 	if !present || entry.Snapshot == nil {
 		return store.Device{}, device.Device{}, "", errors.New("configured device is offline")
@@ -373,6 +356,9 @@ func (s *Server) prepareAutomaticTaskEnvironment(ctx context.Context, config *st
 		return err
 	}
 	if task.TaskType == "public_ip" {
+		if !s.developerActive(ctx) {
+			return errors.New("roaming public IP tasks require developer mode")
+		}
 		progress("已注册蜂窝网络，正在建立数据连接")
 		if _, err := s.devices.SetNetwork(ctx, physicalID, s.cardNetworkRequest(ctx, physicalID, *config, policy, true)); err != nil {
 			return fmt.Errorf("start roaming data: %w", err)
@@ -525,25 +511,6 @@ func (s *Server) restoreAutomaticTaskEnvironment(physicalID string, snapshot aut
 	if err := s.store.UpsertDevice(cleanupContext, config); err != nil {
 		restoreErrors = append(restoreErrors, fmt.Errorf("persist device policy: %w", err))
 	}
-	if config.DeviceType == store.DeviceTypeUSBSIMReader {
-		if s.vowifi == nil {
-			return errors.Join(append(restoreErrors, errors.New("VoWiFi runtime is unavailable"))...)
-		}
-		state, stateErr := s.vowifi.State(config.ID)
-		if policy.VoWiFiEnabled {
-			if stateErr == nil && state.Enabled {
-				_, stateErr = s.vowifi.RequestReconnect(config.ID)
-			} else {
-				_, stateErr = s.vowifi.RequestEnabled(config.ID, true)
-			}
-		} else if stateErr == nil && (state.Enabled || state.Active) {
-			_, stateErr = s.vowifi.RequestEnabled(config.ID, false)
-		}
-		if stateErr != nil {
-			restoreErrors = append(restoreErrors, fmt.Errorf("restore reader VoWiFi: %w", stateErr))
-		}
-		return errors.Join(restoreErrors...)
-	}
 
 	if policy.VoWiFiEnabled {
 		if _, err := s.devices.SetNetwork(cleanupContext, physicalID, s.cardNetworkRequest(cleanupContext, physicalID, config, policy, false)); err != nil {
@@ -670,15 +637,6 @@ func (s *Server) handleAutomaticTasks(w http.ResponseWriter, r *http.Request) {
 			s.writeStoreError(w, err)
 			return
 		}
-		if !s.developerActive(r.Context()) {
-			visible := tasks[:0]
-			for _, task := range tasks {
-				if validateAutomaticTaskAvailability(false, task.TaskType, task.Environment) == nil {
-					visible = append(visible, task)
-				}
-			}
-			tasks = visible
-		}
 		writeJSON(w, http.StatusOK, map[string]any{"data": map[string]any{"tasks": tasks}})
 	case http.MethodPost:
 		task, err := s.decodeAutomaticTask(r, 0)
@@ -731,14 +689,7 @@ func (s *Server) handleAutomaticTaskRuns(w http.ResponseWriter, r *http.Request)
 	query := r.URL.Query()
 	limit, _ := strconv.Atoi(query.Get("limit"))
 	offset, _ := strconv.Atoi(query.Get("offset"))
-	var runs []store.AutomaticTaskRun
-	var total int
-	var err error
-	if s.developerActive(r.Context()) {
-		runs, total, err = s.store.ListAutomaticTaskRunsPaginated(r.Context(), limit, offset)
-	} else {
-		runs, total, err = s.store.ListAvailableAutomaticTaskRunsPaginated(r.Context(), limit, offset)
-	}
+	runs, total, err := s.store.ListAutomaticTaskRunsPaginated(r.Context(), limit, offset)
 	if err != nil {
 		s.writeStoreError(w, err)
 		return
@@ -759,19 +710,6 @@ func (s *Server) handleAutomaticTaskRunNow(w http.ResponseWriter, r *http.Reques
 		s.writeStoreError(w, err)
 		return
 	}
-	config, err := s.store.Device(r.Context(), task.DeviceID)
-	if err != nil {
-		s.writeStoreError(w, err)
-		return
-	}
-	if err := validateAutomaticTaskDeviceCapabilities(config, task.TaskType, task.Environment); err != nil {
-		writeError(w, http.StatusConflict, "wifi_calling_only_device", err.Error())
-		return
-	}
-	if err := validateAutomaticTaskAvailability(s.developerActive(r.Context()), task.TaskType, task.Environment); err != nil {
-		writeError(w, http.StatusNotFound, "task_unavailable", err.Error())
-		return
-	}
 	run, err := s.store.QueueAutomaticTaskNow(r.Context(), task)
 	if err != nil {
 		s.writeStoreError(w, err)
@@ -807,8 +745,7 @@ func (s *Server) decodeAutomaticTask(r *http.Request, id int64) (store.Automatic
 	if request.Name == "" || request.DeviceID == "" || request.ProfileICCID == "" {
 		return store.AutomaticTask{}, errors.New("name, device, and eSIM profile are required")
 	}
-	selectedDevice, err := s.store.Device(r.Context(), request.DeviceID)
-	if err != nil {
+	if _, err := s.store.Device(r.Context(), request.DeviceID); err != nil {
 		return store.AutomaticTask{}, errors.New("selected device does not exist")
 	}
 	if request.Environment != "vowifi" && request.Environment != "cellular" {
@@ -820,12 +757,6 @@ func (s *Server) decodeAutomaticTask(r *http.Request, id int64) (store.Automatic
 	if request.TaskType == "public_ip" && request.Environment != "cellular" {
 		return store.AutomaticTask{}, errors.New("public IP tasks must use cellular direct mode")
 	}
-	if err := validateAutomaticTaskAvailability(s.developerActive(r.Context()), request.TaskType, request.Environment); err != nil {
-		return store.AutomaticTask{}, err
-	}
-	if err := validateAutomaticTaskDeviceCapabilities(selectedDevice, request.TaskType, request.Environment); err != nil {
-		return store.AutomaticTask{}, err
-	}
 	if request.IntervalDays < 1 || request.IntervalDays > 365 || request.RetryCount < 0 || request.RetryCount > 10 {
 		return store.AutomaticTask{}, errors.New("interval_days must be 1-365 and retry_count must be 0-10")
 	}
@@ -865,26 +796,6 @@ func (s *Server) decodeAutomaticTask(r *http.Request, id int64) (store.Automatic
 	return task, nil
 }
 
-func validateAutomaticTaskAvailability(available bool, taskType, environment string) error {
-	if !available && (taskType == "public_ip" || environment == "cellular") {
-		return errors.New("unsupported task type or environment")
-	}
-	return nil
-}
-
-func validateAutomaticTaskDeviceCapabilities(config store.Device, taskType, environment string) error {
-	if config.DeviceType != store.DeviceTypeUSBSIMReader {
-		return nil
-	}
-	if environment != "vowifi" {
-		return errors.New("USB SIM reader tasks must use the VoWiFi environment")
-	}
-	if taskType != "sms" && taskType != "call" {
-		return errors.New("USB SIM readers support only VoWiFi SMS and call tasks")
-	}
-	return nil
-}
-
 func nextAutomaticRun(date, clock string, intervalDays int, now time.Time) (time.Time, error) {
 	location := now.Location()
 	start, err := time.ParseInLocation("2006-01-02 15:04", strings.TrimSpace(date)+" "+strings.TrimSpace(clock), location)

internal/server/automatic_tasks_test.go

@@ -3,8 +3,6 @@ package server
 import (
 	"testing"
 	"time"
-
-	"vocat/internal/store"
 )
 
 func TestNextAutomaticRunUsesIntervalAndLocalClock(t *testing.T) {
@@ -20,45 +18,6 @@ func TestNextAutomaticRunUsesIntervalAndLocalClock(t *testing.T) {
 	}
 }
 
-func TestUSBSIMReaderAutomaticTasksRequireVoWiFi(t *testing.T) {
-	reader := store.Device{DeviceType: store.DeviceTypeUSBSIMReader}
-	for _, test := range []struct {
-		taskType    string
-		environment string
-		wantError   bool
-	}{
-		{taskType: "sms", environment: "vowifi"},
-		{taskType: "call", environment: "vowifi"},
-		{taskType: "sms", environment: "cellular", wantError: true},
-		{taskType: "public_ip", environment: "cellular", wantError: true},
-	} {
-		err := validateAutomaticTaskDeviceCapabilities(reader, test.taskType, test.environment)
-		if (err != nil) != test.wantError {
-			t.Errorf("type=%s environment=%s error=%v", test.taskType, test.environment, err)
-		}
-	}
-}
-
-func TestAutomaticTaskAvailabilityHidesRestrictedPaths(t *testing.T) {
-	for _, test := range []struct {
-		available   bool
-		taskType    string
-		environment string
-		wantError   bool
-	}{
-		{false, "sms", "vowifi", false},
-		{false, "call", "vowifi", false},
-		{false, "sms", "cellular", true},
-		{false, "public_ip", "cellular", true},
-		{true, "public_ip", "cellular", false},
-	} {
-		err := validateAutomaticTaskAvailability(test.available, test.taskType, test.environment)
-		if (err != nil) != test.wantError {
-			t.Fatalf("availability(%v, %q, %q) = %v", test.available, test.taskType, test.environment, err)
-		}
-	}
-}
-
 func TestAutomaticSMSRetrySafetyPreventsDuplicateSubmission(t *testing.T) {
 	unsafe := []byte(`{"data":{"parts_attempted":1,"parts_accepted":1,"retry_safe":false}}`)
 	if automaticSMSRetrySafe(unsafe) {

internal/server/developer_settings_test.go

@@ -39,14 +39,14 @@ func TestDeveloperSettingsUpdatesGlobalSMSLimit(t *testing.T) {
 		t.Fatal(err)
 	}
 	server := &Server{store: database, developerEnabled: true, logger: regionTestLogger(), maxRequestBodyBytes: 4096}
-	request := httptest.NewRequest(http.MethodPut, "/api/settings/developer", strings.NewReader(`{"sms_hourly_limit":17}`))
+	request := httptest.NewRequest(http.MethodPut, "/api/settings/developer", strings.NewReader(`{"sms_hourly_limit":25}`))
 	request.Header.Set("Content-Type", "application/json")
 	response := httptest.NewRecorder()
 	server.handleDeveloperSettings(response, request)
 	if response.Code != http.StatusOK {
 		t.Fatalf("status = %d, body=%s", response.Code, response.Body.String())
 	}
-	if got := developer.SMSHourlyLimit(ctx, database); got != 17 {
-		t.Fatalf("SMS hourly limit = %d, want 17", got)
+	if got := developer.SMSHourlyLimit(ctx, database); got != 25 {
+		t.Fatalf("SMS hourly limit = %d, want 25", got)
 	}
 }

internal/server/device_api.go

@@ -66,7 +66,6 @@ type deviceConfigPayload struct {
 	USBPath            string `json:"usb_path"`
 	AudioDevice        string `json:"audio_device"`
 	ModemIMEI          string `json:"modem_imei"`
-	SIMPIN             string `json:"sim_pin"`
 	APN                string `json:"apn"`
 	ProxyPort          int    `json:"proxy_port"`
 	BaudRate           int    `json:"baud_rate"`
@@ -98,7 +97,6 @@ func (payload deviceConfigPayload) toStoreDevice() store.Device {
 		USBPath:            strings.TrimSpace(payload.USBPath),
 		AudioDevice:        strings.TrimSpace(payload.AudioDevice),
 		ModemIMEI:          strings.TrimSpace(payload.ModemIMEI),
-		SIMPIN:             strings.TrimSpace(payload.SIMPIN),
 		APN:                strings.TrimSpace(payload.APN),
 		ProxyPort:          payload.ProxyPort,
 		BaudRate:           payload.BaudRate,
@@ -248,12 +246,6 @@ func (s *Server) handleDevices(w http.ResponseWriter, r *http.Request) bool {
 			config.NetworkEnabled = false
 		}
 		fillConfigFromPhysical(&config, *selected)
-		if pinSetter, ok := s.devices.(interface{ SetSIMPin(string, string) error }); ok {
-			if err := pinSetter.SetSIMPin(selected.ID, config.SIMPIN); err != nil {
-				s.writeDeviceError(w, err)
-				return true
-			}
-		}
 		if selector, ok := s.devices.(interface{ SetBackend(string, string) error }); ok {
 			if err := selector.SetBackend(selected.ID, config.DeviceBackend); err != nil {
 				s.writeDeviceError(w, err)
@@ -344,14 +336,7 @@ func (s *Server) handleDiscoveredDevices(w http.ResponseWriter, r *http.Request)
 		writeJSON(w, http.StatusOK, map[string]any{"data": map[string]any{"devices": []any{}}})
 		return true
 	}
-	// This endpoint backs the add-device dialog. Always perform a new physical
-	// scan instead of serving Manager.List(), which intentionally retains
-	// unplugged configured devices so the main device list can show them offline.
-	devices, err := s.devices.Discover(r.Context())
-	if err != nil {
-		s.writeDeviceError(w, err)
-		return true
-	}
+	devices := s.devices.List()
 	configured, err := s.store.ListDevices(r.Context())
 	if err != nil {
 		s.writeStoreError(w, err)
@@ -359,9 +344,6 @@ func (s *Server) handleDiscoveredDevices(w http.ResponseWriter, r *http.Request)
 	}
 	result := make([]map[string]any, 0, len(devices))
 	for _, entry := range devices {
-		if !entry.Discovered {
-			continue
-		}
 		candidate := entry.Candidate
 		atPorts := make([]string, 0, len(candidate.Ports))
 		for _, port := range candidate.Ports {
@@ -381,24 +363,21 @@ func (s *Server) handleDiscoveredDevices(w http.ResponseWriter, r *http.Request)
 			}
 		}
 		result = append(result, map[string]any{
-			"hardware_kind":   candidate.HardwareKind,
-			"reader_name":     candidate.ReaderName,
 			"discovery_key":   entry.ID,
 			"control_path":    controlPath,
 			"net_interface":   candidate.NetworkInterface,
 			"usb_path":        candidate.USBPath,
 			"vendor_id":       parseHexID(candidate.VendorID),
 			"product_id":      parseHexID(candidate.ProductID),
-			"driver_name":     candidate.Product,
+			"driver_name":     "",
 			"at_ports":        atPorts,
 			"at_port":         candidate.ATPort.OpenPath(),
 			"imei":            snapshotString(entry.Snapshot, func(snapshot *device.Snapshot) string { return snapshot.IMEI }),
 			"mode":            backendMode(candidate),
-			"network_capable": candidate.HardwareKind != "pcsc" && (candidate.NetworkInterface != "" || candidate.QMIControl != ""),
+			"network_capable": candidate.NetworkInterface != "" || candidate.QMIControl != "",
 			"configured":      configuredID != "",
 			"configured_id":   configuredID,
-			"degraded":        candidate.DiscoveryIssue != "" || (candidate.HardwareKind != "pcsc" && !candidate.HasATPort()),
-			"discovery_issue": candidate.DiscoveryIssue,
+			"degraded":        !candidate.HasATPort(),
 		})
 	}
 	writeJSON(w, http.StatusOK, map[string]any{"data": map[string]any{"devices": result}})
@@ -480,16 +459,7 @@ func (s *Server) handleDevicePath(
 			if next.Name == id && strings.TrimSpace(payload.Name) == "" {
 				next.Name = config.Name
 			}
-			if next.SIMPIN == "" || next.SIMPIN == store.SecretMask {
-				next.SIMPIN = config.SIMPIN
-			}
 			if _, physicalID, present := s.physicalForConfig(next); present {
-				if pinSetter, ok := s.devices.(interface{ SetSIMPin(string, string) error }); ok {
-					if err := pinSetter.SetSIMPin(physicalID, next.SIMPIN); err != nil {
-						s.writeDeviceError(w, err)
-						return true
-					}
-				}
 				if selector, ok := s.devices.(interface{ SetBackend(string, string) error }); ok {
 					if err := selector.SetBackend(physicalID, next.DeviceBackend); err != nil {
 						s.writeDeviceError(w, err)
@@ -512,16 +482,6 @@ func (s *Server) handleDevicePath(
 	}
 
 	entry, physicalID, physicalPresent := s.physicalForConfig(config)
-	if config.DeviceType == store.DeviceTypeUSBSIMReader && len(tail) > 0 {
-		operation := strings.Join(tail, "/")
-		unsupported := tail[0] == "network" || tail[0] == "operator_selection" ||
-			operation == "actions/at" || operation == "actions/ussd" || operation == "actions/ussd/continue" ||
-			operation == "actions/ussd/cancel" || operation == "actions/reboot" || operation == "usbnet-mode"
-		if unsupported {
-			writeError(w, http.StatusConflict, "wifi_calling_only_device", "USB SIM readers support WiFi Calling, IMS SMS and calls only")
-			return true
-		}
-	}
 	if len(tail) > 0 && tail[0] == "esim" {
 		return s.handleESIM(w, r, tail[1:], physicalID, physicalPresent, config.ID)
 	}
@@ -1482,13 +1442,7 @@ func physicalMatchesConfig(entry device.Device, config store.Device) bool {
 		return config.ModemIMEI == entry.Snapshot.IMEI
 	}
 	if config.USBPath != "" && candidate.USBPath != "" {
-		if config.USBPath == candidate.USBPath {
-			return true
-		}
-		// Sysfs paths may be stored through /sys/class symlinks while a
-		// subsequent discovery returns the resolved device path. Keep checking
-		// the selected AT/QMI nodes instead of rejecting a modem whose physical
-		// path spelling changed but whose control plane is unchanged.
+		return config.USBPath == candidate.USBPath
 	}
 	// Control and serial device nodes are allocation-order dependent. They are
 	// only legacy fallbacks when no physical USB path or readable IMEI exists.
@@ -1849,10 +1803,6 @@ func deviceStatus(entry device.Device) map[string]any {
 }
 
 func storedDeviceConfig(config store.Device) map[string]any {
-	simPIN := ""
-	if strings.TrimSpace(config.SIMPIN) != "" {
-		simPIN = store.SecretMask
-	}
 	return map[string]any{
 		"id":                   config.ID,
 		"name":                 config.Name,
@@ -1863,7 +1813,6 @@ func storedDeviceConfig(config store.Device) map[string]any {
 		"usb_path":             config.USBPath,
 		"audio_device":         config.AudioDevice,
 		"modem_imei":           config.ModemIMEI,
-		"sim_pin":              simPIN,
 		"apn":                  config.APN,
 		"proxy_port":           config.ProxyPort,
 		"baud_rate":            config.BaudRate,
@@ -1883,17 +1832,6 @@ func storedDeviceConfig(config store.Device) map[string]any {
 
 func fillConfigFromPhysical(config *store.Device, entry device.Device) {
 	candidate := entry.Candidate
-	if candidate.HardwareKind == "pcsc" {
-		config.DeviceType = store.DeviceTypeUSBSIMReader
-		config.ControlDevice = candidate.ReaderName
-		config.ATPort = ""
-		config.Interface = ""
-		config.DeviceBackend = "pcsc"
-		config.ESIMTransport = "pcsc"
-		config.NetworkEnabled = false
-		config.SMSEnabled = true
-		config.VoWiFiEnabled = true
-	}
 	if config.Interface == "" {
 		config.Interface = candidate.NetworkInterface
 	}
@@ -1920,92 +1858,66 @@ func fillConfigFromPhysical(config *store.Device, entry device.Device) {
 func modemSummary(snapshot *device.Snapshot, phone string, phoneSource string) map[string]any {
 	if snapshot == nil {
 		return map[string]any{
-			"operator":                  "",
-			"native_mcc":                "",
-			"native_mnc":                "",
-			"native_spn":                "",
-			"operator_country_code":     "",
-			"card_mcc":                  "",
-			"card_mnc":                  "",
-			"card_country":              "",
-			"home_carrier_name":         "",
-			"home_carrier_plmn":         "",
-			"home_carrier_country_code": "",
-			"service_blocked":           false,
-			"blocked_reason":            "",
-			"network_mode":              "",
-			"radio_band":                "",
-			"radio_channel":             0,
-			"signal_dbm":                0,
-			"signal_sinr":               0,
-			"imei":                      "",
-			"iccid":                     "",
-			"reg_status":                0,
-			"reg_status_text":           "not refreshed",
-			"sim_inserted":              false,
-			"phone_number":              phone,
-			"phone_number_source":       phoneSource,
-			"model":                     "",
+			"operator":              "",
+			"native_mcc":            "",
+			"native_mnc":            "",
+			"native_spn":            "",
+			"operator_country_code": "",
+			"card_mcc":              "",
+			"card_mnc":              "",
+			"card_country":          "",
+			"service_blocked":       false,
+			"blocked_reason":        "",
+			"network_mode":          "",
+			"radio_band":            "",
+			"radio_channel":         0,
+			"signal_dbm":            0,
+			"signal_sinr":           0,
+			"imei":                  "",
+			"iccid":                 "",
+			"reg_status":            0,
+			"reg_status_text":       "not refreshed",
+			"sim_inserted":          false,
+			"phone_number":          phone,
+			"phone_number_source":   phoneSource,
+			"model":                 "",
 		}
 	}
 	mcc, mnc := splitPLMN(snapshot.OperatorCode)
 	_, operatorCountryCode, _ := device.CarrierForPLMN(snapshot.OperatorCode)
-	cardMCC, cardMNC := device.CardMCCMNCWithLength(snapshot.IMSI, snapshot.MNCLength)
-	homePLMN, homeCarrier, homeCountry, _ := device.CarrierForSIM(device.CarrierIdentity{
-		IMSI: snapshot.IMSI, ICCID: snapshot.ICCID, SPN: snapshot.SPN,
-		GID1: snapshot.GID1, GID2: snapshot.GID2, MNCLength: snapshot.MNCLength,
-	})
+	cardMCC, cardMNC := device.CardMCCMNC(snapshot.IMSI)
 	blockedReason := device.RegionBlockReason(snapshot.IMSI)
 	return map[string]any{
-		"operator":                  snapshot.OperatorName,
-		"native_mcc":                mcc,
-		"native_mnc":                mnc,
-		"native_spn":                snapshot.SPN,
-		"operator_country_code":     operatorCountryCode,
-		"card_mcc":                  cardMCC,
-		"card_mnc":                  cardMNC,
-		"card_country":              countryNameForMCC(cardMCC),
-		"home_carrier_name":         homeCarrier,
-		"home_carrier_plmn":         homePLMN,
-		"home_carrier_country_code": homeCountry,
-		"service_blocked":           blockedReason != "",
-		"blocked_reason":            blockedReason,
-		"network_mode":              snapshot.AccessTech,
-		"network_duplex":            "",
-		"radio_band":                snapshot.Band,
-		"radio_channel":             parseDecimal(snapshot.Channel),
-		"signal_dbm":                pointerInt(snapshot.RSSIDBm),
-		"signal_rsrp":               pointerInt(snapshot.RSRP),
-		"signal_rsrq":               pointerInt(snapshot.RSRQ),
-		"signal_sinr":               pointerInt(snapshot.SINR),
-		"imei":                      snapshot.IMEI,
-		"iccid":                     snapshot.ICCID,
-		"imsi":                      snapshot.IMSI,
-		"firmware":                  snapshot.Firmware,
-		"model":                     snapshot.Model,
-		"reg_status":                snapshot.RegistrationStatus,
-		"reg_status_text":           registrationText(snapshot),
-		"ps_attached":               snapshot.PSAttached,
-		"sim_inserted":              snapshotHasSIM(snapshot),
-		"operating_mode":            snapshot.OperatingMode,
-		"phone_number":              phone,
-		"phone_number_source":       phoneSource,
-	}
-}
-
-func snapshotHasSIM(snapshot *device.Snapshot) bool {
-	if snapshot == nil {
-		return false
-	}
-	if snapshot.SIMReady || strings.TrimSpace(snapshot.ICCID) != "" || strings.TrimSpace(snapshot.IMSI) != "" {
-		return true
-	}
-	switch strings.ToLower(strings.TrimSpace(snapshot.SIMStatus)) {
-	case "", "unknown", "not_inserted", "not inserted", "absent":
-		return false
-	default:
-		// PIN/PUK and other explicit UICC states prove that a card is present.
-		return true
+		"operator":              snapshot.OperatorName,
+		"native_mcc":            mcc,
+		"native_mnc":            mnc,
+		"native_spn":            snapshot.SPN,
+		"operator_country_code": operatorCountryCode,
+		"card_mcc":              cardMCC,
+		"card_mnc":              cardMNC,
+		"card_country":          countryNameForMCC(cardMCC),
+		"service_blocked":       blockedReason != "",
+		"blocked_reason":        blockedReason,
+		"network_mode":          snapshot.AccessTech,
+		"network_duplex":        "",
+		"radio_band":            snapshot.Band,
+		"radio_channel":         parseDecimal(snapshot.Channel),
+		"signal_dbm":            pointerInt(snapshot.RSSIDBm),
+		"signal_rsrp":           pointerInt(snapshot.RSRP),
+		"signal_rsrq":           pointerInt(snapshot.RSRQ),
+		"signal_sinr":           pointerInt(snapshot.SINR),
+		"imei":                  snapshot.IMEI,
+		"iccid":                 snapshot.ICCID,
+		"imsi":                  snapshot.IMSI,
+		"firmware":              snapshot.Firmware,
+		"model":                 snapshot.Model,
+		"reg_status":            snapshot.RegistrationStatus,
+		"reg_status_text":       registrationText(snapshot),
+		"ps_attached":           snapshot.PSAttached,
+		"sim_inserted":          snapshot.SIMStatus != "",
+		"operating_mode":        snapshot.OperatingMode,
+		"phone_number":          phone,
+		"phone_number_source":   phoneSource,
 	}
 }
 
@@ -2058,9 +1970,6 @@ func deviceName(entry device.Device) string {
 }
 
 func backendMode(candidate modem.Candidate) string {
-	if candidate.HardwareKind == "pcsc" {
-		return "pcsc"
-	}
 	if candidate.QMIControl != "" {
 		return "qmi"
 	}

internal/server/device_discovery_api_test.go

@@ -1,72 +0,0 @@
-package server
-
-import (
-	"context"
-	"net/http"
-	"net/http/httptest"
-	"strings"
-	"testing"
-
-	"vocat/internal/device"
-	"vocat/internal/modem"
-	"vocat/internal/store"
-)
-
-type discoverySnapshotController struct {
-	fakeDeviceController
-	entries       []device.Device
-	discoverCalls int
-}
-
-func (controller *discoverySnapshotController) Discover(context.Context) ([]device.Device, error) {
-	controller.discoverCalls++
-	return append([]device.Device(nil), controller.entries...), nil
-}
-
-func TestDiscoveredDevicesPerformsFreshScanAndOmitsAbsentEntries(t *testing.T) {
-	database, err := store.Open(context.Background(), ":memory:")
-	if err != nil {
-		t.Fatalf("store.Open: %v", err)
-	}
-	t.Cleanup(func() { _ = database.Close() })
-
-	controller := &discoverySnapshotController{
-		fakeDeviceController: fakeDeviceController{entry: device.Device{
-			ID: "stale-device", Discovered: false,
-			Candidate: modem.Candidate{ID: "stale-device", USBPath: "1-1"},
-		}},
-		entries: []device.Device{
-			{
-				ID: "current-device", Discovered: true,
-				Candidate: modem.Candidate{ID: "current-device", USBPath: "2-1"},
-			},
-			{
-				ID: "absent-device", Discovered: false,
-				Candidate: modem.Candidate{ID: "absent-device", USBPath: "3-1"},
-			},
-		},
-	}
-	server := &Server{
-		store: database, logger: regionTestLogger(),
-		maxRequestBodyBytes: 4096, devices: controller,
-	}
-	request := httptest.NewRequest(http.MethodGet, "/api/devices/discovered", nil)
-	recorder := httptest.NewRecorder()
-
-	if !server.handleDiscoveredDevices(recorder, request) {
-		t.Fatal("handleDiscoveredDevices returned false")
-	}
-	if recorder.Code != http.StatusOK {
-		t.Fatalf("status = %d, body = %s", recorder.Code, recorder.Body.String())
-	}
-	if controller.discoverCalls != 1 {
-		t.Fatalf("Discover calls = %d, want 1", controller.discoverCalls)
-	}
-	body := recorder.Body.String()
-	if !strings.Contains(body, "current-device") {
-		t.Fatalf("response omits current device: %s", body)
-	}
-	if strings.Contains(body, "stale-device") || strings.Contains(body, "absent-device") {
-		t.Fatalf("response contains an absent device: %s", body)
-	}
-}

internal/server/device_features_api_test.go

@@ -117,27 +117,6 @@ func TestPhysicalMatchesConfigRejectsDuplicateAndroidSerialAlias(t *testing.T) {
 	}
 }
 
-func TestPhysicalMatchesConfigFallsBackWhenWWANSysfsPathWasResolved(t *testing.T) {
-	config := store.Device{
-		ID:            "wwan0",
-		USBPath:       "/sys/class/wwan/wwan0",
-		ATPort:        "/dev/wwan0at0",
-		ControlDevice: "/dev/wwan0qmi0",
-	}
-	entry := device.Device{
-		ID: "mhi-wwan0",
-		Candidate: modem.Candidate{
-			USBPath:      "/sys/devices/platform/soc/4080000.remoteproc/wwan/wwan0",
-			ATPort:       modem.Port{Path: "/dev/wwan0at0"},
-			QMIControl:   "/dev/wwan0qmi0",
-			HardwareKind: "wwan",
-		},
-	}
-	if !physicalMatchesConfig(entry, config) {
-		t.Fatal("resolved WWAN sysfs path should fall back to matching control nodes")
-	}
-}
-
 func TestFindDiscoveredDevicePrefersPhysicalIdentityOverSerialAlias(t *testing.T) {
 	alias := "/dev/serial/by-id/usb-Android_Android-if02-port0"
 	devices := []device.Device{

internal/server/device_summary_test.go

@@ -115,24 +115,3 @@ func TestConfiguredDeviceSummaryMarksIdleRuntimeAsNotInUse(t *testing.T) {
 		t.Fatalf("summary = %#v", got)
 	}
 }
-
-func TestSnapshotHasSIMDoesNotTreatUnknownStatusAsInserted(t *testing.T) {
-	for _, snapshot := range []*device.Snapshot{
-		{IMEI: "867123456789012"},
-		{IMEI: "867123456789012", SIMStatus: "unknown"},
-		{IMEI: "867123456789012", SIMStatus: "not_inserted"},
-	} {
-		if snapshotHasSIM(snapshot) {
-			t.Fatalf("snapshot was reported with a SIM: %#v", snapshot)
-		}
-	}
-	for _, snapshot := range []*device.Snapshot{
-		{SIMStatus: "pin_required"},
-		{ICCID: "89441000400128014257"},
-		{SIMReady: true},
-	} {
-		if !snapshotHasSIM(snapshot) {
-			t.Fatalf("snapshot was reported without a SIM: %#v", snapshot)
-		}
-	}
-}

internal/server/export_proxy_api.go

@@ -1,13 +1,11 @@
 package server
 
 import (
-	"context"
 	"errors"
 	"net/http"
 	"strings"
 
 	"vocat/internal/exportproxy"
-	"vocat/internal/store"
 )
 
 func (s *Server) routeExportProxyAPI(w http.ResponseWriter, r *http.Request, cleanPath string) bool {
@@ -35,9 +33,6 @@ func (s *Server) routeExportProxyAPI(w http.ResponseWriter, r *http.Request, cle
 				writeError(w, http.StatusBadRequest, "invalid_request", err.Error())
 				return true
 			}
-			if s.rejectUnsupportedExportProxyDevice(w, r.Context(), config.DeviceID) {
-				return true
-			}
 			created, err := s.exportProxy.Create(r.Context(), config)
 			if err != nil {
 				s.writeExportProxyError(w, err)
@@ -76,9 +71,6 @@ func (s *Server) routeExportProxyAPI(w http.ResponseWriter, r *http.Request, cle
 			writeError(w, http.StatusBadRequest, "invalid_request", err.Error())
 			return true
 		}
-		if s.rejectUnsupportedExportProxyDevice(w, r.Context(), config.DeviceID) {
-			return true
-		}
 		updated, err := s.exportProxy.Update(r.Context(), id, config)
 		if err != nil {
 			s.writeExportProxyError(w, err)
@@ -98,19 +90,6 @@ func (s *Server) routeExportProxyAPI(w http.ResponseWriter, r *http.Request, cle
 	return true
 }
 
-func (s *Server) rejectUnsupportedExportProxyDevice(w http.ResponseWriter, ctx context.Context, deviceID string) bool {
-	config, err := s.store.Device(ctx, strings.TrimSpace(deviceID))
-	if err != nil {
-		s.writeStoreError(w, err)
-		return true
-	}
-	if config.DeviceType == store.DeviceTypeUSBSIMReader {
-		writeError(w, http.StatusConflict, "wifi_calling_only_device", "USB SIM readers cannot export cellular data as a proxy")
-		return true
-	}
-	return false
-}
-
 func (s *Server) writeExportProxyError(w http.ResponseWriter, err error) {
 	switch {
 	case errors.Is(err, exportproxy.ErrDisabled):

internal/server/export_proxy_reader_test.go

@@ -1,31 +0,0 @@
-package server
-
-import (
-	"context"
-	"net/http"
-	"net/http/httptest"
-	"testing"
-
-	"vocat/internal/store"
-)
-
-func TestExportProxyRejectsUSBSIMReader(t *testing.T) {
-	database, err := store.Open(context.Background(), ":memory:")
-	if err != nil {
-		t.Fatal(err)
-	}
-	t.Cleanup(func() { _ = database.Close() })
-	if err := database.UpsertDevice(context.Background(), store.Device{
-		ID: "reader-1", Name: "USB SIM Reader", DeviceType: store.DeviceTypeUSBSIMReader,
-	}); err != nil {
-		t.Fatal(err)
-	}
-	server := &Server{store: database}
-	response := httptest.NewRecorder()
-	if !server.rejectUnsupportedExportProxyDevice(response, context.Background(), "reader-1") {
-		t.Fatal("reader was accepted as an export-proxy device")
-	}
-	if response.Code != http.StatusConflict {
-		t.Fatalf("status = %d, body = %s", response.Code, response.Body.String())
-	}
-}

internal/server/general_api.go

@@ -506,7 +506,7 @@ func (s *Server) handlePasswordChange(w http.ResponseWriter, r *http.Request) {
 		switch {
 		case errors.Is(err, auth.ErrInvalidCredentials):
 			writeError(w, http.StatusUnauthorized, "invalid_credentials", "current password is incorrect")
-		case errors.Is(err, auth.ErrEmptyPassword):
+		case strings.Contains(err.Error(), "between 12 and 1024"):
 			writeError(w, http.StatusBadRequest, "weak_password", err.Error())
 		case strings.Contains(err.Error(), "must differ"):
 			writeError(w, http.StatusBadRequest, "password_reused", err.Error())

internal/server/proxy_binding_test.go

@@ -93,28 +93,3 @@ func TestProfileProxyBindingRejectsSameICCIDOnDifferentProxy(t *testing.T) {
 		t.Fatalf("binding after rejected rebind = %+v, %v", binding, err)
 	}
 }
-
-func TestProfileProxyBindingSupportsPCSCReader(t *testing.T) {
-	server, database, controller := newProfileBindingTestServer(t)
-	readerICCID := "89104100000028106378"
-	if err := database.UpsertDevice(context.Background(), store.Device{
-		ID: "reader-1", Name: "USB SIM Reader", DeviceType: store.DeviceTypeUSBSIMReader,
-	}); err != nil {
-		t.Fatal(err)
-	}
-	controller.state = vowifi.State{DeviceID: "reader-1", ICCID: readerICCID, Enabled: true}
-	response := profileBindingRequest(t, server, http.MethodPost, `{
-		"upstream_proxy_id":"route-1",
-		"bindings":[{"device_id":"reader-1","iccid":"89104100000028106378","profile_name":"Reader Profile"}]
-	}`)
-	if response.Code != http.StatusOK {
-		t.Fatalf("POST status = %d, body = %s", response.Code, response.Body.String())
-	}
-	binding, err := database.DeviceProxyBinding(context.Background(), readerICCID)
-	if err != nil || binding.DeviceID != "reader-1" || binding.UpstreamProxyID != "route-1" {
-		t.Fatalf("reader binding = %+v, %v", binding, err)
-	}
-	if controller.reconnects != 1 {
-		t.Fatalf("reader reconnects = %d, want 1", controller.reconnects)
-	}
-}

internal/server/settings_api.go

@@ -29,7 +29,7 @@ import (
 )
 
 var (
-	errUnsafeDestination = errors.New("notification destination is not allowed")
+	errUnsafeDestination = errors.New("notification destination is not public")
 	errProviderRejected  = errors.New("notification provider rejected the test")
 	telegramTokenPattern = regexp.MustCompile(`^[0-9]{5,20}:[A-Za-z0-9_-]{20,128}$`)
 )
@@ -429,18 +429,17 @@ func (s *Server) handleNotificationTest(
 		return
 	}
 
-	notificationContext := s.notificationDestinationContext(r.Context())
 	switch channel {
 	case "webhook":
-		err = sendWebhookNotificationTest(notificationContext, resolved)
+		err = sendWebhookNotificationTest(r.Context(), resolved)
 	case "telegram":
-		err = sendTelegramNotificationTest(notificationContext, resolved)
+		err = sendTelegramNotificationTest(r.Context(), resolved)
 	case "email":
-		err = sendEmailNotificationTest(notificationContext, resolved)
+		err = sendEmailNotificationTest(r.Context(), resolved)
 	case "bark":
-		err = sendBarkNotificationTest(notificationContext, resolved)
+		err = sendBarkNotificationTest(r.Context(), resolved)
 	case "wecom":
-		err = sendWecomNotificationTest(notificationContext, resolved)
+		err = sendWecomNotificationTest(r.Context(), resolved)
 	}
 	if err != nil {
 		redacted := store.RedactText(err.Error(), provider)
@@ -459,7 +458,7 @@ func (s *Server) handleNotificationTest(
 				w,
 				http.StatusBadRequest,
 				"unsafe_destination",
-				"notification destination resolved to an unusable or protected system address",
+				"notification destination must resolve only to public network addresses",
 			)
 		case errors.Is(err, errProviderRejected):
 			writeError(
@@ -905,12 +904,11 @@ func restrictedHTTPClient(
 		},
 	}
 	if strings.TrimSpace(proxy) != "" {
-		parsed, err := validateNotificationProxyURL(ctx, proxy)
+		parsed, err := validateOutboundURL(ctx, proxy, false)
 		if err != nil {
 			return nil, fmt.Errorf("validate notification proxy: %w", err)
 		}
 		transport.Proxy = http.ProxyURL(parsed)
-		transport.DialContext = notificationProxyDialer(timeout)
 	}
 	return &http.Client{
 		Transport: transport,
@@ -953,17 +951,6 @@ func validateOutboundURL(
 	return parsed, nil
 }
 
-func validateNotificationProxyURL(ctx context.Context, raw string) (*url.URL, error) {
-	parsed, err := parseOutboundURL(raw, false)
-	if err != nil {
-		return nil, err
-	}
-	if _, err := resolveNotificationProxyAddresses(ctx, parsed.Hostname()); err != nil {
-		return nil, err
-	}
-	return parsed, nil
-}
-
 func parseOutboundURL(raw string, requireHTTPS bool) (*url.URL, error) {
 	parsed, err := url.Parse(strings.TrimSpace(raw))
 	if err != nil || parsed.Hostname() == "" || parsed.IsAbs() == false {
@@ -997,42 +984,17 @@ func restrictedDialer(timeout time.Duration) func(
 	}
 }
 
-func notificationProxyDialer(timeout time.Duration) func(
-	context.Context,
-	string,
-	string,
-) (net.Conn, error) {
-	return func(ctx context.Context, network string, address string) (net.Conn, error) {
-		return dialNotification(ctx, network, address, timeout, true)
-	}
-}
-
 func dialRestricted(
 	ctx context.Context,
 	network string,
 	address string,
 	timeout time.Duration,
-) (net.Conn, error) {
-	return dialNotification(ctx, network, address, timeout, false)
-}
-
-func dialNotification(
-	ctx context.Context,
-	network string,
-	address string,
-	timeout time.Duration,
-	allowLocal bool,
 ) (net.Conn, error) {
 	host, port, err := net.SplitHostPort(address)
 	if err != nil {
 		return nil, fmt.Errorf("parse outbound address: %w", err)
 	}
-	var addresses []netip.Addr
-	if allowLocal {
-		addresses, err = resolveNotificationProxyAddresses(ctx, host)
-	} else {
-		addresses, err = resolvePublicAddresses(ctx, host)
-	}
+	addresses, err := resolvePublicAddresses(ctx, host)
 	if err != nil {
 		return nil, err
 	}
@@ -1108,68 +1070,21 @@ func dialNotification(
 	if len(failures) == 0 {
 		return nil, ctx.Err()
 	}
-	return nil, fmt.Errorf("dial notification destination: %w", errors.Join(failures...))
-}
-
-func (s *Server) notificationDestinationContext(ctx context.Context) context.Context {
-	if ctx == nil {
-		return context.Background()
-	}
-	// Notification delivery is outbound administrator-configured traffic. It
-	// must not inherit the inbound Web access policy: DNS Fake-IP ranges, LAN
-	// gateways, and local proxies are valid notification paths.
-	return ctx
-}
-
-func notificationAddressAllowed(_ context.Context, address netip.Addr) bool {
-	address = address.Unmap()
-	if !notificationTransportAddress(address) {
-		return false
-	}
-	for _, fakeIP := range notificationFakeIPNetworks {
-		if fakeIP.Contains(address) {
-			return true
-		}
-	}
-	if !address.IsGlobalUnicast() {
-		return false
-	}
-	for _, blocked := range blockedNotificationDestinationNetworks {
-		if blocked.Contains(address) {
-			return false
-		}
-	}
-	return true
-}
-
-func notificationProxyAddressAllowed(address netip.Addr) bool {
-	return notificationTransportAddress(address.Unmap())
-}
-
-func notificationTransportAddress(address netip.Addr) bool {
-	return address.IsValid() && !address.IsUnspecified() && !address.IsMulticast() &&
-		!address.IsLinkLocalUnicast() && !address.IsLinkLocalMulticast() &&
-		address != netip.MustParseAddr("255.255.255.255") &&
-		address != netip.MustParseAddr("100.100.100.200")
+	return nil, fmt.Errorf("dial public notification destination: %w", errors.Join(failures...))
 }
 
 func resolvePublicAddresses(ctx context.Context, host string) ([]netip.Addr, error) {
-	return resolveNotificationAddresses(ctx, host, false)
-}
-
-func resolveNotificationProxyAddresses(ctx context.Context, host string) ([]netip.Addr, error) {
-	return resolveNotificationAddresses(ctx, host, true)
-}
-
-func resolveNotificationAddresses(ctx context.Context, host string, allowLocal bool) ([]netip.Addr, error) {
 	normalized := strings.ToLower(strings.TrimSuffix(strings.TrimSpace(host), "."))
-	if normalized == "" {
+	if normalized == "" || normalized == "localhost" ||
+		strings.HasSuffix(normalized, ".localhost") ||
+		normalized == "metadata" ||
+		strings.HasSuffix(normalized, ".internal") ||
+		strings.HasSuffix(normalized, ".local") {
 		return nil, fmt.Errorf("%w: blocked host name", errUnsafeDestination)
 	}
 	if literal, err := netip.ParseAddr(normalized); err == nil {
 		literal = literal.Unmap()
-		if (!allowLocal && !notificationAddressAllowed(ctx, literal)) ||
-			(allowLocal && !notificationProxyAddressAllowed(literal)) {
+		if !publicNotificationAddress(literal) {
 			return nil, fmt.Errorf("%w: %s", errUnsafeDestination, literal)
 		}
 		return []netip.Addr{literal}, nil
@@ -1184,8 +1099,7 @@ func resolveNotificationAddresses(ctx context.Context, host string, allowLocal b
 	result := make([]netip.Addr, 0, len(addresses))
 	for _, address := range addresses {
 		address = address.Unmap()
-		if (!allowLocal && !notificationAddressAllowed(ctx, address)) ||
-			(allowLocal && !notificationProxyAddressAllowed(address)) {
+		if !publicNotificationAddress(address) {
 			return nil, fmt.Errorf("%w: %s", errUnsafeDestination, address)
 		}
 		result = append(result, address)
@@ -1193,11 +1107,7 @@ func resolveNotificationAddresses(ctx context.Context, host string, allowLocal b
 	return result, nil
 }
 
-var notificationFakeIPNetworks = []netip.Prefix{
-	netip.MustParsePrefix("198.18.0.0/15"),
-}
-
-var blockedNotificationDestinationNetworks = []netip.Prefix{
+var blockedNotificationNetworks = []netip.Prefix{
 	netip.MustParsePrefix("0.0.0.0/8"),
 	netip.MustParsePrefix("10.0.0.0/8"),
 	netip.MustParsePrefix("100.64.0.0/10"),
@@ -1208,6 +1118,7 @@ var blockedNotificationDestinationNetworks = []netip.Prefix{
 	netip.MustParsePrefix("192.0.2.0/24"),
 	netip.MustParsePrefix("192.88.99.0/24"),
 	netip.MustParsePrefix("192.168.0.0/16"),
+	netip.MustParsePrefix("198.18.0.0/15"),
 	netip.MustParsePrefix("198.51.100.0/24"),
 	netip.MustParsePrefix("203.0.113.0/24"),
 	netip.MustParsePrefix("224.0.0.0/4"),
@@ -1222,6 +1133,19 @@ var blockedNotificationDestinationNetworks = []netip.Prefix{
 	netip.MustParsePrefix("ff00::/8"),
 }
 
+func publicNotificationAddress(address netip.Addr) bool {
+	if !address.IsValid() || !address.IsGlobalUnicast() {
+		return false
+	}
+	address = address.Unmap()
+	for _, blocked := range blockedNotificationNetworks {
+		if blocked.Contains(address) {
+			return false
+		}
+	}
+	return true
+}
+
 func configString(config map[string]any, key string) string {
 	value, _ := config[key].(string)
 	return strings.TrimSpace(value)

internal/server/settings_api_test.go

@@ -369,10 +369,6 @@ func TestNotificationTestsBlockSSRFAndUnsupportedChannels(t *testing.T) {
 	if recorder.Code != http.StatusBadRequest {
 		t.Fatalf("Telegram metadata status = %d, body = %s", recorder.Code, recorder.Body)
 	}
-	response = decodeSettingsResponse(t, recorder)
-	if response["error"].(map[string]any)["code"] != "unsafe_destination" {
-		t.Fatalf("Telegram metadata response = %#v", response)
-	}
 
 	recorder = test.request(
 		t,
@@ -766,28 +762,26 @@ func TestTrafficAnalysisIsUnavailableOutsideDeveloperMode(t *testing.T) {
 	}
 }
 
-func TestNotificationDestinationAddressPolicyIsIndependentFromWebAccess(t *testing.T) {
+func TestNotificationDestinationAddressPolicy(t *testing.T) {
 	blocked := []string{
 		"0.0.0.0", "10.0.0.1", "100.100.100.200", "127.0.0.1",
-		"169.254.169.254", "172.16.0.1", "192.168.1.1", "224.0.0.1",
-		"255.255.255.255", "::", "::1", "fc00::1", "fe80::1", "ff02::1",
+		"169.254.169.254", "172.16.0.1", "192.168.1.1", "198.18.0.1",
+		"::1", "fc00::1", "fe80::1", "2001:db8::1",
 	}
 	for _, text := range blocked {
 		address := netip.MustParseAddr(text)
-		if notificationAddressAllowed(context.Background(), address) {
-			t.Errorf("%s was incorrectly accepted for notification transport", text)
+		if publicNotificationAddress(address) {
+			t.Errorf("%s was incorrectly accepted as public", text)
 		}
 	}
-	for _, text := range []string{
-		"1.1.1.1", "198.18.0.1", "2606:4700:4700::1111",
-	} {
+	for _, text := range []string{"1.1.1.1", "8.8.8.8", "2606:4700:4700::1111"} {
 		address := netip.MustParseAddr(text)
-		if !notificationAddressAllowed(context.Background(), address) {
-			t.Errorf("%s was incorrectly blocked for notification transport", text)
+		if !publicNotificationAddress(address) {
+			t.Errorf("%s was incorrectly blocked", text)
 		}
 	}
 	if _, err := resolvePublicAddresses(context.Background(), "localhost"); err == nil {
-		t.Fatal("local notification destination was not blocked")
+		t.Fatal("localhost was not blocked")
 	}
 	if _, err := resolvePublicAddresses(
 		context.Background(),
@@ -795,53 +789,6 @@ func TestNotificationDestinationAddressPolicyIsIndependentFromWebAccess(t *testi
 	); err == nil {
 		t.Fatal("metadata IP was not blocked")
 	}
-	server := &Server{access: parsedAccessConfig{mode: "internal"}}
-	notificationContext := server.notificationDestinationContext(context.Background())
-	if addresses, err := resolvePublicAddresses(notificationContext, "198.18.0.1"); err != nil || len(addresses) != 1 {
-		t.Fatalf("Fake-IP notification destination = %v, %v", addresses, err)
-	}
-}
-
-func TestNotificationProxyAcceptsLocalAddressWithoutWebAccessAllowlist(t *testing.T) {
-	server := &Server{access: parsedAccessConfig{mode: "internal"}}
-	ctx := server.notificationDestinationContext(context.Background())
-	for _, host := range []string{"127.0.0.1", "10.0.0.1", "192.168.1.1", "198.18.0.1", "::1"} {
-		if addresses, err := resolveNotificationProxyAddresses(ctx, host); err != nil || len(addresses) != 1 {
-			t.Errorf("local notification proxy %s = %v, %v", host, addresses, err)
-		}
-	}
-	if _, err := resolveNotificationProxyAddresses(ctx, "169.254.169.254"); err == nil {
-		t.Fatal("cloud metadata address was accepted as a notification proxy")
-	}
-}
-
-func TestRestrictedNotificationClientConnectsThroughLocalProxy(t *testing.T) {
-	var hits atomic.Int32
-	proxy := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, request *http.Request) {
-		hits.Add(1)
-		if request.URL.Host != "1.1.1.1" {
-			t.Errorf("proxy request host = %q", request.URL.Host)
-		}
-		w.WriteHeader(http.StatusNoContent)
-	}))
-	defer proxy.Close()
-
-	client, err := restrictedHTTPClient(context.Background(), 2*time.Second, proxy.URL)
-	if err != nil {
-		t.Fatal(err)
-	}
-	request, err := http.NewRequest(http.MethodGet, "http://1.1.1.1/test", nil)
-	if err != nil {
-		t.Fatal(err)
-	}
-	response, err := client.Do(request)
-	if err != nil {
-		t.Fatal(err)
-	}
-	_ = response.Body.Close()
-	if response.StatusCode != http.StatusNoContent || hits.Load() != 1 {
-		t.Fatalf("local proxy status = %d, hits = %d", response.StatusCode, hits.Load())
-	}
 }
 
 func TestRestrictedNotificationClientCapsTimeoutAndRedirects(t *testing.T) {

internal/server/sms_api.go

@@ -546,13 +546,6 @@ func (s *Server) syncModemSMS(ctx context.Context, onlyDevice string) {
 		if onlyDevice != "" && config.ID != onlyDevice {
 			continue
 		}
-		// A PC/SC USB reader has no modem storage or AT command channel. Its
-		// messages are delivered by the active VoWiFi IMS session, so attempting
-		// an AT+CMGL catch-up scan would only poison the reader's health state
-		// with ErrNoATPort.
-		if !supportsModemSMSStorage(config) {
-			continue
-		}
 		// Do not queue CMGL traffic on the same serial actor while VoWiFi is
 		// reading the SIM or running AKA. Once the session is stable, resume the
 		// SM/ME scan as a catch-up path: an SMS submitted while the card was
@@ -666,10 +659,6 @@ func (s *Server) syncModemSMS(ctx context.Context, onlyDevice string) {
 	}
 }
 
-func supportsModemSMSStorage(config store.Device) bool {
-	return store.NormalizeDeviceType(config.DeviceType) != store.DeviceTypeUSBSIMReader
-}
-
 func shouldDeferModemSMSSync(state vowifi.State, stateErr error) bool {
 	if stateErr != nil || !state.Enabled {
 		return false

internal/server/sms_api_test.go

@@ -108,15 +108,6 @@ func TestNormalizeSMSDeviceFilter(t *testing.T) {
 	}
 }
 
-func TestSupportsModemSMSStorageRejectsUSBReader(t *testing.T) {
-	if supportsModemSMSStorage(store.Device{DeviceType: store.DeviceTypeUSBSIMReader}) {
-		t.Fatal("USB SIM reader must not be polled with modem SMS AT commands")
-	}
-	if !supportsModemSMSStorage(store.Device{DeviceType: store.DeviceTypePCIeEC20EC25}) {
-		t.Fatal("cellular modem should retain modem SMS storage synchronization")
-	}
-}
-
 func TestSMSSendOutcome(t *testing.T) {
 	tests := []struct {
 		name      string

internal/server/sms_notifications.go

@@ -105,7 +105,7 @@ func (s *Server) runSMSNotificationChannel(ctx context.Context, channel string)
 			} else {
 				for _, message := range messages {
 					notification := s.newSMSNotification(ctx, message)
-					if sendErr := sendSMSNotification(s.notificationDestinationContext(ctx), channel, config, notification); sendErr != nil {
+					if sendErr := sendSMSNotification(ctx, channel, config, notification); sendErr != nil {
 						if sendErr.Error() != lastError || time.Since(lastErrorAt) >= time.Minute {
 							s.logSMSNotificationError(channel, sendErr)
 							lastError, lastErrorAt = sendErr.Error(), time.Now()

internal/server/telegram_bot.go

@@ -850,7 +850,7 @@ func (bot *telegramBot) sendDeviceStatus(ctx context.Context, config telegramRun
 					"ICCID："+firstNonEmpty(snapshot.ICCID, "--"),
 					"IMSI："+firstNonEmpty(snapshot.IMSI, "--"),
 					"号码："+resolveTelegramPhoneNumber(associationNumber, wfcState, snapshot),
-					"原运营商："+telegramSnapshotHomeCarrier(snapshot),
+					"原运营商："+telegramHomeCarrier(snapshot.IMSI, snapshot.SPN),
 					"当前网络："+telegramCurrentNetwork(snapshot),
 					"蜂窝模式："+map[bool]string{true: "飞行模式", false: "开启"}[snapshot.FlightMode],
 				)
@@ -929,31 +929,21 @@ func usableTelegramPhoneNumber(value string) bool {
 }
 
 func telegramHomeCarrier(imsi string, spn ...string) string {
-	identity := device.CarrierIdentity{IMSI: imsi}
-	if len(spn) > 0 {
-		identity.SPN = spn[0]
-	}
-	return telegramResolvedHomeCarrier(identity)
-}
-
-func telegramSnapshotHomeCarrier(snapshot *device.Snapshot) string {
-	if snapshot == nil {
-		return "--"
-	}
-	return telegramResolvedHomeCarrier(device.CarrierIdentity{
-		IMSI: snapshot.IMSI, ICCID: snapshot.ICCID, SPN: snapshot.SPN,
-		GID1: snapshot.GID1, GID2: snapshot.GID2, MNCLength: snapshot.MNCLength,
-	})
-}
-
-func telegramResolvedHomeCarrier(identity device.CarrierIdentity) string {
-	plmn, name, country, ok := device.CarrierForSIM(identity)
+	plmn, name, country, ok := device.CarrierForIMSI(imsi)
 	if !ok {
-		if strings.TrimSpace(identity.SPN) != "" {
-			return strings.TrimSpace(identity.SPN)
+		if len(spn) > 0 && strings.TrimSpace(spn[0]) != "" {
+			return strings.TrimSpace(spn[0])
 		}
 		return "--"
 	}
+	if len(spn) > 0 && strings.TrimSpace(spn[0]) != "" {
+		brand := strings.TrimSpace(spn[0])
+		brandCountry := country
+		if strings.Contains(strings.ToLower(brand), "lebara") && strings.HasPrefix(strings.TrimSpace(imsi), "20404") {
+			brandCountry = "GB"
+		}
+		return strings.TrimSpace(strings.Join([]string{telegramCountryFlag(brandCountry), brand, "（认证核心 " + plmn + "）"}, " "))
+	}
 	return strings.TrimSpace(strings.Join([]string{telegramCountryFlag(country), name, "(" + plmn + ")"}, " "))
 }
 
@@ -2328,11 +2318,6 @@ func (bot *telegramBot) loadConfig(ctx context.Context) (telegramRuntimeConfig,
 }
 
 func (bot *telegramBot) call(ctx context.Context, config telegramRuntimeConfig, method string, payload any, result any) error {
-	// Telegram polling is a long-lived notification channel and must use the
-	// same administrator-configured destination exceptions as test messages,
-	// SMS pushes and automatic-task notifications. This keeps SSRF protection
-	// enabled while allowing explicit DNS Fake-IP ranges such as 198.18/15.
-	ctx = bot.notificationDestinationContext(ctx)
 	base, err := validateTelegramAPIURL(ctx, config.BaseURL, config.Token, method)
 	if err != nil {
 		return redactTelegramError(err, config.Token)
@@ -2375,13 +2360,6 @@ func (bot *telegramBot) call(ctx context.Context, config telegramRuntimeConfig,
 	return nil
 }
 
-func (bot *telegramBot) notificationDestinationContext(ctx context.Context) context.Context {
-	if bot.server == nil {
-		return ctx
-	}
-	return bot.server.notificationDestinationContext(ctx)
-}
-
 func (bot *telegramBot) sendText(ctx context.Context, config telegramRuntimeConfig, chatID int64, text string, replyMarkup any) error {
 	target := config.ChatID
 	if chatID != 0 {

internal/server/telegram_bot_test.go

@@ -57,17 +57,6 @@ func TestTelegramAPIURLRejectsMalformedTemplates(t *testing.T) {
 	}
 }
 
-func TestTelegramPollingAcceptsFakeIPWithoutWebAccessAllowlist(t *testing.T) {
-	bot := &telegramBot{server: &Server{access: parsedAccessConfig{mode: "internal"}}}
-	ctx := bot.notificationDestinationContext(context.Background())
-	if _, err := validateTelegramAPIURL(ctx, "https://198.18.0.34", "123456:test-token", "getUpdates"); err != nil {
-		t.Fatalf("explicitly allowed Telegram Fake-IP was rejected: %v", err)
-	}
-	if _, err := validateTelegramAPIURL(ctx, "https://169.254.169.254", "123456:test-token", "getUpdates"); err == nil {
-		t.Fatal("metadata address became reachable through Telegram allowlist")
-	}
-}
-
 func TestParseTelegramCommand(t *testing.T) {
 	command, remainder := parseTelegramCommand("  /sms@vocat_bot EC20 +447700900123 hello world  ")
 	if command != "sms" || remainder != "EC20 +447700900123 hello world" {
@@ -138,11 +127,8 @@ func TestTelegramCarrierPresentationSeparatesHomeAndServingNetworks(t *testing.T
 	if got := telegramHomeCarrier("234336570710174"); !strings.Contains(got, "🇬🇧") || !strings.Contains(got, "23433") {
 		t.Fatalf("home carrier = %q", got)
 	}
-	if got := telegramHomeCarrier("454006395879502", "Saily"); !strings.Contains(got, "1O1O / csl / Club Sim") || !strings.Contains(got, "45400") || !strings.Contains(got, "🇭🇰") || strings.Contains(got, "Saily") {
-		t.Fatalf("profile brand overrode home carrier = %q", got)
-	}
-	if got := telegramHomeCarrier("999991234567890", "Unknown Brand"); got != "Unknown Brand" {
-		t.Fatalf("unknown home carrier did not fall back to SPN: %q", got)
+	if got := telegramHomeCarrier("204040123456789", "Lebara"); !strings.Contains(got, "Lebara") || !strings.Contains(got, "20404") || !strings.Contains(got, "🇬🇧") || strings.Contains(got, "🇳🇱") {
+		t.Fatalf("branded foreign-core carrier = %q", got)
 	}
 	flight := &device.Snapshot{FlightMode: true, OperatorName: "stale network", RegistrationStatus: 1}
 	if got := telegramCurrentNetwork(flight); got != "--（飞行模式）" {