# CCspace

**Repository Path**: lazza/ccspace

## Basic Information

- **Project Name**: CCspace
- **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-03
- **Last Updated**: 2026-09-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CCspace

这是一个前后端分离的乡村小店系统：用户可以在微信小程序下单，给家人购买日用品；小店管理员可以在 Web 管理端维护商品、处理订单、登记代收快递并安排配送。

## 技术栈

- 后端：Python + FastAPI + SQLAlchemy + MySQL
- 管理端：Vue 3 + Vite + TDesign Vue Next
- 小程序端：微信原生小程序 + TDesign Miniprogram
- 数据库：MySQL，连接 `127.0.0.1:9274` 的 `ccspace` 数据库（见 `server/app/core/config.py`）

## 目录结构

```text
.
├── server/       # Python FastAPI 后端
├── admin-web/    # TDesign Vue 管理端
├── miniprogram/  # TDesign 微信小程序
└── docs/         # API 和迭代说明
```

## 后端启动

后端配置在 `server/.env`，包含 MySQL 地址、端口、账号、数据库名和管理端默认账号。

```powershell
cd e:\CODE\Project\ccspace\server
.\.venv\Scripts\python.exe run.py
```

后端默认监听：

```text
http://localhost:3784
```

健康检查：

```text
http://localhost:3784/health
```

FastAPI 文档：

```text
http://localhost:3784/docs
```

## 管理端启动

```powershell
cd e:\CODE\Project\ccspace\admin-web
npm run dev
```

默认 API 地址是：

```text
http://127.0.0.1:3784
```

如果本地开发要连本机后端，可以在管理端登录页修改 API 地址，或新建 `admin-web/.env`：

```text
VITE_API_BASE=http://localhost:3784
```

默认管理账号从后端 `server/.env` 读取。首次启动会自动建表并初始化管理员和示例商品。

## 小程序启动

```powershell
cd e:\CODE\Project\ccspace\miniprogram
npm install
```

然后打开微信开发者工具，导入 `miniprogram` 目录，并执行“工具 / 构建 npm”。

小程序 API 地址在：

```text
miniprogram/utils/api.js
```

当前默认是 `http://192.168.123.129:3784`（见 `miniprogram/utils/api.js`，按本机局域网 IP 调整）。

正式上线微信小程序时，后端必须部署 HTTPS 域名，并在微信公众平台配置 request 合法域名；仅 IP + HTTP 适合开发联调。

## 当前功能

已完成功能清单见 `docs/计划.md`（含后端 API、数据模型、管理端与小程序各页面）。核心能力：
- 管理端登录鉴权 + 商品 / 订单 / 快递 / 促销管理
- 小程序商品浏览、购物车、下单（含库存事务与取消回补）
- 配送排单、消费月报、复购提醒
- MySQL 自动建表与初始数据