JuergGood/angularai
GitHub: JuergGood/angularai
AI 驱动的软件架构智能分析平台，通过自然语言问答、风险雷达和 ADR 漂移检测等功能帮助工程团队理解复杂架构并维护长期架构完整性。
Stars: 1 | Forks: 0
     
     
# GoodOne ### 面向工程团队的 AI 软件 **AI 驱动的平台，用于分析架构、开发工作流和工程文档。** GoodOne 展示了当 AI 成为**工程工作流本身**的一部分时会发生什么。 该平台不仅限于生成代码，还能分析： • 架构文档 • 开发工作流 • 项目知识 • 工程风险 在线演示 https://GoodOne.ch # 🤖 由 AI 构建 本项目是一个 **AI 驱动软件开发的展示**。 亮点： • **100% 的源代码由 AI 生成** • **迭代规划由 AI 辅助** • **架构设计由 AI 优化** • **AI 功能直接在运行时运行** GoodOne 尚未成为一个成品，而是一个 **AI 辅助软件工程的可运行演示**。 该平台正处于**积极开发中**，新的 AI 功能会不断加入。 # 🎬 产品演示  # 🧩 核心 AI 功能 | 功能 | 描述 | |------|-------------| | 架构 Q&A | 对系统架构提出自然语言问题 | | AI 风险雷达 | 检测反复出现的工程和交付风险 | | Sprint 回顾 | 自动生成回顾洞察 | | ADR 漂移检测 | 检测偏离 ADR 决策的架构漂移 | | AI 任务解析 | 将自然语言转换为结构化任务 | | AI 经济学 | 跟踪 AI 使用情况、积分和运营成本 | # 🏗 架构概述 ``` Angular Frontend │ ▼ Spring Boot API │ ▼ AI Analysis Layer │ ┌─────────┼─────────┐ ▼ ▼ ▼ Tasks Documentation ADRs ``` AI 会分析这些工件，从而生成关于工程系统的洞察。 # ✨ AI 特性 ## 架构 Q&A 对系统架构提出自然语言问题。 示例问题： • 哪些组件在运行时使用了 AI？ • 身份验证是如何工作的？ • reCAPTCHA 是如何验证的？ AI 会使用内部的架构文档来回答。 ## AI 风险雷达 自动检测反复出现的工程风险。 示例： • 被标记为 DONE 但仍包含未完成项的任务 • 缺少验证部分 • 文档不一致 帮助团队尽早发现**系统性质量问题**。 ## AI Sprint 回顾 基于开发任务生成 **AI 辅助的 Sprint 回顾**。 系统会分析： • 任务完成模式 • 反复出现的阻碍因素 • 文档质量 ## ADR 漂移检测 架构决策记录 (ADR) 定义了架构意图。 GoodOne 会监控实现过程，并在系统偏离这些决策时检测出漂移。 这有助于维护**长期的架构完整性**。 ## AI 任务解析 将自然语言转换为结构化的工作项。 示例： 下周五准备架构评审 AI 会提取： • 标题 • 截止日期 • 类别 ## AI 经济学 跟踪并了解平台内的 AI 使用情况。 示例： • AI 积分请求 • 使用情况仪表板 • 成本透明度 # ⚡ 快速开始 克隆仓库 git clone https://github.com/JuergGood/angularai 启动技术栈 cp .env.example .env docker compose -f deploy/dev/docker-compose.yml up --build 应用端点 前端 http://localhost 后端 API http://localhost:8080/api Mailpit http://localhost:8025 # AI 运行时要求 部分运行时功能需要访问 AI 模型。 ### OpenAI 目前的运行时 AI 功能使用的是 **OpenAI API**。 OPENAI_API_KEY=your_key_here ### Ollama（计划中） 一个**使用 Ollama 的本地运行时**目前正在开发中。 这将允许在没有外部 API 的情况下在本地运行 AI 功能。 ### 数据库 应用使用 **PostgreSQL**，通过 Docker 自动启动。 # 📚 文档 文档位于 `doc` 目录中。 主要入口： 架构 doc/knowledge/architecture/index.md 用户指南 doc/operations-guide.md 管理员指南 doc/operations-guide.md 部署 doc/infrastructure/Deployment.md # 🎯 愿景 GoodOne 探索了 **AI 如何增强软件工程工作流**。 该平台并非旨在取代开发人员，而是帮助团队： • 理解复杂的架构 • 检测工程风险 • 分析开发过程 • 维护架构意图 ⭐ 如果您觉得这个项目很有趣，请考虑给本仓库加个星标。