@nexttylabs/echo 0.4.0 → 0.6.0

package/docs/product_changes.md

@@ -1,37 +0,0 @@
-# Portal Experience: 产品功能与角色影响更新
-
-## 🚀 核心功能更新 (Core Features)
-
-1.  **反馈门户 (Feedback Portal)**
-    *   新增 `/portal` 统一入口，聚合“提交反馈”、“路线图”、“变更日志”等功能模块。
-    *   提供清晰的导航结构，替代原先零散的页面访问方式。
-
-2.  **智能即时防重 (Inline Duplicate Detection)**
-    *   用户在表单输入标题时，系统实时通过 AI/算法匹配现有反馈。
-    *   在输入框下方即时显示“可能存在相似反馈”列表，支持点击查看。
-
-3.  **智能链接预填充 (Smart URL Prefill)**
-    *   支持通过 URL 参数自动填充表单字段。
-    *   支持字段：`title` (标题), `description` (描述), `type` (类型: bug/feature/etc), `priority` (优先级)。
-
----
-
-## 👥 角色影响详解 (Impact by Role)
-
-### 1. 终端用户 (End Users)
-*   **体验升级**: 拥有了一个集中的“反馈中心”首页，不再迷失。
-*   **极速反馈**: 在输入标题时若看到相似问题，可直接点击查看并投票，**无需重复撰写**长篇大论，减少挫败感。
-*   **操作简化**: 点击支持团队发送的特定链接时，表单类别、优先级等可能已被自动填好，只需补充核心信息。
-
-### 2. 产品经理 & 管理员 (Product Managers & Admins)
-*   **效率提升**: 系统在源头拦截了大量重复反馈，**Review 列表中的“重复项”将显著减少**，大大降低人工分拣和合并的压力。
-*   **数据质量优化**: 通过推广带参数的链接（如 `?type=feature&title=二期需求`），可以引导用户提交更规范、分类更准确的数据。
-*   **闭环体验**: 详情页新增“返回反馈中心”按钮，用户流失率降低，更容易留在门户内产生更多互动。
-
-### 3. 客户支持团队 (Support Team)
-*   **工单转化神器**: 当用户在聊天/邮件中报告问题时，支持人员可以直接发送预填充链接（例如：`/portal?type=bug&priority=high&title=登录失败`）。
-*   **即用即走**: 降低用户填写门槛，提高工单收集成功率和信息的准确度。
-
-### 4. 开发者 (Developers)
-*   **API 能力**: 开放 `/api/feedback/similar` 端点。
-*   **扩展性**: 可将“相似反馈搜索”功能集成到内部 CRM、CLI 工具或 Slack 机器人中，进一步打通工作流。

package/docs/project-overview.md

