# Development Instructions

**Date:** 2026-03-11T11:59:39Z

## Prerequisites

- Windows Server or Windows development environment
- IIS with Classic ASP enabled
- IIS URL Rewrite module
- Microsoft Access Database Engine for `.accdb` support
- Windows Script Host / `cscript`

## Setup

1. Copy the project to the target IIS host.
2. Point the IIS site root to `public/`.
3. Update `public/web.config`:
   - `ConnectionString`
   - `ErrorLogPath` if logging is desired
4. Ensure the Access database file path is valid for the environment.

## Common Development Tasks

### Generate a migration

```bat
cscript //nologo scripts\generateMigration.vbs create_my_table
```

### Generate POBO and repository

```bat
cscript //nologo scripts\GenerateRepo.vbs /table:my_table /pk:id
```

Move generated files into `app/models/` and `app/repositories/`.

### Generate a controller

```bat
cscript //nologo scripts\generateController.vbs MyController "Index;Show(id);Create;Store"
```

Move the generated controller into `app/controllers/`.

### Activate a controller

After generating a controller:

1. Include it from `app/controllers/autoload_controllers.asp`
2. Register it in `core/lib.ControllerRegistry.asp`
3. Add routes in `public/Default.asp`
4. Create corresponding views in `app/views/`

## Validation Approach

- Manual browser validation is required for runtime changes.
- Route/layout changes should be checked through IIS-hosted execution.
- Migration and generator changes should be validated with `cscript`.
