添加 user-openapi.adoc

.gitignore

@@ -2,3 +2,5 @@
 .cache
 build
 /docs/antora/modules/ROOT/assets/attachments/resume/resume.tar
+books
+resume

docs/antora/modules/ROOT/nav.adoc

@@ -4,6 +4,8 @@
 * xref:term.adoc[]
 * xref:schedule.adoc[]
 * xref:application.adoc[]
+* xref:user-openapi.adoc[]
 * xref:faq.adoc[]
+* xref:version.adoc[]
 // * xref:computer.adoc[]
 // * xref:resume-12.adoc[]

docs/antora/modules/ROOT/pages/faq.adoc

@@ -1,10 +1,25 @@
 = 问题
 
+== 杂项
+
+* 如何快速分析"多模块 Maven 项目"中模块之间的依赖关系。
+
 == Java
 
 如何转换耗时为人类可读的字符串？::
 参考 https://stackoverflow.com/questions/3471397/how-can-i-pretty-print-a-duration-in-java[stackoverflow^]。
 
+构造方法继承父类方法的注释？::
+peacetrue-common/src/main/java/com/github/peacetrue/range/LocalDateTimeRange.java:29: 警告: 没有注释
+public LocalDateTimeRange(LocalDateTime lowerBound, LocalDateTime upperBound, Boolean lowerInclusive, Boolean upperInclusive)
+
+see https://stackoverflow.com/questions/14402275/javadoc-inheriting-parent-constructors-documentation
+
+Lombok 项目支持 Java 9 吗？::
+. https://stackoverflow.com/questions/41520511/does-project-lombok-support-java-9
+. https://projectlombok.org/features/configuration
+
+
 == 统一变量
 
 * 环境变量
@@ -38,3 +53,27 @@ Vim paste from clipboard::
 . 网络模拟器：网络模拟器是一种软件，可以模拟不同类型的网络，包括网络分区。网络模拟器可以模拟各种网络条件，如带宽、延迟、丢包率等，从而模拟网络分区的不同情况。
 
 需要注意的是，在模拟网络分区时，需要仔细考虑网络拓扑结构、节点之间的通信方式、网络流量等因素，以确保模拟的真实性和准确性。
+
+== GitHub
+
+=== without `workflow` scope
+
+.Question：
+* !	refs/heads/master:refs/heads/master	[remote rejected] (refusing to allow an OAuth App to create or update workflow `.github/workflows/main.yml` without `workflow` scope)
+
+.See：
+* https://stackoverflow.com/questions/64059610/how-to-resolve-refusing-to-allow-an-oauth-app-to-create-or-update-workflow-on
+* https://stackoverflow.com/questions/16052602/how-to-disable-osxkeychain-as-credential-helper-in-git-config/16052884#16052884
+
+[source%nowrap]
+----
+git config --local --unset credential.helper
+git config --global --unset credential.helper
+git config --system --unset credential.helper
+----
+
+
+=== 使用多个版本的 JDK 测试代码
+
+.See
+* https://github.com/actions/setup-java/issues/44

docs/antora/modules/ROOT/pages/github.adoc

@@ -6,6 +6,7 @@
 
 构建源码：
 
+[source%nowrap,adoc]
 ----
 image:https://img.shields.io/github/actions/workflow/status/peacetrue/{app-name}/main.yml?branch=master["GitHub Workflow Status",link="https://github.com/peacetrue/{app-name}/actions"]
 ----
@@ -21,8 +22,7 @@ image:https://img.shields.io/github/actions/workflow/status/peacetrue/{app-name}
 . 测试结果徽章： https://shields.io/category/test-results
 . [.line-through]#https://foresight.thundra.io/# 网站下线
 . [.line-through]#https://ci.appveyor.com/# 构建平台与 GitHub 功能重叠，只需要上传展示测试报告
-. https://help.testspace.com/getting.started test space good
-. https://github.com/testspace-com/hello.publish[demo for testspace^]
+. https://help.testspace.com/getting.started good
 . https://peacetrue.testspace.com/[peacetrue for testspace^]
 
 .github/workflows/main.yml