@@ -1,159 +0,0 @@
-# Project Overview
-
-**Project:** Echo
-**Type:** Web Application
-**Purpose:** 用户反馈系统
-**Generated:** 2025-12-31
-
-## Executive Summary
-
-Echo 是一个现代化的 Web 应用，使用 Next.js 16 和 React 19 构建，旨在让用户通过 Web 页面反馈应用或服务的使用情况。项目采用 App Router 架构、React Server Components 和 TypeScript 严格模式，使用 Shadcn/ui 作为组件库，Tailwind CSS v4 进行样式管理。
-
-## Quick Reference
-
-| 属性 | 值 |
-|------|-----|
-| **项目类型** | 单体 Web 应用 |
-| **主语言** | TypeScript 5.x |
-| **框架** | Next.js 16.1.1 + React 19.2.3 |
-| **架构模式** | App Router + React Server Components |
-| **包管理器** | Bun |
-| **代码库** | `/Users/derek/Workspaces/echo` |
-
-## Technology Stack Summary
-
-### Frontend
-
-| 类别 | 技术 | 版本 |
-|------|------|------|
-| **框架** | Next.js | 16.1.1 |
-| **UI 库** | React | 19.2.3 |
-| **语言** | TypeScript | 5.x (strict) |
-| **样式** | Tailwind CSS | 4.x |
-| **组件库** | Shadcn/ui | 3.6.2 |
-| **基础组件** | Base UI | 1.0.0 |
-| **Radix UI** | Radix UI | 1.4.3 |
-| **图标** | Lucide React | 0.562.0 |
-
-### Development Tools
-
-| 工具 | 用途 |
-|------|------|
-| **Bun** | 包管理器和运行时 |
-| **ESLint** | 代码检查 |
-| **TypeScript** | 类型检查 |
-
-## Repository Structure
-
-```
-echo/                      # 项目根目录
-├── app/                   # Next.js App Router
-├── components/            # React 组件
-│   └── ui/               # Shadcn/ui 基础组件（14 个）
-├── lib/                   # 工具函数
-├── docs/                  # 项目文档
-├── public/                # 静态资源
-└── _bmad/                 # BMAD 工作流系统
-```
-
-## Architecture Classification
-
-| 维度 | 分类 |
-|------|------|
-| **应用类型** | 单体应用 (Monolith) |
-| **渲染模式** | 混合（Server + Client Components）|
-| **路由系统** | 文件系统路由 (App Router) |
-| **样式方案** | 实用优先 CSS (Tailwind) |
-| **状态管理** | 未实现 |
-
-## Current Implementation Status
-
-### ✅ 已实现
-
-| 功能 | 状态 |
-|------|------|
-| Next.js 项目结构 | ✅ |
-| Shadcn/ui 组件库 | ✅ (14 个基础组件) |
-| Tailwind CSS 主题 | ✅ |
-| TypeScript 类型检查 | ✅ |
-| ESLint 代码规范 | ✅ |
-| 开发/构建脚本 | ✅ |
-
-### ❌ 未实现
-
-| 功能 | 状态 |
-|------|------|
-| API 路由 | ❌ |
-| 数据库 | ❌ |
-| 状态管理 | ❌ |
-| 用户认证 | ❌ |
-| 测试套件 | ❌ |
-| CI/CD | ❌ |
-| Docker 配置 | ❌ |
-
-## Project Status
-
-**阶段：** 初始化/脚手架
-
-项目处于早期开发阶段，已建立基础架构和开发环境，但核心功能尚未实现。
-
-## Documentation Index
-
-| 文档 | 描述 |
-|------|------|
-| [Architecture](./architecture.md) | 系统架构详细说明 |
-| [Source Tree Analysis](./source-tree-analysis.md) | 源代码树结构 |
-| [Component Inventory](./component-inventory.md) | 组件清单 |
-| [Development Guide](./development-guide.md) | 开发指南 |
-
-## Existing Documentation
-
-| 文档 | 位置 | 描述 |
-|------|------|------|
-| README.md | `/` | Next.js 标准启动文档 |
-| CLAUDE.md | `/` | Claude Code 项目指令 |
-
-## Getting Started
-
-### 快速开始
-
-```bash
-# 1. 安装依赖
-bun install
-
-# 2. 启动开发服务器
-bun dev
-
-# 3. 访问应用
-open http://localhost:3000
-```
-
-### 可用命令
-
-```bash
-bun dev          # 开发服务器
-bun run build    # 生产构建
-bun start        # 生产服务器
-bun run lint     # 代码检查
-```
-
-## Development Setup
-
-详细开发设置请参阅：[Development Guide](./development-guide.md)
-
-## Next Steps
-
-1. **核心功能开发** - 实现反馈系统的核心功能
-2. **API 设计** - 设计和实现 API 端点
-3. **数据层** - 添加数据库和 ORM
-4. **状态管理** - 实现客户端状态管理
-5. **测试** - 添加测试套件
-6. **部署** - 配置 CI/CD 和部署流程
-
-## Contributing
-
-本项目使用 BMad Method 工作流进行开发。查看 `_bmad-output/planning-artifacts/` 目录获取规划文档。
-
-## License
-
-未指定

package/docs/project-scan-report.json

