Skip to content

Commit 7948a1a

Browse files
Create README.md
1 parent 8250392 commit 7948a1a

File tree

1 file changed

+116
-0
lines changed

1 file changed

+116
-0
lines changed

README.md

Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
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

Comments
 (0)