docs/antora/modules/ROOT/pages/repository.adoc

@@ -148,6 +148,8 @@ learn::
 learn 记录学习过程。每个模块对应一块知识。
 samples::
 samples 存储代码样章。每个模块对应一个样章。
+cases::
+cases 存储案例。
 peacetrue-convention::
 peacetrue-convention 存储二方库。
 peacetrue*::
@@ -167,6 +169,44 @@ WARNING: 以上未完待续！
 
 资源库涉及的编程语言，包括：Java、JavaScript、Shell，以 Java 主。
 
+== 数据库版本
+
+每个模块都是一个单独的组件，将所有模块组合起来，创建一个示例应用。
+
+|===
+|模块 |版本 |备注
+
+|用户
+|V1_1_0__user.sql
+|
+
+|参数配置
+|V1_10_0__configuration.sql
+|？
+
+|数据字典
+|V1_20_0__dictionary.sql
+|
+
+|分类
+|V1_30_0__classify.sql
+|
+
+|日志
+|V1_40_0__log.sql
+|
+
+|附件
+|V1_50_0__attachment.sql
+|
+
+|区域
+|V1_60_0__region.sql
+|
+|===
+
+
+
 == 模块组织
 
 根据资源库中模块的组织方式，可分为以下几类：
@@ -253,3 +293,20 @@ image::image-2022-08-14-14-45-48-716.png[]
 容易产生冲突，需要想办法规避。
 规避思路为，每个模块都使用各自独立的文件，
 禁止两个模块共用同一个文件。
+
+
+== 仓库版本
+
+* image:https://img.shields.io/nexus/r/com.github.peacetrue.gradle/peacetrue-gradle-plugin?label=peacetrue-gradle&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-gradle",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue.gradle"]
+* image:https://img.shields.io/nexus/r/com.github.peacetrue/peacetrue-dependencies?label=peacetrue-dependencies&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-dependencies",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue"]
+* image:https://img.shields.io/nexus/r/com.github.peacetrue/peacetrue-common?label=peacetrue-common&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-common",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue"]
+* image:https://img.shields.io/nexus/r/com.github.peacetrue/peacetrue-beans?label=peacetrue-beans&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-beans",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue"]
+* image:https://img.shields.io/nexus/r/com.github.peacetrue/peacetrue-test?label=peacetrue-test&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-test",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue"]
+* image:https://img.shields.io/nexus/r/com.github.peacetrue/peacetrue-cryptography?label=peacetrue-cryptography&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-cryptography",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue"]
+* image:https://img.shields.io/nexus/r/com.github.peacetrue/peacetrue-validation?label=peacetrue-validation&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-validation",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue"]
+* image:https://img.shields.io/nexus/r/com.github.peacetrue/peacetrue-servlet?label=peacetrue-servlet&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-servlet",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue"]
+* image:https://img.shields.io/nexus/r/com.github.peacetrue.result/peacetrue-result-core?label=peacetrue-result&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-result",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue.result"]
+* image:https://img.shields.io/nexus/r/com.github.peacetrue.spring/peacetrue-spring-beans?label=peacetrue-spring&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-spring",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue.spring"]
+* image:https://img.shields.io/nexus/r/com.github.peacetrue.tplngn/peacetrue-tplngn-core?label=peacetrue-tplngn&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-tplngn",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue.tplngn"]
+* image:https://img.shields.io/nexus/r/com.github.peacetrue.template/peacetrue-template-antora?label=peacetrue-template&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-template",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue.template"]
+* image:https://img.shields.io/nexus/r/com.github.peacetrue.file/peacetrue-file-service-api?label=peacetrue-file&server=https%3A%2F%2Foss.sonatype.org%2F["peacetrue-file",link="https://central.sonatype.com/search?smo=true&q=com.github.peacetrue.file"]