# natole

**Repository Path**: liqinyi/natole

## Basic Information

- **Project Name**: natole
- **Description**: 用ai写出来的商城项目
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-05
- **Last Updated**: 2025-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nalote - 企业税务服务系统

本项目是一个基于 Vue 3 + Koa 2 的全栈企业税务服务系统，包含用户前台、运营管理后台以及统一的后端服务。

## 📂 项目结构

本项目采用 Monorepo 结构，主要包含以下三个部分：

*   **`frontend/`**: 用户前台系统
    *   面向普通用户，提供服务浏览、企业认证、服务下单、支付、订单查询等功能。
    *   **技术栈**: Vue 3, Vite, Element Plus, Pinia, TypeScript, Tailwind CSS。
*   **`adminSystem/`**: 运营管理后台
    *   面向运营与财务人员，提供订单管理、服务商品管理、企业审核、优惠券管理、系统配置等功能。
    *   **技术栈**: Vue 3, Vite, Element Plus, Pinia, TypeScript, ECharts。
*   **`backend/`**: 统一后端服务
    *   为前台和后台提供 RESTful API 接口。
    *   **技术栈**: Node.js (Koa 2), MySQL 8.0/5.7, JWT 认证。

## 🛠️ 技术选型与环境要求

### 环境依赖

*   **Node.js**: `^16.0.0` 或更高版本 (推荐 18+)
*   **MySQL**: `5.7` 或 `8.0` (推荐 8.0，已兼容 5.7)
*   **包管理器**: `npm` 或 `yarn`

### 核心框架

*   **前端框架**: Vue 3 (Composition API)
*   **构建工具**: Vite 4
*   **UI 组件库**: Element Plus
*   **状态管理**: Pinia
*   **CSS 框架**: Tailwind CSS (前台)
*   **后端框架**: Koa 2
*   **数据库驱动**: mysql2 (支持 Promise)

## 🚀 快速开始

### 1. 数据库准备

1.  创建数据库 `enterprise_tax_service` (字符集推荐 `utf8mb4`)。
2.  进入 `backend/` 目录。
3.  复制 `.env.example` 为 `.env`，并配置数据库连接信息：
    ```properties
    DB_HOST=localhost
    DB_PORT=3306
    DB_USER=root
    DB_PASSWORD=your_password
    DB_NAME=enterprise_tax_service
    ```
4.  运行初始化脚本以创建表结构和默认数据：
    ```bash
    npm install
    node scripts/init-db.js
    ```

### 2. 启动后端服务

```bash
cd backend
npm install
npm run dev
```
后端服务默认运行在 `http://localhost:3001`。

### 3. 启动管理后台

```bash
cd adminSystem
npm install
npm run dev
```
管理后台默认运行在 `http://localhost:3002` (或自动分配的闲置端口)。
*   **默认管理员账号**: `admin`
*   **默认密码**: `admin123456`

### 4. 启动用户前台

```bash
cd frontend
npm install
npm run dev
```
用户前台默认运行在 `http://localhost:3000`。

## 📝 主要功能模块

### 用户端 (Frontend)
*   **微信登录**: 支持微信扫码/授权登录。
*   **服务大厅**: 展示各类税务服务商品。
*   **企业认证**: 对接天眼查接口（需配置），查询并认证企业信息。
*   **订单中心**: 下单、支付（微信支付对接）、退款申请、订单进度追踪。

### 管理端 (AdminSystem)
*   **仪表盘**: 实时查看今日订单、收入统计及趋势图。
*   **订单管理**: 订单筛选、详情查看、状态流转、退款审批。
*   **商品管理**: 服务的增删改查、上下架、价格与库存管理。
*   **系统设置**: 微信支付参数配置、第三方 API (天眼查) 配置。

## 🤝 贡献

欢迎提交 Issue 或 Pull Request！

## 📄 License

MIT