# speed

**Repository Path**: pzxye/speed

## Basic Information

- **Project Name**: speed
- **Description**: No description available
- **Primary Language**: Go
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-06
- **Last Updated**: 2026-04-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# speed

`speed` 是模板服务的 foundation 仓库，不承担业务模板骨架，也不承担 `awesome` 风格的重型 harness 治理。

它的职责很明确：

- 承载可复用的基础设施 core、contract、adapter 和少量通用 utility
- 为 `awesome` 以及后续同类项目提供稳定 import path
- 保持“库仓”心智，而不是再长成一个 opinionated framework

## Governance

`speed` 采用 lightweight governance，而不是 full harness：

- 包分类和 canonical path 规则见 `docs/TAXONOMY.md`
- 兼容层和演进规则见 `docs/GOVERNANCE.md`
- 顶层入口定位见 `docs/PUBLIC_ENTRYPOINTS.md`、`docs/INFRA_ENTRYPOINTS.md`、`docs/HISTORICAL_ENTRYPOINTS.md`
- 历史 utility 分组蓝图见 `docs/HISTORICAL_GROUPING_BLUEPRINT.md`
- 历史 utility 分组执行结果见 `docs/GROUPING_EXECUTION_2026-04-02.md`
- 基础设施入口分组蓝图见 `docs/INFRA_GROUPING_BLUEPRINT.md`
- 顶层 utility 内容评估见 `docs/TOP_LEVEL_UTILITY_REVIEW_2026-04-02.md`
- 验证基线固定使用 `gvm` 的 `go1.25.8`

## Layout

- `shared/**`: 小而稳定的共享 contract 与 helper
- `kernel/**`: core business context 可复用的稳定执行内核
- `platform/**`: 模板基础设施 core、状态机、provider store、runtime engine
- `x*`: 剩余的稳定顶层入口和未归组历史 utility
- `convert/**`: 已落地的 grouped historical utility 目录
- `transport/**`: 已落地的 grouped historical utility 目录
- `infra/**`: 已落地的 grouped infrastructure entrypoint 目录

当前默认方向：

- 新的 foundation core 优先进入 `platform/**`、`shared/**` 或 `kernel/**`
- 已删除的旧兼容路径不恢复；新能力直接进入 canonical path
- 纯 utility 若还没有更合适的分组，暂时保留在顶层，后续再分批整理
- 本轮已完成 `convert/conv`、`convert/cast`、`transport/xgrpc`、`transport/xws`、`xrand`、`xcron` 的第一轮 API 收口
- grouped historical utility 的第一批迁移已执行：`conv -> convert/conv`、`xcast -> convert/cast`
- grouped historical utility 的第二批迁移已执行：`xgrpc -> transport/xgrpc`、`xws -> transport/xws`
- grouped infra entrypoint 的迁移已执行：`xredis -> infra/redis`、`xdb -> infra/db`、`xminio -> infra/minio`、`xmqtt -> infra/mqtt`、`xleaf -> infra/leaf`

## Validation

```bash
bash scripts/check_boundaries.sh
source ~/.gvm/scripts/gvm
gvm use go1.25.8
go test ./... -timeout 120s -count=1
```