Enhance project rules and documentation structure
- Updated project rules to unify structure and interaction with tools, emphasizing the use of UV for package management and Windows PowerShell for terminal commands. - Added guidelines for argument validation and referencing documentation files for context and architecture. - Improved links in the README documentation for better navigation and accessibility to project resources. These changes aim to streamline project management and enhance clarity for developers, ensuring adherence to best practices and coding standards.
This commit is contained in:
parent
c8d8d980aa
commit
551316872c
@ -3,6 +3,18 @@ description:
|
|||||||
globs:
|
globs:
|
||||||
alwaysApply: true
|
alwaysApply: true
|
||||||
---
|
---
|
||||||
- use UV for package management
|
# Rule: Project specific rules
|
||||||
- ./docs folder for the documetation and the modules description, update related files if logic changed
|
|
||||||
|
## Goal
|
||||||
|
Unify the project structure and interraction with tools and console
|
||||||
|
|
||||||
|
### System tools
|
||||||
|
- **ALWAYS** use UV for package management
|
||||||
|
- **ALWAYS** use windows PowerShell command for terminal
|
||||||
|
|
||||||
|
### Coding patterns
|
||||||
|
- **ALWYAS** check the arguments and methods before use to avoid errors with whron parameters or names
|
||||||
|
- If in doubt, check [CONTEXT.md](mdc:CONTEXT.md) file and [architecture.md](mdc:docs/architecture.md)
|
||||||
|
- **PREFER** ORM pattern for databases with SQLAclhemy.
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -24,7 +24,7 @@ Before starting any refactoring, the AI MUST:
|
|||||||
1. **Context Analysis:**
|
1. **Context Analysis:**
|
||||||
- Review existing `CONTEXT.md` for architectural decisions
|
- Review existing `CONTEXT.md` for architectural decisions
|
||||||
- Analyze current code patterns and conventions
|
- Analyze current code patterns and conventions
|
||||||
- Identify all files that will be affected
|
- Identify all files that will be affected (search the codebase for use)
|
||||||
- Check for existing tests that verify current behavior
|
- Check for existing tests that verify current behavior
|
||||||
|
|
||||||
2. **Scope Definition:**
|
2. **Scope Definition:**
|
||||||
|
|||||||
@ -5,32 +5,32 @@ Welcome to the documentation for the TCP Trading Platform. This resource provide
|
|||||||
## Table of Contents
|
## Table of Contents
|
||||||
|
|
||||||
### 1. Project Overview
|
### 1. Project Overview
|
||||||
- **[Project Context (`CONTEXT.md`)]** - The single source of truth for the project's current state, architecture, and conventions. **Start here.**
|
- **[Project Context (`../CONTEXT.md`)](../CONTEXT.md)** - The single source of truth for the project's current state, architecture, and conventions. **Start here.**
|
||||||
- **[Product Requirements (`crypto-bot-prd.md`)]** - The Product Requirements Document (PRD) outlining the project's goals and scope.
|
- **[Product Requirements (`./crypto-bot-prd.md`)](./crypto-bot-prd.md)** - The Product Requirements Document (PRD) outlining the project's goals and scope.
|
||||||
|
|
||||||
### 2. Getting Started
|
### 2. Getting Started
|
||||||
- **[Setup Guide (`guides/setup.md`)]** - Instructions for setting up the development environment.
|
- **[Setup Guide (`guides/setup.md`)](./guides/setup.md)** - Instructions for setting up the development environment.
|
||||||
- **[Contributing (`CONTRIBUTING.md`)]** - Guidelines for contributing to the project.
|
- **[Contributing (`CONTRIBUTING.md`)](./CONTRIBUTING.md)** - Guidelines for contributing to the project.
|
||||||
|
|
||||||
### 3. Architecture & Design
|
### 3. Architecture & Design
|
||||||
- **[Architecture Overview (`architecture.md`)]** - High-level system architecture, components, and data flow.
|
- **[Architecture Overview (`../architecture.md`)](../architecture.md)** - High-level system architecture, components, and data flow.
|
||||||
- **[Architecture Decision Records (`decisions/`)](./decisions/)** - Key architectural decisions and their justifications.
|
- **[Architecture Decision Records (`decisions/`)](./decisions/)** - Key architectural decisions and their justifications.
|
||||||
|
|
||||||
### 4. Modules Documentation
|
### 4. Modules Documentation
|
||||||
This section contains detailed technical documentation for each system module.
|
This section contains detailed technical documentation for each system module.
|
||||||
|
|
||||||
- **[Chart System (`modules/charts/`)](./modules/charts/)** - Comprehensive documentation for the modular chart system.
|
- **[Chart System (`modules/charts/`)](./modules/charts/)** - Comprehensive documentation for the modular chart system.
|
||||||
- **[Data Collectors (`modules/data_collectors.md`)]** - Guide to the data collector framework.
|
- **[Data Collectors (`modules/data_collectors.md`)](./modules/data_collectors.md)йй** - Guide to the data collector framework.
|
||||||
- **[Database Operations (`modules/database_operations.md`)]** - Details on the repository pattern for database interactions.
|
- **[Database Operations (`modules/database_operations.md`)](./modules/database_operations.md)** - Details on the repository pattern for database interactions.
|
||||||
- **[Technical Indicators (`modules/technical-indicators.md`)]** - Information on the technical analysis module.
|
- **[Technical Indicators (`modules/technical-indicators.md`)](./modules/technical-indicators.md)** - Information on the technical analysis module.
|
||||||
- **[Exchange Integrations (`modules/exchanges/`)](./modules/exchanges/)** - Exchange-specific implementation details.
|
- **[Exchange Integrations (`modules/exchanges/`)](./modules/exchanges/)** - Exchange-specific implementation details.
|
||||||
- **[Logging System (`modules/logging.md`)]** - The unified logging framework.
|
- **[Logging System (`modules/logging.md`)](./modules/logging.md)** - The unified logging framework.
|
||||||
- **[Data Collection Service (`modules/services/data_collection_service.md`)]** - The high-level service that orchestrates data collectors.
|
- **[Data Collection Service (`modules/services/data_collection_service.md`)](./modules/services/data_collection_service.md)** - The high-level service that orchestrates data collectors.
|
||||||
|
|
||||||
### 5. API & Reference
|
### 5. API & Reference
|
||||||
- **[API Documentation (`API.md`)]** - Placeholder for future REST API documentation.
|
- **[API Documentation (`API.md`)](./API.md)** - Placeholder for future REST API documentation.
|
||||||
- **[Technical Reference (`reference/`)](./reference/)** - Detailed specifications, data formats, and standards.
|
- **[Technical Reference (`reference/`)](./reference/)** - Detailed specifications, data formats, and standards.
|
||||||
- **[Changelog (`CHANGELOG.md`)]** - A log of all notable changes to the project.
|
- **[Changelog (`CHANGELOG.md`)](./CHANGELOG.md)** - A log of all notable changes to the project.
|
||||||
|
|
||||||
## How to Use This Documentation
|
## How to Use This Documentation
|
||||||
|
|
||||||
@ -44,7 +44,7 @@ This documentation is intended to be a living document that evolves with the pro
|
|||||||
|
|
||||||
### 📖 **[Setup & Guides](guides/)**
|
### 📖 **[Setup & Guides](guides/)**
|
||||||
|
|
||||||
- **[Setup Guide](guides/setup.md)** - *Comprehensive setup instructions*
|
- **[Setup Guide](./guides/setup.md)** - *Comprehensive setup instructions*
|
||||||
- Environment configuration and prerequisites
|
- Environment configuration and prerequisites
|
||||||
- Database setup with Docker and PostgreSQL
|
- Database setup with Docker and PostgreSQL
|
||||||
- Development workflow and best practices
|
- Development workflow and best practices
|
||||||
@ -52,7 +52,7 @@ This documentation is intended to be a living document that evolves with the pro
|
|||||||
|
|
||||||
### 📋 **[Technical Reference](reference/)**
|
### 📋 **[Technical Reference](reference/)**
|
||||||
|
|
||||||
- **[Project Specification](reference/specification.md)** - *Technical specifications and requirements*
|
- **[Project Specification](./reference/specification.md)** - *Technical specifications and requirements*
|
||||||
- System requirements and constraints
|
- System requirements and constraints
|
||||||
- Database schema specifications
|
- Database schema specifications
|
||||||
- API endpoint definitions
|
- API endpoint definitions
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user