Current tenant acceptance — Checkpoint474: **156 DONE /164 (95.1%),1PARTIAL,0MISSING,7BLOCKED**. Native access9, native control5 and real two-customer/React/lifecycle/export-restore acceptance passed. Source milestone reached; check release evidence before claiming the public runtime/manual is updated. Market feature parity is a separate backlog.

Current verified continuation (2026-11-07): **124 DONE / 164 (75.6%), 28 PARTIAL, 2 MISSING, 10 BLOCKED**. Checkpoint 465 established the deployed 75% baseline; BE-136 now also passes native and authenticated React acceptance. The active target is at least 80%: 132 DONE (80.5%).

Previous latest implementation Checkpoint 337 advanced BE-003 scalability: configured CRM trade/category matching uses a company-scoped normalized Odoo relation and PostgreSQL composite index. Clean-install native tests passed 2/2, live React→BFF→Odoo acceptance passed 1/1, and upgrade/backfill passed on a disposable clone. Local demo rollout to `be_tender` .6 and bridge .42 followed a verified backup; health checks passed with no shared business-row changes. BE-003 remains PARTIAL pending full Owner/company acceptance, production-scale benchmark and official tender feeds. Totals were **19 DONE, 133 PARTIAL, 2 MISSING, 10 BLOCKED / 164**. See [Checkpoint 337](build-engine/CHECKPOINT_337.md), [migration QA](build-engine/CRM_CODE_INDEX_UPGRADE_QA.json), [live QA](build-engine/CRM_SCOUTING_LIVE_QA.json) and [native QA](build-engine/CRM_SCOUTING_NATIVE_QA.json).

Previous implementation Checkpoint 324 established native own-timesheet role inheritance; Checkpoint 352 now completes BE-089 against its supplied criteria. See [Checkpoint 324](build-engine/CHECKPOINT_324.md), [Checkpoint 351](build-engine/CHECKPOINT_351.md), [role QA](build-engine/TIMESHEET_ROLE_QA.json), [general-user live QA](build-engine/TIMESHEET_LIVE_QA.json), and [HR Officer live QA](build-engine/TIMESHEET_HR_LIVE_QA.json).

Latest implementation Checkpoint 323 adds permission-aware internal qualification counts to the React supplier directory (BE-059). See [Checkpoint 323](build-engine/CHECKPOINT_323.md) and [native QA](build-engine/SUPPLIER_QUALIFICATION_NATIVE_QA.json).

# Build Engine requirements traceability

## Supplemental capability outside the supplied 164 stories

Project employee expenses were identified in the Pragtech package comparison as a gap beside project timesheets and cost tracking. An original implementation exists in `odoo/addons/be/be_project_expense`, exposed to React through `frontend/src/ProjectExpensesWorkspace.jsx` and authenticated BFF routes `/api/project-expenses`. It is **not** counted as a supplied BRS story and does not change the story totals. Status: **PARTIAL / not acceptance-verified**. Native `hr_expense` and `be_project_expense` are installed in `namaa_ksa`. Per the user's request, admin is linked to synthetic employee `Demo Expense Employee (Administrator)`; the React capability now returns true and options include 2 projects and 6 expense categories. This record is for demo use, not a real HR identity. Native role/company acceptance, receipt evidence and full reimbursement acceptance remain outstanding. The current code covers retry-safe draft creation, project analytic distribution and native submit; design-preview records remain clearly synthetic.

Latest implementation Checkpoint 344 improves BE-069's visible site-location audit metadata: React now displays creator and creation timestamp together; mocked browser 1/1 and production build passed. A fresh live rerun was blocked before test execution by a legacy `be_tender` registry/index error on missing `be_crm_lead_code`; its disposable clone was dropped. BE-069 stays PARTIAL pending live timestamp confirmation and broader acceptance. Totals remain 19 DONE, 133 PARTIAL, 2 MISSING, 10 BLOCKED / 164. See [Checkpoint 344](build-engine/CHECKPOINT_344.md) and [recheck output](build-engine/SITE_LOCATION_WAREHOUSE_LIVE_QA.json).

Previous implementation Checkpoint 343 extends the React customer master with standard Odoo billing-address fields (street, second line, city, postal code), current-company address search, and revision-checked updates. Isolated native Odoo QA passed 2/2 on a disposable clone; backend customer tests 9/9, React unit 90/90, customer browser journey 1/1, and production build passed. The clone was dropped and `namaa_ksa` remained unchanged. This extension does not change the 164-story classifications or claim National Address verification/geocoding. See [Checkpoint 343](build-engine/CHECKPOINT_343.md) and [QA](build-engine/CUSTOMER_ADDRESS_QA.json).

Latest implementation Checkpoint 337 advances BE-003 scalability: configured code matching uses a company-scoped normalized Odoo relation and PostgreSQL composite index rather than scanning all authorized CRM leads in Python. Direct index access is company-scoped. Clean-install native tests passed 2/2, live React → BFF → disposable Odoo acceptance passed 1/1, and upgrade/backfill QA passed on a clone of `namaa_ksa`. Local demo rollout to `be_tender` .6 and bridge .42 followed a verified backup; services are healthy and no shared business rows changed. BE-003 remains PARTIAL pending full Owner/company acceptance, production-scale benchmark and official tender feeds. Totals remain **19 DONE, 133 PARTIAL, 2 MISSING, 10 BLOCKED / 164**. See [Checkpoint 337](build-engine/CHECKPOINT_337.md), [migration QA](build-engine/CRM_CODE_INDEX_UPGRADE_QA.json), [live QA](build-engine/CRM_SCOUTING_LIVE_QA.json), and [native QA](build-engine/CRM_SCOUTING_NATIVE_QA.json).

Latest implementation Checkpoint 321 advances BE-160: the React payment register identifies transfers, includes readable same-company paired-leg details, searches the counterpart reference, and does not offer one-leg cancel/reversal. Native Odoo QA passed 8/8 on a disposable clone (dropped; shared database unchanged), the React paired-transfer browser journey passed 1/1, and the production build passed. Two-leg reversal remains gated by DEC-27; BE-160 remains PARTIAL. Totals are unchanged at **19 DONE, 132 PARTIAL, 3 MISSING, 10 BLOCKED / 164**. See [Checkpoint 321](build-engine/CHECKPOINT_321.md) and [native QA](build-engine/ACCOUNTING_PAYMENTS_REGISTER_QA.json).

Latest implementation Checkpoint 320 completes BE-019. The Owner configured and reopened the company mandate in React; Odoo persisted allowed native `utm.source` IDs, displayed company/actor/time, and filtered candidate search. An isolated live React → BFF → Qwen → Odoo run assessed only the permitted lead, showed a cited pending draft with uncertainty, then recorded a separate human decision and audit event. Forged company writes, unauthorized readers and foreign-company candidate leakage were denied or excluded. Clean-install native, mandate live, and AI/human-review live journeys each passed 1/1; backend focused tests passed 2/2 with 10 validation subtests; React 89/89 and the production build passed. The local demo received only the additive schema and matching app code; no shared business records were written. Totals are **19 DONE, 132 PARTIAL, 3 MISSING, 10 BLOCKED / 164** (11.6% acceptance-verified). See [Checkpoint 320](build-engine/CHECKPOINT_320.md) and its [native](build-engine/CRM_SCOUTING_NATIVE_QA.json), [mandate live](build-engine/CRM_SCOUTING_LIVE_QA.json) and [AI live](build-engine/CRM_SCOUTING_AI_LIVE_QA.json) evidence.

Latest implementation Checkpoint 312 adds a React workflow for applying one payment across 2–30 selected open invoices/bills for one partner through Odoo’s grouped native payment wizard. Odoo rechecks user access, current company, partner, direction, SAR currency, open balances and journal; row locks, a bounded amount and operation idempotency protect the write. The live isolated React→BFF→Odoo journey applied SAR 450 across two invoices and returned their updated balances. Native Odoo suite 3/3; targeted BFF tests 4/4; React units 85/85; payment browser journeys 3/3; production build passed. Clones and temporary BFF were removed; `namaa_ksa` remained unchanged. BE-160 remains PARTIAL: pooled amounts follow Odoo’s native application order; exact per-invoice amount entry, reversals, full AR/AP lifecycle, broader acceptance and accountant UAT remain. Counts: **18 DONE, 133 PARTIAL, 3 MISSING, 10 BLOCKED** of 164. See [Checkpoint 313](build-engine/CHECKPOINT_313.md)<br>[Checkpoint 312](build-engine/CHECKPOINT_312.md) and [live QA](build-engine/ACCOUNTING_DOCUMENT_PAYMENT_LIVE_QA.json).

Previous implementation Checkpoint 309 adds scheduled daily/weekly in-app digest deliveries to the bilingual React notification center. Odoo snapshots items per user/company, generates at 08:00 local time, avoids duplicate runs, rechecks current item access, and records read state/actor/time. Owners configure all 18 role/topic preferences with audit and revision protection. Isolated Odoo QA passed 2/2, backend 211, React unit 85/85, browser 1/1 and production build passed. Clone and temporary OCA addon removed; shared `namaa_ksa` unchanged. BE-163 remains PARTIAL: email/SMS/push delivery, full role/company acceptance and runtime rollout remain. The shared database does not have `be_dashboard` installed and the current runtime lacks `report_xlsx`, so this capability is not yet live. Counts were **18 DONE, 132 PARTIAL, 4 MISSING, 10 BLOCKED**. See [Checkpoint 309](build-engine/CHECKPOINT_309.md) and [isolated QA](build-engine/NOTIFICATIONS_QA.json).

Previous implementation Checkpoint 307 added React project attendance submission and separate HR review with immutable decision events. Isolated Odoo QA passed 4/4, backend 209/209, React unit 85/85, attendance Playwright 2/2 and production build passed. Clone dropped; shared `namaa_ksa` unchanged. BE-090 remains PARTIAL pending official HR attendance/payroll reconciliation, employee and shift assignment, live role/company acceptance and complete A1–A4. See [Checkpoint 307](build-engine/CHECKPOINT_307.md) and [isolated QA](build-engine/SITE_ATTENDANCE_QA.json).

Historical implementation checkpoint 282: **18 DONE, 124 PARTIAL, 12 MISSING, 10 BLOCKED** of 164 stories (11.0%, 75.6%, 7.3%, 6.1%). These are classifications, not a weighted completion percentage. The latest slice extends BE-132 React archive export with attached issued and superseded project drawing revisions, their manifest metadata and SHA-256 checksums; draft drawings are excluded. Focused Odoo lifecycle/security and authenticated React→BFF→Odoo QA each passed 1/1 on an isolated clone; reader and foreign-company probes were denied. Shared `namaa_ksa` was unchanged. Submitted submittal/DMS files, knowledge items, broader role/company coverage and full A1–A4 remain open. See [Checkpoint 282](build-engine/CHECKPOINT_282.md) and [live evidence](build-engine/PROJECT_ARCHIVE_EXPORT_LIVE_QA.json).


Checkpoint42 adds supplier-reference capture and an exact duplicate guard to the BE-079 vendor-bill draft workflow. The story remains PARTIAL; see [test evidence](TEST_RESULTS.md).


## Native feature increment under QA — 2026-10-24

Equipment custody (BE-094/095), submittal revisions/decisions (BE-111/112), owner dashboard risk/finance drilldowns (BE-158–162), and confirmed BOQ links on native quote lines are implemented in existing Odoo addons. The latest fresh isolated Odoo 20 run passed 170 tests with zero failures/errors and one optional helpdesk skip, including these modules. Live Namaa React register/dashboard reads were also verified after the user-authorized synthetic seed. See [checkpoint54](build-engine/CHECKPOINT_54.md), [implementation status](IMPLEMENTATION_STATUS.md) and [test evidence](TEST_RESULTS.md). They remain PARTIAL pending full story acceptance; counts below are not changed by coding/test count alone.

### CRM duplicate review — checkpoint40

BE-011 now has a same-company, permission-checked review flow in the React CRM detail. It suggests likely opportunity matches using Odoo CRM's native matching and organization matches by normalized VAT or organization email; it returns no contact email, phone, or VAT values. React links each candidate to its native Odoo record and never merges automatically. Isolated checks: 11 Odoo bridge tests, 33 backend tests, 34 React unit tests, 46 Playwright cases, and the production build passed. The story remains PARTIAL: expose the native merge workflow with explicit review/audit, document false-positive policy, and verify complete user/company permissions. Evidence: [checkpoint40](build-engine/CHECKPOINT_40.md) and [test results](TEST_RESULTS.md).

### CRM duplicate merge — checkpoint41

React now requires a separate confirmation before merging selected opportunity or organization candidates. Odoo rechecks matching, current company, record ACLs, native merge-wizard group access, and each selected record's `write_date` under row locks. Opportunity merging delegates to native CRM merge and retains Odoo's merge chatter; organization merging delegates to the native contact merge implementation inside the request transaction and posts a note on the surviving organization. Contact merges require the native partner-manager ACL. Fresh isolated QA passed 15 Odoo bridge tests, 36 backend tests, 34 React unit tests, 48 Playwright cases, and the production build. BE-011 remains PARTIAL pending an accepted false-positive/master-record policy and end-to-end acceptance under real customer roles/companies. See [checkpoint41](build-engine/CHECKPOINT_41.md) and [test results](TEST_RESULTS.md).

Audit baseline: 2026-10-23, Git `5b3f3f7`. Source: [164-story JSON snapshot](requirements/Build_Engine_Stories.json), supplied DOCX/PDF in `/home/aymen/Downloads/odoo20documentation`; provenance/hashes in [inventory](audit/REPOSITORY_INVENTORY.json). DOCX and PDF each contain the same 164 story IDs. Original 23-page BRD is not supplied; BRD links below refer to [repository summary](build-engine/BRD_SUMMARY.md), not a separately verified original BRD.

## Frontend design Phase 1 follow-up (2026-10-23)

User-authorized light/emerald/gold redesign delivered the existing shell, login, overview and recent-record search with Arabic-first/English labels. New relevant evidence: [Dashboard.jsx](../frontend/src/Dashboard.jsx), [WorkspaceSearch.jsx](../frontend/src/WorkspaceSearch.jsx), [dashboard tests](../frontend/tests/dashboard.test.js), [browser regressions](../frontend/e2e/workspace.spec.js) and [design-phase report](build-engine/FRONTEND_PHASES.md). The 19 unit/10 browser tests verify bounded frontend behavior with sample/mocked data. BE-004/007/158–164 retain PARTIAL: tenant document branding, full translations/timezone preferences, construction reporting and real-role acceptance remain incomplete. No row is promoted to DONE.

## Frontend design Phase 2 follow-up (2026-10-23)

CRM, Sales, Purchase and Accounting registers/editors/details/reviews now have bilingual UI, filtering and validated draft forms. Relevant evidence: [business helpers/tests](../frontend/tests/business.test.js), [business browser scenarios](../frontend/e2e/business.spec.js), [BFF error transport tests](../frontend/tests/workspaceApi.test.js) and [CHECKPOINT 32](build-engine/CHECKPOINT_32.md). The full frontend suite passed 27 unit and 26 browser tests with samples/mocked HTTP; live Odoo role/tenant/financial acceptance was not run. BE-007/009/061/065/079 gain scoped frontend evidence but retain PARTIAL. No story is promoted to DONE.

## Frontend design Phase 3 / demo follow-up (2026-10-23)

AI specialist/history/review and task/activity screens now have bilingual presentation and bounded tests: [productivity unit tests](../frontend/tests/productivity.test.js), [browser scenarios](../frontend/e2e/productivity.spec.js). The full frontend suite passed 32 unit/ 39 browser tests and existing backend tests passed 19. An authenticated synthetic dashboard-agent smoke returned READY without business documents; it does not validate specialized agents or real-role/business mutation acceptance.

The [67-image HTML manual](../frontend/public/user-manual.html), [demo brief](build-engine/DEMO_READINESS.md) and [exact classification percentages](build-engine/BRS_PROGRESS.md) document scope. BE-007 gains AI/task translation evidence but still lacks timezone/full acceptance; BE-038/156 gain existing-runtime review evidence without becoming complete BRD sales/feedback workflows. No story is promoted to DONE: 2 DONE, 105 PARTIAL, 47 MISSING, 10 BLOCKED.

## Checkpoint34 QA follow-up (2026-10-23)

No classification changed. [Checkpoint34](build-engine/CHECKPOINT_34.md) adds119 reported native tests (zero failures/errors, one optional skip),17 genuine Odoo views and an 84-image offline manual. BE-130 now rejects caller tenant overrides through `core/security.authenticated_tenant`; [adversarial API tests](../services/platform/tests/test_tenant_boundary.py) pass. Production identity, Odoo credential binding and project ACL acceptance remain open. BE-142 gains native positive finite quantity/project/company/BOQ/UOM validation and rejected-write tests in `be_site`; PWA collection and end-to-end sync remain incomplete. The Owl3 AI toolbar fix is verified in a real browser; native chat remains a placeholder.

## Checkpoint35 native delivery — historical acceptance (2026-10-24)

BE-109 and BE-110 had their original acceptance verified in native Odoo at checkpoint35. Following the React-first decision in [ADR0014](adr/0014-react-as-end-user-application.md), React RFI workflows were subsequently implemented. Checkpoint188 verifies an ordinary-role React → BFF → Odoo journey on an isolated clone. The shared tenant was not changed, so deployment and broader company/portal acceptance remain open. The original 164-story JSON remains unchanged. See [native acceptance evidence](build-engine/native-theme/ACCEPTANCE.md) and [Checkpoint188](build-engine/CHECKPOINT_188.md).

## Classification and acceptance contract

`DONE`: every story acceptance criterion and cross-cutting definition of done verified. `PARTIAL`: concrete implementation exists, but acceptance/UI/security/integration is incomplete or unverified. `MISSING`: no story-specific implementation found (listed code may be a native reuse candidate). `BLOCKED`: an explicit external dependency or business decision prevents acceptance; existing code is still recorded. Blocked does not imply engineering cannot progress on mocks or unrelated slices.

The original audit promoted no stories. Checkpoint35 verified BE-109/110's original criteria in native Odoo under the earlier direction. Under current ADR0014, their React end-user journeys are also required; checkpoint188 verifies the ordinary-role RFI journey on a disposable database clone. Both stories remain PARTIAL for remaining privacy, edge-case and shared-deployment acceptance. The 164-story classifications are interpreted against the current React-first delivery requirement.

All 164 stories have four criteria: A1 authorized validated persistence in Odoo; A2 invalid-input field errors and no partial business transaction; A3 reopened state/actor/timestamps/project/company visible; A4 unauthorized and cross-tenant denial without disclosure. All also require Odoo security, versioned API, **a React end-user journey**, audit/telemetry, unit/integration/isolation tests, Arabic/English. Native Odoo remains the backend and administration surface, not the required daily interface; see [ADR0014](adr/0014-react-as-end-user-application.md). For PARTIAL/MISSING/BLOCKED rows, verification against A1–A4 and that definition remains open unless specifically recorded. DONE rows link executed acceptance evidence. Tests below are existing relevant evidence/candidates, **not a claim that they cover or pass all story criteria**. Actual executions and limits: [test results](TEST_RESULTS.md). Findings AUD-* and decisions DEC-* are detailed in [audit](REPOSITORY_AUDIT.md) and [decisions](OPEN_DECISIONS.md).

The React user guide lists all 164 stories with current classification and a localized navigation/usage hint. Regenerate its data from this file with `python3 scripts/build_react_user_manual.py`; guide availability does not change story acceptance.

| Status | Count |
|---|---:|
| DONE | 115 |
| PARTIAL | 37 |
| MISSING | 2 |
| BLOCKED | 10 |

## Platform, tenancy and onboarding

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-001 | P0 | Create tenant and configure legal company identity | 11 | DONE | [native control](../odoo/addons/be/be_tenant_control)<br>[private worker](../services/platform/app/tenants)<br>[React operator workspace](../frontend/src/TenantOperationsWorkspace.jsx) | [real runtime/restore/browser acceptance](build-engine/evidence/TENANT_LIFECYCLE_ACCEPTANCE_LATEST.json)<br>[invitation/project-scope acceptance](build-engine/evidence/TENANT_INVITATIONS_ACCEPTANCE_LATEST.json) | Native allowlisted operator control, queued UUID jobs and separate fresh PostgreSQL/Odoo/BFF/frontend/storage/credentials. Legal identity and manual Owner activation read back. Real interruption compensation and retry, two-runtime/foreign-session denial, React setup, and complete pinned module installation pass. Customer Owner lacks technical settings authority. Local endpoint scope only; production DNS/TLS and official identity verification remain separate. |
| BE-002 | P0 | Invite users and assign project-scoped roles | 11 | DONE | [native access](../odoo/addons/be/be_tenant_access)<br>[React team workspace](../frontend/src/TenantAccessWorkspace.jsx)<br>[activation screen](../frontend/src/InvitationActivation.jsx) | [real runtime/restore/browser acceptance](build-engine/evidence/TENANT_LIFECYCLE_ACCEPTANCE_LATEST.json)<br>[invitation/project-scope acceptance](build-engine/evidence/TENANT_INVITATIONS_ACCEPTANCE_LATEST.json) | Nine native tests plus actual fresh-customer React/native acceptance pass: one-use/expiry/password validation, no invitation email, native group/project assignment, nested daily-report and direct DMS isolation, dynamic AI targets, live scope updates, revocation, immutable audit and foreign-customer denial. PM/Site/QS are project-scoped; Finance/Sales/Procurement/Owner retain explicitly labeled company scope. A per-project DMS root-name collision found during acceptance was fixed; existing roots are retained. |
| BE-003 | P0 | Configure company trades, regions and tender thresholds | 9.2 BD | DONE | [Odoo company mandate](../odoo/addons/be/be_ai/models/be_ai_mandate.py)<br>[CRM lead trade/category facts and normalized index](../odoo/addons/be/be_tender/models/crm_lead.py)<br>[Company-scoped indexed matching and source snapshots](../addons/namaa_ai_bridge/models/scouting_bridge.py)<br>[React mandate editor](../frontend/src/CrmScoutingWorkspace.jsx)<br>[Authenticated BFF](../backend/app/main.py) | [Current-source native mandate/lead tests](build-engine/evidence/BE-003_OWNER_COMPANY_ACCEPTANCE.json)<br>[Backend field-error/no-call test](../backend/tests/test_business.py)<br>[Live React→BFF→Odoo Owner journey](build-engine/evidence/BE-003_OWNER_COMPANY_ACCEPTANCE.json)<br>[React mocked journey](../frontend/e2e/crm-scouting.spec.js)<br>[Checkpoint 444](build-engine/CHECKPOINT_444.md) | All four supplied criteria pass. Owner saves/reopens thresholds, trade/category codes, regions, sector and allowed sources; a React-created CRM lead stores normalized codes and appears in company-scoped matching. Invalid fields return HTTP 422 with field errors and no Odoo call; native invalid values leave the prior mandate unchanged; non-Owner and foreign-company access are denied. Native Odoo 2/2, backend 1/1, live React→BFF→Odoo 1/1, mocked React 1/1. Disposable DB/services/image were removed. Scale benchmarking and official tender feeds are extensions beyond the supplied criteria. |
| BE-004 | P0 | Configure company branding and document templates | 9.2 Sales, 11 | DONE | [frontend/src/AppearanceMenu.jsx](../frontend/src/AppearanceMenu.jsx)<br>[odoo/addons/be/be_base/models/be_company_identity.py](../odoo/addons/be/be_base/models/be_company_identity.py) <br>[BFF company identity reader/writer](../addons/namaa_ai_bridge/models/company_identity_bridge.py)<br>[Authenticated React identity test](../frontend/e2e/company-identity.live.spec.js)<br>[Isolated live QA runner](../scripts/run_company_identity_live_qa.py)| [frontend/tests/appearance.test.js](../frontend/tests/appearance.test.js)<br>[odoo/addons/be/be_base/tests](../odoo/addons/be/be_base/tests) <br>[Native identity/template tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Live QA evidence](build-engine/evidence/BE-004_IDENTITY_LIVE_QA.json)<br>[Checkpoint 459](build-engine/CHECKPOINT_459.md)|Current-source disposable-clone acceptance passed all four native tests and both authenticated React→BFF→Odoo browser tests. The Owner changed and reopened branding; identity readback showed brand, actor and write timestamp; native quotation rendering verified the configured letterhead/footer. Invalid branding returned 422 with no partial change. Sales could read but not write; a foreign-company Owner saw only its own profile and could not forge a cross-company read. Clone dropped and shared namaa_ksa was unchanged. The runner’s separate post-run auxiliary shell readback is marked INCOMPLETE because its diagnostic snippet lacked an import; the live identity read and template test had already verified the supplied criteria. All four supplied acceptance criteria are covered; story classified DONE. See Checkpoint 459. |
| BE-005 | P1 | Import initial master data with validation | 9.3 | DONE | [Native atomic master import](../addons/namaa_ai_bridge/models/master_data_import.py)<br>[Excel validation API](../backend/app/master_import.py)<br>[React mapping and receipts](../frontend/src/MasterDataImportWorkspace.jsx) | [Native tests](../addons/namaa_ai_bridge/tests/test_master_import.py)<br>[Parser/API tests](../backend/tests/test_master_import.py)<br>[Live browser acceptance](../frontend/e2e/master-import.acceptance.spec.js)<br>[Isolated acceptance evidence](build-engine/evidence/BE005_MASTER_IMPORT_ACCEPTANCE_20261107.json) | All four supplied criteria verified for initial customer, vendor and product Excel imports: Owner/Admin with native creation rights maps columns, validates row errors, commits atomically, safely retries the same operation and reopens immutable receipts with actor/time/company and created records. Four native tests, six parser/API tests and three live React→BFF→Odoo cases pass; invalid rows create no partial records and unauthorized/foreign requests disclose no receipt. Numeric zero references are preserved. Opening balances, quantities and external-system synchronization remain separate workflows. |
| BE-006 | P1 | View onboarding checklist and first-value sample project | 11 | DONE | [Owner-only Odoo onboarding checklist and sample project](../odoo/addons/be/be_onboarding/models/be_onboarding.py)<br>[Odoo company bridge and capability](../addons/namaa_ai_bridge/models/onboarding_bridge.py)<br>[Authenticated BFF routes and validation](../backend/app/main.py)<br>[Bilingual React onboarding workspace](../frontend/src/OnboardingWorkspace.jsx) | [Isolated Odoo QA](build-engine/BE006_ONBOARDING_LIVE_QA.json)<br>[Native lifecycle/security tests](../odoo/addons/be/be_onboarding/tests/test_be_onboarding.py)<br>[BFF input/route tests](../backend/tests/test_business.py)<br>[Owner/role/company live browser journey](../frontend/e2e/onboarding.live.spec.js)<br>[Checkpoint 376](build-engine/CHECKPOINT_376.md) | Current-source isolated native tests passed 4/4 and authenticated live browser tests 3/3. Owner updates persisted and reopened with note, actor and time; invalid completion returned 422 without a write; sample-project creation was verified idempotent with five linked tasks and zero accounting moves. Same-company non-Owner received 403; separate-company Owner saw only that company's empty checklist. Clone dropped, source fingerprint unchanged, temporary BFF stopped and Odoo healthy. All applicable supplied criteria passed. |
| BE-007 | P1 | Configure Arabic/English language and timezone | 11 | DONE | [React language/timezone preferences](../frontend/src/AppearanceMenu.jsx)<br>[Authenticated user preference BFF](../backend/app/main.py)<br>[Native Odoo `res.users.lang` / `res.users.tz`](../vendor/odoo/addons/base/models/res_users.py) | [Current-source Odoo own-profile role test](build-engine/evidence/BE-007-USER-PREFERENCES-QA-20261105.json)<br>[BFF validation/session-binding test](../backend/tests/test_business.py)<br>[React save, timestamp formatting, and fresh sign-in journey](../frontend/e2e/user-preferences.spec.js)<br>[Checkpoint 436](build-engine/CHECKPOINT_436.md) | All four supplied criteria pass. React saves/reopens language and IANA timezone through the authenticated BFF; target user ID comes from the Odoo session. Invalid/missing input returns field errors without Odoo calls; reopened state includes actor/time/current company; another user cannot update the profile. Native Odoo 1/1, API 1/1, browser 1/1 and production build passed on current source; disposable DB dropped. Browser APIs are mocked, while native authorization is separately verified. User profile has no project relation. |
| BE-008 | P2 | Suspend tenant and export customer data | 11 | DONE | [native lifecycle control](../odoo/addons/be/be_tenant_control)<br>[worker/export implementation](../services/platform/app/tenants/worker.py)<br>[protected BFF download](../backend/app/tenant_workflows.py) | [real runtime/restore/browser acceptance](build-engine/evidence/TENANT_LIFECYCLE_ACCEPTANCE_LATEST.json)<br>[invitation/project-scope acceptance](build-engine/evidence/TENANT_INVITATIONS_ACCEPTANCE_LATEST.json) | Real native lifecycle jobs suspend only the selected customer applications/workers, retain its data and clear its sessions. The other customer remains running. Export delivers an authorized checksummed ZIP through the read-only control export volume/BFF; native and agent dumps restore and the actual attachment bytes and company/project records are verified. Audited resume preserves records and requires fresh login. Private operator controls only; no active shared customer was suspended in QA. |

