refactor: 删除未使用的 api_external_url 配置并完善 runtime 文档

- 删除 SupabaseSettings 中未使用的 api_external_url computed field
- 更新测试文件移除相关测试用例
- backend/AGENTS.md 新增软删除设计规则
- runtime-database.md 更新表结构（删除 user_agents，表名更新为 agent_chat_sessions/messages，system_agents）
- runtime-frontend.md 补充路由结构和功能模块说明
- 根 AGENTS.md 清理过时技能路径引用

docs/runtime/runtime-frontend.md

@@ -1,11 +1,21 @@
-# Frontend Runtime Runbook
+# Frontend Runtime
 
-**Date:** 2026-02-27
-**Status:** Active
+**Date:** 2026-03-06  
+**Status:** Active  
 **Audience:** 前端开发
 
 ---
 
+## 技术栈
+
+- **Framework:** Flutter (Dart)
+- **Routing:** go_router
+- **State Management:** BLoC + Cubit
+- **API Client:** Dio + Retrofit
+- **Mock Mode:** 支持 `--dart-define=MOCK_API=true`
+
+---
+
 ## 开发环境
 
 ### Mock 模式
@@ -35,6 +45,156 @@ Mock 模式下，启动 App 时会自动使用测试账号登录并跳转到首
 
 ---
 
+## 路由结构
+
+### 认证路由（无需登录）
+
+| 路由 | 页面 | 说明 |
+|------|------|------|
+| `/` | LoginScreen | 登录页（默认首页） |
+| `/register` | RegisterScreen | 注册页 |
+| `/register/verification` | RegisterVerificationScreen | 注册验证码页 |
+| `/reset-password` | ResetPasswordScreen | 重置密码页 |
+
+### 受保护路由（需要登录）
+
+| 路由 | 页面 | 说明 |
+|------|------|------|
+| `/home` | HomeScreen | 首页（AI 助手） |
+| `/contacts` | ContactsScreen | 通讯录 |
+| `/contacts/add` | AddContactScreen | 添加联系人 |
+| `/calendar/month` | CalendarMonthScreen | 月视图 |
+| `/calendar/dayweek` | CalendarDayweekScreen | 日/周视图 |
+| `/calendar/events/:id` | CalendarEventDetailScreen | 日程详情 |
+| `/todo` | TodoQuadrantsScreen | 待办四象限 |
+| `/messages/invites` | MessageInviteListScreen | 消息邀请列表 |
+| `/messages/invites/:id` | MessageInviteDetailScreen | 消息邀请详情 |
+| `/settings` | SettingsScreen | 设置首页 |
+| `/settings/features` | FeaturesScreen | 功能开关 |
+| `/settings/memory` | MemoryScreen | 记忆管理 |
+| `/settings/account` | AccountScreen | 账号设置 |
+
+---
+
+## 功能模块
+
+### Auth（认证）
+
+**路径:** `apps/lib/features/auth/`
+
+| 文件 | 说明 |
+|------|------|
+| `presentation/bloc/auth_bloc.dart` | 认证状态管理 |
+| `presentation/cubits/` | 登录/注册/重置密码 Cubit |
+| `ui/screens/` | 认证相关页面 |
+| `data/repositories/auth_repository.dart` | 认证 API 调用 |
+
+**流程：**
+1. 注册： `/register` → 输入邮箱/用户名/密码 → `/register/verification` → 输入验证码 → `/home`
+2. 登录: `/` → 输入邮箱/密码 → `/home`
+3. 重置密码: `/reset-password` → 输入邮箱 → 收到邮件 → 输入验证码+新密码 → `/`
+
+---
+
+### Home（首页/AI 助手）
+
+**路径:** `apps/lib/features/home/`
+
+| 文件 | 说明 |
+|------|------|
+| `ui/screens/home_screen.dart` | 首页（AI 助手入口） |
+| `ui/screens/home_sheet.dart` | 首页底部弹出面板 |
+
+**功能：**
+- AI 助手对话入口
+- 快速访问常用功能
+
+---
+
+### Calendar（日历）
+
+**路径:** `apps/lib/features/calendar/`
+
+| 文件 | 说明 |
+|------|------|
+| `ui/screens/calendar_month_screen.dart` | 月视图 |
+| `ui/screens/calendar_dayweek_screen.dart` | 日/周视图 |
+| `ui/screens/calendar_event_detail_screen.dart` | 日程详情 |
+| `ui/calendar_time_utils.dart` | 时间工具函数 |
+
+**功能：**
+- 月/日/周三视图切换
+- 日程创建/编辑/删除
+- 日程分享
+
+---
+
+### Todo（待办）
+
+**路径:** `apps/lib/features/todo/`
+
+| 文件 | 说明 |
+|------|------|
+| `ui/screens/todo_quadrants_screen.dart` | 四象限视图 |
+| `ui/screens/todo_detail_screen.dart` | 待办详情 |
+
+**功能：**
+- 四象限管理（重要/紧急矩阵）
+- 待办创建/编辑/完成/删除
+
+---
+
+### Contacts（通讯录）
+
+**路径:** `apps/lib/features/contacts/`
+
+| 文件 | 说明 |
+|------|------|
+| `ui/screens/contacts_screen.dart` | 通讯录列表 |
+| `ui/screens/add_contact_screen.dart` | 添加联系人 |
+
+**功能：**
+- 好友列表
+- 搜索用户
+- 添加好友
+
+---
+
+### Messages（消息）
+
+**路径:** `apps/lib/features/messages/`
+
+| 文件 | 说明 |
+|------|------|
+| `ui/screens/message_invite_list_screen.dart` | 邀请消息列表 |
+| `ui/screens/message_invite_detail_screen.dart` | 邀请详情 |
+
+**功能：**
+- 日程邀请通知
+- 好友请求通知
+- 群组邀请通知
+
+---
+
+### Settings（设置）
+
+**路径:** `apps/lib/features/settings/`
+
+| 文件 | 说明 |
+|------|------|
+| `ui/screens/settings_screen.dart` | 设置首页 |
+| `ui/screens/features_screen.dart` | 功能开关 |
+| `ui/screens/memory_screen.dart` | 记忆管理 |
+| `ui/screens/account_screen.dart` | 账号设置 |
+
+**功能：**
+- 个人资料编辑
+- 记忆管理（用户/工作记忆）
+- 功能开关
+- 账号安全设置
+
+---
+
 ## 打包构建
 
 ### Debug Build
@@ -100,4 +260,5 @@ flutter run -d emulator-5554
 
 | 日期 | 变更 |
 |------|------|
+| 2026-03-06 | 完善路由结构、功能模块说明，补充技术栈信息 |
 | 2026-02-27 | 新增 Frontend Runbook，支持 --dart-define=MOCK_API=true 切换 Mock 模式 |