@@ -1,104 +0,0 @@
-{
-  "workflow_version": "1.2.0",
-  "timestamps": {
-    "started": "2025-12-31T00:00:00Z",
-    "last_updated": "2025-12-31T00:00:00Z"
-  },
-  "mode": "initial_scan",
-  "scan_level": "quick",
-  "project_root": "/Users/derek/Workspaces/echo",
-  "output_folder": "/Users/derek/Workspaces/echo/docs",
-  "current_step": "completed",
-  "findings": {
-    "project_classification": {
-      "repository_type": "monolith",
-      "parts_count": 1,
-      "primary_tech": "Next.js 16.1.1 + React 19.2.3 + TypeScript 5"
-    },
-    "project_types": [
-      {
-        "part_id": "main",
-        "project_type_id": "web",
-        "display_name": "Web Application"
-      }
-    ],
-    "existing_docs_count": 2,
-    "technology_stack": {
-      "framework": "Next.js 16.1.1 + React 19.2.3",
-      "language": "TypeScript 5.x (strict mode)"
-    },
-    "architecture_pattern": "Next.js App Router + React Server Components"
-  },
-  "outputs_generated": [
-    "project-scan-report.json",
-    "source-tree-analysis.md",
-    "development-guide.md",
-    "architecture.md",
-    "component-inventory.md",
-    "project-overview.md",
-    "index.md"
-  ],
-  "completed_steps": [
-    {
-      "step": "step_1",
-      "status": "completed",
-      "timestamp": "2025-12-31T00:00:00Z",
-      "summary": "Classified as monolith with 1 parts"
-    },
-    {
-      "step": "step_2",
-      "status": "completed",
-      "timestamp": "2025-12-31T00:00:00Z",
-      "summary": "Found 2 existing docs"
-    },
-    {
-      "step": "step_3",
-      "status": "completed",
-      "timestamp": "2025-12-31T00:00:00Z",
-      "summary": "Tech stack: Next.js 16 + React 19 + TypeScript 5"
-    },
-    {
-      "step": "step_4",
-      "status": "completed",
-      "timestamp": "2025-12-31T00:00:00Z",
-      "summary": "Conditional analysis complete, 0 files written"
-    },
-    {
-      "step": "step_5",
-      "status": "completed",
-      "timestamp": "2025-12-31T00:00:00Z",
-      "summary": "Source tree documented"
-    },
-    {
-      "step": "step_6",
-      "status": "completed",
-      "timestamp": "2025-12-31T00:00:00Z",
-      "summary": "Dev/deployment guides written"
-    },
-    {
-      "step": "step_8",
-      "status": "completed",
-      "timestamp": "2025-12-31T00:00:00Z",
-      "summary": "Architecture docs written for 1 parts"
-    },
-    {
-      "step": "step_9",
-      "status": "completed",
-      "timestamp": "2025-12-31T00:00:00Z",
-      "summary": "All supporting docs written"
-    },
-    {
-      "step": "step_10",
-      "status": "completed",
-      "timestamp": "2025-12-31T00:00:00Z",
-      "summary": "Master index generated"
-    },
-    {
-      "step": "step_12",
-      "status": "completed",
-      "timestamp": "2025-12-31T00:00:00Z",
-      "summary": "Workflow complete"
-    }
-  ],
-  "resume_instructions": "Workflow completed"
-}

package/docs/route-role-visibility.md

