Morpheus

Morpheus is a full-stack groundwater modeling and decision support system (DSS).

Project Structure

• Backend: Python-based REST API (FastAPI/Flask), event-sourced domain logic, and Celery task queue.
• Frontend: React/TypeScript applications for modeling, visualization, and utilities.
• Infrastructure: Docker-based local and production environment configurations.
• Keycloak: Identity and access management configuration.

Getting Started

1. Prerequisites: Check the main README for requirements (Docker, Python, Node.js, etc.).
2. Setup: Run make install-local from the root.
3. Development:
   • Start backend: cd src/backend && make start-dev
   • Start frontend: cd src/frontend && make start-morpheus-integration-local

Development Workflow

• Backend: Follow the Backend README for running the Flask/FastAPI app and tests.
• Frontend: Follow the Frontend README for development and building.
• Infrastructure: See the Infrastructure README for Docker and environment details.

Contributors

Please follow the established patterns in the codebase. For architectural decisions, refer to the concepts/ directory.