@nexttylabs/echo 0.2.0

package/docs/product_changes.md

@@ -0,0 +1,37 @@
+# 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

@@ -0,0 +1,159 @@
+# 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

@@ -0,0 +1,104 @@
+{
+  "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

@@ -0,0 +1,51 @@
+# 路由与用户角色可见性对照表
+
+> 生成日期：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

@@ -0,0 +1,150 @@
+# 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

@@ -0,0 +1,18 @@
+# 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]