使用说明
工具服务（域和约定管理代理）
项目概述
Tool Service（Domain&Convention Management Agent）是软件开发的核心资产。 域知识和 项目会议作为独立模块进行管理，并帮助AI Agent将其引用到适当的位置的系统。
此项目包含两个独立的Bounded Context（domain_document哇 project_convention），每种架构都采用了十六进制体系结构。
domain_document：管理域定义、属性、策略、关系等。包含有关“我们在做什么”的信息。project_convention：管理特定项目的标准和规则。包含有关“我们如何制作”的信息。
安装和运行
1.安装项目克隆和依赖性
# git clone <repository_url> # 프로젝트 클론
# cd <project_directory> # 프로젝트 디렉토리로 이동
poetry install
2.设置环境变量（.env)
在项目根目录中 .env 创建文件并设置数据库连接信息。
# .env 파일 예시
DB_USER=your_db_user
DB_PASSWORD=your_db_password
DB_HOST=localhost
DB_PORT=5432
DB_NAME=tool_service_db
your_db_user哇 your_db_password必须更改为实际PostgreSQL用户名和密码。
3.初始化数据库（Seed Data）
在启动应用程序之前，必须将所需的初始数据注入数据库。
# poetry run python seed.py
请参见: seed.py 文件在初始数据注入后自动删除。
4.运行FastAPI服务器
要验证Web适配器是否工作正常，请启动FastAPI服务器。
poetry run uvicorn main:app --reload
服务器启动后 http://localhost:8000/docs可以通过Swagger UI查看API文档。
测试
Web API端点
- API文档：
http://localhost:8000/docs - 查看项目会议（示例）：
http://localhost:8000/conventions/my-project
AI Agent模拟（MCP Tool处理程序）
src/mcp/handler.py在中定义 read_domain_spec, read_project_conventions, analyze_impact 函数是AI Agent（MCP）将使用的工具。可以通过以下问题向Agent验证工具调用和操作：
“为User域编写添加nickname字段的迁移代码”
通过Agent的响应 read_domain_spec和 read_project_conventions请确保正确调用。
