# react-app **Repository Path**: monsterchina/react-app ## Basic Information - **Project Name**: react-app - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-04-10 - **Last Updated**: 2026-04-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # React 电商应用基于 React 19 + Vite 8 + TypeScript 的现代化电商应用 demo，项目使用 Harness 进行多会话开发管理。 ## 技术栈 | 类别 | 技术 | |------|------| | 前端框架 | React 19 | | 构建工具 | Vite 8 | | UI 组件库 | Ant Design v6 | | 路由 | React Router v7 | | 状态管理 | Zustand | | 样式方案 | Tailwind CSS v4 + CSS Custom Properties | | 语言 | TypeScript | | 包管理器 | pnpm | ## 功能模块项目基于 Harness 管理，已完成 **26 个功能模块**： | 编号 | 功能 | 编号 | 功能 | |------|------|------|------| | F001 | 前端工程化基础架构 | F014 | 消息通知中心 | | F002 | 页面路由与布局系统 | F015 | 会员等级与权益 | | F003 | 商品展示模块 | F016 | UI主题与设计系统 | | F004 | 购物车与结算模块 | F017 | 浏览历史 | | F005 | 用户认证模块 | F018 | 申请退款售后 | | F006 | 购物车功能 | F019 | 物流追踪 | | F007 | 结算流程 | F020 | 智能搜索 | | F008 | 用户中心 | F021 | 商品推荐系统 | | F009 | 代码优化 | F022 | 拼团团购 | | F010 | 优惠券系统 | F023 | 积分商城 | | F011 | 商品评价与晒图 | F024 | 发票申请 | | F012 | 收藏心愿单 | F025 | 社交分享 | | F013 | 限时秒杀折扣 | F026 | 后台管理系统 | ## 快速开始 ```bash # 安装依赖 pnpm install # 启动开发服务器（带 HMR） pnpm dev # 生产构建 pnpm build # 预览生产构建 pnpm preview # 代码检查 pnpm lint # 代码格式化 pnpm format ``` ## 项目结构 ``` src/ ├── main.tsx # 入口文件 ├── App.tsx # 根组件 ├── router/ # 路由配置 ├── layouts/ # 布局组件 ├── pages/ # 页面组件 ├── components/ # 公共组件 ├── hooks/ # 自定义 Hooks ├── store/ # Zustand 状态管理 ├── services/ # API 服务 └── utils/ # 工具函数 ``` ## Harness 本项目使用 **Long-Running Agent Harness v3.5.0** 进行多会话开发管理。 ### 核心文件 | 文件 | 用途 | |------|------| | `.harness/harness.json` | Harness 配置信息 | | `.harness/features.json` | 功能模块跟踪 | | `.harness/context_summary.md` | 会话上下文与决策记录 | | `.harness/claude-progress.txt` | 进度交接文件 | | `.harness/init.sh` | 项目初始化脚本 | | `.claude/hooks/` | 质量门禁钩子 | ### 自动化流程 - **会话开始**: `auto-pull.sh` 自动拉取最新代码 - **任务完成**: `post-task-complete.sh` 执行自动化流程 ``` Test → Review → Commit → Push → Retro ``` ### 查看 Harness 状态 ```bash # 查看所有功能 cat .harness/features.json # 查看当前上下文 cat .harness/context_summary.md # 查看进度交接 cat .harness/claude-progress.txt ``` ## 代码规范采用 **Conventional Commits** 格式： ``` (): Refs: # ``` - **Type**: feat, fix, refactor, style, docs, test, chore, perf, ci - **Scope**: web, harness, config, deps, router, layout, store, components, pages - **示例**: `feat(pages): 完成商品列表页面` ## Git 配置 - **用户名**: monsterchina - **邮箱**: yongchaoshang@outlook.com - **远程仓库**: https://gitee.com/monsterchina/react-app.git ## 相关文档 - [CLAUDE.md](./CLAUDE.md) - Claude Code 使用指南 - [METHODOLOGY.md](./METHODOLOGY.md) - 开发方法论 - [AGENTS.md](./AGENTS.md) - Agent 工具配置 ## 许可证 MIT