# TS 后端初始化 v1

> Status: Trial（试行）；Version: 1。
>
> 技术路线：TypeScript + Hono + Drizzle。

这是项目负责人的常用后端路线，适用于独立后端，也适用于前后端共用仓库中的后端目录。

AI 先读取本场景，再执行[通用初始化流程](../common.md)。以下要求补充到通用流程的对应步骤中。

## 已确定的技术路线

| 用途 | 选择 |
| --- | --- |
| 开发语言 | TypeScript |
| HTTP 框架 | Hono |
| 数据库访问 | Drizzle ORM |

用户要求采用本场景时，AI 沿用这组选择，不再重复询问是否使用 Hono 或 Drizzle。已有项目使用不同技术时，先说明差异，不能因初始化而更换框架或迁移数据；不依赖这些选择的通用治理流程可以继续。

治理初始化负责安装规则、Skills 和建立项目文档。用户同时要求创建项目骨架时，AI 才按这条路线创建代码、安装依赖。

## 还需要了解的项目情况

AI 先阅读代码、配置和用户需求，查清以下信息；已有答案不重复询问。

- **代码与运行方式**：后端目录、运行时（如 Node.js 或 Bun）、包管理工具，以及启动命令。
- **数据库与部署**：使用哪种数据库和驱动，服务部署在哪里，如何管理连接和迁移。
- **业务与接口**：后端负责哪些功能，接口的输入、输出和权限要求是什么。
- **模块与外部服务**：现有职责划分，以及需要调用的短信、支付等外部服务。

本版尚未固定运行时、数据库类型和部署平台，不能仅凭 Hono + Drizzle 推断。缺失信息只有在影响下一步时才询问；其余注明“尚未确定”。

已有项目沿用依赖清单和锁文件中的版本。创建新骨架时，AI 核对依赖兼容性，记录实际采用的版本并生成锁文件；本场景的 `v1` 不代表 Hono 或 Drizzle 的软件版本。

## Skill 选择

选用 [TypeScript 后端职责与边界](../../skills/backend/typescript-backend-boundaries/SKILL.md)，约定业务逻辑、Drizzle 数据库访问、接口定义和 Hono 请求适配的职责。配套资源：[架构说明](../../skills/backend/typescript-backend-boundaries/references/architecture.md)、[Agent 元数据](../../skills/backend/typescript-backend-boundaries/agents/openai.yaml)。

已确认分层时直接安装；分层尚未确定或与现有架构冲突时，按治理规则处理。此 Skill 仅适用于后端目录，通用 Skill 按通用流程选择。

## 验证范围

AI 从现有配置中查找类型检查、测试、构建和架构检查命令，记录各自的执行目录。架构检查指检查模块之间是否违反依赖约定。

本次只运行与实际改动相关的检查。没有的检查如实注明，不为完成治理初始化额外引入工具。接口、权限和数据行为仍按实际任务要求验收。

## 版本约定

- `v1` 表示本场景的技术路线与初始化要求。措辞修正和不改变既有要求的说明补充仍更新 v1。
- 技术路线、架构要求或初始化结果发生不兼容变化时，新增 `v2.md`，保留 v1 入口；已有项目不自动升级。
- 通用流程、治理规则和 Skills 各自维护。本入口不是所有依赖内容的冻结快照；记录采用版本和来源，日常使用项目内的本地副本。