控制台快速搭建教程

当前教程页面由服务端模板渲染，面向业务开发者介绍如何基于 TokenProto-词元部落快速搭建控制台项目。

1. 创建启动工程

创建一个 Spring Boot 启动模块，统一承载控制台 Web 入口。

@SpringBootApplication(scanBasePackages = {"com.kylin"})
public class TokenprotoConsoleApplication {
    public static void main(String[] args) {
        SpringApplication.run(TokenprotoConsoleApplication.class, args);
    }
}

2. 引入控制台依赖

在启动模块引入控制台基础能力与示例 Web 能力。

<dependency>
    <groupId>com.kylin.cloud</groupId>
    <artifactId>kylin-cloud-starter-console</artifactId>
</dependency>
<dependency>
    <groupId>com.kylin.tokenproto</groupId>
    <artifactId>kylin-tokenproto-boot-web</artifactId>
</dependency>

3. 配置运行环境

按项目环境配置端口、context-path、数据源、Redis 与登录跳转地址。

server:
  port: 8880
  servlet:
    context-path: /

kylin:
  admin:
    redirect-after-login: /

当前配置示例中登录后跳转地址为： /

4. 目录建议

kylin-tokenproto-boot-web
├─ src/main/java/com/kylin/tokenproto/console/web
│  ├─ UserViewController.java
│  ├─ UserLoginController.java
│  └─ AdminTokenCookieFilter.java
├─ src/main/resources/templates/user
│  ├─ login.html
│  └─ index.html
└─ src/main/resources/static/user/css/admin.css

5. 启动与访问

启动控制台应用（IDEA 运行 main 或 `mvn spring-boot:run`）。
访问 `http://localhost:8880/admin/tutorial` 查看教程页。
访问 `.../admin/login` 进行登录，验证控制台链路。