Contributing

Contributing

Contributions are welcome from the Frappe community.

How to Contribute

1. Fork the repository at https://github.com/navariltd/cams-biometric
2. Create a feature or fix branch from develop:

git checkout -b feat/my-feature develop

3. Follow Conventional Commits format for your commit messages:

• feat: add multi-device support
• fix: handle missing shift assignment gracefully
• docs: update installation steps for v15

4. Ensure pre-commit hooks pass before pushing:

pre-commit run --all-files

5. Write or update tests in test_cams_call.py
6. Open a Pull Request targeting develop, with a clear description of what the PR does
7. Await review from the maintainer (maniamartial)

Code Style

• Follow PEP 8 for Python
• Use FrappeTestCase for all tests
• Prefer real DB interactions in tests over heavy mocking
• All new features must include corresponding tests

Reporting Issues

Open a GitHub issue at https://github.com/navariltd/cams-biometric/issues. Include:

• Your Frappe/ERPNext/HRMS version
• App version
• Steps to reproduce
• Error log output (redact AuthTokens before sharing)