Merge pull request #10 from careagain-org/dev-code

Dev code

Author: careagain-org

.github/workflows/documentation.yaml

@@ -0,0 +1,24 @@
+name: deploy-docs
+
+on:
+  workflow_dispatch:
+
+jobs:
+  deploy-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install mkdocs mkdocs-material  # add other plugins or requirements here
+
+      - name: Deploy documentation
+        run: mkdocs gh-deploy --force

.gitignore

@@ -1,3 +1,4 @@
+.states
 .states/*
 *.pkl
 *.db
@@ -18,3 +19,5 @@ inventory.ini
 frontend.zip
 /.states
 *.pkl
+/site
+alembic/ac4f8682bd44_.py

Dockerfile

@@ -15,6 +15,10 @@ RUN apt-get update && apt-get install -y \
     && apt-get clean \
     && rm -rf /var/lib/apt/lists/*
 
+RUN DEBIAN_FRONTEND=noninteractive apt-get update && \
+    apt-get install -y xclip && \
+    rm -rf /var/lib/apt/lists/*
+
 # Install CA certs and dependencies
 RUN apt-get update && apt-get install -y --no-install-recommends \
     ca-certificates curl gnupg && \

README.md

@@ -1,69 +1,158 @@
-# Welcome to Reflex!
+# CareAgain WebApp
 
-This is the base Reflex template - installed when you run `reflex init`.
+**CareAgain WebApp** is a web application built using the [Reflex](https://reflex.dev/) framework.
+It serves as the frontend for CareAgain's platform, connecting institutions and organizations involved in medical devices—such as R&D, manufacturing, logistics, and hospitals—into a unified network to foster collaboration and innovation.
 
-If you want to use a different template, pass the `--template` flag to `reflex init`.
-For example, if you want a more basic starting point, you can run:
+## Table of Contents
 
-```bash
-reflex init --template blank
-```
+- [Features](#features)
+- [Project Structure](#project-structure)
+- [Getting Started](#getting-started)
+- [Development](#development)
+- [Testing](#testing)
+- [Deployment](#deployment)
+- [Contributing](#contributing)
+- [License](#license)
 
-## About this Template
+## Features
 
-This template has the following directory structure:
+- Modular and extensible architecture using Reflex.
+- Predefined components and templates for rapid development.
+- Dockerized setup for consistent development and deployment environments.
+- Integration-ready with backend services and databases.
+- Focused on fostering collaboration in the medical device ecosystem.
 
-```bash
+## Project Structure
+
+The project follows the standard Reflex template structure:
+
+```
 ├── README.md
-├── assets
+├── assets/
 ├── rxconfig.py
-└── {your_app}
-    ├── __init__.py
-    ├── components
-    │   ├── __init__.py
-    │   └── sidebar.py
-    ├── pages
-    │   ├── __init__.py
-    │   ├── dashboard.py
-    │   ├── index.py
-    │   └── settings.py
-    ├── styles.py
-    ├── templates
-    │   ├── __init__.py
-    │   └── template.py
-    └── {your_app}.py
+├── webapp/
+│   ├── __init__.py
+│   ├── components/
+│   │   ├── __init__.py
+│   │   └── sidebar.py
+│   ├── pages/
+│   │   ├── __init__.py
+│   │   ├── dashboard.py
+│   │   ├── index.py
+│   │   └── settings.py
+│   ├── styles.py
+│   ├── templates/
+│   │   ├── __init__.py
+│   │   └── template.py
+│   └── webapp.py
+├── tests/
+│   ├── __init__.py
+│   └── test_pages.py
+├── Dockerfile
+├── docker-compose.yaml
+├── requirements.txt
+├── requirements_manual.txt
+├── pyproject.toml
+├── alembic/
+├── alembic.ini
+├── devops/
+└── .github/workflows/
+```
+
+## Getting Started
+
+### Prerequisites
+
+- Python 3.8 or higher
+- Docker and Docker Compose (optional, for containerized setup)
+
+### Installation
+
+1. Clone the repository:
+
+   ```bash
+   git clone https://github.com/careagain-org/careagain-webapp.git
+   cd careagain-webapp
+   ```
+
+2. Install dependencies:
+
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+3. Run the application:
+
+   ```bash
+   reflex run
+   ```
+
+   The application will be accessible at `http://localhost:3000`.
+
+## Development
+
+- To add new pages, create a Python file in `webapp/pages/` and define a function with the `@template` decorator.
+- For reusable components, add them to `webapp/components/`.
+- Use `webapp/styles.py` for styling and theming.
+- Add tests in the `tests/` directory to ensure code quality.
+
+## Testing
+
+Run tests using `pytest`:
+
+```bash
+pytest tests/
 ```
 
-See the [Project Structure docs](https://reflex.dev/docs/getting-started/project-structure/) for more information on general Reflex project structure.
+Ensure all tests pass before submitting changes.
+
+## Deployment
+
+### Using Docker
+
+1. Build the Docker image:
+
+   ```bash
+   docker build -t careagain-webapp .
+   ```
+
+2. Run the Docker container:
+
+   ```bash
+   docker run -p 3000:3000 careagain-webapp
+   ```
+
+   The application will be accessible at `http://localhost:3000`.
+
+## Contributing
 
-### Adding Pages
+We welcome contributions from the community. To contribute:
 
-In this template, the pages in your app are defined in `{your_app}/pages/`.
-Each page is a function that returns a Reflex component.
-For example, to edit this page you can modify `{your_app}/pages/index.py`.
-See the [pages docs](https://reflex.dev/docs/pages/routes/) for more information on pages.
+1. Fork the repository.
+2. Create a new branch:
 
-In this template, instead of using `rx.add_page` or the `@rx.page` decorator,
-we use the `@template` decorator from `{your_app}/templates/template.py`.
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
 
-To add a new page:
+3. Make your changes and commit them:
 
-1. Add a new file in `{your_app}/pages/`. We recommend using one file per page, but you can also group pages in a single file.
-2. Add a new function with the `@template` decorator, which takes the same arguments as `@rx.page`.
-3. Import the page in your `{your_app}/pages/__init__.py` file and it will automatically be added to the app.
+   ```bash
+   git commit -m "Add your message here"
+   ```
 
+4. Push to your forked repository:
 
-### Adding Components
+   ```bash
+   git push origin feature/your-feature-name
+   ```
 
-In order to keep your code organized, we recommend putting components that are
-used across multiple pages in the `{your_app}/components/` directory.
+5. Open a pull request detailing your changes.
 
-In this template, we have a sidebar component in `{your_app}/components/sidebar.py`.
+## License
 
-### Adding State
+This project is licensed under the [APACHE 2.0](LICENSE).
 
-As your app grows, we recommend using [substates](https://reflex.dev/docs/substates/overview/)
-to organize your state.
+---
 
-You can either define substates in their own files, or if the state is
-specific to a page, you can define it in the page file itself.
+For more information on the Reflex framework, visit the [official documentation](https://reflex.dev/docs).

alembic.ini

@@ -49,6 +49,7 @@ prepend_sys_path = .
 # version_path_separator = :
 # version_path_separator = ;
 # version_path_separator = space
+# version_path_separator = newline
 version_path_separator = os  # Use os.pathsep. Default configuration used for new projects.
 
 # set to 'true' to search source files recursively
@@ -91,12 +92,12 @@ keys = console
 keys = generic
 
 [logger_root]
-level = WARN
+level = WARNING
 handlers = console
 qualname =
 
 [logger_sqlalchemy]
-level = WARN
+level = WARNING
 handlers =
 qualname = sqlalchemy.engine