## CRM, tenders and opportunities

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-009 | P0 | Create lead from manual entry | 7.4 | DONE | [React CRM workspace](../frontend/src/BusinessWorkspace.jsx)<br>[BFF validation](../backend/app/main.py)<br>[Odoo CRM bridge](../addons/namaa_ai_bridge/models/extension.py)<br>[native Odoo CRM](../vendor/odoo/addons/crm) | [backend validation test](../backend/tests/test_business.py)<br>[Odoo role/company tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[React business suite](../frontend/tests/business.test.js)<br>[isolated live React journey](build-engine/CRM_MANUAL_LEAD_LIVE_QA.json)<br>[Checkpoint195](build-engine/CHECKPOINT_195.md) | Sales user created a persisted customer-free lead; blank name returned a field-level error before RPC; reopen showed state, creator, company, sector, and Riyadh-local created/updated timestamps. No-CRM-role and foreign-company attempts were denied without disclosure. Native Odoo, backend, React and live journey checks passed. |
| BE-010 | P0 | Classify government vs private lead | 7.4, 10.3 | DONE | [Native CRM sector field](../odoo/addons/be/be_tender/models/crm_lead.py)<br>[React CRM editor/list/detail](../frontend/src/BusinessWorkspace.jsx)<br>[Customer-free CRM edit contract](../backend/app/contracts.py)<br>[Odoo bridge](../addons/namaa_ai_bridge/models/extension.py) | [Odoo role/company tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[BFF field-boundary tests](../backend/tests/test_business.py)<br>[React payload tests](../frontend/tests/business.test.js)<br>[Isolated live React journey](build-engine/CRM_MANUAL_LEAD_LIVE_QA.json)<br>[Checkpoint197](build-engine/CHECKPOINT_197.md) | Sales user created an unmatched lead classified as government, changed it to private through React, reopened it, and verified the Sales updater, company and timestamps. Invalid enum failed with field-level 422 before RPC; no-CRM-role and foreign-company reads/updates were denied without disclosure or state change. The classification operation does not generate AI content. |
| BE-011 | P0 | Deduplicate organization and lead | 7.4 | DONE | [React duplicate review and receipts](../frontend/src/BusinessWorkspace.jsx)<br>[native merge boundary](../addons/namaa_ai_bridge/models/extension.py)<br>[immutable receipt](../addons/namaa_ai_bridge/models/crm_merge_event.py) | [current-source native and bilingual live acceptance](build-engine/evidence/CRM_DEDUP_PROPOSAL_REVIEW_ACCEPTANCE_20261107.json) | All four supplied criteria are verified: Sales explicitly reviews native duplicate suggestions, merges its writable opportunities with Odoo’s native merge operation, and merges one organization into the linked master with native contact-manager permission. Invalid/stale and unauthorized/foreign-company requests are denied without a partial merge or disclosure. The survivor reopens in React with immutable source-ID/name, actor, timestamp and company receipts. Matches are advisory: a human checks identity; Odoo confidence ranking determines the surviving opportunity and organization merge keeps the linked organization. No general CRM delete permission or custom elevated business merge was added. Source database unchanged; disposable services removed. [Checkpoint 465](build-engine/CHECKPOINT_465.md). |
| BE-012 | P0 | Qualify lead yes/no/maybe with reason | 7.4, 9.2 BD | DONE | [Native CRM qualification](../odoo/addons/be/be_tender/models/crm_lead.py)<br>[Company/project-safe Odoo bridge](../addons/namaa_ai_bridge/models/crm_qualification_bridge.py)<br>[React qualification workspace](../frontend/src/LeadQualificationWorkspace.jsx) | [Odoo role/audit/context tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Mocked React Playwright](../frontend/e2e/lead-qualification.spec.js)<br>[Live role/company React → BFF → Odoo journey](build-engine/CRM_QUALIFICATION_LIVE_QA.json)<br>[Checkpoint199](build-engine/CHECKPOINT_199.md) | All four supplied acceptance criteria passed live on a disposable clone: Sales yes/reason/audit/reopen; required and invalid fields plus stale revision rejected; CRM reader and foreign-company Sales denied without disclosure; company/readable project context shown in React. Evaluated BD-agent suggestions are a separate, unsupplied broader requirement and are not claimed complete; lead promotion approval is BE-013. |
| BE-013 | P1 | Approve lead-to-opportunity promotion | 7.4, 9.2 BD | DONE | [Native company governance](../odoo/addons/be/be_governance/models/governance.py)<br>[Promotion bridge](../addons/namaa_ai_bridge/models/crm_promotion_bridge.py)<br>[Charter bridge](../addons/namaa_ai_bridge/models/project_bridge.py)<br>[Owner policy UI](../frontend/src/GovernancePolicyWorkspace.jsx) | [Governance acceptance](build-engine/evidence/GOVERNANCE_ACCEPTANCE_20261110.json)<br>[Native tests](../odoo/addons/be/be_governance/tests/test_governance.py)<br>[Live browser matrix](../frontend/e2e/governance.acceptance.spec.js) | CP468: user accepted existing independent reviewer rules with per-company configuration (2026-11-10). Nine native and four real bilingual browser tests pass: Owner policy audit/revision; named reviewer restrictions; Sales request, independent approval/native conversion and rejection/no conversion; PM charter rejection/revision/resubmission/approval with immutable snapshots; invalid no-write and unauthorized/project/company denial. Fresh-session state/actor/time readback verified. Charter content is manual; AI drafting remains a separate draft workflow. No self-approval or automatic sending. Clone/services removed; see release evidence for deployment. |
| BE-014 | P1 | Manage pipeline stage and probability | 7.4 | DONE | [Odoo CRM bridge](../addons/namaa_ai_bridge/models/extension.py)<br>[React pipeline editor](../frontend/src/BusinessWorkspace.jsx)<br>[BFF contracts](../backend/app/contracts.py) | [Native Odoo test](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Authenticated live QA](build-engine/CRM_PIPELINE_LIVE_QA.json)<br>[Checkpoint 364](build-engine/CHECKPOINT_364.md)<br>[Accessible bilingual validation, Checkpoint 341](build-engine/CHECKPOINT_341.md)<br>[Fractional probability, Checkpoint 342](build-engine/CHECKPOINT_342.md) | All four supplied criteria verified on a current-source disposable clone: Sales user changed stage/probability; invalid probability returned field-level 422 with no write; reopen showed updated state, actor/time/company/project; CRM reader and foreign-company user received 403 without record-name disclosure. Stale revision returned 422 without overwriting. Native Odoo test 1/1 and authenticated React→BFF→Odoo browser journey 1/1 passed. Clone/temp services removed; source unchanged. Win-rate analytics are a separate story (BE-018). |
| BE-015 | P1 | Create tender and bid checklist | 7.4, 10.3 | DONE | [Tender checklist models](../odoo/addons/be/be_tender/models/be_tender_checklist.py)<br>[Tender React workspace](../frontend/src/TenderWorkspace.jsx)<br>[Named Odoo bridge](../addons/namaa_ai_bridge/models/extension.py)<br>[BFF routes](../backend/app/main.py) | [Native tests](../odoo/addons/be/be_tender/tests/test_be_tender.py)<br>[Authenticated live QA](build-engine/TENDER_CREATE_LIVE_QA.json)<br>[Checkpoint 365](build-engine/CHECKPOINT_365.md)<br>[Demo seed](../scripts/seed_be015_demo.py) | All four supplied criteria passed on a current-source disposable clone: Sales created and reopened a tender/checklist; invalid mandatory checklist data was rejected; actor/time/company/project were visible; no-role and foreign-company details/create were denied with generic responses containing no tender/project/marker data. Same-operation retry was idempotent. Native Odoo tests 2/2 and authenticated React→BFF→Odoo browser journey 1/1 passed. The optional post-browser native postcondition collector did not run because the QA reporter had an f-string formatting error after Playwright passed; source DB unchanged and clone/temp BFF removed. |
| BE-016 | P2 | Track bid deadline and submission evidence | 7.4, 10.3 | DONE | [Tender and bid models](../odoo/addons/be/be_tender/models/be_tender.py)<br>[Checklist/evidence model](../odoo/addons/be/be_tender/models/be_tender_checklist.py)<br>[Tender React workspace](../frontend/src/TenderWorkspace.jsx)<br>[Authenticated BFF evidence route](../backend/app/main.py) | [Native Odoo tests](../odoo/addons/be/be_tender/tests/test_be_tender.py)<br>[Bridge/BFF tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Sales-persona authenticated live QA](build-engine/TENDER_SALES_EVIDENCE_LIVE_QA.json)<br>[Procurement workflow QA](build-engine/TENDER_EVIDENCE_LIVE_QA.json)<br>[Checkpoint 371](build-engine/CHECKPOINT_371.md) | All four criteria passed for the Sales Representative persona through authenticated React→BFF→Odoo: tender-owning Sales uploaded/reopened sanitized evidence that hides bidder identity, amount and filename; missing evidence made no write; actor/time/company/project were visible; non-owner Sales and foreign-company attempts were denied without disclosure. Procurement retains its full view. Native tests 2/2 and live browser 1/1 passed. Clone/temp services removed; source unchanged. Official portal submission remains separate integration scope. |
| BE-017 | P2 | Convert won opportunity to project | 7.1, 7.4 | DONE | [Odoo project hook](../odoo/addons/be/be_tender/models/crm_lead.py)<br>[company-scoped bridge](../addons/namaa_ai_bridge/models/extension.py)<br>[React CRM action](../frontend/src/BusinessWorkspace.jsx)<br>[BFF route](../backend/app/main.py) | [Odoo bridge tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[BFF tests](../backend/tests/test_business.py)<br>[isolated live QA](build-engine/CRM_WON_PROJECT_LIVE_QA.json)<br>[Checkpoint 203](build-engine/CHECKPOINT_203.md) | All four supplied criteria passed with a Sales Project Manager: exactly one authoritative current-company project persists and links to the won opportunity; invalid/un-won input creates nothing; reopened React detail shows project, company, creator and timestamp; Arabic action is present; React opens the selected project; retries are safe; CRM-only/foreign-company actions are denied without disclosure. Disposable clone and temporary Odoo/BFF QA services were removed. |
| BE-018 | P2 | View win rate and pipeline value | 7.4 | DONE | [backend/app/tools.py](../backend/app/tools.py)<br>[frontend/src/Dashboard.jsx](../frontend/src/Dashboard.jsx)<br>[frontend/src/dashboard.js](../frontend/src/dashboard.js)<br>[native CRM model](../vendor/odoo/addons/crm/models/crm_lead.py) | [backend company-scope and metric tests](../backend/tests/test_business.py)<br>[React dashboard tests](../frontend/tests/dashboard.test.js)<br>[current-source isolated Sales live journey](build-engine/CRM_PIPELINE_LIVE_QA.json)<br>[two-role USD/SAR and win-rate acceptance](build-engine/CHECKPOINT_112.md)<br>[Checkpoint 389](build-engine/CHECKPOINT_389.md) | Acceptance verified for this read-only story: React shows open gross pipeline, probability-weighted value, closed counts and the won/(won+lost) rate from Odoo CRM records, and shows no rate when no outcomes are visible. Current-source isolated authenticated Sales browser passed 1/1 alongside company-scoped CRM regression QA; earlier Owner/Sales run verified 75% from 3 won/1 archived lost in SAR and USD-role isolation. Backend tests assert every aggregate is constrained to Odoo's active company. View actions create no business transaction, so generic write-only invalid-input, actor/timestamp mutation and project-write acceptance criteria are not applicable; company, currency and source records are returned from Odoo. Disposable clone and temporary services were removed; shared databases unchanged. |

## Business development AI

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-019 | P0 | Configure scouting mandate and source allowlist | 9.2 BD | DONE | [Odoo mandate](../odoo/addons/be/be_ai/models/be_ai_mandate.py)<br>[scouting bridge and candidate filter](../addons/namaa_ai_bridge/models/scouting_bridge.py)<br>[BFF contract/routes](../backend/app/contracts.py)<br>[React mandate and AI review](../frontend/src/CrmScoutingWorkspace.jsx) | [clean-install native QA](build-engine/CRM_SCOUTING_NATIVE_QA.json)<br>[isolated mandate journey](build-engine/CRM_SCOUTING_LIVE_QA.json)<br>[isolated Qwen/human review](build-engine/CRM_SCOUTING_AI_LIVE_QA.json)<br>[BFF tests](../backend/tests/test_business.py)<br>[browser tests](../frontend/e2e/crm-scouting-ai.live.spec.js)<br>[Checkpoint 320](build-engine/CHECKPOINT_320.md) | All five supplied criteria are verified: an Owner persists the mandate in Odoo; invalid ranges and forged tenant input return validation errors without a write; React refresh shows saved state, company, actor and time; unauthorized writes are denied and foreign-company candidates are excluded; Qwen content is a cited pending draft with uncertainty and requires a separate human decision. External tender discovery/connectors are separate stories. |
| BE-020 | P0 | Schedule periodic tender and public signal discovery | 9.2 BD | BLOCKED | [services/platform/app/integrations](../services/platform/app/integrations) | None found | Discovery adapters are absent; approved tender/public-source API access and licensed source policy are dependencies (DEC-05). |
| BE-021 | P0 | Filter by project size, region and sector | 9.2 BD | DONE | [odoo/addons/be/be_ai/models/be_ai_mandate.py](../odoo/addons/be/be_ai/models/be_ai_mandate.py)<br>[addons/namaa_ai_bridge/models/scouting_bridge.py](../addons/namaa_ai_bridge/models/scouting_bridge.py)<br>[backend/app/main.py](../backend/app/main.py)<br>[frontend/src/CrmScoutingWorkspace.jsx](../frontend/src/CrmScoutingWorkspace.jsx)<br>[frontend/src/BusinessWorkspace.jsx](../frontend/src/BusinessWorkspace.jsx) | [native isolated QA](build-engine/CRM_SCOUTING_NATIVE_QA.json)<br>[live browser QA](build-engine/CRM_SCOUTING_LIVE_QA.json)<br>[backend/tests/test_business.py](../backend/tests/test_business.py)<br>[live screenshot](build-engine/frontend/screenshots/crm-scouting-live.png)<br>[Checkpoint 243](build-engine/CHECKPOINT_243.md) | All four supplied acceptance criteria pass: Owner saves the company value/region/sector mandate; invalid ranges return a field-level 422 without an Odoo call; reopening returns the saved filters and actor/time; native access/company-scope tests deny unauthorized writes and exclude foreign-company candidates. Live React → BFF → Odoo acceptance passed on a disposable clone. External tender discovery/source verification are BE-020/022, not part of this filter story. |
| BE-022 | P0 | Verify sources and organization legitimacy | 9.2 BD | BLOCKED | [services/platform/app/integrations](../services/platform/app/integrations) | None found | Discovery adapters are absent; approved tender/public-source API access and licensed source policy are dependencies (DEC-05). |
| BE-023 | P1 | Classify lead as yes/no/maybe | 9.2 BD | DONE | [Company/project-safe Odoo qualification bridge](../addons/namaa_ai_bridge/models/crm_qualification_bridge.py)<br>[React qualification workspace](../frontend/src/LeadQualificationWorkspace.jsx)<br>[Source-bound scouting AI and Odoo suggestions](../backend/app/crm_scouting_ai.py)<br>[Native CRM qualification fields](../odoo/addons/be/be_tender/models/crm_lead.py) | [Owner/current-source native qualification and AI review tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[AI invalid-input/no-write/role regression](../odoo/addons/be/be_ai/tests/test_be_ai.py)<br>[live React → BFF → Qwen → Odoo owner journey](build-engine/CRM_SCOUTING_AI_LIVE_QA.json)<br>[Checkpoint 430](build-engine/CHECKPOINT_430.md) | All five supplied criteria verified. An authorized Owner generated a yes/maybe/no-capable classification draft from current company CRM facts; Odoo persisted the source revision, exact CRM citation, uncertainty, state and creator, and the Owner’s human decision was separately audited. Invalid classifications and stale sources were rejected without creating a finding; an unauthorized same-company reader and foreign-company lead access were denied. Current-source native tests include Owner classification/review and runtime/foreign-company boundaries; authenticated React→BFF→Qwen→Odoo journey reopened the source-cited result and related project/company. The AI did not update the lead or promote it before human action. Clone dropped and source unchanged. Public tender discovery remains a separate blocked story (BE-020/022). |
| BE-024 | P1 | Route yes/maybe to human review and archive no | 9.2 BD | DONE | [React scouting assessment and review](../frontend/src/CrmScoutingWorkspace.jsx)<br>[BFF generator](../backend/app/crm_scouting_ai.py)<br>[Odoo review/persistence](../odoo/addons/be/be_ai/models/be_ai_suggestion.py)<br>[Company-scoped source bridge](../addons/namaa_ai_bridge/models/scouting_bridge.py) | [Current-source native routing/deduplication test](../odoo/addons/be/be_ai/tests/test_be_ai.py)<br>[Native Owner review/source tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Current-source live React→BFF→Qwen→Odoo QA](build-engine/CRM_SCOUTING_AI_LIVE_QA.json)<br>[pending/approved screenshots](build-engine/frontend/screenshots/crm-scouting-ai-live-pending.png)<br>[Checkpoint 430](build-engine/CHECKPOINT_430.md) | All four supplied criteria verified. Yes/maybe findings remain pending for human review; a no finding is stored/flagged without creating an approval request. Current-source native tests verify both branches, invalid labels/no-write, duplicate protection, source freshness and unauthorized/foreign-company access. The authenticated Owner journey generated a current-source pending assessment, displayed the CRM citation/rationale/uncertainty, and reopened the human-approved result with reviewer and audit reason. No lead promotion or customer contact is automated. Clone and temporary services removed; source unchanged. Public tender discovery and Arabic model evaluation remain separate integrations/quality extensions, not prerequisites in this supplied story’s acceptance criteria. |
| BE-025 | P1 | Prevent duplicate CRM handoff | 9.2 BD | DONE | [Odoo idempotent scouting handoff](../odoo/addons/be/be_ai/models/be_ai_suggestion.py)<br>[Company-scoped revision-checked bridge](../addons/namaa_ai_bridge/models/scouting_bridge.py)<br>[React scouting and review workspace](../frontend/src/CrmScoutingWorkspace.jsx) | [Current-source Odoo duplicate/validation/security regression](../odoo/addons/be/be_ai/tests/test_be_ai.py)<br>[Current-source native review and stale-source tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[backend contracts](../backend/tests/test_crm_scouting_ai.py)<br>[authenticated React → BFF → Qwen → Odoo live QA](build-engine/CRM_SCOUTING_AI_LIVE_QA.json)<br>[Checkpoint 429](build-engine/CHECKPOINT_429.md) | All four supplied criteria verified. The Odoo AI runtime validates and persists one lead-bound handoff; retries for the same lead are serialized by a company/lead advisory lock and a second active/stored finding is rejected. Invalid classification and target input produce no finding; unauthorized runtime and foreign-company lead attempts are denied. Current-source native duplicate/validation/company tests plus two Odoo bridge tests passed (3/3); authenticated React→BFF→Qwen→Odoo review passed 1/1 with current CRM source citation, approved/rejected audit state, reviewer, rationale and company/project context. Clone and temporary services removed; source unchanged. External tender discovery is a separate source-integration capability; the handoff gate does not ingest or claim public tender feeds. |
| BE-026 | P2 | Show source links and fit rationale | 9.2 BD | DONE | [Source review model](../addons/namaa_ai_bridge/models/scouting_source_review.py)<br>[React source review](../frontend/src/ScoutingSourceReviews.jsx) | [Native tests](../addons/namaa_ai_bridge/tests/test_scouting_source_review.py)<br>[API boundaries](../backend/tests/test_scouting_sources.py)<br>[Live acceptance](build-engine/evidence/BE026_SOURCE_REVIEW_ACCEPTANCE_20261108.json) | Human-reviewed source links and fit rationale now persist in immutable Odoo review receipts, with exact lead/mandate source revision, named organization, reviewer/time/company and safe HTTPS links. Three native tests, one BFF boundary test and two real bilingual React→BFF→Odoo journeys passed, including stale/invalid no-write, exact safe retry and reader/foreign-company denial. This completes the supplied source-display/review criteria; automated source discovery and independent organization verification remain separate blocked stories BE-020/022. No crawler, source licensing or AI accuracy is claimed. 
| BE-027 | P2 | Chat with scouting agent about findings | 9.2 BD | DONE | [React scouting chat](../frontend/src/CrmScoutingWorkspace.jsx)<br>[Odoo transcript models and company ACLs](../odoo/addons/be/be_ai/models/be_ai_scouting_chat.py)<br>[company-authorized Odoo bridge](../addons/namaa_ai_bridge/models/scouting_bridge.py)<br>[authenticated BFF request/response](../backend/app/main.py) | [focused backend/API tests](../backend/tests/test_business.py)<br>[source-bound Qwen tests](../backend/tests/test_crm_scouting_ai.py)<br>[Odoo persistence/access/concurrency tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[live React/Qwen journey](../frontend/e2e/crm-scouting-ai.live.spec.js)<br>[isolated current-source QA](build-engine/CRM_SCOUTING_AI_LIVE_QA.json)<br>[pending and reopened transcript screenshots](build-engine/frontend/screenshots/crm-scouting-ai-live-pending.png), [human review](build-engine/frontend/screenshots/crm-scouting-ai-live-human-approved.png)<br>[Checkpoint 396](build-engine/CHECKPOINT_396.md) | All supplied criteria passed in current-source isolated acceptance. Owner scouting chat reads the current authorized CRM snapshot and saves each turn in authoritative Odoo. A short question returned field-level 422 and left the transcript empty. Two valid turns reopened from Odoo in React with project/company/actor/time; responses included lead citations and uncertainty, were explicitly `draft_only`, and were never applied or approved by the AI. Native Odoo tests 2/2, current-source backend/API tests 240/240, authenticated React → BFF → Qwen → Odoo browser journey 1/1. Native access tests cover project role, foreign-company access, stale source revision and stale transcript version. Clone/temp services removed and source DB unchanged.
| BE-028 | P2 | Review run logs and disable unreliable sources | 9.2 BD | DONE | [Native run receipts and company source decisions](../addons/namaa_ai_bridge/models/scouting_runtime.py)<br>[Candidate and in-flight source enforcement](../addons/namaa_ai_bridge/models/scouting_bridge.py)<br>[Actual BFF model runtime](../backend/app/scouting_runtime.py)<br>[React run history/source controls](../frontend/src/ScoutingRuntimeWorkspace.jsx) | [12 native and 2 live browser checks](build-engine/evidence/SCOUTING_RUNTIME_ACCEPTANCE_LATEST.json)<br>[BFF runtime failure/retry checks](../backend/tests/test_scouting_runtime.py)<br>[Native cases](../addons/namaa_ai_bridge/tests/test_scouting_runtime.py)<br>[Live specification](../frontend/e2e/scouting-runtime.acceptance.spec.js)<br>[Checkpoint473](build-engine/CHECKPOINT_473.md) | Actual internal CRM fit-assessment requests now retain native start/terminal status, actor/time/company/source/revision, duration, finding reference and allowlisted failure categories. Exact UUID retry reuses the receipt without another model call; pending and interrupted requests are distinguished. Owner source decisions are immutable, reasoned and company-scoped. Disable excludes candidates and blocks in-flight/old-source results, including disable/re-enable cycles; global UTM records and other companies are unchanged. Role/company/native-lead rules protect paged histories and decisions. Real local model success, unreachable-model failure and a controlled synthetic in-flight race pass, with bilingual390px history/reopen, no CRM stage/write-date/global-source changes and no outgoing mail. Twelve native/2live; backend371/frontend120 pass. QA clone/services removed. Scope is the existing CRM assessment runtime; licensed external discovery, organization verification and model accuracy remain separate dependencies. |

## Sales AI and proposals

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-029 | P0 | Generate account research and opening message draft | 9.2 Sales | DONE | [Source-limited generator with false/null/blank CRM sentinel filtering](../backend/app/crm_account_research_ai.py)<br>[React CRM record detail](../frontend/src/BusinessWorkspace.jsx)<br>[Odoo pending suggestion bridge](../addons/namaa_ai_bridge/models/crm_account_research_bridge.py) | [generator/API unit tests](../backend/tests/test_crm_account_research_ai.py)<br>[React live acceptance spec](../frontend/e2e/crm-account-research-live.spec.js)<br>[isolated native Odoo tests](build-engine/CRM_ACCOUNT_RESEARCH_LIVE_QA.json)<br>[authenticated React→BFF→Qwen→Odoo live QA](build-engine/CRM_ACCOUNT_RESEARCH_LIVE_QA.json)<br>[reviewed Arabic draft screenshot](build-engine/frontend/screenshots/live-crm-account-research-arabic-draft.png)<br>[Checkpoint 399](build-engine/CHECKPOINT_399.md) | All supplied criteria passed. Authorized Sales generated English and Arabic pending drafts from current CRM facts; unsupported language returned field-level 422 with no suggestion; reopened records showed actor/time, company/project and exact Odoo readback; same-company non-Sales reader and foreign-company lead were denied without disclosure. Drafts cite only current lead/partner records, disclose gaps/uncertainty, remain pending/unsent and create no message, activity or lead mutation. The model context omits Odoo False/None/blank sentinels; the Arabic output was human-reviewed and its full uncertainty is visible. Native Odoo 4/4, backend unit 5/5 and live browser 1/1 passed; source fingerprint unchanged, clone removed and Odoo healthy. External discovery and actual contact/consent remain separate BE-020/022 and BE-030 scopes. |
| BE-030 | P0 | Require human first contact and consent to proceed | 9.2 Sales | DONE | [Native immutable contact evidence and consent gate](../odoo/addons/be/be_contact_policy/models/contact.py)<br>[Proposal approval/release enforcement](../addons/namaa_ai_bridge/models/crm_technical_proposal_bridge.py)<br>[Authenticated BFF](../backend/app/contact_consent.py)<br>[React CRM contact/consent](../frontend/src/ContactConsentWorkspace.jsx) | [17 native and 2 live browser checks](build-engine/evidence/CONTACT_CONSENT_ACCEPTANCE_20261114.json)<br>[Live specification](../frontend/e2e/contact-consent.acceptance.spec.js)<br>[Checkpoint471](build-engine/CHECKPOINT_471.md) | User-approved manual human contact and recorded customer consent accepted. Sales records contact person/channel/actual time/evidence and grant, decline or withdrawal. Pending/declined consent blocks independent technical-proposal approval; granted consent enables it with a persisted consent receipt; withdrawal blocks new PDF release. Native actor/time/company audit is immutable, exact UUID retries add no duplicate, stale/invalid input makes no event, and non-Sales/foreign-company sessions cannot read or write evidence. English desktop and Arabic390px history/reopen pass. Fresh native readback confirms four events, separate reviewer, no sales order, outgoing mail or lead-stage change; disposable QA clone/services removed. Synthetic acceptance records establish workflow only; no actual customer consent, outreach, external discovery or model-quality claim is made. |
| BE-031 | P0 | Draft technical proposal from customer template | 9.2 Sales | DONE | [Source-constrained generator](../backend/app/technical_proposal_ai.py)<br>[React CRM proposal panel](../frontend/src/CrmTechnicalProposalWorkspace.jsx)<br>[Company-scoped Odoo suggestion bridge](../addons/namaa_ai_bridge/models/crm_technical_proposal_bridge.py) | [generator tests](../backend/tests/test_technical_proposal_ai.py)<br>[business/API tests](../backend/tests/test_business.py)<br>[React browser test](../frontend/e2e/business.spec.js)<br>[current-source isolated native QA: 11 passed](build-engine/CRM_TECHNICAL_PROPOSAL_LIVE_QA.json)<br>[live React/Odoo/model QA: 1 passed](build-engine/CRM_TECHNICAL_PROPOSAL_LIVE_QA.json)<br>[live screenshot](build-engine/frontend/screenshots/live-crm-technical-proposal.png)<br>[Checkpoint 427](build-engine/CHECKPOINT_427.md) | All five supplied story criteria verified: authorized Sales created a source-bound pending proposal from customer template text in React; blank mandatory template returned validation error without a suggestion; reopening showed the exact customer headings, source citation, uncertainty, actor, timestamp and company; same-company unauthorized reader and foreign-company Sales user were denied without disclosure; proposal remained a draft and created no message, activity, lead mutation or sale order. Current-source native suite passed 11/11 and authenticated React→BFF→Qwen→Odoo browser passed 1/1 on an isolated clone; clone removed and source unchanged. File/PDF template extraction and a separate Arabic-quality pilot are useful extensions beyond this story’s supplied acceptance criteria. |
| BE-032 | P0 | Draft financial proposal from approved pricing | 9.2 Sales | DONE | [backend/app/financial_proposal_ai.py](../backend/app/financial_proposal_ai.py)<br>[addons/namaa_ai_bridge/models/sales_financial_proposal_bridge.py](../addons/namaa_ai_bridge/models/sales_financial_proposal_bridge.py)<br>[frontend/src/SalesFinancialProposalWorkspace.jsx](../frontend/src/SalesFinancialProposalWorkspace.jsx) | [Real model acceptance](build-engine/evidence/FINANCIAL_PROPOSAL_ACCEPTANCE_20261110.json)<br>[Native role/project tests](../addons/namaa_ai_bridge/tests/test_sales_financial_proposal.py)<br>[Live bilingual browser journey](../frontend/e2e/financial-proposal.acceptance.spec.js) | CP469: user accepted confirmed Odoo orders as approved pricing, independent Sales Manager/Owner review and no automatic sending. Five native and two live browser tests passed against the real local Qwen model. English/Arabic prose excludes numeric commercial terms; exact prices remain in the immutable native snapshot. Another reviewer approved/rejected the saved drafts; fresh-session readback verifies actor/time/project/company and unchanged source prices/state, with no outgoing messages or finance postings. Reader, unassigned private-project Sales and foreign-company sessions cannot create or disclose history. Model wording remains a human-reviewed draft. |
| BE-033 | P1 | Apply tenant logo and letterhead | 9.2 Sales, 11 | DONE | [React company identity editor](../frontend/src/AppearanceMenu.jsx)<br>[Odoo company identity model](../odoo/addons/be/be_base/models/be_company_identity.py)<br>[Company identity bridge](../addons/namaa_ai_bridge/models/company_identity_bridge.py)<br>[Native report company-field sync](../odoo/addons/be/be_base/models/res_company.py) | [Current-source Odoo role/company QA](build-engine/evidence/BE-033_IDENTITY_BRANDING_QA.json)<br>[API boundary tests](../backend/tests/test_business.py): 2 passed<br>[React branding browser flow](../frontend/e2e/company-identity.spec.js): 1 passed<br>[Checkpoint 434](build-engine/CHECKPOINT_434.md) | All four supplied criteria pass: authorized Owner identity persists in Odoo and reopens; invalid payloads return HTTP 422 without a partial profile; state shows active company, actor and timestamp; Sales cannot write and foreign-company Owners cannot read another company's identity. Logo, colors, sanitized letterhead and footer sync to native `res.company` report fields. Native Odoo tests 3/3, API tests 2/2, React E2E 1/1, and production build passed. React E2E mocks APIs; API/Odoo were tested separately. No PDF render was visually inspected. |
| BE-034 | P1 | Produce final PDF preview for approval | 9.2 Sales | DONE | [QWeb PDF report](../addons/namaa_ai_bridge/report/sales_financial_proposal_report.xml)<br>[Odoo preview record/private attachment](../addons/namaa_ai_bridge/models/sales_financial_proposal_bridge.py)<br>[Sales-only linked BOQ read rules](../odoo/addons/be/be_boq/security/ir.access.csv)<br>[BFF create/list/download routes](../backend/app/main.py)<br>[React Sales proposal workspace](../frontend/src/SalesFinancialProposalWorkspace.jsx) | [Native lifecycle, permission and linked-BOQ tests](../addons/namaa_ai_bridge/tests/test_sales_financial_proposal.py)<br>[BFF binary/company/file tests](../backend/tests/test_business.py)<br>[Live React journey](../frontend/e2e/financial-proposal-pdf.live.spec.js)<br>[Isolated acceptance evidence](build-engine/BE034_FINANCIAL_PDF_LIVE_QA.json)<br>[Screenshot](build-engine/frontend/screenshots/be034-live-financial-pdf-preview.png)<br>[Checkpoint 379](build-engine/CHECKPOINT_379.md) | All four supplied criteria passed. Sales created, downloaded and reopened a private immutable PDF from a pending source-bound financial draft; invalid language returned field-level 422 with no new draft/preview; actor, time, company, project and PDF checksum persisted; same-company non-Sales and foreign-company Sales reads/create/download were denied without disclosure. Native 4/4 and authenticated live browser 3/3 passed. Sales can read only BOQ lines/parents attached to their own confirmed orders in their allowed companies; writes, unlinked records and foreign-company records remain denied. PDF preview did not alter the six pre-existing company accounting moves. Clone DB/filestore/temp BFF removed; source fingerprint unchanged; Odoo healthy. |
| BE-035 | P1 | Approve/reject/revise outgoing proposal | 9.2 Sales | DONE | [React independent proposal review](../frontend/src/CrmTechnicalProposalWorkspace.jsx)<br>[authenticated review route](../backend/app/main.py)<br>[native review and immutable events](../addons/namaa_ai_bridge/models/crm_technical_proposal_bridge.py) | [current-source native and bilingual live acceptance](build-engine/evidence/CRM_DEDUP_PROPOSAL_REVIEW_ACCEPTANCE_20261107.json) | All five supplied criteria are verified: a separate Sales Manager/Owner approves for internal release, rejects with rationale, or creates a linked pending revision retaining the prior version and its citations. Reopened React receipts and native readback confirm reviewer/time/company/source. Missing rationale, author self-review, unprivileged and foreign-company access are rejected without changes or disclosure. Review events are immutable; quotations, customer mail and CRM stages remain unchanged. Synthetic text tests review controls, not AI language quality. Customer sending remains outside this internal review action; BE-036 handles the approved archive separately. Source database unchanged; disposable services removed. [Checkpoint 465](build-engine/CHECKPOINT_465.md). |
| BE-036 | P2 | Save approved PDF to opportunity/project archive | 9.2 Sales | DONE | [React CRM workspace](../frontend/src/CrmTechnicalProposalWorkspace.jsx)<br>[React project archive](../frontend/src/TechnicalProposalArchiveWorkspace.jsx)<br>[Authenticated BFF](../backend/app/main.py)<br>[Odoo private archive model and QWeb report](../addons/namaa_ai_bridge/models/crm_technical_proposal_bridge.py) | [Current-source native Odoo archive/approval suite](build-engine/evidence/BE-036_TECHNICAL_PROPOSAL_ARCHIVE_QA.json)<br>[BFF route and validation tests](../backend/tests/test_business.py)<br>[React internal review/archive journey](../frontend/e2e/business.spec.js)<br>[Checkpoint 442](build-engine/CHECKPOINT_442.md) | All five supplied criteria pass across current-source layers. Only independently approved and current proposal revisions can be archived; invalid/stale PDF input creates no record. A real QWeb PDF was generated on a disposable clone, stored as a private immutable checksum-backed attachment, and reopened with project/company/actor/time. Native Odoo 11/11, API 3/3, React 1/1 passed; clone dropped. Browser uses synthetic API fixtures, so a live integrated role matrix remains additional UAT. No email/customer release or publication is done. |
| BE-037 | P2 | Generate daily follow-up list | 9.2 Sales | DONE | [Bilingual React follow-up workspace](../frontend/src/TasksWorkspace.jsx)<br>[Source-constrained AI generator](../backend/app/task_followup_ai.py)<br>[Authenticated BFF task routes](../backend/app/main.py)<br>[Strict task request contract](../backend/app/contracts.py)<br>[Odoo native activity and pending suggestion bridge](../addons/namaa_ai_bridge/models/extension.py) | [BFF boundary/no-write tests](../backend/tests/test_business.py)<br>[AI generator tests](../backend/tests/test_task_followup_ai.py)<br>[Odoo source/citation/freshness tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[React unit tests](../frontend/tests/productivity.test.js)<br>[Mocked browser tests](../frontend/e2e/productivity.spec.js)<br>[Live browser journey](../frontend/e2e/task-followup-live.spec.js)<br>[Current-source live QA](build-engine/TASK_FOLLOWUP_LIVE_QA.json)<br>[Checkpoint 377](build-engine/CHECKPOINT_377.md) | All five supplied criteria verified. Sales generated and reopened a company-scoped pending Qwen follow-up draft with exact activity/CRM citations, uncertainty, actor, company and Riyadh date/time. A cross-company override was field-validated with 422/no write; a same-company no-role user was denied read/create; foreign Sales saw no suggestions and could not write to the other company. Human review remains required; the original activities stayed open and unchanged. Native tests 2/2; authenticated live browser passed. Project attribution is N/A for this company-level activity flow; the linked CRM source and company are recorded. Clone removed and source unchanged. |
| BE-038 | P2 | Block autonomous sending and stage promotion | 9.2 Sales | DONE | [LangGraph tools and review state](../backend/app/graph.py)<br>[Draft review API and React receipt](../backend/app/main.py)<br>[Native immutable Odoo audit bridge](../addons/namaa_ai_bridge/models/ai_run_review_bridge.py)<br>[React AI workspace](../frontend/src/AIWorkspace.jsx) | [Graph regression tests](../backend/tests/test_graph.py)<br>[Current-source Odoo AI suite](../odoo/addons/be/be_ai/tests/test_be_ai.py)<br>[Prior live retry](build-engine/evidence/BE-038_LIVE_ACCEPTANCE_RETRY_20261106.json)<br>[Fresh live acceptance](build-engine/evidence/BE-038_LIVE_ACCEPTANCE_FOLLOWUP_20261106.json)<br>[Checkpoint 463](build-engine/CHECKPOINT_463.md) | All supplied criteria verified on current source. Odoo native AI suite passed 18/18; current-code React→BFF→Odoo Playwright passed 1/1. The Sales prompt could not access send_email or promote_lead tools; stage-bearing cross-department drafts were rejected; invalid rationale made no write; rejection created no quotation; human review created only an unconfirmed, unsent draft quotation. Reopened React approval/rejection receipts showed reviewer, Riyadh timestamp, company, rationale, matching BFF/Odoo run UUID, and linked draft. Foreign-company customer approval was denied with no quote, audit event, or disclosure; Owner and foreign-company Sales could not read another users run. Odoo readback verified unchanged CRM stage, unchanged lead timestamp, immutable audit event, and unchanged mail count. A foreign-target Odoo AccessError surfaced as generic BFF 502, fail-closed with no sensitive data. An unconfirmed quotation precedes project creation, so project linkage is not applicable. Clone and temporary services were removed; source database and shared Odoo were unchanged. |

## Projects and scheduling

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-039 | P0 | Create project from awarded opportunity | 7.1, 7.4 | DONE | [Odoo award/project hook](../odoo/addons/be/be_tender/models/be_tender.py)<br>[company-scoped bridge](../addons/namaa_ai_bridge/models/extension.py)<br>[React CRM action](../frontend/src/BusinessWorkspace.jsx) | [Odoo bridge tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[live React journey](../frontend/e2e/crm-won-project.live.spec.js)<br>[native QA](build-engine/CRM_WON_PROJECT_ACCEPTANCE_QA.json)<br>[live QA](build-engine/CRM_WON_PROJECT_LIVE_QA.json)<br>[Checkpoint 349](build-engine/CHECKPOINT_349.md) | All supplied A1–A4 verified. Project Manager opens a project from a won opportunity; Odoo persists one company-scoped link and retry does not duplicate it. React reopens the project with name, company, creator and timestamp. Invalid ID/non-won opportunity are rejected; reader and foreign-company writes are denied without disclosure. |
| BE-040 | P0 | Create phases tasks subtasks and dependencies | 7.1 | DONE | [React project plan](../frontend/src/ProjectScheduleWorkspace.jsx)<br>[Odoo task bridge](../addons/namaa_ai_bridge/models/project_bridge.py)<br>[native project models](../odoo/addons/be/be_project) | [native bridge test](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[task payload tests](../backend/tests/test_business.py)<br>[React project-plan journey](../frontend/e2e/project-plan.spec.js)<br>[authenticated live journey](build-engine/PROJECT_PLAN_LIVE_QA.json)<br>[cycle/project-scope regression](build-engine/CHECKPOINT_333.md)<br>[Checkpoint 348](build-engine/CHECKPOINT_348.md) | All supplied criteria verified. An ordinary PM creates, edits and reopens native phases/tasks/dependencies in React; blank names return field-level errors with no partial row. Cycle creation and cross-project parent links are denied without changing task data. Reopened plan shows project/company, actor/time. Unauthorized and foreign-company writes are denied. Current React journey verifies English desktop and Arabic RTL mobile. |
| BE-041 | P0 | Assign crew and responsible persons | 7.1 | DONE | [React project plan](../frontend/src/ProjectScheduleWorkspace.jsx)<br>[Odoo task bridge](../addons/namaa_ai_bridge/models/project_bridge.py)<br>[native project models](../odoo/addons/be/be_project) | [native bridge test](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[task payload tests](../backend/tests/test_business.py)<br>[React project-plan journey](../frontend/e2e/project-plan.spec.js)<br>[authenticated live journey](build-engine/PROJECT_PLAN_LIVE_QA.json)<br>[Checkpoint 348](build-engine/CHECKPOINT_348.md) | All supplied criteria verified. Ordinary Project Managers assign project/field crew to phases and tasks through React; assignment and responsible actor persist on native tasks and reopen in the project plan. Invalid names are rejected atomically; unauthorized/foreign-company writes are denied. English desktop and Arabic RTL mobile rendering are covered. |
| BE-042 | P0 | Display Gantt and critical deadlines | 7.1 | DONE | [React project Gantt and critical path](../frontend/src/ProjectScheduleWorkspace.jsx)<br>[React portfolio Gantt](../frontend/src/ProjectPortfolioTimeline.jsx)<br>[Odoo-calendar duration analysis](../frontend/src/scheduleCriticalPath.js)<br>[Native project schedule](../odoo/addons/be/be_project/models/project_project.py)<br>[Company-scoped Odoo bridge](../addons/namaa_ai_bridge/models/project_bridge.py) | [Critical path/date tests](../frontend/tests/scheduleCriticalPath.test.js)<br>[Current-source authenticated React → BFF → Odoo QA](build-engine/PROJECT_PLAN_LIVE_QA.json)<br>[Native project-plan/security regressions 3/3](build-engine/PROJECT_PLAN_LIVE_QA.json)<br>[Live Gantt drag/resize and role test 1/1](build-engine/PROJECT_PLAN_LIVE_QA.json)<br>[Checkpoint 428](build-engine/CHECKPOINT_428.md) | Supplied acceptance criteria verified on a disposable current-source clone. An authorized Project Manager reopened the Odoo-backed Gantt, moved and resized a task, and verified its persisted dates, actor, timestamp and project/company. Invalid input is rejected without partial records; users without the project role and a foreign-company PM cannot read/write the project plan. Native project-plan/security tests passed 3/3 and authenticated React→BFF→Odoo browser journey passed 1/1. Clone dropped; source unchanged. Advanced resource leveling, employee-specific calendars, cross-project dependency paths and schedule float remain future planning extensions outside this story’s supplied acceptance criteria. |
| BE-043 | P1 | Detect crew and equipment double-booking | 7.1, 9.1 | DONE | [native overlap detection](../addons/namaa_ai_bridge/models/project_bridge.py)<br>[React project planning](../frontend/src/ProjectScheduleWorkspace.jsx) | [Current-source native project-plan security/conflict suite 3/3](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Authenticated live React→BFF→Odoo role acceptance](build-engine/PROJECT_PLAN_LIVE_QA.json)<br>[Conflict warning screenshot](build-engine/frontend/screenshots/live-project-resource-conflicts.png)<br>[Checkpoint 407](build-engine/CHECKPOINT_407.md) | All four supplied generic acceptance criteria are verified for advisory conflict detection. An authorized PM saved a dated task assigned to a crew member and shared crane; React/Odoo identified the overlapping same-company task in a second project and displayed both crew and equipment warnings. The source task reopened with its project/company, actor, timestamps and resource assignments. A blank task name returned field-level 422 with no partial write. Foreign-company access to the project plan was denied without disclosure. Native project-plan/security suite passed 3/3; current-source isolated React→BFF→Odoo browser journey passed 1/1. Conflict detection is advisory; it does not reserve resources or block assignment. Disposable clone and temporary BFF were removed; source database unchanged. |
| BE-044 | P1 | Configure project lifecycle stage template | 7.1, 9.4 | DONE | [Odoo lifecycle models](../odoo/addons/be/be_workflow)<br>[React lifecycle editor](../frontend/src/WorkflowTemplatesWorkspace.jsx)<br>[Project-type assignment](../frontend/src/ProjectTypeWorkflowPanel.jsx)<br>[Authenticated BFF](../backend/app/main.py) | [Native workflow tests](../odoo/addons/be/be_workflow/tests/test_be_workflow.py)<br>[Two-role live React → BFF → Odoo journey](build-engine/WORKFLOW_TEMPLATE_LIVE_QA.json)<br>[Checkpoint 410](build-engine/CHECKPOINT_410.md)<br>[authenticated foreign-company live QA](build-engine/WORKFLOW_TEMPLATE_LIVE_QA.json)<br>[Checkpoint 415](build-engine/CHECKPOINT_415.md) | All supplied criteria verified in the authenticated React→BFF→Odoo lifecycle editor journey. An Owner configured stages/transitions and approvers, published/versioned a template, assigned a project type and reopened the saved metadata. Invalid transition syntax returned 422 without a stored template. Same-company PM could read but not configure; a foreign-company Owner could neither list the template nor create a new version from it (403, no target name/code disclosure). Odoo readback confirmed project/company/version and assignment. Browser 1/1; disposable clone dropped and source unchanged. The separate module-upgrade suite remains blocked by the clone’s pre-existing dangling mail-tracking product reference and is not presented as passed. |
| BE-045 | P1 | Track project milestones and stakeholder obligations | 7.1 | DONE | [React project planning workspace](../frontend/src/ProjectScheduleWorkspace.jsx)<br>[company-scoped Odoo bridge](../addons/namaa_ai_bridge/models/project_bridge.py)<br>[native milestone model](../odoo/addons/be/be_project/models/project_milestone.py) | [Native bridge milestone lifecycle/security tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[React live journey](../frontend/e2e/project-plan.live.spec.js)<br>[isolated live QA runner](../scripts/run_project_plan_live_qa.py)<br>[QA evidence](build-engine/PROJECT_PLAN_LIVE_QA.json)<br>[Arabic phone screenshot](build-engine/frontend/screenshots/live-project-plan-milestones-arabic-390.png)<br>[Checkpoint 358](build-engine/CHECKPOINT_358.md) | All supplied criteria verified on a disposable current-source Odoo clone through React→BFF→Odoo: an authorized PM created and reopened a stakeholder obligation linked to a responsible user and task; blank milestone input returned a field-level 422 with no partial record; reopened state showed creator, creation time and company; an unauthorized user and foreign-company PM were denied; linked-task closure gates reaching the milestone; Arabic RTL phone rendering and audit details passed. Native Odoo tests 2/2 and authenticated live browser 1/1 passed. Clone dropped; shared source DB unchanged. |
| BE-046 | P2 | Draft project charter and obtain approval | 7.1 | DONE | [Native company governance](../odoo/addons/be/be_governance/models/governance.py)<br>[Promotion bridge](../addons/namaa_ai_bridge/models/crm_promotion_bridge.py)<br>[Charter bridge](../addons/namaa_ai_bridge/models/project_bridge.py)<br>[Owner policy UI](../frontend/src/GovernancePolicyWorkspace.jsx) | [Governance acceptance](build-engine/evidence/GOVERNANCE_ACCEPTANCE_20261110.json)<br>[Native tests](../odoo/addons/be/be_governance/tests/test_governance.py)<br>[Live browser matrix](../frontend/e2e/governance.acceptance.spec.js) | CP468: user accepted existing independent reviewer rules with per-company configuration (2026-11-10). Nine native and four real bilingual browser tests pass: Owner policy audit/revision; named reviewer restrictions; Sales request, independent approval/native conversion and rejection/no conversion; PM charter rejection/revision/resubmission/approval with immutable snapshots; invalid no-write and unauthorized/project/company denial. Fresh-session state/actor/time readback verified. Charter content is manual; AI drafting remains a separate draft workflow. No self-approval or automatic sending. Clone/services removed; see release evidence for deployment. |
| BE-047 | P2 | Record schedule baseline and change history | 7.1 | DONE | [Native baseline and immutable event models](../odoo/addons/be/be_workflow)<br>[React project-plan workspace](../frontend/src/ProjectScheduleWorkspace.jsx)<br>[Odoo project bridge](../addons/namaa_ai_bridge/models/project_bridge.py)<br>[Authenticated BFF routes](../backend/app/main.py) | [Current-source native + live QA](build-engine/PROJECT_PLAN_LIVE_QA.json)<br>[Checkpoint 361](build-engine/CHECKPOINT_361.md)<br>[Prior baseline evidence](build-engine/frontend/LIVE_SCHEDULE_BASELINE_QA.json)<br>[Checkpoint 87](build-engine/CHECKPOINT_87.md)<br>[Checkpoint 359](build-engine/CHECKPOINT_359.md) | All supplied acceptance criteria pass. Product owner approved an Owner-only decision policy: a Project Manager may submit; only a different Build Engine Owner may approve/reject; self-review is denied. Current-source native plan/milestone/baseline tests passed 3/3 and authenticated React→BFF→Odoo browser passed 1/1. Browser verified PM submission, Owner approval with rationale, reopened actor/time/company/task snapshot, invalid-input 422/no-write and foreign-company denial. Native regression now verifies a separate same-company PM cannot decide and the React capability is hidden for PMs. The isolated clone was dropped. [Checkpoint 409](build-engine/CHECKPOINT_409.md). |
| BE-048 | P2 | Close project after required reconciliations | 7.1 | DONE | [Native certification](../odoo/addons/be/be_project/models/be_project_closeout.py)<br>[Native source checks and Finance review](../addons/namaa_ai_bridge/models/project_closeout_policy.py)<br>[BFF review contract](../backend/app/closeout_policy.py)<br>[React closeout](../frontend/src/ProjectCloseoutWorkspace.jsx)<br>[Finance review](../frontend/src/CloseoutFinanceReview.jsx) | [24 native and 2 live browser checks](build-engine/evidence/CLOSEOUT_POLICY_ACCEPTANCE_20261114.json)<br>[Native policy cases](../addons/namaa_ai_bridge/tests/test_closeout_policy.py)<br>[Live specification](../frontend/e2e/closeout-policy.acceptance.spec.js)<br>[Policy and limits](adr/0023-project-closeout-finance-evidence.md)<br>[Checkpoint472](build-engine/CHECKPOINT_472.md) | User-approved gate accepted: no open punch items, unresolved project stock transfers/moves, project yard quantities, allocated equipment or draft/open analytically linked project invoices/bills. PM requests review; a different authorized Finance/Accounting user records financial and bank evidence and approves/rejects; the requesting PM certifies current approved evidence. Changed source snapshots require a new review. Exact UUID retries preserve immutable events; no direct audit ACL, self-review, unprivileged or foreign/unassigned-project disclosure. Fresh native readback confirms separate actors, timestamps/company, immutable request/review/certification receipts, zero blocker counts and no ledger/stock/outgoing-mail change or automatic archiving. English desktop/Arabic390px and client/report handover regressions pass; QA clone/services removed. Unlinked financial/bank rows require recorded human Finance evidence; no automatic bank matching, zero project profit/loss requirement or statutory certification is inferred. Existing certifications retain their historical evidence. |

## BOQ, BOM and cost control

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-049 | P0 | Create versioned project BOQ | 8.1 | DONE | [Native BOQ, section, line and immutable baseline models](../odoo/addons/be/be_boq)<br>[Named Odoo bridge](../addons/namaa_ai_bridge/models/boq_bridge.py)<br>[React BOQ editor and revision comparison](../frontend/src/BoqWorkspace.jsx)<br>[Revision diff logic](../frontend/src/boqRevisionComparison.js)<br>[BFF routes](../backend/app/main.py) | [Native BOQ suite](../odoo/addons/be/be_boq/tests/test_be_boq.py)<br>[Odoo bridge tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[React draft edit + prior-baseline journeys](../frontend/e2e/boq-draft-revision.spec.js)<br>[Live React→BFF→Odoo journeys](../frontend/e2e/boq.revision.live.spec.js)<br>[Isolated Odoo QA](build-engine/BOQ_DRAFT_REVISION_QA.json)<br>[Live QA](build-engine/BOQ_DRAFT_REVISION_LIVE_QA.json)<br>[Checkpoint 381](build-engine/CHECKPOINT_381.md)<br>[Arabic RTL/accessibility journey](build-engine/CHECKPOINT_340.md)<br>[Arabic screenshot](build-engine/frontend/screenshots/be049-live-ar-editor-rtl.png) | All four supplied criteria verified. Authenticated Project Manager edited and reopened a versioned draft with actor/time/project/company; invalid mandatory line name returned 422 and left version/lines unchanged; same-company non-QS and foreign-company QS could not read or mutate the source BOQ or create a BOQ, with no disclosure or writes. Existing Arabic RTL editor/revision-comparison journey passed. Odoo suite 31/31 and browser journeys 3/3 passed. Clone, temporary services and mode-0600 backup removed; source unchanged. |
| BE-050 | P0 | Import BOQ spreadsheet with mapping | 8.1, 9.3 | DONE | [React BOQ import dialog](../frontend/src/BoqImportDialog.jsx)<br>[React BOQ audit display](../frontend/src/BoqWorkspace.jsx)<br>[BFF parser/routes](../backend/app/boq_import.py)<br>[Odoo named BOQ bridge](../addons/namaa_ai_bridge/models/boq_bridge.py)<br>[native immutable source metadata and retry hash](../odoo/addons/be/be_boq/models/be_boq.py) | [BFF workbook/API tests](../backend/tests/test_business.py)<br>[Arabic import tests](../backend/tests/test_boq_import.py)<br>[Odoo retry/provenance/security tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[isolated history QA](build-engine/BOQ_IMPORT_HISTORY_QA.json)<br>[Arabic import QA](build-engine/BOQ_IMPORT_ARABIC_QA.json)<br>[checkpoint 327](build-engine/CHECKPOINT_327.md)<br>[checkpoint 328](build-engine/CHECKPOINT_328.md)<br>[mapping template QA](build-engine/BOQ_MAPPING_TEMPLATES_QA.json)<br>[React import journey](../frontend/e2e/boq.spec.js)<br>[current-source authenticated React→BFF→Odoo acceptance](../frontend/e2e/boq.import.live.spec.js)<br>[Checkpoint 390](build-engine/CHECKPOINT_390.md)<br>[live QA](build-engine/BE050_BOQ_IMPORT_LIVE_QA.json) | React supports bilingual `.xlsx` column mapping, row preview and field errors; Arabic headers receive suggestions and Arabic/Persian digits, separators and item types are parsed. Company-scoped saved mappings can be reused. Current-source isolated live acceptance verified an authorized Quantity Surveyor imports a real XLSX to a draft BOQ, sees the saved line and total after reopening, and sees immutable importer/time/project/company/source filename/SHA-256/mapping/row count provenance; workbook bytes are not retained. Same-company ordinary reader and foreign-company QS were denied without disclosure. Native Odoo BOQ/bridge suite 27/27 and authenticated import browser journey 1/1 passed; existing parser/API tests cover malformed workbook/mapping inputs and native retry tests reject changed retry content. Disposable clone removed and source DB unchanged. This closes the supplied BOQ spreadsheet import story. Cross-entity master-data templates and distinct import-history search/retention capabilities are extensions, not criteria for this story. |
| BE-051 | P0 | Capture labor material equipment and work lines | 8.1 | DONE | [Odoo BOQ models and Quantity Surveyor role](../odoo/addons/be/be_boq)<br>[React BOQ editor](../frontend/src/BoqWorkspace.jsx)<br>[Odoo bridge](../addons/namaa_ai_bridge/models/boq_bridge.py) | [native bridge tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[React BOQ unit tests](../frontend/tests/boq.test.js)<br>[mocked and live React browser journeys](../frontend/e2e/boq.spec.js)<br>[live React/Odoo QA](build-engine/BOQ_QUANTITY_SURVEYOR_LIVE_QA.json)<br>[Checkpoint 350](build-engine/CHECKPOINT_350.md) | All supplied A1–A4 verified. The dedicated Quantity Surveyor role creates, edits and reopens work/material/labour/equipment lines in React; Odoo persists calculated amounts, actor/time, project and company. Invalid payloads create no partial BOQ; public and foreign-company actions are denied. Baseline confirmation is denied to the capture role. Native clone tests 3/3, React units 90/90, mocked BOQ journeys 5/5, live authenticated journey 1/1, and production build passed. |
| BE-052 | P0 | Draft BOQ from drawings and scope with AI | 8.1, 9.1 | DONE | [backend/app/boq_ai.py](../backend/app/boq_ai.py)<br>[backend/app/main.py](../backend/app/main.py)<br>[frontend/src/BoqWorkspace.jsx](../frontend/src/BoqWorkspace.jsx) | [backend/tests/test_boq_ai.py](../backend/tests/test_boq_ai.py)<br>[frontend/e2e/boq.spec.js](../frontend/e2e/boq.spec.js)<br>[addons/namaa_ai_bridge/tests/test_bridge.py](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[QA evidence](build-engine/evidence/BE-052_AI_BOQ_DRAFT_QA.json)<br>[Checkpoint 445](build-engine/CHECKPOINT_445.md) | All five supplied criteria pass: validated estimator-reviewed draft persistence in authoritative Odoo; invalid input creates no partial BOQ; reopened provenance/actor/time/project/company; foreign project and invalid UOM denied; uncertain AI content stays draft-only and never self-approves. Native Odoo 2/2, backend 11/11, React journey 1/1. Drawing bytes are ephemeral per ADR0016. QS accuracy and live local-model evaluation remain quality follow-up, not supplied AC. |
| BE-053 | P1 | Validate units rates and quantity totals | 8.1 | DONE | [Odoo BOQ line model](../odoo/addons/be/be_boq/models/be_boq_line.py)<br>[BFF strict payload contract](../backend/app/contracts.py)<br>[React BOQ validation and currency-rounded totals](../frontend/src/boq.js)<br>[React BOQ editor](../frontend/src/BoqWorkspace.jsx) | [Odoo BOQ tests](../odoo/addons/be/be_boq/tests/test_be_boq.py)<br>[React validation tests](../frontend/tests/boq.test.js)<br>[Live React journey](../frontend/e2e/boq.validation.live.spec.js)<br>[Isolated acceptance evidence](build-engine/BE053_BOQ_VALIDATION_LIVE_QA.json)<br>[Screenshot](build-engine/frontend/screenshots/be053-live-boq-units-rates-total.png)<br>[Checkpoint 378](build-engine/CHECKPOINT_378.md) | All four supplied criteria passed for the Quantity Surveyor: valid units/rates/quantities persisted in authoritative Odoo; invalid zero quantity and invalid UOM returned field-level errors with no write; reopened draft showed actor, time, project and company; same-company non-QS and foreign-company QS were denied without disclosure or write. Fractional SAR lines rounded to 0.14 and 0.07 with a 0.21 total, consistent with currency precision. Current clone native BOQ/bridge suite passed 26/26 and the authenticated React→BFF→Odoo live browser journey passed 2/2. Clone dropped; source fingerprint unchanged; Odoo healthy. |
| BE-054 | P1 | Approve BOQ baseline and lock revision | 8.1 | DONE | [Odoo BOQ baseline lifecycle](../odoo/addons/be/be_boq/models/be_boq.py)<br>[React Owner decision flow](../frontend/src/BoqWorkspace.jsx)<br>[Company-scoped Odoo bridge](../addons/namaa_ai_bridge/models/boq_bridge.py) | [Native lifecycle regression](../odoo/addons/be/be_boq/tests/test_be_boq.py)<br>[Native cross-company decision denial](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Live React→BFF→Odoo approval QA](build-engine/BOQ_BASELINE_OWNER_APPROVAL_LIVE_QA.json)<br>[Checkpoint 425](build-engine/CHECKPOINT_425.md) | The supplied acceptance criteria passed on a disposable current-source clone. PM submitted a BOQ from React; self-approval and a foreign-company Owner decision were denied without changing the pending baseline. An independent Owner approved with rationale; actor/time and state reopened in React. Invalid rationale returned 422. Four focused native tests and the live browser journey passed; clone removed and source database unchanged. DEC-06 is resolved for this story by the user's independent Owner approval decision. |
| BE-055 | P1 | Create variation order with impact analysis | 8.1 | DONE | [Odoo variation order and confirmed BOQ controls](../odoo/addons/be/be_variation/models/be_variation_order.py)<br>[React contract variations and advisory panel](../frontend/src/ContractVariations.jsx)<br>[Odoo source snapshot, revision guard and audit draft](../addons/namaa_ai_bridge/models/variation_impact_bridge.py)<br>[BFF routes and strict contracts](../backend/app/main.py) | [Native variation lifecycle tests](../odoo/addons/be/be_variation/tests/test_be_variation.py)<br>[Impact bridge tests](../addons/namaa_ai_bridge/tests/test_variation_impact.py)<br>[Mocked React flow](../frontend/e2e/contracts.spec.js)<br>[Authenticated React → BFF → Qwen → Odoo acceptance](build-engine/VARIATION_IMPACT_LIVE_QA.json)<br>[React-created variation/advisory screenshot](build-engine/frontend/screenshots/live-variation-created-advisory.png)<br>[Checkpoint 417](build-engine/CHECKPOINT_417.md) | Supplied acceptance verified on an isolated clone. A Project Manager created a new variation in React and Odoo readback confirmed draft state, creator, project/company, BOQ line, quantity delta and calculated SAR amount. The PM generated a pending source-cited impact advisory from that record; uncertainty and sources reopened, and the advisory did not approve/apply it. Unsupported language returned 422 without creating a draft. Same-company read-only and foreign-company PM could not list variations or read/write advisory drafts, with no project/company disclosure. Odoo also verified approved and rejected requests separately by an independent Owner under the scoped DEC-06 policy. Native impact bridge 4/4, native variation suite 21/21 (clean isolated DB), mocked React journey 1/1 and authenticated live browser 1/1 passed. Clone/services removed; source DB unchanged. Pending advice is bound to its source revision and must be regenerated if the BOQ changes.
| BE-056 | P2 | Approve/reject variation order with audit trail | 8.1 | DONE | [Owner-only native decision and immutable audit fields](../odoo/addons/be/be_variation/models/be_variation_order.py)<br>[React review actions and rationale dialog](../frontend/src/ContractVariations.jsx)<br>[Odoo bridge and capability checks](../addons/namaa_ai_bridge/models/contracts_bridge.py)<br>[BFF rationale validation](../backend/app/contracts.py) | [Native variation approval tests](../odoo/addons/be/be_variation/tests/test_be_variation.py)<br>[Mocked React approval flow](../frontend/e2e/contracts.spec.js)<br>[Authenticated approve/reject, self-review and rationale acceptance](build-engine/VARIATION_IMPACT_LIVE_QA.json)<br>[Checkpoint 417](build-engine/CHECKPOINT_417.md) | All supplied decision criteria passed. Requester approval returned 403 and left the order submitted; short rationale returned 422 with no state change. An independent Owner approved one submitted variation and rejected another through React with required rationale. Fresh Odoo readback confirmed immutable decision, actor, timestamp and rationale; approval applied the BOQ quantity once and preserved the prior baseline, while rejection made no BOQ change. Same-company reader and foreign-company PM could not list the contract variations or access advisory records. Native variation suite 21/21 on a clean isolated DB, BFF/backend rationale test, mocked React flow 1/1 and authenticated approve/reject browser journey 1/1 passed. Clone/services removed; source database unchanged. DEC-06 remains provisional policy for the other workflows named in OPEN_DECISIONS.md.
| BE-057 | P2 | Compare estimated vs actual consumption and costs | 7.5, 8.1 | DONE | [Native BOQ actuals](../odoo/addons/be/be_boq/models/be_boq_line.py)<br>[Source-entry audit bridge](../addons/namaa_ai_bridge/models/boq_actual_sources.py)<br>[React comparison](../frontend/src/BoqWorkspace.jsx)<br>[Actual source records](../frontend/src/BoqActualSources.jsx) | [Native stock/capture acceptance](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[BFF boundaries](../backend/tests/test_portfolio_financials.py)<br>[Live bilingual comparison](../frontend/e2e/boq-consumption.acceptance.spec.js)<br>[Isolated evidence](build-engine/evidence/BE057_CONSUMPTION_ACCEPTANCE_20261108.json) | All supplied read-only plan/actual comparison criteria verified: three native methods and two production-build browser journeys pass. Approved plan 20 units/SAR 1,000 is compared with native net issue/return actual 3 units/SAR 150, yielding quantity variance -17 and cost variance -850. An unposted site capture of seven units remains separate and changes neither stock nor BOQ actuals. Authorized QS with required native source-read permissions reopens actual entries with issuer/time/project/company; invalid IDs and ordinary/foreign access are denied. Fixed a global sidebar-style collision that blocked the BOQ source-record button. Comparisons use native operational actuals and do not approve DEC-18 valuation or GL-recognition policy. |
| BE-058 | P2 | Link manufacturing BOM where applicable | 8.1 | DONE | [odoo/addons/be/be_boq_mrp](../odoo/addons/be/be_boq_mrp)<br>[addons/namaa_ai_bridge/models/boq_bridge.py](../addons/namaa_ai_bridge/models/boq_bridge.py)<br>[frontend/src/BoqWorkspace.jsx](../frontend/src/BoqWorkspace.jsx) | [native model tests](../odoo/addons/be/be_boq_mrp/tests)<br>[bridge tests](../addons/namaa_ai_bridge/tests/test_boq_manufacturing.py)<br>[React tests](../frontend/tests/boq.test.js)<br>[live browser journey](../frontend/e2e/boq.manufacturing.live.spec.js)<br>[QA evidence](build-engine/BOQ_MRP_LIVE_QA.json) | Accepted live through React→BFF→Odoo with a Project Manager and Stock/MRP read access: create BOQ with a BoM line, sign in after reload and reopen, clear and restore the link, then confirm. Native postconditions verify the draft line and immutable baseline both reference the selected BoM. Native addon 3/3, bridge 2/2, React unit 6/6, backend contract 1/1 (4 subtests), mocked browser 1/1, live browser 1/1. See [Checkpoint 267](build-engine/CHECKPOINT_267.md). |

## Procurement and suppliers

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-059 | P0 | Maintain approved supplier directory | 7.5 | DONE | [Odoo qualification model](../odoo/addons/be/be_supplier/models/supplier_qualification.py)<br>[React supplier qualification workspace](../frontend/src/SupplierQualificationWorkspace.jsx)<br>[Odoo bridge](../addons/namaa_ai_bridge/models/supplier_qualification_bridge.py)<br>[BFF routes/contracts](../backend/app/main.py) | [native isolated QA](build-engine/SUPPLIER_QUALIFICATION_NATIVE_QA.json)<br>[live React → BFF → Odoo QA](build-engine/SUPPLIER_QUALIFICATION_LIVE_QA.json)<br>[native tests](../odoo/addons/be/be_supplier/tests/test_supplier_qualification.py)<br>[BFF tests](../backend/tests/test_business.py)<br>[submitted screenshot](build-engine/frontend/screenshots/supplier-qualification-submitted-live.png)<br>[approved screenshot](build-engine/frontend/screenshots/supplier-qualification-approved-live.png)<br>[Arabic screenshot](build-engine/frontend/screenshots/supplier-qualification-approved-live-ar.png)<br>[Checkpoint 245](build-engine/CHECKPOINT_245.md)<br>[Checkpoint 447](build-engine/CHECKPOINT_447.md) | All supplied criteria verified. Procurement submitted a company-scoped supplier qualification; a separate Build Engine Owner approved it with mandatory rationale. Requester self-review and Purchase Manager approval/rejection are denied; an Owner who submitted the request cannot decide it. Approval and rejection record actor/time/rationale in immutable events. Missing scope is rejected without creating a record; unauthorized and foreign-company access is denied. Native QA passed 7/7; authenticated live React → BFF → Odoo Owner review passed 1/1, with the request and decision reopened in Arabic/English. No AI content is generated in this workflow, so the AI-review criterion is not applicable. Approval is internal and does not assert Saudi regulatory certification. Clone and temporary services removed; source database unchanged. Supplier evidence formats and downstream purchasing eligibility remain separate extensions, not acceptance criteria for this story.|
| BE-060 | P0 | Create material request linked to BOQ | 7.5, 8.1 | DONE | [BOQ/OCA request extension](../odoo/addons/be/be_boq/models/purchase_request_line.py)<br>[OCA request and RFQ wizard](../odoo/addons/oca20/purchase-workflow/purchase_request)<br>[React material requests](../frontend/src/MaterialRequestsWorkspace.jsx)<br>[Odoo bridge](../addons/namaa_ai_bridge/models/purchase_request_bridge.py) | [Native Odoo authorization and linkage tests](../odoo/addons/be/be_boq/tests/test_be_boq_purchase_request.py)<br>[bridge tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[field validation and no-write test](../backend/tests/test_business.py)<br>[3 live isolated React journeys and native postconditions](build-engine/MATERIAL_REQUEST_FULFILLMENT_LIVE_QA.json)<br>[Checkpoint194](build-engine/CHECKPOINT_194.md)<br>[Checkpoint206 authorization guidance](build-engine/CHECKPOINT_206.md) | All four acceptance criteria verified. React requester created/submitted a request tied to a confirmed same-company BOQ material line; procurement reviewer approved it and created the native OCA RFQ; Odoo PO/receipt recorded 8 ordered and 3 received, and React reopened 5 outstanding. Reopened rows show responsible requester, Riyadh-local created/updated timestamps, company and project. Missing required date returns a field error before any Odoo call. Separate-company tests show only own requests/BOQ options, deny forged cross-company links without disclosure or persistence; native no-project-role tests deny BOQ-linked create/write. The demo now explains role/active-company requirements after a denied action; no ACLs were loosened. |
| BE-061 | P0 | Draft and review RFQ to selected suppliers | 7.5 | DONE | [Odoo native purchase alternatives](../vendor/odoo/addons/purchase_alternative)<br>[React alternatives panel](../frontend/src/PurchaseAlternativesPanel.jsx)<br>[Odoo bridge](../addons/namaa_ai_bridge/models/extension.py)<br>[BFF routes](../backend/app/main.py) | [native Odoo test](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[BFF contract/route tests](../backend/tests/test_business.py)<br>[live React journey](../frontend/e2e/purchase-alternatives.live.spec.js)<br>[isolated QA evidence](build-engine/PURCHASE_ALTERNATIVES_LIVE_QA.json)<br>[Checkpoint 207](build-engine/CHECKPOINT_207.md) | All applicable supplied criteria are verified. An authorized Procurement user selected eligible suppliers and created two native Odoo RFQ alternatives from the open source RFQ; the React workspace reopened both as drafts with source/project/company and creator/timestamp audit. Empty supplier input returned field-level 422 without creating alternatives. Same-company reader and foreign-company Procurement users were denied without disclosing RFQ or supplier data and created no records. Current-source isolated Odoo alternative test 1/1 and authenticated React→BFF→Odoo browser journey 1/1 passed; clone, registry, BFF and proxy were removed; source DB unchanged. The generic AI draft clause is not applicable because this path uses user-entered supplier selection and creates no AI content. RFQs remain drafts; no send/email action occurs. |
| BE-062 | P0 | Record supplier quotations and validity | 7.5 | DONE | [native Odoo RFQ quote fields](../addons/namaa_ksa_purchase/models/extension.py)<br>[per-line compliance evidence](../addons/namaa_ksa_purchase/models/quote_compliance.py)<br>[React supplier quote panel](../frontend/src/PurchaseAlternativesPanel.jsx)<br>[Odoo bridge](../addons/namaa_ai_bridge/models/purchase_quote_bridge.py)<br>[BFF route](../backend/app/main.py) | [native Odoo acceptance tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[isolated live React journey](../frontend/e2e/purchase-quote.live.spec.js)<br>[QA evidence](build-engine/PURCHASE_QUOTE_LIVE_QA.json)<br>[Checkpoint 360](build-engine/CHECKPOINT_360.md) | All supplied BE-062 criteria verified on a disposable current-source clone: an authorized procurement user records and reopens supplier reference, received/valid-through dates, every quoted unit price, reviewed line compliance evidence, actor/time and company/project; invalid dates return a field-level 422 without partial changes; unauthorized and foreign-company writes are denied; stale revisions and unsafe retries are rejected. Native Odoo 2/2 and authenticated React→BFF→Odoo browser 1/1 passed. The clone and temporary services were removed. External RFQ sending/review belongs to BE-061; DEC-23 still governs which evidence types each business accepts and is not resolved by this story. |
| BE-063 | P1 | Compare landed prices and delivery dates | 9.1 | DONE | [Native quote fields and review](../addons/namaa_ai_bridge/models/purchase_quote_bridge.py)<br>[React comparison](../frontend/src/PurchaseAlternativesPanel.jsx)<br>[Weighted product/UOM comparison](../frontend/src/purchaseQuoteComparison.js) | [Native quote/role/alternative tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Comparison regressions](../frontend/tests/purchaseQuoteComparison.test.js)<br>[Real browser acceptance](../frontend/e2e/landed-comparison.acceptance.spec.js)<br>[Isolated evidence](build-engine/evidence/BE063_LANDED_COMPARISON_ACCEPTANCE_20261108.json) | All supplied recorded-quote comparison criteria verified: three native methods and two production-build React→BFF→Odoo browser journeys pass. Supplier quote prices, dates and reviewer/time/company persist and reopen; invalid quote dates create no partial changes, and reader/foreign-company reads are denied. Fixed repeated product/UOM lines to use quantity-weighted landed unit price and the last complete delivery date rather than silently overwriting a line. Missing price/date data cannot win ranking. Three unit-price/delivery cases plus two split-line regressions cover aggregation. Comparison highlights cheapest estimate and earliest expected delivery independently and leaves RFQs as drafts. Actual receipt/invoice reconciliation, delivery-performance history, award authority and DEC-23 evidence policy remain separate controls. |
| BE-064 | P1 | Flag quote anomalies for human review | 7.5, 9.1 | DONE | [React quote anomaly review](../frontend/src/PurchaseWorkspace.jsx)<br>[Odoo anomaly model and bridge](../addons/namaa_ai_bridge/models/purchase_quote_anomaly_bridge.py)<br>[Procurement review agent](../services/platform/app/agents/procurement) | [Native isolated QA](build-engine/QUOTE_ANOMALY_NATIVE_QA.json)<br>[Authenticated live QA](build-engine/QUOTE_ANOMALY_LIVE_QA.json)<br>[Review screenshot](build-engine/frontend/screenshots/live-quote-anomaly-review.png)<br>[Flagged audit screenshot](build-engine/frontend/screenshots/live-quote-anomaly-flagged.png)<br>[Checkpoint 363](build-engine/CHECKPOINT_363.md) | All four supplied criteria verified: authorized buyer persisted a human-review anomaly in Odoo; invalid/short reason returned field-level errors and API 422 with no mutation; reopening showed review state, actor/time/project/company; unauthorized reader and foreign-company buyer were denied without sensitive quote data or writes. Native Hoot target 1/1 and authenticated React→BFF→Odoo browser journey passed. Disposable clone and temporary services were removed; source DB unchanged. |
| BE-065 | P1 | Approve purchase before commitment | 7.5 | DONE | [React purchase detail and Owner review](../frontend/src/BusinessWorkspace.jsx)<br>[FastAPI purchase commitment routes](../backend/app/main.py)<br>[Append-only Odoo approval events and native confirmation guard](../odoo/addons/be/be_supplier/models/purchase_commitment_event.py) | [Current-source native lifecycle/role tests](../odoo/addons/be/be_supplier/tests/test_purchase_commitment.py)<br>[Focused API validation and ACL test](../backend/tests/test_business.py)<br>[React request → Owner decision → reopen journey](../frontend/e2e/purchase-commitment.spec.js)<br>[QA artifact](build-engine/evidence/BE-065_PURCHASE_COMMITMENT_QA.json)<br>[Checkpoint 435](build-engine/CHECKPOINT_435.md) | All five supplied criteria pass. Procurement request is persisted; invalid reason returns field-level validation without an event; reopened status records company/project, request/decision actors, timestamps and rationale; unauthorized and foreign-company users are denied; confirmation is blocked until an independent Build Engine Owner approves the current purchase-order snapshot. Rejection leaves the RFQ draft; event write/unlink are denied and rationale history is append-only. Current-source native tests 2/2, API test 1/1, React request/review/reopen browser journey 1/1, build and compile passed. React browser/API roles are mocked; live partner UAT remains useful operational validation. Temporary QA DBs were dropped. |
| BE-066 | P2 | Receive materials into correct location | 7.5 | DONE | [React receipt workspace](../frontend/src/PurchaseReceiptsWorkspace.jsx)<br>[BFF receipt API](../backend/app/main.py)<br>[Odoo receipt bridge](../addons/namaa_ai_bridge/models/purchase_receipt_bridge.py)<br>[Odoo stock/purchase](../vendor/odoo/addons/stock) | [native bridge tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[backend contract test](../backend/tests/test_business.py)<br>[React browser suite](../frontend/e2e/purchase-receipts.spec.js)<br>[authenticated live QA](build-engine/PURCHASE_RECEIPT_TRACKED_LIVE_QA.json)<br>[Checkpoint 347](build-engine/CHECKPOINT_347.md)<br>[QA summary](build-engine/RECEIPT_DESTINATION_ACCEPTANCE_QA.json) | All supplied A1–A4 verified. An authorized Stock User selects a same-warehouse internal/project bin and validates the PO receipt. Odoo persists the location, exact quantity and lot/serial; invalid/foreign locations and bad quantities are denied without partial stock changes. React reopens the receipt with company/project, responsible validator and timestamp. Native role/company checks deny unauthorized access; authenticated live lot and serial journeys verify native stock and backorders. |
| BE-067 | P2 | Detect stock shortage against schedule | 7.5, 9.1 | DONE | [Odoo shortage review model](../odoo/addons/be/be_project/models)<br>[React schedule workspace](../frontend/src/ProjectScheduleWorkspace.jsx)<br>[Authenticated BFF route](../backend/app/main.py) | [Backend tests 3/3](../backend/tests)<br>[Mocked Playwright 1/1](../frontend/e2e/project-plan.spec.js)<br>[Current-source live QA](build-engine/SCHEDULE_SHORTAGE_LIVE_QA.json)<br>[Checkpoint 367](build-engine/CHECKPOINT_367.md) | All four supplied criteria verified: scheduled task quantity was compared with dated project-location forecast; invalid cross-project location returned `fields.location_id` 422 with no snapshot; authorized reviewer saved and reopened the shortage with actor/time/project/company; no-role and foreign-company operations were denied. Native inventory readback confirmed 10 required, 5 forecast and 5 shortage; BOQ over-allocation was rejected. Authenticated React→BFF→Odoo fresh-session reopen passed. Clone/temp services removed and source unchanged. This advisory does not reserve stock or create an RFQ. |
| BE-068 | P2 | Track vendor performance and RFQ history | 7.5 | DONE | [Native performance models](../odoo/addons/be/be_vendor_performance)<br>[Read-only Odoo bridge](../addons/namaa_ai_bridge/models/vendor_performance_bridge.py)<br>[Authenticated BFF](../backend/app/main.py)<br>[React performance register](../frontend/src/VendorPerformanceWorkspace.jsx)<br>[Odoo Purchase](../vendor/odoo/addons/purchase)<br>[Odoo Purchase Stock](../vendor/odoo/addons/purchase_stock) | [Native business tests](../odoo/addons/be/be_vendor_performance/tests/test_vendor_performance.py)<br>[Bridge clone tests](../addons/namaa_ai_bridge/tests/test_vendor_performance_bridge.py)<br>[BFF tests](../backend/tests/test_vendor_performance.py)<br>[React metrics tests](../frontend/tests/vendorPerformance.test.js)<br>[English/Arabic preview](../frontend/e2e/vendor-performance.spec.js)<br>[Disposable-clone evidence](build-engine/BE068_VENDOR_PERFORMANCE_QA.json)<br>[Checkpoint BE068](build-engine/CHECKPOINT_BE068_20261030.md)<br>[Authenticated live QA](build-engine/BE068_VENDOR_PERFORMANCE_LIVE_QA.json)<br>[Live screenshot](build-engine/frontend/screenshots/live-vendor-performance.png) | All supplied acceptance criteria pass for the read-only vendor history/report. Product owner accepted calendar-day RFQ response and delivery-variance definitions; the React report labels calendar days and assigns no weighted score or automated ranking. Native derived-metric tests 2/2, bridge tests 2/2, BFF tests 5/5, React metric tests 4/4, English/Arabic preview 2/2, and current-source authenticated React→BFF→Odoo role/company browser 1/1 pass. The purchase user saw own-company RFQ/receipt history and pending filter results; the foreign-company order was excluded; a non-Purchase reader received 403 without disclosure. This is read-only, so mutation/reopen actor checks are not applicable. Disposable clone and temporary BFF were removed. [Checkpoint 409](build-engine/CHECKPOINT_409.md). |

## Inventory and warehouses

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-069 | P0 | Create warehouses and site stock locations | 7.5 | DONE | [React workspace](../frontend/src/ProjectSiteLocationsWorkspace.jsx)<br>[Odoo bridge](../addons/namaa_ai_bridge/models/inventory_site_bridge.py)<br>[native stock](../vendor/odoo/addons/stock) | [Odoo bridge tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[mocked React journey](../frontend/e2e/project-site-locations.spec.js)<br>[current native QA](build-engine/SITE_LOCATION_ACCEPTANCE_QA.json)<br>[prior live QA](build-engine/CHECKPOINT_157.md)<br>[Checkpoint 346](build-engine/CHECKPOINT_346.md) | All supplied A1–A4 criteria verified. An authorized Stock Manager creates a native warehouse with standard receipt/delivery configuration and a project stock location; Odoo validates fields and denies unauthorized/cross-company project access. React shows the reopened location, creator, timestamp, project and company. Invalid input does not create a partial record. Current native tests 2/2, React browser 1/1, prior authenticated live warehouse/site-location flow 1/1 and production build pass. The separate legacy QA recheck did not start due to its missing `be_crm_lead_code` table; clone dropped. Remaining warehouse lifecycle/policy is covered by other inventory stories, not this supplied story. |
| BE-070 | P0 | Receive materials against purchase order | 7.5 | DONE | [React receipt workspace](../frontend/src/PurchaseReceiptsWorkspace.jsx)<br>[BFF receipt API](../backend/app/main.py)<br>[native Odoo receipt bridge](../addons/namaa_ai_bridge/models/purchase_receipt_bridge.py)<br>[Odoo stock/purchase](../vendor/odoo/addons/stock) | [native bridge tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[BFF contract test](../backend/tests/test_business.py)<br>[React browser suite](../frontend/e2e/purchase-receipts.spec.js)<br>[authenticated live lot/serial evidence](build-engine/PURCHASE_RECEIPT_TRACKED_LIVE_QA.json)<br>[Checkpoint 345](build-engine/CHECKPOINT_345.md)<br>[QA summary](build-engine/PURCHASE_RECEIPT_AUDIT_QA.json) | All supplied criteria verified. An authorized Stock/Purchase receiver validates a PO receipt and Odoo persists the native picking, received quantities, lot/serial identities, project bin and backorder. Invalid quantities are rejected without partial stock changes; BFF returns `fields.lines`, and the React form associates/announces the error. Reopened React state shows status, company, destination project, validator and completion timestamp. Native role/company tests deny unauthorized or foreign-company receipt operations without disclosure. The separate AI draft criterion is not applicable because this workflow produces no AI content. |
| BE-071 | P0 | Transfer material to project site | 7.5 | DONE | [vendor/odoo/addons/stock](../vendor/odoo/addons/stock)<br>[vendor/odoo/addons/purchase_stock](../vendor/odoo/addons/purchase_stock) | [vendor/odoo/addons/stock/tests](../vendor/odoo/addons/stock/tests)<br>[vendor/odoo/addons/purchase_stock/tests](../vendor/odoo/addons/purchase_stock/tests) | All supplied generic A1–A4 criteria are verified. Authenticated Stock Manager created and validated a lot-tracked native internal transfer with exact lot, project/company, actor/time and persisted backorder; invalid quantity and unauthorized/foreign-company cases are denied. See checkpoint122 for live and native evidence. |
| BE-072 | P0 | Issue material to project and BOQ line | 7.5, 8.1 | DONE | [native BOQ stock-move-line link](../odoo/addons/be/be_boq/models/stock_move_line.py)<br>[native analytic/BOQ link](../odoo/addons/be/be_boq/models/stock_analytic_move.py)<br>[site usage model](../odoo/addons/be/be_site/models/be_site_material_usage.py)<br>[native issue bridge](../addons/namaa_ai_bridge/models/site_bridge.py)<br>[React issue/return workspace](../frontend/src/SiteMaterialIssuesWorkspace.jsx)<br>[React BOQ actuals](../frontend/src/BoqWorkspace.jsx)<br>[authenticated BFF](../backend/app/main.py) | [Current-source acceptance](build-engine/evidence/MATERIAL_ISSUE_ACCEPTANCE_20261111.json)<br>[Live purchase/issue/return journey](../frontend/e2e/site-material-issues-live.spec.js)<br>[Live role/company acceptance](../frontend/e2e/material-issue-boundary.acceptance.spec.js) | CP469: user accepted configured native stock valuation/ledger rules, net completed issues minus returns, and separate vendor-bill expenses. Three native tests plus the live purchase-to-issue and role/company journeys passed on a disposable clone. Independently approved PO receives eight lot units at SAR 40 into the project yard; the posted SAR 320 vendor bill stays separate. Warehouse user issues six and returns two, yielding four units/SAR 160 net BOQ actual; serial issue/return yields one unit/SAR 55. Native readback verifies exact lots/serials, project/company, actor/timestamps, original return links, maintenance valuation and unchanged default delivery settings. Reader/Site/QS without stock privileges and unassigned/foreign stock users cannot issue the target project; fresh-session history preserves provenance. |
| BE-073 | P1 | Return unused material to yard | 7.5 | DONE | [vendor/odoo/addons/stock](../vendor/odoo/addons/stock)<br>[vendor/odoo/addons/purchase_stock](../vendor/odoo/addons/purchase_stock) | [vendor/odoo/addons/stock/tests](../vendor/odoo/addons/stock/tests)<br>[vendor/odoo/addons/purchase_stock/tests](../vendor/odoo/addons/purchase_stock/tests) | All supplied acceptance criteria are verified: ordinary Warehouse Officer can return unused material through React/native Odoo, preserves exact lot/serial, BOQ/project/company, actor/time and cost reversal; invalid/over-return and unauthorized/foreign-company actions are denied. |
| BE-074 | P1 | Perform stock count and variance approval | 7.5 | DONE | [vendor/odoo/addons/stock](../vendor/odoo/addons/stock)<br>[vendor/odoo/addons/purchase_stock](../vendor/odoo/addons/purchase_stock) | [vendor/odoo/addons/stock/tests](../vendor/odoo/addons/stock/tests)<br>[vendor/odoo/addons/purchase_stock/tests](../vendor/odoo/addons/purchase_stock/tests) | All supplied acceptance criteria are verified: Stock Officer submits a quant snapshot, a different Stock Manager reviews/applies or rejects variance through native Odoo inventory adjustment, with stale snapshot, self-approval, access and audit controls. |
| BE-075 | P1 | Track minimum stock and reorder alerts | 7.5 | DONE | [vendor/odoo/addons/stock](../vendor/odoo/addons/stock)<br>[vendor/odoo/addons/purchase_stock](../vendor/odoo/addons/purchase_stock) | [vendor/odoo/addons/stock/tests](../vendor/odoo/addons/stock/tests)<br>[vendor/odoo/addons/purchase_stock/tests](../vendor/odoo/addons/purchase_stock/tests) | All supplied acceptance criteria are verified using native stock.warehouse.orderpoint through React. Stock Managers create/update/archive/restore company/project rules; Stock Users view forecast and suggested amounts. Suggestions remain advisory and use purchase-request approval. |
| BE-076 | P2 | Prevent negative stock per configuration | 7.5 | DONE | [Native stock policy and quant guard](../odoo/addons/be/be_inventory_policy)<br>[Owner policy React workspace](../frontend/src/InventoryPolicyWorkspace.jsx)<br>[Strict BFF API](../backend/app/inventory_policy.py) | [Current-source acceptance](build-engine/evidence/INVENTORY_POLICY_ACCEPTANCE_20261112.json)<br>[Native guard tests](../odoo/addons/be/be_inventory_policy/tests/test_inventory_policy.py)<br>[Live configuration/concurrency tests](../frontend/e2e/inventory-policy.acceptance.spec.js) | CP470: user selected hard insufficient-stock blocking with no transaction bypass. Six native and two live browser tests passed. An Owner configures the active company policy with reason/revision/UUID and immutable actor/time history. Enabled policy protects native internal/transit quant changes, direct adjustments, lots, sudo and caller bypass flags; external supplier/customer locations retain native behavior. Existing negative balances can be repaired by receipts. Product/company locks protect native concurrent depletion and policy changes. Real concurrent deliveries for one available unit complete exactly one delivery; forced overdraw commits no movement and native on-hand remains non-negative. Fresh session preserves policy and stock actors/time/company; stock/general readers cannot change policy, and foreign-company sessions cannot see or override it. Existing companies retain native behavior until an explicit company policy is enabled. |

## Accounting and ZATCA

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-077 | P0 | Assign analytic project cost center | 7.2, 7.3 | DONE | [Odoo project analytic assignment bridge](../addons/namaa_ai_bridge/models/project_bridge.py)<br>[Authenticated BFF route and contracts](../backend/app/main.py)<br>[React Projects cost-center editor](../frontend/src/ProjectsWorkspace.jsx)<br>[Native BOQ/purchase analytics](../odoo/addons/be/be_boq) | [Current-source native Odoo role/company test](build-engine/evidence/BE-077_COST_CENTER_ASSIGNMENT_QA.json)<br>[Backend field-validation test](build-engine/evidence/BE-077_COST_CENTER_ASSIGNMENT_QA.json)<br>[React cost-center browser flow](../frontend/e2e/project-cost-center.spec.js)<br>[Checkpoint 433](build-engine/CHECKPOINT_433.md) | All four supplied criteria pass: authorized assignment persists and reopens in Odoo; malformed/missing input returns field errors without writes; reopened state includes project/company/actor/time; unauthorized and foreign-company reads/writes are denied without cross-company disclosure. Native current-source disposable-clone test passed 1/1, focused BFF test 1/1, and React editor browser flow 1/1 (mock API; native persistence and permissions tested separately). Broader BOQ actual-cost recognition, site-issue and bill/payment reconciliation are tracked in BE-072/079 and related finance stories, not acceptance criteria for this assignment story.|
| BE-078 | P0 | Create customer invoice from milestone | 7.2 | DONE | [Native milestone certificate approval and invoice draft](../odoo/addons/be/be_progress_billing/models/be_progress_bill.py)<br>[Authenticated review and invoice BFF](../backend/app/main.py)<br>[React progress billing and Owner review](../frontend/src/ProgressBillingWorkspace.jsx)<br>[Immutable approval/rejection event model](../odoo/addons/be/be_progress_billing/models/be_progress_bill.py) | [Current-source native approval/invoice suite](../odoo/addons/be/be_progress_billing/tests/test_be_progress_billing.py)<br>[Focused BFF validation/ACL test](../backend/tests/test_business.py)<br>[React Owner approval/rejection/reopen flow](../frontend/e2e/progress-billing-review.spec.js)<br>[Prior authenticated finance-reader/accountant journey](build-engine/PROGRESS_BILLING_LIVE_QA.json)<br>[Current AC evidence](build-engine/evidence/BE-078_MILESTONE_REVIEW_QA_20261105.json)<br>[Checkpoint 440](build-engine/CHECKPOINT_440.md) | All five supplied criteria pass. A PM submits a certificate; only a separate Owner can approve/reject with rationale; immutable audit records actor/time/project/company. Invalid reason/no authorization makes no write; invoice creation is blocked before approval and rejection leaves invoice absent; after approval an authorized accountant creates/reopens only a draft invoice. Current-source isolated native tests 7/7, API 1/1, React review journey 1/1 (mocked endpoints), build passed; QA clone dropped. Live browser retry stopped at workspace sign-in before any business write. Retention/advance policy and accountant/customer UAT are separate rollout gaps; no invoice posting or ZATCA send was performed. |
| BE-079 | P0 | Record vendor bill and match purchase order | 7.2 | DONE | [React accounting and vendor-bill workspaces](../frontend/src/BusinessWorkspace.jsx)<br>[Authenticated BFF draft API](../backend/app/main.py)<br>[Native PO/OCR bridge](../addons/namaa_ai_bridge/models/vendor_bill_ocr_bridge.py)<br>[Saudi Accounting KSA OCR](../addons/accounting_ksa/features/bill_ocr/models/account_move.py) | [Current-source authenticated React → BFF → Odoo QA](build-engine/VENDOR_BILL_OCR_LIVE_QA.json)<br>[Native OCR and PO-match regressions](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[BFF/API regression](../backend/tests/test_business.py)<br>[Live accountant/reader browser journey](../frontend/e2e/vendor-bill-ocr-live.spec.js)<br>[Checkpoint 431](build-engine/CHECKPOINT_431.md) | All four supplied criteria passed on a disposable current-source clone. An authorized accountant created and reopened a PO-matched Odoo vendor-bill draft; readback confirmed company, project, actor/time, received quantity, linked PO line, and the authoritative PO price despite a tampered UI price. Invalid/mismatched retry input is rejected without creating a duplicate; the native suite covers vendor/quantity/PO validation. An ordinary same-company reader received 403 for lookup/create and created no bill. Two native Odoo tests and the authenticated React→BFF→Odoo browser journey passed. Clone and temporary BFF removed; source database unchanged. Accountant UAT and representative supplier-issued invoice coverage remain operational acceptance beyond this supplied story. |
| BE-080 | P0 | Reconcile bank payments and receipts | 7.2 | DONE | [React reconciliation workspace](../frontend/src/BankReconciliationWorkspace.jsx)<br>[Odoo bridge](../backend/app/main.py)<br>[Accounting KSA](../addons/accounting_ksa)<br>[OCA reconciliation port](../odoo/addons/oca20/account-reconcile/account_reconcile_oca) | [Mapped import and reconciliation acceptance](build-engine/evidence/BANK_IMPORT_ACCEPTANCE_20261110.json)<br>[Live mapped-bank browser](../frontend/e2e/bank-import.acceptance.spec.js)<br>[Native import tests](../addons/accounting_ksa/features/bank_import/tests/test_statement_import.py)<br>[Native reconciliation tests](../addons/accounting_ksa/features/reconciliation/tests/test_reconcile_engine.py) | CP469: user selected configurable CSV/XLSX column mappings including Arabic numbers and dates. Forty-nine native and three live browser tests passed (one native administrator-without-accounting scenario is inapplicable and skipped in this Odoo version): manager configures and reopens mappings; Arabic CSV/XLSX import keeps source files; exact/overlapping retries do not duplicate; changed bank IDs and ambiguous ID-less amendments require review without overwrite or partial import. Accountant reconciles split receipts, reopens actor/time/company audit, and undoes only the selected match; native invoice residual and unchanged import amounts are verified. Reader and foreign-company sessions cannot import or access protected transactions. Existing native tests cover FX, partial/multi-invoice receipts and explicitly configured fee/VAT models; no particular bank certification or universal tax/write-off policy is claimed. |
| BE-081 | P1 | View project P&L and cash flow | 7.2, 8.4 | DONE | [Native report API](../addons/accounting_ksa/models/ksa_api.py)<br>[Accounting report BFF](../backend/app/main.py)<br>[React report workspace](../frontend/src/AccountingReportsWorkspace.jsx)<br>[Accounting navigation](../frontend/src/BusinessWorkspace.jsx)<br>[Riyadh date helper](../frontend/src/dateUtils.js) | [KSA permission/company/filter tests](../addons/accounting_ksa/tests/test_ksa_security.py)<br>[BFF boundary tests](../backend/tests/test_business.py)<br>[Native report engine](../addons/accounting_ksa/features/reports/models/report_engine.py)<br>[Timezone unit test](../frontend/tests/dateUtils.test.js)<br>[Financial report browser test](../frontend/e2e/accounting-reports.spec.js)<br>[Checkpoint190](build-engine/CHECKPOINT_190.md)<br>[Checkpoint291](build-engine/CHECKPOINT_291.md)<br>[Project cash-flow QA](build-engine/PROJECT_CASH_FLOW_QA.json)<br>[Authenticated live QA](build-engine/PROJECT_CASH_FLOW_LIVE_QA.json)<br>[Local runtime screenshot](build-engine/frontend/screenshots/live-project-cash-flow-local.png) | React displays native Odoo P&L and cash flow, date range, posted-only option, project/analytic filter on both reports, and PDF/XLSX download; Odoo rechecks finance permission and company scope. Project cash flow allocates each cash movement by the analytic distribution on counterpart journal items; opening/closing company cash balances are omitted for project-filtered results. Report date defaults use `Asia/Riyadh`; the browser regression verifies the UTC-midnight boundary and all ten report selections. Isolated report suite 8/8; Accounting KSA security/API suite 15/15; BFF boundaries 3/3; mocked React 1/1; authenticated finance-role React→BFF→Odoo 1/1 with PDF/XLSX exports and SAR 50 allocation readback. The shared local demo runtime now has the explicitly labeled project and draft movement; it was verified at React :3200 without posting. Acceptance verified: current-source isolated finance-role React→BFF→Odoo journey, native 15-test permission/filter suite, invalid-date 422 with no write, foreign-company analytic probe denied without disclosure, SAR 50 analytic allocation readback, and valid PDF/XLSX downloads. The generic persistence/actor AC is N/A for this read-only report; the returned company and filters are revalidated. Project-filtered cash flow reports attributable cash movements and intentionally omit project opening/closing bank balances; formal rollout sign-off remains separate from story completion. |
| BE-082 | P1 | Generate compliant Saudi tax invoice | 7.2, 10.1 | BLOCKED | [vendor/odoo/addons/l10n_sa_edi](../vendor/odoo/addons/l10n_sa_edi) | [vendor/odoo/addons/l10n_sa_edi/tests](../vendor/odoo/addons/l10n_sa_edi/tests) | Core localization installed on namaa_ksa; Saudi company Simulation UAT, onboarding/OTP and owner authorization outstanding. No Fatoora calls (DEC-04). |
| BE-083 | P1 | Clear/report electronic invoice via approved ZATCA adapter | 7.2, 10.1 | BLOCKED | [vendor/odoo/addons/l10n_sa_edi](../vendor/odoo/addons/l10n_sa_edi) | [vendor/odoo/addons/l10n_sa_edi/tests](../vendor/odoo/addons/l10n_sa_edi/tests) | Core localization installed on namaa_ksa; Saudi company Simulation UAT, onboarding/OTP and owner authorization outstanding. No Fatoora calls (DEC-04). |
| BE-084 | P2 | Handle credit and debit notes | 7.2 | DONE | [Native Odoo accounting reversal/debit note wizards](../vendor/odoo/addons/account)<br>[React accounting workspace](../frontend/src/BusinessWorkspace.jsx)<br>[Authenticated BFF route](../backend/app/main.py)<br>[Company-scoped Odoo bridge](../addons/namaa_ai_bridge/models/extension.py) | [Native customer/supplier note regression](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Current-source isolated QA](build-engine/BE084_ACCOUNTING_NOTES_ACCEPTANCE_LIVE_QA.json)<br>[React live journey](../frontend/e2e/accounting-vendor-notes.live.spec.js)<br>[Checkpoint 432](build-engine/CHECKPOINT_432.md) | All four supplied criteria passed on a disposable current-source clone. React accountant created and reopened customer and supplier credit and debit drafts (four variants); Odoo confirmed each draft's move type, exact source link, currency/amount, company, creator and timestamps. Blank reason returned field-level 422 without extra notes; a same-company non-accounting reader and a foreign-company accountant were denied. Native retry safety passed. One focused native test and one authenticated React → BFF → Odoo browser journey passed. Clone and temporary services/image were removed; source database unchanged. These drafts are not posted automatically. |
| BE-085 | P2 | Track failed compliance submission and retry | 7.2, 10.1 | BLOCKED | [vendor/odoo/addons/l10n_sa_edi](../vendor/odoo/addons/l10n_sa_edi) | [vendor/odoo/addons/l10n_sa_edi/tests](../vendor/odoo/addons/l10n_sa_edi/tests) | Core localization installed on namaa_ksa; Saudi company Simulation UAT, onboarding/OTP and owner authorization outstanding. No Fatoora calls (DEC-04). |
| BE-086 | P2 | Export finance reports with restricted permissions | 7.2, 8.4 | DONE | [Finance-gated native report API and immutable export audit](../addons/accounting_ksa/models/ksa_api.py)<br>[Company-scoped audit record](../addons/accounting_ksa/models/report_export.py)<br>[Validated PDF/XLSX BFF](../backend/app/main.py)<br>[React report export and saved-file history](../frontend/src/AccountingReportsWorkspace.jsx)<br>[Native report engine](../addons/accounting_ksa/features/reports/models/report_engine.py) | [KSA export permission tests](../addons/accounting_ksa/tests/test_ksa_security.py)<br>[BFF file/company boundary tests](../backend/tests/test_business.py)<br>[Current-source isolated ten-report live run](build-engine/ACCOUNTING_REPORTS_ACCOUNTANT_LIVE_QA.json)<br>[Checkpoint 388](build-engine/CHECKPOINT_388.md)<br>[prior PDF/XLSX export QA](build-engine/accounting-ksa/REPORT_QA.json) | Acceptance verified: a non-admin single-company accountant ran all ten React report families through Odoo and downloaded 20 valid XLSX/PDF files; a project-filtered export retained and reopened its project, company, actor, dates and checksum in immutable history, and the saved file downloaded again. Native suite passed 16/16; authenticated browser journey passed 1/1, including Arabic history UI. Unauthorized and foreign-company reads, forged creation, mutation, deletion and invalid-date export were denied or rejected without audit writes. Clone and temporary services were removed; shared database unchanged. Accountant policy sign-off remains recommended operational UAT, not an unverified story acceptance criterion. |

## HR and timesheets

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-087 | P0 | Manage employee records and assignments | 7.3 | DONE | [React employee workspace](../frontend/src/EmployeesWorkspace.jsx)<br>[BFF contracts/routes](../backend/app/contracts.py)<br>[Company-scoped Odoo HR bridge](../addons/namaa_ai_bridge/models/employee_management_bridge.py) | [Native role/company/persistence tests](../addons/namaa_ai_bridge/tests/test_employee_management.py)<br>[Backend contract/API tests](../backend/tests/test_employee_management.py)<br>[Mocked React journey](../frontend/e2e/employees.spec.js)<br>[Focused acceptance evidence](build-engine/evidence/BE-087_EMPLOYEE_PROJECT_ASSIGNMENTS_QA.json)<br>[Checkpoint 446](build-engine/CHECKPOINT_446.md) | All four supplied criteria pass: HR creates, reopens and updates authoritative Odoo employee records with company-scoped project staffing assignments, active state, department, actor and timestamps. Invalid input causes no partial creation; non-HR and foreign-company attempts are denied. Native 4/4, backend 3/3, mocked browser 1/1, production build passed. Staffing does not grant Odoo project access or provision login accounts. Payroll remains BE-092. |
| BE-088 | P0 | Onboard and offboard staff | 7.3 | DONE | [React employee lifecycle workspace](../frontend/src/EmployeesWorkspace.jsx)<br>[Authenticated lifecycle BFF](../backend/app/main.py)<br>[Native HR employee bridge](../addons/namaa_ai_bridge/models/employee_management_bridge.py) | [QA evidence](build-engine/evidence/BE-088_EMPLOYEE_OFFBOARDING_QA.json)<br>[Native Odoo tests](../addons/namaa_ai_bridge/tests/test_employee_management.py)<br>[Backend API tests](../backend/tests/test_employee_management.py)<br>[React lifecycle journey](../frontend/e2e/employees.spec.js)<br>[Checkpoint 448](build-engine/CHECKPOINT_448.md) | All four supplied criteria pass: authorized HR users onboard/archive or schedule contracted departure in native Odoo; invalid reason/date causes field validation and no partial departure; reopened state includes actor/time/company and retained project; non-HR and foreign-company access are denied without sensitive details. Native 7/7, API 4/4, mocked React 1/1 and production build passed. Live integrated browser acceptance is rollout follow-up, not an extra supplied AC. |
| BE-089 | P0 | Record project task timesheets | 7.2, 7.3 | DONE | [React timesheets](../frontend/src/TimesheetsWorkspace.jsx)<br>[native bridge](../addons/namaa_ai_bridge/models/timesheet_bridge.py)<br>[Odoo timesheet/accounting](../vendor/odoo/addons/hr_timesheet)<br>[analytic](../vendor/odoo/addons/analytic) | [native tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[role tests](../odoo/addons/be/be_project/tests/test_project_timesheet_roles.py)<br>[backend contract/API tests](../backend/tests/test_business.py)<br>[mocked journey](../frontend/e2e/timesheets.spec.js)<br>[live journey](../frontend/e2e/timesheets.live.spec.js)<br>[live QA](build-engine/TIMESHEET_HR_LIVE_QA.json)<br>[Checkpoint 352](build-engine/CHECKPOINT_352.md) | All four supplied criteria verified: signed-in HR Officer writes the authoritative analytic line; invalid API hours return field-level 422 and no row; React reopens creator/employee/date/project/company details after correction; native security tests deny unprivileged and foreign-company requests without disclosure. Native tests 3/3, backend tests 3 passed with 10 validation subtests, mocked browser 1/1, live browser 1/1. HR receives own-timesheet rights without approver rights. Review/approval belongs to BE-090. Clone dropped, source unchanged. |
| BE-090 | P0 | Review and approve attendance entries | 7.3 | DONE | [Native attendance and immutable audit models](../odoo/addons/be/be_site/models/be_site_attendance.py)<br>[Company-scoped Odoo bridge](../addons/namaa_ai_bridge/models/site_attendance_bridge.py)<br>[BFF routes and validation](../backend/app/main.py)<br>[React attendance workspace](../frontend/src/SiteAttendanceWorkspace.jsx) | [QA evidence](build-engine/evidence/BE-090_ATTENDANCE_REVIEW_QA_20261105.json)<br>[Native Odoo tests](../odoo/addons/be/be_site/tests/test_be_site.py)<br>[Odoo bridge tests](../addons/namaa_ai_bridge/tests/test_site_attendance.py)<br>[Backend tests](../backend/tests/test_business.py)<br>[React role journeys](../frontend/e2e/site-attendance.spec.js)<br>[Checkpoint 449](build-engine/CHECKPOINT_449.md) | All five supplied criteria pass: site submission and HR approve/reject persist in Odoo; invalid rationale/time causes field errors and no partial decision; reopened record exposes state, reviewer/actor/time, project and company; unauthorized/foreign access is denied; pending state stays unchanged until immutable review events are recorded. Native 4/4, API 3/3 plus 9 validation subtests, React 3/3, production build passed. Live integrated browser and payroll/roster reconciliation are rollout/product extensions beyond the supplied criteria. |
| BE-091 | P1 | Allocate labor cost to project | 7.2, 7.3 | DONE | [React timesheets](../frontend/src/TimesheetsWorkspace.jsx)<br>[native bridge](../addons/namaa_ai_bridge/models/timesheet_bridge.py)<br>[Odoo project costing](../odoo/addons/be/be_project)<br>[BOQ analytic actuals](../odoo/addons/be/be_boq/models/account_analytic_line.py)<br>[analytic](../vendor/odoo/addons/analytic) | [native role/bridge/security tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[backend validation tests](../backend/tests/test_business.py)<br>[live cost evidence](build-engine/TIMESHEET_HR_LIVE_QA.json)<br>[Checkpoint 353](build-engine/CHECKPOINT_353.md) | All four supplied criteria verified through the HR timesheet flow: Odoo persisted project-analytic labor cost and the linked BOQ labour actual; invalid input returned field-level errors without partial writes; the corrected entry reopened with actor/project/company details; and unauthorized/foreign-company access was denied. Live fixture: 3 hours at the configured SAR 50/hour produced SAR 150 native labor cost and SAR 150 BOQ labour actual. Native 3/3, backend 3 tests + 10 validation subtests, mocked browser 1/1 and authenticated live browser 1/1 passed. The verified source is Odoo employee hourly cost; payroll processing/export remain separate stories. |
| BE-092 | P1 | Export basic payroll inputs with authorization | 7.3 | BLOCKED | [odoo/addons/be/be_payroll_sa](../odoo/addons/be/be_payroll_sa)<br>[odoo/addons/oca20/payroll/payroll](../odoo/addons/oca20/payroll/payroll) | [odoo/addons/be/be_payroll_sa/tests](../odoo/addons/be/be_payroll_sa/tests) | GOSI/WPS export slice exists; agree payroll inputs vs processing and validate rates/format before customer use (DEC-03). |

## Assets and maintenance

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-093 | P0 | Register equipment and acquisition data | 8.2 | DONE | [Odoo equipment and receipt link](../odoo/addons/be/be_equipment)<br>[Accounting KSA asset link](../odoo/addons/be/be_equipment_accounting/models/equipment_asset_link.py)<br>[React equipment register](../frontend/src/EquipmentWorkspace.jsx)<br>[BFF contract/routes](../backend/app/contracts.py) | [Odoo role/company tests](../odoo/addons/be/be_equipment_accounting/tests/test_equipment_retirement.py)<br>[Backend route regression](../backend/tests/test_business.py)<br>[Live React browser journey](../frontend/e2e/equipment-receipt.live.spec.js)<br>[Live QA evidence](build-engine/EQUIPMENT_RECEIPT_BE093_LIVE_QA.json)<br>[Checkpoint 380](build-engine/CHECKPOINT_380.md) | All four criteria verified: procurement registered equipment from its own completed same-company serial receipt; Odoo derived vendor, date, reference and stock value; invalid input returned a field-level 422 without writing; the record reopened with company, actor, timestamps and receipt trace; unauthorized and foreign-company requests were denied without disclosure. Native tests passed 27/27; live React→BFF→Odoo journey passed 1/1. A null optional asset link is omitted by the BFF while explicit fixed-asset IDs are preserved. Clone, temporary BFF and image removed; source unchanged; Odoo healthy. |
| BE-094 | P0 | Assign equipment to project | 8.2 | DONE | [odoo/addons/be/be_equipment](../odoo/addons/be/be_equipment)<br>[React equipment custody workspace](../frontend/src/EquipmentWorkspace.jsx)<br>[Odoo assignment/movement models](../odoo/addons/be/be_equipment/models) | [Native equipment tests](../odoo/addons/be/be_equipment/tests)<br>[Current-source live QA](build-engine/EQUIPMENT_ASSIGNMENT_BE094_LIVE_QA.json)<br>[Checkpoint 362](build-engine/CHECKPOINT_362.md) | All four supplied criteria passed on a current-source disposable clone: required project input is enforced with field-level 422 and no movement; permitted Site user assigns/reopens with state, actor, time and related project/company; unauthorized reader and foreign-company mutation are denied without disclosure. Native Odoo module tests passed 26/26; authenticated React checkout/reopen/return journey passed. Yard/tool inventory, acquisition and stock intake are separate scope extensions and do not block this story’s stated criteria. Clone/temp BFF/image removed; shared source unchanged. |
| BE-095 | P0 | Check out and return tools | 8.2 | DONE | [Native Odoo equipment movement ledger and React bridge](../odoo/addons/be/be_equipment)<br>[React equipment register](../frontend/src/EquipmentWorkspace.jsx)<br>[Authenticated BFF routes](../backend/app/main.py)<br>[OCA maintenance dependencies](../odoo/addons/oca20/maintenance) | [25 native Odoo tests](../odoo/addons/be/be_equipment/tests/test_be_equipment.py)<br>[isolated React→BFF→Odoo QA](build-engine/EQUIPMENT_CHECKOUT_LIVE_QA.json)<br>[live React screenshot](build-engine/frontend/screenshots/react-be095-equipment-live-namaa.png)<br>[Checkpoint217](build-engine/CHECKPOINT_217.md) | All four acceptance criteria pass: Site user checks out and returns through React; missing project returns 422 with no movement; reopened state/history show actor, timestamps, project and company; reader and foreign-project actions are denied without a write or disclosure. Module and required OCA maintenance paths are installed on the `namaa_ksa` demo. |
| BE-096 | P0 | Schedule preventive maintenance | 8.2 | DONE | [Native OCA maintenance plan bridge and validation](../odoo/addons/be/be_equipment/models/maintenance_workspace.py)<br>[React maintenance workspace](../frontend/src/MaintenanceWorkspace.jsx)<br>[Authenticated BFF routes and schema](../backend/app/main.py)<br>[MaintenancePlanPayload](../backend/app/contracts.py)<br>[OCA maintenance plan/project](../odoo/addons/oca20/maintenance/maintenance_plan) | [25 native equipment tests](../odoo/addons/be/be_equipment/tests/test_be_equipment.py)<br>[BFF validation test](../backend/tests/test_business.py)<br>[React mocked lifecycle](../frontend/e2e/maintenance.spec.js)<br>[Current-source React→BFF→Odoo QA](build-engine/MAINTENANCE_PLAN_LIVE_QA.json)<br>[Screenshot](build-engine/frontend/screenshots/be096-preventive-plan-218.png)<br>[Checkpoint218](build-engine/CHECKPOINT_218.md) | All applicable supplied acceptance criteria verified: a PM created, generated and reopened a company/project-linked plan in React; creator/updater and timestamps persisted and displayed; missing required input returned a field-level 422 without a write; foreign-company equipment and a reader without a maintenance role were denied without disclosure. No AI content is produced, so the generic AI approval criterion is not applicable. Reminder/digest capability remains BE-163; corrective repair execution/cost gaps remain BE-097. |
| BE-097 | P1 | Record breakdown and repair costs | 8.2 | DONE | [Native maintenance request and cost bridge](../odoo/addons/be/be_equipment/models/maintenance_workspace.py)<br>[Immutable cost model and posted bill/stock-move source links](../odoo/addons/be/be_equipment/models/be_maintenance_cost.py)<br>[Maintenance stock-picking link](../odoo/addons/be/be_equipment/models/maintenance_stock.py)<br>[React workspaces](../frontend/src/MaintenanceWorkspace.jsx), [site issue flow](../frontend/src/SiteMaterialIssuesWorkspace.jsx)<br>[Authenticated BFF routes](../backend/app/main.py)<br>[OCA maintenance](../odoo/addons/oca20/maintenance) | [Native Odoo tests 26/26](../odoo/addons/be/be_equipment/tests/test_be_equipment.py)<br>[Backend tests 4 + 5 subtests](../backend/tests)<br>[React live journey](../frontend/e2e/maintenance.live.spec.js)<br>[Current-source QA](build-engine/MAINTENANCE_BE097_LIVE_QA.json)<br>[Checkpoint 368](build-engine/CHECKPOINT_368.md) | All four supplied workflow/security criteria passed: authorized breakdown and costs persisted; invalid cost returned field-level 422/no write; reopened repair showed amount, actor/time/project/company; unauthorized reader and foreign-company user were denied without cost disclosure. Corrective SAR 125.75 and SAR 300 posted same-project vendor-bill allocation were verified without duplicate journal entry. Native Odoo tests 26/26; authenticated React→BFF→Odoo journey passed. This workflow generates no AI content, so the generic AI-review criterion is not applicable. Clone and temporary services removed; source unchanged. Broader cross-project actual-cost reconciliation is separate follow-on scope. |
| BE-098 | P1 | Track utilization and idle time | 8.2 | DONE | [Immutable Odoo report snapshots](../odoo/addons/be/be_equipment/models/be_equipment_utilization.py)<br>[Equipment movement ledger](../odoo/addons/be/be_equipment/models/be_equipment_movement.py)<br>[Odoo bridge](../odoo/addons/be/be_equipment/models/maintenance_equipment.py)<br>[React history and reopen](../frontend/src/EquipmentUtilizationWorkspace.jsx)<br>[BFF routes](../backend/app/main.py) | [Native role test](../odoo/addons/be/be_equipment/tests/test_be_equipment.py)<br>[Live React journey](build-engine/EQUIPMENT_UTILIZATION_LIVE_QA.json)<br>[Arabic phone screenshot](build-engine/frontend/screenshots/live-equipment-utilization-arabic-390.png)<br>[Checkpoint 387](build-engine/CHECKPOINT_387.md) | Current-source disposable-clone QA passed native 1/1 and authenticated live React → BFF → Odoo browser 1/1. All supplied criteria are verified: the Site-role user creates and reopens the authoritative company snapshot; invalid reversed dates return 422 and create no report; creator/time, company and project at period end reopen correctly; unprivileged and foreign-company reads are denied without disclosure. The 10-day fixture returned 240 available, 216 checked-out, 24 idle calendar hours and 90% utilization; Arabic RTL phone rendering passed without overflow. Calendar-hour basis is explicitly labelled and is the delivered BRS scope; shift-adjusted metrics and separate XLSX export are future extensions, not supplied acceptance criteria. Disposable clone dropped; shared database unchanged. |
| BE-099 | P1 | Retire or dispose asset with approval | 8.2 | DONE | [Equipment workspace and scoped roles](../odoo/addons/be/be_equipment/models/maintenance_equipment.py)<br>[Optional Accounting KSA integration](../odoo/addons/be/be_equipment_accounting)<br>[React equipment register](../frontend/src/EquipmentWorkspace.jsx)<br>[BFF routes](../backend/app/main.py) | [Native retirement role tests](../odoo/addons/be/be_equipment_accounting/tests/test_equipment_retirement.py)<br>[Authenticated live React → BFF → Odoo journey](build-engine/EQUIPMENT_RETIREMENT_BE099_LIVE_QA.json)<br>[Requester screenshot](build-engine/frontend/screenshots/be099-retirement-request-368.png)<br>[Owner approval screenshot](build-engine/frontend/screenshots/be099-retirement-approved-368.png)<br>[Checkpoint 416](build-engine/CHECKPOINT_416.md) | All supplied acceptance criteria verified through the current React → BFF → Odoo flow on an isolated clone of `namaa_ksa`: Procurement requester submitted; independent Build Engine Owner approved and Odoo posted the disposal move, closed the accounting asset and archived equipment with requester/approver audit; invalid reason returned 422 without a request; self-approval, Finance-only decision and foreign-company reads were denied without disclosure; reopened state showed company, actors, timestamps and move; Arabic RTL review passed. Direct Odoo readback and live browser passed 1/1. The module-upgrade/native suite was not run because its fixture is blocked by a pre-existing dangling product.mail tracking reference; this limitation is recorded in the QA artifact. Clone and temporary services removed; source unchanged. DEC-06 is resolved for this story by the independent Owner approver policy; this does not resolve other DEC-06 workflows. |

## Quality, inspections and safety

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-100 | P0 | Configure quality gate checklist | 8.1, 9.4, 10.2 | DONE | [Native quality gate template and immutable versions](../odoo/addons/be/be_quality_gate)<br>[Company-scoped React template bridge](../addons/namaa_ai_bridge/models/quality_gate_bridge.py)<br>[React quality gate workspace](../frontend/src/QualityGatesWorkspace.jsx)<br>[Authenticated BFF routes](../backend/app/main.py) | [Native company/role/validation/version test](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Live Owner/Site React → BFF → Odoo journey](build-engine/QUALITY_TEMPLATES_LIVE_QA.json)<br>[Draft screenshot](build-engine/frontend/screenshots/live-quality-template-draft.png)<br>[Published screenshot](build-engine/frontend/screenshots/live-quality-template-published.png)<br>[Checkpoint 419](build-engine/CHECKPOINT_419.md) | Supplied configuration criteria verified on a disposable clone of `namaa_ksa`: an Owner created a stage checklist in React, set its project type and required photo evidence, published version 1, reopened it, and created editable draft version 2 while version 1 remained published. A site user could not access template configuration. The native test rejected an empty item list without creating a template and denied foreign-company versioning. Native test 1/1 and authenticated React → BFF → Odoo browser journeys 2/2 passed; direct readback verified company, actor, type, evidence requirement and version states. QA clones and temporary BFF/image were removed; source `namaa_ksa` unchanged. BE-101 remains PARTIAL until actual evidence upload/review is live-verified; offline finality/device policy remains tracked under DEC-07. |
| BE-101 | P0 | Attach inspection evidence and signatures | 8.1, 9.4, 10.2 | DONE | [Native quality-gate lifecycle](../odoo/addons/be/be_quality_gate)<br>[Company-scoped React bridge](../addons/namaa_ai_bridge/models/quality_gate_bridge.py)<br>[React inspection workspace](../frontend/src/QualityGatesWorkspace.jsx)<br>[Authenticated BFF routes](../backend/app/main.py) | [Native evidence/sign-off/company-scope regression](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Live Site-role upload/download/sign-off journey](build-engine/QUALITY_TEMPLATES_LIVE_QA.json)<br>[Evidence/sign-off screenshot](build-engine/frontend/screenshots/live-quality-gate-failure-signoff.png)<br>[Checkpoint 420](build-engine/CHECKPOINT_420.md) | Acceptance verified on a disposable clone of `namaa_ksa`: Site inspector uploaded a valid PNG through React, downloaded it through the authenticated evidence endpoint, recorded a required failure reason and signer, then reopened the immutable signed result. Odoo readback verified persisted attachment name, MIME type and size, result, reason, actor, timestamp, project and company. Native bridge regression rejects invalid image data without attachment, denies an unauthorized PM sign-off and foreign-company record access, validates evidence and download access, enforces mandatory evidence for pass, preserves signed results and blocks late evidence/reason edits. Two focused native tests and authenticated React → BFF → Odoo browser journeys 2/2 passed. The latest repeat of BE-100’s admin journey hit a frontend test-server startup timeout before sign-in; its preceding full live run passed and is recorded in Checkpoint 419. Disposable clone and temporary services removed; `namaa_ksa` unchanged. |
| BE-102 | P0 | Prevent advancing past mandatory unsigned gate | 8.1, 9.4, 10.2 | DONE | [Odoo workflow gate guard](../odoo/addons/be/be_quality_gate/models/be_workflow_instance.py)<br>[Company-scoped React workflow bridge](../addons/namaa_ai_bridge/models/project_workflow_bridge.py)<br>[Site-safe gate stage summary](../addons/namaa_ai_bridge/models/quality_gate_bridge.py)<br>[React workflow execution](../frontend/src/ProjectWorkflowWorkspace.jsx)<br>[Authenticated BFF routes](../backend/app/main.py) | [Native regression: blocked/stale transition, Site sign-off, PM retry, company boundaries](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Mocked React workflow](../frontend/e2e/project-workflow.spec.js)<br>[Live React → BFF → Odoo role journey](../frontend/e2e/project-workflow.live.spec.js)<br>[Isolated QA and persisted postconditions](build-engine/PROJECT_WORKFLOW_GATE_LIVE_QA.json)<br>[Blocked screenshot](build-engine/frontend/screenshots/live-project-workflow-gate-blocked.png)<br>[Completed screenshot](build-engine/frontend/screenshots/live-project-workflow-gate-completed.png)<br>[Checkpoint 421](build-engine/CHECKPOINT_421.md) | All supplied criteria verified on a disposable current-source clone of `namaa_ksa`. PM attempted to leave a stage with its mandatory unsigned gate; Odoo rejected the request and preserved the running stage. A Site user opened the authorized gate in React and signed its required item; a PM then retried using the refreshed revision and Odoo completed the workflow. Readback verified signer, transition actor/time, project and company. Stale revisions and foreign-company read/transition are denied without writes or disclosure. Site receives only the linked stage label from the authorized gate payload; direct workflow-stage access remains denied. Native bridge tests 3/3, mocked React 1/1, authenticated live React → BFF → Odoo 1/1. QA clone and temporary BFF removed; source database unchanged. |
| BE-103 | P0 | Map regulatory checkpoint to current reference | 10.2, 10.4 | BLOCKED | [odoo/addons/be/be_quality_gate/data/be_quality_gate_sbc_data.xml](../odoo/addons/be/be_quality_gate/data/be_quality_gate_sbc_data.xml) | [odoo/addons/be/be_quality_gate/tests](../odoo/addons/be/be_quality_gate/tests) | SBC/Balady seed references are not validated current regulatory content; qualified owner review required (DEC-09). |
| BE-104 | P1 | Log nonconformance and corrective action | 8.1, 8.3, 10.2 | DONE | [Native Odoo nonconformance model](../odoo/addons/be/be_quality_gate/models/be_nonconformance.py)<br>[React workspace](../frontend/src/NonconformanceWorkspace.jsx)<br>[Authenticated BFF routes](../backend/app/main.py) | [Native Odoo tests 2/2](../odoo/addons/be/be_quality_gate/tests/test_be_quality_gate.py)<br>[Backend and React tests](../backend/tests/test_business.py)<br>[Current-source live acceptance](build-engine/NONCONFORMANCE_ACCEPTANCE_LIVE_QA.json)<br>[Live date/time verification](build-engine/NONCONFORMANCE_TIMESTAMP_LIVE_QA.json)<br>[Checkpoint 372](build-engine/CHECKPOINT_372.md) | All four supplied criteria passed: authorized Quality/Safety Officer created and reopened a finding; invalid description returned field-level 422/no write; reopened state/reporter/time/project/company were visible, with date and HH:mm verified live in Asia/Riyadh; no-reporter and foreign-company actions returned 403 without disclosure. Native tests 2/2 and live React→BFF→Odoo browser 1/1 passed; a separate GET-only live timestamp check passed 1/1. Clone/temp services removed and source unchanged. |
| BE-105 | P1 | Track incident and near miss | 8.1, 8.3, 10.2 | DONE | [Odoo incident and near-miss model](../odoo/addons/be/be_quality_gate/models/be_nonconformance.py)<br>[React Quality & Safety workspace](../frontend/src/QualityGatesWorkspace.jsx)<br>[Authenticated BFF](../backend/app/main.py) | [Native safety test](build-engine/BE105_SAFETY_LIVE_QA.json)<br>[React/BFF validation tests](../backend/tests/test_business.py)<br>[Mocked React journey](../frontend/tests/nonconformance.test.js)<br>[Live role/company journey](build-engine/BE105_SAFETY_LIVE_QA.json)<br>[Checkpoint 375](build-engine/CHECKPOINT_375.md) | Current-source native test 1/1 and authenticated React→BFF→Odoo browser 1/1 passed. Incident and near-miss persisted with event time/location/outcome/action, reporter, state, project and company; invalid/missing event fields returned 422 with no write; non-reporter and foreign-company requests were denied without disclosure. The owner reopened each event with audit details. Clone removed; source unchanged and Odoo healthy. All supplied criteria verified. |
| BE-106 | P1 | Complete daily safety checklist | 8.1, 8.3, 10.2 | DONE | [Odoo quality-gate models](../odoo/addons/be/be_quality_gate)<br>[daily-safety bridge](../addons/namaa_ai_bridge/models/quality_gate_bridge.py)<br>[React checklist workspace](../frontend/src/QualityGatesWorkspace.jsx)<br>[BFF route](../backend/app/main.py) | [native bridge test](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[daily-safety React journey](../frontend/e2e/quality-gates.daily-live.spec.js)<br>[8 quality-gate browser tests](../frontend/e2e/quality-gates.spec.js)<br>[isolated live QA](build-engine/DAILY_SAFETY_LIVE_QA.json)<br>[Checkpoint 205](build-engine/CHECKPOINT_205.md) | An authorized Site user creates, evidences, signs and reopens a checklist in an isolated clone; invalid date returns field validation with no write; creator/signature timestamps and project/company persist; reader and foreign-company access are denied without disclosure. Twelve simultaneous opens return the same single record. No AI content is generated in this workflow, so the AI draft criterion does not apply. Shared demo database was not modified. |
| BE-107 | P2 | Escalate overdue inspection or safety incident | 8.1, 8.3, 10.2 | DONE | [Native escalation](../odoo/addons/be/be_quality_gate/models/be_quality_escalation.py)<br>[React escalation panel](../frontend/src/QualityEscalationPanel.jsx) | [Native tests](../odoo/addons/be/be_quality_gate/tests/test_be_quality_gate.py)<br>[Real browser acceptance](../frontend/e2e/manual-escalation.acceptance.spec.js)<br>[Isolated evidence](build-engine/evidence/MANUAL_ESCALATION_ACCEPTANCE_20261108.json) | All supplied manual-escalation criteria verified: Site records an incident or overdue daily safety escalation to a same-company project-readable Owner/PM, Odoo creates an immutable actor/time/project/company receipt and native manager activity, and React reopens bilingual history. The joint live run passed five native methods and three browser journeys, including invalid recipient/no added event and unauthorized/foreign denial without disclosure. DEC-20 severity tiers, contractor routing matrix and automatic timing remain unapproved; this acceptance covers the explicit manual action and recorded eligibility only. |
| BE-108 | P2 | Maintain punch list until closeout | 8.1, 8.3, 10.2 | DONE | [Odoo punch item lifecycle, role and evidence validation](../odoo/addons/be/be_quality_gate/models/be_punch_item.py)<br>[Odoo closeout punch guard](../odoo/addons/be/be_project/models/be_project_closeout.py)<br>[Project archive guard](../odoo/addons/be/be_project/models/project_project.py)<br>[React workspace](../frontend/src/PunchListWorkspace.jsx)<br>[Authenticated BFF routes](../backend/app/main.py) | [Current-source native Odoo punch tests 3/3](../odoo/addons/be/be_quality_gate/tests/test_be_quality_gate.py)<br>[BFF contracts and route tests](../backend/tests/test_business.py)<br>[Rendered React workflow regression](../frontend/e2e/punch-list.spec.js)<br>[Live React → BFF → Odoo role journey](../frontend/e2e/punch-list.live.spec.js)<br>[Isolated QA and Odoo readback](build-engine/PUNCH_LIST_BE108_LIVE_QA.json)<br>[Closed-item React screenshot](build-engine/frontend/screenshots/be108-live-closed.png)<br>[Checkpoint 422](build-engine/CHECKPOINT_422.md) | Site reporter created a project item and attached evidence. Missing required fields returned field-level 422 with no write. A Project Manager assigned it; the assigned Site user started and resolved it; that user could not assign or self-verify; an independent Project Manager verified and closed it. React reopened the closed record. Odoo readback verified company/project, evidence, corrective action, and reporter/assignment/resolution/verification/closure actors and timestamps. Foreign-project query returned no target data. Native Odoo tests 3/3 and live authenticated React → BFF → Odoo journey 1/1 passed on a disposable current-source clone; the source demo was unchanged. The formal closeout certification blocks while punch items remain open. DEC-21 certification attestation/approval policy remains open for BE-048; it does not block BE-108 acceptance.

## RFI, submittals and site reporting

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-109 | P0 | Create RFI and assign respondent | 7.1, 8.3, 9.6 | DONE | [Odoo RFI model](../odoo/addons/be/be_correspondence/models/rfi.py)<br>[React RFI workspace](../frontend/src/RfiWorkspace.jsx)<br>[BFF routes](../backend/app/main.py) | [Native Odoo suite](../odoo/addons/be/be_correspondence/tests/test_rfi.py)<br>[Backend boundary tests](../backend/tests/test_business.py)<br>[Live role journey](../frontend/e2e/rfi-live.spec.js)<br>[Isolated QA](build-engine/RFI_LIVE_QA.json)<br>[Checkpoint227](build-engine/CHECKPOINT_227.md) | Site author creates/submits; a separate PM manages assignment; the assigned Site responder answers; PM closes. Missing subject returns field-level 422 with no write. Reopened React/Odoo state preserves project/company, actor, timestamps and activity. No-role and foreign-company/project access are denied. Clone was dropped; shared database unchanged. |
| BE-110 | P0 | Track RFI response deadline and status | 7.1, 8.3, 9.6 | DONE | [Odoo deadline/status model](../odoo/addons/be/be_correspondence/models/rfi.py)<br>[React RFI workspace](../frontend/src/RfiWorkspace.jsx)<br>[BFF routes](../backend/app/main.py) | [Native overdue-boundary test](../odoo/addons/be/be_correspondence/tests/test_rfi.py)<br>[Live role journey](../frontend/e2e/rfi-live.spec.js)<br>[Isolated QA](build-engine/RFI_LIVE_QA.json)<br>[Checkpoint227](build-engine/CHECKPOINT_227.md) | A PM changes the respondent/deadline; the assigned user answers and PM closes. Open RFIs are overdue only after the deadline date; due-today, answered, closed and cancelled records are not overdue. React status/deadline and native activity synchronize. Stale version and unauthorized manager edits are rejected. Company/project access is enforced. |
| BE-111 | P0 | Create submittal with drawing revision | 7.1, 8.3, 9.6 | DONE | [React submittal workspace with drawing/revision selection](../frontend/src/SubmittalWorkspace.jsx)<br>[Odoo submittal and immutable revision models](../odoo/addons/be/be_correspondence/models/submittal.py)<br>[Current drawing reader and authenticated routes](../backend/app/main.py) | [Current-source isolated live role QA](build-engine/RFI_LIVE_QA.json)<br>[Native correspondence suite 29/29](../odoo/addons/be/be_correspondence/tests)<br>[Live React → BFF → Odoo journeys 2/2](../frontend/e2e/rfi-live.spec.js)<br>[Checkpoint 405](build-engine/CHECKPOINT_405.md) | All four supplied criteria verified on a disposable current-source clone. Site author created a submittal linked to a current issued drawing, attached PDF evidence, submitted revision 1, and reopened the project/company/actor state. A missing subject/description returned field-level 422 with no added record. A project manager requested changes; the Site author submitted revision 2 with new evidence. Native tests verified drawing/project/company restrictions and unauthorized access; the live unauthorized reader received 403 without data disclosure. Odoo confirmed immutable drawing-linked revision snapshots and actor/time metadata. Clone/services removed; shared database unchanged. External portal behavior and production UAT are separate scope.
| BE-112 | P0 | Record approval or resubmission | 7.1, 8.3, 9.6 | DONE | [React submittal decision and revision flow](../frontend/src/SubmittalWorkspace.jsx)<br>[Odoo review state, immutable revision and audit models](../odoo/addons/be/be_correspondence/models/submittal.py)<br>[Authenticated BFF actions](../backend/app/main.py) | [Current-source isolated live role QA](build-engine/RFI_LIVE_QA.json)<br>[Native correspondence lifecycle/security suite 29/29](../odoo/addons/be/be_correspondence/tests)<br>[Live React → BFF → Odoo journeys 2/2](../frontend/e2e/rfi-live.spec.js)<br>[Checkpoint 405](build-engine/CHECKPOINT_405.md) | All four supplied criteria verified. A separate PM requested revision 2; the Site author resubmitted; a PM recorded a reasoned approval. React and Odoo reopened the approved state, both revision snapshots, current drawing, files, project/company and submitter/reviewer actors/timestamps. Invalid required input returned 422 without a write; native tests and a live unauthorized-reader request enforced access boundaries. Event order persisted as submitted → revision requested → submitted → approved. Disposable clone and services removed; source database unchanged. External portal behavior and production UAT are separate scope.
| BE-113 | P1 | Capture daily site report offline | 9.5 | DONE | [React daily reports](../frontend/src/SiteDailyLogsWorkspace.jsx)<br>[Scoped persistent queue](../frontend/src/siteDailyLogQueue.js)<br>[Odoo daily log model](../odoo/addons/be/be_site/models/be_site_daily_log.py)<br>[Odoo bridge](../addons/namaa_ai_bridge/models/site_bridge.py)<br>[BFF](../backend/app/main.py) | [24-hour soak acceptance](build-engine/evidence/BE113_24H_SOAK_LATEST.json)<br>[Encrypted browser journey](../frontend/e2e/daily-report.soak.spec.js)<br>[Real-time runner](../scripts/run_daily_report_soak.py)<br>[Daily report UI regression](../frontend/e2e/site-daily-logs.spec.js) | CP469: user selected a 24-hour real elapsed soak. Six native tests and the full 24-hour isolated Chromium test passed: encrypted daily report/photo drafts survive offline lock and reload, expired project cache is removed, reconnect produces exactly one native report and one photo with original actor/time/company. Elapsed time 86,410,228 ms, with 1,439 offline checks. QA clone and temporary services removed. New captures use the encrypted offline workspace; the older plaintext queue is limited to explicit recovery/discard. This evidence covers the development-host Chromium browser and does not certify untested field hardware or offline official approvals. |
| BE-114 | P1 | Log manpower deliveries weather and delays | 7.1, 9.5 | DONE | [React structured daily reports](../frontend/src/SiteDailyLogsWorkspace.jsx)<br>[Normalized Odoo child models](../odoo/addons/be/be_site/models/be_site_daily_log.py)<br>[Odoo bridge](../addons/namaa_ai_bridge/models/site_bridge.py)<br>[Strict BFF contract](../backend/app/contracts.py) | [Native model validation](../odoo/addons/be/be_site/tests/test_be_site.py)<br>[Bridge role/idempotency test](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[React browser flows](../frontend/e2e/site-daily-logs.spec.js)<br>[Isolated live React → BFF → Odoo](../frontend/e2e/site-daily-logs-live.spec.js)<br>[QA evidence](build-engine/SITE_DAILY_LOGS_OFFLINE_QA.json)<br>[Checkpoint 277](build-engine/CHECKPOINT_277.md)<br>[Checkpoint 385](build-engine/CHECKPOINT_385.md) | React captures structured manpower by trade/contractor/headcount, deliveries by item/supplier/optional quantity+unit, and categorized delay duration/description alongside weather and narrative notes. The workspace now provides scoped summary totals, project/date/search filtering and filtered CSV export using only the authorized Odoo result set. Strict BFF validation and Odoo model/bridge checks are covered by the 125-test focused isolated Odoo run; current-source isolated Site-role acceptance persisted and reopened all three child collections with author/company/project/date, verified exact retry behavior and changed-content rejection; temporary QA records/users/services were removed. Focused React browser tests 2/2 passed, including summaries, search and export. All four story acceptance criteria are covered: authenticated Site create and Odoo readback; native invalid/partial-write validation; actor/time/project/company re-open; and Odoo role/foreign-company denial without disclosure. Summary/filter/search/date/CSV browser coverage also passes. Offline app-shell, attachment sync and multi-device issues are tracked separately under BE-113 and do not block this structured logging story. |
| BE-115 | P1 | Generate consolidated RFI and submittal logs | 7.1, 8.3, 9.6 | DONE | [React correspondence log](../frontend/src/ProjectCorrespondenceLog.jsx)<br>[RFI workspace](../frontend/src/RfiWorkspace.jsx)<br>[Odoo correspondence models](../odoo/addons/be/be_correspondence)<br>[Drawing revisions](../odoo/addons/be/be_drawing) | [Native correspondence suite](../odoo/addons/be/be_correspondence/tests)<br>[Live isolated QA](build-engine/RFI_LIVE_QA.json)<br>[Checkpoint226](build-engine/CHECKPOINT_226.md)<br>[Live screenshot](build-engine/frontend/screenshots/rfi-live-correspondence-log.png) | All four supplied criteria verified: authoritative persisted RFI/submittal records; invalid required submittal input returns field-level 422 without a write; reopened mixed log exposes state, actors, times and project/company; no-role access returns 403 without disclosure. Filtered CSV contained the closed RFI, approved submittal, history and attachment filename. Clone was dropped; shared demo DB unchanged. |

## Contracts and client helpdesk

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-116 | P0 | Register client subcontractor and supplier contracts | 9.2 Legal | DONE | [Native Odoo contract model](../odoo/addons/be/be_contract)<br>[Company-scoped React/Odoo bridge](../addons/namaa_ai_bridge/models/contracts_bridge.py)<br>[React contracts workspace](../frontend/src/ContractsWorkspace.jsx)<br>[Authenticated BFF](../backend/app/main.py) | [Native contract lifecycle/security tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[React browser flow](../frontend/e2e/contracts.spec.js)<br>[Live create/reopen/invalid-input/role QA](build-engine/CONTRACT_CLAUSE_REVIEW_LIVE_QA.json)<br>[Checkpoint 424](build-engine/CHECKPOINT_424.md) | All four supplied criteria verified: a company/project-linked contract is created and reopened in React with actor/timestamp audit; invalid create returns 422 without a write; native tests deny a reader and foreign-project write; live React→BFF→Odoo creation passed. |
| BE-117 | P0 | Track expiry renewal and milestone dates | 9.2 Legal | DONE | [Native contract key dates/reminders](../odoo/addons/be/be_contract/models/be_contract_key_date.py)<br>[Company-scoped React/Odoo bridge](../addons/namaa_ai_bridge/models/contracts_bridge.py)<br>[React contracts workspace](../frontend/src/ContractsWorkspace.jsx) | [Native reminder test](../odoo/addons/be/be_contract/tests/test_be_contract.py)<br>[Contract bridge and security tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Live React→BFF→Odoo reminder QA](build-engine/CONTRACT_CLAUSE_REVIEW_LIVE_QA.json)<br>[Checkpoint 424](build-engine/CHECKPOINT_424.md) | Critical expiry/milestone dates persist and reopen with their contract; Odoo schedules the native reminder activity at the configured lead time (14 days in QA). Invalid input, current-company scope and reader/foreign-project denial are covered by the linked native and live checks. |
| BE-118 | P0 | Draft contract clause checklist for review | 9.2 Legal | DONE | [React contract checklist](../frontend/src/ContractsWorkspace.jsx)<br>[Native clause records](../odoo/addons/be/be_contract/models/be_contract_clause.py)<br>[Company-scoped contract bridge](../addons/namaa_ai_bridge/models/contracts_bridge.py) | [Native contract/role tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[React contract Playwright](../frontend/e2e/contracts.spec.js)<br>[Live create/reopen and clause QA](build-engine/CONTRACT_CLAUSE_REVIEW_LIVE_QA.json)<br>[Checkpoint 424](build-engine/CHECKPOINT_424.md) | Manual draft checklist clauses persist on the authoritative contract and reopen in React with contract actor/time and company/project context. Invalid create has no write; unauthorized/foreign-project actions are denied. No AI clause content is produced, so the conditional AI-draft criterion does not apply; DEC-22 gates future legal-source automation. |
| BE-119 | P0 | Flag potentially missing contract clauses | 9.2 Legal | DONE | [React contract evidence review](../frontend/src/ContractClauseReview.jsx)<br>[Immutable Odoo review snapshot](../odoo/addons/be/be_contract/models/be_contract_clause_review.py)<br>[Company-scoped contract bridge](../addons/namaa_ai_bridge/models/contracts_bridge.py)<br>[BFF routes](../backend/app/main.py) | [Native company/role/review tests](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[React review browser flow](../frontend/e2e/contracts.spec.js)<br>[Live persisted review/readback QA](build-engine/CONTRACT_CLAUSE_REVIEW_LIVE_QA.json)<br>[Checkpoint 424](build-engine/CHECKPOINT_424.md) | Reviewer-selected checklist review persists an immutable snapshot and flags selected items lacking text/reference; React reopens the finding and reviewer history. This is evidence-gap review, not a legal conclusion. Document extraction and legal rubric/source automation remain gated by DEC-22 and are not claimed. |
| BE-120 | P1 | Create internal defect or blocked-task ticket | 8.3 | DONE | [Native OCA Helpdesk project tickets](../odoo/addons/oca20/helpdesk/helpdesk_mgmt)<br>[Company/project scoped React bridge](../addons/namaa_ai_bridge/models/helpdesk_ticket_bridge.py)<br>[React Internal Tickets workspace](../frontend/src/InternalTicketsWorkspace.jsx)<br>[Quality & Safety navigation](../frontend/src/NonconformanceWorkspace.jsx) | [Current-source native Helpdesk role/company tests](build-engine/evidence/BE-120_INTERNAL_HELPDESK_QA.json)<br>[BFF validation/ACL test](../backend/tests/test_business.py)<br>[React create/list/reopen browser flow](../frontend/e2e/internal-tickets.spec.js)<br>[Checkpoint 437](build-engine/CHECKPOINT_437.md) | All four supplied criteria pass. React creates and reopens an OCA `helpdesk.ticket` linked to the accessible project and active company, with defect/blocked-task type, stage, creator and timestamp. Invalid input creates no ticket; Sales-only, foreign-company and inaccessible-project attempts are denied without disclosure. Native tests 2/2, API 1/1, browser 1/1, build/compile passed. Browser APIs are mocked; Odoo/BFF were verified separately on a disposable clone. Helpdesk was not installed on the shared demo DB. Client portal, resolution evidence and SLA routing remain separate stories. |
| BE-121 | P1 | Create client snag ticket after handover | 8.3 | DONE | [Native client aftercare](../odoo/addons/be/be_client_snag_portal)<br>[Client-only BFF](../backend/app/client_snags.py)<br>[React client workspace](../frontend/src/ClientSnagWorkspace.jsx) | [Client acceptance](build-engine/evidence/CLIENT_SNAG_ACCEPTANCE_20261110.json)<br>[Native HTTP/model tests](../odoo/addons/be/be_client_snag_portal/tests/test_portal_snags.py)<br>[Real browser acceptance](../frontend/e2e/client-snags.acceptance.spec.js) | CP468: user confirmed certified-handover eligibility with company-controlled submission enablement. Five native HTTP/model + two live bilingual/phone browser tests pass. Separate client sign-in; only own-company/client handed-over projects; native ticket/photo create and reopened actor/time/project/company; stable lost-response retry without duplication; invalid/photo validation no-write; foreign-client/company and internal-account denial. Internal APIs reject client identities and logout destroys the native session. Protected native photo downloads and POST-only authorized portal close. Full finance/stock closeout policy remains a separate BE-048 dependency. |
| BE-122 | P1 | Route ticket and escalate SLA breach | 8.3 | DONE | [Native audited routing](../addons/namaa_ai_bridge/models/helpdesk_sla_routing_bridge.py)<br>[React SLA panel](../frontend/src/InternalTicketRoutingPanel.jsx) | [Native role/company tests](../addons/namaa_ai_bridge/tests/test_helpdesk_sla_routing_bridge.py)<br>[Live browser acceptance](../frontend/e2e/manual-escalation.acceptance.spec.js)<br>[Isolated evidence](build-engine/evidence/MANUAL_ESCALATION_ACCEPTANCE_20261108.json) | All supplied manual route/SLA criteria verified: same-company authorized project user records a recipient, future response deadline and reason, reopens the full ticket with audit history, then escalates a recorded overdue deadline once. Fixed incomplete route response and serialized routing/escalation against concurrent writes. Joint acceptance passed five native methods and three production-build browser journeys, invalid/no-partial attempts, duplicate escalation denial and unauthorized/foreign denial. Per-ticket deadlines and manual escalation are implemented; no automatic SLA engine or approved contractor severity/routing matrix is claimed. |
| BE-123 | P2 | Record ticket resolution evidence | 8.3 | DONE | [Immutable Odoo ticket resolution evidence bridge](../addons/namaa_ai_bridge/models/helpdesk_resolution_evidence_bridge.py)<br>[Native OCA Helpdesk ticket and project link](../odoo/addons/oca20/helpdesk/helpdesk_mgmt)<br>[React internal ticket resolution panel](../frontend/src/InternalTicketsWorkspace.jsx) | [Current-source native evidence/role tests](build-engine/evidence/BE-123_TICKET_RESOLUTION_EVIDENCE_QA.json)<br>[BFF/API validation and ACL tests](../backend/tests/test_internal_ticket_resolution_api.py)<br>[React record/reopen/download journey](../frontend/e2e/internal-ticket-resolution.spec.js)<br>[Checkpoint 439](build-engine/CHECKPOINT_439.md) | All four supplied criteria pass. Authorized Site/PM/Owner records a validated resolution note and PDF/image evidence in Odoo, reopening shows Done stage, actor/time/project/company, and unauthorized/foreign-company users are denied. Invalid content makes no partial evidence record; evidence and native ticket closure are transactional; records reject write/unlink. Native Odoo 2/2, API 2/2, React 1/1 (mock endpoints), build/compile passed. Disposable DB and filestore dropped. Client portal and SLA routing/escalation are separate stories. |

## Documents, drawings and knowledge

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-124 | P0 | Create dedicated project document folders | 8.5 | DONE | [OCA DMS project-document bridge](../addons/namaa_ai_bridge/models/project_documents_bridge.py)<br>[React project documents](../frontend/src/ProjectDocumentsWorkspace.jsx)<br>[immutable revision addon](../odoo/addons/be/be_project_documents)<br>[knowledge archive](../services/platform/app/knowledge) | [Current-source folder acceptance](build-engine/PROJECT_DOCUMENT_FOLDERS_LIVE_QA.json)<br>[BFF tests](../backend/tests/test_business.py)<br>[authenticated React journey](../frontend/e2e/project-documents.live.spec.js)<br>[Odoo folder provisioning tests](../odoo/addons/be/be_project_documents/tests/test_project_document.py)<br>[Checkpoint 397](build-engine/CHECKPOINT_397.md) | All supplied A1–A4 passed on a disposable current-source Odoo 20 clone. PM provisioned one authoritative project root and six company/project-scoped folders; React showed creator, timestamp, related project and company after fresh login. Invalid project ID returned field-level 422 with no write. Same-company reader and foreign-company PM provisioning were denied without disclosure or writes. Native Odoo tests 3 passed/1 conditional skip, focused BFF test 1/1, authenticated live journey 1/1; Odoo postconditions verified folder count, taxonomy, actor, time, project and company. Clone/temp services removed; source unchanged. Shared-runtime DMS rollout and operational UAT remain separate deployment work, not open supplied acceptance criteria. |
| BE-125 | P0 | Upload and version drawings | 9.6 | DONE | [Native drawing records and file policy](../odoo/addons/be/be_drawing/models/be_drawing.py)<br>[Company/project-scoped React bridge](../addons/namaa_ai_bridge/models/drawing_project_acl_bridge.py)<br>[React Drawings workspace](../frontend/src/DrawingsWorkspace.jsx)<br>[Authenticated BFF routes](../backend/app/main.py) | [Current-source native file/policy and project ACL QA](build-engine/evidence/BE-125_DRAWING_UPLOAD_VERSION_QA.json)<br>[BFF validation/ACL tests](../backend/tests/test_drawing_project_acl_api.py)<br>[React upload/revision journeys](../frontend/e2e/drawings.spec.js)<br>[Checkpoint 441](build-engine/CHECKPOINT_441.md) | All four supplied criteria pass. Authorized Owner/PM/Site users upload and create revisions in Odoo; native file policy validates name, type/signature, base64 and 25 MB cap before writes; rejected revisions leave the current file unchanged. Reopen shows revision state, actor/time, project/company; unauthorized and foreign-project/company users are denied without disclosure. Current-source native tests 12/12, API 4/4, React 2/2, build/compile passed; disposable clone and filestore dropped. Browser API is mocked. DEC-08 preview conversion/licensing is BE-126 and remains separate. |
| BE-126 | P0 | Preview supported drawing formats without CAD editing | 9.6 | DONE | [Native file and metadata authority](../odoo/addons/be/be_drawing/models/be_drawing.py)<br>[Authenticated preview routes](../backend/app/drawing_previews.py)<br>[Networkless conversion worker](../backend/app/drawing_preview_worker.py)<br>[React preview dialog](../frontend/src/DrawingPreviewDialog.jsx) | [12 native and 3 live browser acceptance checks](build-engine/evidence/DRAWING_PREVIEW_ACCEPTANCE_20261113.json)<br>[Browser specification](../frontend/e2e/drawing-preview.acceptance.spec.js)<br>[Converter design/license](adr/0022-native-authorized-drawing-previews.md)<br>[Checkpoint 470](build-engine/CHECKPOINT_470.md) | User-approved PDF and text DXF2D preview scope accepted. PDF paging and DXF zoom work in React, including Arabic at390px; DWG/IFC remain clearly labelled original downloads. Cached results require fresh native role/company/project/file authorization, including revoked access; invalid pages/formats and corrupt files fail safely. Conversion runs in a credential-free networkless read-only container with CPU/memory/process/time/input limits; private cache is bounded and expires. Fresh native readback confirms original files/revisions and actor/time/company/project are unchanged. Disposable QA database and containers removed. No CAD editing, DWG/IFC conversion or drawing-estimator accuracy is claimed. |
| BE-127 | P0 | Link drawing revision to task and submittal | 9.6 | DONE | [Odoo drawing/task revision relation](../odoo/addons/be/be_drawing/models/be_drawing.py)<br>[Odoo submittal/drawing link and revision snapshot](../odoo/addons/be/be_correspondence/models/submittal.py)<br>[React Drawings workspace](../frontend/src/DrawingsWorkspace.jsx)<br>[React Submittal workspace](../frontend/src/SubmittalWorkspace.jsx) | [Current-source native drawing/submittal suite](build-engine/evidence/BE-127_DRAWING_SUBMITTAL_LINK_QA.json)<br>[BFF contract/ACL tests](../backend/tests/test_business.py)<br>[React drawing upload/revision tests](../frontend/e2e/drawings.spec.js)<br>[React submittal link/reopen test](../frontend/e2e/submittal-drawing-link.spec.js)<br>[Checkpoint 443](build-engine/CHECKPOINT_443.md) | All four supplied criteria pass across the native/API/React layers. A drawing revision stays linked to its same-project task; submittals select and snapshot the drawing revision, enforcing project/company consistency. Invalid inputs make no partial writes; reopened records show state, actor, timestamps, project and company; unauthorized/cross-company access is denied. Current-source native suite 39/39, API 4/4, React drawing 2/2 plus submittal link/reopen 1/1, production build passed. Browser API is mocked; native persistence/security are separately verified. Disposable DB/filestore removed. |
| BE-128 | P1 | Archive approved proposal and BOQ PDFs | 8.5 | DONE | [addons/namaa_ai_bridge/models/crm_technical_proposal_bridge.py](../addons/namaa_ai_bridge/models/crm_technical_proposal_bridge.py)<br>[addons/namaa_ai_bridge/report/be_boq_baseline_archive_report.xml](../addons/namaa_ai_bridge/report/be_boq_baseline_archive_report.xml)<br>[frontend/src/TechnicalProposalArchiveWorkspace.jsx](../frontend/src/TechnicalProposalArchiveWorkspace.jsx) | [Odoo bridge tests](../addons/namaa_ai_bridge/tests/test_crm_technical_proposal.py)<br>[BFF route tests](../backend/tests/test_business.py)<br>[synthetic React browser test](../frontend/e2e/business.spec.js)<br>[live React → BFF → Odoo test](../frontend/e2e/project-proposal-boq-archive.live.spec.js)<br>[current-source isolated QA](build-engine/PROJECT_ARCHIVE_EXPORT_LIVE_QA.json)<br>[Checkpoint 391](build-engine/CHECKPOINT_391.md)<br>[live QA evidence](build-engine/PROJECT_PROPOSAL_BOQ_ARCHIVE_LIVE_QA.json) | All supplied acceptance criteria are verified. An authenticated PM archived an independently approved proposal beside a confirmed BOQ baseline; the missing-approved-source attempt returned a denial and created no archive, while short rationale returned a field-level 422 and created no record. A fresh React login/reopen showed the persisted proposal, BOQ, project, rationale, PM actor and timestamp. Private PDF downloads had valid signatures/no-store headers; same-company reader and foreign-company access were denied without disclosure. Odoo requires an independent proposal approval and confirmed baseline and stores immutable rationale/source/checksum events. Focused native/archive export test passed 1/1 and live browser journey passed 1/1; clone, BFF and image removed, source DB unchanged. Arabic PDF layout review remains a quality follow-up, not a supplied acceptance criterion. |
| BE-129 | P1 | Search archived decisions and lessons learned | 8.5 | DONE | [Native archive authorization](../addons/namaa_ai_bridge/models/archive_search_bridge.py)<br>[Separate index worker](../backend/app/archive_worker.py)<br>[React archive search](../frontend/src/ArchiveSearchWorkspace.jsx)<br>[Bounded Compose worker](../compose.yaml) | [Archive acceptance](build-engine/evidence/ARCHIVE_SEARCH_ACCEPTANCE_20261109.json)<br>[Native tests](../addons/namaa_ai_bridge/tests/test_archive_search.py)<br>[Worker/API tests](../backend/tests/test_archive_index.py)<br>[Browser acceptance](../frontend/e2e/archive-search.acceptance.spec.js) | CP467: 3 native + 2 live bilingual browser + 2 worker/API tests pass. Search native charter decisions, approved lessons and their eligible text/PDF files; immutable actor/time/project/company request audit. Current source fingerprint, approval and native project/source ACLs revalidated before snippets or reopening. Separate persistent SQLite FTS/WAL volume; no extraction in live requests. Networkless worker: 0.5 CPU, 384 MB, 32 PIDs, read-only root, one bounded extraction child, 20-second timeout. Thirty-file load probe observed active indexing with 11 successful live native reads, maximum 101 ms. Invalid/foreign/unprivileged denial and stale suppression verified. Keyword search only; no semantic accuracy or unlimited hardware isolation claim. |
| BE-130 | P1 | Enforce tenant/project document ACLs | 8.5, 11 | DONE | [OCA DMS security mixin and file storage](../odoo/addons/oca20/dms/dms/models/dms_security_mixin.py)<br>[project document ACL bridge](../addons/namaa_ai_bridge/models/project_documents_bridge.py)<br>[immutable document revision addon](../odoo/addons/be/be_project_documents)<br>[OCA DMS file model](../odoo/addons/oca20/dms/dms/models/dms_file.py)<br>[knowledge tenant boundary](../services/platform/app/knowledge/router.py) | [Project DMS/folder/upload/revision ACL QA](build-engine/PROJECT_DOCUMENTS_DMS_QA.json)<br>[Full Odoo 20 OCA DMS suite: 77/77](build-engine/OCA_DMS_ODOO20_QA.json)<br>[Checkpoint 306](build-engine/CHECKPOINT_306.md)<br>[Checkpoint 301](build-engine/CHECKPOINT_301.md) | All supplied criteria passed in current-source isolated acceptance with OCA DMS and `be_project_documents` installed on a disposable clone. Native Odoo tests 4/4; authenticated React → BFF → Odoo journey 1/1. PM provisioned the project folders, uploaded a revision, signed out and signed back in, then reopened file history with actor/time and company/project. Missing directory input returned field-level 422/no-write. Same-company reader was denied upload and DMS-group-only list/download; foreign-company PM was denied target project read/upload without disclosure. Odoo readback verified creator, company, revision and checksum. Clone/temp services removed and source database unchanged. The DMS addons are not installed in the shared runtime; rollout/UAT is a separate follow-up.
| BE-131 | P2 | Isolate archive indexing from live transaction performance | 8.5, 11 | DONE | [Native archive authorization](../addons/namaa_ai_bridge/models/archive_search_bridge.py)<br>[Separate index worker](../backend/app/archive_worker.py)<br>[React archive search](../frontend/src/ArchiveSearchWorkspace.jsx)<br>[Bounded Compose worker](../compose.yaml) | [Archive acceptance](build-engine/evidence/ARCHIVE_SEARCH_ACCEPTANCE_20261109.json)<br>[Native tests](../addons/namaa_ai_bridge/tests/test_archive_search.py)<br>[Worker/API tests](../backend/tests/test_archive_index.py)<br>[Browser acceptance](../frontend/e2e/archive-search.acceptance.spec.js) | CP467: 3 native + 2 live bilingual browser + 2 worker/API tests pass. Search native charter decisions, approved lessons and their eligible text/PDF files; immutable actor/time/project/company request audit. Current source fingerprint, approval and native project/source ACLs revalidated before snippets or reopening. Separate persistent SQLite FTS/WAL volume; no extraction in live requests. Networkless worker: 0.5 CPU, 384 MB, 32 PIDs, read-only root, one bounded extraction child, 20-second timeout. Thirty-file load probe observed active indexing with 11 successful live native reads, maximum 101 ms. Invalid/foreign/unprivileged denial and stale suppression verified. Keyword search only; no semantic accuracy or unlimited hardware isolation claim. |
| BE-132 | P2 | Export archived project pack | 8.5 | DONE | [Odoo immutable project export model and ZIP builder](../addons/namaa_ai_bridge/models/crm_technical_proposal_bridge.py)<br>[Authenticated BFF routes and ZIP integrity checks](../backend/app/main.py)<br>[React project archive export history](../frontend/src/TechnicalProposalArchiveWorkspace.jsx) | [Native lifecycle/security QA](../addons/namaa_ai_bridge/tests/test_crm_technical_proposal.py)<br>[BFF contract/route tests](../backend/tests/test_business.py)<br>[Authenticated React live journey](../frontend/e2e/project-proposal-boq-archive.live.spec.js)<br>[Isolated QA runner](../scripts/run_project_archive_export_live_qa.py)<br>[QA evidence](build-engine/PROJECT_ARCHIVE_EXPORT_LIVE_QA.json)<br>[Checkpoint 289](build-engine/CHECKPOINT_289.md)<br>[DMS integration QA](build-engine/DMS_ARCHIVE_EXPORT_QA.json) | All supplied criteria passed in current-source isolated acceptance. A Project Manager exported the approved proposal/confirmed BOQ pack with issued/superseded drawings, approved submittal revision files and direct project attachments in a private checksummed ZIP; pending and foreign-project sources were excluded. Invalid short rationale returned field-level 422 and created no export. A fresh PM login reopened state, actor, timestamp, project, company and rationale. Same-company reader and foreign-company access were denied without disclosure. Native lifecycle/security QA 1/1; authenticated React → BFF → Odoo journey 1/1. Clone removed and source DB unchanged. OCA DMS integration is separately tracked and is not in the supplied A1–A4.

## No-code workflow engine

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-133 | P0 | Create workflow from standard template | 9.4 | DONE | [React standard-template reuse and visual graph](../frontend/src/WorkflowTemplatesWorkspace.jsx)<br>[authenticated template contracts](../backend/app/contracts.py)<br>[native template validation](../addons/namaa_ai_bridge/models/workflow_template_bridge.py) | [current-source native and bilingual live acceptance](build-engine/evidence/WORKFLOW_LIFECYCLE_ACCEPTANCE_20261107.json)<br>[broader native regression](build-engine/evidence/WORKFLOW_REGRESSION_20261107.json) | All four supplied criteria are verified: Owner reuses a published standard in React under a new name/code, saves and reopens authoritative Odoo stages/transitions with actor/time/company. Stage reachability, completion paths, conditions and approvers are validated; invalid graphs create no template/audit transaction. PM mutation and foreign-company history/version operations are denied without disclosure. Published versions are immutable. Existing gate bindings and native transition actions survive version copies and edits. Source database unchanged; disposable services removed. [Checkpoint 465](build-engine/CHECKPOINT_465.md). |
| BE-134 | P0 | Build stages and transitions in visual editor | 9.4 | DONE | [React lifecycle graph editor](../frontend/src/WorkflowTemplatesWorkspace.jsx)<br>[Odoo workflow template bridge](../addons/namaa_ai_bridge/models/workflow_template_bridge.py) | [workflow editor browser journey](../frontend/e2e/workflow-templates.spec.js)<br>[two-role isolated React → BFF → Odoo QA](build-engine/WORKFLOW_TEMPLATE_LIVE_QA.json)<br>[Checkpoint 410](build-engine/CHECKPOINT_410.md) | All supplied graph-editor acceptance is verified: an ordinary Owner created and saved three named stages and directed transitions with role, group and user approver configuration; publication preserved v1 and copy-on-write produced editable v2. A separate same-company PM read the published graph but received 403 on create. Reopened Odoo state and audit metadata matched; the disposable clone was dropped. |
| BE-135 | P0 | Configure transition conditions and role permissions | 9.4 | DONE | [React lifecycle condition/approver editor](../frontend/src/WorkflowTemplatesWorkspace.jsx)<br>[Odoo condition parser and transition model](../odoo/addons/be/be_workflow/models/be_workflow_transition.py)<br>[Company-scoped Odoo bridge](../addons/namaa_ai_bridge/models/workflow_template_bridge.py) | [Native workflow condition tests](../odoo/addons/be/be_workflow/tests/test_be_workflow.py)<br>[Authenticated two-role React → BFF → Odoo journey](build-engine/WORKFLOW_TEMPLATE_LIVE_QA.json)<br>[Checkpoint 411](build-engine/CHECKPOINT_411.md) | An ordinary Owner configured a condition expression and role, Odoo group and named-user approvers in React; Odoo readback confirmed the exact expression and approvers on the published transition. The same-company PM could read the published policy but received 403 when attempting to create/configure one. The assigned project-type template remained company-scoped. The unrelated DEC-06 decision about which approval matrix the contractor wants for operational workflows remains open; this story verifies configuration capability, not a mandated business approver policy. |
| BE-136 | P0 | Bind mandatory quality gates to transitions | 8.1, 9.4, 10.2 | DONE | [React mandatory exit-gate selector](../frontend/src/WorkflowTemplatesWorkspace.jsx)<br>[published company-scoped native gate validation](../addons/namaa_ai_bridge/models/workflow_template_bridge.py)<br>[React evidence review and signing](../frontend/src/QualityGatesWorkspace.jsx) | [current-source native and three-role live acceptance](build-engine/evidence/BE136_EXIT_GATE_BINDING_ACCEPTANCE_20261107.json) | All four supplied criteria are verified: Owner binds a published company checklist to a lifecycle stage in React, saves/publishes and reopens the actor/time/company and binding. Invalid gate IDs and unpublished/foreign gates create no partial template; PM configuration and foreign project/checklist reads are denied. A PM cannot leave the stage until the Site role attaches required photo evidence and signs; native readback verifies Site evidence/signature, PM final transition and company. Native 4/4, live configuration and execution journeys 1/1 each. This applies to every outgoing transition of the bound stage. Online checklist roles/evidence follow the selected published template; no offline final approval, regulatory certification or production policy sign-off is implied. Source DB unchanged; temporary resources removed. |
| BE-137 | P1 | Validate workflow before publishing | 9.4 | DONE | [React lifecycle editor validation and publish flow](../frontend/src/WorkflowTemplatesWorkspace.jsx)<br>[Odoo bridge validation](../addons/namaa_ai_bridge/models/workflow_template_bridge.py)<br>[Native Odoo condition parser](../odoo/addons/be/be_workflow/models/be_workflow_transition.py) | [Native workflow parser/lifecycle tests](../odoo/addons/be/be_workflow/tests/test_be_workflow.py)<br>[Authenticated invalid/valid lifecycle React journey](build-engine/WORKFLOW_TEMPLATE_LIVE_QA.json)<br>[Checkpoint 412](build-engine/CHECKPOINT_412.md) | Invalid transition syntax (`name ==`) returned HTTP 422 before any template was stored; a follow-up query confirmed no matching row. A valid condition and approvers could then be saved, read back from Odoo, and published through the same workflow. Playwright journey passed 1/1 on a disposable clone. The native module-upgrade suite remains to rerun on a clean fixture; this story is limited to structural and condition validation before publication, not migration of active instances. |
| BE-138 | P1 | Version workflow and migrate active instances safely | 9.4 | DONE | [React version controls](../frontend/src/WorkflowTemplatesWorkspace.jsx)<br>[React explicit project migration](../frontend/src/WorkflowMigrationPanel.jsx)<br>[native locked migration](../addons/namaa_ai_bridge/models/project_workflow_bridge.py) | [current-source native and bilingual live acceptance](build-engine/evidence/WORKFLOW_LIFECYCLE_ACCEPTANCE_20261107.json)<br>[broader native regression](build-engine/evidence/WORKFLOW_REGRESSION_20261107.json) | All four supplied criteria are verified: Owner publishes a separate version, explicitly migrates a writable running project with a rationale, and reopens its new version/current stage and audit record. Running instances stay pinned until that operation. Migration requires the same company/model/lineage, unambiguous matching stage names and start/completion meaning, and unchanged gate bindings. Stale revisions, pending approvals, incompatible stages, completed gate evidence and unauthorized/foreign-company targets are denied without partial migration. Pending gate rows retain their checklist/evidence and map to the corresponding stage. Completed evidence remains pinned; arbitrary renamed-stage or changed-gate mapping is deliberately refused. Source database unchanged; disposable services removed. [Checkpoint 465](build-engine/CHECKPOINT_465.md). |
| BE-139 | P1 | Audit configuration changes and rollback | 9.4, 11 | DONE | [React immutable configuration history and restore](../frontend/src/WorkflowHistoryPanel.jsx)<br>[native configuration events](../odoo/addons/be/be_workflow/models/be_workflow_config_event.py)<br>[native restoration](../addons/namaa_ai_bridge/models/workflow_template_bridge.py) | [current-source native and bilingual live acceptance](build-engine/evidence/WORKFLOW_LIFECYCLE_ACCEPTANCE_20261107.json)<br>[broader native regression](build-engine/evidence/WORKFLOW_REGRESSION_20261107.json) | All four supplied criteria are verified: Owner restores a selected prior publication into a new draft with mandatory rationale, reviews/publishes it and reopens immutable configuration snapshots with actor/time/company. Original publications and pinned project instances remain unchanged; applying the restored configuration to a project requires the separate guarded migration. Audit covers React create/update/publish/version/restore/migrate, including gate/action configuration. Invalid/stale, PM and foreign-company operations cannot write or disclose history; audit creation cannot be forged through ordinary model RPC and write/delete are denied. Source database unchanged; disposable services removed. [Checkpoint 465](build-engine/CHECKPOINT_465.md). |

## Offline and Excel

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-140 | P0 | Download offline-ready assigned project data | 9.5 | DONE | [Native offline bridge](../addons/namaa_ai_bridge/models/offline_site_bridge.py)<br>[Encrypted React vault and sync](../frontend/src/OfflineSiteWorkspace.jsx)<br>[Authenticated BFF](../backend/app/offline_site.py) | [Offline acceptance](build-engine/evidence/OFFLINE_SITE_ACCEPTANCE_20261109.json)<br>[Native tests](../addons/namaa_ai_bridge/tests/test_offline_site_bridge.py)<br>[Browser acceptance](../frontend/e2e/offline-site.acceptance.spec.js) | CP467: 6 native + 2 real-session browser tests pass. Assigned immutable multi-page project/task/material/master/file snapshots; incomplete refresh preserves cache and full replacement removes archived rows. Encrypted scoped device vault survives cold offline reload. Native progress/material/daily/photo captures sync with stable retries, exact version locks, visible keep/reapply conflicts, native actor/time/company and duplicate-free lost-response uploads. Role/company/project denial and invalid/no-partial writes verified. Owner-audited default-disabled TTL policy. Material observations do not post stock actuals; offline cached identity is not a live login. |
| BE-141 | P0 | Create queued task updates while disconnected | 9.5 | DONE | [Native offline bridge](../addons/namaa_ai_bridge/models/offline_site_bridge.py)<br>[Encrypted React vault and sync](../frontend/src/OfflineSiteWorkspace.jsx)<br>[Authenticated BFF](../backend/app/offline_site.py) | [Offline acceptance](build-engine/evidence/OFFLINE_SITE_ACCEPTANCE_20261109.json)<br>[Native tests](../addons/namaa_ai_bridge/tests/test_offline_site_bridge.py)<br>[Browser acceptance](../frontend/e2e/offline-site.acceptance.spec.js) | CP467: 6 native + 2 real-session browser tests pass. Assigned immutable multi-page project/task/material/master/file snapshots; incomplete refresh preserves cache and full replacement removes archived rows. Encrypted scoped device vault survives cold offline reload. Native progress/material/daily/photo captures sync with stable retries, exact version locks, visible keep/reapply conflicts, native actor/time/company and duplicate-free lost-response uploads. Role/company/project denial and invalid/no-partial writes verified. Owner-audited default-disabled TTL policy. Material observations do not post stock actuals; offline cached identity is not a live login. |
| BE-142 | P0 | Capture material usage and daily report offline | 9.5 | DONE | [Native offline bridge](../addons/namaa_ai_bridge/models/offline_site_bridge.py)<br>[Encrypted React vault and sync](../frontend/src/OfflineSiteWorkspace.jsx)<br>[Authenticated BFF](../backend/app/offline_site.py) | [Offline acceptance](build-engine/evidence/OFFLINE_SITE_ACCEPTANCE_20261109.json)<br>[Native tests](../addons/namaa_ai_bridge/tests/test_offline_site_bridge.py)<br>[Browser acceptance](../frontend/e2e/offline-site.acceptance.spec.js) | CP467: 6 native + 2 real-session browser tests pass. Assigned immutable multi-page project/task/material/master/file snapshots; incomplete refresh preserves cache and full replacement removes archived rows. Encrypted scoped device vault survives cold offline reload. Native progress/material/daily/photo captures sync with stable retries, exact version locks, visible keep/reapply conflicts, native actor/time/company and duplicate-free lost-response uploads. Role/company/project denial and invalid/no-partial writes verified. Owner-audited default-disabled TTL policy. Material observations do not post stock actuals; offline cached identity is not a live login. |
| BE-143 | P0 | Sync queued changes on reconnect | 9.5 | DONE | [Native offline bridge](../addons/namaa_ai_bridge/models/offline_site_bridge.py)<br>[Encrypted React vault and sync](../frontend/src/OfflineSiteWorkspace.jsx)<br>[Authenticated BFF](../backend/app/offline_site.py) | [Offline acceptance](build-engine/evidence/OFFLINE_SITE_ACCEPTANCE_20261109.json)<br>[Native tests](../addons/namaa_ai_bridge/tests/test_offline_site_bridge.py)<br>[Browser acceptance](../frontend/e2e/offline-site.acceptance.spec.js) | CP467: 6 native + 2 real-session browser tests pass. Assigned immutable multi-page project/task/material/master/file snapshots; incomplete refresh preserves cache and full replacement removes archived rows. Encrypted scoped device vault survives cold offline reload. Native progress/material/daily/photo captures sync with stable retries, exact version locks, visible keep/reapply conflicts, native actor/time/company and duplicate-free lost-response uploads. Role/company/project denial and invalid/no-partial writes verified. Owner-audited default-disabled TTL policy. Material observations do not post stock actuals; offline cached identity is not a live login. |
| BE-144 | P1 | Resolve optimistic-version conflicts visibly | 9.5 | DONE | [Native offline bridge](../addons/namaa_ai_bridge/models/offline_site_bridge.py)<br>[Encrypted React vault and sync](../frontend/src/OfflineSiteWorkspace.jsx)<br>[Authenticated BFF](../backend/app/offline_site.py) | [Offline acceptance](build-engine/evidence/OFFLINE_SITE_ACCEPTANCE_20261109.json)<br>[Native tests](../addons/namaa_ai_bridge/tests/test_offline_site_bridge.py)<br>[Browser acceptance](../frontend/e2e/offline-site.acceptance.spec.js) | CP467: 6 native + 2 real-session browser tests pass. Assigned immutable multi-page project/task/material/master/file snapshots; incomplete refresh preserves cache and full replacement removes archived rows. Encrypted scoped device vault survives cold offline reload. Native progress/material/daily/photo captures sync with stable retries, exact version locks, visible keep/reapply conflicts, native actor/time/company and duplicate-free lost-response uploads. Role/company/project denial and invalid/no-partial writes verified. Owner-audited default-disabled TTL policy. Material observations do not post stock actuals; offline cached identity is not a live login. |
| BE-145 | P1 | Retry failed uploads without duplicate records | 9.5 | DONE | [Native offline bridge](../addons/namaa_ai_bridge/models/offline_site_bridge.py)<br>[Encrypted React vault and sync](../frontend/src/OfflineSiteWorkspace.jsx)<br>[Authenticated BFF](../backend/app/offline_site.py) | [Offline acceptance](build-engine/evidence/OFFLINE_SITE_ACCEPTANCE_20261109.json)<br>[Native tests](../addons/namaa_ai_bridge/tests/test_offline_site_bridge.py)<br>[Browser acceptance](../frontend/e2e/offline-site.acceptance.spec.js) | CP467: 6 native + 2 real-session browser tests pass. Assigned immutable multi-page project/task/material/master/file snapshots; incomplete refresh preserves cache and full replacement removes archived rows. Encrypted scoped device vault survives cold offline reload. Native progress/material/daily/photo captures sync with stable retries, exact version locks, visible keep/reapply conflicts, native actor/time/company and duplicate-free lost-response uploads. Role/company/project denial and invalid/no-partial writes verified. Owner-audited default-disabled TTL policy. Material observations do not post stock actuals; offline cached identity is not a live login. |
| BE-146 | P1 | Import validated Excel template and show row errors | 9.3 | DONE | [React BOQ mapping/row errors](../frontend/src/BoqImportDialog.jsx)<br>[BFF workbook parser](../backend/app/boq_import.py)<br>[Odoo BOQ import persistence](../addons/namaa_ai_bridge/models/boq_bridge.py) | [current-source isolated live import QA](build-engine/BE050_BOQ_IMPORT_LIVE_QA.json)<br>[current-source native Odoo regression: 27/27](build-engine/BE050_BOQ_IMPORT_LIVE_QA.json)<br>[authenticated import browser journey: 1/1](../frontend/e2e/boq.import.live.spec.js)<br>[retry QA](build-engine/CHECKPOINT_93.md)<br>[Checkpoint 426](build-engine/CHECKPOINT_426.md) | All four supplied criteria are verified: an authorized Quantity Surveyor imported a real workbook into the authoritative Odoo BOQ; invalid input is rejected before commit; reopening shows draft, creator, timestamps, project/company and import provenance; same-company reader and foreign-company QS are denied without disclosure. Current-source isolated native BOQ/bridge suite passed 27/27 and authenticated React→BFF→Odoo import browser passed 1/1. Clone removed and source database unchanged. Additional entity templates and distinct batch-history/retention are extensions, not acceptance criteria for this story. |
| BE-147 | P2 | Export BOQ and operational reports to Excel | 9.3 | DONE | [React BOQ export](../frontend/src/BoqWorkspace.jsx)<br>[React site reports](../frontend/src/SiteDailyLogsWorkspace.jsx)<br>[correspondence export](../frontend/src/ProjectCorrespondenceLog.jsx)<br>[purchase receipts](../frontend/src/PurchaseReceiptsWorkspace.jsx)<br>[filtered timesheets](../frontend/src/TimesheetsWorkspace.jsx)<br>[authenticated XLSX endpoints](../backend/app/main.py) | [current-source timesheet workbook and role/company acceptance](build-engine/evidence/BE147_TIMESHEET_EXPORT_LIVE_QA.json)<br>[live BOQ export](build-engine/BOQ_DRAFT_REVISION_LIVE_QA.json)<br>[site export](build-engine/SITE_DAILY_REPORT_EXPORT_LIVE_QA.json)<br>[receipt export](build-engine/evidence/BE-147_PURCHASE_RECEIPTS_EXPORT_LIVE_QA.json)<br>[correspondence acceptance](build-engine/RFI_LIVE_QA.json) | All four supplied criteria are verified for BOQ and the delivered operational exports: site reports, correspondence, purchase receipts and timesheets. The current-source timesheet run passes three native role/write tests, direct inclusive project/date and reversed-date checks, and an authenticated Arabic React workbook journey. Downloaded XLSX contains exactly both boundary-date rows, RTL Arabic headers and literal formula-like text; other-project/out-of-range rows and cost/rate fields are excluded. Reader and foreign-company requests are denied without disclosure. Prior live evidence covers the other four sources. Read-only exports create no business record; exported source records retain their native actor/time/company. Timesheet matches above 200 are rejected rather than truncated. Additional report types remain module-parity backlog, not an assertion that every installed report has an export. [Checkpoint 465](build-engine/CHECKPOINT_465.md). |

## Project management AI

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-148 | P0 | Draft project charter and baseline plan | 9.1, 9.2 | DONE | [Source-constrained charter/baseline generator](../backend/app/project_charter_ai.py)<br>[React project charter workspace](../frontend/src/ProjectCharterWorkspace.jsx)<br>[Odoo project and schedule bridge](../addons/namaa_ai_bridge/models/project_bridge.py)<br>[Native AI suggestion audit model](../odoo/addons/be/be_ai/models/be_ai_suggestion.py) | [Generator/model tests](../backend/tests/test_project_charter_ai.py)<br>[BFF route tests](../backend/tests/test_business.py)<br>[Native role/source/staleness tests](../addons/namaa_ai_bridge/tests/test_project_charter_ai.py)<br>[React draft and approval journey](../frontend/e2e/project-charter.spec.js)<br>[Live acceptance journey](../frontend/e2e/project-charter-ai-acceptance.live.spec.js)<br>[Acceptance evidence](build-engine/PROJECT_CHARTER_AI_ACCEPTANCE_LIVE_QA.json)<br>[English screenshot](build-engine/frontend/screenshots/live-project-charter-ai-en-acceptance.png)<br>[Arabic screenshot](build-engine/frontend/screenshots/live-project-charter-ai-ar-acceptance.png)<br>[Checkpoint 402](build-engine/CHECKPOINT_402.md) | All supplied criteria verified on a disposable current-source Odoo clone through authenticated React → BFF → Qwen → Odoo. PM saved English and Arabic pending drafts from authorized project/task facts; fresh login reopened them with actor, time, company, sources, uncertainty and baseline phases. Invalid language returned 422/no-write; same-company reader could not see AI drafts or create one; foreign-company PM list/create requests were denied without disclosure. AI did not change the project/task or create an official charter. Native Odoo 5/5 and live browser 1/1 passed; clone dropped and source unchanged. The previous “installed model absent” guard was fixed: empty Odoo model recordsets are falsey, so model availability now checks `is False` explicitly. Arabic screenshot reviewed for readable output and explicit uncertainty. |
| BE-149 | P0 | Suggest task sequencing and resource allocation | 9.1, 9.2 | DONE | [backend/app/schedule_ai.py](../backend/app/schedule_ai.py)<br>[backend/app/main.py](../backend/app/main.py)<br>[addons/namaa_ai_bridge/models/project_bridge.py](../addons/namaa_ai_bridge/models/project_bridge.py)<br>[frontend/src/ProjectScheduleWorkspace.jsx](../frontend/src/ProjectScheduleWorkspace.jsx)<br>[odoo/addons/be/be_ai/models/be_ai_suggestion.py](../odoo/addons/be/be_ai/models/be_ai_suggestion.py) | [backend/tests/test_schedule_ai.py](../backend/tests/test_schedule_ai.py)<br>[backend/tests/test_business.py](../backend/tests/test_business.py)<br>[addons/namaa_ai_bridge/tests/test_bridge.py](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[frontend/e2e/project-schedule-suggestion.spec.js](../frontend/e2e/project-schedule-suggestion.spec.js)<br>[live QA](../docs/build-engine/SCHEDULE_SUGGESTION_LIVE_QA.json)<br>[native QA](../docs/build-engine/SCHEDULE_SUGGESTION_NATIVE_QA.json)<br>[Checkpoint 240](../docs/build-engine/CHECKPOINT_240.md) | Authenticated live React→BFF→Odoo/model and native cross-tenant QA passed. Odoo persisted and reopened the pending suggestion with actor/project/company audit; invalid/stale/unauthorized operations are covered; no official task dates or assignments changed; draft, sources and uncertainty are visible and it never self-approves. Allocation uses visible open-task counts and discloses that skills, qualifications and availability are not known. See checkpoint and QA evidence. |
| BE-150 | P0 | Generate BOQ draft from scope and drawings | 8.1, 9.1 | PARTIAL | [AI draft API and source validation](../backend/app/boq_ai.py)<br>[Odoo provenance bridge](../addons/namaa_ai_bridge/models/boq_bridge.py)<br>[React BOQ workspace](../frontend/src/BoqWorkspace.jsx)<br>[Native BOQ model](../odoo/addons/be/be_boq/models/be_boq.py) | [Backend AI tests](../backend/tests/test_boq_ai.py)<br>[Native provenance/foreign-project tests](../odoo/addons/be/be_boq/tests/test_be_boq.py)<br>[Live React→BFF→Odoo QA](build-engine/evidence/BE-150_AI_BOQ_LIVE_QA.json)<br>[Live Playwright journey](../frontend/e2e/boq.ai.live.spec.js)<br>[Checkpoint 462](build-engine/CHECKPOINT_462.md) | Current-source isolated live QA passed 2/2 native tests and 2/2 browser cases: an authorized PM generated a synthetic-drawing proposal, edited quantity/rate, explicitly saved and reopened the Odoo draft with actor, timestamp, project, company and immutable source/model fingerprints; invalid data, same-company reader and foreign-company project attempts were denied without writes or disclosure. The disposable clone and services were removed; namaa_ksa remained unchanged. The model response and 2x2-pixel drawing are synthetic, and quantity-surveyor/model accuracy was not assessed. Keep PARTIAL until a representative drawing and approved estimator accuracy criteria are validated; deterministic-stub workflow QA is not accuracy evidence. |
| BE-151 | P0 | Identify schedule cost and quality risks | 9.1 | DONE | [React project risk report](../frontend/src/ProjectReportsWorkspace.jsx)<br>[Source-constrained Qwen risk generator](../backend/app/project_risk_ai.py)<br>[BFF request route and strict contract](../backend/app/main.py)<br>[Odoo source snapshot, revision guard and review bridge](../addons/namaa_ai_bridge/models/project_report_bridge.py)<br>[Existing QS suggestion foundation](../services/platform/app/agents/qs) | [Backend risk/report tests](../backend/tests/test_project_risk_ai.py)<br>[Native Odoo role/citation/stale-source tests](../addons/namaa_ai_bridge/tests/test_project_reports.py)<br>[Mocked React workflow](../frontend/e2e/project-reports.spec.js)<br>[Live Qwen two-role journey](../frontend/e2e/project-risk.live.spec.js)<br>[Checkpoint 400](build-engine/CHECKPOINT_400.md)<br>[Combined isolated live QA evidence](build-engine/PROJECT_REPORTS_LIVE_QA.json) | **A1:** authenticated PM generated a source-cited schedule/cost/quality risk draft; Odoo persisted it pending, and a distinct Owner reviewed it. **A2:** malformed period/reason requests returned field-level 422 and before/after report/audit state was unchanged. **A3:** React fresh-session reopen showed project, company, author, timestamp and review state; Odoo readback verified citations, reviewer and persistent risk-owner activity/audit. **A4:** same-company reader and foreign-company Owner/PM were denied without disclosure when reading the target-company project; foreign users could read their own project endpoint, with response rows constrained to their own project/company. Current-source isolated QA: Odoo native 7/7, authenticated React→BFF→Qwen→Odoo browser 2/2; disposable clone/services removed and source `namaa_ksa` unchanged. |
| BE-152 | P1 | Draft supplier RFQ for human authorization | 9.1, 9.2 | DONE | [React material request action](../frontend/src/MaterialRequestsWorkspace.jsx)<br>[React review inbox](../frontend/src/PurchaseRfqAiWorkspace.jsx)<br>[BFF/model drafting](../backend/app/purchase_rfq_ai.py)<br>[Odoo source, revision guard and independent review](../addons/namaa_ai_bridge/models/purchase_rfq_ai_bridge.py)<br>[Native RFQ fields](../addons/namaa_ai_bridge/views/purchase_rfq_ai_views.xml) | [Backend contract/model tests](../backend/tests/test_purchase_rfq_ai.py)<br>[Native lifecycle/security tests](../addons/namaa_ai_bridge/tests/test_purchase_rfq_ai.py)<br>[React mock journey](../frontend/e2e/material-requests.spec.js)<br>[Live two-role React → Qwen → Odoo journey](../frontend/e2e/purchase-rfq-ai.live.spec.js)<br>[Native QA evidence](build-engine/PURCHASE_RFQ_AI_NATIVE_QA.json)<br>[Live QA evidence](build-engine/PURCHASE_RFQ_AI_LIVE_QA.json)<br>[Checkpoint 382](build-engine/CHECKPOINT_382.md) | All five supplied criteria passed in isolated live React→BFF→Qwen→Odoo acceptance. Missing supplier returned field-level 422 with no saved suggestion; Arabic draft text showed source IDs and uncertainty, remained pending, and was approved only by a separate Procurement reviewer with rationale. Fresh reviewer login reopened persisted actor/time/project/company and approved state; exactly one linked PO remained draft and zero emails were sent. Foreign-company Procurement could neither list nor draft the source request, with no disclosure. Native tests 4/4; authenticated browser journey 1/1. Clone, BFF and image removed; source database unchanged. |
| BE-153 | P1 | Propose change order impact | 9.1, 9.2 | DONE | [React variation impact panel](../frontend/src/ContractVariations.jsx)<br>[BFF generation routes](../backend/app/main.py)<br>[Constrained bilingual impact generator](../backend/app/variation_impact_ai.py)<br>[Odoo source snapshot, revision guard and audit draft](../addons/namaa_ai_bridge/models/variation_impact_bridge.py) | [Backend model tests](../backend/tests/test_variation_impact.py)<br>[Backend route tests](../backend/tests/test_business.py)<br>[Native role/company/staleness tests](../addons/namaa_ai_bridge/tests/test_variation_impact.py)<br>[Live two-role React → Qwen → Odoo evidence](build-engine/VARIATION_IMPACT_LIVE_QA.json)<br>[Arabic screenshot](build-engine/frontend/screenshots/live-variation-impact-arabic-draft.png)<br>[Checkpoint 401](build-engine/CHECKPOINT_401.md) | All supplied criteria verified. A1: PM saved English and Arabic pending drafts from the authoritative Odoo variation snapshot; actor, timestamp, company and revision-bound source citations reopened in React. A2: unsupported language returned field-level 422 and created no draft. A3: both drafts reopened with source citations and uncertainty; the AI did not mutate the task, variation or BOQ. A4: same-company read-only and foreign-company PM GET/POST requests were denied without disclosing the target project or foreign company. A separate Owner action, not the AI draft, submitted/approved the variation and applied its SAR 750 BOQ delta once while preserving the old baseline. Native 4/4, live browser 1/1; disposable clone dropped and source DB unchanged. DEC-06 approval authority remains an open decision for BE-055/056 and is not part of this advisory story. |
| BE-154 | P1 | Draft RFI site report and status report | 9.1, 9.2 | DONE | [React report workspace](../frontend/src/ProjectReportsWorkspace.jsx)<br>[BFF/model draft service](../backend/app/project_reports.py)<br>[Odoo source, audit and review bridge](../addons/namaa_ai_bridge/models/project_report_bridge.py) | [Backend schema/citation tests](../backend/tests/test_project_reports.py)<br>[Native Odoo role/lifecycle tests](../addons/namaa_ai_bridge/tests/test_project_reports.py)<br>[Live two-role React → Qwen → Odoo QA](build-engine/PROJECT_REPORT_LIVE_QA.json)<br>[Checkpoint 250](build-engine/CHECKPOINT_250.md)<br>[Draft/review screenshots](build-engine/frontend/screenshots/live-project-rfi-report-draft.png) | All four generic acceptance criteria plus the story-specific AI safeguard were verified. A PM created a source-grounded Arabic status report in React from authorized Odoo project/task records; the saved pending draft reopened to a separate Owner with actor, time, project/company, cited task source and uncertainty. Invalid/reversed periods returned 422 with no new report; same-company reader and foreign-company PM received 403 without disclosure on read/create. The Owner independently approved with rationale; Odoo stored one immutable review event, the AI did not self-approve, and the project remained unchanged. Current-source isolated native project-report suite 7/7 and authenticated React→BFF→Qwen→Odoo browser journeys 3/3 passed. Disposable clone, BFF and Odoo registry removed; source `namaa_ksa` unchanged. Report export is separate follow-up, not a supplied acceptance criterion. |
| BE-155 | P2 | Notify role-specific risk owners | 9.1, 9.2 | DONE | [React risk owner panel](../frontend/src/ProjectRiskOwnersPanel.jsx)<br>[BFF request contract and routes](../backend/app/contracts.py)<br>[Odoo category role checks, activity and audit](../addons/namaa_ai_bridge/models/project_report_bridge.py) | [Backend contract/API tests](../backend/tests/test_business.py)<br>[React owner assignment journey](../frontend/e2e/project-reports.spec.js)<br>[Native persistence/role/retry tests](../addons/namaa_ai_bridge/tests/test_project_reports.py)<br>[Live PM/Owner assignment QA](build-engine/PROJECT_REPORTS_LIVE_QA.json)<br>[Checkpoint 382](build-engine/CHECKPOINT_382.md) | All four supplied criteria passed on a disposable clone. Invalid reason returned field-level 422 without creating activity/audit data; the reviewed assignment reopened with recipient, actor, timestamp, project and company; same-company read-only user and foreign-company Owner/PM were denied options/history/create against both projects without disclosure. QA readback found no foreign risk events or activities. Native tests 7/7; live React→BFF→Odoo journeys 2/2 (risk review and closeout lessons). Broader production role-policy acceptance remains outside these supplied criteria. Clone and temporary services removed; source database unchanged. |
| BE-156 | P2 | Record approve/edit/reject feedback | 9.1, 9.2 | DONE | [Odoo immutable feedback/revision model](../odoo/addons/be/be_ai/models/be_ai_suggestion_feedback.py)<br>[Authenticated BFF routes](../backend/app/main.py)<br>[React AI feedback review panel](../frontend/src/AISuggestionFeedbackPanel.jsx) | [Current-source native scoped audit test](build-engine/evidence/BE-156_AI_SUGGESTION_FEEDBACK_QA.json)<br>[BFF validation/ACL test](../backend/tests/test_business.py)<br>[React edit/approve/reopen flow](../frontend/e2e/ai-suggestion-feedback.spec.js)<br>[Checkpoint 438](build-engine/CHECKPOINT_438.md) | All five criteria pass. PM creates immutable edit/approve/reject feedback with rationale; invalid payload is a 422 with no write; history reopens with actors/time/project/company; ordinary-reader and foreign-company access are denied; feedback decisions never change official suggestion state or apply a business target without a separate authorized approval workflow. Native test 1/1, API 1/1, browser 1/1 (mock API), build/compile passed; clone dropped. |
| BE-157 | P2 | Draft closeout and lessons learned | 9.1, 9.2 | DONE | [React project report workspace](../frontend/src/ProjectReportsWorkspace.jsx)<br>[BFF report route and source-limited generator](../backend/app/main.py)<br>[Odoo closeout snapshot, source revision guard and review lifecycle](../addons/namaa_ai_bridge/models/project_report_bridge.py)<br>[Native certified closeout](../odoo/addons/be/be_project/models/be_project_closeout.py) | [Backend lesson generator tests](../backend/tests/test_project_reports.py)<br>[Native project report bridge tests](../addons/namaa_ai_bridge/tests/test_project_reports.py)<br>[React report browser flow](../frontend/e2e/project-reports.spec.js)<br>[Live PM/Owner journeys](../frontend/e2e/project-risk.live.spec.js)<br>[Checkpoint 297](build-engine/CHECKPOINT_297.md)<br>[Isolated live QA](build-engine/PROJECT_REPORTS_LIVE_QA.json) | All supplied criteria passed in a BE-157-only current-source isolated run. The Site/PM journey generated closeout lessons from a certified Odoo closeout with citations and uncertainty, held the AI output as pending without self-approval, then let a separate Owner review it without applying or sending it. Missing `period_end` returned a field-level 422 with no report write. Fresh Owner login reopened state, project/company, PM actor/time, Owner review and rationale. Same-company reader and foreign-company PM list/create requests returned 403 without disclosure. Native Odoo bridge tests 7/7; authenticated React → BFF → Qwen → Odoo browser journey 1/1; Odoo readback verified immutable review audit and unchanged project. Clone/temp services removed; source DB unchanged. Arabic model-quality evaluation and broader production UAT are follow-up work, outside the supplied acceptance criteria.

## Owner dashboards and notifications

| Story | Priority | Requirement | BRD | Status | Relevant implementation / reuse point | Existing tests (scope only) | Remaining story work, plus A1–A4 / DoD verification |
|---|---|---|---|---|---|---|---|
| BE-158 | P0 | View portfolio status and margin | 8.4 | DONE | [Native financial report](../addons/accounting_ksa/models/ksa_api.py)<br>[Owner portfolio method](../addons/namaa_ai_bridge/models/portfolio_financials.py)<br>[React portfolio](../frontend/src/PortfolioFinancials.jsx)<br>[React budgets](../frontend/src/AccountingReportsWorkspace.jsx) | [Native acceptance](../addons/namaa_ai_bridge/tests/test_portfolio_financials.py)<br>[Bilingual live browser](../frontend/e2e/financial-portfolio.acceptance.spec.js)<br>[Isolated evidence](build-engine/evidence/FINANCIAL_PORTFOLIO_ACCEPTANCE_20261108.json) | All supplied read/report criteria verified on a disposable database: three native methods and two authenticated production-build browser journeys passed. Report uses native fiscal-year configuration or explicit dates, validated/done budget lines and posted GL-linked project analytic income/expense entries. Actuals are counted once across overlapping budgets; unposted entries and off-ledger estimates are excluded, and unbudgeted posted costs remain visible. Owner portfolio adds status, planned/actual margins and a percentage only for positive revenue. Source actors/timestamps and company remain visible; unauthorized roles and foreign/current-company probes are isolated. Owner also needs existing native accounting read permission; no new financial access is granted. This verifies read-only reporting, without asserting Finance inventory-valuation policy, tax compliance or accountant production sign-off. |
| BE-159 | P0 | View budget vs actual by project | 8.4 | DONE | [Native financial report](../addons/accounting_ksa/models/ksa_api.py)<br>[Owner portfolio method](../addons/namaa_ai_bridge/models/portfolio_financials.py)<br>[React portfolio](../frontend/src/PortfolioFinancials.jsx)<br>[React budgets](../frontend/src/AccountingReportsWorkspace.jsx) | [Native acceptance](../addons/namaa_ai_bridge/tests/test_portfolio_financials.py)<br>[Bilingual live browser](../frontend/e2e/financial-portfolio.acceptance.spec.js)<br>[Isolated evidence](build-engine/evidence/FINANCIAL_PORTFOLIO_ACCEPTANCE_20261108.json) | All supplied read/report criteria verified on a disposable database: three native methods and two authenticated production-build browser journeys passed. Report uses native fiscal-year configuration or explicit dates, validated/done budget lines and posted GL-linked project analytic income/expense entries. Actuals are counted once across overlapping budgets; unposted entries and off-ledger estimates are excluded, and unbudgeted posted costs remain visible. Owner portfolio adds status, planned/actual margins and a percentage only for positive revenue. Source actors/timestamps and company remain visible; unauthorized roles and foreign/current-company probes are isolated. Owner also needs existing native accounting read permission; no new financial access is granted. This verifies read-only reporting, without asserting Finance inventory-valuation policy, tax compliance or accountant production sign-off. |
| BE-160 | P0 | View receivables payables and cash forecast | 8.4 | DONE | [native payment and allocation methods](../addons/namaa_ai_bridge/models/extension.py)<br>[authenticated BFF routes](../backend/app/main.py)<br>[React payment register](../frontend/src/AccountingPaymentsWorkspace.jsx)<br>[React allocation workspace](../frontend/src/PaymentAllocationWorkspace.jsx)<br>[Accounting navigation](../frontend/src/BusinessWorkspace.jsx)<br>[cash forecast and reports](../frontend/src/AccountingReportsWorkspace.jsx) <br>[React bank reconciliation](../frontend/src/BankReconciliationWorkspace.jsx)<br>[payment-register QA](build-engine/ACCOUNTING_PAYMENTS_REGISTER_QA.json)| [Current-source financial acceptance](build-engine/evidence/FINANCIAL_REPORTING_ACCEPTANCE_20261111.json)<br>[Native AR/AP tests](../addons/accounting_ksa/features/reports/tests/test_reports.py)<br>[Native cash forecast tests](../addons/accounting_ksa/features/forecast/tests/test_cash_forecast.py)<br>[Live finance roles/companies](../frontend/e2e/financial-reporting.acceptance.spec.js) | CP469: reporting scope is the supplied story: receivables, payables and cash forecast. Thirty-seven native tests passed, one optional recurring-payment integration test skipped because its separate module is absent; three live browser tests passed. Accountant views posted AR after partial payment/credit (SAR 900), AP SAR 400, cutoff aging and forecast; read-only finance reopens the same balances and explicitly includes draft invoices only on request. Native foreign-currency residuals are displayed in company currency. JSON forecast uses exactly the active company, excludes child-company data even for multi-company users, rejects company/filter overrides and records viewer/time. English/Arabic phone checks passed. Ledger entries and invoice revisions remain unchanged. General readers are denied and foreign-company sessions cannot see the target partner. Two-leg transfer reversal and external accountant/statutory certification remain separate capabilities, not reporting acceptance criteria. |
| BE-161 | P0 | View overdue quality gates and risks | 8.4 | DONE | [Odoo owner dashboard](../odoo/addons/be/be_dashboard)<br>[React executive alerts and register navigation](../frontend/src/Dashboard.jsx)<br>[Company-scoped alert aggregates](../backend/app/tools.py)<br>[Quality-gate capability](../addons/namaa_ai_bridge/models/extension.py)<br>[Quality register](../frontend/src/QualityGatesWorkspace.jsx) | [Backend executive aggregation](../backend/tests/test_business.py)<br>[Dashboard warning and drill-down browser journey](../frontend/e2e/workspace.spec.js)<br>[React unit suite](../frontend/tests)<br>[Live role/company QA](build-engine/BE161_DASHBOARD_QUALITY_LIVE_QA.json)<br>[Checkpoint 374](build-engine/CHECKPOINT_374.md) | Overdue corrective-action warning opens the React quality register filtered to overdue active findings, with an explicit empty state and show-all action. Current-source isolated QA passed native test 1/1 and authenticated browser checks 2/2: owner drilldown worked; unprivileged and foreign-company users saw no seeded finding. Postcondition confirmed due date and company scope; clone removed, source unchanged and Odoo healthy. |
| BE-162 | P1 | Drill into material variance and open tickets | 8.4 | DONE | [Odoo owner dashboard](../odoo/addons/be/be_dashboard)<br>[React dashboard drilldowns and source metadata](../frontend/src/Dashboard.jsx)<br>[Company-scoped dashboard BFF](../backend/app/tools.py)<br>[Focused live acceptance](build-engine/BE162_PROJECT_RISKS_LIVE_QA.json) | [Native Odoo owner/role test](../addons/namaa_ai_bridge/tests/test_bridge.py)<br>[Backend invalid-filter test](../backend/tests/test_business.py)<br>[React unit and browser tests](../frontend/tests)<br>[Live preview and owner/PM/foreign journey](../frontend/e2e/project-risks.live.spec.js)<br>[Checkpoint 398](build-engine/CHECKPOINT_398.md) | Owner drilldowns return source-linked material variance and open-ticket records with IDs and available project/company/responsible-user/timestamp metadata. Native 1/1, backend 1/1, preview + authenticated browser 2/2, React unit 96/96 and production build passed. Invalid page-size input returned field-level 422 with no BFF-to-Odoo read/write; same-company PM was denied without disclosure and foreign owner was restricted to own-company records. Odoo readback confirmed rows and unchanged counts. A3 write-audit is N/A: the drilldown is read-only and presents persisted source state/available audit metadata. Clone and dedicated worker removed; source database unchanged. |
| BE-163 | P1 | Configure role-based alerts and digest | 8.4, 11 | DONE | [Odoo role/topic preference and scoped digest model](../odoo/addons/be/be_dashboard/models/be_notification_preference.py)<br>[Scheduled delivery and read-state model](../odoo/addons/be/be_dashboard/models/be_notification_delivery.py)<br>[Odoo company bridge](../addons/namaa_ai_bridge/models/notifications_bridge.py)<br>[Authenticated BFF routes and strict matrix contract](../backend/app/main.py)<br>[Bilingual React notification center](../frontend/src/NotificationCenter.jsx) | [Odoo preference/bridge tests](../addons/namaa_ai_bridge/tests/test_notifications.py)<br>[Isolated Odoo QA](build-engine/NOTIFICATIONS_QA.json)<br>[Backend route/contract tests](../backend/tests/test_business.py)<br>[React browser flow](../frontend/e2e/notifications.spec.js)<br>[Current-source authenticated live QA](build-engine/BE163_ROLE_DIGEST_LIVE_QA.json)<br>[Checkpoint 373](build-engine/CHECKPOINT_373.md) | Owner configures and reopens company role/topic preferences through React→BFF→Odoo with actor/time/company audit; invalid frequency returns field-level 422/no write. PM controls are hidden and direct writes return 403; a weekly scoped digest is generated; a foreign owner sees no preferences and cross-company writes are denied. Native tests 2/2 and authenticated live browser 1/1 passed on a disposable clone; source unchanged. The generic project field is N/A for company-level digest preferences. External email/SMS/push channels are separate scope. |
| BE-164 | P1 | Export dashboard reports | 8.4 | DONE | [Owner-only Odoo export model](../odoo/addons/be/be_dashboard/models/be_dashboard_owner.py)<br>[React dashboard export UI](../frontend/src/Dashboard.jsx)<br>[Authenticated BFF routes](../backend/app/main.py) | [Native dashboard tests 17/17](../odoo/addons/be/be_dashboard/tests)<br>[React unit tests 95/95](../frontend/tests)<br>[Mobile Playwright 2/2](../frontend/e2e)<br>[BFF auth tests 2/2](../backend/tests)<br>[Current-source live QA](build-engine/BE164_OWNER_EXPORT_LIVE_QA.json)<br>[Checkpoint 370](build-engine/CHECKPOINT_370.md) | All applicable criteria verified via owner React→BFF→Odoo export. Owner created and reopened an audited export record; the protected XLSX downloaded with a valid ZIP header and linked company/project/exporter/time/outbox. Separate PM direct export returned 403; foreign owner history was empty and protected download returned 404. Native suite 17/17; real mobile browser flow 1/1. The generic invalid-input criterion is N/A because this export action has no required user-supplied parameters. Clone removed, source unchanged and Odoo healthy. |
