Torna is an enterprise interface document solution that aims to make document management easier and faster. Torna uses a team approach to manage and maintain project API documentation, incorporating different forms of documentation to form a unified maintenance approach.

3e61bd9117f2424b85cccc0ff717c15fnoop.image_

Torna compensates for the shortcomings of traditional document generation tools such as swagger, enriching and enhancing some useful features while maintaining the original functionality:

Basics: Add, delete, modify, preview documents, import and export, document sorting, dictionary management
Enhancements: multi-environment debugging, Mock data, document aggregation, document sharing, rights management, global Settings, docker running, Chinese/English switching, User Center
Extensions: Smart-doc push, swagger plugin push, external document access, OpenAPI/SDK push
Login: third-party interface login, LDAP login, OAuth login, Nailing password free login

daac7fb487ad48de95b471309ede3f87noop.image_

Use steps:

Method 1: Download the zip file and run it locally

1. Prepare

Java environment. The minimum requirement is Java8
MySQL 5.6.5 and later. For versions earlier than 5.6.5, see: Support MySQL | Torna

2. Go to Links, download the latest version, and decompress zip

3. Import the database and run mysql.sql · tanghc/ torna-Gitee.com

4. Open the application.properties configuration file and modify the database connection configuration

5. Run sh startup.sh to start the startup. (Run startup.bat on Windows.)

6. Visit http://ip:7700 with your browser

7. There are no special instructions for subsequent upgrade. You only need to overwrite the torna.jar file and dist folder, and then restart

Method 2: docker run

1. Download the public image

docker pull tanghc2020/torna:latest

Import the database and run mysql.sql · tanghc/ torna-Gitee.com

3. The replication server/boot/SRC/main/resources/application. The properties files into the/opt/torna/config, change the database connection configuration

4. Perform docker run – name torna -p 7700:7700 – v/opt/torna/config: / torna/config – d < mirror ID >

5. Visit http://ip:7700 with your browser

Development and deployment:

1. Development environment

Before embarking on development, please install/learn the following environment in advance

Java8, Torna requires a minimum Java version of Java8
Maven3, package management and build tools, minimum version required maven3
nodejs12: Front-end development requires nodejs installation. The recommended version is NodeJS12
Mysql5.7(Recommended)

Engineering description

front: Front-end engineering
plugin: plugin
script: auxiliary script
sdk: indicates the SDK corresponding to OpenAPI
server: Server project
mysql: database script

2. Import the project

This project is developed using IDEA, and Eclipse can theoretically support it.

Because Torna is based on SpringBoot, it can be developed using the community version of IDEA.

The import procedure is as follows:

Run the mysql.sql script in MySQL5.6.5 and later versions. For versions earlier than 5.6.5, see: MySQL | Torna is supported
The IDE installs the lombok plugin, then opens the project (you can open the root pom.xml under IDEA, then open as project), the first import will download the dependency package, please be patient
Open the server/boot/SRC/main/resources/application properties, change the database configuration
Run server/boot/SRC/main/Java/cn/torna TornaApplication. Java

At this point, the server is started, and the following explains the front-end project

Running front end

cd front, jump the command prompt to the front directory

Run npm install

This step is to download the nodejs dependencies

run npm run dev and go to http://localhost:9530/

At this point, the front end starts up

The server address for the front-end request is configured in the.env.development file, which defaults to http://localhost:7700

The IDE opens the front-end project

Use WebStorm or VSCode to open the front folder, if you are a backend Java developer, WebStorm is recommended, the interface is a little familiar, and the family bucket shortcut is the same.

Interface preview:

Document management

f7b534643f0346b6ba8f9c61f50c27dcnoop.image_

document editing

df7e528189fa4bb590b3bf93e3f1ef16noop.image_

Document preview

8449384a7b734a5caea362c9f21608f3noop.image_

interface debugging

eadb21dbb124404a8ccd417dbd3bfba5noop.image_

upload files

0ff61c0f311742deaf61e93a8cd9099cnoop.image_

You can read more on your own.

Open source address: Click download

If you need project recommendations and resources, please send private letters to the author

资源下载此资源为免费资源立即下载

Telegram:@John_Software

collect(0) Like (0)

Disclaimer: This article is published by a third party and represents the views of the author only and has nothing to do with this website. This site does not make any guarantee or commitment to the authenticity, completeness and timeliness of this article and all or part of its content, please readers for reference only, and please verify the relevant content. The publication or republication of articles by this website for the purpose of conveying more information does not mean that it endorses its views or confirms its description, nor does it mean that this website is responsible for its authenticity.

Ictcoder Free source code Enterprise-class open source interface documentation solution – torna https://ictcoder.com/kyym/enterprise-class-open-source-interface-documentation-solution-torna.html

lllll

Share free open-source source code

Previous article： Human movement and sign language recognition system based on image

Next article： HZHControls Custom control library

Q&A

What is the delivery method?

1, automatic: after taking the photo, click the (download) link to download; 2. Manual: After taking the photo, contact the seller to issue it or contact the official to find the developer to ship.

View details

How long is the trading cycle?

1, the default transaction cycle of the source code: manual delivery of goods for 1-3 days, and the user payment amount will enter the platform guarantee until the completion of the transaction or 3-7 days can be issued, in case of disputes indefinitely extend the collection amount until the dispute is resolved or refunded!

View details

Matters needing attention

1. Heptalon will permanently archive the process of trading between the two parties and the snapshots of the traded goods to ensure that the transaction is true, effective and safe! 2, Seven PAWS can not guarantee such as "permanent package update", "permanent technical support" and other similar transactions after the merchant commitment, please identify the buyer; 3, in the source code at the same time there is a website demonstration and picture demonstration, and the site is inconsistent with the diagram, the default according to the diagram as the dispute evaluation basis (except for special statements or agreement); 4, in the absence of "no legitimate basis for refund", the commodity written "once sold, no support for refund" and other similar statements, shall be deemed invalid; 5, before the shooting, the transaction content agreed by the two parties on QQ can also be the basis for dispute judgment (agreement and description of the conflict, the agreement shall prevail); 6, because the chat record can be used as the basis for dispute judgment, so when the two sides contact, only communicate with the other party on the QQ and mobile phone number left on the systemhere, in case the other party does not recognize self-commitment. 7, although the probability of disputes is very small, but be sure to retain such important information as chat records, mobile phone messages, etc., in case of disputes, it is convenient for seven PAWS to intervene in rapid processing.

View details

Systemhere declaration

1. As a third-party intermediary platform, Qichou protects the security of the transaction and the rights and interests of both buyers and sellers according to the transaction contract (commodity description, content agreed before the transaction); 2, non-platform online trading projects, any consequences have nothing to do with mutual site; No matter the seller for any reason to require offline transactions, please contact the management report.

View details