@@ -1,51 +0,0 @@
-# 路由与用户角色可见性对照表
-
-> 生成日期：2026-01-13
-> 说明：依据当前路由与页面鉴权逻辑整理；如页面本身未做角色校验，但位于受保护布局中，则标记为“登录可见”。
-
-## 角色说明
-- **admin** 管理员
-- **product_manager** 产品经理
-- **developer** 开发者
-- **customer_support** 客服
-- **customer** 终端用户
-
-## 路由对照
-
-| 路由 | 页面/功能 | 访问要求 | 角色可见性 | 备注 |
-|---|---|---|---|---|
-| `/` | 落地页 | 公开 | 所有人 | - |
-| `/login` | 登录页 | 公开 | 所有人 | 已登录会重定向 `/dashboard` |
-| `/register` | 注册页 | 公开 | 所有人 | 已登录会重定向 `/dashboard` |
-| `/docs` | API 文档 | 公开 | 所有人 | Swagger UI |
-| `/feedback/[id]` | 公开反馈详情 | 公开 | 所有人 | 登录后可用账号评论；游客可匿名评论 |
-| `/widget/[organizationId]` | 嵌入式反馈 Widget | 公开 | 所有人 | 供产品内嵌使用 |
-| `/<organizationSlug>` | 公开反馈 Portal | 公开 | 所有人 | 入口默认展示反馈 |
-| `/invite/[token]` | 邀请接受 | 公开 | 所有人 | 未登录会提示登录 |
-
-| `/dashboard` | 仪表盘 | 登录 | 所有登录用户 | 由 Dashboard 布局保护 |
-| `/feedback` | 反馈管理列表 | 登录 | 所有登录用户 | 列表内可投票 |
-| `/feedback/new` | 代客户提交反馈 | 登录 | admin、product_manager、customer_support | 其他角色显示“权限不足” |
-| `/admin/feedback/[id]` | 后台反馈详情 | 登录 | 所有登录用户 | 编辑/删除/状态更新权限依角色而定 |
-
-| `/settings/notifications` | 通知设置 | 登录 | 所有登录用户 | - |
-| `/settings/organizations/new` | 创建组织 | 登录 | 所有登录用户 | 侧边栏入口仅管理员可见 |
-| `/settings/organizations/[orgId]/members` | 成员管理 | 登录 | 所有登录用户 | 仅管理员可调整角色/移除成员 |
-| `/settings/organization` | 组织管理 | 登录 | admin | 组织信息与成员管理 |
-| `/settings/portal-branding` | Portal Branding | 登录 | admin、product_manager | 主题、文案、语言 |
-| `/settings/portal-growth` | Portal Growth | 登录 | admin、product_manager | 分享与 SEO |
-| `/settings/portal-access` | Portal Access | 登录 | admin、product_manager | 可见性与权限 |
-| `/settings/portal-modules` | Portal Modules | 登录 | admin、product_manager | 模块开关 |
-| `/settings/portal-resources` | Portal Resources | 登录 | admin、product_manager | 入口与预览链接 |
-
-## 权限细节（页面内行为）
-
-| 功能 | 约束 | 说明 |
-|---|---|---|
-| 代客户提交 | `canSubmitOnBehalf` | 允许角色：admin、product_manager、customer_support |
-| 更新反馈状态 | `canUpdateFeedbackStatus` | 允许角色：admin、product_manager |
-| 删除反馈 | `canDeleteFeedback` | 允许角色：admin |
-| 组织角色管理/移除成员 | 管理员限定 | 在成员管理页内限制 |
-
-## 已知不一致/注意事项
-- 登录跳转存在 `/login` 与 `/sign-in` 混用（如 `app/(dashboard)/feedback/page.tsx`），可能导致重定向不一致。

package/docs/source-tree-analysis.md

