- The culmination of a year dedicated to creating PharmaLab, an innovative web application addressing fragmented processes in pharmaceutical management.
- Fragmented processes and direct communication hinder efficiency in pharmaceutical product management.
- PharmaLab: A web application automating product management to centralize operations, improve efficiency, and enhance security.
- Secure user registration and login.
- Defined roles and permissions for pharmacies, laboratories, and administrators.
- User profile creation and management (contact information, address, etc.).
- Laboratories can submit information, including products and pricing.
- Comprehensive display of pharmaceutical products.
- Detailed product information (name, description, ingredients, price, etc.).
- Online ordering for pharmacies.
- Security: Ensuring confidentiality and data security.
- Ease of Use: Intuitive interface and user assistance.
- Performance: Meeting criteria for response time, throughput, and efficiency for optimal system performance.
These features are designed to enhance efficiency, security, and user experience in pharmaceutical product management within PharmaLab.
| Tool | Version | Description | Logo |
|---|---|---|---|
| Node.js (back) | 1.0.0 | Server-side JavaScript runtime |  |
| Express | 4.18.2 | Web application framework for Node.js |  |
| MongoDB | 8.0.0 | NoSQL database |  |
| JWT | 9.0.2 | JSON Web Token for authentication |  |
| Cypress | 13.6.1 | End-to-end testing framework |  |
| Bcrypt.js | 2.4.3 | Password hashing library | - |
| Tool | Version | Description | Logo |
|---|---|---|---|
| Angular (front) | 15.1.0 | TypeScript-based web application framework |  |
| PrimeNG | 15.1.1 | Angular UI component library |  |
| Font Awesome | 4.7.0 | Icon toolkit |  |
- Cypress Slow Down: 1.3.1 - Middleware to slow down responses during testing.
- PrimeFlex: 3.3.0 - A lightweight flexbox CSS utility library.
- PrimeIcons: 6.0.1 - Icon library for PrimeNG.
Follow these steps to set up and run the PharmaLab project locally:
git clone https://github.com/aziz-zina/PharmaLab.git
- Navigate to the Backend Directory:
cd PharmaLab/back
- Install Backend Dependencies:
npm install
- Configure Environment Variables:
- Create a .env file in the back directory.
- Set up necessary variables such as database connection details, JWT secret, etc.
- Run the Express Backend:
npm start
The Express backend should be running at http://localhost:your-backend-port.
- Navigate to the Frontend Directory:
cd PharmaLab/front
- Install Frontend Dependencies:
npm install
- Configure Angular Environment::
- Update configuration files (environment.ts and environment.prod.ts) with backend API URL, etc.
- Run the Angular Frontend:
ng serve --open
The Angular frontend should be running at http://localhost:4200.
Now, the PharmaLab project is cloned, and both the Express backend and Angular frontend are set up locally. Adjust the instructions based on your project structure and requirements.
Follow these steps to make the most of PharmaLab:
- Login: 🚪 Access your account securely.
- Dashboard Overview: 📊 Explore the key information on the dashboard.
- Profile Management: 👤 Update your contact information and address.
- Product Catalog: 📦 Browse through the comprehensive list of pharmaceutical products.
- Order Management: 🛒 Place online orders for products.
- Admin Features: 🛠️ Explore additional features if you have administrative privileges.
- Security: 🔒 Ensure data security and confidentiality.
- Performance Metrics: ⚙️ Check system performance metrics.
We welcome contributions to PharmaLab! Follow these guidelines to get started:
Follow the coding standards and conventions outlined in the CONTRIBUTING.md file.
Maintain code readability and consistency.
- Create a New Branch:
git checkout -b feature/your-feature-name
- Make Changes and Commit:
- Implement your changes and commit them.
git commit -m "Add feature: your-feature-name"
- Push Changes to Your Fork:
git push origin feature/your-feature-name
- Submit a Pull Request:
- Open a pull request against the
mainbranch on the PharmaLab GitHub repository.
- Review and Merge:
- The maintainers will review your pull request, provide feedback, and merge it once approved.
If you find any issues or have feature requests, please open an issue on the PharmaLab GitHub Issues page.
Thank you for contributing to PharmaLab! Your efforts help make this project better.
This project is licensed under the MIT License.
🚀 Feel free to use, modify, and distribute the codebase. Contributions are welcome!
I extend my sincere appreciation to the following tools, libraries, and resources that have been instrumental in shaping and enhancing this project:
- Node.js: The JavaScript runtime that powers the server-side of our application.
- Express.js: The fast, unopinionated, minimalist web framework for Node.js.
- Angular: The framework empowering the development of our dynamic frontend.
- MongoDB: The flexible and scalable NoSQL database that stores our data.
- GitHub: The platform that facilitates collaborative coding and version control.
- Cypress: The end-to-end testing framework ensuring the reliability of our application.
- PrimeNG: The UI component library for Angular that enhances the aesthetics and functionality of our user interface.
These tools and resources have played a crucial role in bringing our vision to fruition. We express our gratitude to the dedicated individuals behind these projects and the broader open-source community. 🙌
For any questions, issues, or collaboration inquiries related to PharmaLab, feel free to reach out to us:
- Email: [email protected]
- GitHub Issues: PharmaLab GitHub Issues
- Collaboration: We welcome contributions! Check out our Contribution Guidelines for details.
Connect with us and be a part of enhancing PharmaLab! We appreciate your feedback and contributions.