chore: scaffold src/guichetoi package, pyproject.toml, CI, PR/issue templates

- pyproject.toml: installable package with src/ layout, dev/ui extras
- src/guichetoi/__init__.py + src/guichetoi/api/__init__.py: namespace
- .github/workflows/ci.yml: ruff + mypy + pytest on PR and push to main
- .github/PULL_REQUEST_TEMPLATE.md: focused PR template with test plan
- .github/ISSUE_TEMPLATE/{bug_report,feature_request}.md
- CONTRIBUTING.md: layout, setup, branch strategy, sensitive-data rules

No file moves yet — that comes in the next two commits to keep blame
history easy to follow.

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,39 @@
+---
+name: Bug report
+about: Something is broken or behaves incorrectly
+title: "[bug] "
+labels: bug
+---
+
+## What happened
+
+<!-- One short paragraph. -->
+
+## How to reproduce
+
+```
+# minimal commands / inputs
+```
+
+## Expected vs actual
+
+- Expected:
+- Actual:
+
+## Environment
+
+- OS:
+- Python version:
+- Branch / commit:
+- Running via: [ ] CLI  [ ] Streamlit demo  [ ] FastAPI  [ ] Docker
+
+## Logs / traceback
+
+<details>
+<summary>traceback</summary>
+
+```
+paste here
+```
+
+</details>

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Propose a new capability or improvement
+title: "[feat] "
+labels: enhancement
+---
+
+## Problem
+
+<!-- What user need or workflow gap motivates this? -->
+
+## Proposed solution
+
+<!-- One paragraph. -->
+
+## Alternatives considered
+
+<!-- Optional. -->
+
+## Impact
+
+- Who benefits:
+- What changes for existing users:

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,24 @@
+<!-- Keep PRs focused: one logical change per PR. Branch off `main`. -->
+
+## Summary
+
+<!-- 1-3 sentences. What does this PR do and why. -->
+
+## Changes
+
+<!-- Bullet list of the key changes. File paths welcome. -->
+- 
+
+## Test plan
+
+<!-- How did you verify it works? Tick what applies. -->
+- [ ] `pytest -q` passes locally
+- [ ] Streamlit demo still loads (`make demo`)
+- [ ] FastAPI service starts and `/health` returns `pipeline_loaded: true`
+- [ ] Docker image builds (`docker build -t guichetoi-ml .`)
+- [ ] No new files contain customer PII
+
+## Risk
+
+<!-- Anything reviewers should look at extra carefully? -->
+- 

.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+# Cancel an in-flight run on the same branch when a newer push lands
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint (ruff + mypy)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: pip
+      - name: Install lint tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff mypy
+      - name: Ruff
+        run: ruff check src/ tests/
+      - name: Mypy (library only)
+        run: mypy --config-file mypy.ini src/guichetoi/cms.py src/guichetoi/recommendation.py
+
+  test:
+    name: Tests (pytest)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: pip
+      - name: System deps (tesseract-fra)
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y --no-install-recommends \
+            tesseract-ocr tesseract-ocr-fra libgl1 libglib2.0-0
+      - name: Install package
+        # `-e .` installs the package; `requirements.txt` pins exact versions
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Pytest
+        run: pytest -q

CONTRIBUTING.md

@@ -0,0 +1,69 @@
+# Contributing
+
+## Repo layout
+
+```
+src/guichetoi/      Library (importable as `guichetoi.…`)
+  inference.py      LayoutLMv3 classifier + extractor pipeline
+  recommendation.py Rule engine that verdicts demande complétude
+  cms.py            Pre-fill CMS IMMO 9 BANBOU xlsx from a Verdict
+  api/main.py       FastAPI service wrapping all of the above
+
+scripts/            Training pipeline + batch utilities (CLIs)
+apps/               UI applications (Streamlit demo)
+tools/              One-off dev / debug scripts
+tests/              Pytest suite
+assets/             Templates, logos, non-data static files
+data/               label_mappings.json (other data dirs are gitignored)
+docs/               Internal markdown docs
+.github/            CI workflow + PR/issue templates
+```
+
+## Local setup
+
+```bash
+python -m venv .venv
+source .venv/bin/activate   # or: .venv\Scripts\activate on Windows
+pip install -e ".[dev,ui]"
+pip install -r requirements.txt   # exact pins (optional; for reproducibility)
+```
+
+External requirement: **Tesseract OCR with the French language pack**
+must be on `PATH` for inference to work.
+
+## Branch strategy
+
+GitHub Flow:
+
+- `main` is always deployable. Protected: requires PR + green CI to merge.
+- One topic branch per work unit. Naming:
+  - `feature/<short-slug>` — new capability
+  - `fix/<short-slug>` — bug fix
+  - `chore/<short-slug>` — refactor, infra, deps
+  - `docs/<short-slug>` — docs only
+- Squash-merge into `main`. Delete the branch after merge.
+
+## Workflow
+
+```bash
+git checkout main && git pull
+git checkout -b feature/my-thing
+# … edits …
+pytest -q                # local sanity check
+ruff check src/ tests/   # lint
+mypy --config-file mypy.ini src/guichetoi/cms.py src/guichetoi/recommendation.py
+git push -u origin feature/my-thing
+gh pr create             # or open via github.com
+```
+
+CI runs lint + tests on every PR. Both must be green to merge.
+
+## What never goes in git
+
+- Customer documents (`DataSet1/`, `DataSet2/`, `DataRef/`)
+- Real extracted PII (`assets/sample_verdicts.json`)
+- Model weights (`models/`)
+- Label Studio raw exports (`project-*-at-*.json`)
+
+`.gitignore` enforces these — when in doubt, check `git status` before
+committing and never use `git add -f` to override an ignore rule.

