build: establish unified project entry

docs/current-state.md

@@ -12,34 +12,35 @@
 ## 当前快照
 
 - 日期：2026-08-03
-- 阶段：**Phase 0 · 地基（采购服务与采购工具骨架已初始化，尚无采购业务代码）**
+- 阶段：**Phase 0 · 地基（两端骨架、核心数据模型与统一入口已完成，尚无真机采购业务代码）**
 - MVP 形态：手工填链接建单 → 批量开始试选 → 定时轮询 → **第一趟试选** → 人工确认 → **第二趟下单** → 待付款
 - 技术栈：已定。采购服务（`admin/`）使用 Go 1.23+ / gin / SQLite；采购工具（`client/`）
   使用 Python 3.11+ / uiautomator2 / PySide6。
   详见 [`03-tech-stack.md`](03-tech-stack.md)
-- 生产代码：`admin/` 已有最小 Go 服务、`GET /healthz` 与 SQLite 驱动封装；`client/` 已有
-  Python 包、PySide6 最小入口、运行目录与日志脱敏策略；两端均尚无采购业务代码
-- 测试：采购服务 2 项离线单元测试；采购工具 6 项离线单元测试（不连接真机）
-- 数据：**无**
-- 标准启动路径：`./init.ps1`（Windows）/ `./init.sh`。两端骨架现已存在，但 `init.ps1` 仍使用
-  默认 Python 3.10，不能正确验证要求 Python 3.11+ 的采购工具；T-003 负责统一入口与解释器选择。
-- 标准验证路径：`admin/` 下运行 `go test ./...`、`go vet ./...`、`go build ./...`；`client/` 下使用
-  `py -3.12 -m unittest discover -s tests -t .`、`py -3.12 -m compileall -q src tests scripts`；仓库根运行
-  `python scripts/validate_agent_context.py`
-- 当前 blocker：无外部 blocker。T-002 已完成；T-004 核心数据模型正在进行；T-003 统一入口与
-  T-101 真机环境盘点已就绪。当前不宣称统一入口或桌面 GUI 已验收。
+- 生产代码：`admin/` 已有最小 Go 服务、健康检查、核心领域模型、SQLite 迁移与任务状态机；
+  `client/` 已有 Python 包、PySide6 最小入口、运行目录与日志脱敏策略；尚无真机采购流程
+- 测试：采购服务已覆盖健康检查、核心模型、迁移与状态机等离线包级测试；采购工具 6 项离线单元测试
+  （不连接真机）
+- 数据：SQLite 核心表与迁移已落成；无业务实例数据
+- 标准启动路径：Windows PowerShell 运行 `./init.ps1`，Unix shell 运行 `./init.sh`。Windows 入口
+  优先使用合规的既有 venv；仅在其缺失时才从 Python Launcher 已安装版本中选择最高的 Python 3.11+，
+  并且不覆盖低版本环境；成功后打印真实启动命令。
+- 标准验证路径：`./init.ps1` 已实际跑通 admin 的 mod download / test / vet / build、client 的
+  editable install / 包导入 / unittest / compileall，以及仓库上下文校验。可单独运行两端命令诊断。
+- 当前 blocker：无外部 blocker。T-002、T-003、T-004 已完成；T-101 真机环境盘点已就绪，
+  但尚未真机验收。桌面 GUI 与真机流程尚未验收。
 
 ## 当前目录要点
 
 | 路径 | 状态 | 说明 |
 | --- | --- | --- |
 | `docs/` | 已有 | 项目规范化文档，本次已完整生成 |
-| `docs/tasks/` | 已有（T-001、T-002、T-004～T-009） | T-001、T-002 已完成；T-004 正在进行；其余既有任务已完成 |
+| `docs/tasks/` | 已有（T-001～T-004、T-005～T-009、T-101） | T-001～T-004 已完成；T-101 已就绪、待真机验收 |
 | `docs/design/` | 已有（6 个原型） | web 登录 / 建单 / 工作台 / 详情，desk 采购执行 / 配置；均已人工确认 |
 | `scripts/` | 已有 | 上下文门禁、Vikunja 单向导出与 MCP 启动包装 |
-| `admin/` | 已初始化 | Go 1.23+ / gin / SQLite 骨架与健康检查；无采购业务路由 |
+| `admin/` | 已初始化 | Go 1.23+ / gin / SQLite，含核心模型、迁移与状态机；无真机采购执行 |
 | `client/` | 已初始化 | Python 3.11+ 包、依赖源、PySide6 最小入口、离线测试与 wheel 元数据检查；无真机或采购流程 |
