124 lines
3.3 KiB
Markdown
124 lines
3.3 KiB
Markdown
|
# .codelf 项目文档目录
|
|||
|
|
|
|||
|
|
> 📚 这个目录包含了药店销售预测系统的完整文档，专为LLM大模型编程优化
|
|||
|
|
|
|||
|
|
## 📋 文档列表
|
|||
|
|
|
|||
|
|
### 🚀 [quick-reference.md](./quick-reference.md) - 快速参考指南
|
|||
|
|
**用途**: LLM编程的核心上下文文档
|
|||
|
|
**内容**:
|
|||
|
|
- 项目概述和技术栈
|
|||
|
|
- 快速启动命令
|
|||
|
|
- 核心目录结构
|
|||
|
|
- API接口列表
|
|||
|
|
- 支持的ML模型类型
|
|||
|
|
- 开发规范和常见问题
|
|||
|
|
- 重要注意事项和编程提示
|
|||
|
|
|
|||
|
|
**何时使用**:
|
|||
|
|
- LLM需要快速了解项目结构
|
|||
|
|
- 开发新功能前的参考
|
|||
|
|
- 解决常见问题时的查询
|
|||
|
|
|
|||
|
|
### 🏗️ [architecture.md](./architecture.md) - 系统架构详情
|
|||
|
|
**用途**: 深度技术架构和实现细节
|
|||
|
|
**内容**:
|
|||
|
|
- 系统架构图
|
|||
|
|
- 详细API规范和示例
|
|||
|
|
- 前端组件架构
|
|||
|
|
- 数据存储结构
|
|||
|
|
- 数据流程详解
|
|||
|
|
- 工具类说明
|
|||
|
|
- 错误处理机制
|
|||
|
|
- 性能优化策略
|
|||
|
|
|
|||
|
|
**何时使用**:
|
|||
|
|
- 需要深入理解系统设计
|
|||
|
|
- API接口开发和调试
|
|||
|
|
- 架构优化和重构
|
|||
|
|
- 新组件设计参考
|
|||
|
|
|
|||
|
|
### 📊 [project.md](./project.md) - 项目完整信息
|
|||
|
|
**用途**: 项目的详细记录和文件列表
|
|||
|
|
**内容**:
|
|||
|
|
- 完整的文件目录树
|
|||
|
|
- 项目历史和版本信息
|
|||
|
|
- 依赖关系详情
|
|||
|
|
- 配置文件说明
|
|||
|
|
|
|||
|
|
**何时使用**:
|
|||
|
|
- 查找特定文件位置
|
|||
|
|
- 了解项目完整结构
|
|||
|
|
- 依赖管理和版本控制
|
|||
|
|
|
|||
|
|
### 📝 [_changelog.md](./_changelog.md) - 变更日志
|
|||
|
|
**用途**: 记录项目的所有变更历史
|
|||
|
|
**内容**:
|
|||
|
|
- 按时间排序的变更记录
|
|||
|
|
- 详细的变更描述和影响范围
|
|||
|
|
- API变更和配置变更
|
|||
|
|
- 性能影响评估
|
|||
|
|
|
|||
|
|
**何时使用**:
|
|||
|
|
- 了解项目演进历史
|
|||
|
|
- 追踪特定功能的开发过程
|
|||
|
|
- 版本发布和回滚决策
|
|||
|
|
|
|||
|
|
### ⚠️ [attention.md](./attention.md) - 重要注意事项
|
|||
|
|
**用途**: 项目开发的关键提醒和规范
|
|||
|
|
**内容**:
|
|||
|
|
- 关键开发规范
|
|||
|
|
- 重要限制和约束
|
|||
|
|
- 安全注意事项
|
|||
|
|
- 性能考虑
|
|||
|
|
|
|||
|
|
**何时使用**:
|
|||
|
|
- 开始开发前必读
|
|||
|
|
- 避免常见错误
|
|||
|
|
- 代码审查参考
|
|||
|
|
|
|||
|
|
## 🎯 为LLM优化的使用指南
|
|||
|
|
|
|||
|
|
### 快速上手流程
|
|||
|
|
1. **首次接触项目** → 阅读 `quick-reference.md`
|
|||
|
|
2. **深入开发** → 参考 `architecture.md`
|
|||
|
|
3. **查找文件** → 搜索 `project.md`
|
|||
|
|
4. **了解历史** → 查看 `_changelog.md`
|
|||
|
|
5. **避免踩坑** → 检查 `attention.md`
|
|||
|
|
|
|||
|
|
### LLM编程最佳实践
|
|||
|
|
- 优先查阅 `quick-reference.md` 获取项目上下文
|
|||
|
|
- 使用 `architecture.md` 中的API示例和组件结构
|
|||
|
|
- 遵循文档中的开发规范和命名约定
|
|||
|
|
- 参考错误处理和性能优化建议
|
|||
|
|
|
|||
|
|
### 文档维护
|
|||
|
|
- 每次重大变更后更新 `_changelog.md`
|
|||
|
|
- 新增功能时同步更新 `quick-reference.md`
|
|||
|
|
- 架构变更时修订 `architecture.md`
|
|||
|
|
- 定期检查文档的准确性和完整性
|
|||
|
|
|
|||
|
|
## 🚀 快速命令参考
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
# 启动后端服务
|
|||
|
|
uv run .\server\api.py
|
|||
|
|
|
|||
|
|
# 启动前端开发服务器
|
|||
|
|
cd UI; npm run dev
|
|||
|
|
|
|||
|
|
# 查看项目结构
|
|||
|
|
tree /F
|
|||
|
|
|
|||
|
|
# 检查Python依赖
|
|||
|
|
uv pip list
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 📞 使用建议
|
|||
|
|
|
|||
|
|
💡 **提示**: 这些文档是为LLM大模型编程特别优化的，包含了项目的核心信息和开发模式，建议在每次编程任务开始前先查阅相关文档获取上下文。
|
|||
|
|
|
|||
|
|
🎯 **目标**: 通过结构化的文档系统，提高AI助手在药店销售预测系统开发中的效率和准确性。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
*📚 此目录通过 [codelf](https://github.com/codelf/codelf) 工具生成和维护，专为LLM编程提供项目知识库*
|