pyproject.toml

@@ -0,0 +1,82 @@
+# ──────────────────────────────────────────────────────────────────────────
+# GuichetOI ML — Python project metadata
+# ──────────────────────────────────────────────────────────────────────────
+# Install for development:
+#     pip install -e .[dev]
+#
+# Install runtime only:
+#     pip install -e .
+#     # then: pip install -r requirements.txt   (for exact pins)
+#
+# `requirements.txt` remains the source of truth for fully-pinned versions
+# used in CI and the Dockerfile. `pyproject.toml` declares loose runtime
+# bounds so the library is `pip install`-friendly.
+# ──────────────────────────────────────────────────────────────────────────
+
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name            = "guichetoi"
+version         = "1.0.0"
+description     = "Inference + recommendation + CMS generation for Orange Guichet Accueil Infrastructures (demande de localisation PAR)."
+readme          = "README.md"
+requires-python = ">=3.11"
+license         = { text = "MIT" }
+authors         = [{ name = "Aziz Mohamed Miladi", email = "medazizmiledi@ieee.org" }]
+keywords        = ["layoutlmv3", "document-ai", "ocr", "fiber", "orange"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: Microsoft :: Windows",
+    "License :: OSI Approved :: MIT License",
+]
+dependencies = [
+    "torch>=2.0",
+    "transformers>=4.35",
+    "tokenizers>=0.20",
+    "safetensors>=0.4",
+    "pytesseract>=0.3.10",
+    "PyMuPDF>=1.24",
+    "pillow>=10.0",
+    "openpyxl>=3.1",
+    "fastapi>=0.110",
+    "uvicorn[standard]>=0.30",
+    "python-multipart>=0.0.9",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "ruff>=0.6",
+    "mypy>=1.10",
+]
+ui  = ["streamlit>=1.30", "altair>=5.0"]
+
+[project.urls]
+Homepage = "https://github.com/MedAziz012/GuichetOI_ML"
+Issues   = "https://github.com/MedAziz012/GuichetOI_ML/issues"
+
+# ──────────────────────────────────────────────────────────────────────────
+# Packaging — src/ layout
+# ──────────────────────────────────────────────────────────────────────────
+[tool.setuptools.packages.find]
+where = ["src"]
+
+# ──────────────────────────────────────────────────────────────────────────
+# Ruff — linting
+# ──────────────────────────────────────────────────────────────────────────
+[tool.ruff]
+line-length    = 100
+target-version = "py311"
+extend-exclude = ["scripts", "tools", "apps"]   # legacy scripts, not lib code
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP"]
+ignore = [
+    "E501",  # line length — codebase has long French strings
+    "B008",  # function-call-in-default-arg — used intentionally with FastAPI Depends/File
+]

src/guichetoi/__init__.py

@@ -0,0 +1,10 @@
+"""
+GuichetOI — document AI for Orange's Guichet Accueil Infrastructures.
+
+Sub-modules:
+  guichetoi.inference        LayoutLMv3 classifier + extractor pipeline
+  guichetoi.recommendation   Rule engine that verdicts demande complétude
+  guichetoi.cms              Pre-fill CMS IMMO 9 BANBOU xlsx from a Verdict
+  guichetoi.api.main         FastAPI service wrapping the above
+"""
+__version__ = "1.0.0"