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

embedded/2024/10/11 13:27:13/

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.Driverurl: jdbc:mysql://127.0.0.1:xxxusername: rootpassword: root```3. 启动eureka注册中心4. 启动gateway网关模块5. 启动oauth2权限模块6. 启动system后端项目

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


http://www.ppmy.cn/embedded/9639.html

相关文章

java | junit | 基本+技巧

1.参考链接 1.1 单测概念 https://medium.com/lathasreeseeni/junit-2d9857773e8 1.2 高级技巧 https://symflower.com/en/company/blog/2023/how-to-write-junit-test-cases-advanced-techniques/ assertThrows: 有时候,我们的方法,需要抛出…

第八章_VLAN、Trunk和VLAN间路由

VLAN和 Trunk是企业局域网最基本和最核心的网络技术,在部著和实施局域网时应用广泛。VLAN技术可以很容易地控制广播域的大小。有了VLAN,交换机之间的级联链路就需要Trunk技术来保证该链路可以同时传输多个VLAN的数据。管理员可以手动配置交换机之间链路上…

[MySQL数据库] 索引与事务

1. 索引 1.1 概念 索引是一种特殊的文件,包含着对数据表里所有记录的引用指针.可以对表中的一列或多列创建索引,并指定索引的类型,各类索引有各自的数据结构实现. 1.2 作用 数据库中的表、数据、索引之间的关系,类似于书架上的图书、书籍…

nginx使用http2,并配置ssl证书

** nginx使用http2,并配置ssl证书 ** 想要使用http2,需要在安装nginx时安装http2模块和ssl模块 前置条件nginx版本需要在1.9.5以上 #解压nginx包 tar -zxvf nginx-1.18.0.tar.gz #进入nginx目录 cd nginx-1.18.0 #执行 ./configure --prefix/usr/lo…

SpringCloud系列(9)--将服务消费者Consumer注册进Eureka Server

前言:上一章节我们介绍了如何将服务提供者注册进Eureka服务里,本章节则介绍如何将服务消费者Consumer注册进Eureka服务里 Eureka架构原理图 1、修改consumer-order80子模块的pom.xml文件,引入Eureka Clinet的依赖,然后reolad一下&…

智慧公厕解决方案易集成好使用的智能硬件

在现代城市建设中,智慧公厕的需求日益增长。为了提供更好的用户体验和更高效的管理,易集成、好使用的智能硬件成为智慧公厕解决方案的关键组成部分。 1. 蹲位有人无人感应器:是用于检测厕位有人无人的设备,根据现场不同的安装条件…

未来城市可视化,A3D引擎支持,免费搭建全新一代数字孪生!

AMRT3D数字孪生引擎https://www.amrt3d.com/#/ 什么是未来城市?它是新型数字化理念的载体,以数字孪生与物理世界城市的融合为核心,通过数字孪生技术在数字空间实时构建城市,采用数据整合和分析预测来实时模拟、预测、控制整体城市…

Qt-控件篇

QPushbutton 1、设置按钮文本 pushButton->setText("按钮"); 2、获取按钮文本 pushButton->text(); 3、设置按钮的大小为特定值(宽度和高度) pushButton->setFixedSize(width,height); 4、设置按钮悬停时的工具提示文本。 pushButto…