add readme.md file

README.md

@@ -0,0 +1,90 @@
+# Bank Statement Reconciliation Module
+
+## Overview
+This Odoo 17 module enhances the bank reconciliation process by providing a streamlined interface for matching bank statement lines with journal entries. The module allows users to select multiple bank lines and reconcile them with existing journal entries, with enhanced filtering capabilities to hide already reconciled lines.
+
+## Features
+
+### 1. Bank Statement Line Management
+- Dedicated menu for accessing bank statement lines
+- Journal selection wizard to filter lines by bank journal
+- Multi-line selection for batch reconciliation
+
+### 2. Enhanced Reconciliation Process
+- Wizard-based interface for selecting journal entries to reconcile with
+- Individual line processing for precise control
+- Automatic journal entry creation for reconciliation transactions
+
+### 3. Smart Filtering
+- "Hide Reconciled" filter to focus on unreconciled lines
+- Computed `is_reconciled` field for accurate status tracking
+- Toggle between filtered and unfiltered views
+
+### 4. Visual Indicators
+- Color-coded lines for negative amounts (red danger decoration)
+- Clean interface without visual muting of reconciled lines
+- Consistent styling with Odoo's standard UI patterns
+
+## Installation
+
+1. Copy the `bank_statement_reconciliation` folder to your Odoo addons directory
+2. Update the apps list in Odoo
+3. Search for "Bank Statement Reconciliation" in the Apps menu
+4. Install the module
+
+## Configuration
+No additional configuration is required after installation. The module works with standard Odoo accounting settings.
+
+## Usage
+
+### Accessing Bank Statement Lines
+1. Navigate to Accounting > Bank Reconciliation > Bank Statement Lines
+2. Select a bank journal using the wizard
+3. View the bank statement lines for the selected journal
+
+### Reconciling Bank Lines
+1. Select one or more bank lines from the list view
+2. Click "Action" and select "Reconcile Selected Lines"
+3. In the wizard, select the journal entry to reconcile with
+4. Choose the specific journal entry line
+5. Click "Reconcile" to complete the process
+
+### Filtering Reconciled Lines
+1. Click the "Filters" button in the search bar
+2. Select "Hide Reconciled" to show only unreconciled lines
+3. To show all lines again, select "Show All" or remove the filter
+
+## Technical Details
+
+### Computed Fields
+- `is_reconciled`: Boolean field that computes reconciliation status based on the presence of "Reconciliation:" in linked journal entry names
+
+### Search Filters
+- "Hide Reconciled": `domain="[('is_reconciled', '=', False)]"`
+- "Show All": `domain="[]"`
+
+### Dependencies
+- `account`: Standard Odoo accounting module
+- `base`: Standard Odoo base module
+
+## Troubleshooting
+
+### Common Issues
+1. **Lines not hiding when filter applied**: Ensure the `is_reconciled` computed field is properly stored in the database
+2. **Reconciliation errors**: Verify that journal entries have proper account mappings
+3. **Performance issues**: For large datasets, use the filter to reduce the number of displayed lines
+
+### Support
+For issues or feature requests, please contact your Odoo administrator or module developer.
+
+## Version
+1.0.0 - Initial release for Odoo 17
+
+## License
+This module is released under the Odoo Enterprise License.
+
+## Author
+Custom Development Team
+
+## Credits
+Developed for Odoo 17 accounting enhancements.