hunjing

技术栈

前端

Next.js + TypeScript + React + Tailwind CSS + Zustand/Jotai + pnpm

核心依赖

实时通信: SSE / WebSocket
可视化: Mermaid + 图谱可视化库
测试: Vitest + Testing Library
代码质量: ESLint (flat config) + Prettier + Husky + lint-staged

后端

python（uv管理）： FastAPI + SQLAlchemy + Alembic + Pydantic + httpx + loguru + uvicorn + chromadb rust（cargo管理）： tauri（桌面端设计） go （go mod管理）：

文档设计

相关的文档统一放在docs目录下

文档中所有的流程图和架构图都应该使用统一的mermaid绘制相关风格和格式，同时确保能够正常显示
文档应该定期更新和维护，以确保其内容的准确性和时效性。每次系统更新或功能变更后，相关文档也应该及时进行更新，以反映最新的系统状态和功能变化。

docker部署

Docker 文件放在根目录 docker/ 下。容器名称以 hunjing 开头。 Compose 文件不使用顶部 version 字段。本地开发默认使用 SQLite 文件数据库，正式环境使用 PostgreSQL，并按需启用 Milvus、Neo4j / NebulaGraph、Redis 和对象存储。

项目目录

日志统一放在根目录的logs目录下数据库相关的文件统一放在根目录的db目录下配置文件统一放在根目录的config目录下 .env.example文件放在根目录下，包含所有环境变量的示例和详细的中文说明

前端页面设计

图标：统一使用 Lucide 图标，界面全程禁止使用表情符号。设计标准：对标 Awwwards 顶级网站水准，达到 Awwwards、FWA、CSS Design Awards 每日最佳网站同等设计品质。创意自由度：将浏览器视作交互式艺术画布，跳出传统布局框架，追求先锋视觉风格、实验性排版、流畅物理动效、极具冲击力的文字版式。沉浸式体验：融合代码、高级渲染逻辑、图片素材，打造统一完整的精品页面，做出突破常规 UI 认知、令人惊艳的数字交互体验。

开发命令

Docker

编排按职责解耦为两个文件，容器名统一以 hunjing- 开头，通过共享网络 hunjing-net 互通，详细说明见 docker/README.md： docker-compose.infra.yml（数据库 / 缓存 / 向量 / 图库 / 对象存储）创建网络与命名卷，docker-compose.app.yml（前后端）以 external 引用该网络。

# 先准备配置（只需一次）
cp .env.example .env                       # 填写 POSTGRES_PASSWORD 与各 *_API_KEY
cp config/models.example.yaml config/models.yaml  # 按需填写真实模型 endpoint

# 1) 启动基础设施（首次创建 hunjing-net 网络；Milvus 会自动带起 hunjing-etcd / hunjing-minio）
docker compose -f docker/docker-compose.infra.yml up -d
#   仅按需：docker compose -f docker/docker-compose.infra.yml up -d hunjing-postgres hunjing-redis
#   NebulaGraph（需 --profile）：--profile nebulagraph up -d hunjing-nebula-graphd hunjing-nebula-console-init
#   Attu（Milvus 可视化）：up -d hunjing-attu，访问 http://localhost:8001
#   数据库备份（手动触发，产物在 backups/）：--profile backup run --rm hunjing-pg-backup

# 2) 启动应用层（构建前后端镜像；必须先启动基础设施以创建网络）后端镜像内置 wait-for-it，会按 *_ENABLED 开关自动等待依赖就绪后再启动
docker compose -f docker/docker-compose.app.yml up -d --build

# 可选：反向代理（统一入口 80，/api 与 SSE 走后端，其余走前端）
docker compose -f docker/docker-compose.app.yml --profile nginx up -d hunjing-nginx

# 一键（基础设施 + 应用）
docker compose -f docker/docker-compose.infra.yml up -d && docker compose -f docker/docker-compose.app.yml up -d --build

必须遵守事项

文件路径
    代码中以项目根目录为起点的绝对路径导入相关的配置或者文件

文档管理
    开发前查阅 docs/ 中的相关文档
    稳定工程标识、枚举值、ID 前缀、事件名、命名约定和错误码以 docs/contracts/contract-glossary.md 为单一事实源，下游文档引用而非复制取值列表

版本控制
    只提交 .*.example 文件到 Git

5.3 KiB Raw Blame History Unescape Escape