# cmm

**Repository Path**: yangxiaowen_admin/cmm

## Basic Information

- **Project Name**: cmm
- **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-09-09
- **Last Updated**: 2026-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cmm

蝉妈妈网站前端复刻与业务数据采集项目。前端基于 Next.js、React 和 TypeScript。

## 启动

```bash
npm install
npm run dev
```

访问 http://127.0.0.1:3000/ 。页面、登录及已实现范围见 [页面说明](docs/frontend-replica/ALL-PAGES.md)。

本地登录和采集配置统一放在 `config/site.json`，现有配置已随目录整理迁移。新环境可复制空模板后填写：

```bash
cp config/site.example.json config/site.json
```

该文件仅供服务端及采集脚本读取，已加入忽略规则。

## 目录

```text
cmm/
├── src/                       前端源码
│   ├── app/                   页面路由、全局样式和 API
│   ├── components/            页面组件
│   ├── data/                  前端使用的页面数据
│   ├── lib/                   登录与页面目录等公共逻辑
│   └── types/                 TypeScript 类型
├── public/                    可公开访问的图片、字体和样式
├── config/                    本地配置与空模板
├── data/                      采集数据
│   ├── raw/                   达人、商品、视频、小店、品牌等原始数据
│   ├── snapshots/             详情集合、完整导出
│   └── checkpoints/           采集断点及未完成的导出
├── scripts/                   工具脚本
│   ├── data/                  接口采集、下载与数据盘点
│   ├── site-capture/          原站页面采集
│   ├── assets/                素材下载与组件生成
│   └── verification/          页面验证、视觉对比与覆盖率审计
├── docs/                      分析、方案、研究与验收文档
├── logs/                      运行日志
├── .cache/                    本地 Python 与 TypeScript 缓存
├── .local-data/               本地账号运行数据
├── .next/                     Next.js 构建产物
└── node_modules/              Node.js 依赖
```

框架入口和必要配置保留在根目录：`package.json`、`package-lock.json`、`next.config.ts`、`tsconfig.json` 和 `next-env.d.ts`。

## 常用命令

```bash
npm run typecheck
npm run build
npm run test:ui
npm run test:site
python3 scripts/data/profile_recommendation_data.py
```

页面检查需要先启动本地服务。最后一条命令只扫描本地数据，报告写入 `docs/data-analysis/recommendation-data-inventory.json`。

## 资料入口

- [文档索引](docs/README.md)
- [脚本分类与运行方法](scripts/README.md)
- [数据目录说明](data/README.md)
- [目录迁移清单](docs/maintenance/directory-reorganization.json)

目录整理保留原数据、日志与断点；原始 Gitee README 模板已移入 `docs/archive/`。