-| `init.ps1` / `init.sh` | 已有（骨架） | 统一入口。两端目录建好后由 T-003 补全并验证 |
+| `init.ps1` / `init.sh` | 已完成 | 统一安装与离线验证入口；PowerShell 优先复用合规 venv，缺失时自动选择最高的 Python 3.11+，Unix 缺工具链明确失败 |
 
 ## 任务状态
 
@@ -48,59 +49,53 @@
 - 已完成：T-005（采购服务交互原型）、T-006（采购工具交互原型）、T-007（产品名称与
   源码目录契约）、T-008（Vikunja 任务权威与单向导出）、T-009（MVP 关键路径与并行波次），
   以及 T-001（采购服务 Go 骨架）。
-- 已完成：T-002（采购工具 Python 骨架）。正在进行：T-004（核心数据模型）。
-  T-003（统一入口）与 T-101（真机环境盘点）已就绪，立即推进 T-101 → T-102 → T-103。
+- 已完成：T-002（采购工具 Python 骨架）、T-003（双端统一初始化与验证入口）、
+  T-004（核心数据模型）。T-101（真机环境盘点）已建档并就绪，尚未真机验收，接续推进
+  T-101 → T-102 → T-103。
 - T-103 是当前最高优先级和 MVP 生死线。通过前不开发依赖真机可读字段的 Phase 2 生产页面。
 - 已确认原型继续只作信息架构依据；原型假数据不调用真实接口、不驱动真机。真机结论改变
   可读字段时必须先回修原型与交互清单。
 
 ## 当前可运行内容
 
-采购服务当前可运行：
+Windows 统一安装、离线验证与启动命令提示已可运行：
 
-```bash
-cd admin
-go mod download
-go run ./cmd/server
+```powershell
+.\init.ps1
 ```
 
-采购服务验证与仓库级上下文门禁：
+它会在成功后输出以下真实启动命令，而不自动启动或连接设备：
 
-```bash
-cd admin
-go test ./...
-go vet ./...
-go build ./...
-
-cd ..
-python scripts/validate_agent_context.py
+```text
+采购服务：cd admin; go run ./cmd/server
+采购工具：cd client; .\.venv\Scripts\python.exe -m cmbuyer_client
 ```
 
 采购工具当前可运行的离线验证与 wheel 元数据检查：
 
 ```powershell
 cd client
-py -3.12 -m unittest discover -s tests -t .
-py -3.12 -m compileall -q src tests scripts
+.\.venv\Scripts\python.exe -m unittest discover -s tests -t .
+.\.venv\Scripts\python.exe -m compileall -q src tests scripts
 $wheelDir = Join-Path $env:TEMP ('cmbuyer-client-wheel-' + [guid]::NewGuid())
 New-Item -ItemType Directory -Path $wheelDir | Out-Null
-py -3.12 -m pip wheel --no-deps . --wheel-dir $wheelDir
-py -3.12 scripts/verify_wheel_metadata.py (Get-ChildItem $wheelDir -Filter '*.whl').FullName
+.\.venv\Scripts\python.exe -m pip wheel --no-deps . --wheel-dir $wheelDir
+.\.venv\Scripts\python.exe scripts/verify_wheel_metadata.py (Get-ChildItem $wheelDir -Filter '*.whl').FullName
 ```
 
 采购工具规范安装与本地开发入口：
 
 ```powershell
+# 在仓库根执行统一初始化；成功后再进入 client/
+.\init.ps1
 cd client
-py -3.12 -m venv .venv
-.\.venv\Scripts\python.exe -m pip install -e .
 .\.venv\Scripts\python.exe -m cmbuyer_client
 ```
 
 `client/requirements.txt` 是唯一依赖来源，`client/pyproject.toml` 动态读取它生成 wheel 的
 `Requires-Dist`。Python 3.12 已验证 6 项离线测试、编译与 wheel 元数据；完整运行时依赖安装
-（`pip install -e .`）已通过。`init.ps1` 当前仍选择 Python 3.10，因此不能声称统一入口已正确；
-桌面 GUI 与真机流程未作为 T-002 验收执行。
+（`pip install -e .`）已通过。`init.ps1` 优先使用合规既有 venv，缺失时自动选择最高的 Python 3.11+；
+本机现有 venv 实际验证为 Python 3.12。桌面 GUI 与真机流程未作为 T-003 验收执行。
 
 ## 关键背景