easy-next-admin/docs/components/_template.md

组件名称

适用场景

说明这个组件解决哪个真实后台问题，什么情况下应该使用，什么情况下不应该使用。

如何使用

给出最小接入步骤。示例必须来自当前项目已有代码，或是能按当前工程约束直接落地的代码片段。

请求或执行流程

用步骤描述一次请求或一次任务执行时，哪些类按什么顺序参与。

原理

解释组件的核心机制、边界和失败策略。优先说明“谁负责决策，谁负责执行”。

关键类、配置和表

列出入口注解、配置类、核心服务和数据库表。

Tradeoff

比较当前方案和至少两个备选方案。说明各自优点、缺点、适用场景和不适用场景。

常见坑

列出二开时容易出错的地方，以及如何避免。

扩展建议

记录后续可以优化的方向。不要把尚未实现的优化写成当前能力。