# ts-grm 文档

> ts-grm 的类型驱动数据访问文档：模型、视图（View）、Input DTO、查询 DSL 与 SQL 后端。
> 面向中文读者的交互式教程，每页配有可运行示例。

本文件是索引。每页都有 Markdown 版本：将页面 URL 加上 `.md`，或者对同一 URL 发送 `Accept: text/markdown`（内容协商）；全文单文件见 https://ts-grmd.guico.top/llms-full.txt。

## 关于本教程

> 教程讲什么、怎么读：章节地图、阅读路径，以及每页示例运行所在的沙盒环境。

- [认识 ts-grm](https://ts-grmd.guico.top/docs/about/welcome.md)
- [认识沙盒环境](https://ts-grmd.guico.top/docs/about/sandbox.md)
- [为什么这么快：TS7 原生编译器](https://ts-grmd.guico.top/docs/about/ts7.md)

## 快速上手

> 安装 → 模型 → 视图 → 查询：四步跑通第一个可运行示例。

- [安装](https://ts-grmd.guico.top/docs/getting-started/install.md)
- [模型](https://ts-grmd.guico.top/docs/getting-started/model.md)
- [视图](https://ts-grmd.guico.top/docs/getting-started/view.md)
- [查询](https://ts-grmd.guico.top/docs/getting-started/query.md)

## 核心概念

> 模型、属性、关联、继承多态（独立子表与单表两种策略）、复合值与公式——以及整个框架的理念基石「DTO 哲学」。

- [模型](https://ts-grmd.guico.top/docs/core-concepts/model.md)
- [属性与类型](https://ts-grmd.guico.top/docs/core-concepts/props.md)
- [关联](https://ts-grmd.guico.top/docs/core-concepts/associations.md)
- [继承与多态](https://ts-grmd.guico.top/docs/core-concepts/inheritance.md)
- [单表继承（TABLE_INHERIT）](https://ts-grmd.guico.top/docs/core-concepts/sti.md)
- [复合值 embedded](https://ts-grmd.guico.top/docs/core-concepts/embedded.md)
- [公式与计算属性](https://ts-grmd.guico.top/docs/core-concepts/formula.md)
- [DTO 哲学](https://ts-grmd.guico.top/docs/core-concepts/dto-philosophy.md)

## 查询 API

> 从根查询到条件、排序、取形、分页、自定义数据类型——再到聚合、子查询、CTE 与关联预取的完整查询能力。

- [根查询与取形](https://ts-grmd.guico.top/docs/query/root-query.md)
- [条件表达式](https://ts-grmd.guico.top/docs/query/where.md)
- [排序](https://ts-grmd.guico.top/docs/query/order.md)
- [取形进阶](https://ts-grmd.guico.top/docs/query/shaping.md)
- [分页与区间](https://ts-grmd.guico.top/docs/query/page.md)
- [聚合与分组](https://ts-grmd.guico.top/docs/query/aggregate.md)
- [子查询](https://ts-grmd.guico.top/docs/query/sub-query.md)
- [CTE 与集合运算](https://ts-grmd.guico.top/docs/query/cte.md)
- [原生 SQL](https://ts-grmd.guico.top/docs/query/native.md)
- [关联预取与批加载](https://ts-grmd.guico.top/docs/query/prefetch.md)
- [自定义数据类型](https://ts-grmd.guico.top/docs/query/custom-type.md)

## SQL 后端

> 驱动接入、命名策略、事务、方言差异、SQL 日志、模式创建与实体过滤器（SQL 拦截器）。

- [驱动接入与 SqlClient](https://ts-grmd.guico.top/docs/sql-backend/driver.md)
- [命名策略与表结构](https://ts-grmd.guico.top/docs/sql-backend/naming.md)
- [事务](https://ts-grmd.guico.top/docs/sql-backend/transaction.md)
- [方言差异](https://ts-grmd.guico.top/docs/sql-backend/dialect.md)
- [SQL 日志与追踪](https://ts-grmd.guico.top/docs/sql-backend/logging.md)
- [模式创建与实体管理器](https://ts-grmd.guico.top/docs/sql-backend/schema.md)
- [SQL 拦截器（实体过滤器）](https://ts-grmd.guico.top/docs/sql-backend/filter.md)

## API 参考

> core / sql 快速参考：模型、属性、视图、DSL 与 SqlClient、驱动、选项的速查入口。

- [core 快速参考](https://ts-grmd.guico.top/docs/reference/core.md)
- [sql 快速参考](https://ts-grmd.guico.top/docs/reference/sql.md)