项目中，如何写 readme.md 文件 | 写项目总结

tips：注意写

1. readme文件：①项目文档（项目需求和设计文档、项目系统架构和技术文档、接口文档）、②项目结构、③启动项目。具体结构见下文。

2. 项目总结：技术栈、描述、主要工作！！需求及功能模块

xxxx项目名

项目文档

        接口文档

        设计文档

项目结构        

启动项目

        前端

        后端

readme.md代码参考：

// 创建 .md文件
# xxx管理系统
 
## 项目文档
 
### 接口文档
 
ApiPost：https://xxx.apipost.cn/
 
### 设计文档
 
项目需求和设计文档.md
 
项目系统架构和技术文档.md
 
## 项目结构
 
```
doc 			项目文档
common 			公共模块
code-generate	代码生成器
eureka 			注册中心
gateway 		网关模块
oauth2 			权限模块
web 			前端项目
system 			后端项目
```
 
## 启动项目
 
### 前端
 
```shell
cd web
npm i 
npm run dev
```
 
### 后端
 
1. 新建数据库，导入`doc\sql\xx.sql`
 
2. 在`system\src\main\resources\application.yml`中配置数据源：
 
    ```
    spring:
      datasource:
        driver-class-name: com.mysql.cj.jdbc.Driver
        url: jdbc:mysql://127.0.0.1:xxx
        username: root
        password: root
    ```
    
3. 启动eureka注册中心
 
4. 启动gateway网关模块
 
5. 启动oauth2权限模块
 
6. 启动system后端项目

 .md文件可参考：如何写好README.md文件_使用markdown插件(pycharm)撰写readme.md文件 对代码的文件结构加以说明。建议-CSDN博客