- 为JD订单和Cookie管理添加新的状态值6(Cookie账号Ck失败) - 在订单历史和Cookie历史抽屉中展示备注信息 - 更新状态标签颜色和文本映射以支持新状态 - 调整订单详情中的状态显示逻辑和标签文案 - 修改订单列表中关联订单ID字段的显示逻辑 - 优化历史记录条目的布局对齐方式以适应备注内容 - 在筛选器中添加新的状态选项以支持过滤新状态
3.6 KiB
3.6 KiB
Project Context
Purpose
Kami Frontend is a comprehensive management platform for multi-service card and account operations. The system provides centralized management for Apple Card, JD accounts, Walmart accounts, and T-Mall game accounts, including order tracking, cookie management, and merchant operations.
Tech Stack
- Frontend Framework: Vue 3 with Composition API and
<script setup>syntax - UI Library: Arco Design Vue
- State Management: Pinia with modular stores
- Routing: Vue Router 4
- Data Fetching: TanStack Vue Query + Axios
- Build Tool: Vite with TypeScript
- Package Manager: pnpm (>=8.11.0)
- Code Quality: ESLint, Stylelint, Prettier with Husky pre-commit hooks
- API Generation: OpenAPI Generator with TypeScript Axios client
- Rich Text: Milkdown editor
- Code Editor: CodeMirror 6
- Charts: ECharts with Vue integration
Project Conventions
Code Style
- Vue Components: Use
<script setup>syntax with Composition API - TypeScript: Strict mode enabled, prefer explicit typing
- File Naming: kebab-case for directories, PascalCase for components
- CSS/Less: Use Less preprocessor with Arco Design theme variables
- Imports: Use path aliases (
@/forsrc/) - API Calls: Use generated clients or manual definitions from
src/api/
Architecture Patterns
- Dual API Approach: Generated OpenAPI clients + manual API definitions
- Component Structure: Feature-based organization under
src/views/ - Global Components: Auto-registered via
src/components/index.ts - State: Pinia stores for app state, TanStack Query for server state
- Authentication: JWT tokens with automatic refresh via axios interceptors
Testing Strategy
Currently no formal testing framework is configured. Testing focuses on manual QA and code review.
Git Workflow
- Branching:
developfor development,productionfor releases - Commits: Conventional commits with Commitlint
- Pre-commit: Husky + lint-staged for automated code quality checks
- PR Target: Production branch for release merges
Domain Context
Business Domains
- Apple Card Management: Card info, recharge history, order tracking
- JD Account Management: Cookie management, order processing, account tracking
- Walmart Account Management: Account groups, order management, statistics
- T-Mall Game Operations: Account info, shop management, order processing
- Merchant Operations: Configuration, steal card settings, deployment
Key Concepts
- Cookie Management: JD session cookies for automated operations
- Order Processing: Multi-platform order tracking and management
- Account Groups: Batch account operations and management
- Merchant Steal Settings: Configuration for automated account acquisition
Important Constraints
- Node.js: Requires ^18.0.0 || >=20.0.0
- Browser Support: Modern browsers with ES2020 support
- API Base URL: Configurable via environment variables
- Authentication: JWT-based with automatic token refresh
- OpenAPI: Client generation from backend spec at
http://127.0.0.1:12401/api.json
External Dependencies
- Backend API: Node.js backend at configurable base URL
- OpenAPI Generator: Client code generation from backend specification
- Arco Design: UI component library with theme customization
- Chart Libraries: ECharts for data visualization
- Code Editors: CodeMirror for code editing, Milkdown for rich text
Development Services
- Development API:
http://127.0.0.1:12401(local development) - Production API: Configured via
VITE_API_BASE_URLenvironment variable