用途:规划或修订站点信息架构,明确页面存在范围、导航组织、URL 内容以及公开、登录、组织范围和管理员区域的划分。从用户词汇、使用频率和关系出发,而非照搬数据库表。
主要能力:检查现有路由与需求,区分实际 URL 与框架文件夹(路由组只是组织手段,不是授权边界);识别公开、已认证、组织范围与特权区域,并指明服务端检查在何处强制执行访问控制,包括直接请求;依据层级与任务频率选择导航,保持标签可预测,不为未来无当前理由的路由预留;将非敏感的可分享视图状态放入 URL 参数,凭据、个人输入和私有草稿不进入 URL;定义深链、刷新、前进后退、未找到和会话过期行为,重定向前验证返回目标;修订时尽量保留现有 URL,否则映射重定向并检查入站链接、书签、元数据和搜索索引。
使用方式:输出简洁的路由树,加上用户任务、访问规则、导航位置、URL 状态、迁移/未知项,区分提议端点与现有端点。建议格式为:路由树(标记提议与现有)、导航、约定、访问、迁移/未知项。例如 /projects?status=active 可保留列表视图,/projects/:id 仍须检查登录用户是否有权读取该项目;隐藏侧边栏链接不能保护记录。确认主要任务可通过直接 URL 找到并重新打开。任务内序列用 $flow,单页内容优先级用 $hierarchy。
适用场景:新建或重构站点信息架构、梳理导航与权限区域、设计可分享 URL 状态、规划路由迁移与重定向。
限制:不用于单一任务序列(用 $flow);不用于编写可测试行为或权限规则(用 $requirements),缺少需求不是阻碍,可按简报映射路由并标记提议区域;不用于单页内容优先级(用 $hierarchy)。注意路由组和嵌套布局在文件树中看似安全边界,实际只组织代码;URL 会进入浏览器历史、服务器日志和 referrer 头,过滤器可放入,令牌和草稿文本不可;从查询字符串取登录返回 URL 可能把用户送到其他站点,只接受应用内路径;重命名路由会静默破坏书签、分享链接和搜索结果,除非旧 URL 重定向。