Java 全栈博客项目AI 驱动开发实战⭐项目 GitHub 仓库https://github.com/HaoqiangLu/java-blog一个以AI 驱动开发模式完成的全栈博客平台实战教程。人与 AI 协同从零搭骨架开始按功能逐步叠加最终做出一个包含用户认证、文章评论、实时聊天、AI 助手并支持 Docker / Kubernetes 部署的现代 Web 应用。本仓库由两部分组成目录内容docs/分步教程文档Part 1–9 技术原理深挖主线学习内容java-blog/与教程对应的完整代码实现后端 前端 部署配置教程采用「功能驱动、依赖即用即加」的组织方式不是先把地基铺满而是每做一个功能缺什么依赖 / 数据库 / 配置才引入什么让每一步都看得见动机。⚠️说明本仓库的全部文档与代码均由个人与 AI 协同完成内容难免存在错误或过时的地方仅供学习与参考。如发现有误欢迎通过 Issue 指出我会及时修正。技术栈层技术后端Java 25、Spring Boot 3.5、Spring Security 6JWT 无状态认证、Spring Data JPA、Spring WebSocket前端React 19、TypeScript 5、Vite、React Router v7、TanStack Query、Zustand、TailwindCSS 4数据库PostgreSQL 17Flyway 迁移、Redis 7Token 黑名单 / Pub/Sub消息队列KafkaKRaft 模式扩展AI 助手Ollama / 本地代理、Actuator Micrometer 可观测性部署Docker Compose、KubernetesKustomize Nginx Ingress HPA、GitHub Actions CI/CD可选未实践开发工具IntelliJ IDEA、Maven 3.9、pnpm、Node.js 24、Git功能模块用户认证注册 / 登录 / JWT 签发与刷新、Redis Token 黑名单、BCrypt 密码加密文章与评论文章 CRUD、分页、全文搜索、Markdown 渲染、评论实时聊天Spring WebSocket Redis Pub/Sub 多实例广播、聊天室管理前端应用React SPA、服务端状态管理、受保护路由、深色模式安全加固CORS、XSS 防护、接口限流、安全响应头、方法级权限PreAuthorize功能扩展AI 聊天助手纯非流式、Kafka 事件流、Actuator 监控指标部署上线Docker 多阶段构建、docker-compose 一键启动、Kubernetes 集群部署跟docker compose会有冲突、GitHub Actions 自动化流水线我没有去弄文档阅读顺序教程必须按顺序阅读每个 Part 都在前一个基础上增量构建依赖、配置、数据库迁移、安全白名单都随功能逐步引入。顺序文档内容0idea-configuration.mdIDE 环境配置前置准备1part1-environment-and-skeleton.md工具安装 最小 Spring Boot 骨架可直接启动2part2-user-auth.md用户认证Postgres JPA Flyway Security JWT Redis3part3-posts-and-comments.md文章与评论建表 Service/Controller 放行接口4part4-websocket-chat.mdWebSocket 实时聊天 Redis Pub/Sub5part5-frontend.md前端初始化Vite/pnpm React 完整实现6part6-security.md限流 / XSS / 前端校验等安全加固7part7-extensions.md可观测性 Kafka AI 功能扩展8part8-deployment-cicd.mdDocker 构建 docker-compose Nginx GitHub Actions9part9-kubernetes.mdKubernetes 部署方案Part 8 的集群升级替代方案可选辅助文档technical-deep-dive.md每项技术的原理详解遇到不理解的技术时随时查阅。docs/summary/阶段性复盘总结。Part 8Docker Compose与 Part 9Kubernetes是同一部署目标的两种方案逻辑上二选一即可但不能同时运行两者共享同一个 Docker 引擎同时跑会端口 / 资源冲突切换前先执行docker compose down停掉 Part 8 的容器。快速启动代码位于java-blog/两种本地运行方式Docker Compose推荐本地开发cd java-blog docker compose-f docker/docker-compose.yml up-d--build访问https://myblog.local:4443Kubernetescd java-blog kubectl apply-k k8s/# 需两个终端分别运行kubectl port-forward svc/frontend-svc-n blog-platform 5000:80 kubectl port-forward svc/backend-svc-n blog-platform 8080:8080访问http://localhost:5000更多部署细节见java-blog/docker/README.md与java-blog/k8s/README.md。目录结构blog-project/ ├── README.md # 本文件 ├── docs/ # 教程文档Part 1–9 技术深挖 复盘总结 └── java-blog/ # 代码实现Git 仓库根 ├── backend/ # Spring Boot 后端Maven ├── frontend/ # React 前端pnpm ├── docker/ # Docker Compose 部署配置 ├── k8s/ # Kubernetes 部署配置 ├── nginx/ # Nginx 反向代理 本地 HTTPS 证书 └── deploy/ # Kafka topic 等部署资源学习建议先按Part 1装好环境、跑通最小骨架确认工具链正常。严格按顺序推进每个 Part 结束后自己动手复现而不是只复制代码。遇到不理解的技术名词去 technical-deep-dive.md 查原理。阶段完成后阅读 docs/summary/ 里的复盘把一条链路从头讲一遍以巩固记忆。