使用说明
🌌 Aether-代理项目建筑师
使用AI驱动的视觉规划将想法转化为结构化的项目架构。
Aether是一个可视化项目规划平台，其中Go后端编排LLM代理，使用React Flow将单个提示分解为结构化的、基于节点的项目图。
✨ 特性
🎨 漂亮的UI
- 暗模式玻璃态 -现代优雅的设计，带有模糊效果
- 帧运动动画 -平滑的基于弹簧的物理动画
- 自定义吐司通知 -带有动画的快乐/哭泣脸SVG
- 视差背景 -网格背景上微妙的鼠标跟随效果
🤖 AI驱动
- 项目生成 -将提示转换为结构化项目图
- 智能节点创建 -AI生成组件、特征和依赖关系
- 技术栈建议 -自动技术建议
- 任务分解 -具有优先级的可操作任务
🎯 强大功能
- 视觉画布 -带有自定义节点的交互式React Flow画布
- 自动保存 -静音背景每30秒保存一次
- 项目管理 -列出、切换和管理多个项目
- 认证 -使用Supabase Auth保护用户帐户
- 实时更新 -即时图形再生
🏗️ 清洁建筑
- 转到后端 -基于特征的模块化清洁架构
- 通用响应 -使用Go Generics的类型安全API响应
- 指针优先策略 -内存高效的域模型
- 依赖注入 -可测试、可维护的代码
- 200行规则 -强制模块化以提高可读性
🚀 快速开始
先决条件
- Node.js 18+
- 转到1.21+
- Supabase账户（免费等级）
1.克隆存储库
git clone https://github.com/yourusername/aether.git
cd aether
2.设置数据库
# Run migration in Supabase SQL Editor
# Or use Supabase CLI:
npx supabase link --project-ref your-ref
npx supabase db push
3.启动后端
cd backend
cp .env.example .env
# Edit .env with your Supabase credentials
go mod download
make run
4.启动前端
cd frontend
cp .env.example .env
# Edit .env with your API and Supabase URLs
npm install
npm run dev
5.打开浏览器
导航至 http://localhost:5173 并开始创建项目！
📚 文档
🏛️ 建筑
┌─────────────────────────────────────────────────────────────┐
│ Frontend │
│ React + Vite + Tailwind + Framer Motion + React Flow │
│ │
│ ┌─────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Dashboard │ │ ProjectCanvas│ │ AuthDialog │ │
│ └─────────────┘ └──────────────┘ └──────────────┘ │
└─────────────────────────────────────────────────────────────┘
│ REST API
┌─────────────────────────────────────────────────────────────┐
│ Go Backend │
│ Clean Architecture (Chi Router) │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Platform Layer │ │
│ │ Response │ Middleware │ Router │ Logger │ │
│ └─────────────────────────────────────────────────────┘ │
│ │ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Project Feature (Domain) │ │
│ │ Service │ Repository │ Handler │ │
│ └─────────────────────────────────────────────────────┘ │
│ │ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Infrastructure Layer │ │
│ │ AI Client │ MCP Client │ Supabase Client │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
│
┌─────────────────────────────────────────────────────────────┐
│ Supabase (PostgreSQL) │
│ Projects │ Nodes │ Edges │ Auth │ RLS │
└─────────────────────────────────────────────────────────────┘
🛠️ 技术栈
后端
- 转到1.21+ -高性能后端
- Chi路由器 -轻量级HTTP路由器
- Supabase Go客户端 -数据库和身份验证
- 清洁建筑 -可维护的代码结构
前端
- 反应18 -现代UI库
- 维特 -闪电般快速构建工具
- Tailwind CSS -实用性优先的造型
- 帧运动 -流畅的动画
- React 流程 -交互式节点图
- Radix UI -可访问组件
- Lucide React -美丽的图标
数据库
- Supabase -带身份验证的PostgreSQL
- 行级安全性 -安全的数据访问
- 实时 -实时更新（可选）
📖 API终点
GET /health - Health check
POST /api/projects - Create project
POST /api/projects/generate - Generate with AI
GET /api/projects - List projects
GET /api/projects/{id} - Get project
PUT /api/projects/{id} - Update project
DELETE /api/projects/{id} - Delete project
POST /api/projects/{id}/autosave - Auto-save graph
POST /api/projects/{id}/generate - Regenerate graph
🎨 截图
仪表盘
具有玻璃形态效果的美丽暗模式界面。
项目画布
基于React Flow的交互式节点项目可视化。
人工智能一代
将提示转换为结构化的项目架构。
🧪 测试
# Backend tests
cd backend
make test
# Frontend tests (if configured)
cd frontend
npm test
# Integration tests
# See TESTING_GUIDE.md for complete workflow
🚢 部署
推荐堆栈
- 后端： 铁路或Fly.io
- 前端： Vercel或Netlify
- 数据库： Supabase（托管）
看 部署.md 详细说明。
🤝 贡献
欢迎投稿！请在提交PR之前阅读我们的投稿指南。
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📝 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙏 致谢
- 清洁建筑 -罗伯特C.马丁
- React 流程 -Webkid有限公司
- Supabase -开源Firebase替代品
- 帧运动 -制作就绪动画
📧 联系
建于❤️ 使用清洁架构和现代最佳实践。
⭐ 如果你觉得这个repo有用，请将其标记为星号！
