技术热点雷达系统

项目功能

这是一个用于发现热门技术栈、热门技术话题、热门开源项目的后端系统。

当前项目聚焦以下功能：

• 聚合 GitHub、Hacker News、RSS 等来源的热点信号
• 识别并沉淀热门开源项目（projects）
• 识别并归一热门技术话题（topics）
• 映射和统计热门技术栈（stacks）
• 计算热度分数（heat score）与趋势状态（trend status）
• 输出热门榜单 API
• 支持后续日报 / 周报生成

当前已实现

• FastAPI 应用骨架
• 本地 MySQL 配置读取
• SQLAlchemy 模型定义
• Alembic migration 基础结构
• GitHub / Hacker News Collector 骨架
• 项目热度同步服务骨架
• 健康检查接口
• 热门项目查询接口
• 手动同步 GitHub 热门项目接口

API 概览

• GET /health：服务健康检查
• GET /api/projects/top：获取热门项目榜单
• POST /api/sync/github-projects：手动同步 GitHub 热门项目

本地启动

1. 本地创建 MySQL 数据库：tech_radar
2. 复制配置文件：将 .env.example 复制为 .env
3. 安装依赖：pip install -r requirements.txt
4. 执行 migration：alembic upgrade head
5. 启动服务：uvicorn app.main:app --reload

开发约束

• 必须遵循 tech-radar-plan.md 约定的目标与边界
• 新功能先更新文档，再进入编码
• 保持 collectors / normalizers / services / repositories / api 的职责分离
• 数据库变更统一通过 Alembic migration 管理