make app database

README.md

@@ -6,7 +6,7 @@ Each loan is assigned an immutable published workflow configuration when it is c
 
 ## Project status
 
-The repository is currently in the **blueprint and scaffolding phase**. The Laravel application skeleton and project documentation exist, but the BankFlow models, API routes, workflow engine, PostgreSQL schema, admin configuration endpoints, and Docker image have not yet been implemented.
+The repository is currently under implementation. The domain enums, Eloquent models, factories, database schema, and local development seeder are implemented. The API routes, workflow engine, admin configuration endpoints, and Docker image have not yet been implemented.
 
 The approved implementation plan is documented in [Project Blueprint](docs/project-blueprint.md).
 
@@ -180,12 +180,23 @@ DB_USERNAME=postgres
 DB_PASSWORD=
 ```
 
-After the BankFlow migrations and seeders are implemented, initialize the database with:
+Initialize the database and load development sample data with:
 
 ```bash
 php artisan migrate --seed
 ```
 
+`DatabaseSeeder` runs `BankFlowDevelopmentSeeder` only in the local environment. It creates:
+
+- an admin user (`admin@bankflow.test` / `password`);
+- `PERSONAL` and `BUSINESS` loan types;
+- all supported stage definitions;
+- one published workflow per loan type with configured rules;
+- submitted, approved, rejected, and manual-review loan examples;
+- processing histories linked to the exact workflow steps used.
+
+For a clean development rebuild, use `php artisan migrate:fresh --seed`. This command deletes all existing database data.
+
 Build frontend assets when required:
 
 ```bash