@@ -1,150 +0,0 @@
-# Source Tree Analysis
-
-**Project:** Echo
-**Type:** Web Application (Next.js + React + TypeScript)
-**Generated:** 2025-12-31
-
-## Directory Structure
-
-```
-echo/                          # 项目根目录
-├── _bmad/                      # BMAD 模块配置（工作流系统）
-│   ├── core/                   # 核心工作流和任务
-│   └── bmm/                    # BMM 方法论工作流
-├── _bmad-output/               # BMAD 输出目录
-│   ├── planning-artifacts/     # 规划文档
-│   └── implementation-artifacts/ # 实施工件
-├── app/                        # Next.js App Router 目录 ⭐
-│   ├── layout.tsx              # 根布局组件
-│   ├── page.tsx                # 首页
-│   ├── globals.css             # 全局样式 + Tailwind 配置
-│   └── favicon.ico             # 网站图标
-├── components/                 # React 组件目录 ⭐
-│   ├── ui/                     # Shadcn/ui 基础组件（14个）
-│   │   ├── alert-dialog.tsx    # 警告对话框
-│   │   ├── badge.tsx           # 徽章
-│   │   ├── button.tsx          # 按钮
-│   │   ├── card.tsx            # 卡片
-│   │   ├── combobox.tsx        # 组合框
-│   │   ├── dropdown-menu.tsx   # 下拉菜单
-│   │   ├── field.tsx           # 表单字段
-│   │   ├── input-group.tsx     # 输入组
-│   │   ├── input.tsx           # 输入框
-│   │   ├── label.tsx           # 标签
-│   │   ├── select.tsx          # 选择器
-│   │   ├── separator.tsx       # 分隔符
-│   │   └── textarea.tsx        # 文本域
-│   ├── component-example.tsx   # 示例组件
-│   └── example.tsx             # 示例
-├── lib/                        # 工具函数目录 ⭐
-│   └── utils.ts                # 通用工具（cn 函数等）
-├── public/                     # 静态资源目录
-├── docs/                       # 项目文档
-│   ├── project-scan-report.json # 项目扫描状态
-│   └── (生成文档将在此处创建)
-├── node_modules/               # 依赖包
-├── package.json                # 项目配置和依赖 ⭐
-├── tsconfig.json               # TypeScript 配置 ⭐
-├── next.config.ts              # Next.js 配置
-├── components.json             # Shadcn/ui 配置 ⭐
-├── postcss.config.mjs          # PostCSS 配置
-├── eslint.config.mjs           # ESLint 配置
-├── CLAUDE.md                   # Claude Code 项目指令
-└── README.md                   # 项目说明
-```
-
-## Critical Directories Explained
-
-### `/app` - Next.js App Router
-Next.js 13+ 的 App Router 目录，使用基于文件系统的路由。
-
-| 文件/目录 | 用途 |
-|-----------|------|
-| `layout.tsx` | 根布局，定义页面结构和共享 UI |
-| `page.tsx` | 主页（/ 路由）|
-| `globals.css` | 全局样式，包含 Tailwind 主题配置 |
-| `favicon.ico` | 网站图标 |
-
-**架构模式：** React Server Components (RSC) enabled
-
-### `/components` - React 组件
-可复用的 UI 组件目录。
-
-| 子目录 | 用途 |
-|--------|------|
-| `ui/` | Shadcn/ui 基础组件库 |
-| 根目录 | 自定义组件 |
-
-**组件库：**
-- **Shadcn/ui 3.6.2** (Radix UI primitives + Base UI)
-- **图标：** Lucide React 0.562.0
-- **样式变体：** radix-maia
-- **基础颜色：** neutral
-
-### `/lib` - 工具函数
-共享工具函数和帮助器。
-
-| 文件 | 用途 |
-|------|------|
-| `utils.ts` | `cn()` 函数 - 合并 Tailwind 类名（clsx + tailwind-merge）|
-
-## Entry Points
-
-| 类型 | 位置 | 描述 |
-|------|------|------|
-| **应用入口** | `app/layout.tsx` | 根布局组件 |
-| **首页** | `app/page.tsx` | 主页路由 |
-| **全局样式** | `app/globals.css` | Tailwind 主题配置 |
-
-## Key Configuration Files
-
-| 文件 | 用途 |
-|------|------|
-| `package.json` | 项目元数据和依赖 |
-| `tsconfig.json` | TypeScript 编译配置 |
-| `components.json` | Shadcn/ui 组件配置 |
-| `next.config.ts` | Next.js 框架配置 |
-
-## Import Aliases
-
-配置在 `tsconfig.json` 和 `components.json` 中：
-
-```typescript
-@/components  → components/
-@/lib         → lib/
-@/components/ui → components/ui
-@/hooks       → hooks/ (尚未创建)
-```
-
-## Architecture Notes
-
-1. **路由系统：** Next.js App Router (文件系统路由)
-2. **渲染模式：** React Server Components + Client Components
-3. **样式方案：** Tailwind CSS v4 (inline config with @theme)
-4. **组件系统：** Shadcn/ui (Radix UI primitives)
-5. **类型系统：** TypeScript 5.x (strict mode enabled)
-6. **色彩空间：** OKLCH (perceptually uniform colors)
-7. **暗黑模式：** 自定义实现 (`.dark` class selector)
-
-## Development Patterns
-
-### 未实现的功能区域
-
-以下功能区域在当前项目中尚未实现：
-
-- ❌ API 路由（无 `/app/api` 目录）
-- ❌ 数据模型/数据库
-- ❌ 状态管理（无 Redux/Zustand/Context store）
-- ❌ 认证/授权系统
-- ❌ 测试套件
-- ❌ CI/CD 配置
-- ❌ Docker/容器化
-- ❌ 中间件
-
-### 当前实现
-
-- ✅ 基础 Next.js 项目结构
-- ✅ Shadcn/ui 组件库（14 个基础组件）
-- ✅ Tailwind CSS 主题配置
-- ✅ TypeScript 类型检查
-- ✅ ESLint 代码规范

package/docs/testing/delete-project-manual-tests.md

@@ -1,18 +0,0 @@
-# Delete Project Feature - Manual Test Results
-
-Date: 2026-01-09
-
-## Test Cases
-
-- [ ] Dialog opens when delete button clicked
-- [ ] Warning icon and message displayed
-- [ ] Input validation works (exact match required)
-- [ ] Cancel button closes dialog and resets state
-- [ ] Successful delete redirects to project list
-- [ ] Error messages displayed on failure
-- [ ] Loading state shown during delete
-- [ ] Backend permission check works
-
-## Notes
-
-[Add any observations or issues found]