# easyEat

**Repository Path**: cold-abyss_admin/easy-eat

## Basic Information

- **Project Name**: easyEat
- **Description**: easyEat 是一个面向减脂场景的微信小程序前端模版，提供「计划生成 → 每日执行 → 食材推荐 → 进度追踪」的闭环体验。
项目以“低学习成本、可解释、可持续执行”为核心设计原则。 
可以快速根据mock格式接入后端 使用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# easyEat

[![WeChat Mini Program](https://img.shields.io/badge/platform-WeChat%20Mini%20Program-07C160)](#)
[![Language](https://img.shields.io/badge/language-JavaScript-F7DF1E)](#)
[![Style](https://img.shields.io/badge/style-Miniprogram%20Native-2C2C2C)](#)

`easyEat` 是一个面向减脂场景的微信小程序，提供「计划生成 → 每日执行 → 食材推荐 → 进度追踪」的闭环体验。  
项目以“低学习成本、可解释、可持续执行”为核心设计原则。

## 功能特性

- 计划生成：基于基础资料与训练负荷，生成每日热量和三大营养素目标。
- 模板策略：`532` 与 `碳循环` 共用统一计算入口，仅通过宏量配比差异化。
- 每日执行：按早餐/午餐/晚餐输出食材建议与份量。
- 推荐联动：推荐页与当前计划联动，支持按目标类别排序。
- 统计追踪：记录体重与目标热量变化，形成可回溯历史。
- 本地优先：轻量本地持久化，离线可用，降低端侧存储压力。

## 技术栈

- 微信原生小程序（`WXML` / `WXSS` / `JavaScript`）
- 纯前端本地数据层（当前阶段）
- 组件化页面结构 + 配置驱动策略

## 项目结构

```text
easyEat/
├─ app.js
├─ app.json
├─ pages/                  # 页面层（首页、推荐、统计、计划、我的）
├─ components/             # 可复用组件
├─ utils/                  # 业务计算、格式化、存储、主题等通用能力
├─ configs/                # 计划模板、主题、食材库、提示库等配置
├─ mocks/                  # 本地 mock 数据（开源发布默认排除）
├─ docs/                   # 开发与架构文档
├─ scripts/                # 工程脚本（如 UTF-8/BOM 检查）
└─ spec.md                 # 产品与实现规范
```

## 快速开始

### 环境要求

- 微信开发者工具（建议使用稳定版）
- Node.js 18+（仅用于本地脚本检查，可选）

### 本地运行

1. 克隆仓库：

```bash
git clone <your-repo-url>
cd easyEat
```

2. 使用微信开发者工具打开项目根目录。
3. 选择「预览 / 真机调试」进行联调验证。

## 质量与工程约束

- 编码统一：UTF-8（无 BOM）。
- 发布前建议执行：

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\ensure-utf8-no-bom.ps1
```

- 若发现 BOM，可自动修复：

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\ensure-utf8-no-bom.ps1 -Fix
```

## 安全与开源发布策略

为避免敏感信息泄露，仓库对以下内容执行“提交忽略 / 发布排除”双层策略：

- 敏感与私有配置：如 `project.private.config.json`、`.env*`
- 提示词与内部资产：如 `提示词.txt`、`0.0.2bata提示词.md`
- Mock 数据：`mocks/` 与 `docs/backend/mock-api-data.json`

具体规则见：

- [`.gitignore`](./.gitignore)（本地与后续提交拦截）
- [`.gitattributes`](./.gitattributes)（`git archive` 发布包排除）

> 说明：若某些敏感文件已存在于历史提交，需要额外执行历史清理流程（如重写历史）才能彻底移除。

## 路线图（Roadmap）

- 接入真实后端接口（鉴权、计划同步、统计上报）
- 引入自动化测试（计算逻辑与页面关键路径）
- 增加多策略计划引擎与可配置化营养模型
- 完善 CI/CD 与发布流程

## 贡献指南

欢迎通过 Issue / PR 参与项目共建：

1. 提交前请确保不包含敏感信息与本地私有配置。
2. 保持代码结构清晰，避免无引用文件与重复封装。
3. 大变更请同步更新 `docs/` 与 `spec.md`。

## 许可证

建议使用 MIT License（若需要，我可以直接为你补充 `LICENSE` 文件）。