# Blueprint App

The `_blueprint` app is a template app used by `suit_model` to generate CRUD code for your models.

## How it works

`suit_model` reads Python source files from `apps/_blueprint/` and applies string replacements (model name, field names, URL names) to produce working CRUD code for your model.

## Included Blueprints

| Blueprint | Purpose | FK support |
|-----------|---------|------------|
| `_blueprint_table.html` | Table layout for simple models | No |
| `_blueprint_table_child.html` | Table layout for models with a ForeignKey | Yes |
| `_blueprint_cards.html` | Card layout for simple models | No |
| `_blueprint_cards_child.html` | Card layout for models with a ForeignKey | Yes |
| `views/table.py` | Table View class (CBV) | No |
| `views/cards.py` | Cards View class (CBV) | No |
| `views/table_child.py` | Table View with FK context handling | Yes |
| `views/cards_child.py` | Cards View with FK context handling | Yes |
| `forms.py` | ModelForm for simple models | No |
| `forms_child.py` | ModelForm including FK field | Yes |
| `serializers.py` | DRF ModelSerializer | Both |
| `factories.py` | Factory Boy factory | Both |
| `tests/test_table.py` | Test suite for table layout | No |
| `tests/test_cards.py` | Test suite for cards layout | No |
| `tests/test_table_child.py` | Test suite for table with FK | Yes |
| `tests/test_cards_child.py` | Test suite for cards with FK | Yes |
| `migrations/0001_initial.py` | Initial migration with both `BlueprintSimpleModel` and `BlueprintChildModel` | - |

## Browsing the Blueprint App

After running the project, these URLs let you see the blueprint views working live:

```
http://localhost:8000/blueprint/table/
http://localhost:8000/blueprint/cards/
```

## Customizing Blueprints

You can modify any file in `apps/_blueprint/` to change how `suit_model` generates code for all future models. The blueprint files use placeholder identifiers like:

- `BlueprintSimpleModel` → replaced with your model name
- `['name', 'description']` → replaced with your model's field list
- `_blueprint:table` → replaced with your app's URL name