# crm_python

**Repository Path**: firstsoftsh_az0990/crm_python

## Basic Information

- **Project Name**: crm_python
- **Description**: 使用python做底层构建的一个简单的crm系统
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude CRM（极简版）

> 一套基于 **FastAPI + SQLAlchemy + MySQL 8 + Vue 3 + Element Plus** 的轻量级 CRM。
> 聚焦"线索 → 客户 → 商机 → 项目"的核心信息流转。

📘 **主方案：[CRM_PLAN.md](./CRM_PLAN.md)**
📚 详细文档：[docs/](./docs/)

## ✨ 核心模块
用户（manager_id + 固定角色）· 线索 · 客户 · 商机 · 项目

## 🧱 技术栈
- **后端**：FastAPI + SQLAlchemy 2.0 + Pydantic v2 + PyJWT + Uvicorn
- **数据库**：MySQL 8.0（**唯一**数据节点，**不引入 Redis**）
- **前端**：Vue 3 + Vite + TypeScript + Element Plus + Pinia + Axios
- **部署**：Nginx 反向代理 + 多 Uvicorn 进程 + MySQL 8

## 📂 目录结构
```
claude_crm/
├── CRM_PLAN.md           主方案（极简架构）
├── README.md
├── backend/              FastAPI 后端
├── frontend/             Vue 3 前端
├── docker/               Docker 编排
└── docs/                 详细文档
```

## 🚀 快速开始
```bash
# 1. 后端（MySQL 已在远程 192.168.63.33:3380）
cd backend
poetry install
cp .env.example .env
poetry run alembic upgrade head
poetry run python -m app.db.init_db    # 创建 admin/admin123
poetry run uvicorn app.main:app --reload --port 8001
# 一键：./scripts/start_dev.sh  或  scripts\start_dev.bat

# 2. 前端
cd ../frontend
pnpm install
pnpm dev --port 5174  # 端口被占时也可 pnpm dev --port 5180
```

## 📜 文档索引
| 文档 | 说明 |
| --- | --- |
| [CRM_PLAN.md](./CRM_PLAN.md) | 极简架构主方案 |
| [docs/01-architecture.md](./docs/01-architecture.md) | 架构与请求时序 |
| [docs/02-module-design.md](./docs/02-module-design.md) | 5 个模块详细设计 |
| [docs/03-database-design.md](./docs/03-database-design.md) | 数据库表结构 |
| [docs/04-api-spec.md](./docs/04-api-spec.md) | REST API 规范 |
| [docs/05-development-guide.md](./docs/05-development-guide.md) | 开发与命名规范 |
| [docs/06-deployment.md](./docs/06-deployment.md) | 部署架构 |