# local-live

**Repository Path**: haven5/local-live

## Basic Information

- **Project Name**: local-live
- **Description**: 本地生活小程序和网页端
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-10
- **Last Updated**: 2025-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# local-live 本地生活小程序和网页端

## 项目介绍
本项目是一个基于 Admin.NET 框架的本地生活服务平台，包含小程序和网页端应用。平台支持多种功能模块，包括但不限于轮播图管理、评论系统、收藏夹、反馈机制、房产信息、招聘信息、商品信息、租房信息、商家信息、新闻资讯和景点信息等。

该项目使用了现代化的前后端分离架构，后端采用 .NET 作为服务端语言，前端使用 uniapp 和 vue 框架进行开发，支持多端部署。

## 技术架构
- **后端框架**: Admin.NET（基于 .NET 6）
- **前端框架**: uniapp、vue
- **数据库**: 使用 SqlSugar ORM 进行数据操作，支持多种数据库类型
- **接口文档**: Swagger
- **身份认证**: JWT、OAuth、支付宝、微信等
- **消息队列**: Redis、RabbitMQ
- **日志系统**: 支持操作日志、异常日志、访问日志等
- **缓存**: Redis 缓存支持
- **部署**: 支持 Docker 部署

## 核心功能模块

### 1. 轮播图管理（Banner）
支持轮播图的增删改查，包含标题、描述、图片地址、跳转链接、排序、启用状态、生效时间等字段。

### 2. 评论系统（Comment）
支持对对象（如商品、文章等）进行评论，包含用户信息、评论内容、评分、是否启用等字段。

### 3. 收藏夹（Favorite）
用户可收藏商品、房源、商家等信息，支持收藏标题、封面图片、价格、链接路径等字段。

### 4. 用户反馈（Feedback）
用户可提交反馈信息，包含反馈类型、标题、内容、联系信息、处理状态、处理结果等字段。

### 5. 房产信息（House）
提供房产信息管理，包括房产名称、地址、面积、价格、户型、标签、坐标等。

### 6. 招聘信息（Zhaopin）
支持职位发布，包含职位名称、公司名称、工作地点、薪资范围、岗位职责、联系方式等。

### 7. 商品管理（Product）
管理商品信息，包括商品名称、编码、产地、价格、标签、描述、销量、评分等。

### 8. 租房信息（Rentout）
提供租房信息发布功能，包含房源标题、租金、押金规则、配套设施、坐标、联系人等字段。

### 9. 商家信息（Shop）
管理本地商家信息，包括商家名称、联系人、电话、地址、评分、营业时间、人均消费等。

### 10. 新闻资讯（News）
支持资讯内容发布，包含标题、副标题、内容、分类、封面图、来源、作者、发布时间等。

### 11. 景点信息（Scene）
管理本地景点信息，包括景点名称、地址、简介、分类、开放时间、门票价格、评分等。

### 12. 交通岗信息（Traffic）
提供交通岗信息管理，包含标题、查岗时间、地址、坐标、标签、状态等。

## 主要特性

- **多端支持**：支持小程序、网页端访问，适配移动端和桌面端。
- **模块化设计**：各功能模块独立，便于维护和扩展。
- **权限管理**：基于角色的权限控制（RBAC），支持菜单权限、数据权限等。
- **日志与监控**：完善的日志记录系统，支持操作日志、访问日志、异常日志等。
- **缓存机制**：支持 Redis 缓存，提升系统性能。
- **消息队列**：使用 Redis 和 RabbitMQ 实现事件驱动架构。
- **定时任务**：支持 Quartz.NET 定时任务调度。
- **代码生成器**：内置代码生成工具，可快速生成实体、服务、接口等代码。
- **国际化支持**：支持多语言配置，通过 `Readme_*.md` 实现。

## 使用说明

### 后端服务
后端服务基于 Admin.NET 框架，使用 .NET 6 编写，支持 RESTful API 接口。

#### 启动后端服务
1. 安装 .NET 6 SDK
2. 进入项目目录 `src/Admin.NET/Admin.NET.Application`
3. 执行命令：
   ```bash
   dotnet run
   ```

#### 接口文档
访问 `/swagger` 查看 API 接口文档。

### 前端页面
前端使用 uniapp 和 vue 框架开发，支持 H5、小程序等多端部署。

#### 启动前端
1. 安装 Node.js 和 npm
2. 进入前端项目目录
3. 安装依赖：
   ```bash
   npm install
   ```
4. 启动开发服务器：
   ```bash
   npm run serve
   ```

## 部署说明

### 后端部署
- **Docker 部署**：使用 `.dockerignore` 和 Dockerfile 构建镜像。
- **生产环境部署**：推荐使用 Linux + Nginx + Kestrel 部署方案。

### 前端部署
- **uniapp**：支持编译到微信小程序、H5、App 等平台。
- **vue**：使用 `npm run build` 构建静态资源，部署到 Nginx 或 CDN。

## 开发者指南

### 代码结构
- `Entity`：数据实体类，对应数据库表结构。
- `Request`：请求参数模型。
- `Service`：业务逻辑层，提供 API 接口。
- `Configuration`：系统配置文件，如数据库、缓存、日志等。
- `GlobalUsings.cs`：全局命名空间引用。
- `Startup.cs`：服务注册与中间件配置。

### 数据库配置
- 数据库配置文件位于 `src/Admin.NET/Admin.NET.Application/Configuration/Database.json`
- 支持多数据库类型，如 SQL Server、MySQL、PostgreSQL ://gitee.com/explore
4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)