ia_dev/projects/README.md
Nicolas Cantu 07e0341c1d Initial commit: ia_dev pilot repo, agents and deploy scripts
**Motivations:**
- Provide a single repo for IA-driven piloting of all projects (agents, rules, deploy scripts).
- Reusable as git submodule; project-specific config in projects/ (no slug from submodule path).

**Evolutions:**
- Cursor agents: deploy-by-script, push-by-script, branch-align, fix, evol, fix-lint, fix-search, code, docupdate, gitea-issues-process, change-to-all-branches.
- Deploy scripts: pousse.sh (build_dirs from project config), bump-version.sh (version from project config), branch-align.sh, change-to-all-branches.sh.
- Project config schema in projects/README.md; lecoffreio.json as example.

**Pages affectées:**
- .cursor/agents/*.md, .cursor/rules/*.mdc, deploy/*.sh, projects/README.md, projects/lecoffreio.json, README.md, CLAUDE.md, config files.
2026-03-12 21:44:29 +01:00

39 lines
1.6 KiB
Markdown

# Project-specific configuration
This repo (`ia_dev`) is intended to be used as a **git submodule** inside each project. Project-specific parameters are stored here in `projects/<slug>.json`.
## Current project selection
- **`IA_PROJECT`** (environment variable), or
- **`.ia_project`** file at the repository root (one line: the project slug, e.g. `lecoffreio`). Do not use angle brackets in the file.
When running from a repo that has `ia_dev` as a submodule, the root is the parent repo; the script resolves `ia_dev` either as `./ia_dev` or `./deploy` (symlink to `ia_dev/deploy`).
## Schema
One JSON file per project in `projects/` named by the slug (e.g. `projects/lecoffreio.json`).
| Field | Required | Description |
|-------|----------|-------------|
| `name` | yes | Human-readable project name |
| `project_path` | no | Relative path to project from ia_dev (e.g. `../lecoffre_ng_test`); used when running from ia_dev standalone |
| `build_dirs` | no | List of directories (relative to repo root) where `npm run build` is run before push. If missing or empty, build check is skipped |
| `version` | no | Version/bump configuration |
| `version.package_json_paths` | no | List of paths (relative to repo root) to `package.json` files to update on bump |
| `version.splash_app_name` | no | App name used in splash message template |
| `mail` | no | Mail/imap bridge config |
| `git` | no | Git hosting: `wiki_url`, `ticketing_url`, `token_file` |
## Example (minimal)
```json
{
"name": "My App",
"build_dirs": ["backend", "frontend"]
}
```
## Example (full)
See `projects/lecoffreio.json`.