ai-spec-dev 0.42.0 → 0.46.0

package/demo-frontend/.ai-spec-constitution.md

@@ -1,95 +0,0 @@
-# Project Constitution
-
-## 1. 架构规则 (Architecture Rules)
-- **组件分层架构**：页面/组件 → 自定义hooks → 服务层 → API客户端
-- **组件组织**：页面组件位于 `src/pages/`，可复用组件位于 `src/components/`
-- **业务逻辑分离**：所有API调用、数据转换和业务逻辑必须封装在自定义hooks或服务层中
-- **状态管理**：使用React Context或本地状态，禁止直接修改props
-- **类型安全**：所有组件props、API响应和状态必须明确定义TypeScript类型
-
-## 2. 命名规范 (Naming Conventions)
-- **文件命名**：
-  - 组件文件：PascalCase (`UserProfile.tsx`)
-  - Hook文件：camelCase，以`use`开头 (`useAuth.ts`)
-  - 工具/服务文件：camelCase (`apiService.ts`)
-  - 样式文件：与组件同名，使用CSS模块 (`UserProfile.module.css`)
-- **变量/函数**：
-  - 变量/函数：camelCase (`userData`, `fetchUserProfile`)
-  - 接口/类型：PascalCase (`UserData`, `ApiResponse`)
-  - 常量：UPPER_SNAKE_CASE (`API_BASE_URL`)
-- **组件命名**：PascalCase (`<UserProfile />`)
-- **路由路径**：kebab-case (`/user-profile`, `/admin/dashboard`)
-
-## 3. API 规范 (API Patterns)
-- **API客户端**：使用统一的axios实例配置，位于 `src/services/apiClient.ts`
-- **请求模式**：所有API调用必须封装在自定义hooks (`useApi`, `useFetch`) 或服务函数中
-- **响应结构**：
-  ```typescript
-  interface ApiResponse<T> {
-    success: boolean;
-    data: T;
-    message?: string;
-    error?: string;
-    code?: number;
-  }
-  ```
-- **错误处理**：统一使用try-catch包装，错误通过状态返回而非抛出异常
-- **认证**：Token存储在localStorage，通过axios拦截器自动添加Authorization头
-- **路由组织**：
-  - 公开路由：无需认证 (`/login`, `/register`)
-  - 受保护路由：需要认证 (`/dashboard`, `/profile`)
-  - 管理员路由：需要特定角色 (`/admin/*`)
-
-## 4. 数据层规范 (Data Layer Rules)
-- **状态管理**：
-  - 全局状态：React Context + useReducer
-  - 本地组件状态：useState
-  - 服务端状态：React Query或自定义缓存hooks
-- **数据获取**：所有数据必须通过服务层获取，禁止组件直接调用fetch/axios
-- **类型定义**：所有API请求/响应必须定义在 `src/types/` 目录下
-- **数据转换**：在服务层进行API响应到前端模型的转换
-
-## 5. 错误处理规范 (Error Handling Patterns)
-- **全局错误边界**：App组件包裹ErrorBoundary
-- **API错误**：统一在服务层处理，返回标准化错误对象
-- **用户反馈**：通过Toast/Snackbar组件显示错误消息
-- **错误日志**：使用console.error记录，生产环境集成错误监控
-- **表单验证**：使用Formik或React Hook Form进行客户端验证
-
-## 6. 禁区 (Red Lines — Never Violate)
-- [ ] **禁止**在组件中直接进行API调用（必须通过hooks/服务层）
-- [ ] **禁止**使用`any`类型（必须明确定义或使用`unknown`）
-- [ ] **禁止**修改传入的props（遵循单向数据流）
-- [ ] **禁止**在组件中编写复杂业务逻辑（必须提取到hooks/服务层）
-- [ ] **禁止**使用内联样式（必须使用CSS模块或styled-components）
-- [ ] **禁止**提交未定义类型的代码
-- [ ] **禁止**直接访问process.env（必须通过配置模块）
-
-## 7. 测试规范 (Testing Rules)
-- **测试框架**：Vitest + React Testing Library
-- **测试文件位置**：与源文件同目录，使用`.test.tsx`或`.spec.tsx`后缀
-- **必须测试**：
-  - 所有自定义hooks
-  - 复杂业务逻辑函数
-  - 关键用户交互流程
-  - 组件渲染和状态变化
-- **测试结构**：Arrange-Act-Assert模式
-- **Mock策略**：API调用必须mock，使用MSW或手动mock
-- **覆盖率要求**：核心业务逻辑必须>80%
-
-## 8. 共享配置文件清单 (Shared Config Files — Append-Only)
-
-CRITICAL: The following files are **singleton config files** that already exist in the project.
-When any feature needs to add entries (translations, constants, routes, enums, etc.), they MUST be
-appended/merged into these existing files. **NEVER create a new parallel file.**
-
-- `src/constants/apiEndpoints.ts` — API端点配置 — **MODIFY ONLY, never recreate**
-- `src/types/api.d.ts` — API类型定义 — **MODIFY ONLY, never recreate**
-- `src/config/env.ts` — 环境变量配置 — **MODIFY ONLY, never recreate**
-- `src/utils/errorCodes.ts` — 错误码常量 — **MODIFY ONLY, never recreate**
-- `src/services/apiClient.ts` — Axios实例配置 — **MODIFY ONLY, never recreate**
-- `src/routes/index.tsx` — 路由配置 — **MODIFY ONLY, never recreate**
-- `src/hooks/index.ts` — 自定义hooks导出 — **MODIFY ONLY, never recreate**
-- `src/context/index.ts` — Context导出 — **MODIFY ONLY, never recreate**
-
-(No i18n/locale files detected — will be populated on first run)

package/demo-frontend/package.json

@@ -1,23 +0,0 @@
-{
-  "name": "demo-frontend",
-  "version": "0.1.0",
-  "private": true,
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc && vite build",
-    "test": "vitest run"
-  },
-  "dependencies": {
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "axios": "^1.7.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.7.0",
-    "@types/react": "^18.3.0",
-    "@types/react-dom": "^18.3.0",
-    "vite": "^5.4.0",
-    "@vitejs/plugin-react": "^4.3.0",
-    "vitest": "^2.1.0"
-  }
-}

package/demo-frontend/src/App.tsx

@@ -1,12 +0,0 @@
-import React from "react";
-
-function App() {
-  return (
-    <div>
-      <h1>Bookmark Manager</h1>
-      <p>Coming soon...</p>
-    </div>
-  );
-}
-
-export default App;

package/demo-frontend/src/main.tsx

@@ -1,9 +0,0 @@
-import React from "react";
-import ReactDOM from "react-dom/client";
-import App from "./App";
-
-ReactDOM.createRoot(document.getElementById("root")!).render(
-  <React.StrictMode>
-    <App />
-  </React.StrictMode>
-);

package/demo-frontend/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "jsx": "react-jsx",
-    "strict": true,
-    "esModuleInterop": true,
-    "outDir": "dist",
-    "rootDir": "src"
-  },
-  "include": ["src"]
-}