EasyCard/README.md

EasyCard

多租户电子名片系统

简介

EasyCard 是一套面向事务所/组织的电子名片系统，包含后台管理端、后端服务与微信小程序三部分。

• 后端统一提供租户、组织、用户、名片、文件、统计等能力
• 管理端用于平台管理、租户管理与日常运营
• 小程序面向访客展示机构与个人电子名片

项目结构

easycard/
├─ backend/                # Spring Boot 后端
├─ frontend_admin/         # Vue 3 管理端
├─ frontend_miniprogram/   # 微信小程序
├─ deploy/                 # 部署与环境配置
└─ docs/                   # 技术、数据库与环境文档

技术栈

• 后端：Java 21、Spring Boot 3、MyBatis-Plus、MySQL、Redis、MinIO、Flyway
• 管理端：Vue 3、TypeScript、Vite、Pinia、Element Plus
• 小程序：原生微信小程序、TypeScript、Less

快速开始

1. 启动依赖服务

优先参考部署目录中的容器配置与脚本：

• deploy/docker-compose.yml
• deploy/application.yml

2. 启动后端

cd backend
mvn -pl easycard-boot spring-boot:run

3. 启动管理端

cd frontend_admin
npm install
npm run dev

4. 启动小程序

使用微信开发者工具打开 frontend_miniprogram/ 目录进行预览与调试。

文档

• 技术方案：docs/技术文档.md
• 数据库设计：docs/数据库设计文档.md
• 本地中间件环境：docs/本地中间件环境说明.md

说明

• 管理端与小程序共用同一套后端服务
• 当前仓库适合本地开发、联调和私有化部署扩展