kongdeqiang
2026-10-12 ccf1a44c001e233c158bd168dc2d0d96721af929
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
 
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.0</version>
        <relativePath/>
    </parent>
 
    <groupId>com.custom</groupId>
    <artifactId>webui-springboot</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>webui-springboot</name>
    <description>Custom-WebUI 主业务后端:认证、会话、消息树、SSE 流式对话、RAG 代理</description>
 
    <properties>
        <java.version>17</java.version>
        <mybatis-plus.version>3.5.5</mybatis-plus.version>
        <jjwt.version>0.11.5</jjwt.version>
        <!--
          源码与输出统一使用 UTF-8。
          必须显式声明:源码注释含大量中文,若让编译器沿用平台默认编码
          (Windows 上常为 GBK、某些环境下为 ASCII),会直接报
          「非法字符: '\uff0c'」这类难以定位的编译错误。
        -->
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
    </properties>
 
    <dependencies>
        <!-- Web MVC:提供 Controller / SseEmitter / RestTemplate -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
 
        <!-- Spring Security:认证授权 + 密码编码 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-security</artifactId>
        </dependency>
 
        <!-- 参数校验(@Valid / @NotBlank 等) -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-validation</artifactId>
        </dependency>
 
        <!-- MyBatis-Plus:SpringBoot3 专用 starter -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
            <version>${mybatis-plus.version}</version>
        </dependency>
 
        <!-- MySQL 驱动 -->
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>
 
        <!-- JWT -->
        <dependency>
            <groupId>io.jsonwebtoken</groupId>
            <artifactId>jjwt-api</artifactId>
            <version>${jjwt.version}</version>
        </dependency>
        <dependency>
            <groupId>io.jsonwebtoken</groupId>
            <artifactId>jjwt-impl</artifactId>
            <version>${jjwt.version}</version>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>io.jsonwebtoken</groupId>
            <artifactId>jjwt-jackson</artifactId>
            <version>${jjwt.version}</version>
            <scope>runtime</scope>
        </dependency>
 
        <!-- Lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
 
        <!--
          PDF 导出(Apache PDFBox,Apache-2.0)
 
          为什么是 PDFBox 而不是 iText / openhtmltopdf:
            - iText 是 AGPL,闭源分发要买商业授权,本项目不适合
            - openhtmltopdf 依赖链很长(自己也要拖 PDFBox),而我们只需要
              「标题 + 元信息 + 若干条消息」这一种版式,用不着 HTML/CSS 排版引擎
            - PDFBox 只多两个传递依赖(fontbox、pdfbox-io),且能直接嵌入
              系统中文字体并按子集裁剪,一个中文对话导出的 PDF 通常只有几十 KB
 
          commons-logging 为什么要显式钉版本:pdfbox-parent 里声明的是 1.3.3,
          而本项目离线仓库里只有 1.3.4 —— 不钉的话离线构建会解析失败。
          两者是同一主线的补丁版本,行为兼容。
        -->
        <dependency>
            <groupId>org.apache.pdfbox</groupId>
            <artifactId>pdfbox</artifactId>
            <version>3.0.3</version>
        </dependency>
        <dependency>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
            <version>1.3.4</version>
        </dependency>
 
        <!-- 测试 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!--
          说明:本项目当前没有 JUnit 测试(主链路验证走 scripts/smoke-test.sh
          端到端黑盒测试,覆盖度比单元测试更贴近真实使用)。
          因此刻意不引入 spring-security-test —— 少一个依赖就少一份维护面。
          将来补 @WithMockUser 之类的测试时,再加上即可:
            <dependency>
              <groupId>org.springframework.security</groupId>
              <artifactId>spring-security-test</artifactId>
              <scope>test</scope>
            </dependency>
        -->
    </dependencies>
 
    <profiles>
        <!--
          smoke 冒烟测试 profile:引入 H2 内存库。
          刻意放在独立 profile 中而不是默认依赖,原因:
            - 生产构建不需要 H2,少一个依赖就少一份 CVE 面
            - 离线环境无需为跑通生产构建而拉取 H2
          启用方式:mvn -Psmoke spring-boot:run
        -->
        <profile>
            <id>smoke</id>
            <dependencies>
                <dependency>
                    <groupId>com.h2database</groupId>
                    <artifactId>h2</artifactId>
                    <scope>runtime</scope>
                </dependency>
            </dependencies>
        </profile>
    </profiles>
 
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>