.. _user-guide:

Welcome to Malevich Nova
========================

What is it?
----------------------

Malevich Nova is a framework that simplifies working with graph databases by providing an abstraction layer called Resources. Resources represent subgraphs in your database, making it easy to:

- **Model complex relationships** between entities in your domain
- **Create deeply nested structures** in a single operation
- **Query related data** without writing complex graph traversals
- **Maintain consistency** with transactional operations
- **Build type-safe applications** with strong IDE support

If you're familiar with ORM libraries like SQLAlchemy or Django ORM, think of Nova as an "OGM+" (Object Graph Mapper) that gives you the same convenience for graph databases, but with a focus on subgraphs rather than individual nodes.

Core Concepts
--------------

Nova is built around these key concepts:

- **Resources**: Classes that define a subgraph structure, starting from a pivot node

Getting Started
----------------

To install Nova, follow the instructions in :doc:`user-guide/installation`.
The best way to learn Nova is to follow the guides below:

1. Start with :doc:`user-guide/resources/what-is-a-resource` to understand the fundamental building block
2. Then learn how to :doc:`user-guide/resources/creation` to create resources in your database
3. Explore the more advanced features as you build your application

As Nova develops, we'll add more guides covering new features and capabilities.

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   user-guide/index
   api/index

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`