|
| 1 | +# Records Management Odoo Module |
| 2 | + |
| 3 | +This repository contains a custom Odoo module named **Records Management** for Odoo 8.0. |
| 4 | +It is designed for use in a Dockerized development environment, such as GitHub Codespaces or VS Code Dev Containers. |
| 5 | + |
| 6 | +--- |
| 7 | + |
| 8 | +## Features |
| 9 | + |
| 10 | +- Custom models and views for managing records |
| 11 | +- Integration with Odoo stock and web modules |
| 12 | +- Demo data and scheduled actions for testing |
| 13 | +- Ready for deployment and further customization |
| 14 | + |
| 15 | +--- |
| 16 | + |
| 17 | +## Project Structure |
| 18 | + |
| 19 | +``` |
| 20 | +. |
| 21 | +├── records_management/ |
| 22 | +│ ├── __init__.py |
| 23 | +│ ├── __manifest__.py |
| 24 | +│ ├── models/ |
| 25 | +│ │ ├── __init__.py |
| 26 | +│ │ └── scrm_records_management.py |
| 27 | +│ ├── views/ |
| 28 | +│ │ ├── inventory_template.xml |
| 29 | +│ │ └── pickup_request.xml |
| 30 | +│ ├── security/ |
| 31 | +│ │ └── ir.model.access.csv |
| 32 | +│ └── (other module files) |
| 33 | +├── .devcontainer/ |
| 34 | +│ ├── devcontainer.json |
| 35 | +│ └── .vscode/ |
| 36 | +│ ├── launch.json |
| 37 | +│ └── settings.json |
| 38 | +├── docker-compose.yml |
| 39 | +└── README.md |
| 40 | +``` |
| 41 | + |
| 42 | +--- |
| 43 | + |
| 44 | +## Getting Started |
| 45 | + |
| 46 | +### Prerequisites |
| 47 | + |
| 48 | +- [Docker](https://www.docker.com/) installed (or use GitHub Codespaces) |
| 49 | +- (Optional) [VS Code](https://code.visualstudio.com/) with the Dev Containers extension |
| 50 | + |
| 51 | +### Running Odoo with Docker |
| 52 | + |
| 53 | +1. **Clone this repository:** |
| 54 | + ```sh |
| 55 | + git clone https://github.com/<your-username>/ssh-git-github.com-odoo-odoo.git-8.0.git |
| 56 | + cd ssh-git-github.com-odoo-odoo.git-8.0 |
| 57 | + ``` |
| 58 | + |
| 59 | +2. **Start Odoo and PostgreSQL using Docker Compose:** |
| 60 | + ```sh |
| 61 | + docker-compose up |
| 62 | + ``` |
| 63 | + |
| 64 | +3. **Access Odoo in your browser:** |
| 65 | + - Go to [http://localhost:8069](http://localhost:8069) (or use the forwarded port in Codespaces). |
| 66 | + |
| 67 | +4. **Create a new database:** |
| 68 | + - Master password: `admin` (default) |
| 69 | + - Choose a database name and admin password |
| 70 | + |
| 71 | +5. **Update the Apps list and install the module:** |
| 72 | + - Go to **Settings > Modules > Update Modules List** |
| 73 | + - Search for "Records Management" in the Apps menu and click **Install** |
| 74 | + |
| 75 | +--- |
| 76 | + |
| 77 | +## Development |
| 78 | + |
| 79 | +- All custom code is in the `records_management` module. |
| 80 | +- To make changes, edit the Python or XML files, then restart Odoo and update the module. |
| 81 | +- Use the Docker CLI (`docker`) in your dev container terminal to manage containers. |
| 82 | + |
| 83 | +--- |
| 84 | + |
| 85 | +## Troubleshooting |
| 86 | + |
| 87 | +- **Odoo not starting?** |
| 88 | + Check the logs in your terminal for errors. |
| 89 | +- **Module not visible?** |
| 90 | + Make sure you updated the Apps list and removed the "Apps" filter in the Apps menu. |
| 91 | +- **Port 8069 not accessible?** |
| 92 | + Ensure Docker is running and the port is not blocked by a firewall. |
| 93 | + |
| 94 | +--- |
| 95 | + |
| 96 | +## Contributing |
| 97 | + |
| 98 | +Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change. |
| 99 | + |
| 100 | +--- |
| 101 | + |
| 102 | +## License |
| 103 | + |
| 104 | +This project is licensed under the MIT License. |
| 105 | + |
| 106 | +--- |
| 107 | + |
| 108 | +## Credits |
| 109 | + |
| 110 | +- [Odoo S.A.](https://www.odoo.com/) for the Odoo framework |
| 111 | +- [Docker](https://www.docker.com/) for containerization |
| 112 | +- GitHub Codespaces and VS Code for the development environment |
| 113 | + |
| 114 | +--- |
| 115 | + |
| 116 | +*Happy |
0 commit comments