1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130# Contributing to Decision Engine
Thank you for considering contributing to Decision Engine! This document provides guidelines and instructions for contributing.
## Code of Conduct
By participating in this project, you agree to abide by our [Code of Conduct](CODE_OF_CONDUCT.md).
## How Can I Contribute?
### Reporting Bugs
Bug reports help make Decision Engine more stable. When you submit a bug report, please include:
1. **Version Information**: Include the Decision Engine version you're using
2. **Environment**: Include OS, Rust version, Redis version, etc.
3. **Steps to Reproduce**: Detailed steps to reproduce the bug
4. **Expected vs. Actual Behavior**: What you expected vs. what happened
5. **Configuration**: Your configuration settings (redact sensitive info)
Please use the issue template when submitting a bug report.
### Suggesting Features
We welcome feature suggestions! Feature requests should include:
1. **Clear Description**: Describe the feature and its benefits
2. **Use Case**: Explain how it would be used
3. **Alternatives**: Any alternative solutions you've considered
### Contributing Code
1. **Fork the Repository**: Fork the project to your GitHub account
2. **Create a Branch**: Create a feature branch for your work
3. **Write Code**: Write your code, following our code style
4. **Write Tests**: Add tests for your changes
5. **Submit a Pull Request**: Submit a PR against the main branch
#### Development Environment Setup
For setting up the database, please refer to the following guides:
- **MySQL Setup**: [docs/setup-guide-mysql.md](docs/setup-guide-mysql.md)
- **PostgreSQL Setup**: [docs/setup-guide-postgres.md](docs/setup-guide-postgres.md)
```bash
# Clone your fork
git clone https://github.com/your-username/decision-engine.git
cd Decision Engine
# Add the upstream repository
git remote add upstream https://github.com/project-owner/decision-engine.git
# Create a branch
git checkout -b feature/your-feature-name
# Install development dependencies
cargo install cargo-watch cargo-insta cargo-audit
# Run tests
cargo test
# Run specific tests
cargo test routing_test
# Run with auto-reload for development
cargo watch -x run
```
## Code Style
We follow Rust's official style guidelines:
- Run `cargo fmt` before committing
- Run `cargo clippy` to catch common mistakes
- Aim for clear, idiomatic Rust code
- Document your public API with doc comments
## Commit Messages
- Use the imperative mood ("Add feature" not "Added feature")
- First line is a summary (50 chars or less)
- Include relevant issue numbers (e.g., "Fix #42: Add success rate validation")
- Be descriptive about what and why, not how
## Pull Request Process
1. Ensure your code passes all tests
2. Update documentation if needed
3. Update the CHANGELOG.md if appropriate
4. Ensure the PR description clearly describes the problem and solution
5. Include any issue numbers in the PR description
Your PR will be reviewed by maintainers who may request changes.
## Testing
- Write unit tests for new functionality
- Ensure all tests pass before submitting PRs
- Consider adding integration tests for complex features
## Documentation
- Update documentation for new features or changes
- Write clear, concise doc comments for public APIs
- Update examples if appropriate
## Release Process
Maintainers will handle the release process, which includes:
1. Updating version numbers
2. Creating changelog entries
3. Creating GitHub releases
4. Publishing to registries
## Getting Help
If you need help, you can:
- Open a discussion on GitHub
- Ask in our community chat
- Check the documentation
## Recognition
All contributors will be recognized in our README and CONTRIBUTORS file.
Thank you for contributing to Decision Engine!