diff --git a/.claude/worktrees/modest-meninsky-d24f27 b/.claude/worktrees/modest-meninsky-d24f27
new file mode 160000
index 0000000..65aaf92
--- /dev/null
+++ b/.claude/worktrees/modest-meninsky-d24f27
@@ -0,0 +1 @@
+Subproject commit 65aaf9275eeb260be2d506d0deffd06cdde8f9b7
diff --git a/.claude/worktrees/thirsty-mclean-9799f6 b/.claude/worktrees/thirsty-mclean-9799f6
new file mode 160000
index 0000000..65aaf92
--- /dev/null
+++ b/.claude/worktrees/thirsty-mclean-9799f6
@@ -0,0 +1 @@
+Subproject commit 65aaf9275eeb260be2d506d0deffd06cdde8f9b7
diff --git a/Implementation fix.md b/Implementation fix.md
new file mode 100644
index 0000000..4e3eb5b
--- /dev/null
+++ b/Implementation fix.md	
@@ -0,0 +1,273 @@
+Implementation Goal
+Deliver a single, continuous evidence flow so users do not re-upload PDFs across M4->M5->M8->M9->M10, and always see the right document lineage.
+
+Target User Flow (after changes)
+
+User analyzes source docs in M4 from M3 or M5 context.
+User opens M5 and gets only relevant extracted requirements.
+User creates M8 contract from M5 and contract gets proposal PDF continuity automatically.
+User opens M9 from M8 with contractId preserved through diagnosis and case creation.
+User opens M10 and sees live dossier with file-level links, freshness state, and clear traceability.
+Phase Plan
+
+Phase 1: Fix Critical Continuity Breaks
+Stop unrelated M4 history fallback in M5 extraction when proposal has no linked source.
+Persist and use contractId in legal diagnosis finalization.
+Replace M9 contract selector from “IDs from existing cases” to “actual contracts list”.
+Files: workflow extract API, M5 detail page, legal diagnosis start, legal diagnosis answer, M9 view, M9 page.
+Phase 2: M5->M8 Document Reuse (No Reupload)
+On M8 autocreate, auto-copy latest proposal PDF into ContractDocument.
+Extend M8 extraction endpoint to accept sourceProposalId without mandatory new file upload.
+Add “Use proposal PDF from M5” action in M8 upload tab.
+Files: M8 page, contract extract API, contracts view, contract storage, proposal storage.
+Phase 3: Complete Contract Document UX
+Wire existing /api/contracts/upload into M8 UI.
+Show contract documents list in M8 cards.
+Add delete endpoint for contract documents and surface actions in UI.
+Files: contracts upload API, contracts view, contracts API folder.
+Phase 4: M10 Live Dossier + File-Level Traceability
+Make dossier load strategy explicit (live default, snapshot optional).
+Add freshness metadata (generatedAt, isStale, source indicator).
+Extend dossier payload from counts to include document-level entries and link targets.
+Render proposals/contracts/legal sections with drill-down and links in M10.
+Files: audits server, audits types, expediente API, M10 view.
+Phase 5: Secure Download Endpoints
+Add proposal document download endpoint.
+Add contract document download endpoint.
+Enforce ownership checks and safe storage path resolution.
+Files: proposals API folder, contracts API folder, proposal delete route pattern.
+Phase 6: Continuity Safeguards and Observability
+Add structured logs for handoffs (sourceProposalId, contractId, history source used).
+Add continuity warnings in UI when source context is missing.
+Add “why this file” trace badges where extraction picks source docs.
+Files: M4 view, M5 workflow view, M8 view, M10 view.
+Phase 7: Tests and Release Gates
+Add integration tests for full continuity path M4->M5->M8->M9->M10.
+Add regression tests for “wrong history picked” and “diagnosis loses contractId”.
+Add API tests for download ownership and safe path rules.
+Keep existing npm test, npm run lint, npm run build as mandatory gate.
+Files: lib tests root, component tests root.
+Acceptance Criteria
+
+No forced reupload from M5 to M8 when proposal PDF exists.
+Legal cases created via diagnosis stay linked to selected contract.
+M5 never uses unrelated M4 history for extraction.
+M10 shows live, fresh dossier state and file-level evidence traceability.
+Users can securely download proposal/contract evidence from module context.
+End-to-end continuity test passes for M4->M10.
+Execution Order (Critical Path)
+
+Phase 1
+Phase 2
+Phase 4
+Phase 5
+Phase 3
+Phase 6
+Phase 7
+Estimated Delivery
+
+Phase 1-2: 2-3 days
+Phase 3-5: 2-3 days
+Phase 6-7: 1-2 days
+Total: ~1 week of focused implementation
+If you want, I can start immediately with Phase 1 and push the exact code changes in that order.
+
+Progress Update
+
+Date: 2026-04-09
+Phase 1 Status: Completed
+
+Completed in Phase 1
+
+- M5 extraction continuity guard: removed unrelated M4 history fallback when proposal has no linked `sourceLicitationId`.
+- M5 detail continuity guard: history context now loads only when tied to the same linked `sourceLicitationId`.
+- M9 diagnosis continuity: diagnosis start now validates and persists `contractId` in diagnosis context.
+- M9 diagnosis finalization continuity: legal case auto-created from diagnosis now reuses persisted `contractId` (with ownership validation).
+- M9 contract selector source: selector options now come from actual M8 contracts instead of contract IDs inferred from existing legal cases.
+
+Validation Run
+
+- `npm test`: passed (22 files, 61 tests).
+- `npm run lint`: passed with existing warnings in `pdfExtractor.js` (no errors).
+- `npm run build`: passed (Next.js production build succeeded).
+
+Next Planned Step
+
+- Phase 2: M5 -> M8 document reuse (no reupload).
+
+Progress Update
+
+Date: 2026-04-09
+Phase 2 Status: Completed
+
+Completed in Phase 2
+
+- M8 autocreate continuity: when opening M8 from M5 (`autocreate=1`), the flow now auto-links the latest proposal PDF into `ContractDocument` (deduplicated).
+- M8 extraction endpoint continuity: `/api/contracts/extract` now accepts `sourceProposalId` without mandatory file upload.
+- M8 extraction source handling: route can analyze either uploaded PDF or proposal PDF; it preserves `sourceProposalId` on contract create/update.
+- M8 proposal PDF reuse UI: added explicit action in upload tab to "Usar PDF de propuesta de M5" with proposal selector and timestamped file labels.
+- Shared continuity utilities:
+  - Safe proposal document read helper in proposal storage.
+  - Proposal->contract continuity helper for latest PDF lookup and deduplicated linking.
+
+Validation Run (Phase 2)
+
+- `npm test`: passed (22 files, 61 tests).
+- `npm run build`: passed (Next.js production build succeeded).
+- `npm run lint`: passed with existing warnings in `pdfExtractor.js` (no errors).
+
+Next Planned Step
+
+- Phase 4: M10 live dossier + file-level traceability (per critical path order).
+
+Progress Update
+
+Date: 2026-04-14
+Phase 4 Status: Completed
+
+Completed in Phase 4
+
+- Dossier load strategy is now explicit in M10:
+  - API and UI support `live` (default) and `snapshot` (optional) loading.
+  - M10 now shows requested strategy vs actual source used.
+- Freshness metadata added and surfaced:
+  - `generatedAt`, `isStale`, `source`, `snapshotId`, `staleAfterMinutes`.
+  - Snapshot generation returns synchronized freshness metadata.
+- Dossier payload upgraded from aggregate-only counts to file-level traceability:
+  - M5 proposals now include `documentEntries` with links and trace labels.
+  - M8 contracts now include `documentEntries` with links, kind, and lineage to source proposal when available.
+  - M9 legal cases now include `documentEntries` with links and trace labels to legal context/contract continuity.
+- M10 UI drill-down completed:
+  - Separate sections for proposals/contracts/legal with per-record links.
+  - Per-file expandable trace blocks showing mime, size/date, trace reason, and actionable links.
+
+Validation Run (Phase 4)
+
+- `npm test`: passed (23 files, 67 tests).
+- `npm run lint`: passed with existing warnings in `pdfExtractor.js` (no errors).
+- `npm run build`: passed (Next.js production build succeeded).
+
+Next Planned Step
+
+- Phase 5: secure download endpoints for proposal and contract evidence.
+
+Progress Update
+
+Date: 2026-04-14
+Phase 5 Status: Completed
+
+Completed in Phase 5
+
+- Added secure proposal evidence download endpoint:
+  - `GET /api/proposals/[id]/documents/[documentId]`.
+  - Enforces ownership (`proposalId` + `documentId` + `userId`) before file access.
+  - Uses safe storage path guard and bounded file read helper.
+  - Returns attachment headers with safe filename handling.
+- Added secure contract evidence download endpoint:
+  - `GET /api/contracts/[id]/documents/[documentId]`.
+  - Enforces ownership via contract relation (`contract.userId`).
+  - Uses new safe contract document read helper with path traversal protection.
+  - Returns attachment headers with safe filename handling.
+- Added safe contract storage read helper:
+  - `readStoredContractDocumentFile(...)` with canonical path validation and size guard.
+- M10 file-level traceability now exposes direct secure download links for proposal and contract evidence from dossier context.
+
+Validation Run (Phase 5)
+
+- `npm test`: passed (23 files, 67 tests).
+- `npm run lint`: passed with existing warnings in `pdfExtractor.js` (no errors).
+- `npm run build`: passed (Next.js production build succeeded).
+
+Next Planned Step
+
+- Phase 3: complete contract document UX (wire upload UI, show docs in M8 cards, add delete endpoint/actions).
+
+Progress Update
+
+Date: 2026-04-14
+Phase 3 Status: Completed
+
+Completed in Phase 3
+
+- M8 upload UX now wires existing `/api/contracts/upload`:
+  - Added explicit "Adjuntar documento al contrato (sin IA)" flow in M8 upload tab.
+  - Supports selecting contract target, document kind, and PDF file.
+- Contract document cards in M8 now include document list and actions:
+  - File name, kind, size, and timestamp shown per document.
+  - Direct download action per file.
+  - Delete action per file.
+- Added contract document delete endpoint:
+  - `DELETE /api/contracts/[id]/documents/[documentId]`.
+  - Enforces ownership via `contract.userId`.
+  - Removes both storage file and DB row with safe path handling.
+
+Validation Run (Phase 3)
+
+- `npm test`: passed (23 files, 67 tests).
+- `npm run lint`: passed with existing warnings in `pdfExtractor.js` (no errors).
+- `npm run build`: passed (Next.js production build succeeded).
+
+Next Planned Step
+
+- Phase 6: continuity safeguards and observability.
+
+Progress Update
+
+Date: 2026-04-15
+Phase 6 Status: Completed
+
+Completed in Phase 6
+
+- Added structured continuity handoff logs across critical APIs:
+  - `m4_to_m5_*` events in `/api/proposals/[id]/workflow/extract`.
+  - `m5_to_m8_*` events in `/api/contracts/extract`.
+  - `m8_to_m9_*` events in `/api/legal/diagnosis/start`.
+  - `m9_*` continuity events in `/api/legal/diagnosis/answer`.
+- Added page-level observability for M5->M8 autocreate in `/gestion-contratos`:
+  - Logs for autocreate request, proposal resolution, contract target resolution, proposal PDF lookup, and link outcomes.
+- Added continuity safeguards and operator-facing warnings in UI:
+  - M4 (`normative-analysis-view`): warning when no linked source context.
+  - M5 (`proposal-workflow-view`): warning when no M4 context for extraction.
+  - M8 (`contracts-management-view`): warnings for missing proposal PDFs and contracts without `sourceProposalId`.
+  - M10 (`preventive-dossier-view`): warnings derived from incomplete dossier component evidence.
+- Added explicit traceability badges (`Por que este archivo`) where file/source selection affects continuity in M4, M5, M8, and M10.
+
+Validation Note (Phase 6)
+
+- Continuity observability changes were carried into Phase 7 release-gate validation and passed together with final gates.
+
+Next Planned Step
+
+- Phase 7: tests and release gates.
+
+Progress Update
+
+Date: 2026-04-15
+Phase 7 Status: Completed
+
+Completed in Phase 7
+
+- Added integration continuity test for M4->M5->M8->M9->M10 dossier lineage:
+  - `src/lib/audits/__tests__/dossier-continuity.integration.test.ts`.
+  - Verifies proposal->contract->legal continuity links and evidence trace payload in M10.
+- Added regression test for "wrong history picked" continuity break:
+  - `src/app/api/proposals/[id]/workflow/extract/route.test.ts`.
+  - Verifies extraction is blocked when no linked M4 source and no uploaded PDF.
+- Added regression test for "diagnosis loses contractId":
+  - `src/app/api/legal/diagnosis/answer/route.test.ts`.
+  - Verifies finalization preserves persisted `contractId` and links the auto-created legal case to that contract.
+- Added API security tests for download ownership/path safety:
+  - `src/app/api/proposals/[id]/documents/[documentId]/route.test.ts`.
+  - `src/app/api/contracts/[id]/documents/[documentId]/route.test.ts`.
+  - Verifies 404 on non-owned/missing document and 400 on invalid storage path.
+- Fixed JSX parsing safety in M8 continuity messaging (`M5->M8`) to keep lint/build green.
+
+Validation Run (Phase 7)
+
+- `npm test`: passed (28 files, 74 tests).
+- `npm run lint`: passed with existing warnings in `pdfExtractor.js` (no errors).
+- `npm run build`: passed (Next.js production build succeeded).
+
+Next Planned Step
+
+- Planned implementation phases (1-7) are complete. Ready for QA/UAT and deployment checklist.
diff --git a/README.md b/README.md
index 070081d..d950b6a 100644
--- a/README.md
+++ b/README.md
@@ -66,6 +66,66 @@ OPENAI_ACTA_TIMEOUT_MS=60000
 OPENAI_ACTA_MAX_CHARS=45000
 ```
 
+## AI Assist Modules (M1/M2/M3/M7/M10)
+
+The platform now includes assist-only AI helpers for:
+
+- `M1` Diagnostic suggestions per question (apply/dismiss).
+- `M2` Strategic insights and suggested field values (explicit apply only).
+- `M3` AI fit + blended score layered on deterministic recommendations.
+- `M7` Compliance playbook recommendations (no auto state/severity updates).
+- `M10` Auditor-style findings simulation from dossier + simulation data.
+
+Deterministic scoring and compliance engines remain the source of truth.
+
+Environment variables:
+
+```bash
+OPENAI_SMART_MODEL=gpt-4.1
+OPENAI_SMART_FALLBACK_MODEL=gpt-4.1-mini
+OPENAI_SMART_TIMEOUT_MS=75000
+OPENAI_SMART_MAX_CHARS=55000
+
+# Optional module overrides
+OPENAI_M1_MODEL=gpt-4.1
+OPENAI_M2_MODEL=gpt-4.1
+OPENAI_M3_MODEL=gpt-4.1
+OPENAI_M7_MODEL=gpt-4.1
+OPENAI_M10_MODEL=gpt-4.1
+```
+
+Traceability:
+
+- AI suggestions are persisted in `AiSuggestion` with request/response metadata.
+- Use `POST /api/ai/suggestions/{id}/decision` with `{ "decision": "accept" | "dismiss" }` to persist user action.
+
+## Mercado Pago Checkout (Planes M2-M10)
+
+Se agrego integracion de checkout para vender planes:
+
+- `Plan 1` -> Modulos `2-4`
+- `Plan 2` -> Modulos `5-7`
+- `Plan 3` -> Modulos `8-10`
+
+Variables requeridas:
+
+```bash
+MP_ACCESS_TOKEN=TEST-... # token de prueba o produccion
+MP_API_BASE_URL=https://api.mercadopago.com
+MP_PLAN_DURATION_DAYS=30
+```
+
+Flujo:
+
+- `GET /api/payments/checkout?plan=plan-1|plan-2|plan-3` crea preferencia y redirige a Mercado Pago.
+- `GET /api/payments/checkout/return` procesa callback y regresa a `/dashboard`.
+- `POST /api/payments/mercadopago/webhook` sincroniza pagos aprobados.
+
+DB:
+
+- Nuevos modelos Prisma: `ModulePlanPurchase`, `ModulePlanSubscription`.
+- Ejecuta migraciones antes de usar el checkout en un entorno nuevo.
+
 ## Local CLI Script (PDF -> OCR/text -> AI)
 
 Run:
@@ -87,9 +147,17 @@ Add these vars to `.env`:
 ```bash
 LICITAYA_API_KEY=your-licitaya-api-key
 LICITAYA_BASE_URL=https://<licitaya-base-url>
-LICITAYA_TEST_ENDPOINT=/tender/search?items=10&page=1
+LICITAYA_TEST_ENDPOINT=/tender/SCRZJ
 LICITAYA_ACCEPT=application/json
 LICITAYA_TIMEOUT_MS=20000
+LICITAYA_ALLOW_EMPTY_SEARCH=true
+LICITAYA_ENABLED=true
+LICITAYA_ITEMS_PER_PAGE=50
+LICITAYA_MAX_PAGES_PER_RUN=3
+LICITAYA_SYNC_INTERVAL_HOURS=12
+LICITAYA_DATE_OFFSET_DAYS=1
+LICITAYA_DATE_FALLBACK_WINDOW_DAYS=3
+LICITAYA_FALLBACK_TENDER_IDS=SCRZJ
 ```
 
 Run the connection test:
@@ -132,4 +200,29 @@ Notes:
 
 - The script sends your key in header `X-API-KEY`.
 - It prints status code + response preview.
-- A non-2xx response exits with code `1` (useful for CI checks).
+- For `/tender/search`, you can allow an empty 404 as connectivity success with `LICITAYA_ALLOW_EMPTY_SEARCH=true` or `--allow-empty-search`.
+- A non-2xx response exits with code `1` unless empty-search mode is allowed.
+
+## Compliance Cron + Persistence (M7)
+
+This project now persists official-regulations verification state and suggestions in Postgres.
+
+Apply migration and regenerate Prisma client:
+
+```bash
+npm run prisma:migrate
+npm run prisma:generate
+```
+
+Scheduler endpoints:
+
+- `GET/POST /api/cron/licitations-sync` (includes periodic regulations verification by default)
+- `GET/POST /api/cron/regulations-verify` (regulations-only run)
+
+Accepted auth for cron routes:
+
+- Header `x-sync-token: $LICITATIONS_SYNC_TOKEN`
+- Header `Authorization: Bearer $CRON_SECRET` (Vercel cron compatible)
+- Query param `?token=$LICITATIONS_SYNC_TOKEN` (fallback)
+
+Vercel schedules are included in [`vercel.json`](./vercel.json).
diff --git a/ai_integration.md b/ai_integration.md
new file mode 100644
index 0000000..781ba20
--- /dev/null
+++ b/ai_integration.md
@@ -0,0 +1,106 @@
+# AI Integration Plan for Modules 1, 2, 3, 7, and 10
+
+## Summary
+- Goal: add AI assistance to M1, M2, M3, M7, and M10 while keeping deterministic scoring/compliance logic as the source of truth.
+- Product mode selected: **Assist-only** (AI suggests; user explicitly accepts/applies).
+- Model strategy selected: **Higher quality** (primary `gpt-4.1`, fallback `gpt-4.1-mini`).
+- Persistence selected: **Structured traceability** (store request/response metadata, model, usage, warnings, and accept/dismiss events).
+
+## Core Architecture Changes
+- Add a shared AI service layer used by all 5 modules:
+  - `callOpenAiJsonSchema()` and `callOpenAiJsonObjectFallback()`.
+  - shared timeout/retry handling, prompt versioning, truncation guard, and safe JSON parsing.
+  - standardized output envelope: `engine`, `model`, `usage`, `warnings`, `confidence`.
+- Add a shared persistence model for AI traces:
+  - New Prisma model `AiSuggestion` (or equivalent name), fields:
+    - `id`, `userId`, `moduleKey`, `featureKey`, `subjectType`, `subjectId`.
+    - `inputHash`, `requestJson`, `responseJson`, `confidence`.
+    - `engine`, `model`, `usageJson`, `warningsJson`, `promptVersion`.
+    - `status` (`GENERATED | ACCEPTED | DISMISSED | EXPIRED`), `actedAt`, `createdAt`, `updatedAt`.
+  - Purpose:
+    - deduplicate repeated requests by `inputHash`.
+    - preserve auditability and user decisions.
+- Add shared decision endpoint:
+  - `POST /api/ai/suggestions/{id}/decision` with `{ decision: "accept" | "dismiss" }`.
+- Keep deterministic engines untouched and authoritative:
+  - M1 scoring, M2 scoring, M3 deterministic match score, M7 rule alerts, M10 scoring remain unchanged.
+
+## Public API and Type Additions
+- `POST /api/diagnostic/ai/suggestions` (M1):
+  - Input: `moduleKey`, optional `questionId`.
+  - Output: list of suggestions with `questionId`, `suggestedAnswerOptionId`, `rationale`, `missingEvidence`, `confidence`, `suggestionId`.
+- `POST /api/strategic-diagnostic/ai/insights` (M2):
+  - Input: current strategic form snapshot + evidence metadata.
+  - Output: `sectionGaps`, `priorityActions`, `suggestedEvidence`, `suggestedFieldValues`, `confidence`, `suggestionId`.
+- `GET /api/licitations/ai/recommendations` (M3):
+  - Input: optional query (`top`, `profileId`), based on deterministic pre-ranked items.
+  - Output: deterministic score + AI score + blended score + `aiReasons`, `aiRisks`, `nextStep`, `suggestionId`.
+- `POST /api/compliance/m7/ai/playbook` (M7):
+  - Input: current M7 dataset.
+  - Output: `predictedIncidents`, `priorityOrder`, `preventiveActions`, `escalationAdvice`, `confidence`, `suggestionId`.
+- `POST /api/audits/ai/findings` (M10):
+  - Input: selected simulation + current institutional dossier.
+  - Output: `auditorLikelyFindings`, `missingEvidence`, `topRisks`, `remediationPlan`, `confidence`, `suggestionId`.
+- Type updates:
+  - Extend view types to include optional AI sections per module (`aiSuggestion`, `aiInsights`, `aiFit`, `aiPlaybook`, `aiFindings`) with strict nullable typing.
+  - Add common `AiUsage`, `AiWarning`, `AiSuggestionStatus`, `AiDecision`.
+
+## Module-by-Module Behavior
+- M1:
+  - AI infers likely answers for unanswered questions based on answered responses and evidence notes.
+  - UI per question: “Sugerencia IA” card with `Apply` and `Dismiss`.
+  - Applying uses existing response save route so scoring pipeline is unchanged.
+- M2:
+  - AI analyzes strategic data + evidence counts to propose prioritized actions and missing evidence by section.
+  - UI in each section + results tab: “Plan sugerido por IA”.
+  - Suggested field values are shown as explicit apply actions, never auto-written.
+- M3:
+  - Keep deterministic scoring as base.
+  - AI re-ranks only top deterministic candidates to control latency/cost.
+  - UI shows three values: deterministic score, AI fit, blended score; reasons become semantic and more specific.
+- M7:
+  - AI creates a prioritized compliance playbook from existing alerts/deadlines/checklist.
+  - UI adds “Plan IA” tab with incident predictions + actions with owner suggestion and target date.
+  - No severity/status changes are auto-applied.
+- M10:
+  - AI simulates auditor perspective using latest simulation and dossier.
+  - UI adds “Dictamen IA” with likely findings, missing evidence, and remediation order.
+  - Deterministic section scores remain unchanged and visible alongside AI narrative.
+
+## Test Plan
+- Unit tests:
+  - AI parser/normalizer for each module schema.
+  - prompt truncation + fallback behavior.
+  - suggestion persistence lifecycle (`GENERATED -> ACCEPTED/DISMISSED`).
+- Route tests:
+  - auth, validation, malformed JSON handling.
+  - OpenAI failure paths return structured fallback/empty-assist safely.
+- Integration tests:
+  - M1 apply suggestion updates response but does not break scoring calculations.
+  - M2/M3/M7/M10 AI outputs render without changing deterministic KPIs/scores unless user explicitly applies where applicable.
+- Regression tests:
+  - existing deterministic test suites for M1/M2/M3/M7/M10 continue passing unchanged.
+- Acceptance scenarios:
+  - each module can produce at least one AI suggestion with trace metadata.
+  - user can accept/dismiss and decision is persisted.
+  - pages remain functional when AI is unavailable.
+
+## Environment and Rollout Defaults
+- New env vars:
+  - `OPENAI_SMART_MODEL=gpt-4.1`
+  - `OPENAI_SMART_FALLBACK_MODEL=gpt-4.1-mini`
+  - `OPENAI_SMART_TIMEOUT_MS=75000`
+  - `OPENAI_SMART_MAX_CHARS=55000`
+  - optional per-module overrides (`OPENAI_M1_MODEL`, `OPENAI_M2_MODEL`, etc.).
+- Rollout:
+  - Phase 1: backend + trace model + M3 and M10 (highest visible value).
+  - Phase 2: M1 and M2 assist flows.
+  - Phase 3: M7 predictive playbook tuning.
+- Documentation updates:
+  - add a new section in README for “AI Assist Modules (M1/M2/M3/M7/M10)” and env variables.
+
+## Assumptions
+- Current auth gating behavior remains unchanged in this scope.
+- AI output language is Spanish for end-user text.
+- No auto-application beyond explicit user action.
+- Existing AI-enabled modules (M4/M5/M6/M8/M9) are not refactored in this effort.
diff --git a/docs/ui-parity-checklist.md b/docs/ui-parity-checklist.md
new file mode 100644
index 0000000..254a565
--- /dev/null
+++ b/docs/ui-parity-checklist.md
@@ -0,0 +1,32 @@
+# UI Parity Checklist (Modules 3-5)
+
+## Baseline
+- Font stack: `Manrope` (body), `Playfair Display` (display headings).
+- Primary colors: navy action buttons, slate neutrals, green success accents.
+- Card radius and border hierarchy aligned to reference module screenshots.
+
+## Module 3
+- Hero title/subtitle and sync CTA placement.
+- Guide panel + KPI cards + "ultimo analisis" row.
+- Search/filter bars with geo filters.
+- Opportunity cards (badges, compatibility %, progress line, details toggle).
+- Bottom handoff CTA to Module 4.
+
+## Module 4
+- Hero title/subtitle.
+- Left column: guide + drag/drop upload + metadata fields.
+- Right column: empty-state and selected-analysis state.
+- Bottom navigation block to Module 3 / Module 5 / Dashboard.
+
+## Module 5
+- Hero title/subtitle.
+- Search + "Nueva Propuesta" controls.
+- Empty state with primary CTA.
+- Populated cards with edit fields, status, drag/drop docs, document list.
+- Forward nav to M6 placeholder.
+
+## Topbar
+- Authenticated module pages use minimal module-flow header.
+- Back link visible in module mode.
+- Optional Manual, plan badge, and concise actions only.
+- No dense authenticated global nav links.
diff --git a/final_implementation.md b/final_implementation.md
new file mode 100644
index 0000000..d4e8a50
--- /dev/null
+++ b/final_implementation.md
@@ -0,0 +1,463 @@
+# Final Implementation Plan - Modulos 8, 9 y 10
+
+## 1. Objetivo
+Implementar M08, M09 y M10 como una cadena operativa completa:
+
+- M08 Gestion Estrategica de Contratos: registro de contratos, entregables, pagos y carga inteligente de PDF.
+- M09 Proteccion Legal: diagnostico guiado, gestion de casos, ruta de escalada, generador de escritos y directorio.
+- M10 Expediente Preventivo: simulador de auditoria y expediente institucional centralizado.
+
+El alcance sigue exactamente la UX mostrada en las referencias y se integra con M5 y M7 ya existentes.
+
+## 2. Principios de implementacion
+- Reusar patrones actuales: App Router, Prisma, componentes estilo M7, endpoints administrativos autenticados.
+- Mantener trazabilidad completa: cada caso legal y cada auditoria debe poder rastrear contrato, entregable, pago y evidencia origen.
+- Diseñar para escalamiento nacional: iniciar con seed federal + NL y permitir extender por estado/municipio.
+- Regla conservadora legal: donde no haya certeza normativa, marcar "requiere validacion legal".
+
+## 3. M08 - Gestion Estrategica de Contratos
+
+### 3.1 Ruta y UI
+- Nueva ruta: `/gestion-contratos`.
+- Header de flujo:
+  - back: `M7: Alertas`
+  - next: `M9: Legal`
+- KPIs:
+  - Contratos activos
+  - Total cobrado
+  - Entregables pendientes
+  - Entregables vencidos
+- Tabs:
+  - Subir Contrato
+  - Contratos
+  - Entregables
+  - Pagos
+
+### 3.2 Dominio y modelo de datos
+Agregar en Prisma:
+
+- `ContractRecord`
+  - `id, userId, sourceProposalId?`
+  - `title, counterpartyEntity, contractNumber, contractType`
+  - `startDate, endDate, totalAmount, currency`
+  - `status` (`ACTIVE|COMPLETED|PAUSED|CANCELLED`)
+  - `description, createdAt, updatedAt`
+- `ContractDeliverable`
+  - `id, contractId, title, dueDate, amountLinked?`
+  - `status` (`PENDING|DELIVERED|APPROVED|REJECTED|OVERDUE`)
+  - `deliveredAt?, approvedAt?, notes`
+- `ContractPayment`
+  - `id, contractId, amount, paymentDate, invoiceNumber?, concept`
+  - `status` (`REGISTERED|CONFIRMED|DISPUTED`)
+- `ContractDocument`
+  - `id, contractId, fileName, filePath, mimeType, sizeBytes, checksumSha256`
+  - `kind` (`SIGNED_CONTRACT|ADDENDUM|DELIVERABLE_EVIDENCE|PAYMENT_EVIDENCE|OTHER`)
+- `ContractExtractionHistory`
+  - `id, contractId?, userId, engine, model, resultJson, warningsJson, analyzedAt`
+
+Indices:
+- `ContractRecord(userId,status,endDate)`
+- `ContractDeliverable(contractId,status,dueDate)`
+- `ContractPayment(contractId,paymentDate)`
+
+### 3.3 APIs
+- `GET /api/contracts` list + filtros.
+- `POST /api/contracts` crear contrato manual (modal Nuevo Contrato).
+- `PATCH /api/contracts/:id` editar estado y datos clave.
+- `POST /api/contracts/upload` subir PDF firmado.
+- `POST /api/contracts/extract` OCR + IA y crear/actualizar contrato.
+- `GET /api/contracts/kpis` dataset de M08.
+- `POST /api/contracts/:id/deliverables` crear entregable (modal).
+- `PATCH /api/deliverables/:id` cambiar estado.
+- `POST /api/contracts/:id/payments` registrar pago (modal).
+- `GET /api/contracts/:id/payments` historial.
+
+### 3.4 IA para "Subir Contrato"
+Reusar pipeline de PDF existente:
+- `analyzePdf` para texto/OCR.
+- Nuevo extractor IA `extractContractWithAi`:
+  - campos: titulo, entidad contratante, numero, tipo, fechas, monto total.
+  - lista de entregables detectados.
+  - hitos de pago detectados.
+  - clausulas de riesgo contractual (para alimentar M9).
+- Guardar trazabilidad en `ContractExtractionHistory`.
+
+### 3.5 Reglas funcionales
+- Contrato activo: `status=ACTIVE` y fecha fin no vencida (o sin fecha fin).
+- Entregable vencido: `status=PENDING` y `dueDate < now`.
+- Total cobrado: sumatoria pagos confirmados.
+- Barra de avance por contrato: `entregables completados / entregables totales`.
+
+## 4. M09 - Proteccion Legal
+
+### 4.1 Ruta y UI
+- Nueva ruta: `/proteccion-legal`.
+- Header de flujo:
+  - back: `M8: Contratos`
+  - next: `M10: Auditorias`
+- KPIs:
+  - Casos abiertos
+  - Alta severidad
+  - Monto en riesgo
+  - Casos resueltos
+- Tabs:
+  - Diagnostico
+  - Casos
+  - Escalada
+  - Escritos
+  - Directorio
+
+### 4.2 Dominio y modelo de datos
+Agregar en Prisma:
+
+- `LegalCase`
+  - `id, userId, contractId?`
+  - `caseType` (`CONTRACT_BREACH|PAYMENT_RETENTION|UNJUST_SANCTION|CONTRACT_DISPUTE`)
+  - `severity` (`LOW|MEDIUM|HIGH`)
+  - `counterparty, description`
+  - `amountAtRisk`
+  - `status` (`OPEN|IN_PROGRESS|ESCALATED|RESOLVED|CLOSED`)
+  - `openedAt, resolvedAt?`
+- `LegalDiagnosis`
+  - `id, userId, legalCaseId?`
+  - `stepIndex, totalSteps, answersJson, recommendedRouteJson`
+- `LegalEscalationStepLog`
+  - `id, legalCaseId, routeStepKey, completedAt?, notes`
+- `LegalDocument`
+  - `id, legalCaseId?, userId, templateKey?, aiGenerated`
+  - `title, content, createdAt`
+- `LegalDirectoryEntity`
+  - `id, jurisdictionLevel, name, scopeTagsJson`
+  - `websiteUrl?, phone?, email?, stateCode?, municipalityCode?`
+  - `isActive`
+
+### 4.3 APIs
+- `GET /api/legal/kpis`
+- `POST /api/legal/diagnosis/start`
+- `POST /api/legal/diagnosis/answer`
+- `POST /api/legal/cases`
+- `GET /api/legal/cases`
+- `PATCH /api/legal/cases/:id` (resolver/escalar)
+- `GET /api/legal/escalation/:caseId`
+- `POST /api/legal/documents/generate` (IA)
+- `GET /api/legal/templates`
+- `GET /api/legal/directory`
+
+### 4.4 Motor de diagnostico
+Wizard de 4 pasos como referencia:
+1. Tipo de incumplimiento.
+2. Estado procesal y evidencia disponible.
+3. Impacto economico y urgencia.
+4. Objetivo legal (pago, correccion, impugnacion, mediacion).
+
+Salida:
+- severidad sugerida
+- tipo de caso sugerido
+- ruta escalada sugerida
+- lista de escritos recomendados
+
+### 4.5 Ruta Escalada (tab Escalada)
+Catalogo base de pasos:
+1. Requerimiento formal
+2. Conciliacion administrativa
+3. Queja ante OIC
+4. Inconformidad ante SFP/Organo estatal
+5. Via jurisdiccional
+
+Cada paso incluye:
+- ventana estimada de tiempo
+- checklist de acciones
+- bandera de "requiere abogado"
+- dependencias del paso previo
+
+### 4.6 Escritos (IA + plantillas)
+- Selector de tipo de caso y severidad.
+- Inputs: contraparte, empresa, monto, descripcion.
+- Generador IA produce borrador estructurado y editable.
+- Plantillas predefinidas por categoria (como en referencia):
+  - General: Acta entrega-recepcion.
+  - Incumplimiento: Carta de inconformidad.
+  - Retencion de pagos: Solicitud de liberacion.
+  - Sanciones: Recurso de inconformidad.
+- Guardar documento y boton copiar/exportar.
+
+### 4.7 Directorio
+Seed inicial federal + estatal:
+- SFP, TFJA, ASF, OIC, CompraNet, sistemas anticorrupcion estatales, etc.
+- Filtros por jurisdiccion y tipo de autoridad.
+
+## 5. M10 - Expediente Preventivo
+
+### 5.1 Ruta y UI
+- Nueva ruta: `/expediente-preventivo`.
+- Header de flujo:
+  - back: `M9: Legal`
+- KPIs:
+  - Auditorias completadas
+  - Ultima calificacion
+  - Contratos registrados (desde M08)
+  - PDFs resguardados (M08 + M5)
+- Tabs:
+  - Simulador
+  - Expediente
+
+### 5.2 Dominio y modelo de datos
+Agregar en Prisma:
+
+- `AuditSimulation`
+  - `id, userId, name, auditType`
+  - `status` (`DRAFT|COMPLETED`)
+  - `overallScore, completedAt?`
+- `AuditSimulationSection`
+  - `id, simulationId, key`
+  - `score, status` (`READY|WARNING|CRITICAL`)
+  - `findingsJson, recommendationsJson`
+- `AuditChecklistResponse`
+  - `id, simulationId, questionKey, answer, evidenceRefsJson`
+- `InstitutionalDossierSnapshot`
+  - `id, userId, generatedAt, payloadJson`
+
+Secciones del simulador v1:
+- Cumplimiento fiscal
+- Cumplimiento laboral
+- Documentacion legal
+- Control operativo
+- Transparencia financiera
+
+### 5.3 APIs
+- `POST /api/audits/simulations`
+- `GET /api/audits/simulations`
+- `POST /api/audits/simulations/:id/score`
+- `GET /api/audits/simulations/:id`
+- `GET /api/audits/expediente`
+- `POST /api/audits/expediente/refresh`
+
+### 5.4 Logica del expediente
+Consolidar automaticamente:
+- M5: propuestas, workflow, documentos.
+- M8: contratos, entregables, pagos, contratos PDF.
+- M9: casos, escritos, evidencia de escalada.
+- M7: alertas activas de cumplimiento para semaforo preventivo.
+
+Resultado:
+- vista de historial institucional lista para auditoria.
+- estado por componente (completo/incompleto).
+
+## 6. Integraciones entre modulos
+- M5 -> M8: crear contrato desde propuesta adjudicada.
+- M8 -> M9: boton "abrir caso legal" desde contrato/entregable/pago.
+- M8 -> M10: contratos y PDFs alimentan expediente.
+- M9 -> M10: casos, escritos y escalada alimentan expediente.
+- M7 <-> M8/M9: alertas por entregables vencidos, pagos disputados, casos alta severidad.
+
+## 7. Tipos de dominio (frontend/backend)
+Crear `src/lib/contracts/types.ts`, `src/lib/legal/types.ts`, `src/lib/audits/types.ts` con:
+- snapshots KPI por modulo
+- enums de estado
+- payloads de formularios (modales)
+- DTOs para tabs
+- contratos de IA (input/output) para extractor de contrato y generador de escritos
+
+## 8. Plan de implementacion por fases
+
+### Fase A (base de datos + navegacion)
+- Prisma models, migraciones, seeds.
+- Rutas vacias M08/M09/M10 con header y tabs.
+- Linkear dashboard (Plan 3) a rutas reales.
+
+### Fase B (M08 operativo)
+- CRUD contratos + entregables + pagos.
+- KPIs y tabs funcionales.
+- Upload PDF + extraccion IA + guardado en expediente.
+
+### Fase C (M09 operativo)
+- Diagnostico wizard y creacion de casos.
+- Registro/seguimiento de casos.
+- Escalada guiada con checklist por paso.
+- Generador IA de escritos + plantillas + copiar/exportar.
+- Directorio con seed inicial.
+
+### Fase D (M10 operativo)
+- Simulador de auditoria con scoring por seccion.
+- Expediente centralizado con agregacion M5/M8/M9.
+- KPIs finales y acciones correctivas sugeridas.
+
+### Fase E (hardening)
+- permisos por plan, auditoria de cambios, logs de errores IA.
+- observabilidad de pipelines OCR/IA.
+- refinamiento de UX responsive y accesibilidad.
+
+## 9. Plan de pruebas
+
+### Unit
+- Formulas KPI M08/M09/M10.
+- Reglas de estado (vencido, resuelto, escalado, activo).
+- Scoring del simulador.
+- Seleccion de ruta legal por diagnostico.
+
+### Integration
+- Flujo completo: contrato (M08) -> caso (M09) -> expediente (M10).
+- Extraccion IA de contrato -> creacion de entregables/pagos.
+- Generacion de escrito IA + guardado en caso.
+
+### UI/E2E
+- Paridad visual de tabs y KPI cards con referencias.
+- Modales: Nuevo Contrato, Nuevo Entregable, Registrar Pago.
+- Estados vacios y poblados.
+- Responsive movil/escritorio.
+
+## 10. Criterios de aceptacion
+- M08 permite crear contrato, registrar entregable y pago, y ver KPIs actualizados en tiempo real.
+- M09 permite abrir caso desde diagnostico, escalarlo por pasos, y generar escritos IA reutilizables.
+- M10 muestra simulaciones con score y expediente consolidado de evidencia documental.
+- Navegacion lineal operativa M7 -> M8 -> M9 -> M10.
+- Build, test y lint sin errores bloqueantes.
+
+## 11. Defaults V1
+- Sin firma digital de escritos dentro del sistema (solo generacion y exportacion).
+- Sin integracion externa de tribunales/SFP para envio automatico (solo preparacion guiada).
+- Directorio legal inicial federal + NL, extensible por seed.
+- Clasificacion de riesgo legal conservadora si faltan evidencias.
+
+## 12. Master Checklist de Implementacion
+
+### 12.1 Preparacion
+- [ ] Confirmar alcance funcional final con producto (M08, M09, M10 + integraciones).
+- [ ] Validar naming final de rutas: `/gestion-contratos`, `/proteccion-legal`, `/expediente-preventivo`.
+- [ ] Confirmar permisos por plan (Plan 3) y reglas de acceso admin/pago.
+
+### 12.2 Fase A - Data + Navegacion Base
+- [ ] Crear modelos Prisma M08/M09/M10.
+- [ ] Crear enums Prisma para estados de contratos, casos y auditorias.
+- [ ] Crear migraciones SQL + seeds iniciales (directorio legal, catalogos base).
+- [ ] Ejecutar `npm run prisma:generate`.
+- [ ] Crear paginas base de rutas M08, M09 y M10 con layout y header de flujo.
+- [ ] Conectar dashboard (tarjetas M08/M09/M10) a rutas reales.
+
+### 12.3 Fase B - M08 Operativo
+- [ ] Implementar dominio `contracts` (`types.ts`, validadores, mappers).
+- [ ] Implementar endpoints CRUD de contratos.
+- [ ] Implementar endpoints de entregables y pagos.
+- [ ] Implementar endpoint KPI de M08.
+- [ ] Implementar tab Subir Contrato (upload PDF + persistencia de archivo).
+- [ ] Implementar extraccion IA de contrato y guardado de `ContractExtractionHistory`.
+- [ ] Implementar UI tabs M08 (Subir Contrato, Contratos, Entregables, Pagos).
+- [ ] Implementar modales: Nuevo Contrato, Nuevo Entregable, Registrar Pago.
+- [ ] Implementar reglas de negocio: activo, vencido, total cobrado, progreso.
+
+### 12.4 Fase C - M09 Operativo
+- [ ] Implementar dominio `legal` (`types.ts`, enums, validaciones).
+- [ ] Implementar wizard Diagnostico (4 pasos) y recomendacion de ruta.
+- [ ] Implementar CRUD de casos legales.
+- [ ] Implementar tab Casos con acciones de resolver/escalar.
+- [ ] Implementar tab Escalada (pasos, checklist, estatus por caso).
+- [ ] Implementar generador de escritos IA y persistencia.
+- [ ] Implementar repositorio de plantillas predefinidas y accion copiar/exportar.
+- [ ] Implementar tab Directorio con filtros de jurisdiccion/autoridad.
+
+### 12.5 Fase D - M10 Operativo
+- [ ] Implementar dominio `audits` (`types.ts`, scoring, snapshots).
+- [ ] Implementar CRUD de simulaciones de auditoria.
+- [ ] Implementar motor de scoring por seccion.
+- [ ] Implementar tab Simulador con historial y detalle de resultados.
+- [ ] Implementar agregador de expediente institucional (M5 + M8 + M9 + M7).
+- [ ] Implementar tab Expediente con estados vacios/poblados y trazabilidad.
+- [ ] Implementar KPIs de M10.
+
+### 12.6 Fase E - Hardening
+- [ ] Reglas de autorizacion por plan en rutas y APIs.
+- [ ] Auditoria de cambios (logs funcionales por entidad critica).
+- [ ] Manejo robusto de errores IA/OCR con mensajes accionables.
+- [ ] Validacion de performance en listados y agregadores (paginacion/indices).
+- [ ] Reforzar accesibilidad (labels, focus, teclado, contraste).
+
+## 13. Task Backlog (Orden de Ejecucion)
+
+### 13.1 Arquitectura y Persistencia
+1. [ ] Crear schema Prisma para M08 (contratos, entregables, pagos, documentos, extraccion).
+2. [ ] Crear schema Prisma para M09 (casos, diagnostico, escalada, documentos, directorio).
+3. [ ] Crear schema Prisma para M10 (simulaciones, respuestas, snapshots).
+4. [ ] Agregar indices y constraints de integridad.
+5. [ ] Generar y revisar migraciones.
+6. [ ] Ejecutar seeds base (directorio legal + catalogos).
+
+### 13.2 Backend APIs
+1. [ ] Crear `src/app/api/contracts/*`.
+2. [ ] Crear `src/app/api/legal/*`.
+3. [ ] Crear `src/app/api/audits/*`.
+4. [ ] Implementar servicios en `src/lib/contracts`, `src/lib/legal`, `src/lib/audits`.
+5. [ ] Agregar validaciones de entrada/salida y manejo de errores uniforme.
+
+### 13.3 Frontend M08
+1. [ ] Crear pantalla principal M08 con 4 KPIs y tabs.
+2. [ ] Implementar tab Contratos (cards, progreso, estado).
+3. [ ] Implementar tab Entregables (pendiente/vencido/completado).
+4. [ ] Implementar tab Pagos (registro e historial).
+5. [ ] Implementar tab Subir Contrato + drag/drop + estado de analisis IA.
+6. [ ] Conectar modales a APIs y refresco de dataset.
+
+### 13.4 Frontend M09
+1. [ ] Crear pantalla principal M09 con KPIs y tabs.
+2. [ ] Implementar wizard Diagnostico con barra de progreso.
+3. [ ] Implementar tab Casos con filtros por severidad/estado.
+4. [ ] Implementar tab Escalada con timeline de pasos.
+5. [ ] Implementar tab Escritos (formulario IA + plantillas).
+6. [ ] Implementar tab Directorio (cards de entidades + acciones contacto).
+
+### 13.5 Frontend M10
+1. [ ] Crear pantalla principal M10 con KPIs y tabs.
+2. [ ] Implementar tab Simulador (nueva simulacion, scoring y resultados).
+3. [ ] Implementar tab Expediente (contratos, PDFs, propuestas, casos, escritos).
+4. [ ] Implementar navegacion back/next M9 <-> M10 y Dashboard.
+
+### 13.6 Integraciones Cross-Module
+1. [ ] Habilitar handoff M5 -> M8 para crear contrato desde propuesta adjudicada.
+2. [ ] Habilitar handoff M8 -> M9 para abrir caso legal contextual.
+3. [ ] Habilitar agregacion M8 + M9 en M10.
+4. [ ] Publicar alertas M8/M9 relevantes para M7 (vencimientos y riesgo legal).
+
+## 14. Master Test Plan
+
+### 14.1 Unit Tests
+- [ ] Reglas de calculo KPI M08.
+- [ ] Reglas de calculo KPI M09.
+- [ ] Reglas de calculo KPI M10.
+- [ ] Motor de scoring del simulador.
+- [ ] Clasificacion de severidad y rutas legales.
+- [ ] Normalizacion de extraccion IA de contrato.
+
+### 14.2 Integration Tests
+- [ ] Flujo M5 -> M8 (creacion de contrato desde propuesta).
+- [ ] Flujo M08 completo (contrato -> entregable -> pago -> KPI).
+- [ ] Flujo M8 -> M9 (apertura de caso legal).
+- [ ] Flujo M9 -> M10 (caso/escrito visibles en expediente).
+- [ ] Flujo M7 con alertas de entregables vencidos y casos severos.
+
+### 14.3 UI/E2E
+- [ ] Paridad visual de M08 (tabs, cards, modales, empty/data states).
+- [ ] Paridad visual de M09 (diagnostico, casos, escalada, escritos, directorio).
+- [ ] Paridad visual de M10 (simulador y expediente).
+- [ ] Responsive movil/escritorio en M08/M09/M10.
+- [ ] Accesibilidad basica de formularios y modales.
+
+## 15. Release Gate (Definition of Done)
+
+### 15.1 Calidad Tecnica
+- [ ] Migraciones aplicadas sin errores en entorno objetivo.
+- [ ] Seeds ejecutados y datos base disponibles.
+- [ ] Sin errores TypeScript en build.
+- [ ] Sin errores de lint bloqueantes.
+- [ ] Tests unitarios/integracion/UI en verde.
+
+### 15.2 Verificaciones por Comando (orden recomendado)
+1. [ ] `npm run prisma:generate`
+2. [ ] `npm run prisma:migrate`
+3. [ ] `npm test`
+4. [ ] `npm run lint`
+5. [ ] `npm run build` (FINAL CHECK OBLIGATORIO)
+
+### 15.3 Aprobacion Funcional Final
+- [ ] Demo E2E: M8 -> M9 -> M10 con datos reales de prueba.
+- [ ] Validacion de KPIs contra datos de ejemplo.
+- [ ] Validacion de guardado y recuperacion de evidencia/documentos.
+- [ ] Sign-off final de producto.
diff --git a/prisma/migrations/20260321193000_module5_gestion_licitaciones/migration.sql b/prisma/migrations/20260321193000_module5_gestion_licitaciones/migration.sql
new file mode 100644
index 0000000..2dd0225
--- /dev/null
+++ b/prisma/migrations/20260321193000_module5_gestion_licitaciones/migration.sql
@@ -0,0 +1,58 @@
+-- CreateEnum
+CREATE TYPE "ProposalStatus" AS ENUM ('DRAFT', 'IN_PROGRESS', 'SUBMITTED', 'ARCHIVED');
+
+-- CreateTable
+CREATE TABLE "Proposal" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "sourceLicitationId" TEXT,
+    "title" TEXT NOT NULL,
+    "issuingEntity" TEXT NOT NULL,
+    "summary" TEXT NOT NULL DEFAULT '',
+    "status" "ProposalStatus" NOT NULL DEFAULT 'DRAFT',
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "Proposal_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ProposalDocument" (
+    "id" TEXT NOT NULL,
+    "proposalId" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "fileName" TEXT NOT NULL,
+    "storedFileName" TEXT NOT NULL,
+    "filePath" TEXT NOT NULL,
+    "mimeType" TEXT NOT NULL,
+    "sizeBytes" INTEGER NOT NULL,
+    "checksumSha256" TEXT,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ProposalDocument_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "Proposal_userId_status_idx" ON "Proposal"("userId", "status");
+
+-- CreateIndex
+CREATE INDEX "Proposal_updatedAt_idx" ON "Proposal"("updatedAt");
+
+-- CreateIndex
+CREATE INDEX "Proposal_sourceLicitationId_idx" ON "Proposal"("sourceLicitationId");
+
+-- CreateIndex
+CREATE INDEX "ProposalDocument_proposalId_createdAt_idx" ON "ProposalDocument"("proposalId", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "ProposalDocument_userId_createdAt_idx" ON "ProposalDocument"("userId", "createdAt");
+
+-- AddForeignKey
+ALTER TABLE "Proposal" ADD CONSTRAINT "Proposal_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ProposalDocument" ADD CONSTRAINT "ProposalDocument_proposalId_fkey" FOREIGN KEY ("proposalId") REFERENCES "Proposal"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ProposalDocument" ADD CONSTRAINT "ProposalDocument_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
diff --git a/prisma/migrations/20260323120000_licitaya_source/migration.sql b/prisma/migrations/20260323120000_licitaya_source/migration.sql
new file mode 100644
index 0000000..6037648
--- /dev/null
+++ b/prisma/migrations/20260323120000_licitaya_source/migration.sql
@@ -0,0 +1,2 @@
+-- AlterEnum
+ALTER TYPE "LicitationSource" ADD VALUE IF NOT EXISTS 'LICITAYA';
diff --git a/prisma/migrations/20260327120000_module3_preferences_module4_history/migration.sql b/prisma/migrations/20260327120000_module3_preferences_module4_history/migration.sql
new file mode 100644
index 0000000..8ca4dbc
--- /dev/null
+++ b/prisma/migrations/20260327120000_module3_preferences_module4_history/migration.sql
@@ -0,0 +1,81 @@
+-- CreateEnum
+CREATE TYPE "LicitationReviewStatus" AS ENUM ('NEW', 'REVIEWED', 'INTERESTED', 'DISCARDED');
+
+-- CreateEnum
+CREATE TYPE "NormativeDocumentType" AS ENUM ('BASES_LICITACION', 'CONVOCATORIA', 'REGLAMENTO', 'LEY', 'OTRO');
+
+-- CreateEnum
+CREATE TYPE "NormativeAnalysisMethod" AS ENUM ('DIRECT', 'OCR');
+
+-- CreateEnum
+CREATE TYPE "NormativeConfidence" AS ENUM ('LOW', 'MEDIUM', 'HIGH');
+
+-- CreateEnum
+CREATE TYPE "NormativeRiskLevel" AS ENUM ('ALTO', 'MEDIO', 'BAJO');
+
+-- CreateTable
+CREATE TABLE "LicitationUserPreference" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "licitationId" TEXT NOT NULL,
+    "status" "LicitationReviewStatus" NOT NULL DEFAULT 'NEW',
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "LicitationUserPreference_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "NormativeAnalysisHistory" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "sourceLicitationId" TEXT,
+    "fileName" TEXT NOT NULL,
+    "documentType" "NormativeDocumentType" NOT NULL,
+    "issuingEntity" TEXT,
+    "methodUsed" "NormativeAnalysisMethod" NOT NULL,
+    "numPages" INTEGER NOT NULL,
+    "warnings" JSONB,
+    "extractedChars" INTEGER NOT NULL,
+    "confidence" "NormativeConfidence" NOT NULL,
+    "viabilityScore" INTEGER NOT NULL,
+    "riskLevel" "NormativeRiskLevel" NOT NULL,
+    "executiveSummary" TEXT NOT NULL,
+    "result" JSONB NOT NULL,
+    "analyzedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deletedAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "NormativeAnalysisHistory_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "LicitationUserPreference_userId_licitationId_key" ON "LicitationUserPreference"("userId", "licitationId");
+
+-- CreateIndex
+CREATE INDEX "LicitationUserPreference_userId_status_idx" ON "LicitationUserPreference"("userId", "status");
+
+-- CreateIndex
+CREATE INDEX "LicitationUserPreference_licitationId_status_idx" ON "LicitationUserPreference"("licitationId", "status");
+
+-- CreateIndex
+CREATE INDEX "NormativeAnalysisHistory_userId_analyzedAt_idx" ON "NormativeAnalysisHistory"("userId", "analyzedAt");
+
+-- CreateIndex
+CREATE INDEX "NormativeAnalysisHistory_userId_deletedAt_idx" ON "NormativeAnalysisHistory"("userId", "deletedAt");
+
+-- CreateIndex
+CREATE INDEX "NormativeAnalysisHistory_sourceLicitationId_idx" ON "NormativeAnalysisHistory"("sourceLicitationId");
+
+-- AddForeignKey
+ALTER TABLE "LicitationUserPreference" ADD CONSTRAINT "LicitationUserPreference_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "LicitationUserPreference" ADD CONSTRAINT "LicitationUserPreference_licitationId_fkey" FOREIGN KEY ("licitationId") REFERENCES "Licitation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "NormativeAnalysisHistory" ADD CONSTRAINT "NormativeAnalysisHistory_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "NormativeAnalysisHistory" ADD CONSTRAINT "NormativeAnalysisHistory_sourceLicitationId_fkey" FOREIGN KEY ("sourceLicitationId") REFERENCES "Licitation"("id") ON DELETE SET NULL ON UPDATE CASCADE;
diff --git a/prisma/migrations/20260330130000_module5_workflow_persistence/migration.sql b/prisma/migrations/20260330130000_module5_workflow_persistence/migration.sql
new file mode 100644
index 0000000..2caf9dc
--- /dev/null
+++ b/prisma/migrations/20260330130000_module5_workflow_persistence/migration.sql
@@ -0,0 +1,6 @@
+-- AlterTable
+ALTER TABLE "Proposal"
+ADD COLUMN "workflowDraft" JSONB,
+ADD COLUMN "currentStep" INTEGER NOT NULL DEFAULT 1,
+ADD COLUMN "completionPercent" INTEGER NOT NULL DEFAULT 0,
+ADD COLUMN "readyForSubmissionAt" TIMESTAMP(3);
diff --git a/prisma/migrations/20260406015826_compliance_regulations_persistence/migration.sql b/prisma/migrations/20260406015826_compliance_regulations_persistence/migration.sql
new file mode 100644
index 0000000..56a8866
--- /dev/null
+++ b/prisma/migrations/20260406015826_compliance_regulations_persistence/migration.sql
@@ -0,0 +1,8 @@
+-- RenameIndex (safe guard for environments where the old truncated index never existed)
+DO $$
+BEGIN
+  IF to_regclass('"OfficialNormativeSuggestion_stateCode_municipalityCode_createdA"') IS NOT NULL THEN
+    ALTER INDEX "OfficialNormativeSuggestion_stateCode_municipalityCode_createdA"
+      RENAME TO "OfficialNormativeSuggestion_stateCode_municipalityCode_crea_idx";
+  END IF;
+END $$;
diff --git a/prisma/migrations/20260406183000_compliance_regulations_persistence/migration.sql b/prisma/migrations/20260406183000_compliance_regulations_persistence/migration.sql
new file mode 100644
index 0000000..6b14c83
--- /dev/null
+++ b/prisma/migrations/20260406183000_compliance_regulations_persistence/migration.sql
@@ -0,0 +1,134 @@
+-- CreateEnum
+CREATE TYPE "OfficialNormativeSourceType" AS ENUM ('LEY', 'REGLAMENTO', 'LINEAMIENTO', 'PORTAL');
+
+-- CreateEnum
+CREATE TYPE "NormativeVerificationStatus" AS ENUM ('SUCCESS', 'WARNING', 'FAILED');
+
+-- CreateTable
+CREATE TABLE "OfficialNormativeSource" (
+    "id" TEXT NOT NULL,
+    "stateCode" TEXT NOT NULL,
+    "stateName" TEXT NOT NULL,
+    "municipalityCode" TEXT,
+    "municipalityName" TEXT,
+    "authorityName" TEXT NOT NULL,
+    "title" TEXT NOT NULL,
+    "officialUrl" TEXT NOT NULL,
+    "sourceType" "OfficialNormativeSourceType" NOT NULL,
+    "versionLabel" TEXT,
+    "isPilot" BOOLEAN NOT NULL DEFAULT false,
+    "lastKnownHash" TEXT,
+    "lastVerifiedAt" TIMESTAMP(3),
+    "nextCheckAt" TIMESTAMP(3),
+    "lastStatus" "NormativeVerificationStatus",
+    "lastMessage" TEXT,
+    "lastChangedAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "OfficialNormativeSource_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "OfficialNormativeSuggestion" (
+    "id" TEXT NOT NULL,
+    "stateCode" TEXT NOT NULL,
+    "municipalityCode" TEXT,
+    "authorityName" TEXT NOT NULL,
+    "title" TEXT NOT NULL,
+    "officialUrl" TEXT NOT NULL,
+    "sourceType" "OfficialNormativeSourceType" NOT NULL,
+    "notes" TEXT,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "OfficialNormativeSuggestion_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "OfficialNormativeSource_stateCode_municipalityCode_isPilot_idx" ON "OfficialNormativeSource"("stateCode", "municipalityCode", "isPilot");
+
+-- CreateIndex
+CREATE INDEX "OfficialNormativeSource_nextCheckAt_idx" ON "OfficialNormativeSource"("nextCheckAt");
+
+-- CreateIndex
+CREATE INDEX "OfficialNormativeSource_lastStatus_lastVerifiedAt_idx" ON "OfficialNormativeSource"("lastStatus", "lastVerifiedAt");
+
+-- CreateIndex
+CREATE INDEX "OfficialNormativeSuggestion_stateCode_municipalityCode_createdAt_idx" ON "OfficialNormativeSuggestion"("stateCode", "municipalityCode", "createdAt");
+
+-- Seed pilot sources (Nuevo Leon)
+INSERT INTO "OfficialNormativeSource" (
+  "id",
+  "stateCode",
+  "stateName",
+  "municipalityCode",
+  "municipalityName",
+  "authorityName",
+  "title",
+  "officialUrl",
+  "sourceType",
+  "versionLabel",
+  "isPilot",
+  "createdAt",
+  "updatedAt"
+)
+VALUES
+  (
+    'nl-ley-adquisiciones-estatal',
+    'NL',
+    'Nuevo Leon',
+    NULL,
+    NULL,
+    'Gobierno del Estado de Nuevo Leon',
+    'Ley de Adquisiciones, Arrendamientos y Contratacion de Servicios del Estado de Nuevo Leon',
+    'https://www.hcnl.gob.mx/trabajo_legislativo/leyes/',
+    'LEY',
+    NULL,
+    true,
+    CURRENT_TIMESTAMP,
+    CURRENT_TIMESTAMP
+  ),
+  (
+    'nl-reglamento-adquisiciones-estatal',
+    'NL',
+    'Nuevo Leon',
+    NULL,
+    NULL,
+    'Gobierno del Estado de Nuevo Leon',
+    'Reglamento de la Ley de Adquisiciones del Estado de Nuevo Leon',
+    'https://www.nl.gob.mx/',
+    'REGLAMENTO',
+    NULL,
+    true,
+    CURRENT_TIMESTAMP,
+    CURRENT_TIMESTAMP
+  ),
+  (
+    'spgg-reglamento-adquisiciones',
+    'NL',
+    'Nuevo Leon',
+    'SPGG',
+    'San Pedro Garza Garcia',
+    'Municipio de San Pedro Garza Garcia',
+    'Reglamento de Adquisiciones y Contratacion de Servicios de San Pedro Garza Garcia',
+    'https://www.sanpedro.gob.mx/',
+    'REGLAMENTO',
+    NULL,
+    true,
+    CURRENT_TIMESTAMP,
+    CURRENT_TIMESTAMP
+  )
+ON CONFLICT ("id") DO UPDATE
+SET
+  "stateCode" = EXCLUDED."stateCode",
+  "stateName" = EXCLUDED."stateName",
+  "municipalityCode" = EXCLUDED."municipalityCode",
+  "municipalityName" = EXCLUDED."municipalityName",
+  "authorityName" = EXCLUDED."authorityName",
+  "title" = EXCLUDED."title",
+  "officialUrl" = EXCLUDED."officialUrl",
+  "sourceType" = EXCLUDED."sourceType",
+  "versionLabel" = EXCLUDED."versionLabel",
+  "isPilot" = EXCLUDED."isPilot",
+  "updatedAt" = CURRENT_TIMESTAMP;
diff --git a/prisma/migrations/20260406200000_modules8_9_10/migration.sql b/prisma/migrations/20260406200000_modules8_9_10/migration.sql
new file mode 100644
index 0000000..cd49cd2
--- /dev/null
+++ b/prisma/migrations/20260406200000_modules8_9_10/migration.sql
@@ -0,0 +1,376 @@
+-- CreateEnum
+CREATE TYPE "ContractStatus" AS ENUM ('ACTIVE', 'COMPLETED', 'PAUSED', 'CANCELLED');
+
+-- CreateEnum
+CREATE TYPE "ContractDeliverableStatus" AS ENUM ('PENDING', 'DELIVERED', 'APPROVED', 'REJECTED', 'OVERDUE');
+
+-- CreateEnum
+CREATE TYPE "ContractPaymentStatus" AS ENUM ('REGISTERED', 'CONFIRMED', 'DISPUTED');
+
+-- CreateEnum
+CREATE TYPE "ContractDocumentKind" AS ENUM ('SIGNED_CONTRACT', 'ADDENDUM', 'DELIVERABLE_EVIDENCE', 'PAYMENT_EVIDENCE', 'OTHER');
+
+-- CreateEnum
+CREATE TYPE "LegalCaseType" AS ENUM ('CONTRACT_BREACH', 'PAYMENT_RETENTION', 'UNJUST_SANCTION', 'CONTRACT_DISPUTE');
+
+-- CreateEnum
+CREATE TYPE "LegalCaseSeverity" AS ENUM ('LOW', 'MEDIUM', 'HIGH');
+
+-- CreateEnum
+CREATE TYPE "LegalCaseStatus" AS ENUM ('OPEN', 'IN_PROGRESS', 'ESCALATED', 'RESOLVED', 'CLOSED');
+
+-- CreateEnum
+CREATE TYPE "LegalJurisdictionLevel" AS ENUM ('FEDERAL', 'STATE', 'MUNICIPAL');
+
+-- CreateEnum
+CREATE TYPE "AuditSimulationStatus" AS ENUM ('DRAFT', 'COMPLETED');
+
+-- CreateEnum
+CREATE TYPE "AuditSimulationSectionStatus" AS ENUM ('READY', 'WARNING', 'CRITICAL');
+
+-- CreateTable
+CREATE TABLE "ContractRecord" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "sourceProposalId" TEXT,
+    "title" TEXT NOT NULL,
+    "counterpartyEntity" TEXT NOT NULL,
+    "contractNumber" TEXT,
+    "contractType" TEXT NOT NULL,
+    "startDate" TIMESTAMP(3),
+    "endDate" TIMESTAMP(3),
+    "totalAmount" DECIMAL(14,2),
+    "currency" TEXT NOT NULL DEFAULT 'MXN',
+    "status" "ContractStatus" NOT NULL DEFAULT 'ACTIVE',
+    "description" TEXT NOT NULL DEFAULT '',
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ContractRecord_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ContractDeliverable" (
+    "id" TEXT NOT NULL,
+    "contractId" TEXT NOT NULL,
+    "title" TEXT NOT NULL,
+    "dueDate" TIMESTAMP(3),
+    "amountLinked" DECIMAL(14,2),
+    "status" "ContractDeliverableStatus" NOT NULL DEFAULT 'PENDING',
+    "deliveredAt" TIMESTAMP(3),
+    "approvedAt" TIMESTAMP(3),
+    "notes" TEXT NOT NULL DEFAULT '',
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ContractDeliverable_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ContractPayment" (
+    "id" TEXT NOT NULL,
+    "contractId" TEXT NOT NULL,
+    "amount" DECIMAL(14,2) NOT NULL,
+    "paymentDate" TIMESTAMP(3) NOT NULL,
+    "invoiceNumber" TEXT,
+    "concept" TEXT NOT NULL DEFAULT '',
+    "status" "ContractPaymentStatus" NOT NULL DEFAULT 'REGISTERED',
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ContractPayment_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ContractDocument" (
+    "id" TEXT NOT NULL,
+    "contractId" TEXT NOT NULL,
+    "fileName" TEXT NOT NULL,
+    "filePath" TEXT NOT NULL,
+    "mimeType" TEXT NOT NULL,
+    "sizeBytes" INTEGER NOT NULL,
+    "checksumSha256" TEXT,
+    "kind" "ContractDocumentKind" NOT NULL DEFAULT 'OTHER',
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ContractDocument_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ContractExtractionHistory" (
+    "id" TEXT NOT NULL,
+    "contractId" TEXT,
+    "userId" TEXT NOT NULL,
+    "engine" TEXT NOT NULL,
+    "model" TEXT,
+    "resultJson" JSONB NOT NULL,
+    "warningsJson" JSONB,
+    "analyzedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "ContractExtractionHistory_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "LegalCase" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "contractId" TEXT,
+    "caseType" "LegalCaseType" NOT NULL,
+    "severity" "LegalCaseSeverity" NOT NULL,
+    "counterparty" TEXT NOT NULL,
+    "description" TEXT NOT NULL,
+    "amountAtRisk" DECIMAL(14,2),
+    "status" "LegalCaseStatus" NOT NULL DEFAULT 'OPEN',
+    "openedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "resolvedAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "LegalCase_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "LegalDiagnosis" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "legalCaseId" TEXT,
+    "stepIndex" INTEGER NOT NULL DEFAULT 1,
+    "totalSteps" INTEGER NOT NULL DEFAULT 4,
+    "answersJson" JSONB NOT NULL,
+    "recommendedRouteJson" JSONB NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "LegalDiagnosis_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "LegalEscalationStepLog" (
+    "id" TEXT NOT NULL,
+    "legalCaseId" TEXT NOT NULL,
+    "routeStepKey" TEXT NOT NULL,
+    "completedAt" TIMESTAMP(3),
+    "notes" TEXT NOT NULL DEFAULT '',
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "LegalEscalationStepLog_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "LegalDocument" (
+    "id" TEXT NOT NULL,
+    "legalCaseId" TEXT,
+    "userId" TEXT NOT NULL,
+    "templateKey" TEXT,
+    "aiGenerated" BOOLEAN NOT NULL DEFAULT false,
+    "title" TEXT NOT NULL,
+    "content" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "LegalDocument_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "LegalDirectoryEntity" (
+    "id" TEXT NOT NULL,
+    "jurisdictionLevel" "LegalJurisdictionLevel" NOT NULL,
+    "name" TEXT NOT NULL,
+    "scopeTagsJson" JSONB NOT NULL,
+    "websiteUrl" TEXT,
+    "phone" TEXT,
+    "email" TEXT,
+    "stateCode" TEXT,
+    "municipalityCode" TEXT,
+    "isActive" BOOLEAN NOT NULL DEFAULT true,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "LegalDirectoryEntity_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "AuditSimulation" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "auditType" TEXT NOT NULL,
+    "status" "AuditSimulationStatus" NOT NULL DEFAULT 'DRAFT',
+    "overallScore" INTEGER,
+    "completedAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "AuditSimulation_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "AuditSimulationSection" (
+    "id" TEXT NOT NULL,
+    "simulationId" TEXT NOT NULL,
+    "key" TEXT NOT NULL,
+    "score" INTEGER,
+    "status" "AuditSimulationSectionStatus" NOT NULL DEFAULT 'READY',
+    "findingsJson" JSONB,
+    "recommendationsJson" JSONB,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "AuditSimulationSection_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "AuditChecklistResponse" (
+    "id" TEXT NOT NULL,
+    "simulationId" TEXT NOT NULL,
+    "questionKey" TEXT NOT NULL,
+    "answer" TEXT NOT NULL,
+    "evidenceRefsJson" JSONB,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "AuditChecklistResponse_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "InstitutionalDossierSnapshot" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "generatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "payloadJson" JSONB NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "InstitutionalDossierSnapshot_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "ContractRecord_userId_status_endDate_idx" ON "ContractRecord"("userId", "status", "endDate");
+
+-- CreateIndex
+CREATE INDEX "ContractRecord_sourceProposalId_idx" ON "ContractRecord"("sourceProposalId");
+
+-- CreateIndex
+CREATE INDEX "ContractRecord_updatedAt_idx" ON "ContractRecord"("updatedAt");
+
+-- CreateIndex
+CREATE INDEX "ContractDeliverable_contractId_status_dueDate_idx" ON "ContractDeliverable"("contractId", "status", "dueDate");
+
+-- CreateIndex
+CREATE INDEX "ContractDeliverable_dueDate_idx" ON "ContractDeliverable"("dueDate");
+
+-- CreateIndex
+CREATE INDEX "ContractPayment_contractId_paymentDate_idx" ON "ContractPayment"("contractId", "paymentDate");
+
+-- CreateIndex
+CREATE INDEX "ContractPayment_status_paymentDate_idx" ON "ContractPayment"("status", "paymentDate");
+
+-- CreateIndex
+CREATE INDEX "ContractDocument_contractId_kind_createdAt_idx" ON "ContractDocument"("contractId", "kind", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "ContractExtractionHistory_userId_analyzedAt_idx" ON "ContractExtractionHistory"("userId", "analyzedAt");
+
+-- CreateIndex
+CREATE INDEX "ContractExtractionHistory_contractId_analyzedAt_idx" ON "ContractExtractionHistory"("contractId", "analyzedAt");
+
+-- CreateIndex
+CREATE INDEX "LegalCase_userId_status_severity_idx" ON "LegalCase"("userId", "status", "severity");
+
+-- CreateIndex
+CREATE INDEX "LegalCase_contractId_idx" ON "LegalCase"("contractId");
+
+-- CreateIndex
+CREATE INDEX "LegalDiagnosis_userId_updatedAt_idx" ON "LegalDiagnosis"("userId", "updatedAt");
+
+-- CreateIndex
+CREATE INDEX "LegalDiagnosis_legalCaseId_idx" ON "LegalDiagnosis"("legalCaseId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "LegalEscalationStepLog_legalCaseId_routeStepKey_key" ON "LegalEscalationStepLog"("legalCaseId", "routeStepKey");
+
+-- CreateIndex
+CREATE INDEX "LegalEscalationStepLog_legalCaseId_completedAt_idx" ON "LegalEscalationStepLog"("legalCaseId", "completedAt");
+
+-- CreateIndex
+CREATE INDEX "LegalDocument_userId_createdAt_idx" ON "LegalDocument"("userId", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "LegalDocument_legalCaseId_createdAt_idx" ON "LegalDocument"("legalCaseId", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "LegalDirectoryEntity_jurisdictionLevel_isActive_idx" ON "LegalDirectoryEntity"("jurisdictionLevel", "isActive");
+
+-- CreateIndex
+CREATE INDEX "LegalDirectoryEntity_stateCode_municipalityCode_isActive_idx" ON "LegalDirectoryEntity"("stateCode", "municipalityCode", "isActive");
+
+-- CreateIndex
+CREATE INDEX "AuditSimulation_userId_status_updatedAt_idx" ON "AuditSimulation"("userId", "status", "updatedAt");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "AuditSimulationSection_simulationId_key_key" ON "AuditSimulationSection"("simulationId", "key");
+
+-- CreateIndex
+CREATE INDEX "AuditSimulationSection_status_idx" ON "AuditSimulationSection"("status");
+
+-- CreateIndex
+CREATE INDEX "AuditChecklistResponse_simulationId_questionKey_idx" ON "AuditChecklistResponse"("simulationId", "questionKey");
+
+-- CreateIndex
+CREATE INDEX "InstitutionalDossierSnapshot_userId_generatedAt_idx" ON "InstitutionalDossierSnapshot"("userId", "generatedAt");
+
+-- AddForeignKey
+ALTER TABLE "ContractRecord" ADD CONSTRAINT "ContractRecord_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ContractRecord" ADD CONSTRAINT "ContractRecord_sourceProposalId_fkey" FOREIGN KEY ("sourceProposalId") REFERENCES "Proposal"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ContractDeliverable" ADD CONSTRAINT "ContractDeliverable_contractId_fkey" FOREIGN KEY ("contractId") REFERENCES "ContractRecord"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ContractPayment" ADD CONSTRAINT "ContractPayment_contractId_fkey" FOREIGN KEY ("contractId") REFERENCES "ContractRecord"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ContractDocument" ADD CONSTRAINT "ContractDocument_contractId_fkey" FOREIGN KEY ("contractId") REFERENCES "ContractRecord"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ContractExtractionHistory" ADD CONSTRAINT "ContractExtractionHistory_contractId_fkey" FOREIGN KEY ("contractId") REFERENCES "ContractRecord"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ContractExtractionHistory" ADD CONSTRAINT "ContractExtractionHistory_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "LegalCase" ADD CONSTRAINT "LegalCase_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "LegalCase" ADD CONSTRAINT "LegalCase_contractId_fkey" FOREIGN KEY ("contractId") REFERENCES "ContractRecord"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "LegalDiagnosis" ADD CONSTRAINT "LegalDiagnosis_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "LegalDiagnosis" ADD CONSTRAINT "LegalDiagnosis_legalCaseId_fkey" FOREIGN KEY ("legalCaseId") REFERENCES "LegalCase"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "LegalEscalationStepLog" ADD CONSTRAINT "LegalEscalationStepLog_legalCaseId_fkey" FOREIGN KEY ("legalCaseId") REFERENCES "LegalCase"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "LegalDocument" ADD CONSTRAINT "LegalDocument_legalCaseId_fkey" FOREIGN KEY ("legalCaseId") REFERENCES "LegalCase"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "LegalDocument" ADD CONSTRAINT "LegalDocument_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "AuditSimulation" ADD CONSTRAINT "AuditSimulation_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "AuditSimulationSection" ADD CONSTRAINT "AuditSimulationSection_simulationId_fkey" FOREIGN KEY ("simulationId") REFERENCES "AuditSimulation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "AuditChecklistResponse" ADD CONSTRAINT "AuditChecklistResponse_simulationId_fkey" FOREIGN KEY ("simulationId") REFERENCES "AuditSimulation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "InstitutionalDossierSnapshot" ADD CONSTRAINT "InstitutionalDossierSnapshot_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
diff --git a/prisma/migrations/20260406213000_normative_index_name_normalization/migration.sql b/prisma/migrations/20260406213000_normative_index_name_normalization/migration.sql
new file mode 100644
index 0000000..8730cc9
--- /dev/null
+++ b/prisma/migrations/20260406213000_normative_index_name_normalization/migration.sql
@@ -0,0 +1,9 @@
+-- Normalize index name across environments where Postgres truncated long identifiers.
+DO $$
+BEGIN
+  IF to_regclass('"OfficialNormativeSuggestion_stateCode_municipalityCode_createdA"') IS NOT NULL
+     AND to_regclass('"OfficialNormativeSuggestion_stateCode_municipalityCode_crea_idx"') IS NULL THEN
+    ALTER INDEX "OfficialNormativeSuggestion_stateCode_municipalityCode_createdA"
+      RENAME TO "OfficialNormativeSuggestion_stateCode_municipalityCode_crea_idx";
+  END IF;
+END $$;
diff --git a/prisma/migrations/20260406224500_ai_assist_suggestions/migration.sql b/prisma/migrations/20260406224500_ai_assist_suggestions/migration.sql
new file mode 100644
index 0000000..8229591
--- /dev/null
+++ b/prisma/migrations/20260406224500_ai_assist_suggestions/migration.sql
@@ -0,0 +1,42 @@
+-- CreateEnum
+CREATE TYPE "AiSuggestionStatus" AS ENUM ('GENERATED', 'ACCEPTED', 'DISMISSED', 'EXPIRED');
+
+-- CreateTable
+CREATE TABLE "AiSuggestion" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "moduleKey" TEXT NOT NULL,
+    "featureKey" TEXT NOT NULL,
+    "subjectType" TEXT NOT NULL,
+    "subjectId" TEXT NOT NULL,
+    "inputHash" TEXT NOT NULL,
+    "requestJson" JSONB NOT NULL,
+    "responseJson" JSONB NOT NULL,
+    "confidence" DOUBLE PRECISION,
+    "engine" TEXT NOT NULL,
+    "model" TEXT,
+    "usageJson" JSONB,
+    "warningsJson" JSONB,
+    "promptVersion" TEXT NOT NULL,
+    "status" "AiSuggestionStatus" NOT NULL DEFAULT 'GENERATED',
+    "actedAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "AiSuggestion_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ai_suggestion_dedupe" ON "AiSuggestion"("userId", "moduleKey", "featureKey", "subjectType", "subjectId", "inputHash");
+
+-- CreateIndex
+CREATE INDEX "AiSuggestion_userId_moduleKey_featureKey_createdAt_idx" ON "AiSuggestion"("userId", "moduleKey", "featureKey", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "AiSuggestion_status_updatedAt_idx" ON "AiSuggestion"("status", "updatedAt");
+
+-- CreateIndex
+CREATE INDEX "AiSuggestion_inputHash_idx" ON "AiSuggestion"("inputHash");
+
+-- AddForeignKey
+ALTER TABLE "AiSuggestion" ADD CONSTRAINT "AiSuggestion_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
diff --git a/prisma/migrations/20260428153000_module_plans_mercadopago/migration.sql b/prisma/migrations/20260428153000_module_plans_mercadopago/migration.sql
new file mode 100644
index 0000000..03689cf
--- /dev/null
+++ b/prisma/migrations/20260428153000_module_plans_mercadopago/migration.sql
@@ -0,0 +1,69 @@
+-- CreateEnum
+CREATE TYPE "ModulePlanKey" AS ENUM ('PLAN_2_4', 'PLAN_5_7', 'PLAN_8_10');
+
+-- CreateEnum
+CREATE TYPE "ModulePlanPurchaseStatus" AS ENUM ('PENDING', 'APPROVED', 'REJECTED', 'CANCELLED', 'EXPIRED');
+
+-- CreateTable
+CREATE TABLE "ModulePlanPurchase" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "planKey" "ModulePlanKey" NOT NULL,
+    "status" "ModulePlanPurchaseStatus" NOT NULL DEFAULT 'PENDING',
+    "externalReference" TEXT NOT NULL,
+    "mercadoPreferenceId" TEXT,
+    "mercadoPaymentId" TEXT,
+    "mercadoOrderId" TEXT,
+    "checkoutUrl" TEXT,
+    "amount" DECIMAL(14,2) NOT NULL,
+    "currency" TEXT NOT NULL DEFAULT 'MXN',
+    "requestJson" JSONB,
+    "responseJson" JSONB,
+    "approvedAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ModulePlanPurchase_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ModulePlanSubscription" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "planKey" "ModulePlanKey" NOT NULL,
+    "sourcePurchaseId" TEXT,
+    "isActive" BOOLEAN NOT NULL DEFAULT true,
+    "startsAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "expiresAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ModulePlanSubscription_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ModulePlanPurchase_externalReference_key" ON "ModulePlanPurchase"("externalReference");
+
+-- CreateIndex
+CREATE INDEX "ModulePlanPurchase_userId_planKey_createdAt_idx" ON "ModulePlanPurchase"("userId", "planKey", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "ModulePlanPurchase_status_updatedAt_idx" ON "ModulePlanPurchase"("status", "updatedAt");
+
+-- CreateIndex
+CREATE INDEX "ModulePlanPurchase_mercadoPaymentId_idx" ON "ModulePlanPurchase"("mercadoPaymentId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ModulePlanSubscription_userId_planKey_key" ON "ModulePlanSubscription"("userId", "planKey");
+
+-- CreateIndex
+CREATE INDEX "ModulePlanSubscription_userId_isActive_expiresAt_idx" ON "ModulePlanSubscription"("userId", "isActive", "expiresAt");
+
+-- AddForeignKey
+ALTER TABLE "ModulePlanPurchase" ADD CONSTRAINT "ModulePlanPurchase_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ModulePlanSubscription" ADD CONSTRAINT "ModulePlanSubscription_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ModulePlanSubscription" ADD CONSTRAINT "ModulePlanSubscription_sourcePurchaseId_fkey" FOREIGN KEY ("sourcePurchaseId") REFERENCES "ModulePlanPurchase"("id") ON DELETE SET NULL ON UPDATE CASCADE;
diff --git a/prisma/schema.prisma b/prisma/schema.prisma
index 3d3f828..e8200d5 100644
--- a/prisma/schema.prisma
+++ b/prisma/schema.prisma
@@ -60,6 +60,7 @@ enum LicitationSource {
   MUNICIPAL_OPEN_PORTAL
   PNT
   MUNICIPAL_BACKUP
+  LICITAYA
 }
 
 enum LicitationProcedureType {
@@ -83,11 +84,151 @@ enum SyncRunStatus {
   FAILED
 }
 
+enum ProposalStatus {
+  DRAFT
+  IN_PROGRESS
+  SUBMITTED
+  ARCHIVED
+}
+
+enum LicitationReviewStatus {
+  NEW
+  REVIEWED
+  INTERESTED
+  DISCARDED
+}
+
+enum NormativeDocumentType {
+  BASES_LICITACION
+  CONVOCATORIA
+  REGLAMENTO
+  LEY
+  OTRO
+}
+
+enum NormativeAnalysisMethod {
+  DIRECT
+  OCR
+}
+
+enum NormativeConfidence {
+  LOW
+  MEDIUM
+  HIGH
+}
+
+enum NormativeRiskLevel {
+  ALTO
+  MEDIO
+  BAJO
+}
+
+enum OfficialNormativeSourceType {
+  LEY
+  REGLAMENTO
+  LINEAMIENTO
+  PORTAL
+}
+
+enum NormativeVerificationStatus {
+  SUCCESS
+  WARNING
+  FAILED
+}
+
 enum MunicipalOpenPortalType {
   GENERIC
   SAN_PEDRO_ASPX
 }
 
+enum ContractStatus {
+  ACTIVE
+  COMPLETED
+  PAUSED
+  CANCELLED
+}
+
+enum ContractDeliverableStatus {
+  PENDING
+  DELIVERED
+  APPROVED
+  REJECTED
+  OVERDUE
+}
+
+enum ContractPaymentStatus {
+  REGISTERED
+  CONFIRMED
+  DISPUTED
+}
+
+enum ContractDocumentKind {
+  SIGNED_CONTRACT
+  ADDENDUM
+  DELIVERABLE_EVIDENCE
+  PAYMENT_EVIDENCE
+  OTHER
+}
+
+enum LegalCaseType {
+  CONTRACT_BREACH
+  PAYMENT_RETENTION
+  UNJUST_SANCTION
+  CONTRACT_DISPUTE
+}
+
+enum LegalCaseSeverity {
+  LOW
+  MEDIUM
+  HIGH
+}
+
+enum LegalCaseStatus {
+  OPEN
+  IN_PROGRESS
+  ESCALATED
+  RESOLVED
+  CLOSED
+}
+
+enum LegalJurisdictionLevel {
+  FEDERAL
+  STATE
+  MUNICIPAL
+}
+
+enum AuditSimulationStatus {
+  DRAFT
+  COMPLETED
+}
+
+enum AuditSimulationSectionStatus {
+  READY
+  WARNING
+  CRITICAL
+}
+
+enum AiSuggestionStatus {
+  GENERATED
+  ACCEPTED
+  DISMISSED
+  EXPIRED
+}
+
+enum ModulePlanKey {
+  PLAN_2_4
+  PLAN_5_7
+  PLAN_8_10
+}
+
+enum ModulePlanPurchaseStatus {
+  PENDING
+  APPROVED
+  REJECTED
+  CANCELLED
+  EXPIRED
+}
+
 model User {
   id                              String                                @id @default(cuid())
   email                           String                                @unique
@@ -103,9 +244,23 @@ model User {
   strategicDiagnosticEvidenceDocs StrategicDiagnosticEvidenceDocument[]
   workshopProgresses              DevelopmentWorkshopProgress[]
   workshopEvidenceDocs            DevelopmentWorkshopEvidence[]
+  proposals                       Proposal[]
+  proposalDocuments               ProposalDocument[]
+  licitationPreferences           LicitationUserPreference[]
+  normativeAnalyses               NormativeAnalysisHistory[]
+  contracts                       ContractRecord[]
+  contractExtractionHistories     ContractExtractionHistory[]
+  legalCases                      LegalCase[]
+  legalDiagnoses                  LegalDiagnosis[]
+  legalDocuments                  LegalDocument[]
+  auditSimulations                AuditSimulation[]
+  institutionalDossierSnapshots   InstitutionalDossierSnapshot[]
   verificationTokens              EmailVerificationToken[]
   responses                       Response[]
   results                         AssessmentResult[]
+  aiSuggestions                   AiSuggestion[]
+  modulePlanPurchases             ModulePlanPurchase[]
+  modulePlanSubscriptions         ModulePlanSubscription[]
 }
 
 model Organization {
@@ -192,13 +347,13 @@ model StrategicDiagnosticEvidenceDocument {
 }
 
 model DiagnosticModule {
-  id              String             @id @default(cuid())
-  key             String             @unique
+  id              String                @id @default(cuid())
+  key             String                @unique
   name            String
   description     String?
-  sortOrder       Int                @default(0)
-  createdAt       DateTime           @default(now())
-  updatedAt       DateTime           @updatedAt
+  sortOrder       Int                   @default(0)
+  createdAt       DateTime              @default(now())
+  updatedAt       DateTime              @updatedAt
   questions       Question[]
   results         AssessmentResult[]
   recommendations Recommendation[]
@@ -206,39 +361,39 @@ model DiagnosticModule {
 }
 
 model DevelopmentWorkshop {
-  id                String                        @id @default(cuid())
-  key               String                        @unique
-  moduleId          String
-  title             String
-  summary           String
-  videoUrl          String
-  durationMinutes   Int                           @default(0)
-  evidenceRequired  String
+  id                 String                        @id @default(cuid())
+  key                String                        @unique
+  moduleId           String
+  title              String
+  summary            String
+  videoUrl           String
+  durationMinutes    Int                           @default(0)
+  evidenceRequired   String
   learningObjectives Json?
-  sortOrder         Int                           @default(0)
-  isActive          Boolean                       @default(true)
-  createdAt         DateTime                      @default(now())
-  updatedAt         DateTime                      @updatedAt
-  module            DiagnosticModule              @relation(fields: [moduleId], references: [id], onDelete: Cascade)
-  progresses        DevelopmentWorkshopProgress[]
-  evidences         DevelopmentWorkshopEvidence[]
+  sortOrder          Int                           @default(0)
+  isActive           Boolean                       @default(true)
+  createdAt          DateTime                      @default(now())
+  updatedAt          DateTime                      @updatedAt
+  module             DiagnosticModule              @relation(fields: [moduleId], references: [id], onDelete: Cascade)
+  progresses         DevelopmentWorkshopProgress[]
+  evidences          DevelopmentWorkshopEvidence[]
 
   @@index([moduleId, sortOrder])
   @@index([isActive, sortOrder])
 }
 
 model DevelopmentWorkshopProgress {
-  id          String               @id @default(cuid())
+  id          String                 @id @default(cuid())
   workshopId  String
   userId      String
   status      WorkshopProgressStatus @default(NOT_STARTED)
   watchedAt   DateTime?
   skippedAt   DateTime?
   completedAt DateTime?
-  createdAt   DateTime             @default(now())
-  updatedAt   DateTime             @updatedAt
-  workshop    DevelopmentWorkshop  @relation(fields: [workshopId], references: [id], onDelete: Cascade)
-  user        User                 @relation(fields: [userId], references: [id], onDelete: Cascade)
+  createdAt   DateTime               @default(now())
+  updatedAt   DateTime               @updatedAt
+  workshop    DevelopmentWorkshop    @relation(fields: [workshopId], references: [id], onDelete: Cascade)
+  user        User                   @relation(fields: [userId], references: [id], onDelete: Cascade)
 
   @@unique([workshopId, userId])
   @@index([userId, status])
@@ -384,6 +539,48 @@ model EmailVerificationToken {
   @@index([expiresAt])
 }
 
+model ModulePlanPurchase {
+  id                  String                   @id @default(cuid())
+  userId              String
+  planKey             ModulePlanKey
+  status              ModulePlanPurchaseStatus @default(PENDING)
+  externalReference   String                   @unique
+  mercadoPreferenceId String?
+  mercadoPaymentId    String?
+  mercadoOrderId      String?
+  checkoutUrl         String?
+  amount              Decimal                  @db.Decimal(14, 2)
+  currency            String                   @default("MXN")
+  requestJson         Json?
+  responseJson        Json?
+  approvedAt          DateTime?
+  createdAt           DateTime                 @default(now())
+  updatedAt           DateTime                 @updatedAt
+  user                User                     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  subscriptions       ModulePlanSubscription[]
+
+  @@index([userId, planKey, createdAt])
+  @@index([status, updatedAt])
+  @@index([mercadoPaymentId])
+}
+
+model ModulePlanSubscription {
+  id               String        @id @default(cuid())
+  userId           String
+  planKey          ModulePlanKey
+  sourcePurchaseId String?
+  isActive         Boolean       @default(true)
+  startsAt         DateTime      @default(now())
+  expiresAt        DateTime?
+  createdAt        DateTime      @default(now())
+  updatedAt        DateTime      @updatedAt
+  user             User          @relation(fields: [userId], references: [id], onDelete: Cascade)
+  sourcePurchase   ModulePlanPurchase? @relation(fields: [sourcePurchaseId], references: [id], onDelete: SetNull)
+
+  @@unique([userId, planKey])
+  @@index([userId, isActive, expiresAt])
+}
+
 model Municipality {
   id                   String                  @id @default(cuid())
   stateCode            String
@@ -412,31 +609,33 @@ model Municipality {
 }
 
 model Licitation {
-  id              String                  @id @default(cuid())
-  municipalityId  String
-  source          LicitationSource
-  sourceRecordId  String
-  tenderCode      String?
-  procedureType   LicitationProcedureType @default(UNKNOWN)
-  title           String
-  description     String?
-  category        LicitationCategory?     @default(UNKNOWN)
-  isOpen          Boolean                 @default(true)
-  openingDate     DateTime?
-  closingDate     DateTime?
-  publishDate     DateTime?
-  eventDates      Json?
-  amount          Decimal?                @db.Decimal(14, 2)
-  currency        String?
-  status          String?
-  supplierAwarded String?
-  documents       Json?
-  rawSourceUrl    String?
-  rawPayload      Json
-  lastSeenAt      DateTime                @default(now())
-  createdAt       DateTime                @default(now())
-  updatedAt       DateTime                @updatedAt
-  municipality    Municipality            @relation(fields: [municipalityId], references: [id], onDelete: Cascade)
+  id                String                     @id @default(cuid())
+  municipalityId    String
+  source            LicitationSource
+  sourceRecordId    String
+  tenderCode        String?
+  procedureType     LicitationProcedureType    @default(UNKNOWN)
+  title             String
+  description       String?
+  category          LicitationCategory?        @default(UNKNOWN)
+  isOpen            Boolean                    @default(true)
+  openingDate       DateTime?
+  closingDate       DateTime?
+  publishDate       DateTime?
+  eventDates        Json?
+  amount            Decimal?                   @db.Decimal(14, 2)
+  currency          String?
+  status            String?
+  supplierAwarded   String?
+  documents         Json?
+  rawSourceUrl      String?
+  rawPayload        Json
+  lastSeenAt        DateTime                   @default(now())
+  createdAt         DateTime                   @default(now())
+  updatedAt         DateTime                   @updatedAt
+  municipality      Municipality               @relation(fields: [municipalityId], references: [id], onDelete: Cascade)
+  userPreferences   LicitationUserPreference[]
+  normativeAnalyses NormativeAnalysisHistory[]
 
   @@unique([municipalityId, source, sourceRecordId])
   @@index([municipalityId, isOpen, closingDate])
@@ -475,3 +674,400 @@ model CompanyProfile {
   user                User          @relation(fields: [userId], references: [id], onDelete: Cascade)
   organization        Organization? @relation(fields: [organizationId], references: [id], onDelete: SetNull)
 }
+
+model LicitationUserPreference {
+  id           String                 @id @default(cuid())
+  userId       String
+  licitationId String
+  status       LicitationReviewStatus @default(NEW)
+  createdAt    DateTime               @default(now())
+  updatedAt    DateTime               @updatedAt
+  user         User                   @relation(fields: [userId], references: [id], onDelete: Cascade)
+  licitation   Licitation             @relation(fields: [licitationId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, licitationId])
+  @@index([userId, status])
+  @@index([licitationId, status])
+}
+
+model NormativeAnalysisHistory {
+  id                 String                  @id @default(cuid())
+  userId             String
+  sourceLicitationId String?
+  fileName           String
+  documentType       NormativeDocumentType
+  issuingEntity      String?
+  methodUsed         NormativeAnalysisMethod
+  numPages           Int
+  warnings           Json?
+  extractedChars     Int
+  confidence         NormativeConfidence
+  viabilityScore     Int
+  riskLevel          NormativeRiskLevel
+  executiveSummary   String
+  result             Json
+  analyzedAt         DateTime                @default(now())
+  deletedAt          DateTime?
+  createdAt          DateTime                @default(now())
+  updatedAt          DateTime                @updatedAt
+  user               User                    @relation(fields: [userId], references: [id], onDelete: Cascade)
+  sourceLicitation   Licitation?             @relation(fields: [sourceLicitationId], references: [id], onDelete: SetNull)
+
+  @@index([userId, analyzedAt])
+  @@index([userId, deletedAt])
+  @@index([sourceLicitationId])
+}
+
+model Proposal {
+  id                   String             @id @default(cuid())
+  userId               String
+  sourceLicitationId   String?
+  title                String
+  issuingEntity        String
+  summary              String             @default("")
+  workflowDraft        Json?
+  currentStep          Int                @default(1)
+  completionPercent    Int                @default(0)
+  readyForSubmissionAt DateTime?
+  status               ProposalStatus     @default(DRAFT)
+  createdAt            DateTime           @default(now())
+  updatedAt            DateTime           @updatedAt
+  user                 User               @relation(fields: [userId], references: [id], onDelete: Cascade)
+  documents            ProposalDocument[]
+  contracts            ContractRecord[]
+
+  @@index([userId, status])
+  @@index([updatedAt])
+  @@index([sourceLicitationId])
+}
+
+model ContractRecord {
+  id                 String                      @id @default(cuid())
+  userId             String
+  sourceProposalId   String?
+  title              String
+  counterpartyEntity String
+  contractNumber     String?
+  contractType       String
+  startDate          DateTime?
+  endDate            DateTime?
+  totalAmount        Decimal?                    @db.Decimal(14, 2)
+  currency           String                      @default("MXN")
+  status             ContractStatus              @default(ACTIVE)
+  description        String                      @default("")
+  createdAt          DateTime                    @default(now())
+  updatedAt          DateTime                    @updatedAt
+  user               User                        @relation(fields: [userId], references: [id], onDelete: Cascade)
+  sourceProposal     Proposal?                   @relation(fields: [sourceProposalId], references: [id], onDelete: SetNull)
+  deliverables       ContractDeliverable[]
+  payments           ContractPayment[]
+  documents          ContractDocument[]
+  extractions        ContractExtractionHistory[]
+  legalCases         LegalCase[]
+
+  @@index([userId, status, endDate])
+  @@index([sourceProposalId])
+  @@index([updatedAt])
+}
+
+model ContractDeliverable {
+  id           String                    @id @default(cuid())
+  contractId   String
+  title        String
+  dueDate      DateTime?
+  amountLinked Decimal?                  @db.Decimal(14, 2)
+  status       ContractDeliverableStatus @default(PENDING)
+  deliveredAt  DateTime?
+  approvedAt   DateTime?
+  notes        String                    @default("")
+  createdAt    DateTime                  @default(now())
+  updatedAt    DateTime                  @updatedAt
+  contract     ContractRecord            @relation(fields: [contractId], references: [id], onDelete: Cascade)
+
+  @@index([contractId, status, dueDate])
+  @@index([dueDate])
+}
+
+model ContractPayment {
+  id            String                @id @default(cuid())
+  contractId    String
+  amount        Decimal               @db.Decimal(14, 2)
+  paymentDate   DateTime
+  invoiceNumber String?
+  concept       String                @default("")
+  status        ContractPaymentStatus @default(REGISTERED)
+  createdAt     DateTime              @default(now())
+  updatedAt     DateTime              @updatedAt
+  contract      ContractRecord        @relation(fields: [contractId], references: [id], onDelete: Cascade)
+
+  @@index([contractId, paymentDate])
+  @@index([status, paymentDate])
+}
+
+model ContractDocument {
+  id             String               @id @default(cuid())
+  contractId     String
+  fileName       String
+  filePath       String
+  mimeType       String
+  sizeBytes      Int
+  checksumSha256 String?
+  kind           ContractDocumentKind @default(OTHER)
+  createdAt      DateTime             @default(now())
+  updatedAt      DateTime             @updatedAt
+  contract       ContractRecord       @relation(fields: [contractId], references: [id], onDelete: Cascade)
+
+  @@index([contractId, kind, createdAt])
+}
+
+model ContractExtractionHistory {
+  id           String          @id @default(cuid())
+  contractId   String?
+  userId       String
+  engine       String
+  model        String?
+  resultJson   Json
+  warningsJson Json?
+  analyzedAt   DateTime        @default(now())
+  createdAt    DateTime        @default(now())
+  contract     ContractRecord? @relation(fields: [contractId], references: [id], onDelete: SetNull)
+  user         User            @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId, analyzedAt])
+  @@index([contractId, analyzedAt])
+}
+
+model LegalCase {
+  id             String                   @id @default(cuid())
+  userId         String
+  contractId     String?
+  caseType       LegalCaseType
+  severity       LegalCaseSeverity
+  counterparty   String
+  description    String
+  amountAtRisk   Decimal?                 @db.Decimal(14, 2)
+  status         LegalCaseStatus          @default(OPEN)
+  openedAt       DateTime                 @default(now())
+  resolvedAt     DateTime?
+  createdAt      DateTime                 @default(now())
+  updatedAt      DateTime                 @updatedAt
+  user           User                     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  contract       ContractRecord?          @relation(fields: [contractId], references: [id], onDelete: SetNull)
+  diagnoses      LegalDiagnosis[]
+  escalationLogs LegalEscalationStepLog[]
+  documents      LegalDocument[]
+
+  @@index([userId, status, severity])
+  @@index([contractId])
+}
+
+model LegalDiagnosis {
+  id                   String     @id @default(cuid())
+  userId               String
+  legalCaseId          String?
+  stepIndex            Int        @default(1)
+  totalSteps           Int        @default(4)
+  answersJson          Json
+  recommendedRouteJson Json
+  createdAt            DateTime   @default(now())
+  updatedAt            DateTime   @updatedAt
+  user                 User       @relation(fields: [userId], references: [id], onDelete: Cascade)
+  legalCase            LegalCase? @relation(fields: [legalCaseId], references: [id], onDelete: SetNull)
+
+  @@index([userId, updatedAt])
+  @@index([legalCaseId])
+}
+
+model LegalEscalationStepLog {
+  id           String    @id @default(cuid())
+  legalCaseId  String
+  routeStepKey String
+  completedAt  DateTime?
+  notes        String    @default("")
+  createdAt    DateTime  @default(now())
+  updatedAt    DateTime  @updatedAt
+  legalCase    LegalCase @relation(fields: [legalCaseId], references: [id], onDelete: Cascade)
+
+  @@unique([legalCaseId, routeStepKey])
+  @@index([legalCaseId, completedAt])
+}
+
+model LegalDocument {
+  id          String     @id @default(cuid())
+  legalCaseId String?
+  userId      String
+  templateKey String?
+  aiGenerated Boolean    @default(false)
+  title       String
+  content     String
+  createdAt   DateTime   @default(now())
+  updatedAt   DateTime   @updatedAt
+  legalCase   LegalCase? @relation(fields: [legalCaseId], references: [id], onDelete: SetNull)
+  user        User       @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId, createdAt])
+  @@index([legalCaseId, createdAt])
+}
+
+model LegalDirectoryEntity {
+  id                String                 @id @default(cuid())
+  jurisdictionLevel LegalJurisdictionLevel
+  name              String
+  scopeTagsJson     Json
+  websiteUrl        String?
+  phone             String?
+  email             String?
+  stateCode         String?
+  municipalityCode  String?
+  isActive          Boolean                @default(true)
+  createdAt         DateTime               @default(now())
+  updatedAt         DateTime               @updatedAt
+
+  @@index([jurisdictionLevel, isActive])
+  @@index([stateCode, municipalityCode, isActive])
+}
+
+model AuditSimulation {
+  id           String                   @id @default(cuid())
+  userId       String
+  name         String
+  auditType    String
+  status       AuditSimulationStatus    @default(DRAFT)
+  overallScore Int?
+  completedAt  DateTime?
+  createdAt    DateTime                 @default(now())
+  updatedAt    DateTime                 @updatedAt
+  user         User                     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  sections     AuditSimulationSection[]
+  responses    AuditChecklistResponse[]
+
+  @@index([userId, status, updatedAt])
+}
+
+model AuditSimulationSection {
+  id                  String                       @id @default(cuid())
+  simulationId        String
+  key                 String
+  score               Int?
+  status              AuditSimulationSectionStatus @default(READY)
+  findingsJson        Json?
+  recommendationsJson Json?
+  createdAt           DateTime                     @default(now())
+  updatedAt           DateTime                     @updatedAt
+  simulation          AuditSimulation              @relation(fields: [simulationId], references: [id], onDelete: Cascade)
+
+  @@unique([simulationId, key])
+  @@index([status])
+}
+
+model AuditChecklistResponse {
+  id               String          @id @default(cuid())
+  simulationId     String
+  questionKey      String
+  answer           String
+  evidenceRefsJson Json?
+  createdAt        DateTime        @default(now())
+  updatedAt        DateTime        @updatedAt
+  simulation       AuditSimulation @relation(fields: [simulationId], references: [id], onDelete: Cascade)
+
+  @@index([simulationId, questionKey])
+}
+
+model InstitutionalDossierSnapshot {
+  id          String   @id @default(cuid())
+  userId      String
+  generatedAt DateTime @default(now())
+  payloadJson Json
+  createdAt   DateTime @default(now())
+  user        User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId, generatedAt])
+}
+
+model ProposalDocument {
+  id             String   @id @default(cuid())
+  proposalId     String
+  userId         String
+  fileName       String
+  storedFileName String
+  filePath       String
+  mimeType       String
+  sizeBytes      Int
+  checksumSha256 String?
+  createdAt      DateTime @default(now())
+  updatedAt      DateTime @updatedAt
+  proposal       Proposal @relation(fields: [proposalId], references: [id], onDelete: Cascade)
+  user           User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([proposalId, createdAt])
+  @@index([userId, createdAt])
+}
+
+model OfficialNormativeSource {
+  id               String                       @id
+  stateCode        String
+  stateName        String
+  municipalityCode String?
+  municipalityName String?
+  authorityName    String
+  title            String
+  officialUrl      String
+  sourceType       OfficialNormativeSourceType
+  versionLabel     String?
+  isPilot          Boolean                      @default(false)
+  lastKnownHash    String?
+  lastVerifiedAt   DateTime?
+  nextCheckAt      DateTime?
+  lastStatus       NormativeVerificationStatus?
+  lastMessage      String?
+  lastChangedAt    DateTime?
+  createdAt        DateTime                     @default(now())
+  updatedAt        DateTime                     @updatedAt
+
+  @@index([stateCode, municipalityCode, isPilot])
+  @@index([nextCheckAt])
+  @@index([lastStatus, lastVerifiedAt])
+}
+
+model OfficialNormativeSuggestion {
+  id               String                      @id @default(cuid())
+  stateCode        String
+  municipalityCode String?
+  authorityName    String
+  title            String
+  officialUrl      String
+  sourceType       OfficialNormativeSourceType
+  notes            String?
+  createdAt        DateTime                    @default(now())
+  updatedAt        DateTime                    @updatedAt
+
+  @@index([stateCode, municipalityCode, createdAt])
+}
+
+model AiSuggestion {
+  id            String             @id @default(cuid())
+  userId        String
+  moduleKey     String
+  featureKey    String
+  subjectType   String
+  subjectId     String
+  inputHash     String
+  requestJson   Json
+  responseJson  Json
+  confidence    Float?
+  engine        String
+  model         String?
+  usageJson     Json?
+  warningsJson  Json?
+  promptVersion String
+  status        AiSuggestionStatus @default(GENERATED)
+  actedAt       DateTime?
+  createdAt     DateTime           @default(now())
+  updatedAt     DateTime           @updatedAt
+  user          User               @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, moduleKey, featureKey, subjectType, subjectId, inputHash], map: "ai_suggestion_dedupe")
+  @@index([userId, moduleKey, featureKey, createdAt])
+  @@index([status, updatedAt])
+  @@index([inputHash])
+}
diff --git a/prisma/seed.mjs b/prisma/seed.mjs
index ee9ee53..1514bc7 100644
--- a/prisma/seed.mjs
+++ b/prisma/seed.mjs
@@ -1,4 +1,4 @@
-import { PrismaClient, ContentPageType, OverallScoreMethod, PriorityLevel } from "@prisma/client";
+import { PrismaClient, ContentPageType, LegalJurisdictionLevel, OverallScoreMethod, PriorityLevel } from "@prisma/client";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -389,6 +389,99 @@ const contentPageSeeds = [
   },
 ];
 
+const legalDirectorySeeds = [
+  {
+    jurisdictionLevel: LegalJurisdictionLevel.FEDERAL,
+    name: "Secretaria de la Funcion Publica (SFP)",
+    scopeTagsJson: ["inconformidades", "sanciones", "organo-interno-control"],
+    websiteUrl: "https://www.gob.mx/sfp",
+    phone: null,
+    email: null,
+    stateCode: null,
+    municipalityCode: null,
+  },
+  {
+    jurisdictionLevel: LegalJurisdictionLevel.FEDERAL,
+    name: "Tribunal Federal de Justicia Administrativa (TFJA)",
+    scopeTagsJson: ["juicio-contencioso", "nulidad", "sanciones-administrativas"],
+    websiteUrl: "https://www.tfja.gob.mx",
+    phone: null,
+    email: null,
+    stateCode: null,
+    municipalityCode: null,
+  },
+  {
+    jurisdictionLevel: LegalJurisdictionLevel.FEDERAL,
+    name: "Auditoria Superior de la Federacion (ASF)",
+    scopeTagsJson: ["auditoria", "fiscalizacion", "cuenta-publica"],
+    websiteUrl: "https://www.asf.gob.mx",
+    phone: null,
+    email: null,
+    stateCode: null,
+    municipalityCode: null,
+  },
+  {
+    jurisdictionLevel: LegalJurisdictionLevel.FEDERAL,
+    name: "CompraNet",
+    scopeTagsJson: ["contrataciones", "licitaciones", "expedientes"],
+    websiteUrl: "https://compranet.hacienda.gob.mx",
+    phone: null,
+    email: null,
+    stateCode: null,
+    municipalityCode: null,
+  },
+  {
+    jurisdictionLevel: LegalJurisdictionLevel.FEDERAL,
+    name: "Sistema Nacional Anticorrupcion",
+    scopeTagsJson: ["anticorrupcion", "denuncias", "integridad"],
+    websiteUrl: "https://www.sna.org.mx",
+    phone: null,
+    email: null,
+    stateCode: null,
+    municipalityCode: null,
+  },
+  {
+    jurisdictionLevel: LegalJurisdictionLevel.STATE,
+    name: "Secretaria de la Contraloria y Transparencia Gubernamental de Nuevo Leon",
+    scopeTagsJson: ["inconformidades", "contraloria", "responsabilidades"],
+    websiteUrl: "https://www.nl.gob.mx/dependencias/contraloria",
+    phone: null,
+    email: null,
+    stateCode: "NL",
+    municipalityCode: null,
+  },
+  {
+    jurisdictionLevel: LegalJurisdictionLevel.STATE,
+    name: "Tribunal de Justicia Administrativa de Nuevo Leon",
+    scopeTagsJson: ["juicio-administrativo", "sanciones", "nulidad"],
+    websiteUrl: "https://tjanl.gob.mx",
+    phone: null,
+    email: null,
+    stateCode: "NL",
+    municipalityCode: null,
+  },
+  {
+    jurisdictionLevel: LegalJurisdictionLevel.STATE,
+    name: "Auditoria Superior del Estado de Nuevo Leon",
+    scopeTagsJson: ["auditoria", "fiscalizacion", "cuenta-publica-estatal"],
+    websiteUrl: "https://www.asenl.gob.mx",
+    phone: null,
+    email: null,
+    stateCode: "NL",
+    municipalityCode: null,
+  },
+  {
+    jurisdictionLevel: LegalJurisdictionLevel.STATE,
+    name: "Sistema Estatal Anticorrupcion de Nuevo Leon",
+    scopeTagsJson: ["anticorrupcion", "politica-estatal", "coordinacion"],
+    websiteUrl: "https://www.seanl.mx",
+    phone: null,
+    email: null,
+    stateCode: "NL",
+    municipalityCode: null,
+  },
+];
+
 async function upsertDiagnosticStructure() {
   const moduleKeys = moduleSeeds.map((moduleSeed) => moduleSeed.key);
 
@@ -605,6 +698,48 @@ async function upsertDefaultScoringConfig() {
   });
 }
 
+async function upsertLegalDirectory() {
+  for (const item of legalDirectorySeeds) {
+    const existing = await prisma.legalDirectoryEntity.findFirst({
+      where: {
+        jurisdictionLevel: item.jurisdictionLevel,
+        name: item.name,
+        stateCode: item.stateCode,
+        municipalityCode: item.municipalityCode,
+      },
+      select: { id: true },
+    });
+
+    if (existing) {
+      await prisma.legalDirectoryEntity.update({
+        where: { id: existing.id },
+        data: {
+          scopeTagsJson: item.scopeTagsJson,
+          websiteUrl: item.websiteUrl,
+          phone: item.phone,
+          email: item.email,
+          isActive: true,
+        },
+      });
+      continue;
+    }
+
+    await prisma.legalDirectoryEntity.create({
+      data: {
+        jurisdictionLevel: item.jurisdictionLevel,
+        name: item.name,
+        scopeTagsJson: item.scopeTagsJson,
+        websiteUrl: item.websiteUrl,
+        phone: item.phone,
+        email: item.email,
+        stateCode: item.stateCode,
+        municipalityCode: item.municipalityCode,
+        isActive: true,
+      },
+    });
+  }
+}
+
 async function loadMunicipalitySeeds() {
   const filePath = path.join(__dirname, "data", "municipalities.json");
   const content = await readFile(filePath, "utf-8");
@@ -697,6 +832,7 @@ async function main() {
   await upsertRecommendations();
   await upsertContentPages();
   await upsertDefaultScoringConfig();
+  await upsertLegalDirectory();
   const municipalitySeedCount = await upsertMunicipalities();
 
   const moduleCount = await prisma.diagnosticModule.count();
@@ -705,6 +841,7 @@ async function main() {
   const workshopCount = await prisma.developmentWorkshop.count();
   const recommendationCount = await prisma.recommendation.count();
   const contentPageCount = await prisma.contentPage.count();
+  const legalDirectoryCount = await prisma.legalDirectoryEntity.count({ where: { isActive: true } });
   const municipalityCount = await prisma.municipality.count({ where: { isActive: true } });
 
   console.log("Seed completed", {
@@ -714,6 +851,7 @@ async function main() {
     workshops: workshopCount,
     recommendations: recommendationCount,
     contentPages: contentPageCount,
+    legalDirectory: legalDirectoryCount,
     municipalities: municipalityCount,
     municipalitySeedsProcessed: municipalitySeedCount,
   });
diff --git a/scripts/backfill-licitaya-history.mjs b/scripts/backfill-licitaya-history.mjs
new file mode 100644
index 0000000..e3bfa4e
--- /dev/null
+++ b/scripts/backfill-licitaya-history.mjs
@@ -0,0 +1,578 @@
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { PrismaClient, LicitationCategory, LicitationProcedureType, LicitationSource, MunicipalOpenPortalType } from "@prisma/client";
+
+const DEFAULT_ITEMS = 50;
+const DEFAULT_MAX_PAGES = 5;
+const DEFAULT_DAYS = 30;
+const DEFAULT_DELAY_MS = 400;
+const LICITAYA_MUNICIPALITY_CODE = "LICITAYA";
+
+const LICITAYA_STATE_MAP = {
+  AGS: { stateCode: "1", stateName: "Aguascalientes" },
+  BCN: { stateCode: "2", stateName: "Baja California" },
+  BCS: { stateCode: "3", stateName: "Baja California Sur" },
+  CAM: { stateCode: "4", stateName: "Campeche" },
+  CHP: { stateCode: "5", stateName: "Chiapas" },
+  CHH: { stateCode: "6", stateName: "Chihuahua" },
+  COA: { stateCode: "7", stateName: "Coahuila" },
+  COL: { stateCode: "8", stateName: "Colima" },
+  CMX: { stateCode: "9", stateName: "Ciudad de Mexico" },
+  CDMX: { stateCode: "9", stateName: "Ciudad de Mexico" },
+  DUR: { stateCode: "10", stateName: "Durango" },
+  GUA: { stateCode: "11", stateName: "Guanajuato" },
+  GRO: { stateCode: "12", stateName: "Guerrero" },
+  HID: { stateCode: "13", stateName: "Hidalgo" },
+  JAL: { stateCode: "14", stateName: "Jalisco" },
+  MEX: { stateCode: "15", stateName: "Estado de Mexico" },
+  MIC: { stateCode: "16", stateName: "Michoacan" },
+  MOR: { stateCode: "17", stateName: "Morelos" },
+  NAY: { stateCode: "18", stateName: "Nayarit" },
+  NLE: { stateCode: "19", stateName: "Nuevo Leon" },
+  OAX: { stateCode: "20", stateName: "Oaxaca" },
+  PUE: { stateCode: "21", stateName: "Puebla" },
+  QUE: { stateCode: "22", stateName: "Queretaro" },
+  ROO: { stateCode: "23", stateName: "Quintana Roo" },
+  SLP: { stateCode: "24", stateName: "San Luis Potosi" },
+  SIN: { stateCode: "25", stateName: "Sinaloa" },
+  SON: { stateCode: "26", stateName: "Sonora" },
+  TAB: { stateCode: "27", stateName: "Tabasco" },
+  TAM: { stateCode: "28", stateName: "Tamaulipas" },
+  TLA: { stateCode: "29", stateName: "Tlaxcala" },
+  VER: { stateCode: "30", stateName: "Veracruz" },
+  YUC: { stateCode: "31", stateName: "Yucatan" },
+  ZAC: { stateCode: "32", stateName: "Zacatecas" },
+};
+
+function loadDotenv(filePath) {
+  if (!existsSync(filePath)) {
+    return;
+  }
+
+  const raw = readFileSync(filePath, "utf8");
+
+  for (const line of raw.split(/\r?\n/)) {
+    const trimmed = line.trim();
+
+    if (!trimmed || trimmed.startsWith("#")) {
+      continue;
+    }
+
+    const eqIndex = trimmed.indexOf("=");
+    if (eqIndex === -1) {
+      continue;
+    }
+
+    const key = trimmed.slice(0, eqIndex).trim();
+
+    if (!key || process.env[key] !== undefined) {
+      continue;
+    }
+
+    let value = trimmed.slice(eqIndex + 1).trim();
+
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+      value = value.slice(1, -1);
+    }
+
+    process.env[key] = value;
+  }
+}
+
+function parseInteger(value, fallback) {
+  const parsed = Number.parseInt(value ?? "", 10);
+  return Number.isFinite(parsed) ? parsed : fallback;
+}
+
+function parseArgs(argv) {
+  const args = {
+    days: parseInteger(process.env.LICITAYA_BACKFILL_DAYS, DEFAULT_DAYS),
+    items: parseInteger(process.env.LICITAYA_BACKFILL_ITEMS, DEFAULT_ITEMS),
+    maxPages: parseInteger(process.env.LICITAYA_BACKFILL_MAX_PAGES, DEFAULT_MAX_PAGES),
+    delayMs: parseInteger(process.env.LICITAYA_BACKFILL_DELAY_MS, DEFAULT_DELAY_MS),
+    from: process.env.LICITAYA_BACKFILL_FROM || null,
+    to: process.env.LICITAYA_BACKFILL_TO || null,
+    dryRun: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const current = argv[index];
+    const next = argv[index + 1];
+
+    if (current === "--days" && next) {
+      args.days = parseInteger(next, args.days);
+      index += 1;
+      continue;
+    }
+
+    if (current === "--items" && next) {
+      args.items = parseInteger(next, args.items);
+      index += 1;
+      continue;
+    }
+
+    if (current === "--max-pages" && next) {
+      args.maxPages = parseInteger(next, args.maxPages);
+      index += 1;
+      continue;
+    }
+
+    if (current === "--delay-ms" && next) {
+      args.delayMs = parseInteger(next, args.delayMs);
+      index += 1;
+      continue;
+    }
+
+    if (current === "--from" && next) {
+      args.from = next;
+      index += 1;
+      continue;
+    }
+
+    if (current === "--to" && next) {
+      args.to = next;
+      index += 1;
+      continue;
+    }
+
+    if (current === "--dry-run") {
+      args.dryRun = true;
+      continue;
+    }
+  }
+
+  args.days = Math.max(1, args.days);
+  args.items = Math.min(100, Math.max(1, args.items));
+  args.maxPages = Math.max(1, args.maxPages);
+  args.delayMs = Math.max(0, args.delayMs);
+
+  return args;
+}
+
+function parseDateYmd(value) {
+  if (!value || !/^\d{8}$/.test(value)) {
+    return null;
+  }
+
+  const year = Number.parseInt(value.slice(0, 4), 10);
+  const month = Number.parseInt(value.slice(4, 6), 10);
+  const day = Number.parseInt(value.slice(6, 8), 10);
+  const date = new Date(Date.UTC(year, month - 1, day));
+  return Number.isNaN(date.getTime()) ? null : date;
+}
+
+function formatDateYmd(date) {
+  const year = String(date.getUTCFullYear());
+  const month = String(date.getUTCMonth() + 1).padStart(2, "0");
+  const day = String(date.getUTCDate()).padStart(2, "0");
+  return `${year}${month}${day}`;
+}
+
+function buildDateRange(args) {
+  const toDate = parseDateYmd(args.to) ?? new Date();
+
+  if (args.from) {
+    const fromDate = parseDateYmd(args.from);
+
+    if (!fromDate) {
+      throw new Error("Invalid --from date. Use YYYYMMDD.");
+    }
+
+    const dates = [];
+    const cursor = new Date(Date.UTC(toDate.getUTCFullYear(), toDate.getUTCMonth(), toDate.getUTCDate()));
+    const floor = new Date(Date.UTC(fromDate.getUTCFullYear(), fromDate.getUTCMonth(), fromDate.getUTCDate()));
+
+    while (cursor >= floor) {
+      dates.push(formatDateYmd(cursor));
+      cursor.setUTCDate(cursor.getUTCDate() - 1);
+    }
+
+    return dates;
+  }
+
+  const dates = [];
+  const cursor = new Date(Date.UTC(toDate.getUTCFullYear(), toDate.getUTCMonth(), toDate.getUTCDate()));
+
+  for (let i = 0; i < args.days; i += 1) {
+    dates.push(formatDateYmd(cursor));
+    cursor.setUTCDate(cursor.getUTCDate() - 1);
+  }
+
+  return dates;
+}
+
+function toText(value) {
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length ? trimmed : null;
+  }
+
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+
+  return null;
+}
+
+function parseDateMaybe(value) {
+  const raw = toText(value);
+
+  if (!raw) {
+    return null;
+  }
+
+  const parsed = new Date(raw);
+  return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+
+function mapProcedureType(value) {
+  const text = (toText(value) || "").toLowerCase();
+
+  if (text.includes("adjudicacion directa")) {
+    return LicitationProcedureType.ADJUDICACION_DIRECTA;
+  }
+
+  if (text.includes("invitacion restringida") || text.includes("invitacion a cuando menos")) {
+    return LicitationProcedureType.INVITACION_RESTRINGIDA;
+  }
+
+  if (text.includes("licitacion publica") || text.includes("licitacion")) {
+    return LicitationProcedureType.LICITACION_PUBLICA;
+  }
+
+  return LicitationProcedureType.UNKNOWN;
+}
+
+function mapCategory(title, description) {
+  const text = `${title || ""} ${description || ""}`.toLowerCase();
+  const goods = text.includes("bien") || text.includes("insumo") || text.includes("material");
+  const services = text.includes("servicio") || text.includes("consultoria");
+  const works = text.includes("obra") || text.includes("construccion") || text.includes("infraestructura");
+  const matched = [goods, services, works].filter(Boolean).length;
+
+  if (matched > 1) {
+    return LicitationCategory.MIXED;
+  }
+
+  if (goods) {
+    return LicitationCategory.GOODS;
+  }
+
+  if (services) {
+    return LicitationCategory.SERVICES;
+  }
+
+  if (works) {
+    return LicitationCategory.WORKS;
+  }
+
+  return LicitationCategory.UNKNOWN;
+}
+
+function sanitizeDocuments(record) {
+  const docs = [];
+
+  if (toText(record.url)) {
+    docs.push({ name: "Ficha LicitaYa", url: String(record.url) });
+  }
+
+  if (toText(record.url2)) {
+    docs.push({ name: "Fuente alterna", url: String(record.url2) });
+  }
+
+  const seen = new Set();
+
+  return docs.filter((doc) => {
+    if (seen.has(doc.url)) {
+      return false;
+    }
+
+    seen.add(doc.url);
+    return true;
+  });
+}
+
+function resolveLicitayaState(rawState, stateNamesByCode) {
+  const token = (toText(rawState) || "").toUpperCase().replace(/[^A-Z]/g, "");
+  const mapped = LICITAYA_STATE_MAP[token] ?? null;
+
+  if (!mapped) {
+    return {
+      stateCode: "00",
+      stateName: "Cobertura nacional",
+    };
+  }
+
+  return {
+    stateCode: mapped.stateCode,
+    stateName: stateNamesByCode.get(mapped.stateCode) || mapped.stateName,
+  };
+}
+
+async function delay(ms) {
+  if (ms <= 0) {
+    return;
+  }
+
+  await new Promise((resolvePromise) => setTimeout(resolvePromise, ms));
+}
+
+async function main() {
+  loadDotenv(resolve(process.cwd(), ".env"));
+
+  const args = parseArgs(process.argv.slice(2));
+  const dates = buildDateRange(args);
+  const apiKey = process.env.LICITAYA_API_KEY?.trim();
+  const baseUrl = (process.env.LICITAYA_BASE_URL?.trim() || "https://www.licitaya.com.mx/api/v1").replace(/\/+$/, "");
+
+  if (!apiKey) {
+    throw new Error("LICITAYA_API_KEY is required.");
+  }
+
+  const prisma = new PrismaClient();
+
+  try {
+    const stateRows = await prisma.municipality.findMany({
+      where: {
+        isActive: true,
+        municipalityCode: {
+          not: LICITAYA_MUNICIPALITY_CODE,
+        },
+      },
+      select: {
+        stateCode: true,
+        stateName: true,
+      },
+      distinct: ["stateCode"],
+    });
+
+    const stateNamesByCode = new Map(stateRows.map((row) => [row.stateCode, row.stateName]));
+    const municipalityCache = new Map();
+
+    async function ensureLicitayaMunicipality(stateCode, stateName) {
+      const key = `${stateCode}|${stateName}`;
+
+      if (municipalityCache.has(key)) {
+        return municipalityCache.get(key);
+      }
+
+      const municipality = await prisma.municipality.upsert({
+        where: {
+          stateCode_municipalityCode: {
+            stateCode,
+            municipalityCode: LICITAYA_MUNICIPALITY_CODE,
+          },
+        },
+        update: {
+          stateName,
+          municipalityName: `Cobertura LicitaYa (${stateName})`,
+          isActive: true,
+          scrapingEnabled: false,
+          openPortalType: MunicipalOpenPortalType.GENERIC,
+          openPortalUrl: null,
+          backupUrl: null,
+          pntEntryUrl: null,
+          pntEntityId: null,
+          pntSectorId: null,
+          pntSubjectId: null,
+        },
+        create: {
+          stateCode,
+          stateName,
+          municipalityCode: LICITAYA_MUNICIPALITY_CODE,
+          municipalityName: `Cobertura LicitaYa (${stateName})`,
+          openPortalType: MunicipalOpenPortalType.GENERIC,
+          isActive: true,
+          scrapingEnabled: false,
+        },
+        select: {
+          id: true,
+        },
+      });
+
+      municipalityCache.set(key, municipality);
+      return municipality;
+    }
+
+    const summary = {
+      datesAttempted: dates.length,
+      pagesAttempted: 0,
+      emptyDates: 0,
+      fetched: 0,
+      inserted: 0,
+      updated: 0,
+      skipped: 0,
+      errors: 0,
+      warnings: [],
+      dryRun: args.dryRun,
+    };
+
+    for (const date of dates) {
+      let dateHadResults = false;
+
+      for (let page = 1; page <= args.maxPages; page += 1) {
+        const requestUrl = new URL("tender/search", `${baseUrl}/`);
+        requestUrl.searchParams.set("date", date);
+        requestUrl.searchParams.set("items", String(args.items));
+        requestUrl.searchParams.set("page", String(page));
+        requestUrl.searchParams.set("order", "1");
+
+        summary.pagesAttempted += 1;
+
+        const response = await fetch(requestUrl, {
+          headers: {
+            "X-API-KEY": apiKey,
+            Accept: "application/json",
+          },
+        });
+
+        if (response.status === 404) {
+          break;
+        }
+
+        if (!response.ok) {
+          summary.errors += 1;
+          summary.warnings.push(`HTTP ${response.status} for ${requestUrl.toString()}`);
+          break;
+        }
+
+        const payload = (await response.json().catch(() => null));
+
+        if (!payload || typeof payload !== "object") {
+          summary.errors += 1;
+          summary.warnings.push(`Invalid JSON for ${requestUrl.toString()}`);
+          break;
+        }
+
+        const rows = Array.isArray(payload.results) ? payload.results : [];
+
+        if (!rows.length) {
+          break;
+        }
+
+        dateHadResults = true;
+
+        for (const row of rows) {
+          if (!row || typeof row !== "object") {
+            continue;
+          }
+
+          const record = row;
+          const tenderId = toText(record.tenderId);
+          const title = toText(record.tender_object) || toText(record.expanded_search) || (tenderId ? `Licitacion ${tenderId}` : null);
+
+          if (!tenderId || !title) {
+            summary.skipped += 1;
+            continue;
+          }
+
+          summary.fetched += 1;
+
+          const description = toText(record.expanded_search) || toText(record.extra_info) || null;
+          const publishDate = parseDateMaybe(record.catalog_date);
+          const closingDate = parseDateMaybe(record.close_date);
+          const state = resolveLicitayaState(record.state, stateNamesByCode);
+          const municipality = await ensureLicitayaMunicipality(state.stateCode, state.stateName);
+
+          if (args.dryRun) {
+            continue;
+          }
+
+          const sourceRecordId = tenderId.slice(0, 255);
+          const existing = await prisma.licitation.findUnique({
+            where: {
+              municipalityId_source_sourceRecordId: {
+                municipalityId: municipality.id,
+                source: LicitationSource.LICITAYA,
+                sourceRecordId,
+              },
+            },
+            select: {
+              id: true,
+            },
+          });
+
+          await prisma.licitation.upsert({
+            where: {
+              municipalityId_source_sourceRecordId: {
+                municipalityId: municipality.id,
+                source: LicitationSource.LICITAYA,
+                sourceRecordId,
+              },
+            },
+            update: {
+              tenderCode: toText(record.number) || toText(record.number2) || toText(record.reference) || toText(record.process) || null,
+              procedureType: mapProcedureType(record.type),
+              title,
+              description,
+              category: mapCategory(title, description),
+              isOpen: closingDate ? closingDate >= new Date() : true,
+              closingDate,
+              publishDate,
+              supplierAwarded: toText(record.agency),
+              documents: sanitizeDocuments(record),
+              rawSourceUrl: requestUrl.toString(),
+              rawPayload: {
+                source: "licitaya-backfill",
+                licitayaState: toText(record.state),
+                licitayaCity: toText(record.city),
+                record,
+              },
+              lastSeenAt: new Date(),
+            },
+            create: {
+              municipalityId: municipality.id,
+              source: LicitationSource.LICITAYA,
+              sourceRecordId,
+              tenderCode: toText(record.number) || toText(record.number2) || toText(record.reference) || toText(record.process) || null,
+              procedureType: mapProcedureType(record.type),
+              title,
+              description,
+              category: mapCategory(title, description),
+              isOpen: closingDate ? closingDate >= new Date() : true,
+              closingDate,
+              publishDate,
+              supplierAwarded: toText(record.agency),
+              documents: sanitizeDocuments(record),
+              rawSourceUrl: requestUrl.toString(),
+              rawPayload: {
+                source: "licitaya-backfill",
+                licitayaState: toText(record.state),
+                licitayaCity: toText(record.city),
+                record,
+              },
+              lastSeenAt: new Date(),
+            },
+          });
+
+          if (existing) {
+            summary.updated += 1;
+          } else {
+            summary.inserted += 1;
+          }
+        }
+
+        const totalPages = Number.parseInt(toText(payload.total_pages) || "1", 10);
+
+        if (!Number.isFinite(totalPages) || page >= totalPages || page >= args.maxPages) {
+          break;
+        }
+
+        await delay(args.delayMs);
+      }
+
+      if (!dateHadResults) {
+        summary.emptyDates += 1;
+      }
+    }
+
+    console.log(JSON.stringify(summary, null, 2));
+  } finally {
+    await prisma.$disconnect();
+  }
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});
diff --git a/scripts/test-licitaya-api.mjs b/scripts/test-licitaya-api.mjs
index 697ea58..4639620 100644
--- a/scripts/test-licitaya-api.mjs
+++ b/scripts/test-licitaya-api.mjs
@@ -2,6 +2,25 @@ import { readFileSync, existsSync } from "node:fs";
 import { resolve } from "node:path";
 
 const DEFAULT_TIMEOUT_MS = 20000;
+const DEFAULT_ENDPOINT = "/tender/SCRZJ";
+
+function parseBoolean(value, fallback = false) {
+  if (!value) {
+    return fallback;
+  }
+
+  const normalized = value.trim().toLowerCase();
+
+  if (["1", "true", "yes", "si"].includes(normalized)) {
+    return true;
+  }
+
+  if (["0", "false", "no"].includes(normalized)) {
+    return false;
+  }
+
+  return fallback;
+}
 
 function loadDotenv(filePath) {
   if (!existsSync(filePath)) {
@@ -40,10 +59,11 @@ function loadDotenv(filePath) {
 function parseArgs(argv) {
   const args = {
     baseUrl: process.env.LICITAYA_BASE_URL,
-    endpoint: process.env.LICITAYA_TEST_ENDPOINT,
+    endpoint: process.env.LICITAYA_TEST_ENDPOINT || DEFAULT_ENDPOINT,
     accept: process.env.LICITAYA_ACCEPT || "application/json",
     method: "GET",
     timeoutMs: Number.parseInt(process.env.LICITAYA_TIMEOUT_MS || "", 10) || DEFAULT_TIMEOUT_MS,
+    allowEmptySearch: parseBoolean(process.env.LICITAYA_ALLOW_EMPTY_SEARCH, true),
   };
 
   for (let i = 0; i < argv.length; i += 1) {
@@ -82,6 +102,11 @@ function parseArgs(argv) {
       i += 1;
       continue;
     }
+
+    if (current === "--allow-empty-search") {
+      args.allowEmptySearch = true;
+      continue;
+    }
   }
 
   return args;
@@ -176,10 +201,17 @@ try {
   console.log("--- Response Preview ---");
   console.log(bodyPreview);
 
-  if (response.status === 404 && url.pathname.endsWith("/tender/search")) {
+  const isEmptySearch404 = response.status === 404 && url.pathname.endsWith("/tender/search");
+
+  if (isEmptySearch404) {
     console.error("No tenders matched the current filters. Try a broader keyword or fewer filters.");
   }
 
+  if (isEmptySearch404 && args.allowEmptySearch) {
+    console.log("Connectivity check passed (search endpoint returned 404 with no matches).");
+    process.exit(0);
+  }
+
   if (!response.ok) {
     process.exit(1);
   }
diff --git a/src/app/api/admin/sync/route.ts b/src/app/api/admin/sync/route.ts
index a3e1888..6d0231b 100644
--- a/src/app/api/admin/sync/route.ts
+++ b/src/app/api/admin/sync/route.ts
@@ -1,5 +1,6 @@
 import { NextResponse } from "next/server";
 import { requireAdminApiUser } from "@/lib/auth/admin";
+import { runPeriodicNormativeVerification } from "@/lib/compliance/regulations";
 import { runDailyLicitationsSync } from "@/lib/licitations/sync";
 
 export const runtime = "nodejs";
@@ -18,6 +19,8 @@ export async function POST(request: Request) {
       skip?: number;
       targetYear?: number;
       includePnt?: boolean;
+      includeLicitaya?: boolean;
+      includeRegulations?: boolean;
       force?: boolean;
     };
 
@@ -26,11 +29,23 @@ export async function POST(request: Request) {
       limit: typeof body.limit === "number" ? body.limit : undefined,
       skip: typeof body.skip === "number" ? body.skip : undefined,
       targetYear: typeof body.targetYear === "number" ? body.targetYear : undefined,
-      includePnt: body.includePnt === true,
-      force: body.force === true,
+      includePnt: typeof body.includePnt === "boolean" ? body.includePnt : undefined,
+      includeLicitaya: typeof body.includeLicitaya === "boolean" ? body.includeLicitaya : undefined,
+      force: typeof body.force === "boolean" ? body.force : undefined,
     });
+    const includeRegulations = body.includeRegulations !== false;
+    let regulations = null;
+    let regulationsError: string | null = null;
 
-    return NextResponse.json({ ok: true, payload });
+    if (includeRegulations) {
+      try {
+        regulations = await runPeriodicNormativeVerification(new Date());
+      } catch (error) {
+        regulationsError = error instanceof Error ? error.message : "No fue posible verificar reglamentos oficiales.";
+      }
+    }
+
+    return NextResponse.json({ ok: true, payload, regulations, regulationsError });
   } catch (error) {
     return NextResponse.json(
       {
diff --git a/src/app/api/ai/suggestions/[id]/decision/route.ts b/src/app/api/ai/suggestions/[id]/decision/route.ts
new file mode 100644
index 0000000..7a95e0a
--- /dev/null
+++ b/src/app/api/ai/suggestions/[id]/decision/route.ts
@@ -0,0 +1,35 @@
+import { NextResponse } from "next/server";
+import { getSessionPayload } from "@/lib/auth/session";
+import { applyAiSuggestionDecision } from "@/lib/ai/suggestions";
+
+type RouteContext = {
+  params: Promise<{ id: string }>;
+};
+
+function parseDecision(value: unknown) {
+  return value === "accept" || value === "dismiss" ? value : null;
+}
+
+export async function POST(request: Request, context: RouteContext) {
+  const session = await getSessionPayload();
+
+  if (!session) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { id } = await context.params;
+  const body = (await request.json().catch(() => ({}))) as Record<string, unknown>;
+  const decision = parseDecision(body.decision);
+
+  if (!id || !decision) {
+    return NextResponse.json({ error: "Decision invalida." }, { status: 400 });
+  }
+
+  const updated = await applyAiSuggestionDecision(session.userId, id, decision);
+
+  if (!updated) {
+    return NextResponse.json({ error: "Sugerencia no encontrada." }, { status: 404 });
+  }
+
+  return NextResponse.json({ ok: true, suggestion: updated });
+}
diff --git a/src/app/api/audits/ai/findings/route.ts b/src/app/api/audits/ai/findings/route.ts
new file mode 100644
index 0000000..3db51a3
--- /dev/null
+++ b/src/app/api/audits/ai/findings/route.ts
@@ -0,0 +1,188 @@
+import { z } from "zod";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { callOpenAiJsonSchema } from "@/lib/ai/openai";
+import { storeAiSuggestionFromEnvelope } from "@/lib/ai/suggestions";
+import { buildInstitutionalDossier, getAuditSimulationDetail, getLatestInstitutionalDossierSnapshot, listAuditSimulationsForUser } from "@/lib/audits/server";
+
+const M10_PROMPT_VERSION = "m10_findings_v1";
+
+const M10FindingsSchema = z.object({
+  auditorLikelyFindings: z
+    .array(
+      z.object({
+        area: z.string().min(4).max(120),
+        finding: z.string().min(8).max(500),
+        severity: z.enum(["alto", "medio", "bajo"]),
+      }),
+    )
+    .max(20),
+  missingEvidence: z.array(z.string().min(6).max(280)).max(20),
+  topRisks: z.array(z.string().min(6).max(280)).max(12),
+  remediationPlan: z
+    .array(
+      z.object({
+        step: z.string().min(8).max(420),
+        priority: z.enum(["alta", "media", "baja"]),
+        ownerSuggestion: z.string().min(3).max(120),
+        targetDate: z.string().min(4).max(40),
+      }),
+    )
+    .max(20),
+  confidence: z.enum(["low", "medium", "high"]),
+});
+
+const M10FindingsJsonSchema = {
+  type: "object",
+  additionalProperties: false,
+  required: ["auditorLikelyFindings", "missingEvidence", "topRisks", "remediationPlan", "confidence"],
+  properties: {
+    auditorLikelyFindings: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["area", "finding", "severity"],
+        properties: {
+          area: { type: "string" },
+          finding: { type: "string" },
+          severity: { type: "string", enum: ["alto", "medio", "bajo"] },
+        },
+      },
+    },
+    missingEvidence: {
+      type: "array",
+      items: { type: "string" },
+    },
+    topRisks: {
+      type: "array",
+      items: { type: "string" },
+    },
+    remediationPlan: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["step", "priority", "ownerSuggestion", "targetDate"],
+        properties: {
+          step: { type: "string" },
+          priority: { type: "string", enum: ["alta", "media", "baja"] },
+          ownerSuggestion: { type: "string" },
+          targetDate: { type: "string" },
+        },
+      },
+    },
+    confidence: { type: "string", enum: ["low", "medium", "high"] },
+  },
+} as const;
+
+function parseString(value: unknown) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+async function resolveSimulation(userId: string, simulationId: string) {
+  if (simulationId) {
+    return getAuditSimulationDetail(userId, simulationId);
+  }
+
+  const simulations = await listAuditSimulationsForUser(userId);
+  return simulations.find((simulation) => simulation.status === "COMPLETED") ?? simulations[0] ?? null;
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const body = (await request.json().catch(() => ({}))) as Record<string, unknown>;
+  const simulationId = parseString(body.simulationId);
+  const simulation = await resolveSimulation(user.id, simulationId);
+
+  if (!simulation) {
+    return NextResponse.json({ error: "No hay simulaciones disponibles para generar dictamen IA." }, { status: 400 });
+  }
+
+  const latestDossier = await getLatestInstitutionalDossierSnapshot(user.id);
+  const dossier = latestDossier?.payload ?? (await buildInstitutionalDossier(user.id));
+
+  const condensedContext = {
+    simulation: {
+      id: simulation.id,
+      name: simulation.name,
+      auditType: simulation.auditType,
+      status: simulation.status,
+      overallScore: simulation.overallScore,
+      completedAt: simulation.completedAt,
+      sections: simulation.sections,
+    },
+    dossier: {
+      generatedAt: dossier.generatedAt,
+      summary: dossier.summary,
+      components: dossier.components,
+    },
+  };
+
+  const systemPrompt = [
+    "Eres auditor preventivo especializado en contratacion publica y cumplimiento documental en Mexico.",
+    "Simula hallazgos probables de una revision formal sin modificar resultados deterministas existentes.",
+    "Debes responder solo JSON valido en espanol.",
+  ].join(" ");
+
+  const userPrompt = [
+    "Contexto actual de simulacion y expediente institucional:",
+    JSON.stringify(condensedContext),
+    "",
+    "Genera:",
+    "- auditorLikelyFindings: hallazgos probables por area y severidad.",
+    "- missingEvidence: evidencia concreta faltante.",
+    "- topRisks: riesgos principales priorizados.",
+    "- remediationPlan: plan de remediacion con prioridad, responsable sugerido y fecha objetivo.",
+  ].join("\n");
+
+  const envelope = await callOpenAiJsonSchema({
+    promptVersion: M10_PROMPT_VERSION,
+    systemPrompt,
+    userPrompt,
+    outputSchema: M10FindingsSchema,
+    schemaName: "m10_audit_findings",
+    jsonSchema: M10FindingsJsonSchema as unknown as Record<string, unknown>,
+    model: process.env.OPENAI_M10_MODEL?.trim() || undefined,
+  });
+
+  const payload =
+    envelope.data ??
+    ({
+      auditorLikelyFindings: [],
+      missingEvidence: [],
+      topRisks: [],
+      remediationPlan: [],
+      confidence: envelope.confidence ?? "low",
+    } satisfies z.infer<typeof M10FindingsSchema>);
+
+  const persisted = await storeAiSuggestionFromEnvelope({
+    userId: user.id,
+    moduleKey: "M10",
+    featureKey: "audit_findings",
+    subjectType: "audit_simulation",
+    subjectId: simulation.id,
+    inputForHash: condensedContext,
+    envelope,
+    responsePayload: payload,
+  });
+
+  return NextResponse.json({
+    ok: true,
+    simulationId: simulation.id,
+    ...payload,
+    suggestionId: persisted.suggestionId,
+    meta: {
+      engine: envelope.engine,
+      model: envelope.model,
+      usage: envelope.usage,
+      warnings: envelope.warnings,
+      confidence: envelope.confidence,
+    },
+  });
+}
diff --git a/src/app/api/audits/expediente/refresh/route.ts b/src/app/api/audits/expediente/refresh/route.ts
new file mode 100644
index 0000000..03f7683
--- /dev/null
+++ b/src/app/api/audits/expediente/refresh/route.ts
@@ -0,0 +1,21 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { refreshInstitutionalDossierSnapshot } from "@/lib/audits/server";
+
+export async function POST() {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const snapshot = await refreshInstitutionalDossierSnapshot(user.id);
+
+  return NextResponse.json({
+    ok: true,
+    snapshotId: snapshot.id,
+    generatedAt: snapshot.generatedAt,
+    dossier: snapshot.payload,
+    freshness: snapshot.freshness,
+  });
+}
diff --git a/src/app/api/audits/expediente/route.ts b/src/app/api/audits/expediente/route.ts
new file mode 100644
index 0000000..251faad
--- /dev/null
+++ b/src/app/api/audits/expediente/route.ts
@@ -0,0 +1,25 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { getInstitutionalDossierForUser } from "@/lib/audits/server";
+
+function parseStrategy(value: string | null) {
+  return value === "snapshot" ? "snapshot" : "live";
+}
+
+export async function GET(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { searchParams } = new URL(request.url);
+  const strategy = parseStrategy(searchParams.get("strategy"));
+  const resolved = await getInstitutionalDossierForUser(user.id, strategy);
+
+  return NextResponse.json({
+    ok: true,
+    dossier: resolved.dossier,
+    freshness: resolved.freshness,
+  });
+}
diff --git a/src/app/api/audits/simulations/[id]/route.ts b/src/app/api/audits/simulations/[id]/route.ts
new file mode 100644
index 0000000..304736c
--- /dev/null
+++ b/src/app/api/audits/simulations/[id]/route.ts
@@ -0,0 +1,24 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { getAuditSimulationDetail } from "@/lib/audits/server";
+
+type RouteContext = {
+  params: Promise<{ id: string }>;
+};
+
+export async function GET(_request: Request, context: RouteContext) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { id } = await context.params;
+  const simulation = await getAuditSimulationDetail(user.id, id);
+
+  if (!simulation) {
+    return NextResponse.json({ error: "Simulacion no encontrada." }, { status: 404 });
+  }
+
+  return NextResponse.json({ ok: true, simulation });
+}
diff --git a/src/app/api/audits/simulations/[id]/score/route.ts b/src/app/api/audits/simulations/[id]/score/route.ts
new file mode 100644
index 0000000..8deaa02
--- /dev/null
+++ b/src/app/api/audits/simulations/[id]/score/route.ts
@@ -0,0 +1,36 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { AuditSimulationScoreInputSchema } from "@/lib/audits/types";
+import { scoreAuditSimulationForUser } from "@/lib/audits/server";
+
+type RouteContext = {
+  params: Promise<{ id: string }>;
+};
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+export async function POST(request: Request, context: RouteContext) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { id } = await context.params;
+  const body = parseJsonBody(await request.json().catch(() => ({})));
+  const parsed = AuditSimulationScoreInputSchema.safeParse(body);
+
+  if (!parsed.success) {
+    return NextResponse.json({ error: "Payload de scoring invalido." }, { status: 400 });
+  }
+
+  const simulation = await scoreAuditSimulationForUser(user.id, id, parsed.data);
+
+  if (!simulation) {
+    return NextResponse.json({ error: "Simulacion no encontrada." }, { status: 404 });
+  }
+
+  return NextResponse.json({ ok: true, simulation });
+}
diff --git a/src/app/api/audits/simulations/route.ts b/src/app/api/audits/simulations/route.ts
new file mode 100644
index 0000000..50063e3
--- /dev/null
+++ b/src/app/api/audits/simulations/route.ts
@@ -0,0 +1,39 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import {
+  AuditSimulationCreateInputSchema,
+} from "@/lib/audits/types";
+import { createAuditSimulationForUser, getAuditKpisForUser, listAuditSimulationsForUser } from "@/lib/audits/server";
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+export async function GET() {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const [simulations, kpis] = await Promise.all([listAuditSimulationsForUser(user.id), getAuditKpisForUser(user.id)]);
+  return NextResponse.json({ ok: true, simulations, kpis });
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const body = parseJsonBody(await request.json().catch(() => ({})));
+  const parsed = AuditSimulationCreateInputSchema.safeParse(body);
+
+  if (!parsed.success) {
+    return NextResponse.json({ error: "Datos de simulacion invalidos." }, { status: 400 });
+  }
+
+  const simulation = await createAuditSimulationForUser(user.id, parsed.data);
+  return NextResponse.json({ ok: true, simulation });
+}
diff --git a/src/app/api/compliance/m7/ai/playbook/route.ts b/src/app/api/compliance/m7/ai/playbook/route.ts
new file mode 100644
index 0000000..7470999
--- /dev/null
+++ b/src/app/api/compliance/m7/ai/playbook/route.ts
@@ -0,0 +1,169 @@
+import { z } from "zod";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { callOpenAiJsonSchema } from "@/lib/ai/openai";
+import { storeAiSuggestionFromEnvelope } from "@/lib/ai/suggestions";
+import { getM7DatasetForUser } from "@/lib/compliance/server";
+import type { M7Dataset } from "@/lib/compliance/types";
+
+const M7_PROMPT_VERSION = "m7_playbook_v1";
+
+const M7PlaybookSchema = z.object({
+  predictedIncidents: z
+    .array(
+      z.object({
+        title: z.string().min(8).max(220),
+        likelihood: z.enum(["alta", "media", "baja"]),
+        impact: z.enum(["alto", "medio", "bajo"]),
+        timeHorizon: z.string().min(4).max(80),
+      }),
+    )
+    .max(12),
+  priorityOrder: z.array(z.string().min(8).max(220)).max(12),
+  preventiveActions: z
+    .array(
+      z.object({
+        action: z.string().min(8).max(400),
+        ownerSuggestion: z.string().min(3).max(120),
+        targetDate: z.string().min(4).max(40),
+      }),
+    )
+    .max(20),
+  escalationAdvice: z.array(z.string().min(8).max(420)).max(8),
+  confidence: z.enum(["low", "medium", "high"]),
+});
+
+const M7PlaybookJsonSchema = {
+  type: "object",
+  additionalProperties: false,
+  required: ["predictedIncidents", "priorityOrder", "preventiveActions", "escalationAdvice", "confidence"],
+  properties: {
+    predictedIncidents: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["title", "likelihood", "impact", "timeHorizon"],
+        properties: {
+          title: { type: "string" },
+          likelihood: { type: "string", enum: ["alta", "media", "baja"] },
+          impact: { type: "string", enum: ["alto", "medio", "bajo"] },
+          timeHorizon: { type: "string" },
+        },
+      },
+    },
+    priorityOrder: {
+      type: "array",
+      items: { type: "string" },
+    },
+    preventiveActions: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["action", "ownerSuggestion", "targetDate"],
+        properties: {
+          action: { type: "string" },
+          ownerSuggestion: { type: "string" },
+          targetDate: { type: "string" },
+        },
+      },
+    },
+    escalationAdvice: {
+      type: "array",
+      items: { type: "string" },
+    },
+    confidence: { type: "string", enum: ["low", "medium", "high"] },
+  },
+} as const;
+
+function parseDataset(value: unknown): M7Dataset | null {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+
+  return value as M7Dataset;
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const body = (await request.json().catch(() => ({}))) as Record<string, unknown>;
+  const providedDataset = parseDataset(body.dataset);
+  const dataset = providedDataset ?? (await getM7DatasetForUser(user.id));
+
+  const condensedDataset = {
+    generatedAt: dataset.generatedAt,
+    kpis: dataset.kpis,
+    m3States: dataset.m3States,
+    deadlines: dataset.tabs.plazos.slice(0, 25),
+    alerts: dataset.tabs.alertas.slice(0, 40),
+    checklist: dataset.tabs.checklist.slice(0, 25),
+  };
+
+  const systemPrompt = [
+    "Eres un especialista en cumplimiento para contratacion publica en Mexico.",
+    "Construye un playbook preventivo con enfoque operativo para los proximos 30 dias.",
+    "No cambies severidades ni estados existentes: solo sugiere acciones.",
+    "Responde solo JSON valido en espanol.",
+  ].join(" ");
+
+  const userPrompt = [
+    "Dataset actual de M7:",
+    JSON.stringify(condensedDataset),
+    "",
+    "Genera:",
+    "- predictedIncidents: incidentes probables (sin inventar datos externos).",
+    "- priorityOrder: orden de atencion recomendado.",
+    "- preventiveActions: acciones con ownerSuggestion y targetDate.",
+    "- escalationAdvice: criterios breves para escalar a legal/direccion.",
+  ].join("\n");
+
+  const envelope = await callOpenAiJsonSchema({
+    promptVersion: M7_PROMPT_VERSION,
+    systemPrompt,
+    userPrompt,
+    outputSchema: M7PlaybookSchema,
+    schemaName: "m7_playbook",
+    jsonSchema: M7PlaybookJsonSchema as unknown as Record<string, unknown>,
+    model: process.env.OPENAI_M7_MODEL?.trim() || undefined,
+  });
+
+  const payload =
+    envelope.data ??
+    ({
+      predictedIncidents: [],
+      priorityOrder: [],
+      preventiveActions: [],
+      escalationAdvice: [],
+      confidence: envelope.confidence ?? "low",
+    } satisfies z.infer<typeof M7PlaybookSchema>);
+
+  const persisted = await storeAiSuggestionFromEnvelope({
+    userId: user.id,
+    moduleKey: "M7",
+    featureKey: "compliance_playbook",
+    subjectType: "m7_dataset",
+    subjectId: dataset.generatedAt,
+    inputForHash: condensedDataset,
+    envelope,
+    responsePayload: payload,
+  });
+
+  return NextResponse.json({
+    ok: true,
+    ...payload,
+    suggestionId: persisted.suggestionId,
+    meta: {
+      engine: envelope.engine,
+      model: envelope.model,
+      usage: envelope.usage,
+      warnings: envelope.warnings,
+      confidence: envelope.confidence,
+    },
+  });
+}
diff --git a/src/app/api/compliance/m7/route.ts b/src/app/api/compliance/m7/route.ts
new file mode 100644
index 0000000..8f8d00a
--- /dev/null
+++ b/src/app/api/compliance/m7/route.ts
@@ -0,0 +1,14 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { getM7DatasetForUser } from "@/lib/compliance/server";
+
+export async function GET() {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const dataset = await getM7DatasetForUser(user.id);
+  return NextResponse.json({ ok: true, dataset });
+}
diff --git a/src/app/api/contracts/[id]/deliverables/route.ts b/src/app/api/contracts/[id]/deliverables/route.ts
new file mode 100644
index 0000000..8484778
--- /dev/null
+++ b/src/app/api/contracts/[id]/deliverables/route.ts
@@ -0,0 +1,75 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { DeliverableCreateInputSchema } from "@/lib/contracts/types";
+
+type RouteContext = {
+  params: Promise<{ id: string }>;
+};
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+export async function POST(request: Request, context: RouteContext) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { id: contractId } = await context.params;
+
+  try {
+    const body = parseJsonBody(await request.json().catch(() => ({})));
+    const parsed = DeliverableCreateInputSchema.safeParse(body);
+
+    if (!parsed.success) {
+      return NextResponse.json({ error: "Datos de entregable invalidos." }, { status: 400 });
+    }
+
+    const contract = await prisma.contractRecord.findFirst({
+      where: {
+        id: contractId,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+      },
+    });
+
+    if (!contract) {
+      return NextResponse.json({ error: "Contrato no encontrado." }, { status: 404 });
+    }
+
+    const input = parsed.data;
+
+    const deliverable = await prisma.contractDeliverable.create({
+      data: {
+        contractId,
+        title: input.title,
+        dueDate: input.dueDate ? new Date(input.dueDate) : null,
+        amountLinked: input.amountLinked ?? null,
+        notes: input.notes ?? "",
+        status: "PENDING",
+      },
+    });
+
+    return NextResponse.json({
+      ok: true,
+      deliverable: {
+        id: deliverable.id,
+        contractId: deliverable.contractId,
+        title: deliverable.title,
+        dueDate: deliverable.dueDate ? deliverable.dueDate.toISOString() : null,
+        amountLinked: deliverable.amountLinked ? Number(deliverable.amountLinked) : null,
+        status: deliverable.status,
+        deliveredAt: deliverable.deliveredAt ? deliverable.deliveredAt.toISOString() : null,
+        approvedAt: deliverable.approvedAt ? deliverable.approvedAt.toISOString() : null,
+        notes: deliverable.notes,
+      },
+    });
+  } catch {
+    return NextResponse.json({ error: "No fue posible crear el entregable." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/contracts/[id]/documents/[documentId]/route.test.ts b/src/app/api/contracts/[id]/documents/[documentId]/route.test.ts
new file mode 100644
index 0000000..edc2a6c
--- /dev/null
+++ b/src/app/api/contracts/[id]/documents/[documentId]/route.test.ts
@@ -0,0 +1,68 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const { requireAdminApiUserMock, readStoredContractDocumentFileMock, prismaMock } = vi.hoisted(() => ({
+  requireAdminApiUserMock: vi.fn(),
+  readStoredContractDocumentFileMock: vi.fn(),
+  prismaMock: {
+    contractDocument: {
+      findFirst: vi.fn(),
+      delete: vi.fn(),
+    },
+  },
+}));
+
+vi.mock("@/lib/auth/admin", () => ({
+  requireAdminApiUser: requireAdminApiUserMock,
+}));
+
+vi.mock("@/lib/contracts/storage", async () => {
+  const actual = await vi.importActual<typeof import("@/lib/contracts/storage")>("@/lib/contracts/storage");
+  return {
+    ...actual,
+    readStoredContractDocumentFile: readStoredContractDocumentFileMock,
+  };
+});
+
+vi.mock("@/lib/prisma", () => ({
+  prisma: prismaMock,
+}));
+
+import { GET } from "@/app/api/contracts/[id]/documents/[documentId]/route";
+
+describe("contract document download API security", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("returns 404 for non-owned or missing contract document", async () => {
+    requireAdminApiUserMock.mockResolvedValue({ id: "user-1" });
+    prismaMock.contractDocument.findFirst.mockResolvedValue(null);
+
+    const response = await GET(new Request("http://localhost/api/contracts/c1/documents/d1"), {
+      params: Promise.resolve({ id: "c1", documentId: "d1" }),
+    });
+    const payload = (await response.json()) as { error?: string };
+
+    expect(response.status).toBe(404);
+    expect(payload.error).toContain("Documento no encontrado");
+    expect(readStoredContractDocumentFileMock).not.toHaveBeenCalled();
+  });
+
+  it("returns 400 when contract storage path is invalid", async () => {
+    requireAdminApiUserMock.mockResolvedValue({ id: "user-1" });
+    prismaMock.contractDocument.findFirst.mockResolvedValue({
+      fileName: "contrato.pdf",
+      filePath: "../../escape.pdf",
+      mimeType: "application/pdf",
+    });
+    readStoredContractDocumentFileMock.mockRejectedValue(new Error("CONTRACT_DOCUMENT_INVALID_PATH"));
+
+    const response = await GET(new Request("http://localhost/api/contracts/c1/documents/d1"), {
+      params: Promise.resolve({ id: "c1", documentId: "d1" }),
+    });
+    const payload = (await response.json()) as { error?: string };
+
+    expect(response.status).toBe(400);
+    expect(payload.error).toContain("Ruta de almacenamiento invalida");
+  });
+});
diff --git a/src/app/api/contracts/[id]/documents/[documentId]/route.ts b/src/app/api/contracts/[id]/documents/[documentId]/route.ts
new file mode 100644
index 0000000..235d635
--- /dev/null
+++ b/src/app/api/contracts/[id]/documents/[documentId]/route.ts
@@ -0,0 +1,150 @@
+import { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { readStoredContractDocumentFile, removeStoredContractDocumentFile } from "@/lib/contracts/storage";
+
+export const runtime = "nodejs";
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+function safeContentDispositionFilename(value: string) {
+  const normalized = value.trim().replace(/[\r\n"]/g, "_");
+  return normalized || "contrato-documento";
+}
+
+function mapDocumentReadError(error: unknown) {
+  if (!(error instanceof Error)) {
+    return null;
+  }
+
+  if (error.message === "CONTRACT_DOCUMENT_NOT_FOUND") {
+    return { status: 404, message: "Archivo no encontrado en almacenamiento." };
+  }
+
+  if (error.message === "CONTRACT_DOCUMENT_INVALID_PATH") {
+    return { status: 400, message: "Ruta de almacenamiento invalida." };
+  }
+
+  if (error.message === "CONTRACT_DOCUMENT_EMPTY") {
+    return { status: 400, message: "Archivo vacio en almacenamiento." };
+  }
+
+  if (error.message === "CONTRACT_DOCUMENT_TOO_LARGE") {
+    return { status: 400, message: "Archivo excede el limite permitido." };
+  }
+
+  return null;
+}
+
+export async function GET(_: Request, context: { params: Promise<{ id: string; documentId: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id, documentId } = await context.params;
+
+    const document = await prisma.contractDocument.findFirst({
+      where: {
+        id: documentId,
+        contractId: id,
+        contract: {
+          userId: user.id,
+        },
+      },
+      select: {
+        fileName: true,
+        filePath: true,
+        mimeType: true,
+      },
+    });
+
+    if (!document) {
+      return NextResponse.json({ error: "Documento no encontrado." }, { status: 404 });
+    }
+
+    let fileBuffer: Buffer;
+    try {
+      fileBuffer = await readStoredContractDocumentFile(document.filePath);
+    } catch (error) {
+      const mapped = mapDocumentReadError(error);
+      if (mapped) {
+        return NextResponse.json({ error: mapped.message }, { status: mapped.status });
+      }
+
+      throw error;
+    }
+
+    const encodedFilename = encodeURIComponent(document.fileName);
+    return new NextResponse(new Uint8Array(fileBuffer), {
+      status: 200,
+      headers: {
+        "Content-Type": document.mimeType || "application/octet-stream",
+        "Content-Disposition": `attachment; filename="${safeContentDispositionFilename(document.fileName)}"; filename*=UTF-8''${encodedFilename}`,
+        "Cache-Control": "no-store",
+      },
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Gestion Estrategica de Contratos. Ejecuta prisma migrate." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible descargar el documento." }, { status: 400 });
+  }
+}
+
+export async function DELETE(_: Request, context: { params: Promise<{ id: string; documentId: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id, documentId } = await context.params;
+
+    const document = await prisma.contractDocument.findFirst({
+      where: {
+        id: documentId,
+        contractId: id,
+        contract: {
+          userId: user.id,
+        },
+      },
+      select: {
+        id: true,
+        filePath: true,
+      },
+    });
+
+    if (!document) {
+      return NextResponse.json({ error: "Documento no encontrado." }, { status: 404 });
+    }
+
+    await removeStoredContractDocumentFile(document.filePath);
+    await prisma.contractDocument.delete({
+      where: {
+        id: document.id,
+      },
+    });
+
+    return NextResponse.json({ ok: true });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Gestion Estrategica de Contratos. Ejecuta prisma migrate." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible eliminar el documento." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/contracts/[id]/payments/route.ts b/src/app/api/contracts/[id]/payments/route.ts
new file mode 100644
index 0000000..496cd00
--- /dev/null
+++ b/src/app/api/contracts/[id]/payments/route.ts
@@ -0,0 +1,116 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { PaymentCreateInputSchema } from "@/lib/contracts/types";
+
+type RouteContext = {
+  params: Promise<{ id: string }>;
+};
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+export async function GET(_request: Request, context: RouteContext) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { id: contractId } = await context.params;
+
+  const contract = await prisma.contractRecord.findFirst({
+    where: {
+      id: contractId,
+      userId: user.id,
+    },
+    select: { id: true },
+  });
+
+  if (!contract) {
+    return NextResponse.json({ error: "Contrato no encontrado." }, { status: 404 });
+  }
+
+  const payments = await prisma.contractPayment.findMany({
+    where: {
+      contractId,
+    },
+    orderBy: [{ paymentDate: "desc" }, { createdAt: "desc" }],
+  });
+
+  return NextResponse.json({
+    ok: true,
+    payments: payments.map((item) => ({
+      id: item.id,
+      contractId: item.contractId,
+      amount: Number(item.amount),
+      paymentDate: item.paymentDate.toISOString(),
+      invoiceNumber: item.invoiceNumber,
+      concept: item.concept,
+      status: item.status,
+      createdAt: item.createdAt.toISOString(),
+      updatedAt: item.updatedAt.toISOString(),
+    })),
+  });
+}
+
+export async function POST(request: Request, context: RouteContext) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { id: contractId } = await context.params;
+
+  try {
+    const body = parseJsonBody(await request.json().catch(() => ({})));
+    const parsed = PaymentCreateInputSchema.safeParse(body);
+
+    if (!parsed.success) {
+      return NextResponse.json({ error: "Datos de pago invalidos." }, { status: 400 });
+    }
+
+    const contract = await prisma.contractRecord.findFirst({
+      where: {
+        id: contractId,
+        userId: user.id,
+      },
+      select: { id: true },
+    });
+
+    if (!contract) {
+      return NextResponse.json({ error: "Contrato no encontrado." }, { status: 404 });
+    }
+
+    const input = parsed.data;
+    const payment = await prisma.contractPayment.create({
+      data: {
+        contractId,
+        amount: input.amount,
+        paymentDate: new Date(input.paymentDate),
+        invoiceNumber: input.invoiceNumber ?? null,
+        concept: input.concept,
+        status: input.status ?? "REGISTERED",
+      },
+    });
+
+    return NextResponse.json({
+      ok: true,
+      payment: {
+        id: payment.id,
+        contractId: payment.contractId,
+        amount: Number(payment.amount),
+        paymentDate: payment.paymentDate.toISOString(),
+        invoiceNumber: payment.invoiceNumber,
+        concept: payment.concept,
+        status: payment.status,
+        createdAt: payment.createdAt.toISOString(),
+        updatedAt: payment.updatedAt.toISOString(),
+      },
+    });
+  } catch {
+    return NextResponse.json({ error: "No fue posible registrar el pago." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/contracts/[id]/route.ts b/src/app/api/contracts/[id]/route.ts
new file mode 100644
index 0000000..f3c3e5a
--- /dev/null
+++ b/src/app/api/contracts/[id]/route.ts
@@ -0,0 +1,70 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { ContractUpdateInputSchema } from "@/lib/contracts/types";
+import { listContractsForUser } from "@/lib/contracts/server";
+
+type RouteContext = {
+  params: Promise<{ id: string }>;
+};
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+export async function PATCH(request: Request, context: RouteContext) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { id } = await context.params;
+
+  try {
+    const body = parseJsonBody(await request.json().catch(() => ({})));
+    const parsed = ContractUpdateInputSchema.safeParse(body);
+
+    if (!parsed.success) {
+      return NextResponse.json({ error: "Datos de actualizacion invalidos." }, { status: 400 });
+    }
+
+    const current = await prisma.contractRecord.findFirst({
+      where: {
+        id,
+        userId: user.id,
+      },
+      select: { id: true },
+    });
+
+    if (!current) {
+      return NextResponse.json({ error: "Contrato no encontrado." }, { status: 404 });
+    }
+
+    const input = parsed.data;
+
+    await prisma.contractRecord.update({
+      where: { id },
+      data: {
+        title: input.title,
+        counterpartyEntity: input.counterpartyEntity,
+        contractNumber: input.contractNumber === undefined ? undefined : input.contractNumber ?? null,
+        contractType: input.contractType,
+        startDate: input.startDate === undefined ? undefined : input.startDate ? new Date(input.startDate) : null,
+        endDate: input.endDate === undefined ? undefined : input.endDate ? new Date(input.endDate) : null,
+        totalAmount: input.totalAmount === undefined ? undefined : input.totalAmount ?? null,
+        currency: input.currency ? input.currency.toUpperCase() : undefined,
+        status: input.status,
+        description: input.description,
+        sourceProposalId: input.sourceProposalId === undefined ? undefined : input.sourceProposalId ?? null,
+      },
+    });
+
+    const contracts = await listContractsForUser(user.id, { q: id });
+    const contract = contracts.find((item) => item.id === id) ?? null;
+
+    return NextResponse.json({ ok: true, contract });
+  } catch {
+    return NextResponse.json({ error: "No fue posible actualizar el contrato." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/contracts/extract/route.ts b/src/app/api/contracts/extract/route.ts
new file mode 100644
index 0000000..1480425
--- /dev/null
+++ b/src/app/api/contracts/extract/route.ts
@@ -0,0 +1,297 @@
+import { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { analyzePdf } from "@/lib/pdf/analyzePdf";
+import { prisma } from "@/lib/prisma";
+import { contractCreateInputFromExtraction } from "@/lib/contracts/server";
+import { extractContractWithAi } from "@/lib/contracts/extraction";
+import { MAX_CONTRACT_PDF_BYTES, storeContractDocumentFile } from "@/lib/contracts/storage";
+import {
+  ensureProposalPdfLinkedToContract,
+  getLatestProposalPdfSourceForUser,
+} from "@/lib/contracts/proposal-continuity";
+
+export const runtime = "nodejs";
+
+function isPdfFile(file: File) {
+  return file.type === "application/pdf" || file.name.toLowerCase().endsWith(".pdf");
+}
+
+function removePdfExtension(fileName: string) {
+  return fileName.replace(/\.pdf$/i, "").trim();
+}
+
+function logContinuityHandoff(event: string, data: Record<string, unknown>) {
+  console.info(
+    "[continuity_handoff]",
+    JSON.stringify({
+      event,
+      at: new Date().toISOString(),
+      ...data,
+    }),
+  );
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const formData = await request.formData();
+  const contractIdRaw = formData.get("contractId");
+  const contractId = typeof contractIdRaw === "string" ? contractIdRaw.trim() : "";
+  const sourceProposalIdRaw = formData.get("sourceProposalId");
+  const sourceProposalId = typeof sourceProposalIdRaw === "string" ? sourceProposalIdRaw.trim() : "";
+  const fileValue = formData.get("file");
+  const uploadedFile = fileValue instanceof File ? fileValue : null;
+
+  logContinuityHandoff("m5_to_m8_extract_requested", {
+    userId: user.id,
+    contractId: contractId || null,
+    sourceProposalId: sourceProposalId || null,
+    hasUploadedFile: Boolean(uploadedFile),
+  });
+
+  let sourceProposalLookup: Awaited<ReturnType<typeof getLatestProposalPdfSourceForUser>> | null = null;
+  let resolvedSourceProposalId: string | null = null;
+  if (sourceProposalId) {
+    try {
+      sourceProposalLookup = await getLatestProposalPdfSourceForUser(user.id, sourceProposalId);
+    } catch {
+      return NextResponse.json({ error: "No fue posible leer el PDF de la propuesta fuente." }, { status: 400 });
+    }
+
+    if (sourceProposalLookup.status === "proposal_not_found") {
+      return NextResponse.json({ error: "Propuesta fuente no encontrada." }, { status: 404 });
+    }
+
+    resolvedSourceProposalId = sourceProposalId;
+    logContinuityHandoff("m5_to_m8_source_proposal_resolved", {
+      userId: user.id,
+      sourceProposalId: resolvedSourceProposalId,
+      lookupStatus: sourceProposalLookup.status,
+    });
+  }
+
+  let fileName = "";
+  let mimeType = "application/pdf";
+  let fileBuffer: Buffer;
+
+  if (uploadedFile) {
+    if (uploadedFile.size <= 0) {
+      return NextResponse.json({ error: "El archivo esta vacio." }, { status: 400 });
+    }
+
+    if (uploadedFile.size > MAX_CONTRACT_PDF_BYTES) {
+      return NextResponse.json({ error: "El archivo excede el limite de 20MB." }, { status: 400 });
+    }
+
+    if (!isPdfFile(uploadedFile)) {
+      return NextResponse.json({ error: "Solo se permite PDF en extraccion de contrato." }, { status: 400 });
+    }
+
+    fileName = uploadedFile.name;
+    mimeType = uploadedFile.type || "application/pdf";
+    fileBuffer = Buffer.from(await uploadedFile.arrayBuffer());
+  } else {
+    if (!sourceProposalLookup) {
+      return NextResponse.json({ error: "Debes adjuntar un contrato PDF o seleccionar una propuesta de Modulo 5." }, { status: 400 });
+    }
+
+    if (sourceProposalLookup.status !== "ok") {
+      return NextResponse.json({ error: "La propuesta fuente no tiene un PDF disponible para reutilizar." }, { status: 400 });
+    }
+
+    fileName = sourceProposalLookup.source.document.fileName;
+    mimeType = sourceProposalLookup.source.document.mimeType;
+    fileBuffer = sourceProposalLookup.source.fileBuffer;
+  }
+
+  const analyzed = await analyzePdf(fileBuffer);
+  const extraction = await extractContractWithAi(analyzed.text);
+
+  let contract = null as { id: string } | null;
+
+  if (contractId) {
+    const existing = await prisma.contractRecord.findFirst({
+      where: {
+        id: contractId,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+      },
+    });
+
+    if (!existing) {
+      return NextResponse.json({ error: "Contrato no encontrado." }, { status: 404 });
+    }
+
+    const base = contractCreateInputFromExtraction({
+      extraction,
+      fallbackTitle: removePdfExtension(fileName) || "Contrato sin titulo",
+    });
+
+    await prisma.contractRecord.update({
+      where: {
+        id: existing.id,
+      },
+      data: {
+        title: extraction.fields.title ? base.title : undefined,
+        counterpartyEntity: extraction.fields.counterpartyEntity ? base.counterpartyEntity : undefined,
+        contractNumber: extraction.fields.contractNumber === null ? undefined : base.contractNumber,
+        contractType: extraction.fields.contractType ? base.contractType : undefined,
+        startDate: extraction.fields.startDate ? new Date(extraction.fields.startDate) : undefined,
+        endDate: extraction.fields.endDate ? new Date(extraction.fields.endDate) : undefined,
+        totalAmount: extraction.fields.totalAmount === null ? undefined : base.totalAmount,
+        currency: base.currency,
+        description: extraction.fields.description ? base.description : undefined,
+        sourceProposalId: resolvedSourceProposalId ?? undefined,
+      },
+    });
+
+    contract = existing;
+  } else {
+    const base = contractCreateInputFromExtraction({
+      extraction,
+      fallbackTitle: removePdfExtension(fileName) || "Contrato sin titulo",
+    });
+
+    contract = await prisma.contractRecord.create({
+      data: {
+        userId: user.id,
+        sourceProposalId: resolvedSourceProposalId,
+        title: base.title,
+        counterpartyEntity: base.counterpartyEntity,
+        contractNumber: base.contractNumber,
+        contractType: base.contractType,
+        startDate: base.startDate ? new Date(base.startDate) : null,
+        endDate: base.endDate ? new Date(base.endDate) : null,
+        totalAmount: base.totalAmount,
+        currency: base.currency,
+        status: base.status,
+        description: base.description,
+      },
+      select: {
+        id: true,
+      },
+    });
+  }
+
+  const targetContractId = contract.id;
+  logContinuityHandoff("m5_to_m8_contract_target_resolved", {
+    userId: user.id,
+    targetContractId,
+    sourceProposalId: resolvedSourceProposalId,
+    mode: contractId ? "update" : "create",
+  });
+
+  const [deliverableCount, paymentCount] = await Promise.all([
+    prisma.contractDeliverable.count({
+      where: {
+        contractId: targetContractId,
+      },
+    }),
+    prisma.contractPayment.count({
+      where: {
+        contractId: targetContractId,
+      },
+    }),
+  ]);
+
+  if (deliverableCount === 0 && extraction.deliverables.length > 0) {
+    await prisma.contractDeliverable.createMany({
+      data: extraction.deliverables.map((item) => ({
+        contractId: targetContractId,
+        title: item.title,
+        dueDate: item.dueDate ? new Date(item.dueDate) : null,
+        amountLinked: item.amountLinked,
+        notes: item.notes ?? "Detectado automaticamente por IA.",
+        status: "PENDING",
+      })),
+    });
+  }
+
+  if (paymentCount === 0 && extraction.paymentMilestones.length > 0) {
+    await prisma.contractPayment.createMany({
+      data: extraction.paymentMilestones
+        .filter((item) => item.paymentDate)
+        .map((item) => ({
+          contractId: targetContractId,
+          amount: item.amount ?? 0,
+          paymentDate: new Date(item.paymentDate as string),
+          concept: item.concept,
+          status: "REGISTERED",
+        })),
+    });
+  }
+
+  let uploadedDocumentId: string | null = null;
+  if (uploadedFile) {
+    const stored = await storeContractDocumentFile(user.id, targetContractId, fileName, mimeType, fileBuffer);
+    const createdDocument = await prisma.contractDocument.create({
+      data: {
+        contractId: targetContractId,
+        fileName: stored.fileName,
+        filePath: stored.filePath,
+        mimeType: stored.mimeType,
+        sizeBytes: stored.sizeBytes,
+        checksumSha256: stored.checksumSha256,
+        kind: "SIGNED_CONTRACT",
+      },
+      select: {
+        id: true,
+      },
+    });
+    uploadedDocumentId = createdDocument.id;
+  } else if (sourceProposalLookup?.status === "ok") {
+    const linked = await ensureProposalPdfLinkedToContract({
+      userId: user.id,
+      contractId: targetContractId,
+      source: sourceProposalLookup.source,
+    });
+    uploadedDocumentId = linked.documentId;
+  }
+
+  await prisma.contractExtractionHistory.create({
+    data: {
+      contractId: targetContractId,
+      userId: user.id,
+      engine: extraction.engine,
+      model: extraction.model,
+      resultJson: extraction as unknown as Prisma.InputJsonValue,
+      warningsJson: extraction.warnings as unknown as Prisma.InputJsonValue,
+    },
+  });
+
+  const fullContract = await prisma.contractRecord.findUnique({
+    where: { id: targetContractId },
+    include: {
+      deliverables: {
+        orderBy: [{ dueDate: "asc" }, { createdAt: "asc" }],
+      },
+      payments: {
+        orderBy: [{ paymentDate: "desc" }, { createdAt: "desc" }],
+      },
+      documents: {
+        orderBy: [{ createdAt: "desc" }],
+      },
+    },
+  });
+
+  return NextResponse.json({
+    ok: true,
+    contract: fullContract,
+    extraction: {
+      ...extraction,
+      analyzed: {
+        methodUsed: analyzed.methodUsed,
+        numPages: analyzed.numPages,
+        warnings: analyzed.warnings,
+      },
+    },
+    uploadedDocumentId,
+  });
+}
diff --git a/src/app/api/contracts/kpis/route.ts b/src/app/api/contracts/kpis/route.ts
new file mode 100644
index 0000000..f2e9ab0
--- /dev/null
+++ b/src/app/api/contracts/kpis/route.ts
@@ -0,0 +1,14 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { getContractsKpisForUser } from "@/lib/contracts/server";
+
+export async function GET() {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const kpis = await getContractsKpisForUser(user.id);
+  return NextResponse.json({ ok: true, kpis });
+}
diff --git a/src/app/api/contracts/route.ts b/src/app/api/contracts/route.ts
new file mode 100644
index 0000000..8daa1fe
--- /dev/null
+++ b/src/app/api/contracts/route.ts
@@ -0,0 +1,100 @@
+import { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import {
+  ContractCreateInputSchema,
+  ContractListFiltersSchema,
+} from "@/lib/contracts/types";
+import { listContractsForUser } from "@/lib/contracts/server";
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+export async function GET(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { searchParams } = new URL(request.url);
+    const parsed = ContractListFiltersSchema.safeParse({
+      q: searchParams.get("q") ?? undefined,
+      status: searchParams.get("status") ?? undefined,
+      sort: searchParams.get("sort") ?? undefined,
+    });
+
+    if (!parsed.success) {
+      return NextResponse.json({ error: "Filtros invalidos." }, { status: 400 });
+    }
+
+    const contracts = await listContractsForUser(user.id, parsed.data);
+    return NextResponse.json({ ok: true, contracts });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Gestion Estrategica de Contratos. Ejecuta prisma migrate." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible obtener contratos." }, { status: 400 });
+  }
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const body = parseJsonBody(await request.json().catch(() => ({})));
+    const parsed = ContractCreateInputSchema.safeParse(body);
+
+    if (!parsed.success) {
+      return NextResponse.json({ error: "Datos de contrato invalidos." }, { status: 400 });
+    }
+
+    const input = parsed.data;
+    const created = await prisma.contractRecord.create({
+      data: {
+        userId: user.id,
+        sourceProposalId: input.sourceProposalId ?? null,
+        title: input.title,
+        counterpartyEntity: input.counterpartyEntity,
+        contractNumber: input.contractNumber ?? null,
+        contractType: input.contractType,
+        startDate: input.startDate ? new Date(input.startDate) : null,
+        endDate: input.endDate ? new Date(input.endDate) : null,
+        totalAmount: input.totalAmount ?? null,
+        currency: (input.currency ?? "MXN").toUpperCase(),
+        status: input.status ?? "ACTIVE",
+        description: input.description ?? "",
+      },
+      select: { id: true },
+    });
+
+    const contracts = await listContractsForUser(user.id, { q: created.id });
+    const contract = contracts.find((item) => item.id === created.id) ?? null;
+
+    return NextResponse.json({ ok: true, contract });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Gestion Estrategica de Contratos. Ejecuta prisma migrate." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible crear el contrato." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/contracts/upload/route.ts b/src/app/api/contracts/upload/route.ts
new file mode 100644
index 0000000..7c478f6
--- /dev/null
+++ b/src/app/api/contracts/upload/route.ts
@@ -0,0 +1,103 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { MAX_CONTRACT_PDF_BYTES, storeContractDocumentFile } from "@/lib/contracts/storage";
+
+export const runtime = "nodejs";
+
+function isPdfFile(file: File) {
+  return file.type === "application/pdf" || file.name.toLowerCase().endsWith(".pdf");
+}
+
+function parseKind(value: FormDataEntryValue | null) {
+  const asString = typeof value === "string" ? value.trim().toUpperCase() : "";
+
+  if (
+    asString === "SIGNED_CONTRACT" ||
+    asString === "ADDENDUM" ||
+    asString === "DELIVERABLE_EVIDENCE" ||
+    asString === "PAYMENT_EVIDENCE" ||
+    asString === "OTHER"
+  ) {
+    return asString;
+  }
+
+  return "SIGNED_CONTRACT";
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const formData = await request.formData();
+  const contractIdValue = formData.get("contractId");
+  const fileValue = formData.get("file");
+
+  if (!(fileValue instanceof File)) {
+    return NextResponse.json({ error: "Debes adjuntar un archivo." }, { status: 400 });
+  }
+
+  if (fileValue.size <= 0) {
+    return NextResponse.json({ error: "El archivo esta vacio." }, { status: 400 });
+  }
+
+  if (fileValue.size > MAX_CONTRACT_PDF_BYTES) {
+    return NextResponse.json({ error: "El archivo excede el limite de 20MB." }, { status: 400 });
+  }
+
+  if (!isPdfFile(fileValue)) {
+    return NextResponse.json({ error: "Solo se permiten archivos PDF para este flujo." }, { status: 400 });
+  }
+
+  const contractId = typeof contractIdValue === "string" ? contractIdValue.trim() : "";
+
+  if (!contractId) {
+    return NextResponse.json({ error: "contractId es requerido." }, { status: 400 });
+  }
+
+  const contract = await prisma.contractRecord.findFirst({
+    where: {
+      id: contractId,
+      userId: user.id,
+    },
+    select: { id: true },
+  });
+
+  if (!contract) {
+    return NextResponse.json({ error: "Contrato no encontrado." }, { status: 404 });
+  }
+
+  const fileBuffer = Buffer.from(await fileValue.arrayBuffer());
+  const stored = await storeContractDocumentFile(user.id, contractId, fileValue.name, fileValue.type, fileBuffer);
+  const kind = parseKind(formData.get("kind"));
+
+  const document = await prisma.contractDocument.create({
+    data: {
+      contractId,
+      fileName: stored.fileName,
+      filePath: stored.filePath,
+      mimeType: stored.mimeType,
+      sizeBytes: stored.sizeBytes,
+      checksumSha256: stored.checksumSha256,
+      kind,
+    },
+  });
+
+  return NextResponse.json({
+    ok: true,
+    document: {
+      id: document.id,
+      contractId: document.contractId,
+      fileName: document.fileName,
+      filePath: document.filePath,
+      mimeType: document.mimeType,
+      sizeBytes: document.sizeBytes,
+      checksumSha256: document.checksumSha256,
+      kind: document.kind,
+      createdAt: document.createdAt.toISOString(),
+    },
+  });
+}
diff --git a/src/app/api/cron/licitations-sync/route.ts b/src/app/api/cron/licitations-sync/route.ts
index 15ba550..c1d0fea 100644
--- a/src/app/api/cron/licitations-sync/route.ts
+++ b/src/app/api/cron/licitations-sync/route.ts
@@ -1,5 +1,6 @@
 import { NextResponse } from "next/server";
-import { licitationsConfig } from "@/lib/licitations/config";
+import { runPeriodicNormativeVerification } from "@/lib/compliance/regulations";
+import { isAuthorizedCronRequest } from "@/lib/cron/auth";
 import { runDailyLicitationsSync } from "@/lib/licitations/sync";
 
 export const runtime = "nodejs";
@@ -31,10 +32,8 @@ function parseBoolean(value: string | null) {
   return undefined;
 }
 
-export async function POST(request: Request) {
-  const token = request.headers.get("x-sync-token") ?? "";
-
-  if (!licitationsConfig.syncCronToken || token !== licitationsConfig.syncCronToken) {
+async function runSync(request: Request) {
+  if (!isAuthorizedCronRequest(request)) {
     return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
   }
 
@@ -44,11 +43,33 @@ export async function POST(request: Request) {
   const skip = parsePositiveInt(url.searchParams.get("skip"));
   const targetYear = parsePositiveInt(url.searchParams.get("target_year"));
   const includePnt = parseBoolean(url.searchParams.get("include_pnt"));
+  const includeLicitaya = parseBoolean(url.searchParams.get("include_licitaya"));
+  const includeRegulations = parseBoolean(url.searchParams.get("include_regulations"));
   const force = parseBoolean(url.searchParams.get("force"));
-  const payload = await runDailyLicitationsSync({ municipalityId, limit, skip, targetYear, includePnt, force });
+  const payload = await runDailyLicitationsSync({ municipalityId, limit, skip, targetYear, includePnt, includeLicitaya, force });
+  let regulations = null;
+  let regulationsError: string | null = null;
+
+  if (includeRegulations !== false) {
+    try {
+      regulations = await runPeriodicNormativeVerification(new Date());
+    } catch (error) {
+      regulationsError = error instanceof Error ? error.message : "No fue posible verificar reglamentos oficiales.";
+    }
+  }
 
   return NextResponse.json({
     ok: true,
     payload,
+    regulations,
+    regulationsError,
   });
 }
+
+export async function GET(request: Request) {
+  return runSync(request);
+}
+
+export async function POST(request: Request) {
+  return runSync(request);
+}
diff --git a/src/app/api/cron/regulations-verify/route.ts b/src/app/api/cron/regulations-verify/route.ts
new file mode 100644
index 0000000..71f1035
--- /dev/null
+++ b/src/app/api/cron/regulations-verify/route.ts
@@ -0,0 +1,25 @@
+import { NextResponse } from "next/server";
+import { runPeriodicNormativeVerification } from "@/lib/compliance/regulations";
+import { isAuthorizedCronRequest } from "@/lib/cron/auth";
+
+export const runtime = "nodejs";
+
+async function runVerification(request: Request) {
+  if (!isAuthorizedCronRequest(request)) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const payload = await runPeriodicNormativeVerification(new Date());
+  return NextResponse.json({
+    ok: true,
+    payload,
+  });
+}
+
+export async function GET(request: Request) {
+  return runVerification(request);
+}
+
+export async function POST(request: Request) {
+  return runVerification(request);
+}
diff --git a/src/app/api/deliverables/[id]/route.ts b/src/app/api/deliverables/[id]/route.ts
new file mode 100644
index 0000000..99e7fb0
--- /dev/null
+++ b/src/app/api/deliverables/[id]/route.ts
@@ -0,0 +1,77 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { DeliverableUpdateInputSchema } from "@/lib/contracts/types";
+
+type RouteContext = {
+  params: Promise<{ id: string }>;
+};
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+export async function PATCH(request: Request, context: RouteContext) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { id } = await context.params;
+
+  try {
+    const body = parseJsonBody(await request.json().catch(() => ({})));
+    const parsed = DeliverableUpdateInputSchema.safeParse(body);
+
+    if (!parsed.success) {
+      return NextResponse.json({ error: "Datos de actualizacion invalidos." }, { status: 400 });
+    }
+
+    const deliverable = await prisma.contractDeliverable.findFirst({
+      where: {
+        id,
+        contract: {
+          userId: user.id,
+        },
+      },
+      select: { id: true },
+    });
+
+    if (!deliverable) {
+      return NextResponse.json({ error: "Entregable no encontrado." }, { status: 404 });
+    }
+
+    const input = parsed.data;
+
+    const updated = await prisma.contractDeliverable.update({
+      where: { id },
+      data: {
+        title: input.title,
+        status: input.status,
+        dueDate: input.dueDate === undefined ? undefined : input.dueDate ? new Date(input.dueDate) : null,
+        deliveredAt: input.deliveredAt === undefined ? undefined : input.deliveredAt ? new Date(input.deliveredAt) : null,
+        approvedAt: input.approvedAt === undefined ? undefined : input.approvedAt ? new Date(input.approvedAt) : null,
+        notes: input.notes,
+        amountLinked: input.amountLinked === undefined ? undefined : input.amountLinked ?? null,
+      },
+    });
+
+    return NextResponse.json({
+      ok: true,
+      deliverable: {
+        id: updated.id,
+        contractId: updated.contractId,
+        title: updated.title,
+        dueDate: updated.dueDate ? updated.dueDate.toISOString() : null,
+        amountLinked: updated.amountLinked ? Number(updated.amountLinked) : null,
+        status: updated.status,
+        deliveredAt: updated.deliveredAt ? updated.deliveredAt.toISOString() : null,
+        approvedAt: updated.approvedAt ? updated.approvedAt.toISOString() : null,
+        notes: updated.notes,
+      },
+    });
+  } catch {
+    return NextResponse.json({ error: "No fue posible actualizar el entregable." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/diagnostic/ai/suggestions/route.ts b/src/app/api/diagnostic/ai/suggestions/route.ts
new file mode 100644
index 0000000..eec3851
--- /dev/null
+++ b/src/app/api/diagnostic/ai/suggestions/route.ts
@@ -0,0 +1,309 @@
+import { z } from "zod";
+import { NextResponse } from "next/server";
+import { getSessionPayload } from "@/lib/auth/session";
+import { prisma } from "@/lib/prisma";
+import { callOpenAiJsonSchema } from "@/lib/ai/openai";
+import { storeAiSuggestionFromEnvelope } from "@/lib/ai/suggestions";
+
+const M1_PROMPT_VERSION = "m1_assist_v1";
+
+const M1AiSuggestionItemSchema = z.object({
+  questionId: z.string().min(1),
+  suggestedAnswerOptionId: z.string().min(1),
+  rationale: z.string().min(10).max(1_500),
+  missingEvidence: z.array(z.string().min(2).max(240)).max(8).default([]),
+  confidence: z.number().min(0).max(1).optional(),
+});
+
+const M1AiSuggestionResponseSchema = z.object({
+  suggestions: z.array(M1AiSuggestionItemSchema).max(50),
+  confidence: z.enum(["low", "medium", "high"]).optional(),
+});
+
+const M1AiSuggestionJsonSchema = {
+  type: "object",
+  additionalProperties: false,
+  required: ["suggestions"],
+  properties: {
+    suggestions: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["questionId", "suggestedAnswerOptionId", "rationale", "missingEvidence"],
+        properties: {
+          questionId: { type: "string" },
+          suggestedAnswerOptionId: { type: "string" },
+          rationale: { type: "string" },
+          missingEvidence: {
+            type: "array",
+            items: { type: "string" },
+          },
+          confidence: { type: "number", minimum: 0, maximum: 1 },
+        },
+      },
+    },
+    confidence: { type: "string", enum: ["low", "medium", "high"] },
+  },
+} as const;
+
+function parseString(value: unknown) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function parseResponseEvidence(rawValue: unknown): { notes: string; links: string[] } | null {
+  if (!rawValue || typeof rawValue !== "object" || Array.isArray(rawValue)) {
+    return null;
+  }
+
+  const value = rawValue as Record<string, unknown>;
+  const notes = typeof value.notes === "string" ? value.notes.trim() : "";
+  const links = Array.isArray(value.links)
+    ? value.links
+        .filter((entry): entry is string => typeof entry === "string")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0)
+    : [];
+
+  if (!notes && links.length === 0) {
+    return null;
+  }
+
+  return {
+    notes,
+    links,
+  };
+}
+
+function toConfidenceNumber(confidence: number | undefined, fallback: "low" | "medium" | "high" | null) {
+  if (typeof confidence === "number" && Number.isFinite(confidence)) {
+    return Math.max(0, Math.min(1, confidence));
+  }
+
+  if (fallback === "high") {
+    return 0.9;
+  }
+
+  if (fallback === "medium") {
+    return 0.65;
+  }
+
+  if (fallback === "low") {
+    return 0.35;
+  }
+
+  return null;
+}
+
+export async function POST(request: Request) {
+  const session = await getSessionPayload();
+
+  if (!session) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const body = (await request.json().catch(() => ({}))) as Record<string, unknown>;
+  const moduleKey = parseString(body.moduleKey);
+  const requestedQuestionId = parseString(body.questionId);
+
+  if (!moduleKey) {
+    return NextResponse.json({ error: "moduleKey es requerido." }, { status: 400 });
+  }
+
+  const moduleRecord = await prisma.diagnosticModule.findUnique({
+    where: { key: moduleKey },
+    select: {
+      id: true,
+      key: true,
+      name: true,
+      questions: {
+        orderBy: [{ sortOrder: "asc" }, { createdAt: "asc" }],
+        select: {
+          id: true,
+          prompt: true,
+          helpText: true,
+          answerOptions: {
+            orderBy: [{ sortOrder: "asc" }, { createdAt: "asc" }],
+            select: {
+              id: true,
+              label: true,
+            },
+          },
+        },
+      },
+    },
+  });
+
+  if (!moduleRecord) {
+    return NextResponse.json({ error: "Modulo no encontrado." }, { status: 404 });
+  }
+
+  const questionIds = moduleRecord.questions.map((question) => question.id);
+  const responses = questionIds.length
+    ? await prisma.response.findMany({
+        where: {
+          userId: session.userId,
+          questionId: {
+            in: questionIds,
+          },
+        },
+        select: {
+          questionId: true,
+          answerOptionId: true,
+          evidence: true,
+        },
+      })
+    : [];
+
+  const responseByQuestionId = new Map(responses.map((item) => [item.questionId, item]));
+  const targetQuestions = moduleRecord.questions.filter((question) => {
+    if (requestedQuestionId) {
+      return question.id === requestedQuestionId;
+    }
+
+    return !responseByQuestionId.has(question.id);
+  });
+
+  if (requestedQuestionId && !targetQuestions.length) {
+    return NextResponse.json({ error: "questionId no pertenece al modulo solicitado." }, { status: 400 });
+  }
+
+  if (!targetQuestions.length) {
+    return NextResponse.json({
+      ok: true,
+      moduleKey,
+      suggestions: [],
+      warnings: [{ code: "no_unanswered_questions", message: "No hay preguntas pendientes para sugerir en este modulo." }],
+    });
+  }
+
+  const answeredContext = moduleRecord.questions
+    .map((question) => {
+      const response = responseByQuestionId.get(question.id);
+      if (!response) {
+        return null;
+      }
+
+      const selectedOption = question.answerOptions.find((option) => option.id === response.answerOptionId) ?? null;
+      const evidence = parseResponseEvidence(response.evidence);
+
+      return {
+        questionId: question.id,
+        prompt: question.prompt,
+        selectedAnswerOptionId: selectedOption?.id ?? response.answerOptionId,
+        selectedAnswerLabel: selectedOption?.label ?? "No identificada",
+        evidenceNotes: evidence?.notes ?? "",
+        evidenceLinks: evidence?.links ?? [],
+      };
+    })
+    .filter((item): item is NonNullable<typeof item> => Boolean(item));
+
+  const targetContext = targetQuestions.map((question) => ({
+    questionId: question.id,
+    prompt: question.prompt,
+    helpText: question.helpText ?? "",
+    options: question.answerOptions.map((option) => ({
+      id: option.id,
+      label: option.label,
+    })),
+  }));
+
+  const systemPrompt = [
+    "Eres un asistente experto en diagnostico organizacional para contratacion publica en Mexico.",
+    "Genera sugerencias de respuesta para preguntas no contestadas sin inventar evidencia.",
+    "Debes responder solamente JSON valido.",
+    "El idioma de salida debe ser espanol.",
+  ].join(" ");
+
+  const userPrompt = [
+    `Modulo: ${moduleRecord.name} (${moduleRecord.key})`,
+    "Respuestas ya contestadas por la organizacion:",
+    JSON.stringify(answeredContext),
+    "",
+    "Preguntas objetivo a sugerir:",
+    JSON.stringify(targetContext),
+    "",
+    "Instrucciones:",
+    "- Para cada pregunta objetivo devuelve questionId y suggestedAnswerOptionId usando solo IDs listados en options.",
+    "- rationale debe explicar por que esa opcion es la mas probable segun contexto.",
+    "- missingEvidence debe listar evidencia que ayudaria a confirmar o corregir la sugerencia.",
+    "- confidence debe ir de 0 a 1.",
+  ].join("\n");
+
+  const envelope = await callOpenAiJsonSchema({
+    promptVersion: M1_PROMPT_VERSION,
+    systemPrompt,
+    userPrompt,
+    outputSchema: M1AiSuggestionResponseSchema,
+    schemaName: "m1_question_suggestions",
+    jsonSchema: M1AiSuggestionJsonSchema as unknown as Record<string, unknown>,
+    model: process.env.OPENAI_M1_MODEL?.trim() || undefined,
+  });
+
+  const targetQuestionById = new Map(
+    targetQuestions.map((question) => [
+      question.id,
+      {
+        id: question.id,
+        optionIds: new Set(question.answerOptions.map((option) => option.id)),
+      },
+    ]),
+  );
+
+  const aiSuggestions = envelope.data?.suggestions ?? [];
+  const normalizedSuggestions = aiSuggestions
+    .map((item) => {
+      const question = targetQuestionById.get(item.questionId);
+      if (!question || !question.optionIds.has(item.suggestedAnswerOptionId)) {
+        return null;
+      }
+
+      return item;
+    })
+    .filter((item): item is z.infer<typeof M1AiSuggestionItemSchema> => Boolean(item));
+
+  const persisted = await Promise.all(
+    normalizedSuggestions.map(async (item) => {
+      const saved = await storeAiSuggestionFromEnvelope({
+        userId: session.userId,
+        moduleKey: "M1",
+        featureKey: "diagnostic_answer_suggestion",
+        subjectType: "question",
+        subjectId: item.questionId,
+        inputForHash: {
+          moduleKey,
+          questionId: item.questionId,
+          answeredContext,
+          targetQuestion: targetContext.find((question) => question.questionId === item.questionId) ?? null,
+        },
+        envelope,
+        responsePayload: item,
+      });
+
+      return {
+        ...item,
+        suggestionId: saved.suggestionId,
+      };
+    }),
+  );
+
+  return NextResponse.json({
+    ok: true,
+    moduleKey,
+    suggestions: persisted.map((item) => ({
+      questionId: item.questionId,
+      suggestedAnswerOptionId: item.suggestedAnswerOptionId,
+      rationale: item.rationale,
+      missingEvidence: item.missingEvidence,
+      confidence: toConfidenceNumber(item.confidence, envelope.confidence),
+      suggestionId: item.suggestionId,
+    })),
+    meta: {
+      engine: envelope.engine,
+      model: envelope.model,
+      usage: envelope.usage,
+      warnings: envelope.warnings,
+      confidence: envelope.confidence,
+    },
+  });
+}
diff --git a/src/app/api/legal/cases/[id]/route.ts b/src/app/api/legal/cases/[id]/route.ts
new file mode 100644
index 0000000..5126bf2
--- /dev/null
+++ b/src/app/api/legal/cases/[id]/route.ts
@@ -0,0 +1,64 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { LegalCaseUpdateInputSchema } from "@/lib/legal/types";
+import { listLegalCasesForUser } from "@/lib/legal/server";
+
+type RouteContext = {
+  params: Promise<{ id: string }>;
+};
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+export async function PATCH(request: Request, context: RouteContext) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { id } = await context.params;
+
+  try {
+    const body = parseJsonBody(await request.json().catch(() => ({})));
+    const parsed = LegalCaseUpdateInputSchema.safeParse(body);
+
+    if (!parsed.success) {
+      return NextResponse.json({ error: "Datos de actualizacion invalidos." }, { status: 400 });
+    }
+
+    const owned = await prisma.legalCase.findFirst({
+      where: {
+        id,
+        userId: user.id,
+      },
+      select: { id: true },
+    });
+
+    if (!owned) {
+      return NextResponse.json({ error: "Caso no encontrado." }, { status: 404 });
+    }
+
+    const input = parsed.data;
+    await prisma.legalCase.update({
+      where: { id },
+      data: {
+        severity: input.severity,
+        status: input.status,
+        resolvedAt: input.resolvedAt === undefined ? undefined : input.resolvedAt ? new Date(input.resolvedAt) : null,
+        description: input.description,
+        amountAtRisk: input.amountAtRisk === undefined ? undefined : input.amountAtRisk ?? null,
+        counterparty: input.counterparty,
+      },
+    });
+
+    const cases = await listLegalCasesForUser(user.id);
+    const legalCase = cases.find((item) => item.id === id) ?? null;
+
+    return NextResponse.json({ ok: true, case: legalCase });
+  } catch {
+    return NextResponse.json({ error: "No fue posible actualizar el caso legal." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/legal/cases/route.ts b/src/app/api/legal/cases/route.ts
new file mode 100644
index 0000000..8bb8789
--- /dev/null
+++ b/src/app/api/legal/cases/route.ts
@@ -0,0 +1,62 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { LegalCaseCreateInputSchema } from "@/lib/legal/types";
+import { listLegalCasesForUser } from "@/lib/legal/server";
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+export async function GET() {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const cases = await listLegalCasesForUser(user.id);
+  return NextResponse.json({ ok: true, cases });
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const body = parseJsonBody(await request.json().catch(() => ({})));
+    const parsed = LegalCaseCreateInputSchema.safeParse(body);
+
+    if (!parsed.success) {
+      return NextResponse.json({ error: "Datos de caso legal invalidos." }, { status: 400 });
+    }
+
+    const input = parsed.data;
+
+    const created = await prisma.legalCase.create({
+      data: {
+        userId: user.id,
+        contractId: input.contractId ?? null,
+        caseType: input.caseType,
+        severity: input.severity,
+        counterparty: input.counterparty,
+        description: input.description,
+        amountAtRisk: input.amountAtRisk ?? null,
+        status: input.status ?? "OPEN",
+      },
+      select: {
+        id: true,
+      },
+    });
+
+    const cases = await listLegalCasesForUser(user.id);
+    const legalCase = cases.find((item) => item.id === created.id) ?? null;
+
+    return NextResponse.json({ ok: true, case: legalCase });
+  } catch {
+    return NextResponse.json({ error: "No fue posible crear el caso legal." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/legal/diagnosis/answer/route.test.ts b/src/app/api/legal/diagnosis/answer/route.test.ts
new file mode 100644
index 0000000..40cced4
--- /dev/null
+++ b/src/app/api/legal/diagnosis/answer/route.test.ts
@@ -0,0 +1,118 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const { requireAdminApiUserMock, parseDiagnosisAnswersMock, evaluateDiagnosisMock, prismaMock } = vi.hoisted(() => ({
+  requireAdminApiUserMock: vi.fn(),
+  parseDiagnosisAnswersMock: vi.fn(),
+  evaluateDiagnosisMock: vi.fn(),
+  prismaMock: {
+    legalDiagnosis: {
+      findFirst: vi.fn(),
+      update: vi.fn(),
+    },
+    contractRecord: {
+      findFirst: vi.fn(),
+    },
+    legalCase: {
+      create: vi.fn(),
+    },
+  },
+}));
+
+vi.mock("@/lib/auth/admin", () => ({
+  requireAdminApiUser: requireAdminApiUserMock,
+}));
+
+vi.mock("@/lib/legal/diagnosis", () => ({
+  parseDiagnosisAnswers: parseDiagnosisAnswersMock,
+  evaluateDiagnosis: evaluateDiagnosisMock,
+}));
+
+vi.mock("@/lib/prisma", () => ({
+  prisma: prismaMock,
+}));
+
+import { POST } from "@/app/api/legal/diagnosis/answer/route";
+
+describe("M9 diagnosis contract continuity regression", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("keeps persisted contractId when finalizing diagnosis into legal case", async () => {
+    const now = new Date("2026-04-15T11:00:00.000Z");
+
+    requireAdminApiUserMock.mockResolvedValue({ id: "user-1" });
+    prismaMock.legalDiagnosis.findFirst.mockResolvedValue({
+      id: "diag-1",
+      totalSteps: 4,
+      legalCaseId: null,
+      answersJson: {
+        contractId: "contract-1",
+        counterparty: "Proveedor SA",
+        description: "Incumplimiento de entregable",
+      },
+    });
+    parseDiagnosisAnswersMock.mockReturnValue({ amountAtRisk: 5000 });
+    evaluateDiagnosisMock.mockReturnValue({
+      suggestedSeverity: "HIGH",
+      suggestedCaseType: "CONTRACT_BREACH",
+    });
+    prismaMock.contractRecord.findFirst.mockResolvedValue({ id: "contract-1" });
+    prismaMock.legalCase.create.mockResolvedValue({ id: "case-1" });
+    prismaMock.legalDiagnosis.update.mockResolvedValue({
+      id: "diag-1",
+      legalCaseId: "case-1",
+      stepIndex: 4,
+      totalSteps: 4,
+      answersJson: {
+        contractId: "contract-1",
+      },
+      recommendedRouteJson: {
+        suggestedSeverity: "HIGH",
+        suggestedCaseType: "CONTRACT_BREACH",
+      },
+      updatedAt: now,
+    });
+
+    const request = new Request("http://localhost/api/legal/diagnosis/answer", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        diagnosisId: "diag-1",
+        stepIndex: 3,
+        answers: {},
+        finalize: true,
+      }),
+    });
+
+    const response = await POST(request);
+    const payload = (await response.json()) as {
+      ok?: boolean;
+      diagnosis?: {
+        legalCaseId: string | null;
+      };
+    };
+
+    expect(response.status).toBe(200);
+    expect(payload.ok).toBe(true);
+    expect(payload.diagnosis?.legalCaseId).toBe("case-1");
+    expect(prismaMock.contractRecord.findFirst).toHaveBeenCalledWith({
+      where: {
+        id: "contract-1",
+        userId: "user-1",
+      },
+      select: {
+        id: true,
+      },
+    });
+    expect(prismaMock.legalCase.create).toHaveBeenCalledWith(
+      expect.objectContaining({
+        data: expect.objectContaining({
+          contractId: "contract-1",
+        }),
+      }),
+    );
+  });
+});
diff --git a/src/app/api/legal/diagnosis/answer/route.ts b/src/app/api/legal/diagnosis/answer/route.ts
new file mode 100644
index 0000000..bfbd296
--- /dev/null
+++ b/src/app/api/legal/diagnosis/answer/route.ts
@@ -0,0 +1,172 @@
+import type { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { evaluateDiagnosis, parseDiagnosisAnswers } from "@/lib/legal/diagnosis";
+import { LegalDiagnosisAnswerInputSchema } from "@/lib/legal/types";
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+function stringOrEmpty(value: unknown) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function extractContractId(value: unknown) {
+  if (typeof value !== "string") {
+    return null;
+  }
+
+  const normalized = value.trim();
+  return normalized ? normalized : null;
+}
+
+function logContinuityHandoff(event: string, data: Record<string, unknown>) {
+  console.info(
+    "[continuity_handoff]",
+    JSON.stringify({
+      event,
+      at: new Date().toISOString(),
+      ...data,
+    }),
+  );
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const body = parseJsonBody(await request.json().catch(() => ({})));
+  const parsed = LegalDiagnosisAnswerInputSchema.safeParse(body);
+
+  if (!parsed.success) {
+    return NextResponse.json({ error: "Datos de respuesta invalidos." }, { status: 400 });
+  }
+
+  const input = parsed.data;
+  logContinuityHandoff("m9_diagnosis_answer_received", {
+    userId: user.id,
+    diagnosisId: input.diagnosisId,
+    finalize: Boolean(input.finalize),
+  });
+
+  const diagnosis = await prisma.legalDiagnosis.findFirst({
+    where: {
+      id: input.diagnosisId,
+      userId: user.id,
+    },
+    select: {
+      id: true,
+      answersJson: true,
+      totalSteps: true,
+      legalCaseId: true,
+    },
+  });
+
+  if (!diagnosis) {
+    return NextResponse.json({ error: "Diagnostico no encontrado." }, { status: 404 });
+  }
+
+  const currentAnswers =
+    diagnosis.answersJson && typeof diagnosis.answersJson === "object" && !Array.isArray(diagnosis.answersJson)
+      ? (diagnosis.answersJson as Record<string, unknown>)
+      : {};
+
+  const mergedAnswers = {
+    ...currentAnswers,
+    ...input.answers,
+  };
+
+  const normalizedAnswers = parseDiagnosisAnswers(mergedAnswers);
+  const recommendation = evaluateDiagnosis(normalizedAnswers);
+  const nextStep = input.finalize ? diagnosis.totalSteps : Math.min(diagnosis.totalSteps, input.stepIndex + 1);
+
+  let legalCaseId = diagnosis.legalCaseId;
+  const persistedContractId = extractContractId(mergedAnswers.contractId);
+  logContinuityHandoff("m9_diagnosis_contract_context", {
+    userId: user.id,
+    diagnosisId: diagnosis.id,
+    persistedContractId,
+    hasLegalCaseAlready: Boolean(legalCaseId),
+  });
+
+  if (input.finalize && !legalCaseId) {
+    if (persistedContractId) {
+      const ownedContract = await prisma.contractRecord.findFirst({
+        where: {
+          id: persistedContractId,
+          userId: user.id,
+        },
+        select: {
+          id: true,
+        },
+      });
+
+      if (!ownedContract) {
+        return NextResponse.json({ error: "El contrato vinculado al diagnostico ya no esta disponible." }, { status: 400 });
+      }
+    }
+
+    const createdCase = await prisma.legalCase.create({
+      data: {
+        userId: user.id,
+        contractId: persistedContractId,
+        caseType: recommendation.suggestedCaseType,
+        severity: recommendation.suggestedSeverity,
+        counterparty: stringOrEmpty(mergedAnswers.counterparty) || "Contraparte por validar",
+        description: stringOrEmpty(mergedAnswers.description) || "Caso generado desde diagnostico legal asistido.",
+        amountAtRisk: normalizedAnswers.amountAtRisk,
+        status: "OPEN",
+      },
+      select: {
+        id: true,
+      },
+    });
+
+    legalCaseId = createdCase.id;
+    logContinuityHandoff("m9_case_autocreated_from_diagnosis", {
+      userId: user.id,
+      diagnosisId: diagnosis.id,
+      legalCaseId,
+      contractId: persistedContractId,
+    });
+  }
+
+  const updated = await prisma.legalDiagnosis.update({
+    where: {
+      id: diagnosis.id,
+    },
+    data: {
+      stepIndex: nextStep,
+      answersJson: mergedAnswers as Prisma.InputJsonValue,
+      recommendedRouteJson: recommendation as unknown as Prisma.InputJsonValue,
+      legalCaseId,
+    },
+    select: {
+      id: true,
+      legalCaseId: true,
+      stepIndex: true,
+      totalSteps: true,
+      answersJson: true,
+      recommendedRouteJson: true,
+      updatedAt: true,
+    },
+  });
+
+  return NextResponse.json({
+    ok: true,
+    diagnosis: {
+      id: updated.id,
+      legalCaseId: updated.legalCaseId,
+      stepIndex: updated.stepIndex,
+      totalSteps: updated.totalSteps,
+      answers: updated.answersJson,
+      recommendation: updated.recommendedRouteJson,
+      updatedAt: updated.updatedAt.toISOString(),
+    },
+  });
+}
diff --git a/src/app/api/legal/diagnosis/start/route.ts b/src/app/api/legal/diagnosis/start/route.ts
new file mode 100644
index 0000000..c74644f
--- /dev/null
+++ b/src/app/api/legal/diagnosis/start/route.ts
@@ -0,0 +1,105 @@
+import type { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { evaluateDiagnosis, parseDiagnosisAnswers } from "@/lib/legal/diagnosis";
+import { LegalDiagnosisStartInputSchema } from "@/lib/legal/types";
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+function logContinuityHandoff(event: string, data: Record<string, unknown>) {
+  console.info(
+    "[continuity_handoff]",
+    JSON.stringify({
+      event,
+      at: new Date().toISOString(),
+      ...data,
+    }),
+  );
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const body = parseJsonBody(await request.json().catch(() => ({})));
+  const parsed = LegalDiagnosisStartInputSchema.safeParse(body);
+
+  if (!parsed.success) {
+    return NextResponse.json({ error: "Datos de inicio de diagnostico invalidos." }, { status: 400 });
+  }
+
+  const input = parsed.data;
+  logContinuityHandoff("m8_to_m9_diagnosis_start_requested", {
+    userId: user.id,
+    requestedContractId: input.contractId ?? null,
+  });
+
+  let contractId: string | null = null;
+  if (input.contractId) {
+    const ownedContract = await prisma.contractRecord.findFirst({
+      where: {
+        id: input.contractId,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+      },
+    });
+
+    if (!ownedContract) {
+      return NextResponse.json({ error: "Contrato no encontrado para iniciar diagnostico." }, { status: 404 });
+    }
+
+    contractId = ownedContract.id;
+  }
+
+  logContinuityHandoff("m8_to_m9_diagnosis_started", {
+    userId: user.id,
+    persistedContractId: contractId,
+  });
+
+  const normalizedAnswers = parseDiagnosisAnswers({});
+  const recommendation = evaluateDiagnosis(normalizedAnswers);
+  const answersJson: Record<string, unknown> = {
+    ...normalizedAnswers,
+  };
+
+  if (contractId) {
+    answersJson.contractId = contractId;
+  }
+
+  const diagnosis = await prisma.legalDiagnosis.create({
+    data: {
+      userId: user.id,
+      answersJson: answersJson as Prisma.InputJsonValue,
+      recommendedRouteJson: recommendation as unknown as Prisma.InputJsonValue,
+      stepIndex: 1,
+      totalSteps: 4,
+    },
+    select: {
+      id: true,
+      stepIndex: true,
+      totalSteps: true,
+      answersJson: true,
+      recommendedRouteJson: true,
+    },
+  });
+
+  return NextResponse.json({
+    ok: true,
+    diagnosis: {
+      id: diagnosis.id,
+      stepIndex: diagnosis.stepIndex,
+      totalSteps: diagnosis.totalSteps,
+      answers: diagnosis.answersJson,
+      contractId,
+      recommendation: diagnosis.recommendedRouteJson,
+    },
+  });
+}
diff --git a/src/app/api/legal/directory/route.ts b/src/app/api/legal/directory/route.ts
new file mode 100644
index 0000000..d897e4c
--- /dev/null
+++ b/src/app/api/legal/directory/route.ts
@@ -0,0 +1,26 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { LegalDirectoryFiltersSchema } from "@/lib/legal/types";
+import { listLegalDirectory } from "@/lib/legal/server";
+
+export async function GET(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { searchParams } = new URL(request.url);
+  const parsed = LegalDirectoryFiltersSchema.safeParse({
+    jurisdictionLevel: searchParams.get("jurisdictionLevel") ?? undefined,
+    stateCode: searchParams.get("stateCode") ?? undefined,
+    q: searchParams.get("q") ?? undefined,
+  });
+
+  if (!parsed.success) {
+    return NextResponse.json({ error: "Filtros invalidos." }, { status: 400 });
+  }
+
+  const entities = await listLegalDirectory(parsed.data);
+  return NextResponse.json({ ok: true, entities });
+}
diff --git a/src/app/api/legal/documents/generate/route.ts b/src/app/api/legal/documents/generate/route.ts
new file mode 100644
index 0000000..05c112f
--- /dev/null
+++ b/src/app/api/legal/documents/generate/route.ts
@@ -0,0 +1,91 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { generateLegalDocument } from "@/lib/legal/ai-documents";
+import { LegalDocumentGenerateInputSchema } from "@/lib/legal/types";
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const body = parseJsonBody(await request.json().catch(() => ({})));
+    const parsed = LegalDocumentGenerateInputSchema.safeParse(body);
+
+    if (!parsed.success) {
+      return NextResponse.json({ error: "Datos para generar escrito invalidos." }, { status: 400 });
+    }
+
+    const input = parsed.data;
+
+    let legalCaseId: string | null = input.legalCaseId ?? null;
+    if (legalCaseId) {
+      const ownedCase = await prisma.legalCase.findFirst({
+        where: {
+          id: legalCaseId,
+          userId: user.id,
+        },
+        select: { id: true },
+      });
+
+      if (!ownedCase) {
+        return NextResponse.json({ error: "Caso legal no encontrado." }, { status: 404 });
+      }
+
+      legalCaseId = ownedCase.id;
+    }
+
+    const generated = await generateLegalDocument({
+      legalCaseId,
+      caseType: input.caseType,
+      severity: input.severity,
+      templateKey: input.templateKey ?? null,
+      counterparty: input.counterparty,
+      companyName: input.companyName,
+      amountAtRisk: input.amountAtRisk ?? null,
+      description: input.description,
+      objective: input.objective,
+    });
+
+    const title = input.title?.trim() || generated.title;
+
+    const document = await prisma.legalDocument.create({
+      data: {
+        legalCaseId,
+        userId: user.id,
+        templateKey: input.templateKey ?? null,
+        aiGenerated: generated.engine === "openai_json_object",
+        title,
+        content: generated.content,
+      },
+    });
+
+    return NextResponse.json({
+      ok: true,
+      document: {
+        id: document.id,
+        legalCaseId: document.legalCaseId,
+        templateKey: document.templateKey,
+        aiGenerated: document.aiGenerated,
+        title: document.title,
+        content: document.content,
+        createdAt: document.createdAt.toISOString(),
+      },
+      generation: {
+        engine: generated.engine,
+        model: generated.model,
+        warnings: generated.warnings,
+        usage: generated.usage,
+      },
+    });
+  } catch {
+    return NextResponse.json({ error: "No fue posible generar el escrito legal." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/legal/escalation/[caseId]/route.ts b/src/app/api/legal/escalation/[caseId]/route.ts
new file mode 100644
index 0000000..1471638
--- /dev/null
+++ b/src/app/api/legal/escalation/[caseId]/route.ts
@@ -0,0 +1,90 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { getEscalationForCase } from "@/lib/legal/server";
+
+type RouteContext = {
+  params: Promise<{ caseId: string }>;
+};
+
+const VALID_STEP_KEYS = new Set([
+  "formal_requirement",
+  "administrative_conciliation",
+  "oic_complaint",
+  "sfp_or_state_challenge",
+  "jurisdictional_path",
+]);
+
+function parseJsonBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+export async function GET(_request: Request, context: RouteContext) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { caseId } = await context.params;
+  const escalation = await getEscalationForCase(user.id, caseId);
+
+  if (!escalation) {
+    return NextResponse.json({ error: "Caso no encontrado." }, { status: 404 });
+  }
+
+  return NextResponse.json({ ok: true, escalation });
+}
+
+export async function POST(request: Request, context: RouteContext) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const { caseId } = await context.params;
+  const body = parseJsonBody(await request.json().catch(() => ({})));
+
+  const routeStepKey = typeof body.routeStepKey === "string" ? body.routeStepKey.trim() : "";
+  const notes = typeof body.notes === "string" ? body.notes.trim() : "";
+  const completed = body.completed === false ? false : true;
+
+  if (!VALID_STEP_KEYS.has(routeStepKey)) {
+    return NextResponse.json({ error: "routeStepKey invalido." }, { status: 400 });
+  }
+
+  const legalCase = await prisma.legalCase.findFirst({
+    where: {
+      id: caseId,
+      userId: user.id,
+    },
+    select: { id: true },
+  });
+
+  if (!legalCase) {
+    return NextResponse.json({ error: "Caso no encontrado." }, { status: 404 });
+  }
+
+  await prisma.legalEscalationStepLog.upsert({
+    where: {
+      legalCaseId_routeStepKey: {
+        legalCaseId: caseId,
+        routeStepKey,
+      },
+    },
+    update: {
+      completedAt: completed ? new Date() : null,
+      notes,
+    },
+    create: {
+      legalCaseId: caseId,
+      routeStepKey,
+      completedAt: completed ? new Date() : null,
+      notes,
+    },
+  });
+
+  const escalation = await getEscalationForCase(user.id, caseId);
+  return NextResponse.json({ ok: true, escalation });
+}
diff --git a/src/app/api/legal/kpis/route.ts b/src/app/api/legal/kpis/route.ts
new file mode 100644
index 0000000..35872ac
--- /dev/null
+++ b/src/app/api/legal/kpis/route.ts
@@ -0,0 +1,14 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { getLegalKpisForUser } from "@/lib/legal/server";
+
+export async function GET() {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const kpis = await getLegalKpisForUser(user.id);
+  return NextResponse.json({ ok: true, kpis });
+}
diff --git a/src/app/api/legal/templates/route.ts b/src/app/api/legal/templates/route.ts
new file mode 100644
index 0000000..9db1b08
--- /dev/null
+++ b/src/app/api/legal/templates/route.ts
@@ -0,0 +1,13 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { listLegalTemplates } from "@/lib/legal/ai-documents";
+
+export async function GET() {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  return NextResponse.json({ ok: true, templates: listLegalTemplates() });
+}
diff --git a/src/app/api/licitations/ai/recommendations/route.ts b/src/app/api/licitations/ai/recommendations/route.ts
new file mode 100644
index 0000000..b501b7c
--- /dev/null
+++ b/src/app/api/licitations/ai/recommendations/route.ts
@@ -0,0 +1,33 @@
+import { NextResponse } from "next/server";
+import { getSessionPayload } from "@/lib/auth/session";
+import { getAiEnhancedLicitationRecommendationsForUser } from "@/lib/licitations/ai-recommendations";
+
+function parseTop(value: string | null) {
+  if (!value) {
+    return undefined;
+  }
+
+  const parsed = Number.parseInt(value, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+}
+
+export async function GET(request: Request) {
+  const session = await getSessionPayload();
+
+  if (!session) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const url = new URL(request.url);
+  const profileId = url.searchParams.get("profileId") ?? url.searchParams.get("profile_id");
+  const top = parseTop(url.searchParams.get("top"));
+  const payload = await getAiEnhancedLicitationRecommendationsForUser(session.userId, {
+    profileId,
+    top,
+  });
+
+  return NextResponse.json({
+    ok: true,
+    ...payload,
+  });
+}
diff --git a/src/app/api/licitations/preferences/[id]/route.ts b/src/app/api/licitations/preferences/[id]/route.ts
new file mode 100644
index 0000000..85e30b6
--- /dev/null
+++ b/src/app/api/licitations/preferences/[id]/route.ts
@@ -0,0 +1,78 @@
+import { Prisma, type LicitationReviewStatus } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { parseLicitationReviewStatus } from "@/lib/licitations/preferences";
+import { prisma } from "@/lib/prisma";
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+export async function PATCH(request: Request, context: { params: Promise<{ id: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id } = await context.params;
+    const body = (await request.json()) as Record<string, unknown>;
+    const status = parseLicitationReviewStatus(body.status);
+
+    if (!status) {
+      return NextResponse.json({ error: "Estatus invalido." }, { status: 400 });
+    }
+
+    const licitation = await prisma.licitation.findUnique({
+      where: { id },
+      select: { id: true },
+    });
+
+    if (!licitation) {
+      return NextResponse.json({ error: "Licitacion no encontrada." }, { status: 404 });
+    }
+
+    if (status === "NEW") {
+      await prisma.licitationUserPreference.deleteMany({
+        where: {
+          userId: user.id,
+          licitationId: id,
+        },
+      });
+
+      return NextResponse.json({ ok: true, status: "NEW" });
+    }
+
+    const updated = await prisma.licitationUserPreference.upsert({
+      where: {
+        userId_licitationId: {
+          userId: user.id,
+          licitationId: id,
+        },
+      },
+      update: {
+        status: status as LicitationReviewStatus,
+      },
+      create: {
+        userId: user.id,
+        licitationId: id,
+        status: status as LicitationReviewStatus,
+      },
+      select: {
+        status: true,
+      },
+    });
+
+    return NextResponse.json({ ok: true, status: updated.status });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de estado de oportunidades. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible actualizar el estado." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/normative-analysis/history/[id]/route.ts b/src/app/api/normative-analysis/history/[id]/route.ts
new file mode 100644
index 0000000..db5870b
--- /dev/null
+++ b/src/app/api/normative-analysis/history/[id]/route.ts
@@ -0,0 +1,46 @@
+import { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+export async function DELETE(_: Request, context: { params: Promise<{ id: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id } = await context.params;
+
+    const deleted = await prisma.normativeAnalysisHistory.updateMany({
+      where: {
+        id,
+        userId: user.id,
+        deletedAt: null,
+      },
+      data: {
+        deletedAt: new Date(),
+      },
+    });
+
+    if (deleted.count === 0) {
+      return NextResponse.json({ error: "Analisis no encontrado." }, { status: 404 });
+    }
+
+    return NextResponse.json({ ok: true });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Analisis Normativo. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible eliminar el analisis." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/normative-analysis/history/route.ts b/src/app/api/normative-analysis/history/route.ts
new file mode 100644
index 0000000..b8be7bf
--- /dev/null
+++ b/src/app/api/normative-analysis/history/route.ts
@@ -0,0 +1,98 @@
+import { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { toNormativeHistoryView } from "@/lib/normative-analysis/history";
+import { prisma } from "@/lib/prisma";
+
+function parsePositiveInt(value: string | null, fallback: number) {
+  if (!value) {
+    return fallback;
+  }
+
+  const parsed = Number.parseInt(value, 10);
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    return fallback;
+  }
+
+  return parsed;
+}
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+export async function GET(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const url = new URL(request.url);
+    const take = Math.min(parsePositiveInt(url.searchParams.get("take"), 50), 100);
+    const proposalId = url.searchParams.get("proposalId")?.trim() || null;
+    let sourceLicitationId = url.searchParams.get("sourceId")?.trim() || null;
+
+    if (!sourceLicitationId && proposalId) {
+      const proposal = await prisma.proposal.findFirst({
+        where: {
+          id: proposalId,
+          userId: user.id,
+        },
+        select: {
+          sourceLicitationId: true,
+        },
+      });
+
+      if (!proposal?.sourceLicitationId) {
+        return NextResponse.json({
+          ok: true,
+          items: [],
+        });
+      }
+
+      sourceLicitationId = proposal.sourceLicitationId;
+    }
+
+    const history = await prisma.normativeAnalysisHistory.findMany({
+      where: {
+        userId: user.id,
+        deletedAt: null,
+        ...(sourceLicitationId ? { sourceLicitationId } : {}),
+      },
+      orderBy: [{ analyzedAt: "desc" }],
+      take,
+      select: {
+        id: true,
+        sourceLicitationId: true,
+        fileName: true,
+        documentType: true,
+        issuingEntity: true,
+        methodUsed: true,
+        numPages: true,
+        warnings: true,
+        extractedChars: true,
+        analyzedAt: true,
+        viabilityScore: true,
+        riskLevel: true,
+        confidence: true,
+        result: true,
+      },
+    });
+
+    return NextResponse.json({
+      ok: true,
+      items: history.map((entry) => toNormativeHistoryView(entry)),
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Analisis Normativo. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible consultar el historial." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/normative-analysis/route.ts b/src/app/api/normative-analysis/route.ts
new file mode 100644
index 0000000..9a2e5cc
--- /dev/null
+++ b/src/app/api/normative-analysis/route.ts
@@ -0,0 +1,612 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { type NormativeConfidence, type NormativeDocumentType as PrismaNormativeDocumentType, type NormativeRiskLevel, Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { isLikelyPdfUrl, parseLicitationDocumentLinks, pickPrimaryLicitationDocument, pickPrimaryLicitationPdfDocument } from "@/lib/licitations/documents";
+import { type NormativeDocumentType } from "@/lib/normative-analysis/analyze";
+import { analyzeNormativeTextWithAi } from "@/lib/normative-analysis/ai-analyze";
+import { toNormativeHistoryView } from "@/lib/normative-analysis/history";
+import { analyzePdf } from "@/lib/pdf/analyzePdf";
+import { OcrFailedError, OcrUnavailableError, PdfEncryptedError, PdfNoTextDetectedError, PdfUnreadableError } from "@/lib/pdf/errors";
+import { prisma } from "@/lib/prisma";
+
+export const runtime = "nodejs";
+
+const MAX_NORMATIVE_PDF_BYTES = 20 * 1024 * 1024;
+const SOURCE_FETCH_TIMEOUT_MS = 45_000;
+const STORAGE_ROOT = path.resolve(process.cwd(), "storage");
+
+function isPdfFile(file: File) {
+  const extension = file.name.toLowerCase().endsWith(".pdf");
+  const mimeType = file.type === "application/pdf";
+  return extension || mimeType;
+}
+
+function hasPdfSignature(buffer: Buffer) {
+  return buffer.subarray(0, 5).toString("utf8") === "%PDF-";
+}
+
+function guessFileNameFromUrl(url: string) {
+  try {
+    const parsed = new URL(url);
+    const segments = parsed.pathname.split("/").filter(Boolean);
+    const lastSegment = segments.at(-1) ?? "";
+    const decoded = decodeURIComponent(lastSegment).trim();
+    if (!decoded) {
+      return "documento-principal.pdf";
+    }
+
+    return decoded.toLowerCase().endsWith(".pdf") ? decoded : `${decoded}.pdf`;
+  } catch {
+    return "documento-principal.pdf";
+  }
+}
+
+async function fetchSourcePdf(url: string) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), SOURCE_FETCH_TIMEOUT_MS);
+
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      redirect: "follow",
+      signal: controller.signal,
+    });
+
+    if (!response.ok) {
+      throw new Error(`SOURCE_FETCH_FAILED_${response.status}`);
+    }
+
+    const headerLength = response.headers.get("content-length");
+    const sizeHint = headerLength ? Number.parseInt(headerLength, 10) : 0;
+    if (Number.isFinite(sizeHint) && sizeHint > MAX_NORMATIVE_PDF_BYTES) {
+      throw new Error("SOURCE_PDF_TOO_LARGE");
+    }
+
+    const arrayBuffer = await response.arrayBuffer();
+    const buffer = Buffer.from(arrayBuffer);
+
+    if (!buffer.byteLength) {
+      throw new Error("SOURCE_PDF_EMPTY");
+    }
+
+    if (buffer.byteLength > MAX_NORMATIVE_PDF_BYTES) {
+      throw new Error("SOURCE_PDF_TOO_LARGE");
+    }
+
+    return buffer;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+type LicitationSourcePdf = {
+  fileBuffer: Buffer;
+  fileName: string;
+  linkedLicitationId: string;
+  issuingEntity: string | null;
+};
+
+type SourcePdfCandidate = {
+  url: string;
+  fileName: string;
+};
+
+function buildSourcePdfCandidates(documentsRaw: unknown, rawSourceUrl: string | null) {
+  const sourceDocuments = parseLicitationDocumentLinks(documentsRaw);
+  const primaryPdf = pickPrimaryLicitationPdfDocument(sourceDocuments);
+  const primaryAny = pickPrimaryLicitationDocument(sourceDocuments);
+  const candidates: SourcePdfCandidate[] = [];
+  const seen = new Set<string>();
+
+  function pushCandidate(url: string | null | undefined, fileName: string | null | undefined) {
+    const normalizedUrl = typeof url === "string" ? url.trim() : "";
+    if (!normalizedUrl || seen.has(normalizedUrl)) {
+      return;
+    }
+    seen.add(normalizedUrl);
+    candidates.push({
+      url: normalizedUrl,
+      fileName: (fileName?.trim() || guessFileNameFromUrl(normalizedUrl)),
+    });
+  }
+
+  pushCandidate(primaryPdf?.url, primaryPdf?.name);
+  pushCandidate(primaryAny?.url, primaryAny?.name);
+
+  for (const document of sourceDocuments) {
+    pushCandidate(document.url, document.name);
+  }
+
+  if (rawSourceUrl) {
+    const normalizedSourceUrl = rawSourceUrl.trim();
+    const existingIndex = candidates.findIndex((item) => item.url === normalizedSourceUrl);
+
+    if (existingIndex >= 0) {
+      if (isLikelyPdfUrl(normalizedSourceUrl) && existingIndex > 0) {
+        const [entry] = candidates.splice(existingIndex, 1);
+        candidates.unshift(entry);
+      }
+    } else if (isLikelyPdfUrl(normalizedSourceUrl)) {
+      candidates.unshift({
+        url: normalizedSourceUrl,
+        fileName: guessFileNameFromUrl(normalizedSourceUrl),
+      });
+    } else {
+      pushCandidate(normalizedSourceUrl, guessFileNameFromUrl(normalizedSourceUrl));
+    }
+  }
+
+  return candidates;
+}
+
+async function resolveLicitationSourcePdf(sourceLicitationId: string, currentIssuingEntity: string | null): Promise<LicitationSourcePdf> {
+  const sourceLicitation = await prisma.licitation.findUnique({
+    where: { id: sourceLicitationId },
+    select: {
+      id: true,
+      supplierAwarded: true,
+      documents: true,
+      rawSourceUrl: true,
+    },
+  });
+
+  if (!sourceLicitation) {
+    throw new Error("SOURCE_LICITATION_NOT_FOUND");
+  }
+
+  const candidates = buildSourcePdfCandidates(sourceLicitation.documents, sourceLicitation.rawSourceUrl);
+
+  if (candidates.length === 0) {
+    throw new Error("SOURCE_LICITATION_NO_PDF");
+  }
+
+  let sawSourceTooLarge = false;
+  let sawSourceTimeout = false;
+
+  for (const candidate of candidates) {
+    try {
+      const fileBuffer = await fetchSourcePdf(candidate.url);
+      if (!hasPdfSignature(fileBuffer)) {
+        continue;
+      }
+
+      return {
+        fileBuffer,
+        fileName: candidate.fileName,
+        linkedLicitationId: sourceLicitation.id,
+        issuingEntity: currentIssuingEntity || sourceLicitation.supplierAwarded?.trim() || null,
+      };
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.message === "SOURCE_PDF_TOO_LARGE") {
+          sawSourceTooLarge = true;
+        }
+
+        if (error.name === "AbortError") {
+          sawSourceTimeout = true;
+        }
+      }
+    }
+  }
+
+  if (sawSourceTooLarge) {
+    throw new Error("SOURCE_LICITATION_PDF_TOO_LARGE");
+  }
+
+  if (sawSourceTimeout) {
+    throw new Error("SOURCE_LICITATION_PDF_TIMEOUT");
+  }
+
+  throw new Error("SOURCE_LICITATION_NO_VALID_PDF");
+}
+
+type ProposalDocumentSource = {
+  fileName: string;
+  filePath: string;
+  mimeType: string;
+};
+
+function isPdfProposalDocument(document: ProposalDocumentSource) {
+  return document.mimeType === "application/pdf" || document.fileName.toLowerCase().endsWith(".pdf");
+}
+
+function pickPrimaryProposalPdfDocument(documents: ProposalDocumentSource[]) {
+  return documents.find((document) => isPdfProposalDocument(document)) ?? null;
+}
+
+async function readStoredProposalPdf(filePath: string) {
+  const absolutePath = path.resolve(process.cwd(), filePath);
+
+  if (!absolutePath.startsWith(`${STORAGE_ROOT}${path.sep}`)) {
+    throw new Error("PROPOSAL_PDF_INVALID_PATH");
+  }
+
+  try {
+    const buffer = await readFile(absolutePath);
+
+    if (!buffer.byteLength) {
+      throw new Error("PROPOSAL_PDF_EMPTY");
+    }
+
+    if (buffer.byteLength > MAX_NORMATIVE_PDF_BYTES) {
+      throw new Error("PROPOSAL_PDF_TOO_LARGE");
+    }
+
+    return buffer;
+  } catch (error) {
+    if (
+      error &&
+      typeof error === "object" &&
+      "code" in error &&
+      (error as NodeJS.ErrnoException).code === "ENOENT"
+    ) {
+      throw new Error("PROPOSAL_PDF_NOT_FOUND");
+    }
+
+    throw error;
+  }
+}
+
+function parseDocumentType(value: unknown): NormativeDocumentType {
+  if (typeof value !== "string") {
+    return "OTRO";
+  }
+
+  const normalized = value.trim().toUpperCase();
+  if (normalized === "BASES_LICITACION" || normalized === "CONVOCATORIA" || normalized === "ANEXOS" || normalized === "REGLAMENTO" || normalized === "LEY") {
+    return normalized;
+  }
+
+  return "OTRO";
+}
+
+function toPrismaDocumentType(value: NormativeDocumentType): PrismaNormativeDocumentType {
+  if (value === "BASES_LICITACION" || value === "CONVOCATORIA" || value === "REGLAMENTO" || value === "LEY") {
+    return value;
+  }
+
+  return "OTRO";
+}
+
+function toPrismaRiskLevel(value: "alto" | "medio" | "bajo"): NormativeRiskLevel {
+  if (value === "alto") {
+    return "ALTO";
+  }
+
+  if (value === "medio") {
+    return "MEDIO";
+  }
+
+  return "BAJO";
+}
+
+function toPrismaConfidence(value: "low" | "medium" | "high"): NormativeConfidence {
+  if (value === "high") {
+    return "HIGH";
+  }
+
+  if (value === "medium") {
+    return "MEDIUM";
+  }
+
+  return "LOW";
+}
+
+function mapAnalysisError(error: unknown) {
+  if (error instanceof PdfEncryptedError) {
+    return {
+      status: 422,
+      error: "El PDF esta protegido/encriptado. Sube una version sin bloqueo para extraer texto.",
+      code: error.code,
+    };
+  }
+
+  if (error instanceof PdfUnreadableError) {
+    return {
+      status: 422,
+      error: "No fue posible leer el PDF. Verifica que el archivo no este danado.",
+      code: error.code,
+    };
+  }
+
+  if (error instanceof OcrUnavailableError) {
+    return {
+      status: 503,
+      error: "No se detecto texto suficiente y OCRmyPDF no esta disponible.",
+      code: error.code,
+    };
+  }
+
+  if (error instanceof PdfNoTextDetectedError) {
+    return {
+      status: 422,
+      error: "No se detecto texto util en el PDF para analizar.",
+      code: error.code,
+    };
+  }
+
+  if (error instanceof OcrFailedError) {
+    return {
+      status: 422,
+      error: "No se detecto texto suficiente y el OCR fallo durante el procesamiento.",
+      code: error.code,
+    };
+  }
+
+  return {
+    status: 422,
+    error: "No fue posible analizar el PDF.",
+    code: "NORMATIVE_ANALYSIS_FAILED",
+  };
+}
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const formData = await request.formData();
+  const documentType = parseDocumentType(formData.get("documentType"));
+  const issuingEntityRaw = formData.get("issuingEntity");
+  let issuingEntity = typeof issuingEntityRaw === "string" ? issuingEntityRaw.trim() || null : null;
+  const sourceLicitationIdRaw = formData.get("sourceLicitationId");
+  const sourceLicitationId = typeof sourceLicitationIdRaw === "string" ? sourceLicitationIdRaw.trim() || null : null;
+  const sourceProposalIdRaw = formData.get("sourceProposalId");
+  const sourceProposalId = typeof sourceProposalIdRaw === "string" ? sourceProposalIdRaw.trim() || null : null;
+  const fileInput = formData.get("file");
+  const uploadedFile = fileInput instanceof File && fileInput.size > 0 ? fileInput : null;
+  const useSourceDocument = String(formData.get("useSourceDocument") ?? "") === "1";
+
+  try {
+    let fileName = "";
+    let fileBuffer: Buffer | null = null;
+    let linkedLicitationId: string | null = null;
+
+    if (uploadedFile) {
+      if (uploadedFile.size > MAX_NORMATIVE_PDF_BYTES) {
+        return NextResponse.json({ error: "El archivo excede el limite de 20MB." }, { status: 400 });
+      }
+
+      if (!isPdfFile(uploadedFile)) {
+        return NextResponse.json({ error: "Solo se permiten archivos PDF." }, { status: 400 });
+      }
+
+      fileBuffer = Buffer.from(await uploadedFile.arrayBuffer());
+      fileName = uploadedFile.name;
+
+      if (!hasPdfSignature(fileBuffer)) {
+        return NextResponse.json({ error: "El archivo no parece ser un PDF valido." }, { status: 400 });
+      }
+    } else if (sourceProposalId && useSourceDocument) {
+      const sourceProposal = await prisma.proposal.findFirst({
+        where: {
+          id: sourceProposalId,
+          userId: user.id,
+        },
+        select: {
+          id: true,
+          issuingEntity: true,
+          sourceLicitationId: true,
+          documents: {
+            orderBy: [{ createdAt: "desc" }],
+            select: {
+              fileName: true,
+              filePath: true,
+              mimeType: true,
+            },
+          },
+        },
+      });
+
+      if (!sourceProposal) {
+        return NextResponse.json({ error: "No se encontro la propuesta vinculada de Modulo 5." }, { status: 404 });
+      }
+
+      if (!issuingEntity) {
+        issuingEntity = sourceProposal.issuingEntity?.trim() || null;
+      }
+
+      linkedLicitationId = sourceProposal.sourceLicitationId ?? null;
+      const proposalPdf = pickPrimaryProposalPdfDocument(sourceProposal.documents);
+
+      if (proposalPdf) {
+        fileBuffer = await readStoredProposalPdf(proposalPdf.filePath);
+        fileName = proposalPdf.fileName;
+
+        if (!hasPdfSignature(fileBuffer)) {
+          return NextResponse.json({ error: "El PDF principal de Modulo 5 no tiene una firma valida." }, { status: 422 });
+        }
+      } else if (sourceProposal.sourceLicitationId) {
+        const licitationSource = await resolveLicitationSourcePdf(sourceProposal.sourceLicitationId, issuingEntity);
+        fileBuffer = licitationSource.fileBuffer;
+        fileName = licitationSource.fileName;
+        linkedLicitationId = licitationSource.linkedLicitationId;
+        issuingEntity = licitationSource.issuingEntity;
+      } else {
+        return NextResponse.json(
+          { error: "La propuesta de Modulo 5 no tiene un PDF disponible para analisis automatico. Sube un PDF manualmente." },
+          { status: 400 },
+        );
+      }
+    } else if (sourceLicitationId && useSourceDocument) {
+      const licitationSource = await resolveLicitationSourcePdf(sourceLicitationId, issuingEntity);
+      fileBuffer = licitationSource.fileBuffer;
+      fileName = licitationSource.fileName;
+      linkedLicitationId = licitationSource.linkedLicitationId;
+      issuingEntity = licitationSource.issuingEntity;
+    } else {
+      return NextResponse.json(
+        { error: "Debes adjuntar un PDF o vincular una propuesta de Modulo 5 / oportunidad de Modulo 3 para usar su documento principal." },
+        { status: 400 },
+      );
+    }
+
+    if (!fileBuffer) {
+      return NextResponse.json({ error: "No fue posible obtener un documento PDF para analizar." }, { status: 400 });
+    }
+
+    const analyzed = await analyzePdf(fileBuffer);
+    const aiAnalysis = await analyzeNormativeTextWithAi({
+      text: analyzed.text,
+      fileName,
+      documentType,
+      issuingEntity,
+      methodUsed: analyzed.methodUsed,
+      numPages: analyzed.numPages,
+      warnings: analyzed.warnings,
+    });
+    const result = aiAnalysis.result;
+    const combinedWarnings = [
+      ...analyzed.warnings,
+      ...aiAnalysis.warnings,
+      `Motor de analisis: ${aiAnalysis.engine}${aiAnalysis.model ? ` (${aiAnalysis.model})` : ""}`,
+    ];
+
+    if (!linkedLicitationId && sourceLicitationId) {
+      const linkedLicitation = await prisma.licitation.findUnique({
+        where: { id: sourceLicitationId },
+        select: { id: true },
+      });
+      linkedLicitationId = linkedLicitation?.id ?? null;
+    }
+
+    if (!linkedLicitationId && sourceProposalId) {
+      const linkedProposal = await prisma.proposal.findFirst({
+        where: {
+          id: sourceProposalId,
+          userId: user.id,
+        },
+        select: {
+          sourceLicitationId: true,
+        },
+      });
+      linkedLicitationId = linkedProposal?.sourceLicitationId ?? null;
+    }
+
+    const created = await prisma.normativeAnalysisHistory.create({
+      data: {
+        userId: user.id,
+        sourceLicitationId: linkedLicitationId,
+        fileName,
+        documentType: toPrismaDocumentType(documentType),
+        issuingEntity,
+        methodUsed: analyzed.methodUsed === "ocr" ? "OCR" : "DIRECT",
+        numPages: analyzed.numPages,
+        warnings: combinedWarnings,
+        extractedChars: analyzed.text.length,
+        confidence: toPrismaConfidence(result.confidence),
+        viabilityScore: result.participationViability.score,
+        riskLevel: toPrismaRiskLevel(result.risk.level),
+        executiveSummary: result.executiveSummary,
+        result,
+        analyzedAt: new Date(),
+      },
+      select: {
+        id: true,
+        sourceLicitationId: true,
+        fileName: true,
+        documentType: true,
+        issuingEntity: true,
+        methodUsed: true,
+        numPages: true,
+        warnings: true,
+        extractedChars: true,
+        analyzedAt: true,
+        viabilityScore: true,
+        riskLevel: true,
+        confidence: true,
+        result: true,
+      },
+    });
+
+    return NextResponse.json({
+      ok: true,
+      item: toNormativeHistoryView(created),
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Analisis Normativo. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    if (error instanceof Error) {
+      if (error.message === "SOURCE_LICITATION_NOT_FOUND") {
+        return NextResponse.json({ error: "No se encontro la oportunidad vinculada de Modulo 3." }, { status: 404 });
+      }
+
+      if (error.message === "SOURCE_LICITATION_NO_PDF") {
+        return NextResponse.json(
+          { error: "La oportunidad de Modulo 3 no tiene un PDF principal disponible para analisis automatico." },
+          { status: 400 },
+        );
+      }
+
+      if (error.message === "SOURCE_LICITATION_NO_VALID_PDF") {
+        return NextResponse.json(
+          { error: "No se pudo obtener un PDF valido desde los enlaces de la oportunidad en Modulo 3." },
+          { status: 422 },
+        );
+      }
+
+      if (error.message === "SOURCE_LICITATION_PDF_TOO_LARGE") {
+        return NextResponse.json({ error: "Los documentos vinculados de Modulo 3 exceden el limite de 20MB." }, { status: 400 });
+      }
+
+      if (error.message === "SOURCE_LICITATION_PDF_TIMEOUT") {
+        return NextResponse.json({ error: "Se excedio el tiempo al descargar documentos vinculados de Modulo 3." }, { status: 504 });
+      }
+
+      if (error.message === "SOURCE_LICITATION_INVALID_PDF") {
+        return NextResponse.json(
+          { error: "El documento principal de Modulo 3 no tiene una firma PDF valida." },
+          { status: 422 },
+        );
+      }
+
+      if (error.message === "PROPOSAL_PDF_INVALID_PATH") {
+        return NextResponse.json({ error: "El archivo de Modulo 5 no esta disponible para lectura segura." }, { status: 422 });
+      }
+
+      if (error.message === "PROPOSAL_PDF_NOT_FOUND") {
+        return NextResponse.json({ error: "No se encontro el PDF principal cargado en Modulo 5." }, { status: 422 });
+      }
+
+      if (error.message === "PROPOSAL_PDF_EMPTY") {
+        return NextResponse.json({ error: "El PDF principal de Modulo 5 esta vacio." }, { status: 422 });
+      }
+
+      if (error.message === "PROPOSAL_PDF_TOO_LARGE") {
+        return NextResponse.json({ error: "El PDF principal de Modulo 5 excede el limite de 20MB." }, { status: 400 });
+      }
+
+      if (error.name === "AbortError") {
+        return NextResponse.json({ error: "Se excedio el tiempo al descargar el PDF principal de Modulo 3." }, { status: 504 });
+      }
+
+      if (error.message === "SOURCE_PDF_TOO_LARGE") {
+        return NextResponse.json({ error: "El PDF principal de Modulo 3 excede el limite de 20MB." }, { status: 400 });
+      }
+
+      if (error.message === "SOURCE_PDF_EMPTY") {
+        return NextResponse.json({ error: "El PDF principal de Modulo 3 esta vacio." }, { status: 422 });
+      }
+
+      if (error.message.startsWith("SOURCE_FETCH_FAILED_")) {
+        return NextResponse.json({ error: "No fue posible descargar el PDF principal desde la fuente de Modulo 3." }, { status: 422 });
+      }
+    }
+
+    const mapped = mapAnalysisError(error);
+    return NextResponse.json({ error: mapped.error, code: mapped.code }, { status: mapped.status });
+  }
+}
diff --git a/src/app/api/payments/checkout/return/route.ts b/src/app/api/payments/checkout/return/route.ts
new file mode 100644
index 0000000..4dc400b
--- /dev/null
+++ b/src/app/api/payments/checkout/return/route.ts
@@ -0,0 +1,50 @@
+import { NextResponse } from "next/server";
+import { buildAppUrl } from "@/lib/http/url";
+import { fetchMercadoPaymentById, hasMercadoPagoConfig } from "@/lib/payments/mercadopago";
+import { syncPurchaseFromPayment } from "@/lib/payments/subscriptions";
+import { prisma } from "@/lib/prisma";
+
+function pickFirst(url: URL, keys: string[]) {
+  for (const key of keys) {
+    const value = url.searchParams.get(key)?.trim();
+
+    if (value) {
+      return value;
+    }
+  }
+
+  return "";
+}
+
+export async function GET(request: Request) {
+  const requestUrl = new URL(request.url);
+  const result = requestUrl.searchParams.get("result")?.trim() || "pending";
+  const paymentId = pickFirst(requestUrl, ["payment_id", "collection_id"]);
+  const externalReference = pickFirst(requestUrl, ["external_reference"]);
+  const fallbackStatus = pickFirst(requestUrl, ["status", "collection_status"]) || result;
+  const merchantOrderId = pickFirst(requestUrl, ["merchant_order_id"]);
+
+  if (paymentId && externalReference && hasMercadoPagoConfig()) {
+    try {
+      const payment = await fetchMercadoPaymentById(paymentId);
+      const resolvedExternalReference = payment.external_reference || externalReference;
+
+      await syncPurchaseFromPayment(prisma, {
+        externalReference: resolvedExternalReference,
+        paymentId,
+        paymentStatus: payment.status,
+        mercadoOrderId: payment.order?.id || merchantOrderId || null,
+        rawPayload: payment,
+      });
+    } catch {
+      // Callback reconciliation is best-effort; webhook still updates asynchronously.
+    }
+  }
+
+  return NextResponse.redirect(
+    buildAppUrl(request, "/dashboard", {
+      mp_result: result,
+      mp_payment_status: fallbackStatus,
+    }),
+  );
+}
diff --git a/src/app/api/payments/checkout/route.ts b/src/app/api/payments/checkout/route.ts
new file mode 100644
index 0000000..147107e
--- /dev/null
+++ b/src/app/api/payments/checkout/route.ts
@@ -0,0 +1,104 @@
+import { randomUUID } from "crypto";
+import type { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { getSessionPayload } from "@/lib/auth/session";
+import { buildAppUrl, getRequestOrigin } from "@/lib/http/url";
+import { createMercadoPreference, hasMercadoPagoConfig } from "@/lib/payments/mercadopago";
+import { getModulePlanByUiKey } from "@/lib/payments/plans";
+import { prisma } from "@/lib/prisma";
+
+function redirectToDashboard(request: Request, params: Record<string, string>) {
+  return NextResponse.redirect(buildAppUrl(request, "/dashboard", params));
+}
+
+export async function GET(request: Request) {
+  const session = await getSessionPayload();
+
+  if (!session) {
+    return NextResponse.redirect(buildAppUrl(request, "/login", { error: "auth_required" }));
+  }
+
+  const requestUrl = new URL(request.url);
+  const planUiKey = requestUrl.searchParams.get("plan")?.trim() || "";
+  const selectedPlan = getModulePlanByUiKey(planUiKey);
+
+  if (!selectedPlan) {
+    return redirectToDashboard(request, { mp_error: "invalid_plan" });
+  }
+
+  if (!hasMercadoPagoConfig()) {
+    return redirectToDashboard(request, { mp_error: "missing_mp_config" });
+  }
+
+  const user = await prisma.user.findUnique({
+    where: { id: session.userId },
+    select: {
+      id: true,
+      email: true,
+    },
+  });
+
+  if (!user) {
+    return NextResponse.redirect(buildAppUrl(request, "/login", { error: "auth_required" }));
+  }
+
+  const externalReference = `${selectedPlan.key}_${user.id}_${Date.now()}_${randomUUID().slice(0, 8)}`;
+  const origin = getRequestOrigin(request);
+  const returnBase = `${origin}/api/payments/checkout/return`;
+
+  const createdPurchase = await prisma.modulePlanPurchase.create({
+    data: {
+      userId: user.id,
+      planKey: selectedPlan.key,
+      amount: selectedPlan.monthlyPrice,
+      currency: selectedPlan.currency,
+      externalReference,
+      requestJson: {
+        uiPlan: selectedPlan.uiKey,
+        name: selectedPlan.name,
+      },
+    },
+    select: {
+      id: true,
+    },
+  });
+
+  try {
+    const preference = await createMercadoPreference({
+      externalReference,
+      payerEmail: user.email,
+      items: [
+        {
+          id: selectedPlan.uiKey,
+          title: `${selectedPlan.name} Modulos ${selectedPlan.moduleStart}-${selectedPlan.moduleEnd}`,
+          quantity: 1,
+          unit_price: selectedPlan.monthlyPrice,
+          currency_id: selectedPlan.currency,
+        },
+      ],
+      successUrl: `${returnBase}?result=success`,
+      failureUrl: `${returnBase}?result=failure`,
+      pendingUrl: `${returnBase}?result=pending`,
+      notificationUrl: `${origin}/api/payments/mercadopago/webhook`,
+    });
+
+    const checkoutUrl = preference.initPoint || preference.sandboxInitPoint;
+
+    await prisma.modulePlanPurchase.update({
+      where: { id: createdPurchase.id },
+      data: {
+        mercadoPreferenceId: preference.id || null,
+        checkoutUrl: checkoutUrl || null,
+        responseJson: preference.rawPayload as Prisma.InputJsonValue,
+      },
+    });
+
+    if (!checkoutUrl) {
+      return redirectToDashboard(request, { mp_error: "missing_checkout_url" });
+    }
+
+    return NextResponse.redirect(checkoutUrl);
+  } catch {
+    return redirectToDashboard(request, { mp_error: "checkout_create_failed" });
+  }
+}
diff --git a/src/app/api/payments/mercadopago/webhook/route.ts b/src/app/api/payments/mercadopago/webhook/route.ts
new file mode 100644
index 0000000..84a8c63
--- /dev/null
+++ b/src/app/api/payments/mercadopago/webhook/route.ts
@@ -0,0 +1,66 @@
+import { NextResponse } from "next/server";
+import { fetchMercadoPaymentById, hasMercadoPagoConfig } from "@/lib/payments/mercadopago";
+import { syncPurchaseFromPayment } from "@/lib/payments/subscriptions";
+import { prisma } from "@/lib/prisma";
+
+function parseBody(body: unknown) {
+  return typeof body === "object" && body !== null ? (body as Record<string, unknown>) : {};
+}
+
+function parseWebhookPaymentId(url: URL, body: Record<string, unknown>) {
+  const fromQuery = url.searchParams.get("data.id")?.trim() || url.searchParams.get("id")?.trim() || "";
+
+  if (fromQuery) {
+    return fromQuery;
+  }
+
+  const data = typeof body.data === "object" && body.data !== null ? (body.data as Record<string, unknown>) : null;
+  return typeof data?.id === "string" || typeof data?.id === "number" ? String(data.id) : "";
+}
+
+async function processWebhook(request: Request, body: Record<string, unknown>) {
+  if (!hasMercadoPagoConfig()) {
+    return NextResponse.json({ ok: true });
+  }
+
+  const requestUrl = new URL(request.url);
+  const eventType = (typeof body.type === "string" ? body.type : requestUrl.searchParams.get("type") || requestUrl.searchParams.get("topic") || "").toLowerCase();
+  const paymentId = parseWebhookPaymentId(requestUrl, body);
+
+  if (eventType && eventType !== "payment") {
+    return NextResponse.json({ ok: true });
+  }
+
+  if (!paymentId) {
+    return NextResponse.json({ ok: true });
+  }
+
+  try {
+    const payment = await fetchMercadoPaymentById(paymentId);
+
+    if (!payment.external_reference) {
+      return NextResponse.json({ ok: true });
+    }
+
+    await syncPurchaseFromPayment(prisma, {
+      externalReference: payment.external_reference,
+      paymentId,
+      paymentStatus: payment.status,
+      mercadoOrderId: payment.order?.id || null,
+      rawPayload: payment,
+    });
+
+    return NextResponse.json({ ok: true });
+  } catch {
+    return NextResponse.json({ ok: true });
+  }
+}
+
+export async function POST(request: Request) {
+  const body = parseBody(await request.json().catch(() => ({})));
+  return processWebhook(request, body);
+}
+
+export async function GET(request: Request) {
+  return processWebhook(request, {});
+}
diff --git a/src/app/api/proposals/[id]/documents/[documentId]/route.test.ts b/src/app/api/proposals/[id]/documents/[documentId]/route.test.ts
new file mode 100644
index 0000000..bb7c4df
--- /dev/null
+++ b/src/app/api/proposals/[id]/documents/[documentId]/route.test.ts
@@ -0,0 +1,69 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const { requireAdminApiUserMock, readStoredProposalDocumentMock, prismaMock } = vi.hoisted(() => ({
+  requireAdminApiUserMock: vi.fn(),
+  readStoredProposalDocumentMock: vi.fn(),
+  prismaMock: {
+    proposalDocument: {
+      findFirst: vi.fn(),
+      delete: vi.fn(),
+    },
+  },
+}));
+
+vi.mock("@/lib/auth/admin", () => ({
+  requireAdminApiUser: requireAdminApiUserMock,
+}));
+
+vi.mock("@/lib/proposals/storage", async () => {
+  const actual = await vi.importActual<typeof import("@/lib/proposals/storage")>("@/lib/proposals/storage");
+  return {
+    ...actual,
+    readStoredProposalDocument: readStoredProposalDocumentMock,
+  };
+});
+
+vi.mock("@/lib/prisma", () => ({
+  prisma: prismaMock,
+}));
+
+import { GET } from "@/app/api/proposals/[id]/documents/[documentId]/route";
+
+describe("proposal document download API security", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("returns 404 for non-owned or missing proposal document", async () => {
+    requireAdminApiUserMock.mockResolvedValue({ id: "user-1" });
+    prismaMock.proposalDocument.findFirst.mockResolvedValue(null);
+
+    const response = await GET(new Request("http://localhost/api/proposals/p1/documents/d1"), {
+      params: Promise.resolve({ id: "p1", documentId: "d1" }),
+    });
+    const payload = (await response.json()) as { error?: string };
+
+    expect(response.status).toBe(404);
+    expect(payload.error).toContain("Documento no encontrado");
+    expect(readStoredProposalDocumentMock).not.toHaveBeenCalled();
+  });
+
+  it("returns 400 when storage path is invalid", async () => {
+    requireAdminApiUserMock.mockResolvedValue({ id: "user-1" });
+    prismaMock.proposalDocument.findFirst.mockResolvedValue({
+      id: "d1",
+      fileName: "propuesta.pdf",
+      filePath: "../outside.pdf",
+      mimeType: "application/pdf",
+    });
+    readStoredProposalDocumentMock.mockRejectedValue(new Error("PROPOSAL_DOCUMENT_INVALID_PATH"));
+
+    const response = await GET(new Request("http://localhost/api/proposals/p1/documents/d1"), {
+      params: Promise.resolve({ id: "p1", documentId: "d1" }),
+    });
+    const payload = (await response.json()) as { error?: string };
+
+    expect(response.status).toBe(400);
+    expect(payload.error).toContain("Ruta de almacenamiento invalida");
+  });
+});
diff --git a/src/app/api/proposals/[id]/documents/[documentId]/route.ts b/src/app/api/proposals/[id]/documents/[documentId]/route.ts
new file mode 100644
index 0000000..687fc08
--- /dev/null
+++ b/src/app/api/proposals/[id]/documents/[documentId]/route.ts
@@ -0,0 +1,145 @@
+import { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { readStoredProposalDocument, removeStoredProposalDocument } from "@/lib/proposals/storage";
+
+export const runtime = "nodejs";
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+function safeContentDispositionFilename(value: string) {
+  const normalized = value.trim().replace(/[\r\n"]/g, "_");
+  return normalized || "documento";
+}
+
+function mapDocumentReadError(error: unknown) {
+  if (!(error instanceof Error)) {
+    return null;
+  }
+
+  if (error.message === "PROPOSAL_DOCUMENT_NOT_FOUND") {
+    return { status: 404, message: "Archivo no encontrado en almacenamiento." };
+  }
+
+  if (error.message === "PROPOSAL_DOCUMENT_INVALID_PATH") {
+    return { status: 400, message: "Ruta de almacenamiento invalida." };
+  }
+
+  if (error.message === "PROPOSAL_DOCUMENT_EMPTY") {
+    return { status: 400, message: "Archivo vacio en almacenamiento." };
+  }
+
+  if (error.message === "PROPOSAL_DOCUMENT_TOO_LARGE") {
+    return { status: 400, message: "Archivo excede el limite permitido." };
+  }
+
+  return null;
+}
+
+async function getOwnedProposalDocument(params: { userId: string; proposalId: string; documentId: string }) {
+  return prisma.proposalDocument.findFirst({
+    where: {
+      id: params.documentId,
+      proposalId: params.proposalId,
+      userId: params.userId,
+    },
+    select: {
+      id: true,
+      fileName: true,
+      filePath: true,
+      mimeType: true,
+    },
+  });
+}
+
+export async function GET(_: Request, context: { params: Promise<{ id: string; documentId: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id, documentId } = await context.params;
+
+    const document = await getOwnedProposalDocument({
+      userId: user.id,
+      proposalId: id,
+      documentId,
+    });
+
+    if (!document) {
+      return NextResponse.json({ error: "Documento no encontrado." }, { status: 404 });
+    }
+
+    let fileBuffer: Buffer;
+    try {
+      fileBuffer = await readStoredProposalDocument(document.filePath);
+    } catch (error) {
+      const mapped = mapDocumentReadError(error);
+      if (mapped) {
+        return NextResponse.json({ error: mapped.message }, { status: mapped.status });
+      }
+
+      throw error;
+    }
+
+    const encodedFilename = encodeURIComponent(document.fileName);
+    return new NextResponse(new Uint8Array(fileBuffer), {
+      status: 200,
+      headers: {
+        "Content-Type": document.mimeType || "application/octet-stream",
+        "Content-Disposition": `attachment; filename="${safeContentDispositionFilename(document.fileName)}"; filename*=UTF-8''${encodedFilename}`,
+        "Cache-Control": "no-store",
+      },
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible descargar el documento." }, { status: 400 });
+  }
+}
+
+export async function DELETE(_: Request, context: { params: Promise<{ id: string; documentId: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id, documentId } = await context.params;
+
+    const document = await getOwnedProposalDocument({
+      userId: user.id,
+      proposalId: id,
+      documentId,
+    });
+
+    if (!document) {
+      return NextResponse.json({ error: "Documento no encontrado." }, { status: 404 });
+    }
+
+    await removeStoredProposalDocument(document.filePath);
+    await prisma.proposalDocument.delete({ where: { id: document.id } });
+
+    return NextResponse.json({ ok: true });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible eliminar el documento." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/proposals/[id]/documents/route.ts b/src/app/api/proposals/[id]/documents/route.ts
new file mode 100644
index 0000000..d986297
--- /dev/null
+++ b/src/app/api/proposals/[id]/documents/route.ts
@@ -0,0 +1,170 @@
+import { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import {
+  MAX_PROPOSAL_DOCUMENT_BYTES,
+  isAllowedProposalMimeType,
+  storeProposalDocument,
+} from "@/lib/proposals/storage";
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+function toProposalPayload(
+  proposal: {
+    id: string;
+    title: string;
+    issuingEntity: string;
+    summary: string;
+    status: string;
+    sourceLicitationId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    documents: Array<{
+      id: string;
+      fileName: string;
+      mimeType: string;
+      sizeBytes: number;
+      createdAt: Date;
+    }>;
+  } & {
+    currentStep?: number;
+    completionPercent?: number;
+    readyForSubmissionAt?: Date | null;
+  },
+) {
+  return {
+    id: proposal.id,
+    title: proposal.title,
+    issuingEntity: proposal.issuingEntity,
+    summary: proposal.summary,
+    currentStep: proposal.currentStep ?? 1,
+    completionPercent: proposal.completionPercent ?? 0,
+    readyForSubmissionAt: proposal.readyForSubmissionAt ? proposal.readyForSubmissionAt.toISOString() : null,
+    status: proposal.status,
+    sourceLicitationId: proposal.sourceLicitationId,
+    createdAt: proposal.createdAt.toISOString(),
+    updatedAt: proposal.updatedAt.toISOString(),
+    documents: proposal.documents.map((document) => ({
+      id: document.id,
+      fileName: document.fileName,
+      mimeType: document.mimeType,
+      sizeBytes: document.sizeBytes,
+      createdAt: document.createdAt.toISOString(),
+    })),
+  };
+}
+
+export async function POST(request: Request, context: { params: Promise<{ id: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id } = await context.params;
+    const formData = await request.formData();
+    const file = formData.get("file");
+
+    if (!(file instanceof File)) {
+      return NextResponse.json({ error: "Archivo requerido." }, { status: 400 });
+    }
+
+    if (file.size <= 0) {
+      return NextResponse.json({ error: "El archivo esta vacio." }, { status: 400 });
+    }
+
+    if (file.size > MAX_PROPOSAL_DOCUMENT_BYTES) {
+      return NextResponse.json({ error: "El archivo excede el limite de 20MB." }, { status: 400 });
+    }
+
+    if (!isAllowedProposalMimeType(file.type)) {
+      return NextResponse.json({ error: "Tipo de archivo no permitido (PDF, DOC, DOCX, XLSX, JPG o PNG)." }, { status: 400 });
+    }
+
+    const proposal = await prisma.proposal.findFirst({
+      where: {
+        id,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+        status: true,
+      },
+    });
+
+    if (!proposal) {
+      return NextResponse.json({ error: "Propuesta no encontrada." }, { status: 404 });
+    }
+
+    const fileBuffer = Buffer.from(await file.arrayBuffer());
+    const stored = await storeProposalDocument(user.id, proposal.id, file.name, file.type, fileBuffer);
+
+    await prisma.proposalDocument.create({
+      data: {
+        proposalId: proposal.id,
+        userId: user.id,
+        fileName: stored.fileName,
+        storedFileName: stored.storedFileName,
+        filePath: stored.filePath,
+        mimeType: stored.mimeType,
+        sizeBytes: stored.sizeBytes,
+        checksumSha256: stored.checksumSha256,
+      },
+    });
+
+    if (proposal.status === "DRAFT") {
+      await prisma.proposal.update({
+        where: { id: proposal.id },
+        data: {
+          status: "IN_PROGRESS",
+        },
+      });
+    }
+
+    const updated = await prisma.proposal.findUnique({
+      where: { id: proposal.id },
+      select: {
+        id: true,
+        title: true,
+        issuingEntity: true,
+        summary: true,
+        status: true,
+        sourceLicitationId: true,
+        createdAt: true,
+        updatedAt: true,
+        documents: {
+          orderBy: [{ createdAt: "desc" }],
+          select: {
+            id: true,
+            fileName: true,
+            mimeType: true,
+            sizeBytes: true,
+            createdAt: true,
+          },
+        },
+      },
+    });
+
+    if (!updated) {
+      return NextResponse.json({ error: "Propuesta no encontrada." }, { status: 404 });
+    }
+
+    return NextResponse.json({
+      ok: true,
+      proposal: toProposalPayload(updated),
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible subir el documento." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/proposals/[id]/pdf/[kind]/route.ts b/src/app/api/proposals/[id]/pdf/[kind]/route.ts
new file mode 100644
index 0000000..41dbfc6
--- /dev/null
+++ b/src/app/api/proposals/[id]/pdf/[kind]/route.ts
@@ -0,0 +1,106 @@
+import { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { buildPdfFilename, generateProposalPdf, type ProposalPdfKind } from "@/lib/proposals/pdf";
+import { ProposalWorkflowStateSchema } from "@/lib/proposals/workflow-state";
+
+export const runtime = "nodejs";
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+function parseKind(value: string): ProposalPdfKind | null {
+  if (value === "technical" || value === "economic" || value === "summary") {
+    return value;
+  }
+
+  return null;
+}
+
+export async function GET(_: Request, context: { params: Promise<{ id: string; kind: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id, kind: kindParam } = await context.params;
+    const kind = parseKind(kindParam);
+    if (!kind) {
+      return NextResponse.json({ error: "Tipo de PDF invalido." }, { status: 400 });
+    }
+
+    const proposal = await prisma.proposal.findFirst({
+      where: {
+        id,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+        title: true,
+        issuingEntity: true,
+        summary: true,
+        status: true,
+        currentStep: true,
+        completionPercent: true,
+        updatedAt: true,
+        workflowDraft: true,
+      },
+    });
+
+    if (!proposal) {
+      return NextResponse.json({ error: "Propuesta no encontrada." }, { status: 404 });
+    }
+
+    const workflowParsed = ProposalWorkflowStateSchema.safeParse(proposal.workflowDraft);
+    if (!workflowParsed.success) {
+      return NextResponse.json({ error: "No hay flujo persistido valido para generar PDF." }, { status: 400 });
+    }
+
+    const buffer = await generateProposalPdf({
+      kind,
+      proposal: {
+        title: proposal.title,
+        issuingEntity: proposal.issuingEntity,
+        summary: proposal.summary,
+        status: proposal.status,
+        currentStep: proposal.currentStep,
+        completionPercent: proposal.completionPercent,
+        updatedAtIso: proposal.updatedAt.toISOString(),
+      },
+      workflow: workflowParsed.data,
+    });
+
+    const filename = buildPdfFilename({
+      kind,
+      title: proposal.title,
+    });
+    const body = new Uint8Array(buffer);
+
+    return new NextResponse(body, {
+      status: 200,
+      headers: {
+        "Content-Type": "application/pdf",
+        "Content-Disposition": `attachment; filename="${filename}"`,
+        "Cache-Control": "no-store",
+      },
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene los campos de persistencia de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json(
+      {
+        error: "No fue posible generar el PDF. Verifica que Playwright y Chromium esten disponibles en el entorno.",
+      },
+      { status: 400 },
+    );
+  }
+}
diff --git a/src/app/api/proposals/[id]/route.ts b/src/app/api/proposals/[id]/route.ts
new file mode 100644
index 0000000..7928159
--- /dev/null
+++ b/src/app/api/proposals/[id]/route.ts
@@ -0,0 +1,262 @@
+import { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { canTransitionProposalStatus, parseProposalStatus } from "@/lib/proposals/status";
+import { removeStoredProposalDocument } from "@/lib/proposals/storage";
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+function parseString(value: unknown) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function toProposalPayload(
+  proposal: {
+    id: string;
+    title: string;
+    issuingEntity: string;
+    summary: string;
+    status: string;
+    sourceLicitationId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    documents: Array<{
+      id: string;
+      fileName: string;
+      mimeType: string;
+      sizeBytes: number;
+      createdAt: Date;
+      filePath?: string;
+    }>;
+  } & {
+    currentStep?: number;
+    completionPercent?: number;
+    readyForSubmissionAt?: Date | null;
+  },
+) {
+  return {
+    id: proposal.id,
+    title: proposal.title,
+    issuingEntity: proposal.issuingEntity,
+    summary: proposal.summary,
+    currentStep: proposal.currentStep ?? 1,
+    completionPercent: proposal.completionPercent ?? 0,
+    readyForSubmissionAt: proposal.readyForSubmissionAt ? proposal.readyForSubmissionAt.toISOString() : null,
+    status: proposal.status,
+    sourceLicitationId: proposal.sourceLicitationId,
+    createdAt: proposal.createdAt.toISOString(),
+    updatedAt: proposal.updatedAt.toISOString(),
+    documents: proposal.documents.map((document) => ({
+      id: document.id,
+      fileName: document.fileName,
+      mimeType: document.mimeType,
+      sizeBytes: document.sizeBytes,
+      createdAt: document.createdAt.toISOString(),
+    })),
+  };
+}
+
+export async function GET(_: Request, context: { params: Promise<{ id: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id } = await context.params;
+
+    const proposal = await prisma.proposal.findFirst({
+      where: {
+        id,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+        title: true,
+        issuingEntity: true,
+        summary: true,
+        status: true,
+        sourceLicitationId: true,
+        createdAt: true,
+        updatedAt: true,
+        documents: {
+          orderBy: [{ createdAt: "desc" }],
+          select: {
+            id: true,
+            fileName: true,
+            mimeType: true,
+            sizeBytes: true,
+            createdAt: true,
+          },
+        },
+      },
+    });
+
+    if (!proposal) {
+      return NextResponse.json({ error: "Propuesta no encontrada." }, { status: 404 });
+    }
+
+    return NextResponse.json({
+      ok: true,
+      proposal: toProposalPayload(proposal),
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible obtener la propuesta." }, { status: 400 });
+  }
+}
+
+export async function PATCH(request: Request, context: { params: Promise<{ id: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id } = await context.params;
+    const body = (await request.json()) as Record<string, unknown>;
+
+    const proposal = await prisma.proposal.findFirst({
+      where: {
+        id,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+        title: true,
+        issuingEntity: true,
+        summary: true,
+        status: true,
+        sourceLicitationId: true,
+        createdAt: true,
+        updatedAt: true,
+        documents: {
+          orderBy: [{ createdAt: "desc" }],
+          select: {
+            id: true,
+            fileName: true,
+            mimeType: true,
+            sizeBytes: true,
+            createdAt: true,
+          },
+        },
+      },
+    });
+
+    if (!proposal) {
+      return NextResponse.json({ error: "Propuesta no encontrada." }, { status: 404 });
+    }
+
+    const title = parseString(body.title);
+    const issuingEntity = parseString(body.issuingEntity);
+    const summary = parseString(body.summary);
+    const nextStatus = parseProposalStatus(body.status);
+
+    if (body.status != null && !nextStatus) {
+      return NextResponse.json({ error: "Estatus invalido." }, { status: 400 });
+    }
+
+    if (nextStatus && !canTransitionProposalStatus(proposal.status, nextStatus)) {
+      return NextResponse.json({ error: "La transicion de estatus no es valida." }, { status: 400 });
+    }
+
+    const updated = await prisma.proposal.update({
+      where: { id: proposal.id },
+      data: {
+        ...(title ? { title } : {}),
+        ...(issuingEntity ? { issuingEntity } : {}),
+        ...(summary || body.summary === "" ? { summary } : {}),
+        ...(nextStatus ? { status: nextStatus } : {}),
+      },
+      select: {
+        id: true,
+        title: true,
+        issuingEntity: true,
+        summary: true,
+        status: true,
+        sourceLicitationId: true,
+        createdAt: true,
+        updatedAt: true,
+        documents: {
+          orderBy: [{ createdAt: "desc" }],
+          select: {
+            id: true,
+            fileName: true,
+            mimeType: true,
+            sizeBytes: true,
+            createdAt: true,
+          },
+        },
+      },
+    });
+
+    return NextResponse.json({
+      ok: true,
+      proposal: toProposalPayload(updated),
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible actualizar la propuesta." }, { status: 400 });
+  }
+}
+
+export async function DELETE(_: Request, context: { params: Promise<{ id: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id } = await context.params;
+
+    const proposal = await prisma.proposal.findFirst({
+      where: {
+        id,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+        documents: true,
+      },
+    });
+
+    if (!proposal) {
+      return NextResponse.json({ error: "Propuesta no encontrada." }, { status: 404 });
+    }
+
+    for (const document of proposal.documents) {
+      await removeStoredProposalDocument(document.filePath);
+    }
+
+    await prisma.proposal.delete({ where: { id: proposal.id } });
+
+    return NextResponse.json({ ok: true });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible eliminar la propuesta." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/proposals/[id]/workflow/extract/route.test.ts b/src/app/api/proposals/[id]/workflow/extract/route.test.ts
new file mode 100644
index 0000000..f0b0719
--- /dev/null
+++ b/src/app/api/proposals/[id]/workflow/extract/route.test.ts
@@ -0,0 +1,61 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const { requireAdminApiUserMock, prismaMock } = vi.hoisted(() => ({
+  requireAdminApiUserMock: vi.fn(),
+  prismaMock: {
+    licitation: {
+      findUnique: vi.fn(),
+    },
+    normativeAnalysisHistory: {
+      findFirst: vi.fn(),
+      create: vi.fn(),
+    },
+    proposal: {
+      findFirst: vi.fn(),
+      update: vi.fn(),
+    },
+  },
+}));
+
+vi.mock("@/lib/auth/admin", () => ({
+  requireAdminApiUser: requireAdminApiUserMock,
+}));
+
+vi.mock("@/lib/prisma", () => ({
+  prisma: prismaMock,
+}));
+
+import { POST } from "@/app/api/proposals/[id]/workflow/extract/route";
+
+describe("M4 -> M5 extract continuity regression", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("blocks extraction when proposal has no M4 source and no uploaded PDF", async () => {
+    requireAdminApiUserMock.mockResolvedValue({ id: "user-1" });
+    prismaMock.proposal.findFirst.mockResolvedValue({
+      id: "proposal-1",
+      title: "Propuesta sin fuente",
+      issuingEntity: "Entidad",
+      summary: "Resumen",
+      status: "DRAFT",
+      sourceLicitationId: null,
+      workflowDraft: null,
+    });
+
+    const request = new Request("http://localhost/api/proposals/proposal-1/workflow/extract", {
+      method: "POST",
+      body: new FormData(),
+    });
+
+    const response = await POST(request, {
+      params: Promise.resolve({ id: "proposal-1" }),
+    });
+    const payload = (await response.json()) as { error?: string };
+
+    expect(response.status).toBe(400);
+    expect(payload.error).toContain("no tiene fuente de licitacion");
+    expect(prismaMock.normativeAnalysisHistory.findFirst).not.toHaveBeenCalled();
+  });
+});
diff --git a/src/app/api/proposals/[id]/workflow/extract/route.ts b/src/app/api/proposals/[id]/workflow/extract/route.ts
new file mode 100644
index 0000000..417b8b3
--- /dev/null
+++ b/src/app/api/proposals/[id]/workflow/extract/route.ts
@@ -0,0 +1,740 @@
+import {
+  type NormativeConfidence,
+  type NormativeDocumentType as PrismaNormativeDocumentType,
+  type NormativeRiskLevel,
+  Prisma,
+} from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { evaluateSignaturePolicy } from "@/lib/compliance/signature-policy";
+import { parseLicitationDocumentLinks, rankLicitationDocumentsForBundle, type LicitationBundleDocumentKind } from "@/lib/licitations/documents";
+import { type NormativeDocumentType } from "@/lib/normative-analysis/analyze";
+import { analyzeNormativeTextWithAi } from "@/lib/normative-analysis/ai-analyze";
+import { mergeNormativeBundleSources, type NormativeBundleSourceAnalysis } from "@/lib/normative-analysis/bundle";
+import { toNormativeHistoryView } from "@/lib/normative-analysis/history";
+import { analyzePdf } from "@/lib/pdf/analyzePdf";
+import { OcrFailedError, OcrUnavailableError, PdfEncryptedError, PdfNoTextDetectedError, PdfUnreadableError } from "@/lib/pdf/errors";
+import { prisma } from "@/lib/prisma";
+import { canTransitionProposalStatus } from "@/lib/proposals/status";
+import { buildDefaultWorkflowDraft } from "@/lib/proposals/workflow-default";
+import { applyAiSeedsToWorkflow, buildMilestoneSeedsFromAnalysis, buildRequirementSeeds, buildTechnicalSectionSeeds, type WorkflowMilestoneSeed } from "@/lib/proposals/workflow";
+import { ProposalWorkflowStateSchema, computeWorkflowCompletionPercent, computeWorkflowGate } from "@/lib/proposals/workflow-state";
+
+export const runtime = "nodejs";
+
+const MAX_NORMATIVE_PDF_BYTES = 20 * 1024 * 1024;
+const SOURCE_FETCH_TIMEOUT_MS = 45_000;
+
+type BundleCandidate = {
+  sourceId: string;
+  fileName: string;
+  documentType: NormativeDocumentType;
+  fileBuffer: Buffer;
+};
+
+function logContinuityHandoff(event: string, data: Record<string, unknown>) {
+  console.info(
+    "[continuity_handoff]",
+    JSON.stringify({
+      event,
+      at: new Date().toISOString(),
+      ...data,
+    }),
+  );
+}
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+function parseDocumentType(value: unknown): NormativeDocumentType {
+  if (typeof value !== "string") {
+    return "BASES_LICITACION";
+  }
+
+  const normalized = value.trim().toUpperCase();
+  if (normalized === "BASES_LICITACION" || normalized === "CONVOCATORIA" || normalized === "ANEXOS" || normalized === "REGLAMENTO" || normalized === "LEY") {
+    return normalized;
+  }
+
+  return "OTRO";
+}
+
+function mapBundleKindToDocumentType(kind: LicitationBundleDocumentKind): NormativeDocumentType {
+  if (kind === "BASES_LICITACION") {
+    return "BASES_LICITACION";
+  }
+
+  if (kind === "CONVOCATORIA") {
+    return "CONVOCATORIA";
+  }
+
+  if (kind === "ANEXOS") {
+    return "ANEXOS";
+  }
+
+  return "OTRO";
+}
+
+function inferDocumentTypeFromName(fileName: string): NormativeDocumentType {
+  const lower = fileName
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .toLowerCase();
+
+  if (/\bbase(s)?\b|\bpliego\b|\bterminos\b/.test(lower)) {
+    return "BASES_LICITACION";
+  }
+
+  if (/\bconvocatoria\b|\binvitacion\b/.test(lower)) {
+    return "CONVOCATORIA";
+  }
+
+  if (/\banexo(s)?\b|\bformato(s)?\b/.test(lower)) {
+    return "ANEXOS";
+  }
+
+  return "OTRO";
+}
+
+function guessFileNameFromUrl(url: string) {
+  try {
+    const parsed = new URL(url);
+    const segments = parsed.pathname.split("/").filter(Boolean);
+    const lastSegment = segments.at(-1) ?? "";
+    const decoded = decodeURIComponent(lastSegment).trim();
+    if (!decoded) {
+      return "documento-principal.pdf";
+    }
+
+    return decoded.toLowerCase().endsWith(".pdf") ? decoded : `${decoded}.pdf`;
+  } catch {
+    return "documento-principal.pdf";
+  }
+}
+
+function toPrismaDocumentType(value: NormativeDocumentType): PrismaNormativeDocumentType {
+  if (value === "BASES_LICITACION" || value === "CONVOCATORIA" || value === "REGLAMENTO" || value === "LEY") {
+    return value;
+  }
+
+  return "OTRO";
+}
+
+function toPrismaRiskLevel(value: "alto" | "medio" | "bajo"): NormativeRiskLevel {
+  if (value === "alto") {
+    return "ALTO";
+  }
+
+  if (value === "medio") {
+    return "MEDIO";
+  }
+
+  return "BAJO";
+}
+
+function toPrismaConfidence(value: "low" | "medium" | "high"): NormativeConfidence {
+  if (value === "high") {
+    return "HIGH";
+  }
+
+  if (value === "medium") {
+    return "MEDIUM";
+  }
+
+  return "LOW";
+}
+
+function hasPdfSignature(buffer: Buffer) {
+  return buffer.subarray(0, 5).toString("utf8") === "%PDF-";
+}
+
+async function fetchSourcePdf(url: string) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), SOURCE_FETCH_TIMEOUT_MS);
+
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      redirect: "follow",
+      signal: controller.signal,
+    });
+
+    if (!response.ok) {
+      throw new Error(`SOURCE_FETCH_FAILED_${response.status}`);
+    }
+
+    const headerLength = response.headers.get("content-length");
+    const sizeHint = headerLength ? Number.parseInt(headerLength, 10) : 0;
+    if (Number.isFinite(sizeHint) && sizeHint > MAX_NORMATIVE_PDF_BYTES) {
+      throw new Error("SOURCE_PDF_TOO_LARGE");
+    }
+
+    const arrayBuffer = await response.arrayBuffer();
+    const buffer = Buffer.from(arrayBuffer);
+    if (!buffer.byteLength) {
+      throw new Error("SOURCE_PDF_EMPTY");
+    }
+
+    if (buffer.byteLength > MAX_NORMATIVE_PDF_BYTES) {
+      throw new Error("SOURCE_PDF_TOO_LARGE");
+    }
+
+    if (!hasPdfSignature(buffer)) {
+      throw new Error("SOURCE_PDF_INVALID");
+    }
+
+    return buffer;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+function parseDateCandidate(value: unknown) {
+  if (typeof value !== "string") {
+    return null;
+  }
+
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return null;
+  }
+
+  return parsed;
+}
+
+function toMilestoneSeeds(args: {
+  openingDate: Date | null;
+  closingDate: Date | null;
+  eventDates: Prisma.JsonValue | null;
+}): WorkflowMilestoneSeed[] {
+  const milestones: WorkflowMilestoneSeed[] = [];
+
+  if (args.openingDate) {
+    milestones.push({
+      id: "opening-date",
+      title: "Apertura del proceso",
+      dateIso: args.openingDate.toISOString(),
+      location: "",
+      note: "",
+      source: "licitation",
+    });
+  }
+
+  if (args.closingDate) {
+    milestones.push({
+      id: "closing-date",
+      title: "Presentacion de propuestas",
+      dateIso: args.closingDate.toISOString(),
+      location: "",
+      note: "",
+      source: "licitation",
+    });
+  }
+
+  if (args.eventDates && typeof args.eventDates === "object" && !Array.isArray(args.eventDates)) {
+    const entries = Object.entries(args.eventDates as Record<string, unknown>);
+    for (let index = 0; index < entries.length; index += 1) {
+      const [key, value] = entries[index];
+      const parsed = parseDateCandidate(value);
+      milestones.push({
+        id: `event-date-${index + 1}`,
+        title: key || `Evento ${index + 1}`,
+        dateIso: parsed ? parsed.toISOString() : null,
+        location: "",
+        note: "",
+        source: "licitation",
+      });
+    }
+  }
+
+  return milestones;
+}
+
+function mapAnalysisError(error: unknown) {
+  if (error instanceof PdfEncryptedError) {
+    return {
+      status: 422,
+      error: "El PDF esta protegido/encriptado. Sube una version sin bloqueo para extraer texto.",
+      code: error.code,
+    };
+  }
+
+  if (error instanceof PdfUnreadableError) {
+    return {
+      status: 422,
+      error: "No fue posible leer el PDF. Verifica que el archivo no este danado.",
+      code: error.code,
+    };
+  }
+
+  if (error instanceof OcrUnavailableError) {
+    return {
+      status: 503,
+      error: "No se detecto texto suficiente y OCRmyPDF no esta disponible.",
+      code: error.code,
+    };
+  }
+
+  if (error instanceof PdfNoTextDetectedError) {
+    return {
+      status: 422,
+      error: "No se detecto texto util en el PDF para analizar.",
+      code: error.code,
+    };
+  }
+
+  if (error instanceof OcrFailedError) {
+    return {
+      status: 422,
+      error: "No se detecto texto suficiente y el OCR fallo durante el procesamiento.",
+      code: error.code,
+    };
+  }
+
+  return {
+    status: 422,
+    error: "No fue posible analizar el PDF.",
+    code: "NORMATIVE_ANALYSIS_FAILED",
+  };
+}
+
+export async function POST(request: Request, context: { params: Promise<{ id: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id } = await context.params;
+    const proposal = await prisma.proposal.findFirst({
+      where: {
+        id,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+        title: true,
+        issuingEntity: true,
+        summary: true,
+        status: true,
+        sourceLicitationId: true,
+        workflowDraft: true,
+      },
+    });
+
+    if (!proposal) {
+      return NextResponse.json({ error: "Propuesta no encontrada." }, { status: 404 });
+    }
+
+    const linkedSource = proposal.sourceLicitationId
+      ? await prisma.licitation.findUnique({
+          where: { id: proposal.sourceLicitationId },
+          include: {
+            municipality: {
+              select: {
+                stateName: true,
+                municipalityName: true,
+              },
+            },
+          },
+        })
+      : null;
+
+    const formData = await request.formData().catch(() => null);
+    const filesFromMulti = formData
+      ? formData.getAll("files").filter((item): item is File => item instanceof File && item.size > 0)
+      : [];
+    const maybeSingleFile = formData ? formData.get("file") : null;
+    const singleFile = maybeSingleFile instanceof File && maybeSingleFile.size > 0 ? maybeSingleFile : null;
+    const uploadedFiles = filesFromMulti.length > 0 ? filesFromMulti : singleFile ? [singleFile] : [];
+    const documentType = parseDocumentType(formData?.get("documentType"));
+    const issuingEntityFromRequest = typeof formData?.get("issuingEntity") === "string" ? String(formData?.get("issuingEntity")).trim() : "";
+    const issuingEntity = issuingEntityFromRequest || proposal.issuingEntity || linkedSource?.supplierAwarded || null;
+    const requestedDocumentTypes = formData
+      ? formData
+          .getAll("documentTypes")
+          .map((value) => parseDocumentType(value))
+      : [];
+
+    logContinuityHandoff("m4_to_m5_extract_requested", {
+      userId: user.id,
+      proposalId: proposal.id,
+      sourceLicitationId: proposal.sourceLicitationId,
+      uploadedFiles: uploadedFiles.length,
+    });
+
+    let analysisResult: ReturnType<typeof toNormativeHistoryView>["result"] | null = null;
+    let analysisMeta: {
+      source: "module4_history" | "uploaded_pdf";
+      engine: string | null;
+      model: string | null;
+      warnings: string[];
+      historyId: string | null;
+      bundle?: {
+        sources: Array<{ sourceId: string; fileName: string; documentType: NormativeDocumentType; historyId: string | null }>;
+        conflicts: Array<{ title: string; field: string; keptDocumentType: NormativeDocumentType; replacedDocumentType: NormativeDocumentType }>;
+      };
+    } = {
+      source: "module4_history",
+      engine: null,
+      model: null,
+      warnings: [],
+      historyId: null,
+      bundle: {
+        sources: [],
+        conflicts: [],
+      },
+    };
+
+    const bundleCandidates: BundleCandidate[] = [];
+
+    if (uploadedFiles.length > 0) {
+      for (let index = 0; index < uploadedFiles.length; index += 1) {
+        const file = uploadedFiles[index];
+        if (!file.name.toLowerCase().endsWith(".pdf") && file.type !== "application/pdf") {
+          return NextResponse.json({ error: "Solo se permiten archivos PDF para extraccion IA." }, { status: 400 });
+        }
+
+        if (file.size > MAX_NORMATIVE_PDF_BYTES) {
+          return NextResponse.json({ error: "El archivo excede el limite de 20MB." }, { status: 400 });
+        }
+
+        const buffer = Buffer.from(await file.arrayBuffer());
+        if (!hasPdfSignature(buffer)) {
+          return NextResponse.json({ error: "El archivo no parece ser un PDF valido." }, { status: 400 });
+        }
+
+        const inferredType = inferDocumentTypeFromName(file.name);
+        const resolvedType =
+          requestedDocumentTypes[index] ??
+          (uploadedFiles.length === 1 && documentType !== "OTRO" ? documentType : inferredType !== "OTRO" ? inferredType : "OTRO");
+
+        bundleCandidates.push({
+          sourceId: `upload-${index + 1}`,
+          fileName: file.name,
+          fileBuffer: buffer,
+          documentType: resolvedType,
+        });
+      }
+    } else if (linkedSource) {
+      const sourceDocuments = parseLicitationDocumentLinks(linkedSource.documents);
+      const ranked = rankLicitationDocumentsForBundle(sourceDocuments, 1);
+      const ordered = [...ranked.bases, ...ranked.convocatoria, ...ranked.anexos, ...ranked.extras];
+      const rawSourceUrl = linkedSource.rawSourceUrl?.trim() ?? "";
+      const candidateDocuments = [...ordered];
+
+      if (rawSourceUrl && !candidateDocuments.some((item) => item.url === rawSourceUrl)) {
+        candidateDocuments.push({
+          name: guessFileNameFromUrl(rawSourceUrl),
+          url: rawSourceUrl,
+          type: null,
+          bundleKind: "OTRO",
+          bundleScore: -10_000,
+        });
+      }
+
+      for (let index = 0; index < candidateDocuments.length && index < 6; index += 1) {
+        const document = candidateDocuments[index];
+        try {
+          const buffer = await fetchSourcePdf(document.url);
+          bundleCandidates.push({
+            sourceId: `source-${index + 1}`,
+            fileName: document.name,
+            fileBuffer: buffer,
+            documentType: mapBundleKindToDocumentType(document.bundleKind),
+          });
+        } catch (error) {
+          analysisMeta.warnings.push(error instanceof Error ? `No se pudo leer ${document.name}: ${error.message}` : `No se pudo leer ${document.name}.`);
+        }
+      }
+    }
+
+    if (bundleCandidates.length > 0) {
+      const bundleAnalyses: NormativeBundleSourceAnalysis[] = [];
+
+      for (const candidate of bundleCandidates.slice(0, 3)) {
+        try {
+          const analyzed = await analyzePdf(candidate.fileBuffer);
+          const aiAnalysis = await analyzeNormativeTextWithAi({
+            text: analyzed.text,
+            fileName: candidate.fileName,
+            documentType: candidate.documentType,
+            issuingEntity,
+            methodUsed: analyzed.methodUsed,
+            numPages: analyzed.numPages,
+            warnings: analyzed.warnings,
+          });
+
+          const combinedWarnings = [
+            ...analyzed.warnings,
+            ...aiAnalysis.warnings,
+            `Motor de analisis: ${aiAnalysis.engine}${aiAnalysis.model ? ` (${aiAnalysis.model})` : ""}`,
+          ];
+
+          const createdHistory = await prisma.normativeAnalysisHistory.create({
+            data: {
+              userId: user.id,
+              sourceLicitationId: linkedSource?.id ?? null,
+              fileName: candidate.fileName,
+              documentType: toPrismaDocumentType(candidate.documentType),
+              issuingEntity,
+              methodUsed: analyzed.methodUsed === "ocr" ? "OCR" : "DIRECT",
+              numPages: analyzed.numPages,
+              warnings: combinedWarnings,
+              extractedChars: analyzed.text.length,
+              confidence: toPrismaConfidence(aiAnalysis.result.confidence),
+              viabilityScore: aiAnalysis.result.participationViability.score,
+              riskLevel: toPrismaRiskLevel(aiAnalysis.result.risk.level),
+              executiveSummary: aiAnalysis.result.executiveSummary,
+              result: aiAnalysis.result,
+              analyzedAt: new Date(),
+            },
+            select: {
+              id: true,
+            },
+          });
+
+          bundleAnalyses.push({
+            sourceId: candidate.sourceId,
+            fileName: candidate.fileName,
+            documentType: candidate.documentType,
+            result: aiAnalysis.result,
+          });
+
+          analysisMeta.source = "uploaded_pdf";
+          analysisMeta.engine = analysisMeta.engine ?? aiAnalysis.engine;
+          analysisMeta.model = analysisMeta.model ?? aiAnalysis.model;
+          analysisMeta.historyId = analysisMeta.historyId ?? createdHistory.id;
+          analysisMeta.warnings.push(...combinedWarnings);
+          analysisMeta.bundle?.sources.push({
+            sourceId: candidate.sourceId,
+            fileName: candidate.fileName,
+            documentType: candidate.documentType,
+            historyId: createdHistory.id,
+          });
+        } catch (error) {
+          const mapped = mapAnalysisError(error);
+          analysisMeta.warnings.push(`${candidate.fileName}: ${mapped.error}`);
+        }
+      }
+
+      if (bundleAnalyses.length === 0) {
+        return NextResponse.json({ error: "No fue posible analizar los documentos del bundle." }, { status: 422 });
+      }
+
+      if (bundleAnalyses.length === 1) {
+        analysisResult = bundleAnalyses[0]?.result ?? null;
+      } else {
+        const merged = mergeNormativeBundleSources(bundleAnalyses);
+        analysisResult = merged.result;
+        analysisMeta.bundle = {
+          sources: merged.sources.map((item) => ({
+            ...item,
+            historyId: analysisMeta.bundle?.sources.find((source) => source.sourceId === item.sourceId)?.historyId ?? null,
+          })),
+          conflicts: merged.conflicts.map((conflict) => ({
+            title: conflict.title,
+            field: conflict.field,
+            keptDocumentType: conflict.keptDocumentType,
+            replacedDocumentType: conflict.replacedDocumentType,
+          })),
+        };
+      }
+    } else {
+      if (!proposal.sourceLicitationId) {
+        logContinuityHandoff("m4_to_m5_extract_blocked_no_source_context", {
+          userId: user.id,
+          proposalId: proposal.id,
+        });
+        return NextResponse.json(
+          { error: "La propuesta no tiene fuente de licitacion vinculada de Modulo 4. Sube un PDF para extraer requisitos con IA." },
+          { status: 400 },
+        );
+      }
+
+      const historyEntry = await prisma.normativeAnalysisHistory.findFirst({
+        where: {
+          userId: user.id,
+          deletedAt: null,
+          sourceLicitationId: proposal.sourceLicitationId,
+        },
+        orderBy: [{ analyzedAt: "desc" }],
+        select: {
+          id: true,
+          sourceLicitationId: true,
+          fileName: true,
+          documentType: true,
+          issuingEntity: true,
+          methodUsed: true,
+          numPages: true,
+          warnings: true,
+          extractedChars: true,
+          analyzedAt: true,
+          viabilityScore: true,
+          riskLevel: true,
+          confidence: true,
+          result: true,
+        },
+      });
+
+      if (!historyEntry) {
+        logContinuityHandoff("m4_to_m5_extract_blocked_no_history", {
+          userId: user.id,
+          proposalId: proposal.id,
+          sourceLicitationId: proposal.sourceLicitationId,
+        });
+        return NextResponse.json(
+          { error: "No hay analisis previo de Modulo 4 vinculado. Sube un PDF para extraer requisitos con IA." },
+          { status: 400 },
+        );
+      }
+
+      const historyView = toNormativeHistoryView(historyEntry);
+      analysisResult = historyView.result;
+      analysisMeta = {
+        source: "module4_history",
+        engine: "module4_history",
+        model: null,
+        warnings: historyView.warnings,
+        historyId: historyView.id,
+        bundle: {
+          sources: [
+            {
+              sourceId: `history-${historyView.id}`,
+              fileName: historyView.fileName,
+              documentType: historyView.documentType,
+              historyId: historyView.id,
+            },
+          ],
+          conflicts: [],
+        },
+      };
+    }
+
+    if (!analysisResult) {
+      return NextResponse.json({ error: "No se pudo recuperar resultado de analisis IA." }, { status: 400 });
+    }
+
+    const requirementSeeds = buildRequirementSeeds(analysisResult);
+    const technicalSectionSeeds = buildTechnicalSectionSeeds(analysisResult);
+    const aiMilestoneSeeds = buildMilestoneSeedsFromAnalysis(analysisResult);
+    const sourceMilestoneSeeds = linkedSource
+      ? toMilestoneSeeds({
+          openingDate: linkedSource.openingDate,
+          closingDate: linkedSource.closingDate,
+          eventDates: linkedSource.eventDates,
+        })
+      : [];
+    const milestoneSeeds = [...sourceMilestoneSeeds, ...aiMilestoneSeeds];
+    const existingWorkflowParsed = ProposalWorkflowStateSchema.safeParse(proposal.workflowDraft);
+    const defaultDraft = buildDefaultWorkflowDraft({
+      proposal: {
+        title: proposal.title,
+        issuingEntity: proposal.issuingEntity,
+        summary: proposal.summary,
+        status: proposal.status,
+      },
+      linkedSource: linkedSource
+        ? {
+            title: linkedSource.title,
+            description: linkedSource.description,
+            issuingEntity: linkedSource.supplierAwarded,
+            procedureType: linkedSource.procedureType,
+            stateName: linkedSource.municipality.stateName,
+            municipalityName: linkedSource.municipality.municipalityName,
+            sourceUrl: linkedSource.rawSourceUrl,
+            milestones: milestoneSeeds,
+          }
+        : null,
+      requirementSeeds,
+      technicalSectionSeeds,
+    });
+
+    const baseWorkflow = existingWorkflowParsed.success ? existingWorkflowParsed.data : defaultDraft;
+    const mergedWorkflow = applyAiSeedsToWorkflow(baseWorkflow, {
+      requirementSeeds,
+      technicalSectionSeeds,
+      milestoneSeeds,
+    });
+    const extractedDocumentType = analysisMeta.bundle?.sources[0]?.documentType ?? documentType;
+    const signaturePolicy = evaluateSignaturePolicy({
+      stateName: linkedSource?.municipality.stateName ?? null,
+      municipalityName: linkedSource?.municipality.municipalityName ?? null,
+      documentType: extractedDocumentType,
+    });
+    const workflow = {
+      ...mergedWorkflow,
+      signatureCompliance: {
+        ...mergedWorkflow.signatureCompliance,
+        policyStatus: signaturePolicy.policyStatus,
+        policyName: signaturePolicy.policyName,
+        jurisdictionLabel: signaturePolicy.jurisdictionLabel,
+        sourceUrl: signaturePolicy.sourceUrl ?? "",
+        minimumEvidence: signaturePolicy.evidenceRequired,
+        notes: signaturePolicy.notes,
+      },
+      step: Math.max(2, mergedWorkflow.step),
+    };
+
+    const completionPercent = computeWorkflowCompletionPercent(workflow);
+    const gate = computeWorkflowGate(workflow);
+
+    const nextStatus =
+      proposal.status === "DRAFT" && completionPercent > 0 && canTransitionProposalStatus("DRAFT", "IN_PROGRESS") ? "IN_PROGRESS" : proposal.status;
+
+    const updated = await prisma.proposal.update({
+      where: { id: proposal.id },
+      data: {
+        workflowDraft: workflow as Prisma.InputJsonValue,
+        currentStep: workflow.step,
+        completionPercent,
+        ...(nextStatus !== proposal.status ? { status: nextStatus } : {}),
+        ...(gate.allReady ? {} : { readyForSubmissionAt: null }),
+      },
+      select: {
+        id: true,
+        status: true,
+        currentStep: true,
+        completionPercent: true,
+        readyForSubmissionAt: true,
+      },
+    });
+
+    logContinuityHandoff("m4_to_m5_extract_completed", {
+      userId: user.id,
+      proposalId: proposal.id,
+      sourceLicitationId: proposal.sourceLicitationId,
+      analysisSource: analysisMeta.source,
+      historyId: analysisMeta.historyId,
+      bundleSources: analysisMeta.bundle?.sources.length ?? 0,
+      bundleConflicts: analysisMeta.bundle?.conflicts.length ?? 0,
+      completionPercent,
+      currentStep: updated.currentStep,
+    });
+
+    return NextResponse.json({
+      ok: true,
+      proposal: {
+        id: updated.id,
+        status: updated.status,
+        currentStep: updated.currentStep,
+        completionPercent: updated.completionPercent,
+        readyForSubmissionAt: updated.readyForSubmissionAt ? updated.readyForSubmissionAt.toISOString() : null,
+      },
+      workflow,
+      gate,
+      analysis: analysisMeta,
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene los campos de persistencia de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible extraer requisitos con IA." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/proposals/[id]/workflow/mark-ready/route.ts b/src/app/api/proposals/[id]/workflow/mark-ready/route.ts
new file mode 100644
index 0000000..b4a1583
--- /dev/null
+++ b/src/app/api/proposals/[id]/workflow/mark-ready/route.ts
@@ -0,0 +1,131 @@
+import { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { canTransitionProposalStatus } from "@/lib/proposals/status";
+import { ProposalWorkflowStateSchema, computeWorkflowCompletionPercent, computeWorkflowGate } from "@/lib/proposals/workflow-state";
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+export async function POST(_: Request, context: { params: Promise<{ id: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id } = await context.params;
+
+    const proposal = await prisma.proposal.findFirst({
+      where: {
+        id,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+        status: true,
+        workflowDraft: true,
+      },
+    });
+
+    if (!proposal) {
+      return NextResponse.json({ error: "Propuesta no encontrada." }, { status: 404 });
+    }
+
+    if (proposal.status === "ARCHIVED") {
+      return NextResponse.json({ error: "No puedes marcar una propuesta archivada." }, { status: 400 });
+    }
+
+    const parsedWorkflow = ProposalWorkflowStateSchema.safeParse(proposal.workflowDraft);
+    if (!parsedWorkflow.success) {
+      return NextResponse.json({ error: "No hay flujo persistido valido para validar la propuesta." }, { status: 400 });
+    }
+
+    const workflow = parsedWorkflow.data;
+    const gate = computeWorkflowGate(workflow);
+    if (!gate.allReady) {
+      return NextResponse.json(
+        {
+          error: "No se cumplen todos los requisitos para marcar como Lista para Envio.",
+          gate,
+        },
+        { status: 400 },
+      );
+    }
+
+    const completionPercent = computeWorkflowCompletionPercent(workflow);
+    const persistedWorkflow = {
+      ...workflow,
+      readyMarked: true,
+      step: 6,
+    };
+
+    const updated = await prisma.$transaction(async (tx) => {
+      if (proposal.status === "DRAFT") {
+        if (!canTransitionProposalStatus("DRAFT", "IN_PROGRESS")) {
+          throw new Error("Transicion invalida de estatus.");
+        }
+
+        await tx.proposal.update({
+          where: { id: proposal.id },
+          data: { status: "IN_PROGRESS" },
+        });
+      }
+
+      const current = await tx.proposal.findUnique({
+        where: { id: proposal.id },
+        select: { status: true },
+      });
+
+      if (!current) {
+        throw new Error("Propuesta no encontrada.");
+      }
+
+      if (current.status !== "SUBMITTED" && !canTransitionProposalStatus(current.status, "SUBMITTED")) {
+        throw new Error("Transicion invalida de estatus.");
+      }
+
+      return tx.proposal.update({
+        where: { id: proposal.id },
+        data: {
+          status: "SUBMITTED",
+          workflowDraft: persistedWorkflow as Prisma.InputJsonValue,
+          completionPercent,
+          currentStep: 6,
+          readyForSubmissionAt: new Date(),
+        },
+        select: {
+          id: true,
+          status: true,
+          currentStep: true,
+          completionPercent: true,
+          readyForSubmissionAt: true,
+        },
+      });
+    });
+
+    return NextResponse.json({
+      ok: true,
+      proposal: {
+        id: updated.id,
+        status: updated.status,
+        currentStep: updated.currentStep,
+        completionPercent: updated.completionPercent,
+        readyForSubmissionAt: updated.readyForSubmissionAt ? updated.readyForSubmissionAt.toISOString() : null,
+      },
+      gate,
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene los campos de persistencia de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible marcar la propuesta como lista para envio." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/proposals/[id]/workflow/route.ts b/src/app/api/proposals/[id]/workflow/route.ts
new file mode 100644
index 0000000..9f43141
--- /dev/null
+++ b/src/app/api/proposals/[id]/workflow/route.ts
@@ -0,0 +1,163 @@
+import { Prisma, type ProposalStatus } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { canTransitionProposalStatus } from "@/lib/proposals/status";
+import { ProposalWorkflowStateSchema, clampWorkflowStep, computeWorkflowCompletionPercent, computeWorkflowGate, type ProposalWorkflowState } from "@/lib/proposals/workflow-state";
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+function parseWorkflowState(value: unknown): ProposalWorkflowState | null {
+  const parsed = ProposalWorkflowStateSchema.safeParse(value);
+  if (!parsed.success) {
+    return null;
+  }
+
+  return {
+    ...parsed.data,
+    step: clampWorkflowStep(parsed.data.step),
+  };
+}
+
+function nextStatusFromDraft(progressStatus: ProposalStatus, completionPercent: number): ProposalStatus {
+  if (completionPercent <= 0 || progressStatus !== "DRAFT") {
+    return progressStatus;
+  }
+
+  return canTransitionProposalStatus(progressStatus, "IN_PROGRESS") ? "IN_PROGRESS" : progressStatus;
+}
+
+export async function GET(_: Request, context: { params: Promise<{ id: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id } = await context.params;
+
+    const proposal = await prisma.proposal.findFirst({
+      where: {
+        id,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+        status: true,
+        currentStep: true,
+        completionPercent: true,
+        readyForSubmissionAt: true,
+        workflowDraft: true,
+      },
+    });
+
+    if (!proposal) {
+      return NextResponse.json({ error: "Propuesta no encontrada." }, { status: 404 });
+    }
+
+    const workflow = parseWorkflowState(proposal.workflowDraft);
+    const gate = workflow ? computeWorkflowGate(workflow) : null;
+
+    return NextResponse.json({
+      ok: true,
+      proposal: {
+        id: proposal.id,
+        status: proposal.status,
+        currentStep: proposal.currentStep,
+        completionPercent: proposal.completionPercent,
+        readyForSubmissionAt: proposal.readyForSubmissionAt ? proposal.readyForSubmissionAt.toISOString() : null,
+      },
+      workflow,
+      gate,
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene los campos de persistencia de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible cargar el flujo de trabajo." }, { status: 400 });
+  }
+}
+
+export async function PATCH(request: Request, context: { params: Promise<{ id: string }> }) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const { id } = await context.params;
+    const body = (await request.json()) as Record<string, unknown>;
+    const workflow = parseWorkflowState(body.workflow);
+
+    if (!workflow) {
+      return NextResponse.json({ error: "Workflow invalido." }, { status: 400 });
+    }
+
+    const proposal = await prisma.proposal.findFirst({
+      where: {
+        id,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+        status: true,
+      },
+    });
+
+    if (!proposal) {
+      return NextResponse.json({ error: "Propuesta no encontrada." }, { status: 404 });
+    }
+
+    const gate = computeWorkflowGate(workflow);
+    const completionPercent = computeWorkflowCompletionPercent(workflow);
+    const nextStatus = nextStatusFromDraft(proposal.status, completionPercent);
+
+    const updated = await prisma.proposal.update({
+      where: { id: proposal.id },
+      data: {
+        workflowDraft: workflow as Prisma.InputJsonValue,
+        currentStep: workflow.step,
+        completionPercent,
+        ...(proposal.status !== nextStatus ? { status: nextStatus } : {}),
+        ...(gate.allReady ? {} : { readyForSubmissionAt: null }),
+      },
+      select: {
+        id: true,
+        status: true,
+        currentStep: true,
+        completionPercent: true,
+        readyForSubmissionAt: true,
+      },
+    });
+
+    return NextResponse.json({
+      ok: true,
+      proposal: {
+        id: updated.id,
+        status: updated.status,
+        currentStep: updated.currentStep,
+        completionPercent: updated.completionPercent,
+        readyForSubmissionAt: updated.readyForSubmissionAt ? updated.readyForSubmissionAt.toISOString() : null,
+      },
+      gate,
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene los campos de persistencia de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible guardar el flujo de trabajo." }, { status: 400 });
+  }
+}
+
diff --git a/src/app/api/proposals/route.ts b/src/app/api/proposals/route.ts
new file mode 100644
index 0000000..92567f1
--- /dev/null
+++ b/src/app/api/proposals/route.ts
@@ -0,0 +1,151 @@
+import { Prisma } from "@prisma/client";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { listUserProposals } from "@/lib/proposals/server";
+
+function isSchemaNotReadyError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+function parseString(value: unknown) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function toProposalPayload(
+  proposal: {
+    id: string;
+    title: string;
+    issuingEntity: string;
+    summary: string;
+    status: string;
+    sourceLicitationId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    documents: Array<{
+      id: string;
+      fileName: string;
+      mimeType: string;
+      sizeBytes: number;
+      createdAt: Date;
+    }>;
+  } & {
+    currentStep?: number;
+    completionPercent?: number;
+    readyForSubmissionAt?: Date | null;
+  },
+) {
+  return {
+    id: proposal.id,
+    title: proposal.title,
+    issuingEntity: proposal.issuingEntity,
+    summary: proposal.summary,
+    currentStep: proposal.currentStep ?? 1,
+    completionPercent: proposal.completionPercent ?? 0,
+    readyForSubmissionAt: proposal.readyForSubmissionAt ? proposal.readyForSubmissionAt.toISOString() : null,
+    status: proposal.status,
+    sourceLicitationId: proposal.sourceLicitationId,
+    createdAt: proposal.createdAt.toISOString(),
+    updatedAt: proposal.updatedAt.toISOString(),
+    documents: proposal.documents.map((document) => ({
+      id: document.id,
+      fileName: document.fileName,
+      mimeType: document.mimeType,
+      sizeBytes: document.sizeBytes,
+      createdAt: document.createdAt.toISOString(),
+    })),
+  };
+}
+
+export async function GET(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const url = new URL(request.url);
+    const q = url.searchParams.get("q") ?? "";
+    const proposals = await listUserProposals(user.id, q);
+    return NextResponse.json({ ok: true, proposals });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible obtener propuestas." }, { status: 400 });
+  }
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    const body = (await request.json()) as Record<string, unknown>;
+    const title = parseString(body.title);
+    const issuingEntity = parseString(body.issuingEntity);
+    const summary = parseString(body.summary);
+    const sourceLicitationIdRaw = parseString(body.sourceLicitationId);
+    const sourceLicitationId = sourceLicitationIdRaw || null;
+
+    if (!title) {
+      return NextResponse.json({ error: "El titulo es requerido." }, { status: 400 });
+    }
+
+    if (!issuingEntity) {
+      return NextResponse.json({ error: "La entidad emisora es requerida." }, { status: 400 });
+    }
+
+    const proposal = await prisma.proposal.create({
+      data: {
+        userId: user.id,
+        title,
+        issuingEntity,
+        summary,
+        sourceLicitationId,
+      },
+      select: {
+        id: true,
+        title: true,
+        issuingEntity: true,
+        summary: true,
+        status: true,
+        sourceLicitationId: true,
+        createdAt: true,
+        updatedAt: true,
+        documents: {
+          orderBy: [{ createdAt: "desc" }],
+          select: {
+            id: true,
+            fileName: true,
+            mimeType: true,
+            sizeBytes: true,
+            createdAt: true,
+          },
+        },
+      },
+    });
+
+    return NextResponse.json({
+      ok: true,
+      proposal: toProposalPayload(proposal),
+    });
+  } catch (error) {
+    if (isSchemaNotReadyError(error)) {
+      return NextResponse.json(
+        { error: "La base de datos aun no tiene las tablas de Gestion de Licitaciones. Ejecuta prisma migrate para continuar." },
+        { status: 503 },
+      );
+    }
+
+    return NextResponse.json({ error: "No fue posible crear la propuesta." }, { status: 400 });
+  }
+}
diff --git a/src/app/api/regulations/official/route.ts b/src/app/api/regulations/official/route.ts
new file mode 100644
index 0000000..2a4e6c6
--- /dev/null
+++ b/src/app/api/regulations/official/route.ts
@@ -0,0 +1,81 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import {
+  listOfficialNormativeSources,
+  listOfficialNormativeSuggestions,
+  suggestOfficialNormativeSource,
+} from "@/lib/compliance/regulations";
+import type { OfficialNormativeSourceView, OfficialNormativeSuggestionInput } from "@/lib/compliance/types";
+
+function isValidSourceType(value: unknown): value is OfficialNormativeSourceView["sourceType"] {
+  return value === "ley" || value === "reglamento" || value === "lineamiento" || value === "portal";
+}
+
+function parseSuggestion(body: Record<string, unknown>): OfficialNormativeSuggestionInput | null {
+  const stateCode = typeof body.stateCode === "string" ? body.stateCode.trim().toUpperCase() : "";
+  const municipalityCode = typeof body.municipalityCode === "string" ? body.municipalityCode.trim().toUpperCase() : null;
+  const authorityName = typeof body.authorityName === "string" ? body.authorityName.trim() : "";
+  const title = typeof body.title === "string" ? body.title.trim() : "";
+  const officialUrl = typeof body.officialUrl === "string" ? body.officialUrl.trim() : "";
+  const sourceType = body.sourceType;
+  const notes = typeof body.notes === "string" ? body.notes.trim() : undefined;
+
+  if (!stateCode || !authorityName || !title || !officialUrl || !isValidSourceType(sourceType)) {
+    return null;
+  }
+
+  return {
+    stateCode,
+    municipalityCode,
+    authorityName,
+    title,
+    officialUrl,
+    sourceType,
+    notes,
+  };
+}
+
+export async function GET(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const url = new URL(request.url);
+  const includeSuggestions = url.searchParams.get("includeSuggestions") === "1";
+  const stateCode = url.searchParams.get("stateCode")?.trim() || null;
+  const municipalityCode = url.searchParams.get("municipalityCode")?.trim() || null;
+  const pilotOnly = url.searchParams.get("pilotOnly") !== "0";
+
+  const sources = await listOfficialNormativeSources({
+    stateCode,
+    municipalityCode,
+    pilotOnly,
+  });
+  const suggestions = includeSuggestions ? await listOfficialNormativeSuggestions() : undefined;
+
+  return NextResponse.json({
+    ok: true,
+    sources,
+    suggestions,
+  });
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const body = (await request.json().catch(() => ({}))) as Record<string, unknown>;
+  const suggestion = parseSuggestion(body);
+
+  if (!suggestion) {
+    return NextResponse.json({ error: "Datos invalidos para sugerencia normativa." }, { status: 400 });
+  }
+
+  const created = await suggestOfficialNormativeSource(suggestion);
+  return NextResponse.json({ ok: true, suggestion: created }, { status: 201 });
+}
diff --git a/src/app/api/regulations/official/verify/route.ts b/src/app/api/regulations/official/verify/route.ts
new file mode 100644
index 0000000..9f1559e
--- /dev/null
+++ b/src/app/api/regulations/official/verify/route.ts
@@ -0,0 +1,19 @@
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { verifyOfficialNormativeSources } from "@/lib/compliance/regulations";
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const body = (await request.json().catch(() => ({}))) as { sourceIds?: unknown };
+  const sourceIds = Array.isArray(body.sourceIds)
+    ? body.sourceIds.filter((item): item is string => typeof item === "string" && item.trim().length > 0).map((item) => item.trim())
+    : undefined;
+
+  const results = await verifyOfficialNormativeSources(sourceIds);
+  return NextResponse.json({ ok: true, results });
+}
diff --git a/src/app/api/strategic-diagnostic/ai/insights/route.ts b/src/app/api/strategic-diagnostic/ai/insights/route.ts
new file mode 100644
index 0000000..eff8efb
--- /dev/null
+++ b/src/app/api/strategic-diagnostic/ai/insights/route.ts
@@ -0,0 +1,279 @@
+import { z } from "zod";
+import { NextResponse } from "next/server";
+import { requireAdminApiUser } from "@/lib/auth/admin";
+import { callOpenAiJsonSchema } from "@/lib/ai/openai";
+import { storeAiSuggestionFromEnvelope } from "@/lib/ai/suggestions";
+import { getStrategicDiagnosticSnapshot } from "@/lib/strategic-diagnostic/server";
+import { STRATEGIC_SECTION_KEYS, type StrategicSectionKey } from "@/lib/strategic-diagnostic/types";
+
+const M2_PROMPT_VERSION = "m2_insights_v1";
+
+const M2SectionKeySchema = z.enum(STRATEGIC_SECTION_KEYS);
+
+const M2InsightResponseSchema = z.object({
+  sectionGaps: z
+    .array(
+      z.object({
+        sectionKey: M2SectionKeySchema,
+        gap: z.string().min(8).max(240),
+        impact: z.string().min(8).max(600),
+        urgency: z.enum(["alta", "media", "baja"]),
+      }),
+    )
+    .max(12),
+  priorityActions: z
+    .array(
+      z.object({
+        title: z.string().min(8).max(220),
+        description: z.string().min(8).max(900),
+        priority: z.enum(["alta", "media", "baja"]),
+        ownerSuggestion: z.string().min(3).max(120),
+        targetDateSuggestion: z.string().min(4).max(40),
+      }),
+    )
+    .max(12),
+  suggestedEvidence: z
+    .array(
+      z.object({
+        sectionKey: M2SectionKeySchema,
+        category: z.string().min(3).max(120),
+        reason: z.string().min(8).max(600),
+      }),
+    )
+    .max(20),
+  suggestedFieldValues: z
+    .array(
+      z.object({
+        sectionKey: M2SectionKeySchema,
+        fieldPath: z.string().min(4).max(120),
+        suggestedValue: z.string().min(1).max(500),
+        rationale: z.string().min(8).max(700),
+      }),
+    )
+    .max(20),
+  confidence: z.enum(["low", "medium", "high"]),
+});
+
+const M2InsightJsonSchema = {
+  type: "object",
+  additionalProperties: false,
+  required: ["sectionGaps", "priorityActions", "suggestedEvidence", "suggestedFieldValues", "confidence"],
+  properties: {
+    sectionGaps: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["sectionKey", "gap", "impact", "urgency"],
+        properties: {
+          sectionKey: { type: "string", enum: STRATEGIC_SECTION_KEYS },
+          gap: { type: "string" },
+          impact: { type: "string" },
+          urgency: { type: "string", enum: ["alta", "media", "baja"] },
+        },
+      },
+    },
+    priorityActions: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["title", "description", "priority", "ownerSuggestion", "targetDateSuggestion"],
+        properties: {
+          title: { type: "string" },
+          description: { type: "string" },
+          priority: { type: "string", enum: ["alta", "media", "baja"] },
+          ownerSuggestion: { type: "string" },
+          targetDateSuggestion: { type: "string" },
+        },
+      },
+    },
+    suggestedEvidence: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["sectionKey", "category", "reason"],
+        properties: {
+          sectionKey: { type: "string", enum: STRATEGIC_SECTION_KEYS },
+          category: { type: "string" },
+          reason: { type: "string" },
+        },
+      },
+    },
+    suggestedFieldValues: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["sectionKey", "fieldPath", "suggestedValue", "rationale"],
+        properties: {
+          sectionKey: { type: "string", enum: STRATEGIC_SECTION_KEYS },
+          fieldPath: { type: "string" },
+          suggestedValue: { type: "string" },
+          rationale: { type: "string" },
+        },
+      },
+    },
+    confidence: { type: "string", enum: ["low", "medium", "high"] },
+  },
+} as const;
+
+function isSectionKey(value: string): value is StrategicSectionKey {
+  return (STRATEGIC_SECTION_KEYS as readonly string[]).includes(value);
+}
+
+function normalizeEvidenceMetadata(value: unknown, fallback: Record<StrategicSectionKey, { count: number; categories: string[] }>) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return fallback;
+  }
+
+  const incoming = value as Record<string, unknown>;
+  const normalized = { ...fallback };
+
+  for (const key of STRATEGIC_SECTION_KEYS) {
+    const sectionPayload = incoming[key];
+    if (!sectionPayload || typeof sectionPayload !== "object" || Array.isArray(sectionPayload)) {
+      continue;
+    }
+
+    const sectionRecord = sectionPayload as Record<string, unknown>;
+    const countCandidate = Number(sectionRecord.count);
+    const categories = Array.isArray(sectionRecord.categories)
+      ? sectionRecord.categories
+          .filter((item): item is string => typeof item === "string")
+          .map((item) => item.trim())
+          .filter(Boolean)
+          .slice(0, 20)
+      : [];
+
+    normalized[key] = {
+      count: Number.isFinite(countCandidate) && countCandidate >= 0 ? Math.floor(countCandidate) : normalized[key].count,
+      categories: categories.length ? categories : normalized[key].categories,
+    };
+  }
+
+  return normalized;
+}
+
+export async function POST(request: Request) {
+  const user = await requireAdminApiUser();
+
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  const snapshot = await getStrategicDiagnosticSnapshot(user.id);
+
+  if (!snapshot) {
+    return NextResponse.json({ error: "No existe un perfil organizacional para este usuario." }, { status: 400 });
+  }
+
+  const body = (await request.json().catch(() => ({}))) as Record<string, unknown>;
+  const data = (body.data as unknown) ?? snapshot.data;
+
+  const fallbackEvidenceMetadata = STRATEGIC_SECTION_KEYS.reduce(
+    (accumulator, key) => {
+      accumulator[key] = {
+        count: snapshot.evidenceBySection[key].length,
+        categories: Array.from(new Set(snapshot.evidenceBySection[key].map((item) => item.category))).slice(0, 20),
+      };
+      return accumulator;
+    },
+    {} as Record<StrategicSectionKey, { count: number; categories: string[] }>,
+  );
+
+  const evidenceMetadata = normalizeEvidenceMetadata(body.evidenceMetadata, fallbackEvidenceMetadata);
+
+  const systemPrompt = [
+    "Eres consultor senior de estrategia comercial para licitaciones publicas en Mexico.",
+    "Analiza el diagnostico estrategico y prioriza acciones de alto impacto.",
+    "No alteres puntajes deterministas: solo entrega recomendaciones asistidas.",
+    "Responde exclusivamente JSON valido en espanol.",
+  ].join(" ");
+
+  const userPrompt = [
+    "Diagnostico estrategico actual:",
+    JSON.stringify({
+      data,
+      scores: snapshot.scores,
+      evidenceMetadata,
+    }),
+    "",
+    "Genera:",
+    "- sectionGaps: brechas por seccion con impacto y urgencia.",
+    "- priorityActions: acciones priorizadas con responsable sugerido y fecha objetivo.",
+    "- suggestedEvidence: evidencia recomendada por seccion.",
+    "- suggestedFieldValues: valores sugeridos para campos del formulario.",
+    "",
+    "Reglas para suggestedFieldValues:",
+    "- sectionKey debe ser una seccion valida.",
+    "- fieldPath debe usar notacion con punto (ej. technical.responseTimes).",
+    "- suggestedValue debe ser texto aplicable directamente por el usuario.",
+  ].join("\n");
+
+  const envelope = await callOpenAiJsonSchema({
+    promptVersion: M2_PROMPT_VERSION,
+    systemPrompt,
+    userPrompt,
+    outputSchema: M2InsightResponseSchema,
+    schemaName: "m2_strategic_insights",
+    jsonSchema: M2InsightJsonSchema as unknown as Record<string, unknown>,
+    model: process.env.OPENAI_M2_MODEL?.trim() || undefined,
+  });
+
+  const safeData =
+    envelope.data ??
+    ({
+      sectionGaps: [],
+      priorityActions: [],
+      suggestedEvidence: [],
+      suggestedFieldValues: [],
+      confidence: envelope.confidence ?? "low",
+    } satisfies z.infer<typeof M2InsightResponseSchema>);
+
+  const filteredFieldValues = safeData.suggestedFieldValues.filter((item) => {
+    if (!isSectionKey(item.sectionKey)) {
+      return false;
+    }
+
+    return item.fieldPath.startsWith(`${item.sectionKey}.`);
+  });
+
+  const payload = {
+    sectionGaps: safeData.sectionGaps,
+    priorityActions: safeData.priorityActions,
+    suggestedEvidence: safeData.suggestedEvidence,
+    suggestedFieldValues: filteredFieldValues,
+    confidence: safeData.confidence,
+  };
+
+  const persisted = await storeAiSuggestionFromEnvelope({
+    userId: user.id,
+    moduleKey: "M2",
+    featureKey: "strategic_insights",
+    subjectType: "organization",
+    subjectId: snapshot.organizationId,
+    inputForHash: {
+      organizationId: snapshot.organizationId,
+      data,
+      evidenceMetadata,
+      scores: snapshot.scores,
+    },
+    envelope,
+    responsePayload: payload,
+  });
+
+  return NextResponse.json({
+    ok: true,
+    ...payload,
+    suggestionId: persisted.suggestionId,
+    meta: {
+      engine: envelope.engine,
+      model: envelope.model,
+      usage: envelope.usage,
+      warnings: envelope.warnings,
+      confidence: envelope.confidence,
+    },
+  });
+}
diff --git a/src/app/candados/page.tsx b/src/app/candados/page.tsx
new file mode 100644
index 0000000..206b400
--- /dev/null
+++ b/src/app/candados/page.tsx
@@ -0,0 +1,118 @@
+import Link from "next/link";
+import { hasModuleAccess } from "@/lib/auth/module-access";
+import { requireOnboardedUser } from "@/lib/auth/user";
+import { prisma } from "@/lib/prisma";
+import { NormativeAnalysisView } from "@/components/app/normative-analysis-view";
+import { PageShell } from "@/components/app/page-shell";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+
+type CandadosPageProps = {
+  searchParams: Promise<Record<string, string | string[] | undefined>>;
+};
+
+function getParam(params: Record<string, string | string[] | undefined>, key: string) {
+  const value = params[key];
+  return Array.isArray(value) ? value[0] ?? "" : (value ?? "");
+}
+
+export default async function CandadosPage({ searchParams }: CandadosPageProps) {
+  const user = await requireOnboardedUser();
+  const hasPaidModulesAccess = await hasModuleAccess(user, 6);
+
+  if (!hasPaidModulesAccess) {
+    return (
+      <PageShell title="Modulo 6: Candados" description="Acceso restringido al modulo premium.">
+        <Card>
+          <CardContent className="space-y-3 py-6">
+            <h2 className="text-2xl font-semibold text-[#1f2a40]">Acceso restringido</h2>
+            <p className="text-sm text-[#64718a]">Necesitas un plan con acceso premium para ingresar al Modulo 6.</p>
+            <Link href="/dashboard#modulos">
+              <Button>Ver modulos y planes</Button>
+            </Link>
+          </CardContent>
+        </Card>
+      </PageShell>
+    );
+  }
+
+  const resolvedSearchParams = await searchParams;
+  const proposalId = getParam(resolvedSearchParams, "proposalId").trim();
+  const sourceIdFromQuery = getParam(resolvedSearchParams, "sourceId").trim();
+
+  const linkedProposal = proposalId
+    ? await prisma.proposal.findFirst({
+        where: {
+          id: proposalId,
+          userId: user.id,
+        },
+        select: {
+          id: true,
+          title: true,
+          issuingEntity: true,
+          sourceLicitationId: true,
+        },
+      })
+    : null;
+
+  const sourceId = (linkedProposal?.sourceLicitationId ?? sourceIdFromQuery) || null;
+  const linkedSource = sourceId
+    ? await prisma.licitation.findUnique({
+        where: { id: sourceId },
+        select: {
+          id: true,
+          title: true,
+          supplierAwarded: true,
+        },
+      })
+    : null;
+
+  const backHref = linkedProposal ? `/gestion-licitaciones/${encodeURIComponent(linkedProposal.id)}` : "/gestion-licitaciones";
+
+  return (
+    <PageShell
+      title="Modulo 6: Candados"
+      headerMode="module"
+      headerBackHref={backHref}
+      headerBackLabel="Volver a M5"
+      headerNextHref="/compliance-alerts"
+      headerNextLabel="M7: Cumplimiento"
+      headerShowManual
+      headerPlanBadgeLabel="Plan Premium"
+      showPageHeading={false}
+      contentWidth="wide"
+      className="space-y-6"
+    >
+      <section className="flex items-start gap-4">
+        <span className="inline-flex h-14 w-14 items-center justify-center rounded-2xl bg-[#dce5f2] text-3xl text-[#274676]">◨</span>
+        <div>
+          <h1 className="text-4xl font-semibold text-[#132549] [font-family:var(--font-display)] md:text-5xl">Detector de Candados y Riesgos</h1>
+          <p className="mt-2 text-xl text-[#4f6588] md:text-2xl">Modulo 6: detecta direccionamiento, favoritismo y candados en bases de licitacion</p>
+        </div>
+      </section>
+
+      <NormativeAnalysisView
+        linkedProposal={
+          linkedProposal
+            ? {
+                id: linkedProposal.id,
+                title: linkedProposal.title,
+                issuingEntity: linkedProposal.issuingEntity,
+              }
+            : null
+        }
+        linkedSource={
+          linkedSource
+            ? {
+                id: linkedSource.id,
+                title: linkedSource.title,
+                issuingEntity: linkedSource.supplierAwarded,
+              }
+            : null
+        }
+        autoAnalyzeOnLoad={Boolean(linkedProposal || linkedSource)}
+        moduleContext="candados"
+      />
+    </PageShell>
+  );
+}
diff --git a/src/app/compliance-alerts/page.tsx b/src/app/compliance-alerts/page.tsx
new file mode 100644
index 0000000..8630a76
--- /dev/null
+++ b/src/app/compliance-alerts/page.tsx
@@ -0,0 +1,66 @@
+import Link from "next/link";
+import { hasModuleAccess } from "@/lib/auth/module-access";
+import { requireOnboardedUser } from "@/lib/auth/user";
+import { getM7DatasetForUser } from "@/lib/compliance/server";
+import { ComplianceAlertsView } from "@/components/app/compliance-alerts-view";
+import { PageShell } from "@/components/app/page-shell";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+
+export default async function ComplianceAlertsPage() {
+  const user = await requireOnboardedUser();
+  const hasPaidModulesAccess = await hasModuleAccess(user, 7);
+
+  if (!hasPaidModulesAccess) {
+    return (
+      <PageShell
+        title="Modulo 7: Alertas de Cumplimiento"
+        description="Este modulo esta protegido por suscripcion de pago."
+        action={<span className="rounded-full border border-[#d5ddec] bg-[#edf2fb] px-4 py-1 text-sm font-semibold text-[#5a6a87]">Bloqueado</span>}
+      >
+        <Card>
+          <CardContent className="space-y-3 py-6">
+            <h2 className="text-2xl font-semibold text-[#1f2a40]">Acceso restringido</h2>
+            <p className="text-sm text-[#64718a]">Modulo 7 forma parte de la ruta premium de modulos pagados.</p>
+            <div className="flex flex-wrap gap-2">
+              <Link href="/dashboard#modulos">
+                <Button>Ver modulos y planes</Button>
+              </Link>
+              <Link href="/gestion-licitaciones">
+                <Button variant="secondary">Ir a Modulo 5</Button>
+              </Link>
+            </div>
+          </CardContent>
+        </Card>
+      </PageShell>
+    );
+  }
+
+  const dataset = await getM7DatasetForUser(user.id);
+
+  return (
+    <PageShell
+      title="Modulo 7: Alertas de Cumplimiento"
+      headerMode="module"
+      headerBackHref="/dashboard"
+      headerBackLabel="Volver al Dashboard"
+      headerNextHref="/gestion-contratos"
+      headerNextLabel="M8: Contratos"
+      headerShowManual
+      headerPlanBadgeLabel="Plan Premium"
+      showPageHeading={false}
+      contentWidth="wide"
+      className="space-y-6"
+    >
+      <section className="flex items-start gap-4">
+        <span className="inline-flex h-14 w-14 items-center justify-center rounded-2xl bg-[#dce5f2] text-3xl text-[#274676]">◨</span>
+        <div>
+          <h1 className="text-4xl font-semibold text-[#132549] [font-family:var(--font-display)] md:text-5xl">Modulo 7: Alertas de Cumplimiento</h1>
+          <p className="mt-2 text-xl text-[#4f6588] md:text-2xl">Monitorea plazos, riesgos, checklist y vigencia normativa desde una sola vista</p>
+        </div>
+      </section>
+
+      <ComplianceAlertsView dataset={dataset} />
+    </PageShell>
+  );
+}
diff --git a/src/app/dashboard/page.tsx b/src/app/dashboard/page.tsx
index f2849cc..36e2372 100644
--- a/src/app/dashboard/page.tsx
+++ b/src/app/dashboard/page.tsx
@@ -1,10 +1,14 @@
 import Link from "next/link";
+import type { ModulePlanKey } from "@prisma/client";
 import { isAdminIdentity } from "@/lib/auth/admin";
+import { getActivePlanKeysForUser } from "@/lib/auth/module-access";
 import { PageShell } from "@/components/app/page-shell";
 import { DashboardMaturitySection } from "@/components/app/dashboard-maturity-section";
 import { Button } from "@/components/ui/button";
 import { Card, CardContent } from "@/components/ui/card";
 import { requireOnboardedUser } from "@/lib/auth/user";
+import { hasMercadoPagoConfig } from "@/lib/payments/mercadopago";
+import { getModulePlanByUiKey } from "@/lib/payments/plans";
 import { cn } from "@/lib/utils";
 import { recomputeAssessmentResults } from "@/lib/scoring";
 import { getTalleresSnapshot } from "@/lib/talleres/server";
@@ -57,6 +61,7 @@ const planGroups: PlanGroup[] = [
         id: "M04",
         title: "Analisis Normativo",
         description: "Analiza las bases de licitacion que te interesen con IA.",
+        href: "/normative-analysis",
       },
     ],
   },
@@ -75,16 +80,19 @@ const planGroups: PlanGroup[] = [
         id: "M05",
         title: "Gestion Integral de Licitaciones",
         description: "Herramienta completa para preparar, revisar y enviar propuestas con checklist.",
+        href: "/gestion-licitaciones",
       },
       {
         id: "M06",
         title: "Detector de Candados y Riesgos",
         description: "Analisis automatico de bases para identificar requisitos excluyentes o riesgos.",
+        href: "/candados",
       },
       {
         id: "M07",
         title: "Alertas de Cumplimiento",
         description: "Notificaciones proactivas sobre plazos, documentos vencidos y cambios normativos.",
+        href: "/compliance-alerts",
       },
     ],
   },
@@ -103,16 +111,19 @@ const planGroups: PlanGroup[] = [
         id: "M08",
         title: "Gestion Estrategica de Contratos",
         description: "Dashboard para administrar contratos activos, entregables y pagos.",
+        href: "/gestion-contratos",
       },
       {
         id: "M09",
         title: "Proteccion Legal",
         description: "Guia legal y plantillas ante incumplimientos, retenciones o sanciones.",
+        href: "/proteccion-legal",
       },
       {
         id: "M10",
         title: "Simulador de Auditorias",
         description: "Autoevaluacion que prepara a tu empresa para auditorias gubernamentales.",
+        href: "/expediente-preventivo",
       },
     ],
   },
@@ -165,11 +176,28 @@ function LockIcon({ className }: { className?: string }) {
   );
 }
 
-export default async function DashboardPage() {
+type DashboardPageProps = {
+  searchParams: Promise<Record<string, string | string[] | undefined>>;
+};
+
+function getParam(params: Record<string, string | string[] | undefined>, key: string) {
+  const value = params[key];
+  return Array.isArray(value) ? value[0] ?? "" : (value ?? "");
+}
+
+export default async function DashboardPage({ searchParams }: DashboardPageProps) {
   const user = await requireOnboardedUser();
   const snapshot = await recomputeAssessmentResults(user.id);
   const talleresSnapshot = await getTalleresSnapshot(user.id, { assessmentSnapshot: snapshot });
-  const hasPaidModulesAccess = isAdminIdentity(user.email, user.role);
+  const isAdminUser = isAdminIdentity(user.email, user.role);
+  const activePlanKeys = isAdminUser
+    ? new Set<ModulePlanKey>(["PLAN_2_4", "PLAN_5_7", "PLAN_8_10"])
+    : await getActivePlanKeysForUser(user.id);
+  const hasPaidModulesAccess = activePlanKeys.size > 0;
+  const paymentConfigured = hasMercadoPagoConfig();
+  const resolvedSearchParams = await searchParams;
+  const checkoutResult = getParam(resolvedSearchParams, "mp_result");
+  const checkoutError = getParam(resolvedSearchParams, "mp_error");
   const roundedOverallScore = Math.round(snapshot.overallScore);
   const readinessLabel = getReadinessLabel(roundedOverallScore);
   const strongest = snapshot.strongestModule;
@@ -212,11 +240,11 @@ export default async function DashboardPage() {
       <Card className="border-[#a8dbc8]">
         <CardContent className="py-8">
           <div className="mx-auto max-w-4xl text-center">
-            <span className="inline-flex rounded-full bg-[#24aa77] px-8 py-2 text-2xl font-semibold text-white">Nivel {readinessLabel}</span>
-            <h2 className="mt-6 text-4xl font-semibold text-[#0f2142] [font-family:var(--font-display)] md:text-5xl">
+            <span className="inline-flex rounded-full bg-[#24aa77] px-7 py-2 text-xl font-semibold text-white">Nivel {readinessLabel}</span>
+            <h2 className="mt-6 text-3xl font-semibold text-[#0f2142] [font-family:var(--font-display)] md:text-4xl">
               Puntaje Global: {roundedOverallScore}%
             </h2>
-            <p className="mx-auto mt-4 max-w-3xl text-2xl leading-relaxed text-[#4d6285] md:text-[35px] md:leading-tight">
+            <p className="mx-auto mt-4 max-w-3xl text-xl leading-relaxed text-[#4d6285] md:text-2xl">
               {getReadinessDescription(roundedOverallScore)}
             </p>
 
@@ -251,13 +279,29 @@ export default async function DashboardPage() {
         <div className="flex flex-wrap items-center justify-between gap-3">
           <div>
             <h2 className="text-2xl font-semibold text-[#1a2b48] [font-family:var(--font-display)] md:text-3xl">Modulos y planes</h2>
-            <p className="mt-1 text-sm text-[#5f7293]">Ruta de crecimiento: Modulo 1 (gratis) + Modulos 2-20 por suscripcion.</p>
+            <p className="mt-1 text-sm text-[#5f7293]">Ruta de crecimiento: Modulo 1 (gratis) + Modulos 2-10 por suscripcion.</p>
           </div>
           <span className={cn("inline-flex items-center gap-2 rounded-full border px-4 py-1.5 text-sm font-semibold", hasPaidModulesAccess ? "border-[#a9d8c8] bg-[#e8f6ef] text-[#1e8f67]" : "border-[#d7dceb] bg-[#eff3fb] text-[#5a6b88]")}>
             {hasPaidModulesAccess ? "Plan con acceso activo" : "Cuenta en plan gratuito"}
           </span>
         </div>
 
+        {checkoutResult ? (
+          <div className={cn("rounded-xl border px-4 py-3 text-sm", checkoutResult === "success" ? "border-[#a9d8c8] bg-[#ecf9f2] text-[#1f8b63]" : "border-[#e7d7ac] bg-[#fff8ea] text-[#8b6b1f]")}>
+            {checkoutResult === "success"
+              ? "Mercado Pago reporto checkout exitoso. Estamos validando tu pago y activando el plan."
+              : checkoutResult === "failure"
+                ? "El pago no se completo. Puedes intentarlo nuevamente."
+                : "Tu pago esta pendiente de confirmacion. Te avisaremos cuando se active el plan."}
+          </div>
+        ) : null}
+
+        {checkoutError ? (
+          <div className="rounded-xl border border-[#f1c7cc] bg-[#fff1f3] px-4 py-3 text-sm text-[#a03d4b]">
+            No fue posible iniciar el checkout ({checkoutError}). Verifica la configuracion de Mercado Pago.
+          </div>
+        ) : null}
+
         <Card className="border-[#a9d9c7] bg-[#f3fbf7]">
           <CardContent className="flex flex-wrap items-center justify-between gap-3 py-4">
             <div>
@@ -275,6 +319,11 @@ export default async function DashboardPage() {
 
         {planGroups.map((group) => (
           <article key={group.key} className={cn("rounded-2xl border p-3 md:p-4", group.frameClassName)}>
+            {(() => {
+              const plan = getModulePlanByUiKey(group.key);
+              const planActive = plan ? activePlanKeys.has(plan.key) : false;
+              return (
+                <>
             <header className="flex flex-wrap items-center justify-between gap-3 rounded-xl border border-white/60 bg-white/50 px-3 py-2">
               <div className="flex items-start gap-3">
                 <span className={cn("mt-1.5 h-3 w-3 rounded-full", group.dotClassName)} />
@@ -288,13 +337,13 @@ export default async function DashboardPage() {
 
               <span className={cn("inline-flex items-center gap-1.5 rounded-full border px-3 py-1 text-sm font-semibold", group.badgeClassName)}>
                 <LockIcon className="h-4 w-4" />
-                {hasPaidModulesAccess ? "Disponible" : "Bloqueado"}
+                {planActive ? "Disponible" : "Bloqueado"}
               </span>
             </header>
 
             <div className="mt-3 grid gap-3 md:grid-cols-3">
               {group.modules.map((moduleItem) => {
-                const isLocked = !hasPaidModulesAccess || !moduleItem.href;
+                const isLocked = !planActive || !moduleItem.href;
 
                 return (
                   <article
@@ -335,12 +384,33 @@ export default async function DashboardPage() {
                 );
               })}
             </div>
+            {!planActive ? (
+              <div className="mt-3 flex flex-wrap items-center justify-between gap-3 rounded-xl border border-white/70 bg-white/55 px-3 py-3">
+                <p className="text-sm text-[#5a6f90]">
+                  Desbloquea Modulos {plan?.moduleStart}-{plan?.moduleEnd} con {group.name}.
+                </p>
+                {paymentConfigured ? (
+                  <Link href={`/api/payments/checkout?plan=${encodeURIComponent(group.key)}`}>
+                    <Button size="sm" className="rounded-xl">
+                      Comprar {group.name}
+                    </Button>
+                  </Link>
+                ) : (
+                  <span className="rounded-full border border-[#d8dfea] bg-[#eef2f8] px-3 py-1 text-xs font-semibold text-[#64738c]">
+                    Configura `MP_ACCESS_TOKEN`
+                  </span>
+                )}
+              </div>
+            ) : null}
+          </>
+              );
+            })()}
           </article>
         ))}
 
         <div className="rounded-2xl border border-dashed border-[#d4dceb] bg-[#f8fbff] px-5 py-5 text-center">
           <p className="text-sm font-semibold uppercase tracking-[0.08em] text-[#607290]">Ruta de expansion</p>
-          <p className="mt-2 text-base text-[#536a8e]">Modulos 11-20 se habilitaran en siguientes etapas de la plataforma.</p>
+          <p className="mt-2 text-base text-[#536a8e]">Actualmente la plataforma contempla 10 modulos.</p>
           <Link href="/#planes" className="mt-4 inline-flex">
             <Button size="sm" className="rounded-xl bg-[#e1af1c] text-[#243351] hover:bg-[#cf9f16]">
               Ver todos los planes
diff --git a/src/app/expediente-preventivo/page.tsx b/src/app/expediente-preventivo/page.tsx
new file mode 100644
index 0000000..d199097
--- /dev/null
+++ b/src/app/expediente-preventivo/page.tsx
@@ -0,0 +1,89 @@
+import Link from "next/link";
+import { hasModuleAccess } from "@/lib/auth/module-access";
+import { requireOnboardedUser } from "@/lib/auth/user";
+import {
+  getInstitutionalDossierForUser,
+  getAuditKpisForUser,
+  listAuditSimulationsForUser,
+} from "@/lib/audits/server";
+import { PreventiveDossierView } from "@/components/app/preventive-dossier-view";
+import { PageShell } from "@/components/app/page-shell";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+import type { InstitutionalDossierLoadStrategy } from "@/lib/audits/types";
+
+type PageProps = {
+  searchParams: Promise<Record<string, string | string[] | undefined>>;
+};
+
+function getParam(params: Record<string, string | string[] | undefined>, key: string) {
+  const value = params[key];
+  return Array.isArray(value) ? value[0] ?? "" : (value ?? "");
+}
+
+export default async function ExpedientePreventivoPage({ searchParams }: PageProps) {
+  const user = await requireOnboardedUser();
+  const hasPaidModulesAccess = await hasModuleAccess(user, 10);
+
+  if (!hasPaidModulesAccess) {
+    return (
+      <PageShell
+        title="Modulo 10: Expediente Preventivo"
+        description="Este modulo esta protegido por suscripcion de pago."
+        action={<span className="rounded-full border border-[#d5ddec] bg-[#edf2fb] px-4 py-1 text-sm font-semibold text-[#5a6a87]">Bloqueado</span>}
+      >
+        <Card>
+          <CardContent className="space-y-3 py-6">
+            <h2 className="text-2xl font-semibold text-[#1f2a40]">Acceso restringido</h2>
+            <p className="text-sm text-[#64718a]">Modulo 10 forma parte de la ruta premium de modulos pagados.</p>
+            <div className="flex flex-wrap gap-2">
+              <Link href="/dashboard#modulos">
+                <Button>Ver modulos y planes</Button>
+              </Link>
+              <Link href="/proteccion-legal">
+                <Button variant="secondary">Ir a Modulo 9</Button>
+              </Link>
+            </div>
+          </CardContent>
+        </Card>
+      </PageShell>
+    );
+  }
+
+  const resolvedSearchParams = await searchParams;
+  const strategy = (getParam(resolvedSearchParams, "strategy") === "snapshot" ? "snapshot" : "live") satisfies InstitutionalDossierLoadStrategy;
+
+  const [simulations, kpis, dossierState] = await Promise.all([
+    listAuditSimulationsForUser(user.id),
+    getAuditKpisForUser(user.id),
+    getInstitutionalDossierForUser(user.id, strategy),
+  ]);
+
+  return (
+    <PageShell
+      title="Modulo 10: Expediente Preventivo"
+      headerMode="module"
+      headerBackHref="/proteccion-legal"
+      headerBackLabel="M9: Legal"
+      headerPlanBadgeLabel="Plan Premium"
+      showPageHeading={false}
+      contentWidth="wide"
+      className="space-y-6"
+    >
+      <section className="flex items-start gap-4">
+        <span className="inline-flex h-14 w-14 items-center justify-center rounded-2xl bg-[#dce5f2] text-3xl text-[#274676]">◫</span>
+        <div>
+          <h1 className="text-4xl font-semibold text-[#132549] [font-family:var(--font-display)] md:text-5xl">Expediente Preventivo</h1>
+          <p className="mt-2 text-xl text-[#4f6588] md:text-2xl">Simula auditorias y consolida evidencia institucional desde M5, M8, M9 y M7</p>
+        </div>
+      </section>
+
+      <PreventiveDossierView
+        initialSimulations={simulations}
+        initialKpis={kpis}
+        initialDossier={dossierState.dossier}
+        initialFreshness={dossierState.freshness}
+      />
+    </PageShell>
+  );
+}
diff --git a/src/app/gestion-contratos/page.tsx b/src/app/gestion-contratos/page.tsx
new file mode 100644
index 0000000..5a01b12
--- /dev/null
+++ b/src/app/gestion-contratos/page.tsx
@@ -0,0 +1,237 @@
+import Link from "next/link";
+import { redirect } from "next/navigation";
+import { hasModuleAccess } from "@/lib/auth/module-access";
+import { requireOnboardedUser } from "@/lib/auth/user";
+import { prisma } from "@/lib/prisma";
+import { getContractsKpisForUser, listContractsForUser } from "@/lib/contracts/server";
+import {
+  ensureProposalPdfLinkedToContract,
+  getLatestProposalPdfSourceForUser,
+  isPdfProposalDocument,
+} from "@/lib/contracts/proposal-continuity";
+import { ContractsManagementView } from "@/components/app/contracts-management-view";
+import { PageShell } from "@/components/app/page-shell";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+
+type PageProps = {
+  searchParams: Promise<Record<string, string | string[] | undefined>>;
+};
+
+function getParam(params: Record<string, string | string[] | undefined>, key: string) {
+  const value = params[key];
+  return Array.isArray(value) ? value[0] ?? "" : (value ?? "");
+}
+
+function logContinuityHandoff(event: string, data: Record<string, unknown>) {
+  console.info(
+    "[continuity_handoff]",
+    JSON.stringify({
+      event,
+      at: new Date().toISOString(),
+      ...data,
+    }),
+  );
+}
+
+export default async function GestionContratosPage({ searchParams }: PageProps) {
+  const user = await requireOnboardedUser();
+  const hasPaidModulesAccess = await hasModuleAccess(user, 8);
+
+  if (!hasPaidModulesAccess) {
+    return (
+      <PageShell
+        title="Modulo 8: Gestion Estrategica de Contratos"
+        description="Este modulo esta protegido por suscripcion de pago."
+        action={<span className="rounded-full border border-[#d5ddec] bg-[#edf2fb] px-4 py-1 text-sm font-semibold text-[#5a6a87]">Bloqueado</span>}
+      >
+        <Card>
+          <CardContent className="space-y-3 py-6">
+            <h2 className="text-2xl font-semibold text-[#1f2a40]">Acceso restringido</h2>
+            <p className="text-sm text-[#64718a]">Modulo 8 forma parte de la ruta premium de modulos pagados.</p>
+            <div className="flex flex-wrap gap-2">
+              <Link href="/dashboard#modulos">
+                <Button>Ver modulos y planes</Button>
+              </Link>
+              <Link href="/compliance-alerts">
+                <Button variant="secondary">Ir a Modulo 7</Button>
+              </Link>
+            </div>
+          </CardContent>
+        </Card>
+      </PageShell>
+    );
+  }
+
+  const resolvedSearchParams = await searchParams;
+  const proposalId = getParam(resolvedSearchParams, "proposalId") || null;
+  const shouldAutoCreate = getParam(resolvedSearchParams, "autocreate") === "1";
+
+  if (proposalId || shouldAutoCreate) {
+    logContinuityHandoff("m5_to_m8_autocreate_requested", {
+      userId: user.id,
+      proposalId,
+      shouldAutoCreate,
+    });
+  }
+
+  if (proposalId && shouldAutoCreate) {
+    const ownedProposal = await prisma.proposal.findFirst({
+      where: {
+        id: proposalId,
+        userId: user.id,
+      },
+      select: {
+        id: true,
+        title: true,
+        issuingEntity: true,
+        summary: true,
+      },
+    });
+
+    if (ownedProposal) {
+      logContinuityHandoff("m5_to_m8_autocreate_proposal_resolved", {
+        userId: user.id,
+        proposalId: ownedProposal.id,
+      });
+
+      const existing = await prisma.contractRecord.findFirst({
+        where: {
+          userId: user.id,
+          sourceProposalId: ownedProposal.id,
+        },
+        select: {
+          id: true,
+        },
+      });
+
+      let targetContractId = existing?.id ?? null;
+      if (!targetContractId) {
+        const created = await prisma.contractRecord.create({
+          data: {
+            userId: user.id,
+            sourceProposalId: ownedProposal.id,
+            title: ownedProposal.title,
+            counterpartyEntity: ownedProposal.issuingEntity,
+            contractType: "Desde propuesta adjudicada",
+            description: ownedProposal.summary,
+            status: "ACTIVE",
+            currency: "MXN",
+          },
+          select: {
+            id: true,
+          },
+        });
+        targetContractId = created.id;
+      }
+      logContinuityHandoff("m5_to_m8_autocreate_contract_resolved", {
+        userId: user.id,
+        proposalId: ownedProposal.id,
+        contractId: targetContractId,
+        mode: existing ? "reuse" : "create",
+      });
+
+      if (targetContractId) {
+        try {
+          const proposalPdfLookup = await getLatestProposalPdfSourceForUser(user.id, ownedProposal.id);
+          logContinuityHandoff("m5_to_m8_autocreate_proposal_pdf_lookup", {
+            userId: user.id,
+            proposalId: ownedProposal.id,
+            contractId: targetContractId,
+            lookupStatus: proposalPdfLookup.status,
+          });
+
+          if (proposalPdfLookup.status === "ok") {
+            const linked = await ensureProposalPdfLinkedToContract({
+              userId: user.id,
+              contractId: targetContractId,
+              source: proposalPdfLookup.source,
+            });
+            logContinuityHandoff("m5_to_m8_autocreate_pdf_linked", {
+              userId: user.id,
+              proposalId: ownedProposal.id,
+              contractId: targetContractId,
+              created: linked.created,
+              documentId: linked.documentId,
+            });
+          }
+        } catch {
+          logContinuityHandoff("m5_to_m8_autocreate_pdf_link_failed", {
+            userId: user.id,
+            proposalId: ownedProposal.id,
+            contractId: targetContractId,
+          });
+          // Preserve autocreate flow even if continuity copy fails unexpectedly.
+        }
+      }
+
+      redirect("/gestion-contratos");
+    }
+  }
+
+  const [contracts, kpis, proposals] = await Promise.all([
+    listContractsForUser(user.id),
+    getContractsKpisForUser(user.id),
+    prisma.proposal.findMany({
+      where: {
+        userId: user.id,
+      },
+      orderBy: [{ updatedAt: "desc" }],
+      select: {
+        id: true,
+        title: true,
+        documents: {
+          orderBy: [{ createdAt: "desc" }],
+          select: {
+            id: true,
+            fileName: true,
+            mimeType: true,
+            createdAt: true,
+          },
+        },
+      },
+      take: 200,
+    }),
+  ]);
+  const proposalPdfOptions = proposals
+    .map((proposal) => {
+      const latestPdf = proposal.documents.find((document) => isPdfProposalDocument(document)) ?? null;
+      if (!latestPdf) {
+        return null;
+      }
+
+      return {
+        proposalId: proposal.id,
+        proposalTitle: proposal.title,
+        documentId: latestPdf.id,
+        fileName: latestPdf.fileName,
+        createdAt: latestPdf.createdAt.toISOString(),
+      };
+    })
+    .filter((item): item is { proposalId: string; proposalTitle: string; documentId: string; fileName: string; createdAt: string } => Boolean(item));
+
+  return (
+    <PageShell
+      title="Modulo 8: Gestion Estrategica de Contratos"
+      headerMode="module"
+      headerBackHref="/compliance-alerts"
+      headerBackLabel="M7: Alertas"
+      headerNextHref="/proteccion-legal"
+      headerNextLabel="M9: Legal"
+      headerPlanBadgeLabel="Plan Premium"
+      showPageHeading={false}
+      contentWidth="wide"
+      className="space-y-6"
+    >
+      <section className="flex items-start gap-4">
+        <span className="inline-flex h-14 w-14 items-center justify-center rounded-2xl bg-[#dce5f2] text-3xl text-[#274676]">◧</span>
+        <div>
+          <h1 className="text-4xl font-semibold text-[#132549] [font-family:var(--font-display)] md:text-5xl">Gestion Estrategica de Contratos</h1>
+          <p className="mt-2 text-xl text-[#4f6588] md:text-2xl">Registra contratos, entregables, pagos y evidencia documental con trazabilidad completa</p>
+        </div>
+      </section>
+
+      <ContractsManagementView initialContracts={contracts} initialKpis={kpis} proposalPdfOptions={proposalPdfOptions} />
+    </PageShell>
+  );
+}
diff --git a/src/app/gestion-licitaciones/[id]/page.tsx b/src/app/gestion-licitaciones/[id]/page.tsx
new file mode 100644
index 0000000..7598d7b
--- /dev/null
+++ b/src/app/gestion-licitaciones/[id]/page.tsx
@@ -0,0 +1,305 @@
+import Link from "next/link";
+import { notFound } from "next/navigation";
+import { Prisma } from "@prisma/client";
+import { hasModuleAccess } from "@/lib/auth/module-access";
+import { requireOnboardedUser } from "@/lib/auth/user";
+import { toNormativeHistoryView } from "@/lib/normative-analysis/history";
+import { prisma } from "@/lib/prisma";
+import { buildRequirementSeeds, buildTechnicalSectionSeeds, type WorkflowMilestoneSeed } from "@/lib/proposals/workflow";
+import { PageShell } from "@/components/app/page-shell";
+import { ProposalWorkflowView } from "@/components/app/proposal-workflow-view";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+
+type PageProps = {
+  params: Promise<{ id: string }>;
+  searchParams: Promise<Record<string, string | string[] | undefined>>;
+};
+
+type SourceDocumentLink = {
+  name: string;
+  url: string;
+  type: string | null;
+};
+
+function toSourceDocumentLinks(value: unknown): SourceDocumentLink[] {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+
+  return value
+    .map((item) => {
+      if (!item || typeof item !== "object") {
+        return null;
+      }
+
+      const record = item as Record<string, unknown>;
+      const name = typeof record.name === "string" && record.name.trim() ? record.name.trim() : "Documento";
+      const url = typeof record.url === "string" && record.url.trim() ? record.url.trim() : "";
+      const type = typeof record.type === "string" && record.type.trim() ? record.type.trim() : null;
+
+      if (!url) {
+        return null;
+      }
+
+      return { name, url, type };
+    })
+    .filter((item): item is SourceDocumentLink => Boolean(item));
+}
+
+function parseDateCandidate(value: unknown) {
+  if (typeof value !== "string") {
+    return null;
+  }
+
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return null;
+  }
+
+  return parsed;
+}
+
+function toMilestoneSeeds(args: {
+  openingDate: Date | null;
+  closingDate: Date | null;
+  eventDates: Prisma.JsonValue | null;
+}): WorkflowMilestoneSeed[] {
+  const milestones: WorkflowMilestoneSeed[] = [];
+
+  if (args.openingDate) {
+    milestones.push({
+      id: "opening-date",
+      title: "Apertura del proceso",
+      dateIso: args.openingDate.toISOString(),
+      location: "",
+      note: "",
+      source: "licitation",
+    });
+  }
+
+  if (args.closingDate) {
+    milestones.push({
+      id: "closing-date",
+      title: "Presentacion de propuestas",
+      dateIso: args.closingDate.toISOString(),
+      location: "",
+      note: "",
+      source: "licitation",
+    });
+  }
+
+  if (args.eventDates && typeof args.eventDates === "object" && !Array.isArray(args.eventDates)) {
+    const entries = Object.entries(args.eventDates as Record<string, unknown>);
+    for (let index = 0; index < entries.length; index += 1) {
+      const [key, value] = entries[index];
+      const parsed = parseDateCandidate(value);
+      milestones.push({
+        id: `event-date-${index + 1}`,
+        title: key || `Evento ${index + 1}`,
+        dateIso: parsed ? parsed.toISOString() : null,
+        location: "",
+        note: "",
+        source: "licitation",
+      });
+    }
+  }
+
+  const dedupe = new Set<string>();
+  return milestones.filter((item) => {
+    const signature = `${item.title.toLowerCase()}|${item.dateIso ?? ""}`;
+    if (dedupe.has(signature)) {
+      return false;
+    }
+    dedupe.add(signature);
+    return true;
+  });
+}
+
+function getParam(params: Record<string, string | string[] | undefined>, key: string) {
+  const value = params[key];
+  return Array.isArray(value) ? value[0] ?? "" : (value ?? "");
+}
+
+export default async function GestionLicitacionDetailPage({ params, searchParams }: PageProps) {
+  const user = await requireOnboardedUser();
+  const hasPaidModulesAccess = await hasModuleAccess(user, 5);
+
+  if (!hasPaidModulesAccess) {
+    return (
+      <PageShell
+        title="Modulo 5: Gestion de Licitaciones"
+        description="Este modulo esta protegido por suscripcion de pago."
+        action={<span className="rounded-full border border-[#d5ddec] bg-[#edf2fb] px-4 py-1 text-sm font-semibold text-[#5a6a87]">Bloqueado</span>}
+      >
+        <Card>
+          <CardContent className="space-y-3 py-6">
+            <h2 className="text-2xl font-semibold text-[#1f2a40]">Acceso restringido</h2>
+            <p className="text-sm text-[#64718a]">Modulo 5 forma parte de la ruta premium de modulos pagados.</p>
+            <div className="flex flex-wrap gap-2">
+              <Link href="/dashboard#modulos">
+                <Button>Ver modulos y planes</Button>
+              </Link>
+              <Link href="/normative-analysis">
+                <Button variant="secondary">Ir a Modulo 4</Button>
+              </Link>
+            </div>
+          </CardContent>
+        </Card>
+      </PageShell>
+    );
+  }
+
+  const { id } = await params;
+  const resolvedSearchParams = await searchParams;
+  const autoExtractOnLoad = getParam(resolvedSearchParams, "autofill") === "1";
+
+  const proposal = await prisma.proposal.findFirst({
+    where: {
+      id,
+      userId: user.id,
+    },
+    select: {
+      id: true,
+      title: true,
+      issuingEntity: true,
+      summary: true,
+      status: true,
+      sourceLicitationId: true,
+      updatedAt: true,
+      documents: {
+        orderBy: [{ createdAt: "desc" }],
+        select: {
+          id: true,
+          fileName: true,
+          mimeType: true,
+          sizeBytes: true,
+          createdAt: true,
+        },
+      },
+    },
+  });
+
+  if (!proposal) {
+    notFound();
+  }
+
+  const linkedSource = proposal.sourceLicitationId
+    ? await prisma.licitation.findUnique({
+        where: { id: proposal.sourceLicitationId },
+        include: {
+          municipality: {
+            select: {
+              stateName: true,
+              municipalityName: true,
+            },
+          },
+        },
+      })
+    : null;
+
+  const historyEntry = proposal.sourceLicitationId
+    ? await prisma.normativeAnalysisHistory.findFirst({
+        where: {
+          userId: user.id,
+          deletedAt: null,
+          sourceLicitationId: proposal.sourceLicitationId,
+        },
+        orderBy: [{ analyzedAt: "desc" }],
+        select: {
+          id: true,
+          sourceLicitationId: true,
+          fileName: true,
+          documentType: true,
+          issuingEntity: true,
+          methodUsed: true,
+          numPages: true,
+          warnings: true,
+          extractedChars: true,
+          analyzedAt: true,
+          viabilityScore: true,
+          riskLevel: true,
+          confidence: true,
+          result: true,
+        },
+      })
+    : null;
+
+  const historyView = historyEntry ? toNormativeHistoryView(historyEntry) : null;
+  const requirementSeeds = historyView ? buildRequirementSeeds(historyView.result) : [];
+  const technicalSeeds = historyView ? buildTechnicalSectionSeeds(historyView.result) : [];
+  const milestoneSeeds = linkedSource
+    ? toMilestoneSeeds({
+        openingDate: linkedSource.openingDate,
+        closingDate: linkedSource.closingDate,
+        eventDates: linkedSource.eventDates,
+      })
+    : [];
+  const sourceDocumentLinks = linkedSource ? toSourceDocumentLinks(linkedSource.documents) : [];
+  const candadosHref =
+    `/candados?proposalId=${encodeURIComponent(proposal.id)}` +
+    (proposal.sourceLicitationId ? `&sourceId=${encodeURIComponent(proposal.sourceLicitationId)}` : "");
+
+  return (
+    <PageShell
+      title="Modulo 5: Gestion de Licitaciones"
+      headerMode="module"
+      headerBackHref="/gestion-licitaciones"
+      headerBackLabel="M5: Lista"
+      headerNextHref={candadosHref}
+      headerNextLabel="M6: Candados"
+      headerPlanBadgeLabel="Plan Premium"
+      showPageHeading={false}
+      contentWidth="wide"
+      className="space-y-6"
+    >
+      <ProposalWorkflowView
+        proposal={{
+          id: proposal.id,
+          title: proposal.title,
+          issuingEntity: proposal.issuingEntity,
+          summary: proposal.summary,
+          status: proposal.status,
+          sourceLicitationId: proposal.sourceLicitationId,
+          updatedAt: proposal.updatedAt.toISOString(),
+          documents: proposal.documents.map((document) => ({
+            id: document.id,
+            fileName: document.fileName,
+            mimeType: document.mimeType,
+            sizeBytes: document.sizeBytes,
+            createdAt: document.createdAt.toISOString(),
+          })),
+        }}
+        linkedSource={
+          linkedSource
+            ? {
+                id: linkedSource.id,
+                title: linkedSource.title,
+                description: linkedSource.description ?? "",
+                issuingEntity: linkedSource.supplierAwarded ?? null,
+                procedureType: linkedSource.procedureType,
+                stateName: linkedSource.municipality.stateName,
+                municipalityName: linkedSource.municipality.municipalityName,
+                sourceUrl: linkedSource.rawSourceUrl ?? null,
+                documentLinks: sourceDocumentLinks,
+                milestones: milestoneSeeds,
+              }
+            : null
+        }
+        normativeContext={
+          historyView
+            ? {
+                id: historyView.id,
+                analyzedAt: historyView.analyzedAt,
+                executiveSummary: historyView.result.executiveSummary,
+                confidence: historyView.confidence,
+                requirementSeeds,
+                technicalSeeds,
+              }
+            : null
+        }
+        autoExtractOnLoad={autoExtractOnLoad}
+      />
+    </PageShell>
+  );
+}
diff --git a/src/app/gestion-licitaciones/page.tsx b/src/app/gestion-licitaciones/page.tsx
new file mode 100644
index 0000000..82fa8af
--- /dev/null
+++ b/src/app/gestion-licitaciones/page.tsx
@@ -0,0 +1,133 @@
+import Link from "next/link";
+import { redirect } from "next/navigation";
+import { hasModuleAccess } from "@/lib/auth/module-access";
+import { requireOnboardedUser } from "@/lib/auth/user";
+import { prisma } from "@/lib/prisma";
+import { listUserProposals } from "@/lib/proposals/server";
+import { PageShell } from "@/components/app/page-shell";
+import { ProposalsManagementView } from "@/components/app/proposals-management-view";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+
+type PageProps = {
+  searchParams: Promise<Record<string, string | string[] | undefined>>;
+};
+
+function getParam(params: Record<string, string | string[] | undefined>, key: string) {
+  const value = params[key];
+  return Array.isArray(value) ? value[0] ?? "" : (value ?? "");
+}
+
+export default async function GestionLicitacionesPage({ searchParams }: PageProps) {
+  const user = await requireOnboardedUser();
+  const hasPaidModulesAccess = await hasModuleAccess(user, 5);
+
+  if (!hasPaidModulesAccess) {
+    return (
+      <PageShell
+        title="Modulo 5: Gestion de Licitaciones"
+        description="Este modulo esta protegido por suscripcion de pago."
+        action={<span className="rounded-full border border-[#d5ddec] bg-[#edf2fb] px-4 py-1 text-sm font-semibold text-[#5a6a87]">Bloqueado</span>}
+      >
+        <Card>
+          <CardContent className="space-y-3 py-6">
+            <h2 className="text-2xl font-semibold text-[#1f2a40]">Acceso restringido</h2>
+            <p className="text-sm text-[#64718a]">Modulo 5 forma parte de la ruta premium de modulos pagados.</p>
+            <div className="flex flex-wrap gap-2">
+              <Link href="/dashboard#modulos">
+                <Button>Ver modulos y planes</Button>
+              </Link>
+              <Link href="/normative-analysis">
+                <Button variant="secondary">Ir a Modulo 4</Button>
+              </Link>
+            </div>
+          </CardContent>
+        </Card>
+      </PageShell>
+    );
+  }
+
+  const resolvedSearchParams = await searchParams;
+  const sourceLicitationId = getParam(resolvedSearchParams, "sourceId") || null;
+  const shouldAutoCreate = getParam(resolvedSearchParams, "autocreate") === "1";
+  const shouldAutoFill = getParam(resolvedSearchParams, "autofill") === "1";
+
+  if (sourceLicitationId && shouldAutoCreate) {
+    const existing = await prisma.proposal.findFirst({
+      where: {
+        userId: user.id,
+        sourceLicitationId,
+      },
+      orderBy: [{ updatedAt: "desc" }],
+      select: { id: true },
+    });
+
+    let targetId = existing?.id ?? null;
+
+    if (!targetId) {
+      const source = await prisma.licitation.findUnique({
+        where: { id: sourceLicitationId },
+        select: {
+          id: true,
+          title: true,
+          description: true,
+          supplierAwarded: true,
+        },
+      });
+
+      if (source) {
+        const created = await prisma.proposal.create({
+          data: {
+            userId: user.id,
+            sourceLicitationId: source.id,
+            title: source.title,
+            issuingEntity: source.supplierAwarded?.trim() || "Entidad no especificada",
+            summary: source.description ?? "",
+          },
+          select: { id: true },
+        });
+
+        targetId = created.id;
+      }
+    }
+
+    if (targetId) {
+      redirect(`/gestion-licitaciones/${encodeURIComponent(targetId)}${shouldAutoFill ? "?autofill=1" : ""}`);
+    }
+  }
+
+  const proposals = await listUserProposals(user.id, "");
+  const latestProposal = proposals[0] ?? null;
+  const candadosHref =
+    latestProposal
+      ? `/candados?proposalId=${encodeURIComponent(latestProposal.id)}${
+          latestProposal.sourceLicitationId ? `&sourceId=${encodeURIComponent(latestProposal.sourceLicitationId)}` : ""
+        }`
+      : sourceLicitationId
+        ? `/candados?sourceId=${encodeURIComponent(sourceLicitationId)}`
+        : "/candados";
+
+  return (
+    <PageShell
+      title="Modulo 5: Gestion de Licitaciones"
+      headerMode="module"
+      headerBackHref="/normative-analysis"
+      headerBackLabel="M4: Analisis"
+      headerNextHref={candadosHref}
+      headerNextLabel="M6: Candados"
+      headerPlanBadgeLabel="Plan Premium"
+      showPageHeading={false}
+      contentWidth="wide"
+      className="space-y-6"
+    >
+      <section className="flex flex-wrap items-center justify-between gap-4">
+        <div>
+          <h1 className="text-4xl font-semibold text-[#132549] [font-family:var(--font-display)] md:text-5xl">Gestion de Licitaciones</h1>
+          <p className="mt-2 text-xl text-[#4f6588] md:text-2xl">Prepara tus propuestas de licitacion paso a paso</p>
+        </div>
+      </section>
+
+      <ProposalsManagementView initialProposals={proposals} initialSourceLicitationId={sourceLicitationId} />
+    </PageShell>
+  );
+}
diff --git a/src/app/licitations/[id]/page.tsx b/src/app/licitations/[id]/page.tsx
index e0c43ea..c20a6b8 100644
--- a/src/app/licitations/[id]/page.tsx
+++ b/src/app/licitations/[id]/page.tsx
@@ -1,9 +1,12 @@
 import Link from "next/link";
 import { notFound } from "next/navigation";
-import { isAdminIdentity } from "@/lib/auth/admin";
+import { hasModuleAccess } from "@/lib/auth/module-access";
 import { requireOnboardedUser } from "@/lib/auth/user";
+import { isLikelyPdfUrl, parseLicitationDocumentLinks, pickPrimaryLicitationPdfDocument } from "@/lib/licitations/documents";
 import { getCategoryLabel, getProcedureTypeLabel, getSourceLabel } from "@/lib/licitations/labels";
+import { type LicitationReviewStatusView } from "@/lib/licitations/preferences";
 import { prisma } from "@/lib/prisma";
+import { LicitationCardActions } from "@/components/app/licitation-card-actions";
 import { PageShell } from "@/components/app/page-shell";
 import { Button } from "@/components/ui/button";
 import { Card, CardContent, CardHeader } from "@/components/ui/card";
@@ -25,22 +28,10 @@ function formatDate(value: Date | null) {
 }
 
 function toDocumentArray(value: unknown) {
-  if (!Array.isArray(value)) {
-    return [] as Array<{ name: string; url: string; type?: string }>;
-  }
-
-  return value
-    .filter((item) => item && typeof item === "object")
-    .map((item) => {
-      const entry = item as Record<string, unknown>;
-
-      return {
-        name: typeof entry.name === "string" ? entry.name : "Documento",
-        url: typeof entry.url === "string" ? entry.url : "",
-        type: typeof entry.type === "string" ? entry.type : undefined,
-      };
-    })
-    .filter((item) => item.url.length > 0);
+  return parseLicitationDocumentLinks(value).map((item) => ({
+    ...item,
+    type: item.type ?? undefined,
+  }));
 }
 
 function toEventDates(value: unknown) {
@@ -60,7 +51,7 @@ function toEventDates(value: unknown) {
 
 export default async function LicitationDetailPage({ params }: LicitationDetailPageProps) {
   const user = await requireOnboardedUser();
-  const hasPaidModulesAccess = isAdminIdentity(user.email, user.role);
+  const hasPaidModulesAccess = await hasModuleAccess(user, 3);
 
   if (!hasPaidModulesAccess) {
     return (
@@ -99,16 +90,56 @@ export default async function LicitationDetailPage({ params }: LicitationDetailP
   }
 
   const documents = toDocumentArray(licitation.documents);
+  const primaryPdfDocument =
+    pickPrimaryLicitationPdfDocument(parseLicitationDocumentLinks(licitation.documents)) ??
+    (isLikelyPdfUrl(licitation.rawSourceUrl)
+      ? {
+          name: "Documento principal",
+          url: licitation.rawSourceUrl as string,
+          type: "PDF",
+        }
+      : null);
   const timeline = toEventDates(licitation.eventDates);
+  const preference = await prisma.licitationUserPreference.findUnique({
+    where: {
+      userId_licitationId: {
+        userId: user.id,
+        licitationId: licitation.id,
+      },
+    },
+    select: {
+      status: true,
+    },
+  });
+  const reviewStatus = (preference?.status as LicitationReviewStatusView | undefined) ?? "NEW";
 
   return (
     <PageShell
       title="Detalle de licitacion"
       description={`${licitation.municipality.municipalityName}, ${licitation.municipality.stateName}`}
+      headerMode="module"
+      headerBackHref="/licitations"
+      headerBackLabel="Volver a Oportunidades"
+      headerShowManual
+      headerPlanBadgeLabel="Plan Premium"
+      contentWidth="wide"
       action={
-        <Link href="/licitations">
-          <Button variant="secondary">Volver a resultados</Button>
-        </Link>
+        <div className="flex gap-2">
+          <Link href={`/normative-analysis?sourceId=${encodeURIComponent(licitation.id)}`}>
+            <Button>Analizar en Modulo 4</Button>
+          </Link>
+          <Link href={`/gestion-licitaciones?sourceId=${encodeURIComponent(licitation.id)}&autocreate=1&autofill=1`}>
+            <Button variant="secondary">Crear propuesta (M5)</Button>
+          </Link>
+          {primaryPdfDocument ? (
+            <a href={primaryPdfDocument.url} target="_blank" rel="noreferrer">
+              <Button variant="secondary">Ver PDF principal</Button>
+            </a>
+          ) : null}
+          <Link href="/licitations">
+            <Button variant="secondary">Volver a resultados</Button>
+          </Link>
+        </div>
       }
     >
       <Card>
@@ -129,6 +160,12 @@ export default async function LicitationDetailPage({ params }: LicitationDetailP
             <span className="rounded-full border border-[#d8e1ef] px-2 py-1">Cierre: {formatDate(licitation.closingDate)}</span>
           </div>
 
+          <LicitationCardActions
+            licitationId={licitation.id}
+            initialStatus={reviewStatus}
+            normativeAnalysisHref={`/normative-analysis?sourceId=${encodeURIComponent(licitation.id)}`}
+          />
+
           <div className="grid gap-3 md:grid-cols-2">
             <div className="rounded-xl border border-[#d8e1ef] p-3">
               <p className="text-xs font-semibold uppercase text-[#60718f]">Monto</p>
@@ -170,6 +207,16 @@ export default async function LicitationDetailPage({ params }: LicitationDetailP
           <h3 className="text-lg font-semibold text-[#1f2a40]">Documentos</h3>
         </CardHeader>
         <CardContent className="space-y-2">
+          {primaryPdfDocument ? (
+            <a
+              href={primaryPdfDocument.url}
+              target="_blank"
+              rel="noreferrer"
+              className="block rounded-xl border border-[#c6d8f4] bg-[#ebf3ff] p-3 text-sm font-semibold text-[#1f3f84]"
+            >
+              PDF principal: {primaryPdfDocument.name}
+            </a>
+          ) : null}
           {documents.length === 0 ? (
             <p className="text-sm text-[#64718a]">No hay documentos asociados.</p>
           ) : (
diff --git a/src/app/licitations/page.tsx b/src/app/licitations/page.tsx
index 829a748..35ac8c7 100644
--- a/src/app/licitations/page.tsx
+++ b/src/app/licitations/page.tsx
@@ -1,22 +1,64 @@
 import Link from "next/link";
-import { LicitationProcedureType } from "@prisma/client";
-import { isAdminIdentity } from "@/lib/auth/admin";
+import type { LicitationSource } from "@prisma/client";
+import { hasModuleAccess } from "@/lib/auth/module-access";
 import { requireOnboardedUser } from "@/lib/auth/user";
-import { getCategoryLabel, getProcedureTypeLabel, getSourceLabel } from "@/lib/licitations/labels";
+import { isLikelyPdfUrl, parseLicitationDocumentLinks, pickPrimaryLicitationPdfDocument } from "@/lib/licitations/documents";
+import { getCategoryLabel, getProcedureTypeLabel } from "@/lib/licitations/labels";
+import { getLicitationReviewStatusLabel, type LicitationReviewStatusView } from "@/lib/licitations/preferences";
 import { listMunicipalities, searchLicitations } from "@/lib/licitations/query";
-import { getLicitationRecommendationsForUser } from "@/lib/licitations/recommendations";
+import { getAiEnhancedLicitationRecommendationsForUser } from "@/lib/licitations/ai-recommendations";
+import { computeModule3Summary, getViabilityLevel } from "@/lib/licitations/module3";
+import { prisma } from "@/lib/prisma";
+import { LicitationCardActions } from "@/components/app/licitation-card-actions";
 import { LicitationsSyncButton } from "@/components/app/licitations-sync-button";
 import { PageShell } from "@/components/app/page-shell";
 import { Button } from "@/components/ui/button";
-import { Card, CardContent, CardHeader } from "@/components/ui/card";
+import { Card, CardContent } from "@/components/ui/card";
 
 type LicitationsPageProps = {
   searchParams: Promise<Record<string, string | string[] | undefined>>;
 };
 
+type ViabilityFilter = "all" | "alta" | "media" | "baja";
+type SortFilter = "compat_desc" | "compat_asc" | "closing_soon" | "recent";
+type StatusFilter = "all" | "open" | "closed";
+type ReviewFilter = "all" | "consulted" | "interested" | "active";
+
 function getParam(params: Record<string, string | string[] | undefined>, key: string) {
   const value = params[key];
-  return Array.isArray(value) ? value[0] : value;
+  return Array.isArray(value) ? value[0] ?? "" : (value ?? "");
+}
+
+function parseViability(value: string): ViabilityFilter {
+  if (value === "alta" || value === "media" || value === "baja") {
+    return value;
+  }
+
+  return "all";
+}
+
+function parseSort(value: string): SortFilter {
+  if (value === "compat_asc" || value === "closing_soon" || value === "recent") {
+    return value;
+  }
+
+  return "compat_desc";
+}
+
+function parseStatus(value: string): StatusFilter {
+  if (value === "open" || value === "closed") {
+    return value;
+  }
+
+  return "all";
+}
+
+function parseReview(value: string): ReviewFilter {
+  if (value === "consulted" || value === "interested" || value === "active") {
+    return value;
+  }
+
+  return "all";
 }
 
 function formatDate(value: Date | null) {
@@ -26,11 +68,18 @@ function formatDate(value: Date | null) {
 
   return value.toLocaleDateString("es-MX", {
     year: "numeric",
-    month: "short",
+    month: "long",
     day: "2-digit",
   });
 }
 
+function formatDateShort(value: Date) {
+  return value.toLocaleDateString("es-MX", {
+    day: "2-digit",
+    month: "long",
+  });
+}
+
 function formatAmount(amount: unknown, currency: string | null) {
   if (amount == null) {
     return "Monto no disponible";
@@ -42,12 +91,67 @@ function formatAmount(amount: unknown, currency: string | null) {
     return "Monto no disponible";
   }
 
-  return `${currency ?? "MXN"} ${numeric.toLocaleString("es-MX", { maximumFractionDigits: 2 })}`;
+  return `${currency ?? "MXN"} ${numeric.toLocaleString("es-MX", { maximumFractionDigits: 0 })}`;
+}
+
+function getSourceShortLabel(source: LicitationSource) {
+  if (source === "MUNICIPAL_OPEN_PORTAL") {
+    return "Portal municipal";
+  }
+
+  if (source === "MUNICIPAL_BACKUP") {
+    return "Portal respaldo";
+  }
+
+  if (source === "LICITAYA") {
+    return "LicitaYa API";
+  }
+
+  return "PNT";
+}
+
+function getDaysUntilDate(value: Date | null) {
+  if (!value) {
+    return "Sin cierre";
+  }
+
+  const now = new Date();
+  const difference = value.getTime() - now.getTime();
+  const dayCount = Math.max(0, Math.ceil(difference / (1000 * 60 * 60 * 24)));
+  return `${dayCount} dias`;
+}
+
+function ViabilityBadge({ score }: { score: number }) {
+  const level = getViabilityLevel(score);
+
+  const label = level === "alta" ? "Alta Viabilidad" : level === "media" ? "Media Viabilidad" : "Baja Viabilidad";
+  const className =
+    level === "alta"
+      ? "border-[#b8e3d0] bg-[#ecf9f2] text-[#1f8b63]"
+      : level === "media"
+        ? "border-[#f0deb0] bg-[#fff8e9] text-[#9d6d08]"
+        : "border-[#f2cccc] bg-[#fff1f1] text-[#af3a3a]";
+
+  return <span className={`inline-flex rounded-full border px-3 py-1 text-sm font-semibold ${className}`}>{label}</span>;
+}
+
+function ReviewStatusBadge({ status }: { status: LicitationReviewStatusView }) {
+  const label = getLicitationReviewStatusLabel(status);
+  const className =
+    status === "REVIEWED"
+      ? "border-[#d4dbe8] bg-[#f2f5fb] text-[#42577c]"
+      : status === "INTERESTED"
+        ? "border-[#b9e6cd] bg-[#eaf9f1] text-[#1f8b63]"
+        : status === "DISCARDED"
+          ? "border-[#f0ccd2] bg-[#fff1f4] text-[#a74150]"
+          : "border-[#d4e2ff] bg-[#e8f0ff] text-[#2f58c1]";
+
+  return <span className={`inline-flex rounded-full border px-3 py-1 text-sm font-semibold ${className}`}>{label}</span>;
 }
 
 export default async function LicitationsPage({ searchParams }: LicitationsPageProps) {
   const user = await requireOnboardedUser();
-  const hasPaidModulesAccess = isAdminIdentity(user.email, user.role);
+  const hasPaidModulesAccess = await hasModuleAccess(user, 3);
 
   if (!hasPaidModulesAccess) {
     return (
@@ -57,10 +161,8 @@ export default async function LicitationsPage({ searchParams }: LicitationsPageP
         action={<span className="rounded-full border border-[#d5ddec] bg-[#edf2fb] px-4 py-1 text-sm font-semibold text-[#5a6a87]">Bloqueado</span>}
       >
         <Card>
-          <CardHeader>
-            <h2 className="text-lg font-semibold text-[#1f2a40]">Acceso restringido</h2>
-          </CardHeader>
-          <CardContent className="space-y-3">
+          <CardContent className="space-y-3 py-6">
+            <h2 className="text-2xl font-semibold text-[#1f2a40]">Acceso restringido</h2>
             <p className="text-sm text-[#64718a]">
               El Modulo 3 forma parte de la ruta premium. Tu cuenta actual puede completar el Diagnostico (Modulo 1) y ver los planes en la seccion Modulos.
             </p>
@@ -74,14 +176,18 @@ export default async function LicitationsPage({ searchParams }: LicitationsPageP
   }
 
   const params = await searchParams;
-  const q = getParam(params, "q") ?? "";
-  const state = getParam(params, "state") ?? "";
-  const municipality = getParam(params, "municipality") ?? "";
-  const procedureType = getParam(params, "procedure_type") ?? "";
-  const minAmount = getParam(params, "min_amount") ?? "";
-  const maxAmount = getParam(params, "max_amount") ?? "";
-  const dateFrom = getParam(params, "date_from") ?? "";
-  const dateTo = getParam(params, "date_to") ?? "";
+  const q = getParam(params, "q");
+  const state = getParam(params, "state");
+  const municipality = getParam(params, "municipality");
+  const procedureType = getParam(params, "procedure_type");
+  const minAmount = getParam(params, "min_amount");
+  const maxAmount = getParam(params, "max_amount");
+  const dateFrom = getParam(params, "date_from");
+  const dateTo = getParam(params, "date_to");
+  const viabilityFilter = parseViability(getParam(params, "viability"));
+  const statusFilter = parseStatus(getParam(params, "status"));
+  const reviewFilter = parseReview(getParam(params, "review"));
+  const sortFilter = parseSort(getParam(params, "sort"));
 
   const [municipalities, records, recommendations] = await Promise.all([
     listMunicipalities(),
@@ -96,166 +202,522 @@ export default async function LicitationsPage({ searchParams }: LicitationsPageP
       dateTo,
       take: 100,
     }),
-    getLicitationRecommendationsForUser(user.id),
+    getAiEnhancedLicitationRecommendationsForUser(user.id),
   ]);
 
+  const preferenceRecords = records.records.length
+    ? await prisma.licitationUserPreference.findMany({
+        where: {
+          userId: user.id,
+          licitationId: {
+            in: records.records.map((record) => record.id),
+          },
+        },
+        select: {
+          licitationId: true,
+          status: true,
+        },
+      })
+    : [];
+
+  const recommendationsById = new Map(recommendations.results.map((item) => [item.id, item]));
+  const preferencesById = new Map(preferenceRecords.map((item) => [item.licitationId, item.status as LicitationReviewStatusView]));
+  const activeProposalRecords = records.records.length
+    ? await prisma.proposal.findMany({
+        where: {
+          userId: user.id,
+          sourceLicitationId: {
+            in: records.records.map((record) => record.id),
+          },
+          status: {
+            not: "ARCHIVED",
+          },
+        },
+        select: {
+          sourceLicitationId: true,
+          status: true,
+          updatedAt: true,
+        },
+        orderBy: [{ updatedAt: "desc" }],
+      })
+    : [];
+  const activeLicitationIds = new Set(activeProposalRecords.map((item) => item.sourceLicitationId).filter((value): value is string => Boolean(value)));
+
+  const baseRows = records.records
+    .map((record) => {
+      const recommendation = recommendationsById.get(record.id);
+      const deterministicScore = recommendation?.deterministicScore ?? recommendation?.score ?? 0;
+      const aiFitScore = recommendation?.aiScore ?? deterministicScore;
+      const blendedScore = recommendation?.blendedScore ?? deterministicScore;
+
+      return {
+        id: record.id,
+        title: record.title,
+        description: record.description,
+        entity: record.supplierAwarded ?? "Entidad no especificada",
+        municipalityName: record.municipality.municipalityName,
+        stateName: record.municipality.stateName,
+        amountLabel: formatAmount(record.amount, record.currency),
+        daysToClose: getDaysUntilDate(record.closingDate),
+        procedureLabel: getProcedureTypeLabel(record.procedureType),
+        categoryLabel: getCategoryLabel(record.category),
+        publishDate: record.publishDate,
+        closingDate: record.closingDate,
+        sourceLabel: getSourceShortLabel(record.source),
+        deterministicScore,
+        aiFitScore,
+        compatibilityScore: blendedScore,
+        blendedScore,
+        reasons: recommendation?.reasons ?? [],
+        aiReasons: recommendation?.aiReasons ?? [],
+        aiRisks: recommendation?.aiRisks ?? [],
+        nextStep: recommendation?.nextStep ?? null,
+        suggestionId: recommendation?.suggestionId ?? null,
+        isOpen: record.isOpen,
+        reviewStatus: preferencesById.get(record.id) ?? "NEW",
+        isActive: activeLicitationIds.has(record.id),
+        primaryPdfUrl:
+          pickPrimaryLicitationPdfDocument(parseLicitationDocumentLinks(record.documents))?.url ??
+          (isLikelyPdfUrl(record.rawSourceUrl) ? record.rawSourceUrl : null),
+      };
+    })
+    .filter((row) => {
+      if (statusFilter === "open") {
+        return row.isOpen;
+      }
+
+      if (statusFilter === "closed") {
+        return !row.isOpen;
+      }
+
+      return true;
+    })
+    .filter((row) => {
+      if (viabilityFilter === "all") {
+        return true;
+      }
+
+      return getViabilityLevel(row.compatibilityScore) === viabilityFilter;
+    });
+
+  const rows = baseRows.filter((row) => {
+      if (reviewFilter === "consulted") {
+        return row.reviewStatus === "REVIEWED";
+      }
+
+      if (reviewFilter === "interested") {
+        return row.reviewStatus === "INTERESTED";
+      }
+
+      if (reviewFilter === "active") {
+        return row.isActive;
+      }
+
+      return true;
+    });
+
+  const sortedRows = [...rows].sort((left, right) => {
+    if (sortFilter === "compat_asc") {
+      return left.blendedScore - right.blendedScore;
+    }
+
+    if (sortFilter === "closing_soon") {
+      const leftTime = left.closingDate?.getTime() ?? Number.MAX_SAFE_INTEGER;
+      const rightTime = right.closingDate?.getTime() ?? Number.MAX_SAFE_INTEGER;
+      return leftTime - rightTime;
+    }
+
+    if (sortFilter === "recent") {
+      const leftTime = left.publishDate?.getTime() ?? 0;
+      const rightTime = right.publishDate?.getTime() ?? 0;
+      return rightTime - leftTime;
+    }
+
+    return right.blendedScore - left.blendedScore;
+  });
+
   const uniqueStates = Array.from(new Map(municipalities.map((item) => [item.stateCode, item.stateName])).entries()).map(([code, name]) => ({
     code,
     name,
   }));
+
   const filteredMunicipalities = state ? municipalities.filter((item) => item.stateCode === state) : municipalities;
+  const now = new Date();
+  const summary = computeModule3Summary(
+    sortedRows.length,
+    sortedRows.map((row) => ({
+      id: row.id,
+      score: row.compatibilityScore,
+      publishDate: row.publishDate?.toISOString() ?? null,
+    })),
+    now,
+  );
+  const newToReviewCount = sortedRows.filter((row) => row.reviewStatus === "NEW").length;
+  const consultedCount = baseRows.filter((row) => row.reviewStatus === "REVIEWED").length;
+  const interestedCount = baseRows.filter((row) => row.reviewStatus === "INTERESTED").length;
+  const activeCount = baseRows.filter((row) => row.isActive).length;
 
   return (
     <PageShell
       title="Modulo 3: Deteccion de Oportunidades"
-      description="Encuentra licitaciones compatibles con tu perfil empresarial"
-      action={<LicitationsSyncButton />}
+      headerMode="module"
+      headerBackHref="/dashboard"
+      headerBackLabel="Volver al Dashboard"
+      headerShowManual
+      headerPlanBadgeLabel="Plan Premium"
+      showPageHeading={false}
+      contentWidth="wide"
       className="space-y-6"
     >
+      <section className="flex flex-wrap items-center justify-between gap-4">
+        <div className="flex items-start gap-4">
+          <span className="inline-flex h-14 w-14 items-center justify-center rounded-2xl bg-[#dee5f1] text-3xl text-[#264574]">✧</span>
+          <div>
+            <h1 className="text-4xl font-semibold text-[#132549] [font-family:var(--font-display)] md:text-5xl">Modulo 3: Deteccion de Oportunidades</h1>
+            <p className="mt-2 text-xl text-[#4f6588] md:text-2xl">Encuentra licitaciones compatibles con tu perfil empresarial</p>
+          </div>
+        </div>
+        <LicitationsSyncButton />
+      </section>
+
+      <Card className="border-[#d2dbe9] bg-[#f7f9fd]">
+        <CardContent className="flex items-center justify-between py-5">
+          <div>
+            <p className="text-2xl font-semibold text-[#1b3158] [font-family:var(--font-display)] md:text-3xl">Como usar este modulo?</p>
+            <p className="text-base text-[#566d92] md:text-lg">Guia rapida para encontrar oportunidades</p>
+          </div>
+          <span className="text-2xl text-[#273f67]" aria-hidden>
+            ˅
+          </span>
+        </CardContent>
+      </Card>
+
+      <section className="grid gap-4 md:grid-cols-4">
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-4xl font-semibold text-[#12274d] md:text-5xl">{summary.opportunities}</p>
+            <p className="text-lg text-[#60718f] md:text-xl">Oportunidades</p>
+          </CardContent>
+        </Card>
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-4xl font-semibold text-[#12274d] md:text-5xl">{summary.highViability}</p>
+            <p className="text-lg text-[#60718f] md:text-xl">Alta viabilidad</p>
+          </CardContent>
+        </Card>
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-4xl font-semibold text-[#12274d] md:text-5xl">{summary.mediumViability}</p>
+            <p className="text-lg text-[#60718f] md:text-xl">Media viabilidad</p>
+          </CardContent>
+        </Card>
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-4xl font-semibold text-[#12274d] md:text-5xl">{summary.averageCompatibility}%</p>
+            <p className="text-lg text-[#60718f] md:text-xl">Compatibilidad promedio</p>
+          </CardContent>
+        </Card>
+      </section>
+
+      <section className="grid gap-3 md:grid-cols-3">
+        <Link href="/licitations?review=consulted" className="block">
+          <Card className={reviewFilter === "consulted" ? "border-[#b8c9eb] bg-[#edf3ff]" : undefined}>
+            <CardContent className="py-4">
+              <p className="text-3xl font-semibold text-[#15305d]">{consultedCount}</p>
+              <p className="text-sm font-semibold text-[#5f7090]">Consultadas</p>
+            </CardContent>
+          </Card>
+        </Link>
+        <Link href="/licitations?review=interested" className="block">
+          <Card className={reviewFilter === "interested" ? "border-[#b9e6cd] bg-[#edf9f2]" : undefined}>
+            <CardContent className="py-4">
+              <p className="text-3xl font-semibold text-[#155540]">{interestedCount}</p>
+              <p className="text-sm font-semibold text-[#5f7090]">Me interesa</p>
+            </CardContent>
+          </Card>
+        </Link>
+        <Link href="/licitations?review=active" className="block">
+          <Card className={reviewFilter === "active" ? "border-[#f0deb0] bg-[#fff9ea]" : undefined}>
+            <CardContent className="py-4">
+              <p className="text-3xl font-semibold text-[#704f05]">{activeCount}</p>
+              <p className="text-sm font-semibold text-[#5f7090]">Activas</p>
+            </CardContent>
+          </Card>
+        </Link>
+      </section>
+
+      <p className="text-base text-[#4d6488] md:text-lg">
+        Ultimo analisis: {formatDateShort(now)}, {now.toLocaleTimeString("es-MX", { hour: "2-digit", minute: "2-digit" })} ·
+        <span className="ml-1 font-semibold text-[#1c3768]">{newToReviewCount} nuevas por revisar</span>
+      </p>
+
       <Card>
         <CardContent className="py-4">
-          <form method="get" className="grid gap-3 md:grid-cols-3">
-            <label className="space-y-1 text-sm font-semibold text-[#33415c] md:col-span-2">
-              Buscar oportunidades
-              <input
-                type="text"
-                name="q"
-                defaultValue={q}
-                placeholder="Palabra clave, proveedor, concepto..."
-                className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
-              />
-            </label>
+          <form method="get" className="space-y-4">
+            <div className="grid gap-3 lg:grid-cols-[minmax(0,1fr)_220px_220px_220px_220px]">
+              <label className="space-y-1 text-sm font-semibold text-[#33415c] lg:col-span-1">
+                Buscar oportunidades
+                <input
+                  type="text"
+                  name="q"
+                  defaultValue={q}
+                  placeholder="Buscar oportunidades..."
+                  className="h-12 w-full rounded-xl border border-[#cfd8e6] px-4 text-base"
+                />
+              </label>
 
-            <label className="space-y-1 text-sm font-semibold text-[#33415c]">
-              Tipo de procedimiento
-              <select name="procedure_type" defaultValue={procedureType} className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm">
-                <option value="">Todos</option>
-                <option value={LicitationProcedureType.LICITACION_PUBLICA}>Licitacion publica</option>
-                <option value={LicitationProcedureType.INVITACION_RESTRINGIDA}>Invitacion restringida</option>
-                <option value={LicitationProcedureType.ADJUDICACION_DIRECTA}>Adjudicacion directa</option>
-              </select>
-            </label>
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Viabilidad
+                <select name="viability" defaultValue={viabilityFilter} className="h-12 w-full rounded-xl border border-[#cfd8e6] px-3 text-base">
+                  <option value="all">Todas</option>
+                  <option value="alta">Alta</option>
+                  <option value="media">Media</option>
+                  <option value="baja">Baja</option>
+                </select>
+              </label>
 
-            <label className="space-y-1 text-sm font-semibold text-[#33415c]">
-              Estado
-              <select name="state" defaultValue={state} className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm">
-                <option value="">Todos los estados</option>
-                {uniqueStates.map((stateOption) => (
-                  <option key={stateOption.code} value={stateOption.code}>
-                    {stateOption.name}
-                  </option>
-                ))}
-              </select>
-            </label>
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Estatus
+                <select name="status" defaultValue={statusFilter} className="h-12 w-full rounded-xl border border-[#cfd8e6] px-3 text-base">
+                  <option value="all">Todos</option>
+                  <option value="open">Abiertas</option>
+                  <option value="closed">Cerradas</option>
+                </select>
+              </label>
 
-            <label className="space-y-1 text-sm font-semibold text-[#33415c]">
-              Municipio
-              <select name="municipality" defaultValue={municipality} className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm">
-                <option value="">Todos</option>
-                {filteredMunicipalities.map((municipalityOption) => (
-                  <option key={municipalityOption.id} value={municipalityOption.municipalityCode}>
-                    {municipalityOption.municipalityName}
-                  </option>
-                ))}
-              </select>
-            </label>
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Seguimiento M3
+                <select name="review" defaultValue={reviewFilter} className="h-12 w-full rounded-xl border border-[#cfd8e6] px-3 text-base">
+                  <option value="all">Todos</option>
+                  <option value="consulted">Consultadas</option>
+                  <option value="interested">Me interesa</option>
+                  <option value="active">Activas</option>
+                </select>
+              </label>
 
-            <label className="space-y-1 text-sm font-semibold text-[#33415c]">
-              Monto minimo
-              <input type="number" step="0.01" name="min_amount" defaultValue={minAmount} className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm" />
-            </label>
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Ordenar por
+                <select name="sort" defaultValue={sortFilter} className="h-12 w-full rounded-xl border border-[#cfd8e6] px-3 text-base">
+                  <option value="compat_desc">Mayor compatibilidad</option>
+                  <option value="compat_asc">Menor compatibilidad</option>
+                  <option value="closing_soon">Cierre proximo</option>
+                  <option value="recent">Mas recientes</option>
+                </select>
+              </label>
+            </div>
 
-            <label className="space-y-1 text-sm font-semibold text-[#33415c]">
-              Monto maximo
-              <input type="number" step="0.01" name="max_amount" defaultValue={maxAmount} className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm" />
-            </label>
+            <div className="grid gap-3 md:grid-cols-2 lg:grid-cols-6">
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Procedimiento
+                <select name="procedure_type" defaultValue={procedureType} className="h-12 w-full rounded-xl border border-[#cfd8e6] px-3 text-base">
+                  <option value="">Todos</option>
+                  <option value="LICITACION_PUBLICA">Licitacion publica</option>
+                  <option value="INVITACION_RESTRINGIDA">Invitacion restringida</option>
+                  <option value="ADJUDICACION_DIRECTA">Adjudicacion directa</option>
+                </select>
+              </label>
 
-            <label className="space-y-1 text-sm font-semibold text-[#33415c]">
-              Fecha desde
-              <input type="date" name="date_from" defaultValue={dateFrom} className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm" />
-            </label>
+              <label className="space-y-1 text-sm font-semibold text-[#33415c] lg:col-span-2">
+                Estado
+                <select name="state" defaultValue={state} className="h-12 w-full rounded-xl border border-[#cfd8e6] px-3 text-base">
+                  <option value="">Todos los estados</option>
+                  {uniqueStates.map((stateOption) => (
+                    <option key={stateOption.code} value={stateOption.code}>
+                      {stateOption.name}
+                    </option>
+                  ))}
+                </select>
+              </label>
 
-            <label className="space-y-1 text-sm font-semibold text-[#33415c]">
-              Fecha hasta
-              <input type="date" name="date_to" defaultValue={dateTo} className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm" />
-            </label>
+              <label className="space-y-1 text-sm font-semibold text-[#33415c] lg:col-span-2">
+                Municipio
+                <select name="municipality" defaultValue={municipality} className="h-12 w-full rounded-xl border border-[#cfd8e6] px-3 text-base">
+                  <option value="">Todos</option>
+                  {filteredMunicipalities.map((municipalityOption) => (
+                    <option key={municipalityOption.id} value={municipalityOption.municipalityCode}>
+                      {municipalityOption.municipalityName}
+                    </option>
+                  ))}
+                </select>
+              </label>
 
-            <div className="md:col-span-3 flex gap-2">
-              <Button type="submit">Aplicar filtros</Button>
-              <Link href="/licitations">
-                <Button type="button" variant="secondary">
-                  Limpiar
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Monto minimo
+                <input type="number" step="0.01" name="min_amount" defaultValue={minAmount} className="h-12 w-full rounded-xl border border-[#cfd8e6] px-3 text-base" />
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Monto maximo
+                <input type="number" step="0.01" name="max_amount" defaultValue={maxAmount} className="h-12 w-full rounded-xl border border-[#cfd8e6] px-3 text-base" />
+              </label>
+
+              <input type="hidden" name="date_from" value={dateFrom} />
+              <input type="hidden" name="date_to" value={dateTo} />
+
+              <div className="flex items-end gap-2 lg:col-span-2">
+                <Button type="submit" className="h-12 rounded-xl px-5">
+                  Aplicar
                 </Button>
-              </Link>
+                <Link href="/licitations" className="inline-flex">
+                  <Button type="button" variant="secondary" className="h-12 rounded-xl px-5">
+                    Limpiar
+                  </Button>
+                </Link>
+              </div>
             </div>
           </form>
         </CardContent>
       </Card>
 
-      <Card>
-        <CardHeader>
-          <h2 className="text-lg font-semibold text-[#1f2a40]">Recomendaciones para tu empresa</h2>
-        </CardHeader>
-        <CardContent className="space-y-3">
-          {recommendations.results.slice(0, 5).length ? (
-            recommendations.results.slice(0, 5).map((item) => (
-              <div key={item.id} className="rounded-xl border border-[#d8e1ef] bg-white p-3">
-                <div className="flex flex-wrap items-center justify-between gap-2">
-                  <p className="text-sm font-semibold text-[#1f2f4f]">{item.title}</p>
-                  <span className="rounded-full bg-[#e8eefc] px-2 py-1 text-xs font-semibold text-[#1a3f8d]">Score {item.score}</span>
-                </div>
-                <p className="mt-1 text-sm text-[#5c6f8e]">{item.municipalityName}, {item.stateName}</p>
-                <p className="mt-1 text-xs text-[#5c6f8e]">{item.reasons.join(" ")}</p>
-                <Link href={`/licitations/${item.id}`} className="mt-2 inline-flex text-sm font-semibold text-[#1f3f84]">
-                  Ver detalle
-                </Link>
-              </div>
-            ))
-          ) : (
-            <p className="text-sm text-[#64718a]">Aun no hay recomendaciones por perfil. Completa tu perfil y ejecuta sincronizacion.</p>
-          )}
-        </CardContent>
-      </Card>
-
-      <Card>
-        <CardHeader>
-          <h2 className="text-lg font-semibold text-[#1f2a40]">Resultados ({records.total})</h2>
-          <p className="text-sm text-[#60718f]">Mostrando oportunidades abiertas por defecto.</p>
-        </CardHeader>
-        <CardContent className="space-y-3">
-          {records.records.length === 0 ? (
-            <p className="text-sm text-[#64718a]">No se encontraron oportunidades con los filtros seleccionados.</p>
-          ) : (
-            records.records.map((record) => (
-              <article key={record.id} className="rounded-xl border border-[#d8e1ef] bg-white p-4">
-                <div className="flex flex-wrap items-start justify-between gap-2">
-                  <div>
-                    <p className="text-xs font-semibold uppercase text-[#60718f]">{record.municipality.stateName} / {record.municipality.municipalityName}</p>
-                    <h3 className="text-lg font-semibold text-[#1f2a40]">{record.title}</h3>
-                    <p className="text-sm text-[#60718f]">{record.description ?? "Sin descripcion"}</p>
+      <section className="grid gap-4 xl:grid-cols-2">
+        {sortedRows.length === 0 ? (
+          <Card className="xl:col-span-2">
+            <CardContent className="py-14 text-center">
+              <p className="text-2xl font-semibold text-[#1b3158] [font-family:var(--font-display)] md:text-3xl">No hay oportunidades con estos filtros</p>
+              <p className="mt-2 text-base text-[#5f7090] md:text-lg">Ajusta los filtros o ejecuta una nueva sincronizacion.</p>
+            </CardContent>
+          </Card>
+        ) : (
+          sortedRows.map((row) => (
+            <article
+              key={row.id}
+              className={`rounded-2xl border border-[#d7dfea] p-6 shadow-[0_1px_2px_rgba(16,24,40,0.06)] ${row.reviewStatus === "DISCARDED" ? "bg-[#fafbfe] opacity-85" : "bg-white"}`}
+            >
+                <div className="flex flex-wrap items-start justify-between gap-3">
+              <div className="flex flex-wrap items-center gap-2">
+                    <ReviewStatusBadge status={row.reviewStatus} />
+                    <ViabilityBadge score={row.blendedScore} />
+                    {row.isActive ? (
+                      <span className="inline-flex rounded-full border border-[#f0deb0] bg-[#fff8e9] px-3 py-1 text-sm font-semibold text-[#8d6308]">Activa en M5</span>
+                    ) : null}
                   </div>
-                  <span className="rounded-full bg-[#eef3ff] px-2 py-1 text-xs font-semibold text-[#1f3f84]">{getProcedureTypeLabel(record.procedureType)}</span>
+                <div className="text-right">
+                  <p className="text-3xl font-semibold text-[#12306a] md:text-4xl">{row.blendedScore}%</p>
+                  <p className="text-base text-[#5f7290] md:text-lg">score combinado</p>
                 </div>
+              </div>
 
-                <div className="mt-3 flex flex-wrap items-center gap-2 text-xs text-[#5e7190]">
-                  <span className={`rounded-full border px-2 py-1 ${record.isOpen ? "border-[#acd8c7] bg-[#e8f7ef] text-[#1c8f67]" : "border-[#d4dced]"}`}>
-                    {record.isOpen ? "Abierta" : "Cerrada"}
+              <h3 className="mt-4 text-2xl font-semibold leading-tight text-[#162748] [font-family:var(--font-display)] md:text-3xl">{row.title}</h3>
+
+              <div className="mt-4 h-4 w-full overflow-hidden rounded-full bg-[#d7e6ef]">
+                <div
+                  className="h-full rounded-full bg-gradient-to-r from-[#1f3f84] via-[#2576a8] to-[#2bb67f]"
+                  style={{ width: `${Math.max(8, Math.min(100, row.blendedScore))}%` }}
+                />
+              </div>
+
+              <div className="mt-3 grid gap-2 text-sm text-[#5d7090] md:grid-cols-3">
+                <p>
+                  Determinista: <span className="font-semibold text-[#17315a]">{row.deterministicScore}%</span>
+                </p>
+                <p>
+                  AI fit: <span className="font-semibold text-[#17315a]">{row.aiFitScore}%</span>
+                </p>
+                <p>
+                  Combinado: <span className="font-semibold text-[#17315a]">{row.blendedScore}%</span>
+                </p>
+              </div>
+
+              <div className="mt-4 grid gap-2 text-base text-[#596f93] md:grid-cols-2 md:text-lg">
+                <p>{row.entity}</p>
+                <p>{row.municipalityName}</p>
+                <p>{row.amountLabel}</p>
+                <p>{row.daysToClose}</p>
+              </div>
+
+              <div className="mt-4 space-y-2 text-sm">
+                <p className="font-semibold text-[#0f8a56]">Por que es compatible:</p>
+                {row.aiReasons.length ? (
+                  row.aiReasons.slice(0, 2).map((reason) => (
+                    <span key={reason} className="mr-2 inline-flex rounded-full border border-[#b9e6cd] bg-[#eaf9f1] px-3 py-1 font-semibold text-[#1c865e]">
+                      {reason}
+                    </span>
+                  ))
+                ) : row.reasons.length ? (
+                  row.reasons.slice(0, 2).map((reason) => (
+                    <span key={reason} className="mr-2 inline-flex rounded-full border border-[#dbe4ef] bg-[#f4f7fb] px-3 py-1 font-semibold text-[#576b8f]">
+                      {reason}
+                    </span>
+                  ))
+                ) : (
+                  <span className="inline-flex rounded-full border border-[#dbe4ef] bg-[#f4f7fb] px-3 py-1 font-semibold text-[#576b8f]">
+                    Completa mas datos de perfil para mejorar recomendaciones.
                   </span>
-                  <span className="rounded-full border border-[#d4dced] px-2 py-1">{getCategoryLabel(record.category)}</span>
-                  <span className="rounded-full border border-[#d4dced] px-2 py-1">{formatAmount(record.amount, record.currency)}</span>
-                  <span className="rounded-full border border-[#d4dced] px-2 py-1">Publicacion: {formatDate(record.publishDate)}</span>
-                  <span className="rounded-full border border-[#d4dced] px-2 py-1">Cierre: {formatDate(record.closingDate)}</span>
-                  <span className="rounded-full border border-[#d4dced] px-2 py-1">Fuente: {getSourceLabel(record.source)}</span>
-                </div>
+                )}
+              </div>
 
-                <Link href={`/licitations/${record.id}`} className="mt-3 inline-flex text-sm font-semibold text-[#1f3f84]">
-                  Ver detalle
-                </Link>
-              </article>
-            ))
-          )}
-        </CardContent>
-      </Card>
+              {row.aiRisks.length ? (
+                <div className="mt-2 space-y-1 text-sm">
+                  <p className="font-semibold text-[#8d6308]">Riesgos detectados por IA:</p>
+                  <div className="flex flex-wrap gap-2">
+                    {row.aiRisks.slice(0, 2).map((risk) => (
+                      <span key={risk} className="inline-flex rounded-full border border-[#f0deb0] bg-[#fff8e9] px-3 py-1 font-semibold text-[#8d6308]">
+                        {risk}
+                      </span>
+                    ))}
+                  </div>
+                </div>
+              ) : null}
+
+              {row.nextStep ? <p className="mt-2 text-sm font-semibold text-[#264574]">Siguiente paso sugerido: {row.nextStep}</p> : null}
+
+              <details className="mt-4 rounded-xl border border-[#dce4ef] bg-[#f9fbff] p-3">
+                <summary className="cursor-pointer text-lg font-semibold text-[#1f3f84] md:text-xl">Ver resumen rapido</summary>
+                <div className="mt-3 space-y-2 text-base text-[#5d7090] md:text-lg">
+                  <p>Procedimiento: {row.procedureLabel}</p>
+                  <p>Categoria: {row.categoryLabel}</p>
+                  <p>Fuente: {row.sourceLabel}</p>
+                  <p>Publicacion: {formatDate(row.publishDate)}</p>
+                  <p>Cierre: {formatDate(row.closingDate)}</p>
+                </div>
+                <div className="mt-3">
+                  <LicitationCardActions
+                    licitationId={row.id}
+                    initialStatus={row.reviewStatus}
+                    normativeAnalysisHref={`/normative-analysis?sourceId=${encodeURIComponent(row.id)}`}
+                  />
+                </div>
+                <div className="mt-3 flex flex-wrap gap-2">
+                  <Link href={`/licitations/${encodeURIComponent(row.id)}`}>
+                    <Button size="sm">Ir al detalle</Button>
+                  </Link>
+                  <Link href={`/normative-analysis?sourceId=${encodeURIComponent(row.id)}`}>
+                    <Button size="sm" variant="secondary">
+                      Analizar en M4
+                    </Button>
+                  </Link>
+                  {row.primaryPdfUrl ? (
+                    <a href={row.primaryPdfUrl} target="_blank" rel="noreferrer">
+                      <Button size="sm" variant="secondary">
+                        Ver PDF principal
+                      </Button>
+                    </a>
+                  ) : null}
+                  <Link href={`/gestion-licitaciones?sourceId=${encodeURIComponent(row.id)}&autocreate=1&autofill=1`}>
+                    <Button size="sm" variant="secondary">
+                      Crear propuesta (M5)
+                    </Button>
+                  </Link>
+                </div>
+              </details>
+            </article>
+          ))
+        )}
+      </section>
+
+      <section className="rounded-2xl border border-[#c9dfd2] bg-[#f0faf4] px-6 py-6">
+        <div className="flex flex-wrap items-center justify-between gap-3">
+          <div>
+            <p className="text-2xl font-semibold text-[#17315a] [font-family:var(--font-display)] md:text-3xl">Te interesa una oportunidad?</p>
+            <p className="text-base text-[#5c7395] md:text-lg">Descarga las bases de licitacion y continua en Analisis Normativo (M4).</p>
+          </div>
+          <Link href="/normative-analysis" className="inline-flex">
+            <Button size="lg" className="rounded-2xl px-7">
+              Ir a Analisis Normativo (M4)
+            </Button>
+          </Link>
+        </div>
+      </section>
     </PageShell>
   );
 }
diff --git a/src/app/normative-analysis/page.tsx b/src/app/normative-analysis/page.tsx
new file mode 100644
index 0000000..c4afb13
--- /dev/null
+++ b/src/app/normative-analysis/page.tsx
@@ -0,0 +1,113 @@
+import Link from "next/link";
+import { hasModuleAccess } from "@/lib/auth/module-access";
+import { requireOnboardedUser } from "@/lib/auth/user";
+import { prisma } from "@/lib/prisma";
+import { NormativeAnalysisView } from "@/components/app/normative-analysis-view";
+import { PageShell } from "@/components/app/page-shell";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+
+type NormativeAnalysisPageProps = {
+  searchParams: Promise<Record<string, string | string[] | undefined>>;
+};
+
+function getParam(params: Record<string, string | string[] | undefined>, key: string) {
+  const value = params[key];
+  return Array.isArray(value) ? value[0] ?? "" : (value ?? "");
+}
+
+export default async function NormativeAnalysisPage({ searchParams }: NormativeAnalysisPageProps) {
+  const user = await requireOnboardedUser();
+  const hasPaidModulesAccess = await hasModuleAccess(user, 4);
+
+  if (!hasPaidModulesAccess) {
+    return (
+      <PageShell
+        title="Modulo 4: Analisis Normativo"
+        description="Este modulo esta protegido por suscripcion de pago."
+        action={<span className="rounded-full border border-[#d5ddec] bg-[#edf2fb] px-4 py-1 text-sm font-semibold text-[#5a6a87]">Bloqueado</span>}
+      >
+        <Card>
+          <CardContent className="space-y-3 py-6">
+            <h2 className="text-2xl font-semibold text-[#1f2a40]">Acceso restringido</h2>
+            <p className="text-sm text-[#64718a]">
+              El Modulo 4 forma parte de la ruta premium. Tu cuenta actual puede completar el Diagnostico (Modulo 1) y revisar los planes en la seccion Modulos.
+            </p>
+            <Link href="/dashboard#modulos">
+              <Button>Ver modulos y planes</Button>
+            </Link>
+          </CardContent>
+        </Card>
+      </PageShell>
+    );
+  }
+
+  const params = await searchParams;
+  const sourceId = getParam(params, "sourceId").trim();
+  const linkedSource = sourceId
+    ? await prisma.licitation.findUnique({
+        where: { id: sourceId },
+        select: {
+          id: true,
+          title: true,
+          supplierAwarded: true,
+        },
+      })
+    : null;
+
+  return (
+    <PageShell
+      title="Modulo 4: Analisis Normativo"
+      headerMode="module"
+      headerBackHref="/dashboard"
+      headerBackLabel="Volver al Dashboard"
+      headerShowManual
+      headerPlanBadgeLabel="Plan Premium"
+      showPageHeading={false}
+      contentWidth="wide"
+      className="space-y-6"
+    >
+      <section className="flex items-start gap-4">
+        <span className="inline-flex h-14 w-14 items-center justify-center rounded-2xl bg-[#dce5f2] text-3xl text-[#274676]">◨</span>
+        <div>
+          <h1 className="text-4xl font-semibold text-[#132549] [font-family:var(--font-display)] md:text-5xl">Modulo 4: Analisis Normativo</h1>
+          <p className="mt-2 text-xl text-[#4f6588] md:text-2xl">Analiza bases de licitacion, reglamentos y leyes con IA</p>
+        </div>
+      </section>
+
+      <NormativeAnalysisView
+        linkedSource={
+          linkedSource
+            ? {
+                id: linkedSource.id,
+                title: linkedSource.title,
+                issuingEntity: linkedSource.supplierAwarded,
+              }
+            : null
+        }
+        autoAnalyzeOnLoad={Boolean(linkedSource)}
+      />
+
+      <section className="rounded-2xl border border-[#d8e0ec] bg-[#f4f7fb] px-6 py-5">
+        <div className="flex flex-wrap items-center justify-between gap-3">
+          <div>
+            <p className="text-3xl font-semibold text-[#17315a] [font-family:var(--font-display)]">Navegacion</p>
+            <p className="text-lg text-[#5c7395]">Regresa al Modulo 3 para ver mas oportunidades o vuelve al dashboard.</p>
+          </div>
+          <div className="flex flex-wrap gap-2">
+            <Link href="/licitations">
+              <Button size="lg" className="rounded-2xl px-6">
+                Volver a Oportunidades
+              </Button>
+            </Link>
+            <Link href="/dashboard">
+              <Button size="lg" variant="secondary" className="rounded-2xl px-6">
+                Ir al Dashboard
+              </Button>
+            </Link>
+          </div>
+        </div>
+      </section>
+    </PageShell>
+  );
+}
diff --git a/src/app/proteccion-legal/page.tsx b/src/app/proteccion-legal/page.tsx
new file mode 100644
index 0000000..b4b9635
--- /dev/null
+++ b/src/app/proteccion-legal/page.tsx
@@ -0,0 +1,103 @@
+import Link from "next/link";
+import { hasModuleAccess } from "@/lib/auth/module-access";
+import { requireOnboardedUser } from "@/lib/auth/user";
+import { listLegalTemplates } from "@/lib/legal/ai-documents";
+import { getLegalKpisForUser, listLegalCasesForUser, listLegalDirectory } from "@/lib/legal/server";
+import { prisma } from "@/lib/prisma";
+import { LegalProtectionView } from "@/components/app/legal-protection-view";
+import { PageShell } from "@/components/app/page-shell";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+
+type PageProps = {
+  searchParams: Promise<Record<string, string | string[] | undefined>>;
+};
+
+function getParam(params: Record<string, string | string[] | undefined>, key: string) {
+  const value = params[key];
+  return Array.isArray(value) ? value[0] ?? "" : (value ?? "");
+}
+
+export default async function ProteccionLegalPage({ searchParams }: PageProps) {
+  const user = await requireOnboardedUser();
+  const hasPaidModulesAccess = await hasModuleAccess(user, 9);
+
+  if (!hasPaidModulesAccess) {
+    return (
+      <PageShell
+        title="Modulo 9: Proteccion Legal"
+        description="Este modulo esta protegido por suscripcion de pago."
+        action={<span className="rounded-full border border-[#d5ddec] bg-[#edf2fb] px-4 py-1 text-sm font-semibold text-[#5a6a87]">Bloqueado</span>}
+      >
+        <Card>
+          <CardContent className="space-y-3 py-6">
+            <h2 className="text-2xl font-semibold text-[#1f2a40]">Acceso restringido</h2>
+            <p className="text-sm text-[#64718a]">Modulo 9 forma parte de la ruta premium de modulos pagados.</p>
+            <div className="flex flex-wrap gap-2">
+              <Link href="/dashboard#modulos">
+                <Button>Ver modulos y planes</Button>
+              </Link>
+              <Link href="/gestion-contratos">
+                <Button variant="secondary">Ir a Modulo 8</Button>
+              </Link>
+            </div>
+          </CardContent>
+        </Card>
+      </PageShell>
+    );
+  }
+
+  const resolvedSearchParams = await searchParams;
+  const contractId = getParam(resolvedSearchParams, "contractId") || null;
+
+  const [cases, kpis, directory, contracts] = await Promise.all([
+    listLegalCasesForUser(user.id),
+    getLegalKpisForUser(user.id),
+    listLegalDirectory({}),
+    prisma.contractRecord.findMany({
+      where: { userId: user.id },
+      orderBy: [{ updatedAt: "desc" }],
+      select: {
+        id: true,
+        title: true,
+        contractNumber: true,
+        counterpartyEntity: true,
+        status: true,
+      },
+      take: 200,
+    }),
+  ]);
+  const templates = listLegalTemplates();
+
+  return (
+    <PageShell
+      title="Modulo 9: Proteccion Legal"
+      headerMode="module"
+      headerBackHref="/gestion-contratos"
+      headerBackLabel="M8: Contratos"
+      headerNextHref="/expediente-preventivo"
+      headerNextLabel="M10: Auditorias"
+      headerPlanBadgeLabel="Plan Premium"
+      showPageHeading={false}
+      contentWidth="wide"
+      className="space-y-6"
+    >
+      <section className="flex items-start gap-4">
+        <span className="inline-flex h-14 w-14 items-center justify-center rounded-2xl bg-[#dce5f2] text-3xl text-[#274676]">◪</span>
+        <div>
+          <h1 className="text-4xl font-semibold text-[#132549] [font-family:var(--font-display)] md:text-5xl">Proteccion Legal</h1>
+          <p className="mt-2 text-xl text-[#4f6588] md:text-2xl">Diagnostico guiado, gestion de casos, escalada y generacion de escritos con trazabilidad</p>
+        </div>
+      </section>
+
+      <LegalProtectionView
+        initialCases={cases}
+        initialKpis={kpis}
+        initialDirectory={directory}
+        initialTemplates={templates}
+        availableContracts={contracts}
+        prefilledContractId={contractId}
+      />
+    </PageShell>
+  );
+}
diff --git a/src/app/strategic-diagnostic/page.tsx b/src/app/strategic-diagnostic/page.tsx
index a793f1c..02e46b2 100644
--- a/src/app/strategic-diagnostic/page.tsx
+++ b/src/app/strategic-diagnostic/page.tsx
@@ -1,5 +1,5 @@
 import Link from "next/link";
-import { isAdminIdentity } from "@/lib/auth/admin";
+import { hasModuleAccess } from "@/lib/auth/module-access";
 import { StrategicDiagnosticWizard } from "@/components/app/strategic-diagnostic-wizard";
 import { PageShell } from "@/components/app/page-shell";
 import { Button } from "@/components/ui/button";
@@ -9,7 +9,7 @@ import { getStrategicDiagnosticSnapshot } from "@/lib/strategic-diagnostic/serve
 
 export default async function StrategicDiagnosticPage() {
   const user = await requireOnboardedUser();
-  const hasPaidModulesAccess = isAdminIdentity(user.email, user.role);
+  const hasPaidModulesAccess = await hasModuleAccess(user, 2);
 
   if (!hasPaidModulesAccess) {
     return (
diff --git a/src/app/talleres-desarrollo/page.tsx b/src/app/talleres-desarrollo/page.tsx
index d65d6b8..224fe0f 100644
--- a/src/app/talleres-desarrollo/page.tsx
+++ b/src/app/talleres-desarrollo/page.tsx
@@ -1,5 +1,5 @@
 import Link from "next/link";
-import { isAdminIdentity } from "@/lib/auth/admin";
+import { hasAnyPaidModuleAccess } from "@/lib/auth/module-access";
 import { requireOnboardedUser } from "@/lib/auth/user";
 import { PageShell } from "@/components/app/page-shell";
 import { Button } from "@/components/ui/button";
@@ -27,7 +27,7 @@ function parseDimension(searchParams: Record<string, string | string[] | undefin
 
 export default async function TalleresDesarrolloPage({ searchParams }: PageProps) {
   const user = await requireOnboardedUser();
-  const hasPaidModulesAccess = isAdminIdentity(user.email, user.role);
+  const hasPaidModulesAccess = await hasAnyPaidModuleAccess(user.id, user.email, user.role);
 
   if (!hasPaidModulesAccess) {
     return (
diff --git a/src/components/app/__tests__/compliance-alerts-view.test.tsx b/src/components/app/__tests__/compliance-alerts-view.test.tsx
new file mode 100644
index 0000000..f970558
--- /dev/null
+++ b/src/components/app/__tests__/compliance-alerts-view.test.tsx
@@ -0,0 +1,114 @@
+import { describe, expect, it } from "vitest";
+import { renderToStaticMarkup } from "react-dom/server";
+import type { M7Dataset } from "@/lib/compliance/types";
+import { ComplianceAlertsView } from "@/components/app/compliance-alerts-view";
+
+function buildDataset(overrides?: Partial<M7Dataset>): M7Dataset {
+  return {
+    generatedAt: "2026-04-02T10:00:00.000Z",
+    kpis: {
+      activeLicitations: 2,
+      completionRate: 64,
+      criticalPending: 1,
+      upcoming7Days: 3,
+    },
+    m3States: {
+      consulted: 1,
+      interested: 2,
+      active: 1,
+      new: 5,
+    },
+    tabs: {
+      plazos: [
+        {
+          id: "plazo-1",
+          proposalId: "p-1",
+          licitationId: "l-1",
+          title: "Cierre de convocatoria",
+          description: "Fecha limite",
+          dueAt: "2026-04-03T12:00:00.000Z",
+          source: "milestone",
+          status: "upcoming",
+        },
+      ],
+      alertas: [
+        {
+          id: "alerta-1",
+          proposalId: "p-1",
+          licitationId: "l-1",
+          title: "Vence pronto",
+          description: "Requisito critico",
+          severity: "high",
+          kind: "deadline_soon",
+          dueAt: "2026-04-03T12:00:00.000Z",
+          createdAt: "2026-04-02T10:00:00.000Z",
+        },
+      ],
+      checklist: [
+        {
+          proposalId: "p-1",
+          proposalTitle: "Propuesta 1",
+          mandatoryResolved: 4,
+          mandatoryTotal: 6,
+          completionRate: 67,
+          signaturePolicyStatus: "condicionado",
+        },
+      ],
+      panelKpi: [
+        {
+          id: "panel-1",
+          label: "Licitaciones activas",
+          value: "2",
+          tone: "success",
+        },
+      ],
+    },
+    ...(overrides ?? {}),
+  };
+}
+
+describe("ComplianceAlertsView UI contract", () => {
+  it("renders the four KPI cards and tab labels", () => {
+    const html = renderToStaticMarkup(<ComplianceAlertsView dataset={buildDataset()} />);
+
+    expect(html).toContain("Licitaciones activas");
+    expect(html).toContain("Tasa de completitud");
+    expect(html).toContain("Pendientes criticos");
+    expect(html).toContain("Proximos 7 dias");
+    expect(html).toContain("Plazos");
+    expect(html).toContain("Alertas");
+    expect(html).toContain("Checklist");
+    expect(html).toContain("Panel KPI");
+  });
+
+  it("renders empty state when there is no active compliance data", () => {
+    const html = renderToStaticMarkup(
+      <ComplianceAlertsView
+        dataset={buildDataset({
+          kpis: {
+            activeLicitations: 0,
+            completionRate: 0,
+            criticalPending: 0,
+            upcoming7Days: 0,
+          },
+          tabs: {
+            plazos: [],
+            alertas: [],
+            checklist: [],
+            panelKpi: [],
+          },
+        })}
+      />,
+    );
+
+    expect(html).toContain("Sin alertas de cumplimiento");
+  });
+
+  it("keeps responsive layout classes for desktop and mobile grids", () => {
+    const html = renderToStaticMarkup(<ComplianceAlertsView dataset={buildDataset()} />);
+
+    expect(html).toContain("md:grid-cols-2");
+    expect(html).toContain("xl:grid-cols-4");
+    expect(html).toContain("md:grid-cols-4");
+  });
+});
diff --git a/src/components/app/compliance-alerts-view.tsx b/src/components/app/compliance-alerts-view.tsx
new file mode 100644
index 0000000..aaf3e9e
--- /dev/null
+++ b/src/components/app/compliance-alerts-view.tsx
@@ -0,0 +1,388 @@
+"use client";
+
+import { useState } from "react";
+import { Tabs } from "@/components/ui/tabs";
+import { Card, CardContent } from "@/components/ui/card";
+import { Button } from "@/components/ui/button";
+import type { M7Dataset } from "@/lib/compliance/types";
+
+type ComplianceAlertsViewProps = {
+  dataset: M7Dataset;
+};
+
+type M7AiPlaybook = {
+  predictedIncidents: {
+    title: string;
+    likelihood: "alta" | "media" | "baja";
+    impact: "alto" | "medio" | "bajo";
+    timeHorizon: string;
+  }[];
+  priorityOrder: string[];
+  preventiveActions: {
+    action: string;
+    ownerSuggestion: string;
+    targetDate: string;
+  }[];
+  escalationAdvice: string[];
+  confidence: "low" | "medium" | "high";
+};
+
+function toneClass(tone: "neutral" | "success" | "warning" | "danger") {
+  if (tone === "success") {
+    return "border-[#b9e6cd] bg-[#eaf9f1] text-[#1f8b63]";
+  }
+
+  if (tone === "warning") {
+    return "border-[#f0deb0] bg-[#fff8e9] text-[#8d6308]";
+  }
+
+  if (tone === "danger") {
+    return "border-[#f1c7ce] bg-[#fff1f4] text-[#b03f4f]";
+  }
+
+  return "border-[#d8e1ef] bg-[#f4f7fb] text-[#51688f]";
+}
+
+function severityClass(severity: "high" | "medium" | "low") {
+  if (severity === "high") {
+    return "border-[#f1c7ce] bg-[#fff1f4] text-[#b03f4f]";
+  }
+
+  if (severity === "medium") {
+    return "border-[#f0deb0] bg-[#fff8e9] text-[#8d6308]";
+  }
+
+  return "border-[#b9e6cd] bg-[#eaf9f1] text-[#1f8b63]";
+}
+
+function formatDateTime(value: string) {
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return "Sin fecha";
+  }
+
+  return parsed.toLocaleString("es-MX", {
+    year: "numeric",
+    month: "short",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+}
+
+export function ComplianceAlertsView({ dataset }: ComplianceAlertsViewProps) {
+  const [isLoadingAiPlaybook, setIsLoadingAiPlaybook] = useState(false);
+  const [aiPlaybook, setAiPlaybook] = useState<M7AiPlaybook | null>(null);
+  const [aiSuggestionId, setAiSuggestionId] = useState<string | null>(null);
+  const [aiFeedback, setAiFeedback] = useState<string | null>(null);
+  const [aiError, setAiError] = useState<string | null>(null);
+
+  async function setSuggestionDecision(decision: "accept" | "dismiss") {
+    if (!aiSuggestionId) {
+      return;
+    }
+
+    await fetch(`/api/ai/suggestions/${encodeURIComponent(aiSuggestionId)}/decision`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({ decision }),
+    });
+  }
+
+  async function generateAiPlaybook() {
+    setIsLoadingAiPlaybook(true);
+    setAiError(null);
+    setAiFeedback(null);
+
+    try {
+      const response = await fetch("/api/compliance/m7/ai/playbook", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ dataset }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as {
+        ok?: boolean;
+        error?: string;
+        predictedIncidents?: M7AiPlaybook["predictedIncidents"];
+        priorityOrder?: M7AiPlaybook["priorityOrder"];
+        preventiveActions?: M7AiPlaybook["preventiveActions"];
+        escalationAdvice?: M7AiPlaybook["escalationAdvice"];
+        confidence?: M7AiPlaybook["confidence"];
+        suggestionId?: string;
+      };
+
+      if (!response.ok || !payload.ok) {
+        setAiError(payload.error ?? "No fue posible generar plan IA.");
+        return;
+      }
+
+      setAiPlaybook({
+        predictedIncidents: payload.predictedIncidents ?? [],
+        priorityOrder: payload.priorityOrder ?? [],
+        preventiveActions: payload.preventiveActions ?? [],
+        escalationAdvice: payload.escalationAdvice ?? [],
+        confidence: payload.confidence ?? "low",
+      });
+      setAiSuggestionId(payload.suggestionId ?? null);
+      setAiFeedback("Plan IA generado.");
+    } catch {
+      setAiError("No fue posible generar plan IA.");
+    } finally {
+      setIsLoadingAiPlaybook(false);
+    }
+  }
+
+  const isEmpty =
+    dataset.kpis.activeLicitations === 0 &&
+    dataset.tabs.plazos.length === 0 &&
+    dataset.tabs.alertas.length === 0 &&
+    dataset.tabs.checklist.length === 0;
+
+  return (
+    <div className="space-y-4">
+      <section className="grid gap-3 md:grid-cols-2 xl:grid-cols-4">
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Licitaciones activas</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{dataset.kpis.activeLicitations}</p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Tasa de completitud</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{dataset.kpis.completionRate}%</p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Pendientes criticos</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{dataset.kpis.criticalPending}</p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Proximos 7 dias</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{dataset.kpis.upcoming7Days}</p>
+          </CardContent>
+        </Card>
+      </section>
+
+      <section className="grid gap-3 md:grid-cols-4">
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Consultadas</p>
+            <p className="mt-2 text-3xl font-semibold text-[#15294d]">{dataset.m3States.consulted}</p>
+          </CardContent>
+        </Card>
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Me interesa</p>
+            <p className="mt-2 text-3xl font-semibold text-[#15294d]">{dataset.m3States.interested}</p>
+          </CardContent>
+        </Card>
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Activas M5</p>
+            <p className="mt-2 text-3xl font-semibold text-[#15294d]">{dataset.m3States.active}</p>
+          </CardContent>
+        </Card>
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Nuevas M3</p>
+            <p className="mt-2 text-3xl font-semibold text-[#15294d]">{dataset.m3States.new}</p>
+          </CardContent>
+        </Card>
+      </section>
+
+      {isEmpty ? (
+        <Card className="border-dashed border-[#cfd8e6] bg-[#fbfdff]">
+          <CardContent className="py-16 text-center">
+            <p className="text-3xl font-semibold text-[#162748] [font-family:var(--font-display)]">Sin alertas de cumplimiento</p>
+            <p className="mt-2 text-base text-[#5f7090]">Cuando tengas procesos activos en M5 y fechas detectadas, este tablero mostrara riesgos y vencimientos.</p>
+          </CardContent>
+        </Card>
+      ) : null}
+
+      {aiError ? <p className="rounded-lg border border-[#f1c7ce] bg-[#fff1f4] px-3 py-2 text-sm text-[#b03f4f]">{aiError}</p> : null}
+      {aiFeedback ? <p className="rounded-lg border border-[#b9e6cd] bg-[#eaf9f1] px-3 py-2 text-sm text-[#1f8b63]">{aiFeedback}</p> : null}
+
+      <Tabs
+        defaultTab="plazos"
+        items={[
+          {
+            id: "plazos",
+            label: "Plazos",
+            content: (
+              <div className="space-y-2">
+                {dataset.tabs.plazos.length === 0 ? <p className="text-sm text-[#60718f]">Sin plazos detectables para los proximos dias.</p> : null}
+                {dataset.tabs.plazos.map((item) => (
+                  <article key={item.id} className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                    <div className="flex flex-wrap items-center justify-between gap-2">
+                      <p className="text-sm font-semibold text-[#1d335a]">{item.title}</p>
+                      <span className={`inline-flex rounded-full border px-2 py-0.5 text-xs font-semibold ${item.status === "overdue" ? "border-[#f1c7ce] bg-[#fff1f4] text-[#b03f4f]" : "border-[#d8e1ef] bg-[#f4f7fb] text-[#51688f]"}`}>
+                        {item.status === "overdue" ? "Vencido" : "Programado"}
+                      </span>
+                    </div>
+                    <p className="mt-1 text-xs text-[#60718f]">{item.description}</p>
+                    <p className="mt-1 text-xs font-semibold text-[#334d77]">{formatDateTime(item.dueAt)}</p>
+                  </article>
+                ))}
+              </div>
+            ),
+          },
+          {
+            id: "alertas",
+            label: "Alertas",
+            content: (
+              <div className="space-y-2">
+                {dataset.tabs.alertas.length === 0 ? <p className="text-sm text-[#60718f]">Sin alertas activas.</p> : null}
+                {dataset.tabs.alertas.map((item) => (
+                  <article key={item.id} className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                    <div className="flex flex-wrap items-center justify-between gap-2">
+                      <p className="text-sm font-semibold text-[#1d335a]">{item.title}</p>
+                      <span className={`inline-flex rounded-full border px-2 py-0.5 text-xs font-semibold ${severityClass(item.severity)}`}>{item.severity}</span>
+                    </div>
+                    <p className="mt-1 text-xs text-[#60718f]">{item.description}</p>
+                    {item.dueAt ? <p className="mt-1 text-xs font-semibold text-[#334d77]">{formatDateTime(item.dueAt)}</p> : null}
+                  </article>
+                ))}
+              </div>
+            ),
+          },
+          {
+            id: "checklist",
+            label: "Checklist",
+            content: (
+              <div className="space-y-2">
+                {dataset.tabs.checklist.length === 0 ? <p className="text-sm text-[#60718f]">No hay procesos activos para checklist.</p> : null}
+                {dataset.tabs.checklist.map((item) => (
+                  <article key={item.proposalId} className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                    <p className="text-sm font-semibold text-[#1d335a]">{item.proposalTitle}</p>
+                    <p className="mt-1 text-xs text-[#60718f]">
+                      Obligatorios resueltos: {item.mandatoryResolved}/{item.mandatoryTotal} ({item.completionRate}%)
+                    </p>
+                    <p className="mt-1 text-xs text-[#60718f]">Firma: {item.signaturePolicyStatus.replaceAll("_", " ")}</p>
+                  </article>
+                ))}
+              </div>
+            ),
+          },
+          {
+            id: "panel-kpi",
+            label: "Panel KPI",
+            content: (
+              <div className="grid gap-2 md:grid-cols-2">
+                {dataset.tabs.panelKpi.map((item) => (
+                  <article key={item.id} className={`rounded-xl border p-3 ${toneClass(item.tone)}`}>
+                    <p className="text-xs font-semibold uppercase tracking-[0.08em]">{item.label}</p>
+                    <p className="mt-1 text-2xl font-semibold">{item.value}</p>
+                  </article>
+                ))}
+              </div>
+            ),
+          },
+          {
+            id: "plan-ia",
+            label: "Plan IA",
+            content: (
+              <div className="space-y-3">
+                <div className="flex flex-wrap gap-2">
+                  <Button type="button" variant="secondary" disabled={isLoadingAiPlaybook} onClick={() => void generateAiPlaybook()}>
+                    {isLoadingAiPlaybook ? "Generando plan IA..." : "Generar plan IA"}
+                  </Button>
+                  {aiPlaybook ? (
+                    <Button
+                      type="button"
+                      variant="secondary"
+                      onClick={() => {
+                        void setSuggestionDecision("dismiss");
+                        setAiPlaybook(null);
+                        setAiFeedback("Plan IA descartado.");
+                      }}
+                    >
+                      Descartar plan IA
+                    </Button>
+                  ) : null}
+                </div>
+
+                {!aiPlaybook ? <p className="text-sm text-[#60718f]">Sin plan IA generado todavia.</p> : null}
+
+                {aiPlaybook ? (
+                  <>
+                    <article className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                      <p className="text-sm font-semibold text-[#1d335a]">Incidentes predichos</p>
+                      <ul className="mt-2 space-y-2 text-xs text-[#60718f]">
+                        {aiPlaybook.predictedIncidents.map((incident) => (
+                          <li key={`${incident.title}-${incident.timeHorizon}`} className="rounded-lg border border-[#e4ebf6] px-2 py-1">
+                            <p className="font-semibold text-[#233b62]">{incident.title}</p>
+                            <p>
+                              Probabilidad {incident.likelihood} · Impacto {incident.impact} · Horizonte {incident.timeHorizon}
+                            </p>
+                          </li>
+                        ))}
+                      </ul>
+                    </article>
+
+                    <article className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                      <p className="text-sm font-semibold text-[#1d335a]">Orden de prioridad</p>
+                      <ol className="mt-2 space-y-1 text-xs text-[#60718f]">
+                        {aiPlaybook.priorityOrder.map((item, index) => (
+                          <li key={`${item}-${index}`}>
+                            {index + 1}. {item}
+                          </li>
+                        ))}
+                      </ol>
+                    </article>
+
+                    <article className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                      <p className="text-sm font-semibold text-[#1d335a]">Acciones preventivas</p>
+                      <ul className="mt-2 space-y-2 text-xs text-[#60718f]">
+                        {aiPlaybook.preventiveActions.map((action) => (
+                          <li key={`${action.action}-${action.ownerSuggestion}`} className="rounded-lg border border-[#e4ebf6] px-2 py-1">
+                            <p className="font-semibold text-[#233b62]">{action.action}</p>
+                            <p>
+                              Responsable sugerido: {action.ownerSuggestion} · Fecha objetivo: {action.targetDate}
+                            </p>
+                          </li>
+                        ))}
+                      </ul>
+                    </article>
+
+                    <article className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                      <p className="text-sm font-semibold text-[#1d335a]">Recomendaciones de escalamiento</p>
+                      <ul className="mt-2 space-y-1 text-xs text-[#60718f]">
+                        {aiPlaybook.escalationAdvice.map((item) => (
+                          <li key={item}>- {item}</li>
+                        ))}
+                      </ul>
+                      <div className="mt-3">
+                        <Button
+                          type="button"
+                          size="sm"
+                          onClick={() => {
+                            void setSuggestionDecision("accept");
+                            setAiFeedback("Plan IA marcado como aceptado.");
+                          }}
+                        >
+                          Aceptar plan IA
+                        </Button>
+                      </div>
+                    </article>
+                  </>
+                ) : null}
+              </div>
+            ),
+          },
+        ]}
+      />
+    </div>
+  );
+}
diff --git a/src/components/app/contracts-management-view.tsx b/src/components/app/contracts-management-view.tsx
new file mode 100644
index 0000000..6f71395
--- /dev/null
+++ b/src/components/app/contracts-management-view.tsx
@@ -0,0 +1,1046 @@
+"use client";
+
+import Link from "next/link";
+import { useMemo, useState } from "react";
+import type {
+  ContractCreateInput,
+  ContractDeliverableView,
+  ContractKpiSnapshot,
+  ContractPaymentView,
+  ContractRecordView,
+} from "@/lib/contracts/types";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+import { Dialog } from "@/components/ui/dialog";
+import { Tabs } from "@/components/ui/tabs";
+
+type ContractsManagementViewProps = {
+  initialContracts: ContractRecordView[];
+  initialKpis: ContractKpiSnapshot;
+  proposalPdfOptions: Array<{
+    proposalId: string;
+    proposalTitle: string;
+    documentId: string;
+    fileName: string;
+    createdAt: string;
+  }>;
+};
+
+type ApiPayload = {
+  ok?: boolean;
+  error?: string;
+  contracts?: ContractRecordView[];
+  contract?: ContractRecordView | null;
+  document?: {
+    id: string;
+    contractId: string;
+    fileName: string;
+    filePath: string;
+    mimeType: string;
+    sizeBytes: number;
+    checksumSha256: string | null;
+    kind: ContractRecordView["documents"][number]["kind"];
+    createdAt: string;
+  };
+  kpis?: ContractKpiSnapshot;
+  extraction?: {
+    warnings?: Array<{ code: string; message: string }>;
+    fields?: {
+      title?: string | null;
+      counterpartyEntity?: string | null;
+      contractNumber?: string | null;
+      contractType?: string | null;
+      totalAmount?: number | null;
+    };
+  };
+};
+
+function formatDate(value: string | null) {
+  if (!value) {
+    return "Sin fecha";
+  }
+
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return "Sin fecha";
+  }
+
+  return parsed.toLocaleDateString("es-MX", {
+    year: "numeric",
+    month: "short",
+    day: "2-digit",
+  });
+}
+
+function formatCurrency(amount: number, currency = "MXN") {
+  return new Intl.NumberFormat("es-MX", {
+    style: "currency",
+    currency,
+    maximumFractionDigits: 2,
+  }).format(amount);
+}
+
+function formatDateTime(value: string) {
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return "Sin fecha";
+  }
+
+  return parsed.toLocaleString("es-MX", {
+    year: "numeric",
+    month: "short",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+}
+
+function formatFileSize(bytes: number) {
+  if (!Number.isFinite(bytes) || bytes <= 0) {
+    return "N/D";
+  }
+
+  if (bytes < 1024) {
+    return `${bytes} B`;
+  }
+
+  if (bytes < 1024 * 1024) {
+    return `${(bytes / 1024).toFixed(1)} KB`;
+  }
+
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+function contractDocumentKindLabel(kind: ContractRecordView["documents"][number]["kind"]) {
+  if (kind === "SIGNED_CONTRACT") {
+    return "Contrato firmado";
+  }
+
+  if (kind === "ADDENDUM") {
+    return "Convenio / adenda";
+  }
+
+  if (kind === "DELIVERABLE_EVIDENCE") {
+    return "Evidencia de entregable";
+  }
+
+  if (kind === "PAYMENT_EVIDENCE") {
+    return "Evidencia de pago";
+  }
+
+  return "Otro";
+}
+
+function statusTone(status: ContractRecordView["status"]) {
+  if (status === "ACTIVE") {
+    return "border-[#bce5d1] bg-[#ebf9f1] text-[#1e8b63]";
+  }
+
+  if (status === "COMPLETED") {
+    return "border-[#c7d8f5] bg-[#ecf3ff] text-[#2c59a8]";
+  }
+
+  if (status === "PAUSED") {
+    return "border-[#f0dfb8] bg-[#fff9ea] text-[#946807]";
+  }
+
+  return "border-[#e6c9cf] bg-[#fff2f4] text-[#b04a58]";
+}
+
+export function ContractsManagementView({ initialContracts, initialKpis, proposalPdfOptions }: ContractsManagementViewProps) {
+  const [contracts, setContracts] = useState<ContractRecordView[]>(initialContracts);
+  const [kpis, setKpis] = useState<ContractKpiSnapshot>(initialKpis);
+  const [isBusy, setIsBusy] = useState(false);
+  const [message, setMessage] = useState<string | null>(null);
+  const [errorMessage, setErrorMessage] = useState<string | null>(null);
+  const [extractionSummary, setExtractionSummary] = useState<string | null>(null);
+
+  const [uploadContractId, setUploadContractId] = useState("");
+  const [uploadFile, setUploadFile] = useState<File | null>(null);
+  const [proposalSourceId, setProposalSourceId] = useState(proposalPdfOptions[0]?.proposalId ?? "");
+  const [evidenceContractId, setEvidenceContractId] = useState("");
+  const [evidenceKind, setEvidenceKind] = useState<ContractRecordView["documents"][number]["kind"]>("SIGNED_CONTRACT");
+  const [evidenceFile, setEvidenceFile] = useState<File | null>(null);
+
+  const [newContract, setNewContract] = useState<ContractCreateInput>({
+    sourceProposalId: null,
+    title: "",
+    counterpartyEntity: "",
+    contractNumber: null,
+    contractType: "General",
+    startDate: null,
+    endDate: null,
+    totalAmount: null,
+    currency: "MXN",
+    status: "ACTIVE",
+    description: "",
+  });
+
+  const [newDeliverable, setNewDeliverable] = useState({
+    contractId: "",
+    title: "",
+    dueDate: "",
+    amountLinked: "",
+    notes: "",
+  });
+
+  const [newPayment, setNewPayment] = useState({
+    contractId: "",
+    amount: "",
+    paymentDate: "",
+    invoiceNumber: "",
+    concept: "",
+    status: "REGISTERED",
+  });
+
+  const deliverables = useMemo(() => {
+    const rows: Array<ContractDeliverableView & { contractTitle: string; contractId: string }> = [];
+
+    for (const contract of contracts) {
+      for (const item of contract.deliverables) {
+        rows.push({
+          ...item,
+          contractTitle: contract.title,
+          contractId: contract.id,
+        });
+      }
+    }
+
+    return rows.sort((a, b) => {
+      const left = a.dueDate ? new Date(a.dueDate).getTime() : Number.POSITIVE_INFINITY;
+      const right = b.dueDate ? new Date(b.dueDate).getTime() : Number.POSITIVE_INFINITY;
+      return left - right;
+    });
+  }, [contracts]);
+
+  const payments = useMemo(() => {
+    const rows: Array<ContractPaymentView & { contractTitle: string; currency: string }> = [];
+
+    for (const contract of contracts) {
+      for (const item of contract.payments) {
+        rows.push({
+          ...item,
+          contractTitle: contract.title,
+          currency: contract.currency,
+        });
+      }
+    }
+
+    return rows.sort((a, b) => new Date(b.paymentDate).getTime() - new Date(a.paymentDate).getTime());
+  }, [contracts]);
+
+  const selectedProposalPdfOption = useMemo(
+    () => proposalPdfOptions.find((item) => item.proposalId === proposalSourceId) ?? null,
+    [proposalPdfOptions, proposalSourceId],
+  );
+
+  const hasContractsWithoutProposalTrace = useMemo(
+    () => contracts.some((item) => !item.sourceProposalId),
+    [contracts],
+  );
+
+  async function reloadData() {
+    const [contractsResponse, kpisResponse] = await Promise.all([fetch("/api/contracts"), fetch("/api/contracts/kpis")]);
+
+    const contractsPayload = (await contractsResponse.json().catch(() => ({}))) as ApiPayload;
+    const kpisPayload = (await kpisResponse.json().catch(() => ({}))) as ApiPayload;
+
+    if (contractsResponse.ok && contractsPayload.ok && contractsPayload.contracts) {
+      setContracts(contractsPayload.contracts);
+    }
+
+    if (kpisResponse.ok && kpisPayload.ok && kpisPayload.kpis) {
+      setKpis(kpisPayload.kpis);
+    }
+  }
+
+  async function createContract() {
+    setErrorMessage(null);
+    setMessage(null);
+    setIsBusy(true);
+
+    try {
+      const response = await fetch("/api/contracts", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          ...newContract,
+          totalAmount: newContract.totalAmount === null ? null : Number(newContract.totalAmount),
+        }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok) {
+        setErrorMessage(payload.error ?? "No fue posible crear el contrato.");
+        return;
+      }
+
+      setMessage("Contrato creado correctamente.");
+      setNewContract({
+        sourceProposalId: null,
+        title: "",
+        counterpartyEntity: "",
+        contractNumber: null,
+        contractType: "General",
+        startDate: null,
+        endDate: null,
+        totalAmount: null,
+        currency: "MXN",
+        status: "ACTIVE",
+        description: "",
+      });
+      await reloadData();
+    } catch {
+      setErrorMessage("No fue posible crear el contrato.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function updateContractStatus(contractId: string, status: ContractRecordView["status"]) {
+    setErrorMessage(null);
+    setMessage(null);
+
+    const response = await fetch(`/api/contracts/${encodeURIComponent(contractId)}`, {
+      method: "PATCH",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({ status }),
+    });
+
+    const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+    if (!response.ok || !payload.ok) {
+      setErrorMessage(payload.error ?? "No fue posible actualizar el estado.");
+      return;
+    }
+
+    setMessage("Estado de contrato actualizado.");
+    await reloadData();
+  }
+
+  async function performExtraction(formData: FormData, successMessage: string) {
+    setErrorMessage(null);
+    setMessage(null);
+    setExtractionSummary(null);
+    setIsBusy(true);
+
+    try {
+      const response = await fetch("/api/contracts/extract", {
+        method: "POST",
+        body: formData,
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok) {
+        setErrorMessage(payload.error ?? "No fue posible analizar el contrato.");
+        return false;
+      }
+
+      const extraction = payload.extraction;
+      const fields = extraction?.fields;
+      const warningText = extraction?.warnings?.map((item) => item.message).join(" | ") ?? "";
+      setExtractionSummary(
+        [
+          fields?.title ? `Titulo: ${fields.title}` : "",
+          fields?.counterpartyEntity ? `Entidad: ${fields.counterpartyEntity}` : "",
+          fields?.contractNumber ? `Numero: ${fields.contractNumber}` : "",
+          fields?.contractType ? `Tipo: ${fields.contractType}` : "",
+          fields?.totalAmount ? `Monto: ${fields.totalAmount}` : "",
+          warningText ? `Notas: ${warningText}` : "",
+        ]
+          .filter(Boolean)
+          .join(" • "),
+      );
+
+      setMessage(successMessage);
+      await reloadData();
+      return true;
+    } catch {
+      setErrorMessage("No fue posible analizar el contrato.");
+      return false;
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function submitExtraction() {
+    const currentFile = uploadFile;
+    if (!currentFile) {
+      setErrorMessage("Selecciona un PDF para extraer.");
+      return;
+    }
+
+    const formData = new FormData();
+    formData.append("file", currentFile);
+
+    if (uploadContractId) {
+      formData.append("contractId", uploadContractId);
+    }
+
+    const ok = await performExtraction(formData, "Contrato analizado y guardado.");
+    if (ok) {
+      setUploadFile(null);
+      setUploadContractId("");
+    }
+  }
+
+  async function submitExtractionFromProposal() {
+    if (!proposalSourceId) {
+      setErrorMessage("Selecciona una propuesta con PDF para continuar.");
+      return;
+    }
+
+    const formData = new FormData();
+    formData.append("sourceProposalId", proposalSourceId);
+
+    if (uploadContractId) {
+      formData.append("contractId", uploadContractId);
+    }
+
+    const ok = await performExtraction(formData, "Contrato analizado usando PDF de propuesta (M5).");
+    if (ok) {
+      setUploadFile(null);
+    }
+  }
+
+  async function uploadContractEvidence() {
+    if (!evidenceContractId) {
+      setErrorMessage("Selecciona un contrato para adjuntar evidencia.");
+      return;
+    }
+
+    if (!evidenceFile) {
+      setErrorMessage("Selecciona un archivo PDF para adjuntar evidencia.");
+      return;
+    }
+
+    setIsBusy(true);
+    setErrorMessage(null);
+    setMessage(null);
+
+    try {
+      const formData = new FormData();
+      formData.append("contractId", evidenceContractId);
+      formData.append("kind", evidenceKind);
+      formData.append("file", evidenceFile);
+
+      const response = await fetch("/api/contracts/upload", {
+        method: "POST",
+        body: formData,
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+      if (!response.ok || !payload.ok || !payload.document) {
+        setErrorMessage(payload.error ?? "No fue posible adjuntar el documento al contrato.");
+        return;
+      }
+
+      setMessage("Documento adjuntado al contrato.");
+      setEvidenceFile(null);
+      await reloadData();
+    } catch {
+      setErrorMessage("No fue posible adjuntar el documento al contrato.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function deleteContractDocument(contractId: string, documentId: string) {
+    if (!window.confirm("Se eliminara este documento del contrato. Deseas continuar?")) {
+      return;
+    }
+
+    setErrorMessage(null);
+    setMessage(null);
+    setIsBusy(true);
+
+    try {
+      const response = await fetch(`/api/contracts/${encodeURIComponent(contractId)}/documents/${encodeURIComponent(documentId)}`, {
+        method: "DELETE",
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+      if (!response.ok || !payload.ok) {
+        setErrorMessage(payload.error ?? "No fue posible eliminar el documento.");
+        return;
+      }
+
+      setMessage("Documento eliminado.");
+      await reloadData();
+    } catch {
+      setErrorMessage("No fue posible eliminar el documento.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function createDeliverable() {
+    if (!newDeliverable.contractId) {
+      setErrorMessage("Selecciona un contrato para el entregable.");
+      return;
+    }
+
+    setErrorMessage(null);
+    setMessage(null);
+    setIsBusy(true);
+
+    try {
+      const response = await fetch(`/api/contracts/${encodeURIComponent(newDeliverable.contractId)}/deliverables`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          title: newDeliverable.title,
+          dueDate: newDeliverable.dueDate ? new Date(newDeliverable.dueDate).toISOString() : null,
+          amountLinked: newDeliverable.amountLinked ? Number(newDeliverable.amountLinked) : null,
+          notes: newDeliverable.notes,
+        }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok) {
+        setErrorMessage(payload.error ?? "No fue posible crear el entregable.");
+        return;
+      }
+
+      setMessage("Entregable registrado.");
+      setNewDeliverable({
+        contractId: "",
+        title: "",
+        dueDate: "",
+        amountLinked: "",
+        notes: "",
+      });
+      await reloadData();
+    } catch {
+      setErrorMessage("No fue posible crear el entregable.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function updateDeliverableStatus(deliverableId: string, status: ContractDeliverableView["status"]) {
+    setErrorMessage(null);
+
+    const response = await fetch(`/api/deliverables/${encodeURIComponent(deliverableId)}`, {
+      method: "PATCH",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({ status }),
+    });
+
+    const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+    if (!response.ok || !payload.ok) {
+      setErrorMessage(payload.error ?? "No fue posible actualizar el entregable.");
+      return;
+    }
+
+    setMessage("Entregable actualizado.");
+    await reloadData();
+  }
+
+  async function createPayment() {
+    if (!newPayment.contractId) {
+      setErrorMessage("Selecciona un contrato para el pago.");
+      return;
+    }
+
+    setErrorMessage(null);
+    setMessage(null);
+    setIsBusy(true);
+
+    try {
+      const response = await fetch(`/api/contracts/${encodeURIComponent(newPayment.contractId)}/payments`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          amount: Number(newPayment.amount),
+          paymentDate: new Date(newPayment.paymentDate).toISOString(),
+          invoiceNumber: newPayment.invoiceNumber || null,
+          concept: newPayment.concept,
+          status: newPayment.status,
+        }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok) {
+        setErrorMessage(payload.error ?? "No fue posible registrar el pago.");
+        return;
+      }
+
+      setMessage("Pago registrado.");
+      setNewPayment({
+        contractId: "",
+        amount: "",
+        paymentDate: "",
+        invoiceNumber: "",
+        concept: "",
+        status: "REGISTERED",
+      });
+      await reloadData();
+    } catch {
+      setErrorMessage("No fue posible registrar el pago.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  return (
+    <div className="space-y-4">
+      <section className="grid gap-3 md:grid-cols-2 xl:grid-cols-4">
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Contratos activos</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{kpis.activeContracts}</p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Total cobrado</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{formatCurrency(kpis.totalCollected)}</p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Entregables pendientes</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{kpis.pendingDeliverables}</p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Entregables vencidos</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{kpis.overdueDeliverables}</p>
+          </CardContent>
+        </Card>
+      </section>
+
+      {errorMessage ? <p className="rounded-xl border border-[#efc4c4] bg-[#fff1f1] px-3 py-2 text-sm text-[#ad3f3f]">{errorMessage}</p> : null}
+      {message ? <p className="rounded-xl border border-[#bde5ce] bg-[#ecf9f1] px-3 py-2 text-sm text-[#1f7f4f]">{message}</p> : null}
+      {extractionSummary ? <p className="rounded-xl border border-[#ced9ec] bg-[#f3f7ff] px-3 py-2 text-sm text-[#2b4a7b]">{extractionSummary}</p> : null}
+      {proposalPdfOptions.length === 0 ? (
+        <p className="rounded-xl border border-[#f0deb0] bg-[#fff8e9] px-3 py-2 text-sm text-[#8d6308]">
+          Advertencia de continuidad: no hay propuestas M5 con PDF para reutilizar en M8.
+        </p>
+      ) : null}
+      {hasContractsWithoutProposalTrace ? (
+        <p className="rounded-xl border border-[#f0deb0] bg-[#fff8e9] px-3 py-2 text-sm text-[#8d6308]">
+          Advertencia de continuidad: hay contratos sin `sourceProposalId`, la trazabilidad M5-&gt;M8 puede estar incompleta.
+        </p>
+      ) : null}
+
+      <Tabs
+        defaultTab="upload"
+        items={[
+          {
+            id: "upload",
+            label: "Subir Contrato",
+            content: (
+              <Card>
+                <CardContent className="space-y-4 py-5">
+                  <p className="text-sm text-[#5c6d8a]">Sube contrato PDF para extraer campos, entregables, pagos y clausulas de riesgo.</p>
+
+                  <label className="space-y-1 text-sm font-semibold text-[#314764]">
+                    Contrato existente (opcional)
+                    <select
+                      value={uploadContractId}
+                      onChange={(event) => setUploadContractId(event.target.value)}
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] bg-white px-3"
+                    >
+                      <option value="">Crear nuevo contrato desde extraccion</option>
+                      {contracts.map((item) => (
+                        <option key={item.id} value={item.id}>
+                          {item.title}
+                        </option>
+                      ))}
+                    </select>
+                  </label>
+
+                  <label className="space-y-1 text-sm font-semibold text-[#314764]">
+                    Archivo PDF
+                    <input
+                      type="file"
+                      accept="application/pdf"
+                      onChange={(event) => setUploadFile(event.target.files?.[0] ?? null)}
+                      className="block w-full rounded-lg border border-[#cfd8e7] bg-white px-3 py-2 text-sm"
+                    />
+                  </label>
+
+                  <Button onClick={submitExtraction} disabled={isBusy || !uploadFile}>
+                    {isBusy ? "Analizando..." : "Analizar y guardar"}
+                  </Button>
+
+                  <div className="h-px bg-[#dfe7f3]" />
+
+                  <div className="space-y-2 rounded-xl border border-[#d6e2f3] bg-[#f4f8ff] p-3">
+                    <p className="text-sm font-semibold text-[#2d4d7d]">Continuidad M5 a M8 (sin reupload)</p>
+                    <p className="text-xs text-[#4a638c]">Usa el PDF mas reciente de una propuesta de Modulo 5 como fuente de extraccion.</p>
+
+                    <label className="space-y-1 text-sm font-semibold text-[#314764]">
+                      Propuesta fuente (M5)
+                      <select
+                        value={proposalSourceId}
+                        onChange={(event) => setProposalSourceId(event.target.value)}
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] bg-white px-3"
+                      >
+                        {proposalPdfOptions.length === 0 ? <option value="">No hay propuestas con PDF disponible</option> : null}
+                        {proposalPdfOptions.map((option) => (
+                          <option key={option.proposalId} value={option.proposalId}>
+                            {option.proposalTitle} - {option.fileName} ({formatDateTime(option.createdAt)})
+                          </option>
+                        ))}
+                      </select>
+                    </label>
+
+                    <Button variant="secondary" onClick={submitExtractionFromProposal} disabled={isBusy || !proposalSourceId}>
+                      {isBusy ? "Analizando..." : "Usar PDF de propuesta de M5"}
+                    </Button>
+                    {selectedProposalPdfOption ? (
+                      <p className="rounded-lg border border-[#cfdbef] bg-white px-2 py-1 text-xs text-[#3f5d8a]">
+                        <span className="font-semibold">Por que este archivo:</span> se usa el PDF mas reciente de la propuesta seleccionada ({selectedProposalPdfOption.fileName}).
+                      </p>
+                    ) : null}
+                  </div>
+
+                  <div className="h-px bg-[#dfe7f3]" />
+
+                  <div className="space-y-2 rounded-xl border border-[#e0d9fb] bg-[#f8f5ff] p-3">
+                    <p className="text-sm font-semibold text-[#4f3f9a]">Adjuntar documento al contrato (sin IA)</p>
+                    <p className="text-xs text-[#6a62a3]">Usa este flujo para subir evidencia contractual directamente usando `/api/contracts/upload`.</p>
+
+                    <label className="space-y-1 text-sm font-semibold text-[#314764]">
+                      Contrato destino
+                      <select
+                        value={evidenceContractId}
+                        onChange={(event) => setEvidenceContractId(event.target.value)}
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] bg-white px-3"
+                      >
+                        <option value="">Selecciona contrato</option>
+                        {contracts.map((item) => (
+                          <option key={item.id} value={item.id}>
+                            {item.title}
+                          </option>
+                        ))}
+                      </select>
+                    </label>
+
+                    <label className="space-y-1 text-sm font-semibold text-[#314764]">
+                      Tipo de documento
+                      <select
+                        value={evidenceKind}
+                        onChange={(event) => setEvidenceKind(event.target.value as ContractRecordView["documents"][number]["kind"])}
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] bg-white px-3"
+                      >
+                        <option value="SIGNED_CONTRACT">Contrato firmado</option>
+                        <option value="ADDENDUM">Convenio / adenda</option>
+                        <option value="DELIVERABLE_EVIDENCE">Evidencia de entregable</option>
+                        <option value="PAYMENT_EVIDENCE">Evidencia de pago</option>
+                        <option value="OTHER">Otro</option>
+                      </select>
+                    </label>
+
+                    <label className="space-y-1 text-sm font-semibold text-[#314764]">
+                      Archivo PDF de evidencia
+                      <input
+                        type="file"
+                        accept="application/pdf"
+                        onChange={(event) => setEvidenceFile(event.target.files?.[0] ?? null)}
+                        className="block w-full rounded-lg border border-[#cfd8e7] bg-white px-3 py-2 text-sm"
+                      />
+                    </label>
+
+                    <Button variant="secondary" onClick={uploadContractEvidence} disabled={isBusy || !evidenceContractId || !evidenceFile}>
+                      {isBusy ? "Subiendo..." : "Subir evidencia al contrato"}
+                    </Button>
+                  </div>
+                </CardContent>
+              </Card>
+            ),
+          },
+          {
+            id: "contracts",
+            label: "Contratos",
+            content: (
+              <div className="space-y-3">
+                <div className="flex flex-wrap gap-2">
+                  <Dialog triggerLabel="Nuevo Contrato" title="Nuevo Contrato" description="Captura manual del contrato">
+                    <div className="space-y-2">
+                      <input
+                        value={newContract.title}
+                        onChange={(event) => setNewContract((prev) => ({ ...prev, title: event.target.value }))}
+                        placeholder="Titulo"
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                      />
+                      <input
+                        value={newContract.counterpartyEntity}
+                        onChange={(event) => setNewContract((prev) => ({ ...prev, counterpartyEntity: event.target.value }))}
+                        placeholder="Entidad contratante"
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                      />
+                      <input
+                        value={newContract.contractNumber ?? ""}
+                        onChange={(event) => setNewContract((prev) => ({ ...prev, contractNumber: event.target.value || null }))}
+                        placeholder="Numero de contrato"
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                      />
+                      <input
+                        value={newContract.contractType}
+                        onChange={(event) => setNewContract((prev) => ({ ...prev, contractType: event.target.value }))}
+                        placeholder="Tipo"
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                      />
+                      <input
+                        value={newContract.totalAmount ?? ""}
+                        onChange={(event) => setNewContract((prev) => ({ ...prev, totalAmount: event.target.value ? Number(event.target.value) : null }))}
+                        placeholder="Monto total"
+                        type="number"
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                      />
+                      <Button onClick={createContract} disabled={isBusy}>
+                        Guardar contrato
+                      </Button>
+                    </div>
+                  </Dialog>
+                </div>
+
+                {contracts.length === 0 ? <p className="text-sm text-[#60718f]">Aun no hay contratos registrados.</p> : null}
+
+                {contracts.map((contract) => (
+                  <article key={contract.id} className="rounded-2xl border border-[#d8e1ef] bg-white p-4">
+                    <div className="flex flex-wrap items-start justify-between gap-3">
+                      <div>
+                        <p className="text-lg font-semibold text-[#1f3050]">{contract.title}</p>
+                        <p className="text-sm text-[#60718f]">{contract.counterpartyEntity}</p>
+                        <p className="text-xs text-[#60718f]">{contract.contractType}</p>
+                      </div>
+                      <span className={`inline-flex rounded-full border px-3 py-1 text-xs font-semibold ${statusTone(contract.status)}`}>{contract.status}</span>
+                    </div>
+
+                    <div className="mt-3 grid gap-2 text-sm text-[#425a82] md:grid-cols-4">
+                      <p>Inicio: {formatDate(contract.startDate)}</p>
+                      <p>Fin: {formatDate(contract.endDate)}</p>
+                      <p>Monto: {contract.totalAmount ? formatCurrency(contract.totalAmount, contract.currency) : "Sin monto"}</p>
+                      <p>
+                        Progreso: {contract.progress.completed}/{contract.progress.total} ({contract.progress.percent}%)
+                      </p>
+                    </div>
+
+                    <div className="mt-3 rounded-xl border border-[#dbe4f2] bg-[#f8fbff] p-3">
+                      <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#4b6287]">Documentos del contrato</p>
+                      {contract.documents.length === 0 ? <p className="mt-2 text-xs text-[#60718f]">Sin documentos cargados.</p> : null}
+
+                      {contract.documents.length > 0 ? (
+                        <ul className="mt-2 space-y-2">
+                          {contract.documents.map((document) => (
+                            <li key={document.id} className="rounded-lg border border-[#d8e2ef] bg-white px-3 py-2">
+                              <div className="flex flex-wrap items-center justify-between gap-2">
+                                <div>
+                                  <p className="text-sm font-semibold text-[#1f3050]">{document.fileName}</p>
+                                  <p className="text-xs text-[#60718f]">
+                                    {contractDocumentKindLabel(document.kind)} | {formatFileSize(document.sizeBytes)} | {formatDateTime(document.createdAt)}
+                                  </p>
+                                  {contract.sourceProposalId && document.kind === "SIGNED_CONTRACT" ? (
+                                    <p className="mt-1 rounded-md border border-[#d3e3fa] bg-[#eef5ff] px-2 py-1 text-[11px] font-semibold text-[#2c5b9e]">
+                                      Por que este archivo: continuidad M5-&gt;M8 desde propuesta {contract.sourceProposalId}.
+                                    </p>
+                                  ) : null}
+                                </div>
+                                <div className="flex flex-wrap gap-2">
+                                  <a
+                                    href={`/api/contracts/${encodeURIComponent(contract.id)}/documents/${encodeURIComponent(document.id)}`}
+                                    className="inline-flex h-8 items-center rounded-lg border border-[#cfd8e7] px-2 text-xs font-semibold text-[#2f4a74]"
+                                  >
+                                    Descargar
+                                  </a>
+                                  <button
+                                    type="button"
+                                    className="inline-flex h-8 items-center rounded-lg border border-[#ebc9ce] bg-[#fff4f6] px-2 text-xs font-semibold text-[#ab3e4d]"
+                                    onClick={() => {
+                                      void deleteContractDocument(contract.id, document.id);
+                                    }}
+                                  >
+                                    Eliminar
+                                  </button>
+                                </div>
+                              </div>
+                            </li>
+                          ))}
+                        </ul>
+                      ) : null}
+                    </div>
+
+                    <div className="mt-3 flex flex-wrap items-center gap-2">
+                      <select
+                        value={contract.status}
+                        onChange={(event) => updateContractStatus(contract.id, event.target.value as ContractRecordView["status"])}
+                        className="h-9 rounded-lg border border-[#cfd8e7] bg-white px-2 text-sm"
+                      >
+                        <option value="ACTIVE">ACTIVE</option>
+                        <option value="COMPLETED">COMPLETED</option>
+                        <option value="PAUSED">PAUSED</option>
+                        <option value="CANCELLED">CANCELLED</option>
+                      </select>
+
+                      <Link href={`/proteccion-legal?contractId=${encodeURIComponent(contract.id)}`}>
+                        <Button size="sm" variant="secondary">
+                          Abrir caso legal
+                        </Button>
+                      </Link>
+                    </div>
+                  </article>
+                ))}
+              </div>
+            ),
+          },
+          {
+            id: "deliverables",
+            label: "Entregables",
+            content: (
+              <div className="space-y-3">
+                <Dialog triggerLabel="Nuevo Entregable" title="Nuevo Entregable" description="Vincula un entregable a un contrato">
+                  <div className="space-y-2">
+                    <select
+                      value={newDeliverable.contractId}
+                      onChange={(event) => setNewDeliverable((prev) => ({ ...prev, contractId: event.target.value }))}
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                    >
+                      <option value="">Selecciona contrato</option>
+                      {contracts.map((item) => (
+                        <option key={item.id} value={item.id}>
+                          {item.title}
+                        </option>
+                      ))}
+                    </select>
+                    <input
+                      value={newDeliverable.title}
+                      onChange={(event) => setNewDeliverable((prev) => ({ ...prev, title: event.target.value }))}
+                      placeholder="Titulo del entregable"
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                    />
+                    <input
+                      type="date"
+                      value={newDeliverable.dueDate}
+                      onChange={(event) => setNewDeliverable((prev) => ({ ...prev, dueDate: event.target.value }))}
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                    />
+                    <input
+                      type="number"
+                      value={newDeliverable.amountLinked}
+                      onChange={(event) => setNewDeliverable((prev) => ({ ...prev, amountLinked: event.target.value }))}
+                      placeholder="Monto vinculado"
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                    />
+                    <Button onClick={createDeliverable} disabled={isBusy}>
+                      Guardar entregable
+                    </Button>
+                  </div>
+                </Dialog>
+
+                {deliverables.length === 0 ? <p className="text-sm text-[#60718f]">Sin entregables registrados.</p> : null}
+
+                {deliverables.map((item) => (
+                  <article key={item.id} className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                    <div className="flex flex-wrap items-center justify-between gap-2">
+                      <div>
+                        <p className="text-sm font-semibold text-[#1d335a]">{item.title}</p>
+                        <p className="text-xs text-[#60718f]">{item.contractTitle}</p>
+                      </div>
+                      <select
+                        value={item.status}
+                        onChange={(event) => updateDeliverableStatus(item.id, event.target.value as ContractDeliverableView["status"])}
+                        className="h-8 rounded-lg border border-[#cfd8e7] bg-white px-2 text-xs"
+                      >
+                        <option value="PENDING">PENDING</option>
+                        <option value="DELIVERED">DELIVERED</option>
+                        <option value="APPROVED">APPROVED</option>
+                        <option value="REJECTED">REJECTED</option>
+                        <option value="OVERDUE">OVERDUE</option>
+                      </select>
+                    </div>
+                    <p className="mt-1 text-xs text-[#60718f]">Vence: {formatDate(item.dueDate)} {item.isOverdue ? "(vencido)" : ""}</p>
+                  </article>
+                ))}
+              </div>
+            ),
+          },
+          {
+            id: "payments",
+            label: "Pagos",
+            content: (
+              <div className="space-y-3">
+                <Dialog triggerLabel="Registrar Pago" title="Registrar Pago" description="Agrega un pago vinculado al contrato">
+                  <div className="space-y-2">
+                    <select
+                      value={newPayment.contractId}
+                      onChange={(event) => setNewPayment((prev) => ({ ...prev, contractId: event.target.value }))}
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                    >
+                      <option value="">Selecciona contrato</option>
+                      {contracts.map((item) => (
+                        <option key={item.id} value={item.id}>
+                          {item.title}
+                        </option>
+                      ))}
+                    </select>
+                    <input
+                      type="number"
+                      value={newPayment.amount}
+                      onChange={(event) => setNewPayment((prev) => ({ ...prev, amount: event.target.value }))}
+                      placeholder="Monto"
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                    />
+                    <input
+                      type="date"
+                      value={newPayment.paymentDate}
+                      onChange={(event) => setNewPayment((prev) => ({ ...prev, paymentDate: event.target.value }))}
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                    />
+                    <input
+                      value={newPayment.concept}
+                      onChange={(event) => setNewPayment((prev) => ({ ...prev, concept: event.target.value }))}
+                      placeholder="Concepto"
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                    />
+                    <Button onClick={createPayment} disabled={isBusy}>
+                      Guardar pago
+                    </Button>
+                  </div>
+                </Dialog>
+
+                {payments.length === 0 ? <p className="text-sm text-[#60718f]">Sin pagos registrados.</p> : null}
+
+                {payments.map((item) => (
+                  <article key={item.id} className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                    <div className="flex flex-wrap items-center justify-between gap-2">
+                      <p className="text-sm font-semibold text-[#1d335a]">{item.contractTitle}</p>
+                      <span className="text-sm font-semibold text-[#1d335a]">{formatCurrency(item.amount, item.currency)}</span>
+                    </div>
+                    <p className="mt-1 text-xs text-[#60718f]">{item.concept}</p>
+                    <p className="mt-1 text-xs text-[#60718f]">
+                      {formatDate(item.paymentDate)} - {item.status}
+                    </p>
+                  </article>
+                ))}
+              </div>
+            ),
+          },
+        ]}
+      />
+    </div>
+  );
+}
diff --git a/src/components/app/dashboard-maturity-section.tsx b/src/components/app/dashboard-maturity-section.tsx
index ac75d76..2522b07 100644
--- a/src/components/app/dashboard-maturity-section.tsx
+++ b/src/components/app/dashboard-maturity-section.tsx
@@ -43,13 +43,13 @@ export function DashboardMaturitySection({ snapshot }: { snapshot: TalleresSnaps
     <div className="space-y-4">
       <Card>
         <CardHeader>
-          <h3 className="text-3xl font-semibold text-[#142447] [font-family:var(--font-display)]">Tu Indice de Madurez</h3>
+          <h3 className="text-2xl font-semibold text-[#142447] [font-family:var(--font-display)] md:text-3xl">Tu Indice de Madurez</h3>
           <p className="text-sm text-[#60718f]">Visualiza tu progreso hacia el siguiente nivel de preparacion.</p>
         </CardHeader>
         <CardContent className="space-y-6">
           <div className="text-center">
-            <p className="text-7xl font-semibold text-[#20a777]">{Math.round(snapshot.overallMaturity)}%</p>
-            <p className="text-2xl font-semibold text-[#213252]">Puntaje Global</p>
+            <p className="text-5xl font-semibold text-[#20a777] md:text-6xl">{Math.round(snapshot.overallMaturity)}%</p>
+            <p className="text-xl font-semibold text-[#213252]">Puntaje Global</p>
             <span className="mt-2 inline-flex rounded-full bg-[#24a977] px-4 py-1 text-sm font-semibold text-white">
               Nivel {snapshot.maturityLevel.label}
             </span>
@@ -69,7 +69,7 @@ export function DashboardMaturitySection({ snapshot }: { snapshot: TalleresSnaps
 
           <div className="rounded-2xl border border-[#d6e0ee] bg-[#f5faf7] p-4">
             <div className="flex flex-wrap items-center justify-between gap-2">
-              <p className="text-3xl font-semibold text-[#18305f]">
+              <p className="text-2xl font-semibold text-[#18305f] md:text-3xl">
                 Proximo nivel: <span className="text-[#d39b1c]">{snapshot.nextLevel?.label ?? "Avanzado"}</span>
               </p>
               {snapshot.nextLevel ? (
@@ -101,7 +101,7 @@ export function DashboardMaturitySection({ snapshot }: { snapshot: TalleresSnaps
       <div className="grid gap-4 lg:grid-cols-2">
         <Card>
           <CardHeader>
-            <h3 className="text-4xl font-semibold text-[#152647] [font-family:var(--font-display)]">Tu RADAR Empresarial</h3>
+            <h3 className="text-2xl font-semibold text-[#152647] [font-family:var(--font-display)] md:text-3xl">Tu RADAR Empresarial</h3>
             <p className="text-sm text-[#60718f]">Visualiza tus fortalezas y areas de mejora en 5 dimensiones.</p>
           </CardHeader>
           <CardContent>
@@ -116,7 +116,7 @@ export function DashboardMaturitySection({ snapshot }: { snapshot: TalleresSnaps
 
         <Card>
           <CardHeader>
-            <h3 className="text-4xl font-semibold text-[#152647] [font-family:var(--font-display)]">Puntaje por Dimension</h3>
+            <h3 className="text-2xl font-semibold text-[#152647] [font-family:var(--font-display)] md:text-3xl">Puntaje por Dimension</h3>
             <p className="text-sm text-[#60718f]">Cada respuesta afirmativa suma 20 puntos. Maximo 100 por dimension.</p>
           </CardHeader>
           <CardContent className="space-y-4">
@@ -125,7 +125,7 @@ export function DashboardMaturitySection({ snapshot }: { snapshot: TalleresSnaps
                 <div className="flex flex-wrap items-center justify-between gap-2">
                   <div className="flex items-center gap-2">
                     <span className="text-sm font-bold text-[#1f2f4c]">{statusIcon(dimension.gapLevel)}</span>
-                    <p className="text-3xl font-semibold text-[#1a2c4b]">{dimension.moduleName}</p>
+                    <p className="text-xl font-semibold text-[#1a2c4b] md:text-2xl">{dimension.moduleName}</p>
                     <Link href={`/talleres-desarrollo?dimension=${dimension.moduleKey}`}>
                       <Button size="sm" className="h-8 rounded-full bg-[#25a878] px-4 text-sm hover:bg-[#1f9368]">
                         Ver talleres
@@ -134,7 +134,7 @@ export function DashboardMaturitySection({ snapshot }: { snapshot: TalleresSnaps
                   </div>
                   <div className="flex items-center gap-2">
                     <span className={`rounded-full border px-3 py-1 text-sm font-semibold ${gapTone(dimension.gapLevel)}`}>{dimension.gapLabel}</span>
-                    <span className="text-2xl font-semibold text-[#152747]">{Math.round(dimension.displayScore)}%</span>
+                    <span className="text-xl font-semibold text-[#152747]">{Math.round(dimension.displayScore)}%</span>
                   </div>
                 </div>
                 <div className="h-4 overflow-hidden rounded-full bg-[#d9e2ee]">
@@ -152,7 +152,7 @@ export function DashboardMaturitySection({ snapshot }: { snapshot: TalleresSnaps
 
       <Card>
         <CardHeader>
-          <h3 className="text-4xl font-semibold text-[#152647] [font-family:var(--font-display)]">Analisis de Brechas por Dimension</h3>
+          <h3 className="text-2xl font-semibold text-[#152647] [font-family:var(--font-display)] md:text-3xl">Analisis de Brechas por Dimension</h3>
           <p className="text-sm text-[#60718f]">Identificacion de riesgos asociados a cada area de tu empresa.</p>
         </CardHeader>
         <CardContent className="overflow-x-auto">
@@ -193,13 +193,13 @@ export function DashboardMaturitySection({ snapshot }: { snapshot: TalleresSnaps
 
       <Card>
         <CardHeader>
-          <h3 className="text-4xl font-semibold text-[#152647] [font-family:var(--font-display)]">Recomendaciones Estrategicas Generales</h3>
+          <h3 className="text-2xl font-semibold text-[#152647] [font-family:var(--font-display)] md:text-3xl">Recomendaciones Estrategicas Generales</h3>
           <p className="text-sm text-[#60718f]">3 acciones prioritarias para mejorar tu posicion competitiva.</p>
         </CardHeader>
         <CardContent className="space-y-3">
           {snapshot.recommendations.map((recommendation, index) => (
             <article key={recommendation.id} className="rounded-2xl border border-[#d4dceb] bg-[#fdfefe] p-4">
-              <p className="text-4xl font-semibold text-[#102345]">
+              <p className="text-2xl font-semibold text-[#102345] md:text-3xl">
                 {index + 1}. {recommendation.title}
               </p>
               <p className="mt-1 text-sm text-[#5f7395]">{recommendation.description}</p>
@@ -211,19 +211,19 @@ export function DashboardMaturitySection({ snapshot }: { snapshot: TalleresSnaps
       <div className="grid gap-4 md:grid-cols-3">
         <Card>
           <CardContent className="space-y-2 py-5">
-            <p className="text-4xl font-semibold text-[#132447] [font-family:var(--font-display)]">Que es RADAR?</p>
+            <p className="text-2xl font-semibold text-[#132447] [font-family:var(--font-display)] md:text-3xl">Que es RADAR?</p>
             <p className="text-sm text-[#60718f]">El diagnostico RADAR evalua 5 dimensiones clave para identificar tu nivel de preparacion.</p>
           </CardContent>
         </Card>
         <Card>
           <CardContent className="space-y-2 py-5">
-            <p className="text-4xl font-semibold text-[#132447] [font-family:var(--font-display)]">Que es CRECE?</p>
+            <p className="text-2xl font-semibold text-[#132447] [font-family:var(--font-display)] md:text-3xl">Que es CRECE?</p>
             <p className="text-sm text-[#60718f]">Es tu ruta de fortalecimiento empresarial con capacitacion, rediseno y preparacion.</p>
           </CardContent>
         </Card>
         <Card>
           <CardContent className="space-y-2 py-5">
-            <p className="text-4xl font-semibold text-[#132447] [font-family:var(--font-display)]">Indice de Madurez</p>
+            <p className="text-2xl font-semibold text-[#132447] [font-family:var(--font-display)] md:text-3xl">Indice de Madurez</p>
             <p className="text-sm text-[#60718f]">Mide tu evolucion de Inicial a En Desarrollo, Preparado y Avanzado.</p>
           </CardContent>
         </Card>
diff --git a/src/components/app/legal-protection-view.tsx b/src/components/app/legal-protection-view.tsx
new file mode 100644
index 0000000..ab9fd32
--- /dev/null
+++ b/src/components/app/legal-protection-view.tsx
@@ -0,0 +1,891 @@
+"use client";
+
+import { useEffect, useMemo, useState } from "react";
+import type {
+  DiagnosisRecommendation,
+  LegalCaseView,
+  LegalContractOptionView,
+  LegalDirectoryEntityView,
+  LegalKpiSnapshot,
+  LegalTemplateView,
+} from "@/lib/legal/types";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+import { Dialog } from "@/components/ui/dialog";
+import { Tabs } from "@/components/ui/tabs";
+
+type LegalProtectionViewProps = {
+  initialCases: LegalCaseView[];
+  initialKpis: LegalKpiSnapshot;
+  initialDirectory: LegalDirectoryEntityView[];
+  initialTemplates: LegalTemplateView[];
+  availableContracts: LegalContractOptionView[];
+  prefilledContractId?: string | null;
+};
+
+type ApiPayload = {
+  ok?: boolean;
+  error?: string;
+  kpis?: LegalKpiSnapshot;
+  cases?: LegalCaseView[];
+  case?: LegalCaseView | null;
+  diagnosis?: {
+    id: string;
+    legalCaseId: string | null;
+    recommendation: DiagnosisRecommendation;
+  };
+  escalation?: {
+    caseId: string;
+    steps: Array<{
+      key: string;
+      title: string;
+      estimatedWindow: string;
+      checklist: string[];
+      requiresLawyer: boolean;
+      dependsOn: string | null;
+      completedAt: string | null;
+      notes: string;
+      isBlocked: boolean;
+    }>;
+  };
+  templates?: LegalTemplateView[];
+  entities?: LegalDirectoryEntityView[];
+  document?: {
+    id: string;
+    title: string;
+    content: string;
+    createdAt: string;
+  };
+  generation?: {
+    warnings?: string[];
+  };
+};
+
+function formatDate(value: string | null) {
+  if (!value) {
+    return "Sin fecha";
+  }
+
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return "Sin fecha";
+  }
+
+  return parsed.toLocaleString("es-MX", {
+    year: "numeric",
+    month: "short",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+}
+
+function severityTone(severity: LegalCaseView["severity"]) {
+  if (severity === "HIGH") {
+    return "border-[#f1c7ce] bg-[#fff1f4] text-[#b03f4f]";
+  }
+
+  if (severity === "MEDIUM") {
+    return "border-[#f0deb0] bg-[#fff8e9] text-[#8d6308]";
+  }
+
+  return "border-[#b9e6cd] bg-[#eaf9f1] text-[#1f8b63]";
+}
+
+function formatContractOptionLabel(contract: LegalContractOptionView) {
+  const numberLabel = contract.contractNumber ? `#${contract.contractNumber}` : "Sin numero";
+  return `${contract.title} - ${contract.counterpartyEntity} (${numberLabel})`;
+}
+
+export function LegalProtectionView({
+  initialCases,
+  initialKpis,
+  initialDirectory,
+  initialTemplates,
+  availableContracts,
+  prefilledContractId,
+}: LegalProtectionViewProps) {
+  const [cases, setCases] = useState(initialCases);
+  const [kpis, setKpis] = useState(initialKpis);
+  const [directory, setDirectory] = useState(initialDirectory);
+  const [templates, setTemplates] = useState(initialTemplates);
+
+  const [isBusy, setIsBusy] = useState(false);
+  const [message, setMessage] = useState<string | null>(null);
+  const [errorMessage, setErrorMessage] = useState<string | null>(null);
+
+  const [diagnosisStep, setDiagnosisStep] = useState(1);
+  const [diagnosisId, setDiagnosisId] = useState<string | null>(null);
+  const [diagnosisRecommendation, setDiagnosisRecommendation] = useState<DiagnosisRecommendation | null>(null);
+  const [diagnosisAnswers, setDiagnosisAnswers] = useState({
+    breachType: "contract_breach",
+    processStage: "none",
+    evidenceLevel: "basic",
+    urgency: "medium",
+    objective: "payment",
+    amountAtRisk: "",
+    counterparty: "",
+    description: "",
+  });
+  const [diagnosisContractId, setDiagnosisContractId] = useState(prefilledContractId ?? "");
+
+  const [newCase, setNewCase] = useState({
+    contractId: prefilledContractId ?? "",
+    caseType: "CONTRACT_BREACH",
+    severity: "MEDIUM",
+    counterparty: "",
+    description: "",
+    amountAtRisk: "",
+    status: "OPEN",
+  });
+
+  const [selectedEscalationCaseId, setSelectedEscalationCaseId] = useState("");
+  const [escalation, setEscalation] = useState<ApiPayload["escalation"] | null>(null);
+
+  const [documentDraft, setDocumentDraft] = useState({
+    legalCaseId: "",
+    caseType: "CONTRACT_BREACH",
+    severity: "MEDIUM",
+    templateKey: "",
+    counterparty: "",
+    companyName: "",
+    amountAtRisk: "",
+    description: "",
+    objective: "",
+    title: "",
+  });
+  const [generatedDocuments, setGeneratedDocuments] = useState<Array<{ id: string; title: string; content: string; createdAt: string }>>([]);
+
+  const [directoryFilters, setDirectoryFilters] = useState({
+    jurisdictionLevel: "",
+    q: "",
+  });
+
+  const currentEscalationCase = useMemo(
+    () => cases.find((item) => item.id === selectedEscalationCaseId) ?? null,
+    [cases, selectedEscalationCaseId],
+  );
+  const contractOptions = useMemo(() => {
+    const options = availableContracts.map((item) => ({
+      id: item.id,
+      label: formatContractOptionLabel(item),
+      isPrefilled: item.id === prefilledContractId,
+    }));
+
+    if (prefilledContractId && !options.some((item) => item.id === prefilledContractId)) {
+      options.unshift({
+        id: prefilledContractId,
+        label: `${prefilledContractId} (prefill)`,
+        isPrefilled: true,
+      });
+    }
+
+    return options;
+  }, [availableContracts, prefilledContractId]);
+
+  async function reloadDataset() {
+    const [kpisResponse, casesResponse, templatesResponse] = await Promise.all([
+      fetch("/api/legal/kpis"),
+      fetch("/api/legal/cases"),
+      fetch("/api/legal/templates"),
+    ]);
+
+    const kpisPayload = (await kpisResponse.json().catch(() => ({}))) as ApiPayload;
+    const casesPayload = (await casesResponse.json().catch(() => ({}))) as ApiPayload;
+    const templatesPayload = (await templatesResponse.json().catch(() => ({}))) as ApiPayload;
+
+    if (kpisResponse.ok && kpisPayload.ok && kpisPayload.kpis) {
+      setKpis(kpisPayload.kpis);
+    }
+
+    if (casesResponse.ok && casesPayload.ok && casesPayload.cases) {
+      setCases(casesPayload.cases);
+    }
+
+    if (templatesResponse.ok && templatesPayload.ok && templatesPayload.templates) {
+      setTemplates(templatesPayload.templates);
+    }
+  }
+
+  async function startDiagnosis() {
+    setIsBusy(true);
+    setErrorMessage(null);
+
+    try {
+      const response = await fetch("/api/legal/diagnosis/start", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          contractId: diagnosisContractId || null,
+        }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok || !payload.diagnosis) {
+        setErrorMessage(payload.error ?? "No fue posible iniciar diagnostico.");
+        return;
+      }
+
+      setDiagnosisId(payload.diagnosis.id);
+      setDiagnosisStep(1);
+      setDiagnosisRecommendation(payload.diagnosis.recommendation);
+      setMessage("Diagnostico iniciado.");
+    } catch {
+      setErrorMessage("No fue posible iniciar diagnostico.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function submitDiagnosisStep(finalize = false) {
+    if (!diagnosisId) {
+      await startDiagnosis();
+      return;
+    }
+
+    setIsBusy(true);
+    setErrorMessage(null);
+
+    try {
+      const response = await fetch("/api/legal/diagnosis/answer", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          diagnosisId,
+          stepIndex: diagnosisStep,
+          finalize,
+          answers: {
+            breachType: diagnosisAnswers.breachType,
+            processStage: diagnosisAnswers.processStage,
+            evidenceLevel: diagnosisAnswers.evidenceLevel,
+            urgency: diagnosisAnswers.urgency,
+            objective: diagnosisAnswers.objective,
+            amountAtRisk: diagnosisAnswers.amountAtRisk ? Number(diagnosisAnswers.amountAtRisk) : null,
+            counterparty: diagnosisAnswers.counterparty,
+            description: diagnosisAnswers.description,
+          },
+        }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok || !payload.diagnosis) {
+        setErrorMessage(payload.error ?? "No fue posible registrar respuesta del diagnostico.");
+        return;
+      }
+
+      setDiagnosisRecommendation(payload.diagnosis.recommendation);
+      if (finalize) {
+        setMessage("Diagnostico finalizado y caso legal generado.");
+        setDiagnosisStep(4);
+        await reloadDataset();
+      } else {
+        setDiagnosisStep((prev) => Math.min(4, prev + 1));
+      }
+    } catch {
+      setErrorMessage("No fue posible registrar respuesta del diagnostico.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function createCase() {
+    setIsBusy(true);
+    setErrorMessage(null);
+
+    try {
+      const response = await fetch("/api/legal/cases", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          contractId: newCase.contractId || null,
+          caseType: newCase.caseType,
+          severity: newCase.severity,
+          counterparty: newCase.counterparty,
+          description: newCase.description,
+          amountAtRisk: newCase.amountAtRisk ? Number(newCase.amountAtRisk) : null,
+          status: newCase.status,
+        }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok) {
+        setErrorMessage(payload.error ?? "No fue posible crear el caso legal.");
+        return;
+      }
+
+      setMessage("Caso legal creado.");
+      setNewCase({
+        contractId: prefilledContractId ?? "",
+        caseType: "CONTRACT_BREACH",
+        severity: "MEDIUM",
+        counterparty: "",
+        description: "",
+        amountAtRisk: "",
+        status: "OPEN",
+      });
+      await reloadDataset();
+    } catch {
+      setErrorMessage("No fue posible crear el caso legal.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function updateCaseStatus(caseId: string, status: LegalCaseView["status"]) {
+    setErrorMessage(null);
+
+    const resolvedAt = status === "RESOLVED" || status === "CLOSED" ? new Date().toISOString() : null;
+    const response = await fetch(`/api/legal/cases/${encodeURIComponent(caseId)}`, {
+      method: "PATCH",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({ status, resolvedAt }),
+    });
+
+    const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+    if (!response.ok || !payload.ok) {
+      setErrorMessage(payload.error ?? "No fue posible actualizar el caso.");
+      return;
+    }
+
+    setMessage("Caso actualizado.");
+    await reloadDataset();
+  }
+
+  async function loadEscalation(caseId: string) {
+    if (!caseId) {
+      setEscalation(null);
+      return;
+    }
+
+    const response = await fetch(`/api/legal/escalation/${encodeURIComponent(caseId)}`);
+    const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+    if (!response.ok || !payload.ok || !payload.escalation) {
+      setErrorMessage(payload.error ?? "No fue posible cargar la ruta de escalada.");
+      return;
+    }
+
+    setEscalation(payload.escalation);
+  }
+
+  async function toggleEscalationStep(caseId: string, stepKey: string, completed: boolean, notes: string) {
+    const response = await fetch(`/api/legal/escalation/${encodeURIComponent(caseId)}`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        routeStepKey: stepKey,
+        completed,
+        notes,
+      }),
+    });
+
+    const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+    if (!response.ok || !payload.ok || !payload.escalation) {
+      setErrorMessage(payload.error ?? "No fue posible actualizar la escalada.");
+      return;
+    }
+
+    setEscalation(payload.escalation);
+    setMessage("Escalada actualizada.");
+  }
+
+  async function generateDocument() {
+    setIsBusy(true);
+    setErrorMessage(null);
+
+    try {
+      const response = await fetch("/api/legal/documents/generate", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          legalCaseId: documentDraft.legalCaseId || null,
+          caseType: documentDraft.caseType,
+          severity: documentDraft.severity,
+          templateKey: documentDraft.templateKey || null,
+          counterparty: documentDraft.counterparty,
+          companyName: documentDraft.companyName,
+          amountAtRisk: documentDraft.amountAtRisk ? Number(documentDraft.amountAtRisk) : null,
+          description: documentDraft.description,
+          objective: documentDraft.objective,
+          title: documentDraft.title || null,
+        }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok || !payload.document) {
+        setErrorMessage(payload.error ?? "No fue posible generar el escrito.");
+        return;
+      }
+
+      setGeneratedDocuments((prev) => [payload.document as { id: string; title: string; content: string; createdAt: string }, ...prev]);
+      const warningText = payload.generation?.warnings?.join(" | ");
+      setMessage(warningText ? `Escrito generado. ${warningText}` : "Escrito generado.");
+    } catch {
+      setErrorMessage("No fue posible generar el escrito.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function reloadDirectory() {
+    const params = new URLSearchParams();
+    if (directoryFilters.jurisdictionLevel) {
+      params.set("jurisdictionLevel", directoryFilters.jurisdictionLevel);
+    }
+    if (directoryFilters.q.trim()) {
+      params.set("q", directoryFilters.q.trim());
+    }
+
+    const response = await fetch(`/api/legal/directory${params.toString() ? `?${params.toString()}` : ""}`);
+    const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+    if (!response.ok || !payload.ok || !payload.entities) {
+      setErrorMessage(payload.error ?? "No fue posible cargar el directorio.");
+      return;
+    }
+
+    setDirectory(payload.entities);
+  }
+
+  useEffect(() => {
+    if (selectedEscalationCaseId) {
+      void loadEscalation(selectedEscalationCaseId);
+    }
+  }, [selectedEscalationCaseId]);
+
+  return (
+    <div className="space-y-4">
+      <section className="grid gap-3 md:grid-cols-2 xl:grid-cols-4">
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Casos abiertos</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{kpis.openCases}</p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Alta severidad</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{kpis.highSeverityCases}</p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Monto en riesgo</p>
+            <p className="mt-2 text-3xl font-semibold text-[#15294d]">{kpis.amountAtRisk.toLocaleString("es-MX")}</p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Casos resueltos</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{kpis.resolvedCases}</p>
+          </CardContent>
+        </Card>
+      </section>
+
+      {errorMessage ? <p className="rounded-xl border border-[#efc4c4] bg-[#fff1f1] px-3 py-2 text-sm text-[#ad3f3f]">{errorMessage}</p> : null}
+      {message ? <p className="rounded-xl border border-[#bde5ce] bg-[#ecf9f1] px-3 py-2 text-sm text-[#1f7f4f]">{message}</p> : null}
+
+      <Tabs
+        defaultTab="diagnosis"
+        items={[
+          {
+            id: "diagnosis",
+            label: "Diagnostico",
+            content: (
+              <Card>
+                <CardContent className="space-y-3 py-5">
+                  <p className="text-sm text-[#60718f]">Wizard de 4 pasos para sugerir severidad, tipo de caso y ruta de escalada.</p>
+                  <p className="text-xs font-semibold text-[#415a82]">Paso {diagnosisStep} de 4</p>
+                  <label className="space-y-1 text-xs font-semibold text-[#314764]">
+                    Contrato vinculado (opcional)
+                    <select
+                      value={diagnosisContractId}
+                      onChange={(event) => setDiagnosisContractId(event.target.value)}
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                      disabled={Boolean(diagnosisId)}
+                    >
+                      <option value="">Sin contrato</option>
+                      {contractOptions.map((contract) => (
+                        <option key={contract.id} value={contract.id}>
+                          {contract.isPrefilled ? `${contract.label} (prefill)` : contract.label}
+                        </option>
+                      ))}
+                    </select>
+                  </label>
+
+                  <div className="grid gap-2 md:grid-cols-2">
+                    <label className="space-y-1 text-xs font-semibold text-[#314764]">
+                      Tipo de incumplimiento
+                      <select
+                        value={diagnosisAnswers.breachType}
+                        onChange={(event) => setDiagnosisAnswers((prev) => ({ ...prev, breachType: event.target.value }))}
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                      >
+                        <option value="contract_breach">Incumplimiento contractual</option>
+                        <option value="payment_retention">Retencion de pagos</option>
+                        <option value="unjust_sanction">Sancion injusta</option>
+                        <option value="contract_dispute">Disputa contractual</option>
+                      </select>
+                    </label>
+
+                    <label className="space-y-1 text-xs font-semibold text-[#314764]">
+                      Estado procesal
+                      <select
+                        value={diagnosisAnswers.processStage}
+                        onChange={(event) => setDiagnosisAnswers((prev) => ({ ...prev, processStage: event.target.value }))}
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                      >
+                        <option value="none">Sin proceso</option>
+                        <option value="informal_notice">Aviso informal</option>
+                        <option value="formal_notice">Requerimiento formal</option>
+                        <option value="ongoing_claim">Reclamacion en curso</option>
+                        <option value="trial">Via jurisdiccional</option>
+                      </select>
+                    </label>
+
+                    <label className="space-y-1 text-xs font-semibold text-[#314764]">
+                      Evidencia disponible
+                      <select
+                        value={diagnosisAnswers.evidenceLevel}
+                        onChange={(event) => setDiagnosisAnswers((prev) => ({ ...prev, evidenceLevel: event.target.value }))}
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                      >
+                        <option value="none">Sin evidencia</option>
+                        <option value="basic">Basica</option>
+                        <option value="solid">Solida</option>
+                        <option value="robust">Robusta</option>
+                      </select>
+                    </label>
+
+                    <label className="space-y-1 text-xs font-semibold text-[#314764]">
+                      Urgencia
+                      <select
+                        value={diagnosisAnswers.urgency}
+                        onChange={(event) => setDiagnosisAnswers((prev) => ({ ...prev, urgency: event.target.value }))}
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                      >
+                        <option value="low">Baja</option>
+                        <option value="medium">Media</option>
+                        <option value="high">Alta</option>
+                      </select>
+                    </label>
+
+                    <label className="space-y-1 text-xs font-semibold text-[#314764]">
+                      Objetivo legal
+                      <select
+                        value={diagnosisAnswers.objective}
+                        onChange={(event) => setDiagnosisAnswers((prev) => ({ ...prev, objective: event.target.value }))}
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                      >
+                        <option value="payment">Recuperar pago</option>
+                        <option value="correction">Correccion</option>
+                        <option value="challenge">Impugnacion</option>
+                        <option value="mediation">Mediacion</option>
+                      </select>
+                    </label>
+
+                    <label className="space-y-1 text-xs font-semibold text-[#314764]">
+                      Monto en riesgo
+                      <input
+                        type="number"
+                        value={diagnosisAnswers.amountAtRisk}
+                        onChange={(event) => setDiagnosisAnswers((prev) => ({ ...prev, amountAtRisk: event.target.value }))}
+                        className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                      />
+                    </label>
+                  </div>
+
+                  <input
+                    value={diagnosisAnswers.counterparty}
+                    onChange={(event) => setDiagnosisAnswers((prev) => ({ ...prev, counterparty: event.target.value }))}
+                    placeholder="Contraparte"
+                    className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                  />
+
+                  <textarea
+                    value={diagnosisAnswers.description}
+                    onChange={(event) => setDiagnosisAnswers((prev) => ({ ...prev, description: event.target.value }))}
+                    placeholder="Descripcion del caso"
+                    className="min-h-[110px] w-full rounded-lg border border-[#cfd8e7] px-3 py-2 text-sm"
+                  />
+
+                  <div className="flex flex-wrap gap-2">
+                    <Button variant="secondary" onClick={() => submitDiagnosisStep(false)} disabled={isBusy}>
+                      Guardar paso
+                    </Button>
+                    <Button onClick={() => submitDiagnosisStep(true)} disabled={isBusy}>
+                      Finalizar y abrir caso
+                    </Button>
+                  </div>
+
+                  {diagnosisRecommendation ? (
+                    <div className="rounded-xl border border-[#ced9ec] bg-[#f4f8ff] p-3 text-sm text-[#2d4b7b]">
+                      <p>
+                        Sugerencia: {diagnosisRecommendation.suggestedCaseType} / {diagnosisRecommendation.suggestedSeverity}
+                      </p>
+                      <p className="mt-1">Ruta: {diagnosisRecommendation.suggestedRoute.map((item) => item.title).join(" -> ")}</p>
+                      <p className="mt-1">Escritos: {diagnosisRecommendation.recommendedTemplates.join(", ")}</p>
+                    </div>
+                  ) : null}
+                </CardContent>
+              </Card>
+            ),
+          },
+          {
+            id: "cases",
+            label: "Casos",
+            content: (
+              <div className="space-y-3">
+                <Dialog triggerLabel="Nuevo Caso" title="Nuevo Caso" description="Registro manual de caso legal">
+                  <div className="space-y-2">
+                    <select
+                      value={newCase.contractId}
+                      onChange={(event) => setNewCase((prev) => ({ ...prev, contractId: event.target.value }))}
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                    >
+                      <option value="">Sin contrato</option>
+                      {contractOptions.map((contract) => (
+                        <option key={contract.id} value={contract.id}>
+                          {contract.isPrefilled ? `${contract.label} (prefill)` : contract.label}
+                        </option>
+                      ))}
+                    </select>
+                    <input
+                      value={newCase.counterparty}
+                      onChange={(event) => setNewCase((prev) => ({ ...prev, counterparty: event.target.value }))}
+                      placeholder="Contraparte"
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                    />
+                    <textarea
+                      value={newCase.description}
+                      onChange={(event) => setNewCase((prev) => ({ ...prev, description: event.target.value }))}
+                      placeholder="Descripcion"
+                      className="min-h-[90px] w-full rounded-lg border border-[#cfd8e7] px-3 py-2 text-sm"
+                    />
+                    <Button onClick={createCase} disabled={isBusy}>
+                      Guardar caso
+                    </Button>
+                  </div>
+                </Dialog>
+
+                {cases.length === 0 ? <p className="text-sm text-[#60718f]">Sin casos registrados.</p> : null}
+
+                {cases.map((item) => (
+                  <article key={item.id} className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                    <div className="flex flex-wrap items-center justify-between gap-2">
+                      <p className="text-sm font-semibold text-[#1d335a]">{item.caseType}</p>
+                      <span className={`inline-flex rounded-full border px-2 py-0.5 text-xs font-semibold ${severityTone(item.severity)}`}>{item.severity}</span>
+                    </div>
+                    <p className="mt-1 text-xs text-[#60718f]">{item.counterparty}</p>
+                    <p className="mt-1 text-xs text-[#60718f]">{item.description}</p>
+                    <div className="mt-2 flex flex-wrap items-center gap-2">
+                      <select
+                        value={item.status}
+                        onChange={(event) => updateCaseStatus(item.id, event.target.value as LegalCaseView["status"])}
+                        className="h-8 rounded-lg border border-[#cfd8e7] px-2 text-xs"
+                      >
+                        <option value="OPEN">OPEN</option>
+                        <option value="IN_PROGRESS">IN_PROGRESS</option>
+                        <option value="ESCALATED">ESCALATED</option>
+                        <option value="RESOLVED">RESOLVED</option>
+                        <option value="CLOSED">CLOSED</option>
+                      </select>
+                      <span className="text-xs text-[#60718f]">Abierto: {formatDate(item.openedAt)}</span>
+                    </div>
+                  </article>
+                ))}
+              </div>
+            ),
+          },
+          {
+            id: "escalation",
+            label: "Escalada",
+            content: (
+              <div className="space-y-3">
+                <select
+                  value={selectedEscalationCaseId}
+                  onChange={(event) => setSelectedEscalationCaseId(event.target.value)}
+                  className="h-10 w-full rounded-lg border border-[#cfd8e7] bg-white px-3 text-sm"
+                >
+                  <option value="">Selecciona caso</option>
+                  {cases.map((item) => (
+                    <option key={item.id} value={item.id}>
+                      {item.caseType} - {item.counterparty}
+                    </option>
+                  ))}
+                </select>
+
+                {currentEscalationCase && !escalation ? <Button variant="secondary" onClick={() => loadEscalation(currentEscalationCase.id)}>Cargar ruta</Button> : null}
+
+                {escalation?.steps.map((step) => (
+                  <article key={step.key} className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                    <div className="flex flex-wrap items-start justify-between gap-2">
+                      <div>
+                        <p className="text-sm font-semibold text-[#1d335a]">{step.title}</p>
+                        <p className="text-xs text-[#60718f]">Ventana estimada: {step.estimatedWindow}</p>
+                        {step.requiresLawyer ? <p className="text-xs font-semibold text-[#9b4f2c]">Requiere abogado</p> : null}
+                      </div>
+                      <label className="inline-flex items-center gap-2 text-xs font-semibold text-[#314764]">
+                        <input
+                          type="checkbox"
+                          checked={Boolean(step.completedAt)}
+                          disabled={step.isBlocked}
+                          onChange={(event) => {
+                            if (!selectedEscalationCaseId) {
+                              return;
+                            }
+                            void toggleEscalationStep(selectedEscalationCaseId, step.key, event.target.checked, step.notes ?? "");
+                          }}
+                        />
+                        Completado
+                      </label>
+                    </div>
+                    <ul className="mt-2 list-disc pl-5 text-xs text-[#60718f]">
+                      {step.checklist.map((item) => (
+                        <li key={`${step.key}-${item}`}>{item}</li>
+                      ))}
+                    </ul>
+                  </article>
+                ))}
+              </div>
+            ),
+          },
+          {
+            id: "documents",
+            label: "Escritos",
+            content: (
+              <div className="space-y-3">
+                <Card>
+                  <CardContent className="space-y-2 py-5">
+                    <select
+                      value={documentDraft.legalCaseId}
+                      onChange={(event) => setDocumentDraft((prev) => ({ ...prev, legalCaseId: event.target.value }))}
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                    >
+                      <option value="">Sin caso vinculado</option>
+                      {cases.map((item) => (
+                        <option key={item.id} value={item.id}>
+                          {item.caseType} - {item.counterparty}
+                        </option>
+                      ))}
+                    </select>
+
+                    <select
+                      value={documentDraft.templateKey}
+                      onChange={(event) => setDocumentDraft((prev) => ({ ...prev, templateKey: event.target.value }))}
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                    >
+                      <option value="">Plantilla automatica por tipo de caso</option>
+                      {templates.map((template) => (
+                        <option key={template.key} value={template.key}>
+                          {template.title}
+                        </option>
+                      ))}
+                    </select>
+
+                    <input
+                      value={documentDraft.counterparty}
+                      onChange={(event) => setDocumentDraft((prev) => ({ ...prev, counterparty: event.target.value }))}
+                      placeholder="Contraparte"
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                    />
+                    <input
+                      value={documentDraft.companyName}
+                      onChange={(event) => setDocumentDraft((prev) => ({ ...prev, companyName: event.target.value }))}
+                      placeholder="Empresa"
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                    />
+                    <input
+                      value={documentDraft.objective}
+                      onChange={(event) => setDocumentDraft((prev) => ({ ...prev, objective: event.target.value }))}
+                      placeholder="Objetivo legal"
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                    />
+                    <textarea
+                      value={documentDraft.description}
+                      onChange={(event) => setDocumentDraft((prev) => ({ ...prev, description: event.target.value }))}
+                      placeholder="Descripcion"
+                      className="min-h-[110px] w-full rounded-lg border border-[#cfd8e7] px-3 py-2 text-sm"
+                    />
+
+                    <Button onClick={generateDocument} disabled={isBusy}>
+                      Generar escrito
+                    </Button>
+                  </CardContent>
+                </Card>
+
+                {generatedDocuments.map((item) => (
+                  <article key={item.id} className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                    <p className="text-sm font-semibold text-[#1d335a]">{item.title}</p>
+                    <p className="mt-1 text-xs text-[#60718f]">{formatDate(item.createdAt)}</p>
+                    <textarea readOnly value={item.content} className="mt-2 min-h-[160px] w-full rounded-lg border border-[#cfd8e7] p-2 text-xs" />
+                  </article>
+                ))}
+              </div>
+            ),
+          },
+          {
+            id: "directory",
+            label: "Directorio",
+            content: (
+              <div className="space-y-3">
+                <div className="flex flex-wrap gap-2">
+                  <select
+                    value={directoryFilters.jurisdictionLevel}
+                    onChange={(event) => setDirectoryFilters((prev) => ({ ...prev, jurisdictionLevel: event.target.value }))}
+                    className="h-10 rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                  >
+                    <option value="">Todas las jurisdicciones</option>
+                    <option value="FEDERAL">FEDERAL</option>
+                    <option value="STATE">STATE</option>
+                    <option value="MUNICIPAL">MUNICIPAL</option>
+                  </select>
+                  <input
+                    value={directoryFilters.q}
+                    onChange={(event) => setDirectoryFilters((prev) => ({ ...prev, q: event.target.value }))}
+                    placeholder="Buscar entidad"
+                    className="h-10 min-w-[260px] rounded-lg border border-[#cfd8e7] px-3 text-sm"
+                  />
+                  <Button variant="secondary" onClick={reloadDirectory}>
+                    Filtrar
+                  </Button>
+                </div>
+
+                {directory.length === 0 ? <p className="text-sm text-[#60718f]">Sin entidades en el filtro actual.</p> : null}
+
+                {directory.map((item) => (
+                  <article key={item.id} className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                    <p className="text-sm font-semibold text-[#1d335a]">{item.name}</p>
+                    <p className="mt-1 text-xs text-[#60718f]">{item.jurisdictionLevel} - {item.scopeTags.join(", ")}</p>
+                    <p className="mt-1 text-xs text-[#60718f]">{item.websiteUrl ?? "Sin sitio web"}</p>
+                  </article>
+                ))}
+              </div>
+            ),
+          },
+        ]}
+      />
+    </div>
+  );
+}
diff --git a/src/components/app/licitation-card-actions.tsx b/src/components/app/licitation-card-actions.tsx
new file mode 100644
index 0000000..fd7abff
--- /dev/null
+++ b/src/components/app/licitation-card-actions.tsx
@@ -0,0 +1,93 @@
+"use client";
+
+import { useState } from "react";
+import { useRouter } from "next/navigation";
+import type { LicitationReviewStatusView } from "@/lib/licitations/preferences";
+import { Button } from "@/components/ui/button";
+
+type LicitationCardActionsProps = {
+  licitationId: string;
+  initialStatus: LicitationReviewStatusView;
+  normativeAnalysisHref: string;
+};
+
+type ApiPayload = {
+  ok?: boolean;
+  error?: string;
+  status?: LicitationReviewStatusView;
+};
+
+export function LicitationCardActions({ licitationId, initialStatus, normativeAnalysisHref }: LicitationCardActionsProps) {
+  const router = useRouter();
+  const [status, setStatus] = useState<LicitationReviewStatusView>(initialStatus);
+  const [isSaving, setIsSaving] = useState(false);
+  const [errorMessage, setErrorMessage] = useState<string | null>(null);
+
+  async function updateStatus(nextStatus: LicitationReviewStatusView, shouldRefresh = true) {
+    setErrorMessage(null);
+    setIsSaving(true);
+
+    try {
+      const response = await fetch(`/api/licitations/preferences/${encodeURIComponent(licitationId)}`, {
+        method: "PATCH",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ status: nextStatus }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok || !payload.status) {
+        setErrorMessage(payload.error ?? "No fue posible actualizar el estado.");
+        return false;
+      }
+
+      setStatus(payload.status);
+      if (shouldRefresh) {
+        router.refresh();
+      }
+      return true;
+    } catch {
+      setErrorMessage("No fue posible actualizar el estado.");
+      return false;
+    } finally {
+      setIsSaving(false);
+    }
+  }
+
+  async function handleToggleReviewed() {
+    const nextStatus = status === "REVIEWED" ? "NEW" : "REVIEWED";
+    await updateStatus(nextStatus);
+  }
+
+  async function handleInterested() {
+    const ok = await updateStatus("INTERESTED", false);
+    if (!ok) {
+      return;
+    }
+    window.location.href = normativeAnalysisHref;
+  }
+
+  async function handleDiscardOrRestore() {
+    const nextStatus = status === "DISCARDED" ? "NEW" : "DISCARDED";
+    await updateStatus(nextStatus);
+  }
+
+  return (
+    <div className="space-y-2">
+      <div className="flex flex-wrap gap-2">
+        <Button size="sm" variant="secondary" onClick={handleToggleReviewed} disabled={isSaving}>
+          {status === "REVIEWED" ? "Quitar consultada" : "Marcar consultada"}
+        </Button>
+        <Button size="sm" onClick={handleInterested} disabled={isSaving}>
+          Me interesa
+        </Button>
+        <Button size="sm" variant="ghost" onClick={handleDiscardOrRestore} disabled={isSaving}>
+          {status === "DISCARDED" ? "Restaurar" : "Descartar"}
+        </Button>
+      </div>
+      {errorMessage ? <p className="text-xs font-semibold text-[#b93a4b]">{errorMessage}</p> : null}
+    </div>
+  );
+}
diff --git a/src/components/app/licitations-sync-button.tsx b/src/components/app/licitations-sync-button.tsx
index 66f0437..a6fbf78 100644
--- a/src/components/app/licitations-sync-button.tsx
+++ b/src/components/app/licitations-sync-button.tsx
@@ -17,7 +17,11 @@ export function LicitationsSyncButton() {
         headers: {
           "Content-Type": "application/json",
         },
-        body: JSON.stringify({}),
+        body: JSON.stringify({
+          includePnt: true,
+          includeLicitaya: true,
+          force: true,
+        }),
       });
 
       const payload = (await response.json().catch(() => ({}))) as {
@@ -25,6 +29,19 @@ export function LicitationsSyncButton() {
         error?: string;
         payload?: {
           processedMunicipalities?: number;
+          processedScopes?: number;
+          processedLicitayaBuckets?: number;
+          results?: Array<{
+            sourceResults?: Array<{
+              status?: string;
+              warnings?: string[];
+              stats?: {
+                totalFetched?: number;
+                inserted?: number;
+                updated?: number;
+              };
+            }>;
+          }>;
         };
       };
 
@@ -33,8 +50,41 @@ export function LicitationsSyncButton() {
         return;
       }
 
-      const processed = payload.payload?.processedMunicipalities ?? 0;
-      setMessage(`Sincronizacion completada. Municipios procesados: ${processed}.`);
+      const processedMunicipalities = payload.payload?.processedMunicipalities ?? 0;
+      const processedScopes = payload.payload?.processedScopes ?? processedMunicipalities;
+      const licitayaBuckets = payload.payload?.processedLicitayaBuckets ?? 0;
+      const sourceResults = payload.payload?.results?.flatMap((result) => result.sourceResults ?? []) ?? [];
+
+      const totals = sourceResults.reduce(
+        (acc, sourceResult) => {
+          acc.fetched += sourceResult.stats?.totalFetched ?? 0;
+          acc.inserted += sourceResult.stats?.inserted ?? 0;
+          acc.updated += sourceResult.stats?.updated ?? 0;
+          acc.warnings += sourceResult.warnings?.length ?? 0;
+
+          if (sourceResult.status === "FAILED") {
+            acc.failed += 1;
+          } else if (sourceResult.status === "PARTIAL") {
+            acc.partial += 1;
+          }
+
+          return acc;
+        },
+        {
+          fetched: 0,
+          inserted: 0,
+          updated: 0,
+          warnings: 0,
+          failed: 0,
+          partial: 0,
+        },
+      );
+
+      setMessage(
+        `Sync listo. Municipios: ${processedMunicipalities}. Alcances: ${processedScopes}. LicitaYa: ${licitayaBuckets}. ` +
+          `Detectados: ${totals.fetched}. Nuevos: ${totals.inserted}. Actualizados: ${totals.updated}. ` +
+          `Parciales: ${totals.partial}. Fallidos: ${totals.failed}. Advertencias: ${totals.warnings}.`,
+      );
     } catch {
       setMessage("No se pudo ejecutar la sincronizacion.");
     } finally {
diff --git a/src/components/app/module-questionnaire.tsx b/src/components/app/module-questionnaire.tsx
index 634a3f9..8074c3b 100644
--- a/src/components/app/module-questionnaire.tsx
+++ b/src/components/app/module-questionnaire.tsx
@@ -43,6 +43,15 @@ type EvidenceDraft = {
 
 type SaveState = "idle" | "saving" | "saved" | "error";
 
+type AiQuestionSuggestion = {
+  questionId: string;
+  suggestedAnswerOptionId: string;
+  rationale: string;
+  missingEvidence: string[];
+  confidence: number | null;
+  suggestionId: string;
+};
+
 function toEvidenceDraft(
   evidence: {
     notes: string;
@@ -102,6 +111,11 @@ export function ModuleQuestionnaire({
 
   const [saveStateByQuestionId, setSaveStateByQuestionId] = useState<Record<string, SaveState>>({});
   const [saveErrorByQuestionId, setSaveErrorByQuestionId] = useState<Record<string, string>>({});
+  const [aiSuggestionsByQuestionId, setAiSuggestionsByQuestionId] = useState<Record<string, AiQuestionSuggestion>>({});
+  const [isGeneratingAi, setIsGeneratingAi] = useState(false);
+  const [aiMessage, setAiMessage] = useState<string | null>(null);
+  const [aiError, setAiError] = useState<string | null>(null);
+  const [actingSuggestionId, setActingSuggestionId] = useState<string | null>(null);
 
   const answeredCount = useMemo(() => {
     return questions.reduce((total, question) => {
@@ -150,12 +164,14 @@ export function ModuleQuestionnaire({
       if (!response.ok) {
         const payload = (await response.json().catch(() => ({}))) as { error?: string };
         setQuestionSaveState(questionId, "error", payload.error ?? "No se pudo guardar la respuesta.");
-        return;
+        return false;
       }
 
       setQuestionSaveState(questionId, "saved");
+      return true;
     } catch {
       setQuestionSaveState(questionId, "error", "No se pudo guardar la respuesta.");
+      return false;
     }
   }
 
@@ -191,6 +207,118 @@ export function ModuleQuestionnaire({
     void persistQuestionResponse(questionId, answerOptionId, draft);
   }
 
+  async function setSuggestionDecision(suggestionId: string, decision: "accept" | "dismiss") {
+    const response = await fetch(`/api/ai/suggestions/${encodeURIComponent(suggestionId)}/decision`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({ decision }),
+    });
+
+    return response.ok;
+  }
+
+  async function generateAiSuggestions() {
+    setIsGeneratingAi(true);
+    setAiError(null);
+    setAiMessage(null);
+
+    try {
+      const response = await fetch("/api/diagnostic/ai/suggestions", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          moduleKey,
+        }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as {
+        ok?: boolean;
+        error?: string;
+        suggestions?: AiQuestionSuggestion[];
+      };
+
+      if (!response.ok || !payload.ok || !payload.suggestions) {
+        setAiError(payload.error ?? "No fue posible generar sugerencias IA.");
+        return;
+      }
+
+      const byQuestionId = payload.suggestions.reduce<Record<string, AiQuestionSuggestion>>((accumulator, suggestion) => {
+        accumulator[suggestion.questionId] = suggestion;
+        return accumulator;
+      }, {});
+
+      setAiSuggestionsByQuestionId(byQuestionId);
+      setAiMessage(payload.suggestions.length ? "Sugerencias IA actualizadas." : "No hay preguntas pendientes para sugerir.");
+    } catch {
+      setAiError("No fue posible generar sugerencias IA.");
+    } finally {
+      setIsGeneratingAi(false);
+    }
+  }
+
+  async function applyAiSuggestion(questionId: string) {
+    const suggestion = aiSuggestionsByQuestionId[questionId];
+    if (!suggestion) {
+      return;
+    }
+
+    setActingSuggestionId(suggestion.suggestionId);
+    setAiError(null);
+    setAiMessage(null);
+
+    try {
+      setAnswers((previous) => ({
+        ...previous,
+        [questionId]: suggestion.suggestedAnswerOptionId,
+      }));
+
+      const draft = evidenceByQuestionId[questionId] ?? { notes: "", links: "" };
+      const persisted = await persistQuestionResponse(questionId, suggestion.suggestedAnswerOptionId, draft);
+
+      if (!persisted) {
+        setAiError("La sugerencia se aplico localmente, pero no se pudo guardar en el servidor.");
+        return;
+      }
+
+      await setSuggestionDecision(suggestion.suggestionId, "accept");
+      setAiSuggestionsByQuestionId((previous) => {
+        const next = { ...previous };
+        delete next[questionId];
+        return next;
+      });
+      setAiMessage("Sugerencia IA aplicada.");
+    } finally {
+      setActingSuggestionId(null);
+    }
+  }
+
+  async function dismissAiSuggestion(questionId: string) {
+    const suggestion = aiSuggestionsByQuestionId[questionId];
+    if (!suggestion) {
+      return;
+    }
+
+    setActingSuggestionId(suggestion.suggestionId);
+    setAiError(null);
+    setAiMessage(null);
+
+    try {
+      await setSuggestionDecision(suggestion.suggestionId, "dismiss");
+      setAiSuggestionsByQuestionId((previous) => {
+        const next = { ...previous };
+        delete next[questionId];
+        return next;
+      });
+      setAiMessage("Sugerencia IA descartada.");
+    } finally {
+      setActingSuggestionId(null);
+    }
+  }
+
   if (questions.length === 0) {
     return (
       <Card>
@@ -231,6 +359,13 @@ export function ModuleQuestionnaire({
             </p>
           </div>
           <Progress value={completion} showValue />
+          <div className="flex flex-wrap items-center gap-2">
+            <Button type="button" size="sm" variant="secondary" disabled={isGeneratingAi} onClick={() => void generateAiSuggestions()}>
+              {isGeneratingAi ? "Generando sugerencias IA..." : "Generar sugerencias IA"}
+            </Button>
+            {aiMessage ? <p className="text-sm text-[#1f7c4d]">{aiMessage}</p> : null}
+            {aiError ? <p className="text-sm text-[#b63d3d]">{aiError}</p> : null}
+          </div>
         </CardContent>
       </Card>
 
@@ -241,6 +376,9 @@ export function ModuleQuestionnaire({
             const evidenceDraft = evidenceByQuestionId[question.id] ?? { notes: "", links: "" };
             const saveState = saveStateByQuestionId[question.id] ?? "idle";
             const saveError = saveErrorByQuestionId[question.id] ?? null;
+            const aiSuggestion = aiSuggestionsByQuestionId[question.id] ?? null;
+            const suggestedOptionLabel =
+              question.options.find((option) => option.id === aiSuggestion?.suggestedAnswerOptionId)?.label ?? "Opcion sugerida";
 
             return (
               <div key={question.id} className="rounded-xl border border-[#d9e2f0] p-4">
@@ -315,6 +453,41 @@ export function ModuleQuestionnaire({
                     </p>
                   ) : null}
                 </div>
+
+                {aiSuggestion ? (
+                  <div className="mt-4 rounded-lg border border-[#d7e2f4] bg-[#f6f9ff] p-3">
+                    <p className="text-sm font-semibold text-[#1d335a]">Sugerencia IA</p>
+                    <p className="mt-1 text-sm text-[#405578]">
+                      Opcion sugerida: <span className="font-semibold">{suggestedOptionLabel}</span>
+                    </p>
+                    <p className="mt-1 text-sm text-[#506688]">{aiSuggestion.rationale}</p>
+                    {aiSuggestion.missingEvidence.length ? (
+                      <p className="mt-1 text-xs text-[#60718f]">Evidencia faltante: {aiSuggestion.missingEvidence.join(" | ")}</p>
+                    ) : null}
+                    {typeof aiSuggestion.confidence === "number" ? (
+                      <p className="mt-1 text-xs font-semibold text-[#334d77]">Confianza: {Math.round(aiSuggestion.confidence * 100)}%</p>
+                    ) : null}
+                    <div className="mt-2 flex flex-wrap items-center gap-2">
+                      <Button
+                        type="button"
+                        size="sm"
+                        disabled={actingSuggestionId === aiSuggestion.suggestionId}
+                        onClick={() => void applyAiSuggestion(question.id)}
+                      >
+                        Aplicar
+                      </Button>
+                      <Button
+                        type="button"
+                        size="sm"
+                        variant="secondary"
+                        disabled={actingSuggestionId === aiSuggestion.suggestionId}
+                        onClick={() => void dismissAiSuggestion(question.id)}
+                      >
+                        Descartar
+                      </Button>
+                    </div>
+                  </div>
+                ) : null}
               </div>
             );
           })}
diff --git a/src/components/app/normative-analysis-view.tsx b/src/components/app/normative-analysis-view.tsx
new file mode 100644
index 0000000..bf05f4a
--- /dev/null
+++ b/src/components/app/normative-analysis-view.tsx
@@ -0,0 +1,1132 @@
+"use client";
+
+import Link from "next/link";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import type { NormativeAnalysisHistoryView } from "@/lib/normative-analysis/history";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+import { cn } from "@/lib/utils";
+
+type NormativeDocumentType = "BASES_LICITACION" | "CONVOCATORIA" | "ANEXOS" | "REGLAMENTO" | "LEY" | "OTRO";
+
+type NormativeAnalysisViewProps = {
+  linkedSource?: {
+    id: string;
+    title: string;
+    issuingEntity: string | null;
+  } | null;
+  linkedProposal?: {
+    id: string;
+    title: string;
+    issuingEntity: string | null;
+  } | null;
+  autoAnalyzeOnLoad?: boolean;
+  moduleContext?: "normative" | "candados";
+};
+
+type AnalyzeApiPayload = {
+  ok?: boolean;
+  error?: string;
+  code?: string;
+  item?: NormativeAnalysisHistoryView;
+};
+
+type HistoryApiPayload = {
+  ok?: boolean;
+  error?: string;
+  items?: NormativeAnalysisHistoryView[];
+};
+
+type DeleteApiPayload = {
+  ok?: boolean;
+  error?: string;
+};
+
+const MAX_UPLOAD_BYTES = 20 * 1024 * 1024;
+
+const documentTypeOptions: Array<{ value: NormativeDocumentType; label: string }> = [
+  { value: "BASES_LICITACION", label: "Bases de Licitacion" },
+  { value: "CONVOCATORIA", label: "Convocatoria" },
+  { value: "ANEXOS", label: "Anexos" },
+  { value: "REGLAMENTO", label: "Reglamento" },
+  { value: "LEY", label: "Ley" },
+  { value: "OTRO", label: "Otro" },
+];
+
+function formatDateTime(value: string) {
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    return "Fecha no disponible";
+  }
+
+  return date.toLocaleDateString("es-MX", {
+    year: "numeric",
+    month: "short",
+    day: "2-digit",
+  });
+}
+
+function getDocumentTypeLabel(value: NormativeDocumentType) {
+  return documentTypeOptions.find((option) => option.value === value)?.label ?? "Otro";
+}
+
+function getViabilityBadgeTone(score: number) {
+  if (score >= 75) {
+    return "border-[#b9e6cd] bg-[#eaf9f1] text-[#1f8b63]";
+  }
+
+  if (score >= 55) {
+    return "border-[#f0deb0] bg-[#fff8e9] text-[#9d6d08]";
+  }
+
+  return "border-[#f1c7ce] bg-[#fff1f4] text-[#b03f4f]";
+}
+
+function getRiskBadgeTone(level: "alto" | "medio" | "bajo") {
+  if (level === "alto") {
+    return "border-[#f1c7ce] bg-[#fff1f4] text-[#b03f4f]";
+  }
+
+  if (level === "medio") {
+    return "border-[#f0deb0] bg-[#fff8e9] text-[#9d6d08]";
+  }
+
+  return "border-[#b9e6cd] bg-[#eaf9f1] text-[#1f8b63]";
+}
+
+function getPriorityTone(priority: "alta" | "media" | "baja") {
+  if (priority === "alta") {
+    return "border-[#f1c7ce] bg-[#fff1f4] text-[#b03f4f]";
+  }
+
+  if (priority === "media") {
+    return "border-[#f0deb0] bg-[#fff8e9] text-[#9d6d08]";
+  }
+
+  return "border-[#b9e6cd] bg-[#eaf9f1] text-[#1f8b63]";
+}
+
+function getSeverityTone(level: "alto" | "medio" | "bajo") {
+  if (level === "alto") {
+    return "border-[#f1c7ce] bg-[#fff1f4] text-[#b03f4f]";
+  }
+
+  if (level === "medio") {
+    return "border-[#f0deb0] bg-[#fff8e9] text-[#9d6d08]";
+  }
+
+  return "border-[#b9e6cd] bg-[#eaf9f1] text-[#1f8b63]";
+}
+
+type SuspiciousPattern = {
+  key: string;
+  phrase: string;
+  description: string;
+  level: "alto" | "medio" | "bajo";
+  category: "Direccionamiento" | "Candado Indebido";
+  count: number;
+};
+
+function normalizePatternKey(value: string) {
+  return value.trim().toLowerCase();
+}
+
+function inferPatternCategory(input: string): SuspiciousPattern["category"] {
+  const text = input.toLowerCase();
+  if (text.includes("exclusiv") || text.includes("marca") || text.includes("solo") || text.includes("obligatori")) {
+    return "Direccionamiento";
+  }
+
+  return "Candado Indebido";
+}
+
+function inferPatternLevel(input: string): SuspiciousPattern["level"] {
+  const text = input.toLowerCase();
+  if (text.includes("alto") || text.includes("critic") || text.includes("grave")) {
+    return "alto";
+  }
+
+  if (text.includes("bajo") || text.includes("leve")) {
+    return "bajo";
+  }
+
+  return "medio";
+}
+
+function buildSuspiciousPatterns(result: NormativeAnalysisHistoryView["result"] | null): SuspiciousPattern[] {
+  if (!result) {
+    return [];
+  }
+
+  const grouped = new Map<string, SuspiciousPattern>();
+
+  for (const lock of result.lockIns) {
+    const key = normalizePatternKey(lock.title || lock.impact || "candado");
+    if (!key) {
+      continue;
+    }
+
+    const existing = grouped.get(key);
+    if (existing) {
+      existing.count += 1;
+      continue;
+    }
+
+    grouped.set(key, {
+      key,
+      phrase: lock.title || "Patron detectado",
+      description: lock.impact || lock.recommendation || "Posible restriccion que limita la competencia.",
+      level: inferPatternLevel(`${lock.title} ${lock.impact} ${lock.recommendation}`),
+      category: inferPatternCategory(`${lock.title} ${lock.impact} ${lock.recommendation}`),
+      count: 1,
+    });
+  }
+
+  return Array.from(grouped.values());
+}
+
+function UploadIcon({ className }: { className?: string }) {
+  return (
+    <svg viewBox="0 0 24 24" className={className} aria-hidden>
+      <path
+        d="M12 16V5m0 0-4 4m4-4 4 4M4 15v3a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-3"
+        fill="none"
+        stroke="currentColor"
+        strokeWidth="1.8"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+    </svg>
+  );
+}
+
+function BookIcon({ className }: { className?: string }) {
+  return (
+    <svg viewBox="0 0 24 24" className={className} aria-hidden>
+      <path
+        d="M4 5.5A2.5 2.5 0 0 1 6.5 3H20v16H6.5A2.5 2.5 0 0 0 4 21V5.5Zm0 0A2.5 2.5 0 0 1 6.5 8H20"
+        fill="none"
+        stroke="currentColor"
+        strokeWidth="1.8"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+    </svg>
+  );
+}
+
+export function NormativeAnalysisView({
+  linkedSource,
+  linkedProposal,
+  autoAnalyzeOnLoad = false,
+  moduleContext = "normative",
+}: NormativeAnalysisViewProps) {
+  const inputRef = useRef<HTMLInputElement | null>(null);
+  const autoAnalyzeAttemptedRef = useRef(false);
+  const [isGuideOpen, setIsGuideOpen] = useState(false);
+  const [isDragging, setIsDragging] = useState(false);
+  const [selectedFile, setSelectedFile] = useState<File | null>(null);
+  const [documentType, setDocumentType] = useState<NormativeDocumentType>("BASES_LICITACION");
+  const [issuingEntity, setIssuingEntity] = useState(linkedProposal?.issuingEntity ?? linkedSource?.issuingEntity ?? "");
+  const [history, setHistory] = useState<NormativeAnalysisHistoryView[]>([]);
+  const [selectedHistoryId, setSelectedHistoryId] = useState<string | null>(null);
+  const [isLoadingHistory, setIsLoadingHistory] = useState(true);
+  const [isSubmitting, setIsSubmitting] = useState(false);
+  const [deletingId, setDeletingId] = useState<string | null>(null);
+  const [errorMessage, setErrorMessage] = useState<string | null>(null);
+
+  const selectedItem = useMemo(() => history.find((entry) => entry.id === selectedHistoryId) ?? null, [history, selectedHistoryId]);
+  const hasMissingContinuityContext = !linkedSource && !linkedProposal;
+  const suspiciousPatterns = useMemo(() => buildSuspiciousPatterns(selectedItem?.result ?? null), [selectedItem?.result]);
+  const criticalAlertsCount = useMemo(() => {
+    if (!selectedItem) {
+      return 0;
+    }
+
+    const criticalRequirements = selectedItem.result.criticalRequirements.filter((item) => item.severity === "alto").length;
+    const highPatterns = suspiciousPatterns.filter((item) => item.level === "alto").length;
+    return criticalRequirements + highPatterns;
+  }, [selectedItem, suspiciousPatterns]);
+  const cleanlinessIndex = useMemo(() => {
+    if (!selectedItem) {
+      return 0;
+    }
+
+    const riskPenalty = selectedItem.riskLevel === "alto" ? 30 : selectedItem.riskLevel === "medio" ? 20 : 10;
+    const raw = 100 - suspiciousPatterns.length * 18 - criticalAlertsCount * 22 - riskPenalty;
+    return Math.max(0, Math.min(100, Math.round(raw)));
+  }, [criticalAlertsCount, selectedItem, suspiciousPatterns.length]);
+
+  useEffect(() => {
+    setIssuingEntity(linkedProposal?.issuingEntity ?? linkedSource?.issuingEntity ?? "");
+  }, [linkedProposal?.issuingEntity, linkedSource?.issuingEntity]);
+
+  useEffect(() => {
+    autoAnalyzeAttemptedRef.current = false;
+  }, [linkedSource?.id, linkedProposal?.id]);
+
+  useEffect(() => {
+    let isMounted = true;
+
+    async function loadHistory() {
+      setIsLoadingHistory(true);
+      try {
+        const historyUrl = linkedProposal?.id
+          ? `/api/normative-analysis/history?take=50&proposalId=${encodeURIComponent(linkedProposal.id)}`
+          : linkedSource?.id
+            ? `/api/normative-analysis/history?take=50&sourceId=${encodeURIComponent(linkedSource.id)}`
+            : "/api/normative-analysis/history?take=50";
+        const response = await fetch(historyUrl);
+        const payload = (await response.json().catch(() => ({}))) as HistoryApiPayload;
+
+        if (!response.ok || !payload.ok || !payload.items) {
+          if (isMounted) {
+            setErrorMessage(payload.error ?? "No fue posible cargar el historial de analisis.");
+          }
+          return;
+        }
+
+        if (!isMounted) {
+          return;
+        }
+
+        setHistory(payload.items);
+        const preferredBySource = linkedSource ? payload.items.find((item) => item.sourceLicitationId === linkedSource.id) ?? null : null;
+        setSelectedHistoryId(preferredBySource?.id ?? payload.items[0]?.id ?? null);
+      } catch {
+        if (isMounted) {
+          setErrorMessage("No fue posible cargar el historial de analisis.");
+        }
+      } finally {
+        if (isMounted) {
+          setIsLoadingHistory(false);
+        }
+      }
+    }
+
+    loadHistory();
+    return () => {
+      isMounted = false;
+    };
+  }, [linkedSource, linkedProposal]);
+
+  function onFileSelected(file: File | null) {
+    if (!file) {
+      setSelectedFile(null);
+      return;
+    }
+
+    if (!file.name.toLowerCase().endsWith(".pdf")) {
+      setErrorMessage("Solo se permiten archivos PDF.");
+      return;
+    }
+
+    if (file.size > MAX_UPLOAD_BYTES) {
+      setErrorMessage("El archivo excede el limite de 20MB.");
+      return;
+    }
+
+    setErrorMessage(null);
+    setSelectedFile(file);
+  }
+
+  const handleAnalyzeProposalDocument = useCallback(async () => {
+    if (!linkedProposal?.id) {
+      setErrorMessage("No hay una propuesta de Modulo 5 vinculada para analisis automatico.");
+      return false;
+    }
+
+    setErrorMessage(null);
+    setIsSubmitting(true);
+
+    try {
+      const formData = new FormData();
+      formData.append("documentType", documentType);
+      if (issuingEntity.trim()) {
+        formData.append("issuingEntity", issuingEntity.trim());
+      }
+      formData.append("sourceProposalId", linkedProposal.id);
+      if (linkedSource?.id) {
+        formData.append("sourceLicitationId", linkedSource.id);
+      }
+      formData.append("useSourceDocument", "1");
+
+      const response = await fetch("/api/normative-analysis", {
+        method: "POST",
+        body: formData,
+      });
+
+      const payload = (await response.json().catch(() => null)) as AnalyzeApiPayload | null;
+      if (!response.ok || !payload?.ok || !payload.item) {
+        const suffix = payload?.code ? ` [${payload.code}]` : "";
+        setErrorMessage((payload?.error ?? "No fue posible analizar el documento principal de Modulo 5.") + suffix);
+        return false;
+      }
+
+      setHistory((previous) => [payload.item as NormativeAnalysisHistoryView, ...previous.filter((item) => item.id !== payload.item?.id)]);
+      setSelectedHistoryId(payload.item.id);
+      setSelectedFile(null);
+      if (inputRef.current) {
+        inputRef.current.value = "";
+      }
+      return true;
+    } catch {
+      setErrorMessage("No fue posible enviar el documento principal de Modulo 5 para analisis.");
+      return false;
+    } finally {
+      setIsSubmitting(false);
+    }
+  }, [documentType, issuingEntity, linkedProposal?.id, linkedSource?.id]);
+
+  const handleAnalyzeSourceDocument = useCallback(async () => {
+    if (!linkedSource?.id) {
+      setErrorMessage("No hay una oportunidad de Modulo 3 vinculada para analisis automatico.");
+      return false;
+    }
+
+    setErrorMessage(null);
+    setIsSubmitting(true);
+
+    try {
+      const formData = new FormData();
+      formData.append("documentType", documentType);
+      if (issuingEntity.trim()) {
+        formData.append("issuingEntity", issuingEntity.trim());
+      }
+      formData.append("sourceLicitationId", linkedSource.id);
+      formData.append("useSourceDocument", "1");
+
+      const response = await fetch("/api/normative-analysis", {
+        method: "POST",
+        body: formData,
+      });
+
+      const payload = (await response.json().catch(() => null)) as AnalyzeApiPayload | null;
+      if (!response.ok || !payload?.ok || !payload.item) {
+        const suffix = payload?.code ? ` [${payload.code}]` : "";
+        setErrorMessage((payload?.error ?? "No fue posible analizar el documento principal de Modulo 3.") + suffix);
+        return false;
+      }
+
+      setHistory((previous) => [payload.item as NormativeAnalysisHistoryView, ...previous.filter((item) => item.id !== payload.item?.id)]);
+      setSelectedHistoryId(payload.item.id);
+      setSelectedFile(null);
+      if (inputRef.current) {
+        inputRef.current.value = "";
+      }
+      return true;
+    } catch {
+      setErrorMessage("No fue posible enviar el documento principal para analisis.");
+      return false;
+    } finally {
+      setIsSubmitting(false);
+    }
+  }, [documentType, issuingEntity, linkedSource?.id]);
+
+  async function handleAnalyze() {
+    if (!selectedFile && linkedProposal?.id) {
+      await handleAnalyzeProposalDocument();
+      return;
+    }
+
+    if (!selectedFile && linkedSource?.id) {
+      await handleAnalyzeSourceDocument();
+      return;
+    }
+
+    if (!selectedFile) {
+      setErrorMessage("Selecciona un documento PDF para continuar.");
+      return;
+    }
+
+    setErrorMessage(null);
+    setIsSubmitting(true);
+
+    try {
+      const formData = new FormData();
+      formData.append("file", selectedFile);
+      formData.append("documentType", documentType);
+      if (issuingEntity.trim()) {
+        formData.append("issuingEntity", issuingEntity.trim());
+      }
+      if (linkedSource?.id) {
+        formData.append("sourceLicitationId", linkedSource.id);
+      }
+      if (linkedProposal?.id) {
+        formData.append("sourceProposalId", linkedProposal.id);
+      }
+
+      const response = await fetch("/api/normative-analysis", {
+        method: "POST",
+        body: formData,
+      });
+
+      const payload = (await response.json().catch(() => null)) as AnalyzeApiPayload | null;
+
+      if (!response.ok || !payload?.ok || !payload.item) {
+        const suffix = payload?.code ? ` [${payload.code}]` : "";
+        setErrorMessage((payload?.error ?? "No fue posible analizar el documento.") + suffix);
+        return;
+      }
+
+      setHistory((previous) => [payload.item as NormativeAnalysisHistoryView, ...previous.filter((item) => item.id !== payload.item?.id)]);
+      setSelectedHistoryId(payload.item.id);
+      setSelectedFile(null);
+      if (inputRef.current) {
+        inputRef.current.value = "";
+      }
+    } catch {
+      setErrorMessage("No fue posible enviar el archivo para analisis.");
+    } finally {
+      setIsSubmitting(false);
+    }
+  }
+
+  useEffect(() => {
+    const hasLinkedContext = Boolean(linkedProposal?.id || linkedSource?.id);
+
+    if (!autoAnalyzeOnLoad || !hasLinkedContext || isLoadingHistory || isSubmitting || autoAnalyzeAttemptedRef.current) {
+      return;
+    }
+
+    const hasMatchingHistory = linkedSource?.id ? history.some((item) => item.sourceLicitationId === linkedSource.id) : false;
+    if (hasMatchingHistory) {
+      return;
+    }
+
+    autoAnalyzeAttemptedRef.current = true;
+    if (linkedProposal?.id) {
+      void handleAnalyzeProposalDocument();
+      return;
+    }
+
+    void handleAnalyzeSourceDocument();
+  }, [
+    autoAnalyzeOnLoad,
+    handleAnalyzeProposalDocument,
+    handleAnalyzeSourceDocument,
+    history,
+    isLoadingHistory,
+    isSubmitting,
+    linkedProposal?.id,
+    linkedSource?.id,
+  ]);
+
+  async function handleDeleteHistoryItem(id: string) {
+    setDeletingId(id);
+    setErrorMessage(null);
+
+    try {
+      const response = await fetch(`/api/normative-analysis/history/${encodeURIComponent(id)}`, {
+        method: "DELETE",
+      });
+      const payload = (await response.json().catch(() => ({}))) as DeleteApiPayload;
+
+      if (!response.ok || !payload.ok) {
+        setErrorMessage(payload.error ?? "No fue posible eliminar el analisis.");
+        return;
+      }
+
+      setHistory((previous) => {
+        const next = previous.filter((item) => item.id !== id);
+        setSelectedHistoryId((current) => (current === id ? next[0]?.id ?? null : current));
+        return next;
+      });
+    } catch {
+      setErrorMessage("No fue posible eliminar el analisis.");
+    } finally {
+      setDeletingId(null);
+    }
+  }
+
+  if (moduleContext === "candados") {
+    const activeFileName = selectedFile?.name ?? selectedItem?.fileName ?? "";
+    const extractedWords = selectedItem ? Math.max(0, Math.round(selectedItem.extractedChars / 5)) : 0;
+
+    return (
+      <div className="space-y-4">
+        {hasMissingContinuityContext ? (
+          <p className="rounded-xl border border-[#f0deb0] bg-[#fff8e9] px-3 py-2 text-sm text-[#8d6308]">
+            Advertencia de continuidad: estas analizando sin fuente vinculada de M3/M5; guarda el origen para mantener trazabilidad entre modulos.
+          </p>
+        ) : null}
+
+        <div className="grid gap-3 rounded-xl border border-[#d8e0ec] bg-[#f4f7fb] p-2 md:grid-cols-2">
+          <div className="flex items-center justify-center rounded-lg bg-white px-3 py-2 text-sm font-semibold text-[#13284d]">Analisis de Bases</div>
+          <div className="flex items-center justify-center rounded-lg px-3 py-2 text-sm font-semibold text-[#5f7090]">Evaluacion de Viabilidad</div>
+        </div>
+
+        <Card>
+          <CardContent className="space-y-4 p-4">
+            <div>
+              <h3 className="text-2xl font-semibold text-[#152949] [font-family:var(--font-display)]">Analizar Bases de Licitacion</h3>
+              <p className="text-base text-[#5f7090]">Sube el PDF de las bases para detectar indicios de direccionamiento, favoritismo o candados indebidos.</p>
+            </div>
+
+            <div className="grid gap-2 md:grid-cols-2">
+              <button
+                type="button"
+                className="rounded-lg border border-[#d7dfed] bg-[#f8fbff] px-4 py-2 text-sm font-semibold text-[#17305a]"
+                onClick={() => inputRef.current?.click()}
+              >
+                Subir PDF
+              </button>
+              <div className="rounded-lg border border-[#e2e8f3] bg-[#f8fbff] px-4 py-2 text-center text-sm font-semibold text-[#7c8da8]">Pegar Texto</div>
+            </div>
+
+            <div
+              className={cn(
+                "rounded-xl border-2 border-dashed p-4 transition",
+                isDragging ? "border-[#365ea7] bg-[#eff4ff]" : "border-[#d2dceb] bg-[#fcfdff]",
+              )}
+              onDragOver={(event) => {
+                event.preventDefault();
+                setIsDragging(true);
+              }}
+              onDragLeave={() => setIsDragging(false)}
+              onDrop={(event) => {
+                event.preventDefault();
+                setIsDragging(false);
+                onFileSelected(event.dataTransfer.files?.[0] ?? null);
+              }}
+              onClick={() => inputRef.current?.click()}
+            >
+              {activeFileName ? (
+                <div className="flex items-center justify-between gap-3">
+                  <div className="min-w-0">
+                    <p className="truncate text-lg font-semibold text-[#1a2d4f]">{activeFileName}</p>
+                    {extractedWords > 0 ? <p className="text-sm text-[#5f7090]">{extractedWords} palabras extraidas</p> : null}
+                  </div>
+                  <Button size="sm" variant="secondary" onClick={() => inputRef.current?.click()}>
+                    Cambiar
+                  </Button>
+                </div>
+              ) : (
+                <div className="text-center">
+                  <p className="text-lg font-semibold text-[#1d2d4b]">Arrastra tu documento aqui</p>
+                  <p className="text-sm text-[#5f7190]">o haz clic para seleccionar</p>
+                  <p className="text-sm text-[#5f7190]">Solo archivos PDF (max. 20MB)</p>
+                </div>
+              )}
+            </div>
+
+            <input
+              ref={inputRef}
+              type="file"
+              accept="application/pdf,.pdf"
+              className="hidden"
+              onChange={(event) => onFileSelected(event.target.files?.[0] ?? null)}
+            />
+
+            {errorMessage ? <p className="text-sm font-semibold text-[#c53a4c]">{errorMessage}</p> : null}
+
+            <div className="flex justify-end">
+              <Button onClick={handleAnalyze} disabled={isSubmitting}>
+                {isSubmitting ? "Escaneando..." : "Escanear Documento"}
+              </Button>
+            </div>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="space-y-4 p-4">
+            <div className="grid gap-4 md:grid-cols-3">
+              <div className="text-center">
+                <p className="text-5xl font-semibold text-[#13284d]">{cleanlinessIndex}%</p>
+                <p className="text-sm text-[#5f7090]">Indice de Limpieza</p>
+                <div className="mx-auto mt-2 h-2 w-full max-w-[240px] overflow-hidden rounded-full bg-[#dbe3ef]">
+                  <div className="h-full bg-gradient-to-r from-[#1f3f84] to-[#2bb67f]" style={{ width: `${Math.max(5, cleanlinessIndex)}%` }} />
+                </div>
+              </div>
+              <div className="text-center">
+                <p className="text-5xl font-semibold text-[#13284d]">{suspiciousPatterns.length}</p>
+                <p className="text-sm text-[#5f7090]">Patrones Detectados</p>
+              </div>
+              <div className="text-center">
+                <p className="text-5xl font-semibold text-[#13284d]">{criticalAlertsCount}</p>
+                <p className="text-sm text-[#5f7090]">Alertas Criticas</p>
+              </div>
+            </div>
+          </CardContent>
+        </Card>
+
+        <section className="space-y-3">
+          <p className="text-2xl font-semibold text-[#13284d] [font-family:var(--font-display)]">Patrones Sospechosos ({suspiciousPatterns.length})</p>
+          {suspiciousPatterns.length === 0 ? (
+            <Card>
+              <CardContent className="py-6 text-sm text-[#60718f]">Escanea un documento para ver riesgos y candados detectados.</CardContent>
+            </Card>
+          ) : (
+            suspiciousPatterns.map((pattern) => (
+              <div
+                key={pattern.key}
+                className={cn(
+                  "rounded-xl border p-4",
+                  pattern.level === "alto" ? "border-[#f3c0c8] bg-[#fff9fa]" : "border-[#f0deb0] bg-[#fffdf5]",
+                )}
+              >
+                <div className="flex flex-wrap items-center justify-between gap-2">
+                  <p className="text-xl font-semibold text-[#1a2d4f]">&quot;{pattern.phrase}&quot;</p>
+                  <div className="flex flex-wrap items-center gap-2 text-sm font-semibold">
+                    <span className={cn("rounded-full border px-3 py-0.5", getRiskBadgeTone(pattern.level))}>{pattern.level}</span>
+                    <span className="rounded-full bg-[#24a575] px-3 py-0.5 text-white">{pattern.category}</span>
+                    <span className="rounded-full border border-[#d4deeb] bg-white px-3 py-0.5 text-[#344c72]">{pattern.count}x</span>
+                  </div>
+                </div>
+                <p className="mt-2 text-base text-[#5f7090]">{pattern.description}</p>
+              </div>
+            ))
+          )}
+        </section>
+      </div>
+    );
+  }
+
+  return (
+    <div className="grid gap-4 lg:grid-cols-[minmax(0,1fr)_minmax(0,1.6fr)]">
+      <section className="space-y-4">
+        {hasMissingContinuityContext ? (
+          <p className="rounded-xl border border-[#f0deb0] bg-[#fff8e9] px-3 py-2 text-sm text-[#8d6308]">
+            Advertencia de continuidad: no hay contexto vinculado de M3 o M5. Si continuas, el historial puede quedar sin linea de origen.
+          </p>
+        ) : null}
+
+        {linkedProposal ? (
+          <Card className="border-[#c8e3da] bg-[#edf8f3]">
+            <CardContent className="space-y-1 p-4">
+              <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#2f6e59]">Propuesta vinculada (M5)</p>
+              <p className="text-sm font-semibold text-[#194736]">{linkedProposal.title}</p>
+              {linkedProposal.issuingEntity ? <p className="text-sm text-[#3f7a66]">{linkedProposal.issuingEntity}</p> : null}
+            </CardContent>
+          </Card>
+        ) : null}
+
+        {linkedSource ? (
+          <Card className="border-[#cfe0fb] bg-[#edf4ff]">
+            <CardContent className="space-y-1 p-4">
+              <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#395a93]">Oportunidad origen (M3)</p>
+              <p className="text-sm font-semibold text-[#1d335a]">{linkedSource.title}</p>
+              {linkedSource.issuingEntity ? <p className="text-sm text-[#58709a]">{linkedSource.issuingEntity}</p> : null}
+            </CardContent>
+          </Card>
+        ) : null}
+
+        <Card className="border-[#bdd4f5] bg-[#eef4ff]">
+          <CardContent className="space-y-2 p-4">
+            <button type="button" className="flex w-full items-center justify-between text-left" onClick={() => setIsGuideOpen((previous) => !previous)}>
+              <span className="text-xl font-semibold text-[#1f3f84]">Guia para mejores resultados</span>
+              <span className="text-xl text-[#1f3f84]">{isGuideOpen ? "˄" : "˅"}</span>
+            </button>
+            <p className="text-sm text-[#38517c]">Como preparar tu documento para un analisis exitoso?</p>
+            {isGuideOpen ? (
+              <div className="rounded-lg border border-[#c8d9f4] bg-white p-3 text-sm text-[#425c89]">
+                Asegura que el PDF sea legible, incluya fechas y anexos completos, y de preferencia no sea un escaneo borroso. Si el documento contiene tablas o
+                requisitos tecnicos, sube la version mas reciente.
+              </div>
+            ) : null}
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="space-y-4 p-4">
+            <div>
+              <h3 className="text-4xl font-semibold text-[#1a2b48] [font-family:var(--font-display)]">Analizar Documento Normativo</h3>
+              <p className="mt-1 text-base text-[#5f7090]">Sube bases de licitacion, convocatorias, reglamentos o leyes para obtener un analisis inteligente.</p>
+            </div>
+
+            <button
+              type="button"
+              className={cn(
+                "flex w-full flex-col items-center justify-center rounded-xl border-2 border-dashed px-4 py-8 text-center transition",
+                isDragging ? "border-[#365ea7] bg-[#eff4ff]" : "border-[#cfd8e9] bg-[#fbfdff]",
+              )}
+              onDragOver={(event) => {
+                event.preventDefault();
+                setIsDragging(true);
+              }}
+              onDragLeave={() => setIsDragging(false)}
+              onDrop={(event) => {
+                event.preventDefault();
+                setIsDragging(false);
+                onFileSelected(event.dataTransfer.files?.[0] ?? null);
+              }}
+              onClick={() => inputRef.current?.click()}
+            >
+              <UploadIcon className="h-12 w-12 text-[#5a6f95]" />
+              <p className="mt-3 text-xl font-semibold text-[#1d2d4b]">{selectedFile ? selectedFile.name : "Arrastra tu documento aqui"}</p>
+              <p className="mt-2 text-sm text-[#5f7190]">o haz clic para seleccionar</p>
+              <p className="mt-1 text-sm text-[#5f7190]">Solo archivos PDF (max. 20MB)</p>
+            </button>
+
+            <input
+              ref={inputRef}
+              type="file"
+              accept="application/pdf,.pdf"
+              className="hidden"
+              onChange={(event) => onFileSelected(event.target.files?.[0] ?? null)}
+            />
+
+            <div className="grid gap-3 md:grid-cols-2">
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Tipo de Documento
+                <select
+                  value={documentType}
+                  onChange={(event) => setDocumentType(event.target.value as NormativeDocumentType)}
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                >
+                  {documentTypeOptions.map((option) => (
+                    <option key={option.value} value={option.value}>
+                      {option.label}
+                    </option>
+                  ))}
+                </select>
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Entidad Emisora (opcional)
+                <input
+                  value={issuingEntity}
+                  onChange={(event) => setIssuingEntity(event.target.value)}
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                  placeholder="Ej: IMSS, CFE, Gobierno"
+                />
+              </label>
+            </div>
+
+            {errorMessage ? <p className="text-sm font-semibold text-[#c53a4c]">{errorMessage}</p> : null}
+            {!selectedFile && linkedProposal?.id ? (
+              <p className="text-xs font-semibold text-[#506891]">
+                Sin archivo cargado, se analizara primero el PDF de la propuesta (M5). Si no existe, se usara el documento principal de M3 cuando este disponible.
+              </p>
+            ) : !selectedFile && linkedSource?.id ? (
+              <p className="text-xs font-semibold text-[#506891]">Sin archivo cargado, se analizara automaticamente el PDF principal vinculado desde Modulo 3.</p>
+            ) : null}
+
+            <div className="flex justify-end">
+              <Button onClick={handleAnalyze} disabled={isSubmitting}>
+                {isSubmitting
+                  ? "Analizando..."
+                  : !selectedFile && linkedProposal?.id
+                    ? "Analizar PDF de propuesta (M5)"
+                    : !selectedFile && linkedSource?.id
+                      ? "Analizar PDF principal (M3)"
+                      : "Analizar con IA"}
+              </Button>
+            </div>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="space-y-3 p-4">
+            <div>
+              <h3 className="text-5xl font-semibold text-[#13274e] [font-family:var(--font-display)]">Historial de Analisis</h3>
+              <p className="text-base text-[#5f7190]">{history.length} documentos analizados</p>
+            </div>
+
+            {isLoadingHistory ? <p className="text-sm text-[#60718f]">Cargando historial...</p> : null}
+
+            {!isLoadingHistory && history.length === 0 ? (
+              <p className="text-sm text-[#60718f]">Todavia no hay analisis guardados para esta cuenta.</p>
+            ) : null}
+
+            {history.length > 0 ? (
+              <div className="max-h-[620px] space-y-2 overflow-auto pr-1">
+                {history.map((item) => (
+                  <div
+                    key={item.id}
+                    className={cn(
+                      "rounded-xl border p-3",
+                      selectedHistoryId === item.id ? "border-[#89aee8] bg-[#edf4ff]" : "border-[#dce4f1] bg-white",
+                    )}
+                  >
+                    <div className="flex items-start justify-between gap-2">
+                      <button type="button" className="min-w-0 flex-1 text-left" onClick={() => setSelectedHistoryId(item.id)}>
+                        <div className="flex flex-wrap items-center gap-2">
+                          <p className="truncate text-lg font-semibold text-[#1f304f]">{item.fileName}</p>
+                          <span className={`inline-flex rounded-full border px-2 py-0.5 text-xs font-semibold ${getViabilityBadgeTone(item.viabilityScore)}`}>
+                            {item.riskLevel}
+                          </span>
+                        </div>
+                        <p className="mt-1 text-sm text-[#60718f]">
+                          {getDocumentTypeLabel(item.documentType)} · {formatDateTime(item.analyzedAt)}
+                        </p>
+                        <p className="mt-1 text-sm font-semibold text-[#233a62]">Viabilidad: {item.viabilityScore}%</p>
+                      </button>
+                      <button
+                        type="button"
+                        className="rounded-md px-2 py-1 text-sm text-[#6a7d9c] transition hover:bg-[#e8eef9]"
+                        onClick={() => handleDeleteHistoryItem(item.id)}
+                        disabled={deletingId === item.id}
+                      >
+                        {deletingId === item.id ? "..." : "🗑"}
+                      </button>
+                    </div>
+                  </div>
+                ))}
+              </div>
+            ) : null}
+          </CardContent>
+        </Card>
+      </section>
+
+      <section>
+        <Card className="min-h-[600px] border-dashed border-[#d1dae8] bg-[#f9fbff]">
+          <CardContent className="h-full p-6">
+            {!selectedItem ? (
+              <div className="flex h-full min-h-[540px] flex-col items-center justify-center text-center">
+                <BookIcon className="h-16 w-16 text-[#b0bccf]" />
+                <p className="mt-6 text-3xl font-semibold text-[#1b2d4e] [font-family:var(--font-display)]">Sin analisis seleccionado</p>
+                <p className="mt-2 max-w-md text-base text-[#60718f]">Sube un documento para analizarlo o selecciona uno del historial para ver resultados.</p>
+              </div>
+            ) : (
+              <div className="space-y-4">
+                <div className="grid gap-3 lg:grid-cols-2">
+                  <Card className="border-[#d6e0ef] bg-white">
+                    <CardContent className="p-4">
+                      <p className="text-sm font-semibold text-[#20345a]">Viabilidad de Participacion</p>
+                      <p className="mt-1 text-5xl font-semibold text-[#15294d]">{selectedItem.result.participationViability.score}%</p>
+                      <div className="mt-3 h-3 w-full overflow-hidden rounded-full bg-[#dce5f1]">
+                        <div
+                          className="h-full bg-gradient-to-r from-[#1f3f84] via-[#1f3f84] to-[#2bb67f]"
+                          style={{ width: `${Math.max(8, Math.min(100, selectedItem.result.participationViability.score))}%` }}
+                        />
+                      </div>
+                      <p className="mt-2 text-sm text-[#5d7090]">{selectedItem.result.participationViability.rationale}</p>
+                    </CardContent>
+                  </Card>
+
+                  <Card className="border-[#d6e0ef] bg-white">
+                    <CardContent className="p-4">
+                      <p className="text-sm font-semibold text-[#20345a]">Nivel de Riesgo</p>
+                      <div className="mt-2 flex items-center justify-between gap-2">
+                        <span className={`inline-flex rounded-full border px-4 py-1 text-4xl font-semibold ${getRiskBadgeTone(selectedItem.result.risk.level)}`}>
+                          {selectedItem.result.risk.level}
+                        </span>
+                        <span
+                          className={cn(
+                            "inline-flex h-3 w-3 rounded-full",
+                            selectedItem.result.risk.level === "alto"
+                              ? "bg-[#e34a5b]"
+                              : selectedItem.result.risk.level === "medio"
+                                ? "bg-[#d7a022]"
+                                : "bg-[#2eab78]",
+                          )}
+                        />
+                      </div>
+                      <p className="mt-3 text-sm text-[#5d7090]">{selectedItem.result.risk.description}</p>
+                    </CardContent>
+                  </Card>
+                </div>
+
+                <Card className="border-[#d6e0ef] bg-white">
+                  <CardContent className="space-y-2 p-4">
+                    <div>
+                      <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#4d648a]">Analisis activo</p>
+                      <h3 className="mt-1 text-xl font-semibold text-[#1d2f4f]">{selectedItem.fileName}</h3>
+                      <p className="mt-1 text-sm text-[#60718f]">{formatDateTime(selectedItem.analyzedAt)}</p>
+                    </div>
+                    <div className="flex flex-wrap gap-2 text-xs">
+                      <span className="rounded-full border border-[#d3deef] bg-[#f5f8ff] px-2 py-1 font-semibold text-[#355184]">
+                        {getDocumentTypeLabel(selectedItem.documentType)}
+                      </span>
+                      <span className="rounded-full border border-[#d3deef] bg-[#f5f8ff] px-2 py-1 font-semibold text-[#355184]">
+                        Metodo: {selectedItem.methodUsed.toUpperCase()}
+                      </span>
+                      <span className="rounded-full border border-[#d3deef] bg-[#f5f8ff] px-2 py-1 font-semibold text-[#355184]">
+                        Confianza: {selectedItem.confidence.toUpperCase()}
+                      </span>
+                    </div>
+                    <p className="mt-2 text-base text-[#314766]">{selectedItem.result.executiveSummary}</p>
+                  </CardContent>
+                </Card>
+
+                <div className="grid gap-3 lg:grid-cols-2">
+                  <Card className="border-[#d6e0ef] bg-white">
+                    <CardContent className="space-y-2 p-4">
+                      <div className="flex items-center justify-between gap-2">
+                        <p className="text-sm font-semibold text-[#20345a]">Valor por dinero</p>
+                        <span className={`inline-flex rounded-full border px-3 py-1 text-sm font-semibold ${getViabilityBadgeTone(selectedItem.result.valueForMoney.score)}`}>
+                          {selectedItem.result.valueForMoney.score}%
+                        </span>
+                      </div>
+                      <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#5f7190]">Senales</p>
+                      <ul className="space-y-1 text-sm text-[#5d7090]">
+                        {selectedItem.result.valueForMoney.signals.map((item, index) => (
+                          <li key={`${item}-${index}`} className="rounded-lg border border-[#e1e8f3] bg-[#f8fbff] px-3 py-2">
+                            {item}
+                          </li>
+                        ))}
+                      </ul>
+                      <p className="pt-1 text-xs font-semibold uppercase tracking-[0.08em] text-[#5f7190]">Acciones</p>
+                      <ul className="space-y-1 text-sm text-[#5d7090]">
+                        {selectedItem.result.valueForMoney.actions.map((item, index) => (
+                          <li key={`${item}-${index}`} className="rounded-lg border border-[#d1eadc] bg-[#f3fbf6] px-3 py-2">
+                            {item}
+                          </li>
+                        ))}
+                      </ul>
+                    </CardContent>
+                  </Card>
+
+                  <Card className="border-[#d6e0ef] bg-white">
+                    <CardContent className="space-y-2 p-4">
+                      <div className="flex items-center justify-between gap-2">
+                        <p className="text-sm font-semibold text-[#20345a]">Economia circular</p>
+                        <span
+                          className={`inline-flex rounded-full border px-3 py-1 text-sm font-semibold ${
+                            selectedItem.result.circularEconomy.applicable
+                              ? "border-[#b9e6cd] bg-[#eaf9f1] text-[#1f8b63]"
+                              : "border-[#d8e1ef] bg-[#f3f6fb] text-[#5f7090]"
+                          }`}
+                        >
+                          {selectedItem.result.circularEconomy.applicable ? "Aplica" : "No explicito"}
+                        </span>
+                      </div>
+                      <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#5f7190]">Senales</p>
+                      <ul className="space-y-1 text-sm text-[#5d7090]">
+                        {selectedItem.result.circularEconomy.signals.map((item, index) => (
+                          <li key={`${item}-${index}`} className="rounded-lg border border-[#e1e8f3] bg-[#f8fbff] px-3 py-2">
+                            {item}
+                          </li>
+                        ))}
+                      </ul>
+                      <p className="pt-1 text-xs font-semibold uppercase tracking-[0.08em] text-[#5f7190]">Acciones</p>
+                      <ul className="space-y-1 text-sm text-[#5d7090]">
+                        {selectedItem.result.circularEconomy.actions.map((item, index) => (
+                          <li key={`${item}-${index}`} className="rounded-lg border border-[#d1eadc] bg-[#f3fbf6] px-3 py-2">
+                            {item}
+                          </li>
+                        ))}
+                      </ul>
+                    </CardContent>
+                  </Card>
+                </div>
+
+                <details open className="rounded-xl border border-[#cce5d7] bg-[#eff9f2]">
+                  <summary className="cursor-pointer px-4 py-3 text-xl font-semibold text-[#1d335a]">
+                    Requisitos Obligatorios <span className="ml-2 rounded-full bg-[#2faf7f] px-2 py-0.5 text-sm text-white">{selectedItem.result.requiredChecklist.length}</span>
+                  </summary>
+                  <div className="space-y-3 px-4 pb-4">
+                    {selectedItem.result.requiredChecklist.map((item, index) => (
+                      <div key={`${item.title}-${index}`} className="rounded-xl border border-[#d8e1ef] bg-[#f7fafc] p-4">
+                        <p className="text-lg font-semibold text-[#152949]">{item.title}</p>
+                        <p className="mt-1 text-base text-[#5a6f92]">{item.description}</p>
+                      </div>
+                    ))}
+                  </div>
+                </details>
+
+                <details open className="rounded-xl border border-[#efdca5] bg-[#fff9ea]">
+                  <summary className="cursor-pointer px-4 py-3 text-xl font-semibold text-[#1d335a]">
+                    Requisitos Criticos <span className="ml-2 rounded-full bg-[#f0deb0] px-2 py-0.5 text-sm text-[#8d6308]">{selectedItem.result.criticalRequirements.length}</span>
+                  </summary>
+                  <div className="space-y-3 px-4 pb-4">
+                    {selectedItem.result.criticalRequirements.map((item, index) => (
+                      <div key={`${item.title}-${index}`} className="rounded-xl border border-[#efdca5] bg-[#fffef7] p-4">
+                        <div className="flex flex-wrap items-center justify-between gap-2">
+                          <p className="text-lg font-semibold text-[#152949]">{item.title}</p>
+                          <span className={`inline-flex rounded-full border px-3 py-0.5 text-sm font-semibold ${getSeverityTone(item.severity)}`}>{item.severity}</span>
+                        </div>
+                        <p className="mt-1 text-base text-[#5a6f92]">{item.description}</p>
+                      </div>
+                    ))}
+                  </div>
+                </details>
+
+                <details open className="rounded-xl border border-[#efc1c8] bg-[#fff4f6]">
+                  <summary className="cursor-pointer px-4 py-3 text-xl font-semibold text-[#1d335a]">
+                    Posibles Candados Detectados <span className="ml-2 rounded-full bg-[#f8d9de] px-2 py-0.5 text-sm text-[#ad3f4f]">{selectedItem.result.lockIns.length}</span>
+                  </summary>
+                  <div className="space-y-3 px-4 pb-4">
+                    {selectedItem.result.lockIns.map((item, index) => (
+                      <div key={`${item.title}-${index}`} className="rounded-xl border border-[#efc1c8] bg-[#fffafb] p-4">
+                        <p className="text-lg font-semibold text-[#152949]">{item.title}</p>
+                        <p className="mt-1 text-base text-[#b03f4f]">
+                          <span className="font-semibold">Impacto:</span> {item.impact}
+                        </p>
+                        <p className="mt-1 text-base text-[#1f8b63]">
+                          <span className="font-semibold">Recomendacion:</span> {item.recommendation}
+                        </p>
+                      </div>
+                    ))}
+                  </div>
+                </details>
+
+                <details open className="rounded-xl border border-[#bfe8d0] bg-[#f0faf4]">
+                  <summary className="cursor-pointer px-4 py-3 text-xl font-semibold text-[#1d335a]">
+                    Recomendaciones de Preparacion{" "}
+                    <span className="ml-2 rounded-full bg-[#ccefd9] px-2 py-0.5 text-sm text-[#1e8b63]">{selectedItem.result.preparationRecommendations.length}</span>
+                  </summary>
+                  <div className="space-y-3 px-4 pb-4">
+                    {selectedItem.result.preparationRecommendations.map((item, index) => (
+                      <div key={`${item.title}-${index}`} className="rounded-xl border border-[#cfe7d9] bg-[#f7fcf9] p-4">
+                        <div className="flex flex-wrap items-center justify-between gap-2">
+                          <p className="text-lg font-semibold text-[#152949]">{item.title}</p>
+                          <span className={`inline-flex rounded-full border px-3 py-0.5 text-sm font-semibold ${getPriorityTone(item.priority)}`}>Prioridad {item.priority}</span>
+                        </div>
+                        <p className="mt-1 text-base text-[#5a6f92]">{item.description}</p>
+                      </div>
+                    ))}
+                  </div>
+                </details>
+
+                <details open className="rounded-xl border border-[#d6e0ef] bg-white">
+                  <summary className="cursor-pointer px-4 py-3 text-xl font-semibold text-[#1d335a]">
+                    Formatos Oficiales Detectados{" "}
+                    <span className="ml-2 rounded-full bg-[#2faf7f] px-2 py-0.5 text-sm text-white">{selectedItem.result.officialFormats.length}</span>
+                  </summary>
+                  <div className="space-y-2 px-4 pb-4">
+                    {selectedItem.result.officialFormats.map((item, index) => (
+                      <div key={`${item}-${index}`} className="rounded-xl border border-[#e1e8f3] bg-[#f8fbff] p-3 text-base text-[#51688f]">
+                        {item}
+                      </div>
+                    ))}
+                  </div>
+                </details>
+
+                <details open className="rounded-xl border border-[#d6e0ef] bg-white">
+                  <summary className="cursor-pointer px-4 py-3 text-xl font-semibold text-[#1d335a]">
+                    Trazabilidad por documento{" "}
+                    <span className="ml-2 rounded-full bg-[#d9e6fb] px-2 py-0.5 text-sm text-[#2f4f87]">{selectedItem.result.sourceTraceability.length}</span>
+                  </summary>
+                  <div className="space-y-2 px-4 pb-4">
+                    {selectedItem.result.sourceTraceability.map((item, index) => (
+                      <div key={`${item.sourceLabel}-${index}`} className="rounded-xl border border-[#e1e8f3] bg-[#f8fbff] p-3">
+                        <p className="inline-flex rounded-full border border-[#c9d9f0] bg-white px-2 py-0.5 text-[11px] font-semibold text-[#315b96]">
+                          Por que este archivo
+                        </p>
+                        <p className="text-sm font-semibold text-[#1d335a]">{item.sourceLabel}</p>
+                        <p className="text-xs text-[#5f7090]">{item.documentType}</p>
+                        <p className="mt-1 text-xs text-[#4f6588]">Campos: {item.fields.join(", ") || "Sin campos reportados"}</p>
+                      </div>
+                    ))}
+                  </div>
+                </details>
+
+                <Card className="border-[#d6e0ef] bg-[#f7f9fc]">
+                  <CardContent className="flex flex-wrap items-center justify-between gap-3 p-4">
+                    <div>
+                      <p className="text-4xl font-semibold text-[#13274e] [font-family:var(--font-display)]">Listo para participar?</p>
+                      <p className="text-xl text-[#5f7090]">Con el analisis completado, prepara tu propuesta en el Modulo 5</p>
+                    </div>
+                    <Link
+                      href={
+                        selectedItem.sourceLicitationId
+                          ? `/gestion-licitaciones?sourceId=${encodeURIComponent(selectedItem.sourceLicitationId)}&autocreate=1&autofill=1`
+                          : "/gestion-licitaciones"
+                      }
+                    >
+                      <Button size="lg" className="rounded-2xl px-7">
+                        Preparar Propuesta
+                      </Button>
+                    </Link>
+                  </CardContent>
+                </Card>
+              </div>
+            )}
+          </CardContent>
+        </Card>
+      </section>
+    </div>
+  );
+}
diff --git a/src/components/app/page-shell.tsx b/src/components/app/page-shell.tsx
index 90b275b..858af22 100644
--- a/src/components/app/page-shell.tsx
+++ b/src/components/app/page-shell.tsx
@@ -3,6 +3,7 @@ import { isAdminIdentity } from "@/lib/auth/admin";
 import { KontiaMark } from "@/components/app/kontia-mark";
 import { getCurrentUser } from "@/lib/auth/user";
 import { cn } from "@/lib/utils";
+import { getHeaderVisibility, type HeaderModeRequest } from "@/lib/layout/header";
 
 type PageShellProps = {
   children: React.ReactNode;
@@ -10,98 +11,139 @@ type PageShellProps = {
   description?: string;
   action?: React.ReactNode;
   className?: string;
+  showPageHeading?: boolean;
+  headerMode?: HeaderModeRequest;
+  headerBackHref?: string;
+  headerBackLabel?: string;
+  headerNextHref?: string;
+  headerNextLabel?: string;
+  headerShowManual?: boolean;
+  headerPlanBadgeLabel?: string;
+  headerAction?: React.ReactNode;
+  headerShowLogout?: boolean;
+  contentWidth?: "default" | "wide";
 };
 
-const navLinks = [
-  { href: "/dashboard", label: "Dashboard" },
-  { href: "/diagnostic", label: "Diagnostico" },
-  { href: "/dashboard#modulos", label: "Modulos" },
-  { href: "/talleres-desarrollo", label: "Talleres" },
-  { href: "/licitations", label: "Licitaciones" },
-  { href: "/results", label: "Results" },
-  { href: "/recommendations", label: "Recommendations" },
-  { href: "/manual", label: "Manual" },
-];
+function HeaderBadge({ label }: { label: string }) {
+  return <span className="rounded-full bg-[#0f2a5f] px-4 py-1.5 text-sm font-semibold text-white">{label}</span>;
+}
 
-export async function PageShell({ children, title, description, action, className }: PageShellProps) {
+export async function PageShell({
+  children,
+  title,
+  description,
+  action,
+  className,
+  showPageHeading = true,
+  headerMode = "auto",
+  headerBackHref = "/dashboard",
+  headerBackLabel = "Volver al Dashboard",
+  headerNextHref,
+  headerNextLabel,
+  headerShowManual = false,
+  headerPlanBadgeLabel,
+  headerAction,
+  headerShowLogout = true,
+  contentWidth = "default",
+}: PageShellProps) {
   const currentUser = await getCurrentUser();
   const isAdmin = currentUser ? isAdminIdentity(currentUser.email, currentUser.role) : false;
+  const visibility = getHeaderVisibility(Boolean(currentUser), headerMode);
+  const containerClassName = contentWidth === "wide" ? "max-w-[1560px]" : "max-w-[1200px]";
 
   return (
     <div className="min-h-screen bg-[#eff2f7]">
       <header className="border-b border-[#d8dde7] bg-[#eff2f7]">
-        <div className="mx-auto flex w-full max-w-[1200px] items-center justify-between gap-3 px-4 py-3 sm:px-6 lg:px-8">
-          <Link href="/">
-            <KontiaMark />
-          </Link>
+        <div className={cn("mx-auto flex w-full items-center justify-between gap-3 px-4 py-4 sm:px-6 lg:px-8", containerClassName)}>
+          {visibility.showBackLink ? (
+            <Link href={headerBackHref} className="inline-flex items-center gap-3 text-3xl font-semibold text-[#1a2c4f] [font-family:var(--font-display)]">
+              <span className="text-2xl" aria-hidden>
+                ←
+              </span>
+              <span className="text-base font-semibold [font-family:var(--font-sans)]">{headerBackLabel}</span>
+            </Link>
+          ) : (
+            <Link href="/">
+              <KontiaMark />
+            </Link>
+          )}
 
-          <nav className="hidden items-center gap-5 md:flex">
-            {currentUser ? (
-              navLinks.map((link) => (
-                <Link
-                  key={link.href}
-                  href={link.href}
-                  className="text-sm font-medium text-[#516180] transition-colors hover:text-[#223f7c]"
-                >
-                  {link.label}
-                </Link>
-              ))
-            ) : (
-              <>
-                <Link href="/#metodologia" className="text-sm font-medium text-[#516180] transition-colors hover:text-[#223f7c]">
-                  Metodologia
-                </Link>
-                <Link href="/#modulos" className="text-sm font-medium text-[#516180] transition-colors hover:text-[#223f7c]">
-                  Modulos
-                </Link>
-                <Link href="/#beneficios" className="text-sm font-medium text-[#516180] transition-colors hover:text-[#223f7c]">
-                  Beneficios
-                </Link>
-              </>
-            )}
-            {isAdmin && currentUser ? (
-              <Link href="/admin" className="text-sm font-semibold text-[#1f3f82] transition-colors hover:text-[#17336c]">
+          {visibility.showMarketingNav ? (
+            <nav className="hidden items-center gap-10 text-base font-medium text-[#4f5f7d] lg:flex">
+              <Link href="/#metodologia" className="transition-colors hover:text-[#223f7c]">
+                Metodologia
+              </Link>
+              <Link href="/#modulos" className="transition-colors hover:text-[#223f7c]">
+                Modulos
+              </Link>
+              <Link href="/#beneficios" className="transition-colors hover:text-[#223f7c]">
+                Beneficios
+              </Link>
+              <Link href="/#contacto" className="transition-colors hover:text-[#223f7c]">
+                Contacto
+              </Link>
+            </nav>
+          ) : null}
+
+          <div className="flex items-center gap-2 sm:gap-3">
+            {visibility.showUserControls && headerShowManual ? (
+              <Link href="/manual" className="inline-flex h-11 items-center gap-2 rounded-2xl border border-[#cfd8e7] bg-[#f7f9fd] px-5 text-sm font-semibold text-[#1a2d51] transition hover:bg-white">
+                <span aria-hidden>◧</span>
+                Manual
+              </Link>
+            ) : null}
+
+            {visibility.showUserControls && headerNextHref && headerNextLabel ? (
+              <Link href={headerNextHref} className="inline-flex items-center gap-2 text-sm font-semibold text-[#445d86] hover:text-[#1f3f84]">
+                {headerNextLabel}
+                <span aria-hidden>→</span>
+              </Link>
+            ) : null}
+
+            {visibility.showUserControls && headerAction ? headerAction : null}
+            {visibility.showUserControls && headerPlanBadgeLabel ? <HeaderBadge label={headerPlanBadgeLabel} /> : null}
+
+            {isAdmin && currentUser && visibility.mode === "app" ? (
+              <Link href="/admin" className="rounded-xl border border-[#cfd8e7] px-3 py-2 text-sm font-semibold text-[#2f486f] transition-colors hover:bg-white">
                 Admin
               </Link>
             ) : null}
-          </nav>
 
-          {currentUser ? (
-            <div className="flex items-center gap-2">
-              <p className="hidden text-xs font-semibold text-[#5f6c84] sm:block">{currentUser.email}</p>
+            {visibility.showUserControls && headerShowLogout ? (
               <form action="/api/auth/logout" method="post">
                 <button
                   type="submit"
-                  className="rounded-xl border border-[#ccd6e5] px-3 py-1.5 text-xs font-semibold text-[#334a73] transition-colors hover:bg-white"
+                  className="inline-flex h-11 items-center rounded-2xl border border-[#ccd6e5] px-4 text-sm font-semibold text-[#334a73] transition-colors hover:bg-white"
                 >
-                  Logout
+                  Salir
                 </button>
               </form>
-            </div>
-          ) : (
-            <div className="flex items-center gap-2 text-xs font-semibold text-[#5f6c84]">
-              <Link href="/login" className="rounded-xl px-3 py-2 text-sm font-semibold text-[#13254a] transition-colors hover:text-[#214485]">
-                Iniciar Sesion
-              </Link>
-              <Link
-                href="/register"
-                className="rounded-2xl bg-[#1f3f84] px-4 py-2 text-sm font-semibold text-white transition-colors hover:bg-[#17356f]"
-              >
-                Comenzar Gratis
-              </Link>
-            </div>
-          )}
+            ) : null}
+
+            {visibility.showAuthButtons ? (
+              <>
+                <Link href="/login" className="rounded-xl px-3 py-2 text-sm font-semibold text-[#13254a] transition-colors hover:text-[#214485]">
+                  Iniciar Sesion
+                </Link>
+                <Link href="/register" className="rounded-2xl bg-[#1f3f84] px-4 py-2 text-sm font-semibold text-white transition-colors hover:bg-[#17356f]">
+                  Comenzar Gratis
+                </Link>
+              </>
+            ) : null}
+          </div>
         </div>
       </header>
 
-      <main className="mx-auto w-full max-w-[1200px] px-4 py-8 sm:px-6 lg:px-8">
-        <section className="mb-6 flex flex-wrap items-end justify-between gap-3">
-          <div>
-            <h1 className="text-4xl font-semibold text-[#142447] [font-family:var(--font-display)] md:text-5xl">{title}</h1>
-            {description ? <p className="mt-1 text-sm text-[#60718f]">{description}</p> : null}
-          </div>
-          {action ? <div>{action}</div> : null}
-        </section>
+      <main className={cn("mx-auto w-full px-4 py-8 sm:px-6 lg:px-8", containerClassName)}>
+        {showPageHeading ? (
+          <section className="mb-6 flex flex-wrap items-end justify-between gap-3">
+            <div>
+              <h1 className="text-3xl font-semibold text-[#142447] [font-family:var(--font-display)] md:text-4xl">{title}</h1>
+              {description ? <p className="mt-1 text-sm text-[#60718f]">{description}</p> : null}
+            </div>
+            {action ? <div>{action}</div> : null}
+          </section>
+        ) : null}
 
         <section className={cn("space-y-4", className)}>{children}</section>
       </main>
diff --git a/src/components/app/preventive-dossier-view.tsx b/src/components/app/preventive-dossier-view.tsx
new file mode 100644
index 0000000..c763055
--- /dev/null
+++ b/src/components/app/preventive-dossier-view.tsx
@@ -0,0 +1,779 @@
+"use client";
+
+import Link from "next/link";
+import { useMemo, useState } from "react";
+import { AUDIT_QUESTIONNAIRE } from "@/lib/audits/scoring";
+import type {
+  AuditKpiSnapshot,
+  AuditSimulationView,
+  InstitutionalDossierFreshness,
+  InstitutionalDossierLoadStrategy,
+  InstitutionalDossierPayload,
+} from "@/lib/audits/types";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+import { Dialog } from "@/components/ui/dialog";
+import { Tabs } from "@/components/ui/tabs";
+
+type PreventiveDossierViewProps = {
+  initialSimulations: AuditSimulationView[];
+  initialKpis: AuditKpiSnapshot;
+  initialDossier: InstitutionalDossierPayload | null;
+  initialFreshness: InstitutionalDossierFreshness | null;
+};
+
+type ApiPayload = {
+  ok?: boolean;
+  error?: string;
+  simulations?: AuditSimulationView[];
+  simulation?: AuditSimulationView;
+  kpis?: AuditKpiSnapshot;
+  dossier?: InstitutionalDossierPayload;
+  freshness?: InstitutionalDossierFreshness;
+};
+
+type AuditAiFindings = {
+  auditorLikelyFindings: {
+    area: string;
+    finding: string;
+    severity: "alto" | "medio" | "bajo";
+  }[];
+  missingEvidence: string[];
+  topRisks: string[];
+  remediationPlan: {
+    step: string;
+    priority: "alta" | "media" | "baja";
+    ownerSuggestion: string;
+    targetDate: string;
+  }[];
+  confidence: "low" | "medium" | "high";
+};
+
+function formatDate(value: string | null) {
+  if (!value) {
+    return "Sin fecha";
+  }
+
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return "Sin fecha";
+  }
+
+  return parsed.toLocaleString("es-MX", {
+    year: "numeric",
+    month: "short",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+}
+
+function formatFileSize(bytes: number) {
+  if (!Number.isFinite(bytes) || bytes <= 0) {
+    return "N/D";
+  }
+
+  if (bytes < 1024) {
+    return `${bytes} B`;
+  }
+
+  if (bytes < 1024 * 1024) {
+    return `${(bytes / 1024).toFixed(1)} KB`;
+  }
+
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+export function PreventiveDossierView({ initialSimulations, initialKpis, initialDossier, initialFreshness }: PreventiveDossierViewProps) {
+  const [simulations, setSimulations] = useState(initialSimulations);
+  const [kpis, setKpis] = useState(initialKpis);
+  const [dossier, setDossier] = useState(initialDossier);
+  const [freshness, setFreshness] = useState<InstitutionalDossierFreshness | null>(initialFreshness);
+  const [selectedSimulationId, setSelectedSimulationId] = useState(initialSimulations[0]?.id ?? "");
+
+  const [newSimulation, setNewSimulation] = useState({
+    name: "",
+    auditType: "Preventiva integral",
+  });
+
+  const [answers, setAnswers] = useState<Record<string, string>>(() =>
+    Object.fromEntries(AUDIT_QUESTIONNAIRE.map((question) => [question.key, "si"])),
+  );
+
+  const [isBusy, setIsBusy] = useState(false);
+  const [message, setMessage] = useState<string | null>(null);
+  const [errorMessage, setErrorMessage] = useState<string | null>(null);
+  const [isLoadingAiFindings, setIsLoadingAiFindings] = useState(false);
+  const [aiFindings, setAiFindings] = useState<AuditAiFindings | null>(null);
+  const [aiSuggestionId, setAiSuggestionId] = useState<string | null>(null);
+
+  const continuityWarnings = useMemo(() => {
+    if (!dossier) {
+      return [];
+    }
+
+    const missingComponents = dossier.components
+      .filter((component) => component.totalItems > 0 && component.withEvidence < component.totalItems)
+      .map((component) => `Continuidad incompleta en ${component.label}: ${component.withEvidence}/${component.totalItems} con evidencia.`);
+
+    return missingComponents;
+  }, [dossier]);
+
+  const selectedSimulation = useMemo(
+    () => simulations.find((item) => item.id === selectedSimulationId) ?? null,
+    [simulations, selectedSimulationId],
+  );
+
+  async function reloadSimulations() {
+    const response = await fetch("/api/audits/simulations");
+    const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+    if (!response.ok || !payload.ok || !payload.simulations || !payload.kpis) {
+      throw new Error(payload.error ?? "No fue posible recargar simulaciones.");
+    }
+
+    setSimulations(payload.simulations);
+    setKpis(payload.kpis);
+
+    if (!selectedSimulationId && payload.simulations[0]?.id) {
+      setSelectedSimulationId(payload.simulations[0].id);
+    }
+  }
+
+  async function createSimulation() {
+    setIsBusy(true);
+    setErrorMessage(null);
+
+    try {
+      const response = await fetch("/api/audits/simulations", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify(newSimulation),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok || !payload.simulation) {
+        setErrorMessage(payload.error ?? "No fue posible crear la simulacion.");
+        return;
+      }
+
+      setNewSimulation({
+        name: "",
+        auditType: "Preventiva integral",
+      });
+      setSelectedSimulationId(payload.simulation.id);
+      setMessage("Simulacion creada.");
+      await reloadSimulations();
+    } catch {
+      setErrorMessage("No fue posible crear la simulacion.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function scoreSimulation() {
+    if (!selectedSimulationId) {
+      setErrorMessage("Selecciona una simulacion para calificar.");
+      return;
+    }
+
+    setIsBusy(true);
+    setErrorMessage(null);
+
+    try {
+      const response = await fetch(`/api/audits/simulations/${encodeURIComponent(selectedSimulationId)}/score`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          responses: AUDIT_QUESTIONNAIRE.map((question) => ({
+            questionKey: question.key,
+            answer: answers[question.key] ?? "si",
+            evidenceRefs: [],
+          })),
+        }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok || !payload.simulation) {
+        setErrorMessage(payload.error ?? "No fue posible calcular la simulacion.");
+        return;
+      }
+
+      setMessage("Simulacion calificada.");
+      await reloadSimulations();
+    } catch {
+      setErrorMessage("No fue posible calcular la simulacion.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function loadDossier(strategy: InstitutionalDossierLoadStrategy) {
+    setIsBusy(true);
+    setErrorMessage(null);
+
+    try {
+      const response = await fetch(`/api/audits/expediente?strategy=${encodeURIComponent(strategy)}`);
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok || !payload.dossier || !payload.freshness) {
+        setErrorMessage(payload.error ?? "No fue posible cargar el expediente.");
+        return;
+      }
+
+      setDossier(payload.dossier);
+      setFreshness(payload.freshness);
+      setMessage(
+        payload.freshness.source === "snapshot"
+          ? "Expediente cargado desde snapshot."
+          : "Expediente cargado en modo vivo.",
+      );
+    } catch {
+      setErrorMessage("No fue posible cargar el expediente.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function refreshDossier() {
+    setIsBusy(true);
+    setErrorMessage(null);
+
+    try {
+      const response = await fetch("/api/audits/expediente/refresh", {
+        method: "POST",
+      });
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok || !payload.dossier) {
+        setErrorMessage(payload.error ?? "No fue posible refrescar el expediente.");
+        return;
+      }
+
+      setDossier(payload.dossier);
+      setFreshness(payload.freshness ?? null);
+      setMessage("Snapshot del expediente institucional actualizado.");
+      await reloadSimulations();
+    } catch {
+      setErrorMessage("No fue posible refrescar el expediente.");
+    } finally {
+      setIsBusy(false);
+    }
+  }
+
+  async function setSuggestionDecision(decision: "accept" | "dismiss") {
+    if (!aiSuggestionId) {
+      return;
+    }
+
+    await fetch(`/api/ai/suggestions/${encodeURIComponent(aiSuggestionId)}/decision`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({ decision }),
+    });
+  }
+
+  async function generateAiFindings() {
+    setIsLoadingAiFindings(true);
+    setErrorMessage(null);
+
+    try {
+      const response = await fetch("/api/audits/ai/findings", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          simulationId: selectedSimulationId || undefined,
+        }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as {
+        ok?: boolean;
+        error?: string;
+        auditorLikelyFindings?: AuditAiFindings["auditorLikelyFindings"];
+        missingEvidence?: AuditAiFindings["missingEvidence"];
+        topRisks?: AuditAiFindings["topRisks"];
+        remediationPlan?: AuditAiFindings["remediationPlan"];
+        confidence?: AuditAiFindings["confidence"];
+        suggestionId?: string;
+      };
+
+      if (!response.ok || !payload.ok) {
+        setErrorMessage(payload.error ?? "No fue posible generar dictamen IA.");
+        return;
+      }
+
+      setAiFindings({
+        auditorLikelyFindings: payload.auditorLikelyFindings ?? [],
+        missingEvidence: payload.missingEvidence ?? [],
+        topRisks: payload.topRisks ?? [],
+        remediationPlan: payload.remediationPlan ?? [],
+        confidence: payload.confidence ?? "low",
+      });
+      setAiSuggestionId(payload.suggestionId ?? null);
+      setMessage("Dictamen IA generado.");
+    } catch {
+      setErrorMessage("No fue posible generar dictamen IA.");
+    } finally {
+      setIsLoadingAiFindings(false);
+    }
+  }
+
+  return (
+    <div className="space-y-4">
+      <section className="grid gap-3 md:grid-cols-2 xl:grid-cols-4">
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Auditorias completadas</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{kpis.completedAudits}</p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Ultima calificacion</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{kpis.lastScore ?? 0}</p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">Contratos registrados</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{kpis.registeredContracts}</p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardContent className="py-4">
+            <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#60718f]">PDFs resguardados</p>
+            <p className="mt-2 text-4xl font-semibold text-[#15294d]">{kpis.securedPdfs}</p>
+          </CardContent>
+        </Card>
+      </section>
+
+      {errorMessage ? <p className="rounded-xl border border-[#efc4c4] bg-[#fff1f1] px-3 py-2 text-sm text-[#ad3f3f]">{errorMessage}</p> : null}
+      {message ? <p className="rounded-xl border border-[#bde5ce] bg-[#ecf9f1] px-3 py-2 text-sm text-[#1f7f4f]">{message}</p> : null}
+
+      <Tabs
+        defaultTab="simulator"
+        items={[
+          {
+            id: "simulator",
+            label: "Simulador",
+            content: (
+              <div className="space-y-3">
+                <Dialog triggerLabel="Nueva Simulacion" title="Nueva Simulacion" description="Configura simulacion de auditoria preventiva">
+                  <div className="space-y-2">
+                    <input
+                      value={newSimulation.name}
+                      onChange={(event) => setNewSimulation((prev) => ({ ...prev, name: event.target.value }))}
+                      placeholder="Nombre"
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                    />
+                    <input
+                      value={newSimulation.auditType}
+                      onChange={(event) => setNewSimulation((prev) => ({ ...prev, auditType: event.target.value }))}
+                      placeholder="Tipo de auditoria"
+                      className="h-10 w-full rounded-lg border border-[#cfd8e7] px-3"
+                    />
+                    <Button onClick={createSimulation} disabled={isBusy}>
+                      Guardar simulacion
+                    </Button>
+                  </div>
+                </Dialog>
+
+                <select
+                  value={selectedSimulationId}
+                  onChange={(event) => setSelectedSimulationId(event.target.value)}
+                  className="h-10 w-full rounded-lg border border-[#cfd8e7] bg-white px-3 text-sm"
+                >
+                  <option value="">Selecciona simulacion</option>
+                  {simulations.map((item) => (
+                    <option key={item.id} value={item.id}>
+                      {item.name} ({item.status})
+                    </option>
+                  ))}
+                </select>
+
+                <Card>
+                  <CardContent className="space-y-2 py-5">
+                    <p className="text-sm font-semibold text-[#1d335a]">Cuestionario de scoring</p>
+                    {AUDIT_QUESTIONNAIRE.map((question) => (
+                      <label key={question.key} className="flex flex-wrap items-center justify-between gap-2 rounded-lg border border-[#dbe3f1] px-3 py-2 text-sm">
+                        <span className="text-[#2e466e]">{question.prompt}</span>
+                        <select
+                          value={answers[question.key] ?? "si"}
+                          onChange={(event) =>
+                            setAnswers((prev) => ({
+                              ...prev,
+                              [question.key]: event.target.value,
+                            }))
+                          }
+                          className="h-8 rounded-lg border border-[#cfd8e7] bg-white px-2 text-xs"
+                        >
+                          <option value="si">Si</option>
+                          <option value="parcial">Parcial</option>
+                          <option value="no">No</option>
+                        </select>
+                      </label>
+                    ))}
+
+                    <Button onClick={scoreSimulation} disabled={isBusy || !selectedSimulationId}>
+                      Calificar simulacion
+                    </Button>
+                  </CardContent>
+                </Card>
+
+                {selectedSimulation ? (
+                  <Card>
+                    <CardContent className="space-y-2 py-5">
+                      <p className="text-sm font-semibold text-[#1d335a]">Resultado actual</p>
+                      <p className="text-sm text-[#60718f]">Status: {selectedSimulation.status}</p>
+                      <p className="text-sm text-[#60718f]">Score: {selectedSimulation.overallScore ?? 0}</p>
+                      <p className="text-sm text-[#60718f]">Completada: {formatDate(selectedSimulation.completedAt)}</p>
+                      {selectedSimulation.sections.map((section) => (
+                        <article key={section.id} className="rounded-lg border border-[#dbe3f1] bg-white p-2 text-xs text-[#506180]">
+                          <p className="font-semibold">{section.key}</p>
+                          <p>Status: {section.status}</p>
+                          <p>Score: {section.score ?? 0}</p>
+                        </article>
+                      ))}
+                    </CardContent>
+                  </Card>
+                ) : null}
+              </div>
+            ),
+          },
+          {
+            id: "dossier",
+            label: "Expediente",
+            content: (
+              <div className="space-y-3">
+                <div className="flex flex-wrap gap-2">
+                  <Button variant="secondary" onClick={() => void loadDossier("live")} disabled={isBusy}>
+                    Cargar modo vivo (default)
+                  </Button>
+                  <Button variant="secondary" onClick={() => void loadDossier("snapshot")} disabled={isBusy}>
+                    Cargar ultimo snapshot
+                  </Button>
+                  <Button onClick={refreshDossier} disabled={isBusy}>
+                    Generar nuevo snapshot
+                  </Button>
+                </div>
+
+                {freshness ? (
+                  <Card>
+                    <CardContent className="space-y-2 py-5 text-sm text-[#385073]">
+                      <p>
+                        Estrategia solicitada: <strong>{freshness.strategy}</strong> | Fuente actual: <strong>{freshness.source}</strong>
+                      </p>
+                      <p>Generado: {formatDate(freshness.generatedAt)}</p>
+                      <p>
+                        Estado de frescura:{" "}
+                        <span className={freshness.isStale ? "font-semibold text-[#ad3f3f]" : "font-semibold text-[#1f7f4f]"}>
+                          {freshness.isStale ? "Desactualizado" : "Vigente"}
+                        </span>{" "}
+                        (umbral: {freshness.staleAfterMinutes} min)
+                      </p>
+                      {freshness.snapshotId ? <p>Snapshot ID: {freshness.snapshotId}</p> : null}
+                    </CardContent>
+                  </Card>
+                ) : null}
+                {continuityWarnings.length > 0 ? (
+                  <Card>
+                    <CardContent className="space-y-2 py-5">
+                      <p className="text-sm font-semibold text-[#8d6308]">Advertencias de continuidad</p>
+                      {continuityWarnings.map((warning) => (
+                        <p key={warning} className="rounded-lg border border-[#f0deb0] bg-[#fff8e9] px-2 py-1 text-xs text-[#8d6308]">
+                          {warning}
+                        </p>
+                      ))}
+                    </CardContent>
+                  </Card>
+                ) : null}
+
+                {!dossier ? <p className="text-sm text-[#60718f]">Sin expediente generado todavia.</p> : null}
+
+                {dossier ? (
+                  <>
+                    <Card>
+                      <CardContent className="grid gap-2 py-5 text-sm text-[#385073] md:grid-cols-3 xl:grid-cols-4">
+                        <p>Contratos: {dossier.summary.contracts}</p>
+                        <p>PDF contratos: {dossier.summary.contractDocuments}</p>
+                        <p>Propuestas: {dossier.summary.proposals}</p>
+                        <p>PDF propuestas: {dossier.summary.proposalDocuments}</p>
+                        <p>Casos legales: {dossier.summary.legalCases}</p>
+                        <p>Escritos legales: {dossier.summary.legalDocuments}</p>
+                        <p>Alertas alto riesgo: {dossier.summary.highRiskAlerts}</p>
+                      </CardContent>
+                    </Card>
+
+                    <div className="grid gap-3 md:grid-cols-2">
+                      {dossier.components.map((component) => (
+                        <article key={component.key} className="rounded-xl border border-[#d8e1ef] bg-white p-3 text-sm">
+                          <p className="font-semibold text-[#1d335a]">{component.label}</p>
+                          <p className="mt-1 text-[#60718f]">Estado: {component.status}</p>
+                          <p className="mt-1 text-[#60718f]">
+                            Evidencia: {component.withEvidence}/{component.totalItems}
+                          </p>
+                        </article>
+                      ))}
+                    </div>
+
+                    <Card>
+                      <CardContent className="space-y-2 py-5">
+                        <p className="text-sm font-semibold text-[#1d335a]">Propuestas en expediente (M5)</p>
+                        {dossier.proposals.length === 0 ? <p className="text-sm text-[#60718f]">Sin propuestas.</p> : null}
+                        {dossier.proposals.map((item) => (
+                          <article key={item.id} className="rounded-lg border border-[#dbe3f1] bg-white p-2 text-xs text-[#506180]">
+                            <p className="font-semibold">{item.title}</p>
+                            <p>
+                              {item.status} | Documentos {item.documents}
+                            </p>
+                            <div className="mt-1 flex flex-wrap gap-2">
+                              {item.links.map((link) => (
+                                <Link key={`${item.id}-${link.href}`} href={link.href} className="text-[#2b5fab] underline">
+                                  {link.label}
+                                </Link>
+                              ))}
+                            </div>
+                            {item.documentEntries.length > 0 ? (
+                              <details className="mt-2 rounded-md border border-[#e4ebf6] p-2">
+                                <summary className="cursor-pointer font-semibold">Ver documentos y trazabilidad ({item.documentEntries.length})</summary>
+                                <div className="mt-2 space-y-2">
+                                  {item.documentEntries.map((document) => (
+                                    <article key={document.id} className="rounded-md border border-[#edf2fa] bg-[#f9fbff] p-2">
+                                      <p className="font-semibold">{document.fileName}</p>
+                                      <p className="mt-1 inline-flex rounded-full border border-[#c9d9f0] bg-white px-2 py-0.5 text-[11px] font-semibold text-[#315b96]">
+                                        Por que este archivo
+                                      </p>
+                                      <p>
+                                        {document.mimeType} | {formatFileSize(document.sizeBytes)} | {formatDate(document.createdAt)}
+                                      </p>
+                                      <p className="mt-1">{document.traceLabel}</p>
+                                      <div className="mt-1 flex flex-wrap gap-2">
+                                        {document.links.map((link) => (
+                                          <Link key={`${document.id}-${link.href}`} href={link.href} className="text-[#2b5fab] underline">
+                                            {link.label}
+                                          </Link>
+                                        ))}
+                                      </div>
+                                    </article>
+                                  ))}
+                                </div>
+                              </details>
+                            ) : null}
+                          </article>
+                        ))}
+                      </CardContent>
+                    </Card>
+
+                    <Card>
+                      <CardContent className="space-y-2 py-5">
+                        <p className="text-sm font-semibold text-[#1d335a]">Contratos en expediente (M8)</p>
+                        {dossier.contracts.length === 0 ? <p className="text-sm text-[#60718f]">Sin contratos.</p> : null}
+                        {dossier.contracts.map((item) => (
+                          <article key={item.id} className="rounded-lg border border-[#dbe3f1] bg-white p-2 text-xs text-[#506180]">
+                            <p className="font-semibold">{item.title}</p>
+                            <p>
+                              {item.status} | Entregables {item.deliverables} | Pagos {item.payments} | Documentos {item.documents}
+                            </p>
+                            <div className="mt-1 flex flex-wrap gap-2">
+                              {item.links.map((link) => (
+                                <Link key={`${item.id}-${link.href}`} href={link.href} className="text-[#2b5fab] underline">
+                                  {link.label}
+                                </Link>
+                              ))}
+                            </div>
+                            {item.documentEntries.length > 0 ? (
+                              <details className="mt-2 rounded-md border border-[#e4ebf6] p-2">
+                                <summary className="cursor-pointer font-semibold">Ver documentos y trazabilidad ({item.documentEntries.length})</summary>
+                                <div className="mt-2 space-y-2">
+                                  {item.documentEntries.map((document) => (
+                                    <article key={document.id} className="rounded-md border border-[#edf2fa] bg-[#f9fbff] p-2">
+                                      <p className="font-semibold">{document.fileName}</p>
+                                      <p className="mt-1 inline-flex rounded-full border border-[#c9d9f0] bg-white px-2 py-0.5 text-[11px] font-semibold text-[#315b96]">
+                                        Por que este archivo
+                                      </p>
+                                      <p>
+                                        {document.kind ? `${document.kind} | ` : ""}
+                                        {document.mimeType} | {formatFileSize(document.sizeBytes)} | {formatDate(document.createdAt)}
+                                      </p>
+                                      <p className="mt-1">{document.traceLabel}</p>
+                                      <div className="mt-1 flex flex-wrap gap-2">
+                                        {document.links.map((link) => (
+                                          <Link key={`${document.id}-${link.href}`} href={link.href} className="text-[#2b5fab] underline">
+                                            {link.label}
+                                          </Link>
+                                        ))}
+                                      </div>
+                                    </article>
+                                  ))}
+                                </div>
+                              </details>
+                            ) : null}
+                          </article>
+                        ))}
+                      </CardContent>
+                    </Card>
+
+                    <Card>
+                      <CardContent className="space-y-2 py-5">
+                        <p className="text-sm font-semibold text-[#1d335a]">Casos legales en expediente (M9)</p>
+                        {dossier.legal.length === 0 ? <p className="text-sm text-[#60718f]">Sin casos legales.</p> : null}
+                        {dossier.legal.map((item) => (
+                          <article key={item.id} className="rounded-lg border border-[#dbe3f1] bg-white p-2 text-xs text-[#506180]">
+                            <p className="font-semibold">
+                              {item.caseType} | {item.severity}
+                            </p>
+                            <p>
+                              {item.status} | Escritos {item.documents}
+                            </p>
+                            <div className="mt-1 flex flex-wrap gap-2">
+                              {item.links.map((link) => (
+                                <Link key={`${item.id}-${link.href}`} href={link.href} className="text-[#2b5fab] underline">
+                                  {link.label}
+                                </Link>
+                              ))}
+                            </div>
+                            {item.documentEntries.length > 0 ? (
+                              <details className="mt-2 rounded-md border border-[#e4ebf6] p-2">
+                                <summary className="cursor-pointer font-semibold">Ver documentos y trazabilidad ({item.documentEntries.length})</summary>
+                                <div className="mt-2 space-y-2">
+                                  {item.documentEntries.map((document) => (
+                                    <article key={document.id} className="rounded-md border border-[#edf2fa] bg-[#f9fbff] p-2">
+                                      <p className="font-semibold">{document.fileName}</p>
+                                      <p className="mt-1 inline-flex rounded-full border border-[#c9d9f0] bg-white px-2 py-0.5 text-[11px] font-semibold text-[#315b96]">
+                                        Por que este archivo
+                                      </p>
+                                      <p>
+                                        {document.kind ? `${document.kind} | ` : ""}
+                                        {document.mimeType} | {formatFileSize(document.sizeBytes)} | {formatDate(document.createdAt)}
+                                      </p>
+                                      <p className="mt-1">{document.traceLabel}</p>
+                                      <div className="mt-1 flex flex-wrap gap-2">
+                                        {document.links.map((link) => (
+                                          <Link key={`${document.id}-${link.href}`} href={link.href} className="text-[#2b5fab] underline">
+                                            {link.label}
+                                          </Link>
+                                        ))}
+                                      </div>
+                                    </article>
+                                  ))}
+                                </div>
+                              </details>
+                            ) : null}
+                          </article>
+                        ))}
+                      </CardContent>
+                    </Card>
+                  </>
+                ) : null}
+              </div>
+            ),
+          },
+          {
+            id: "dictamen-ia",
+            label: "Dictamen IA",
+            content: (
+              <div className="space-y-3">
+                <div className="flex flex-wrap gap-2">
+                  <Button type="button" variant="secondary" disabled={isLoadingAiFindings} onClick={() => void generateAiFindings()}>
+                    {isLoadingAiFindings ? "Generando dictamen IA..." : "Generar dictamen IA"}
+                  </Button>
+                  {aiFindings ? (
+                    <Button
+                      type="button"
+                      variant="secondary"
+                      onClick={() => {
+                        void setSuggestionDecision("dismiss");
+                        setAiFindings(null);
+                        setMessage("Dictamen IA descartado.");
+                      }}
+                    >
+                      Descartar dictamen IA
+                    </Button>
+                  ) : null}
+                </div>
+
+                {!aiFindings ? <p className="text-sm text-[#60718f]">Genera dictamen IA para simular observaciones de auditor.</p> : null}
+
+                {aiFindings ? (
+                  <>
+                    <article className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                      <p className="text-sm font-semibold text-[#1d335a]">Hallazgos probables del auditor</p>
+                      <ul className="mt-2 space-y-2 text-xs text-[#60718f]">
+                        {aiFindings.auditorLikelyFindings.map((item) => (
+                          <li key={`${item.area}-${item.finding}`} className="rounded-lg border border-[#e4ebf6] px-2 py-1">
+                            <p className="font-semibold text-[#233b62]">
+                              {item.area} · {item.severity}
+                            </p>
+                            <p>{item.finding}</p>
+                          </li>
+                        ))}
+                      </ul>
+                    </article>
+
+                    <article className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                      <p className="text-sm font-semibold text-[#1d335a]">Evidencia faltante</p>
+                      <ul className="mt-2 space-y-1 text-xs text-[#60718f]">
+                        {aiFindings.missingEvidence.map((item) => (
+                          <li key={item}>- {item}</li>
+                        ))}
+                      </ul>
+                    </article>
+
+                    <article className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                      <p className="text-sm font-semibold text-[#1d335a]">Top riesgos</p>
+                      <ul className="mt-2 space-y-1 text-xs text-[#60718f]">
+                        {aiFindings.topRisks.map((item) => (
+                          <li key={item}>- {item}</li>
+                        ))}
+                      </ul>
+                    </article>
+
+                    <article className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                      <p className="text-sm font-semibold text-[#1d335a]">Plan de remediacion</p>
+                      <ul className="mt-2 space-y-2 text-xs text-[#60718f]">
+                        {aiFindings.remediationPlan.map((item) => (
+                          <li key={`${item.step}-${item.ownerSuggestion}`} className="rounded-lg border border-[#e4ebf6] px-2 py-1">
+                            <p className="font-semibold text-[#233b62]">{item.step}</p>
+                            <p>
+                              Prioridad {item.priority} · Responsable sugerido: {item.ownerSuggestion} · Fecha objetivo: {item.targetDate}
+                            </p>
+                          </li>
+                        ))}
+                      </ul>
+                      <div className="mt-3 flex flex-wrap items-center gap-2">
+                        <Button
+                          type="button"
+                          size="sm"
+                          onClick={() => {
+                            void setSuggestionDecision("accept");
+                            setMessage("Dictamen IA marcado como aceptado.");
+                          }}
+                        >
+                          Aceptar dictamen IA
+                        </Button>
+                        <p className="text-xs font-semibold text-[#405578]">Confianza IA: {aiFindings.confidence}</p>
+                      </div>
+                    </article>
+                  </>
+                ) : null}
+              </div>
+            ),
+          },
+        ]}
+      />
+    </div>
+  );
+}
diff --git a/src/components/app/proposal-workflow-view.tsx b/src/components/app/proposal-workflow-view.tsx
new file mode 100644
index 0000000..8882733
--- /dev/null
+++ b/src/components/app/proposal-workflow-view.tsx
@@ -0,0 +1,1850 @@
+"use client";
+
+import Link from "next/link";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { computeWorkflowCompletionPercent, computeWorkflowGate, type ProposalWorkflowState, type ProposalWorkflowGate } from "@/lib/proposals/workflow-state";
+import { buildDefaultWorkflowDraft } from "@/lib/proposals/workflow-default";
+import type { WorkflowMilestoneSeed, WorkflowRequirementCategory, WorkflowRequirementSeed, WorkflowTechnicalSectionSeed } from "@/lib/proposals/workflow";
+import { getSignaturePolicyStatusLabel, getSignaturePolicyTone } from "@/lib/compliance/signature-policy";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+
+type ProposalDocumentView = {
+  id: string;
+  fileName: string;
+  mimeType: string;
+  sizeBytes: number;
+  createdAt: string;
+};
+
+type ProposalWorkflowViewProps = {
+  proposal: {
+    id: string;
+    title: string;
+    issuingEntity: string;
+    summary: string;
+    status: "DRAFT" | "IN_PROGRESS" | "SUBMITTED" | "ARCHIVED";
+    sourceLicitationId: string | null;
+    updatedAt: string;
+    documents: ProposalDocumentView[];
+  };
+  linkedSource:
+    | {
+        id: string;
+        title: string;
+        description: string;
+        issuingEntity: string | null;
+        procedureType: string;
+        stateName: string;
+        municipalityName: string;
+        sourceUrl: string | null;
+        documentLinks: Array<{ name: string; url: string; type: string | null }>;
+        milestones: WorkflowMilestoneSeed[];
+      }
+    | null;
+  normativeContext:
+    | {
+        id: string;
+        analyzedAt: string;
+        executiveSummary: string;
+        confidence: "low" | "medium" | "high";
+        requirementSeeds: WorkflowRequirementSeed[];
+        technicalSeeds: WorkflowTechnicalSectionSeed[];
+      }
+    | null;
+  autoExtractOnLoad?: boolean;
+};
+
+type WorkflowDraft = ProposalWorkflowState;
+type RequirementStatus = WorkflowDraft["requirements"][number]["status"];
+type RequirementDraft = WorkflowDraft["requirements"][number];
+type EconomicItemDraft = WorkflowDraft["economicItems"][number];
+
+type ApiPayload = {
+  ok?: boolean;
+  error?: string;
+  proposal?: {
+    id: string;
+    status: "DRAFT" | "IN_PROGRESS" | "SUBMITTED" | "ARCHIVED";
+    currentStep?: number;
+    completionPercent?: number;
+    readyForSubmissionAt?: string | null;
+    documents: ProposalDocumentView[];
+  };
+  workflow?: WorkflowDraft | null;
+  gate?: ProposalWorkflowGate | null;
+  analysis?: {
+    source?: "module4_history" | "uploaded_pdf";
+    engine?: string | null;
+    model?: string | null;
+    warnings?: string[];
+    bundle?: {
+      sources?: Array<{ sourceId?: string; fileName: string; documentType: string; historyId?: string | null }>;
+      conflicts?: Array<{ title: string; field: string }>;
+    };
+  };
+};
+
+const STEPS = ["Info", "Docs", "Tecnica", "Economica", "Validacion", "Fechas"] as const;
+const IVA_RATE = 0.16;
+
+function newId(prefix: string) {
+  return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+
+function formatCurrency(value: number) {
+  return value.toLocaleString("es-MX", {
+    style: "currency",
+    currency: "MXN",
+    maximumFractionDigits: 2,
+  });
+}
+
+function formatDateTime(value: string | null) {
+  if (!value) {
+    return "Sin fecha";
+  }
+
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return "Sin fecha";
+  }
+
+  return parsed.toLocaleString("es-MX", {
+    year: "numeric",
+    month: "long",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+}
+
+function isoToLocalInput(value: string | null) {
+  if (!value) {
+    return "";
+  }
+
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return "";
+  }
+
+  const offset = parsed.getTimezoneOffset() * 60_000;
+  return new Date(parsed.getTime() - offset).toISOString().slice(0, 16);
+}
+
+function localInputToIso(value: string) {
+  if (!value.trim()) {
+    return null;
+  }
+
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return null;
+  }
+
+  return parsed.toISOString();
+}
+
+function categoryLabel(value: WorkflowRequirementCategory) {
+  if (value === "administrativo") {
+    return "Administrativo";
+  }
+
+  if (value === "legal") {
+    return "Legal";
+  }
+
+  if (value === "tecnico") {
+    return "Tecnico";
+  }
+
+  if (value === "economico") {
+    return "Economico";
+  }
+
+  return "General";
+}
+
+function sourceLabel(value: WorkflowRequirementSeed["source"]) {
+  if (value === "official_format") {
+    return "Formato oficial";
+  }
+
+  if (value === "required_checklist") {
+    return "Checklist IA";
+  }
+
+  if (value === "critical_requirement") {
+    return "Critico IA";
+  }
+
+  return "Candado IA";
+}
+
+function toStatusLabel(status: RequirementStatus) {
+  if (status === "completed") {
+    return "Completo";
+  }
+
+  if (status === "na") {
+    return "No aplica";
+  }
+
+  return "Pendiente";
+}
+
+function createBaseDraft(props: ProposalWorkflowViewProps): WorkflowDraft {
+  return buildDefaultWorkflowDraft({
+    proposal: {
+      title: props.proposal.title,
+      issuingEntity: props.proposal.issuingEntity,
+      summary: props.proposal.summary,
+      status: props.proposal.status,
+    },
+    linkedSource: props.linkedSource
+      ? {
+          title: props.linkedSource.title,
+          description: props.linkedSource.description,
+          issuingEntity: props.linkedSource.issuingEntity,
+          procedureType: props.linkedSource.procedureType,
+          stateName: props.linkedSource.stateName,
+          municipalityName: props.linkedSource.municipalityName,
+          sourceUrl: props.linkedSource.sourceUrl,
+          milestones: props.linkedSource.milestones,
+        }
+      : null,
+    requirementSeeds: props.normativeContext?.requirementSeeds ?? [],
+    technicalSectionSeeds: props.normativeContext?.technicalSeeds ?? [],
+  });
+}
+
+function computeEconomicTotals(items: EconomicItemDraft[]) {
+  const subtotal = items.reduce((acc, item) => acc + Math.max(0, item.quantity) * Math.max(0, item.unitPrice), 0);
+  const iva = subtotal * IVA_RATE;
+  const total = subtotal + iva;
+
+  return { subtotal, iva, total };
+}
+
+function byCategory(requirements: RequirementDraft[]) {
+  const order: WorkflowRequirementCategory[] = ["administrativo", "legal", "tecnico", "economico", "general"];
+  return order
+    .map((category) => ({
+      category,
+      items: requirements.filter((item) => item.category === category),
+    }))
+    .filter((bucket) => bucket.items.length > 0);
+}
+
+function requirementTone(status: RequirementStatus) {
+  if (status === "completed") {
+    return "border-[#b9e6cd] bg-[#eaf9f1]";
+  }
+
+  if (status === "na") {
+    return "border-[#f0deb0] bg-[#fff8e9]";
+  }
+
+  return "border-[#d8e1ef] bg-white";
+}
+
+function hasRequirementEvidence(item: RequirementDraft) {
+  return item.evidences.length > 0;
+}
+
+function isRequirementResolved(item: RequirementDraft) {
+  return item.status !== "pending" && (item.status === "na" || hasRequirementEvidence(item));
+}
+
+function milestoneSourceLabel(source: WorkflowDraft["milestones"][number]["source"]) {
+  if (source === "ai") {
+    return "IA";
+  }
+
+  if (source === "licitation") {
+    return "Portal";
+  }
+
+  return "Manual";
+}
+
+function getMilestoneTimelineTone(dateIso: string | null) {
+  if (!dateIso) {
+    return {
+      dot: "bg-[#d6a441]",
+      badge: "border-[#f0deb0] bg-[#fff8e9] text-[#8d6308]",
+      label: "Sin fecha",
+    };
+  }
+
+  const time = new Date(dateIso).getTime();
+  if (Number.isNaN(time)) {
+    return {
+      dot: "bg-[#d6a441]",
+      badge: "border-[#f0deb0] bg-[#fff8e9] text-[#8d6308]",
+      label: "Sin fecha",
+    };
+  }
+
+  const now = Date.now();
+  const diff = time - now;
+  const hours = diff / 3_600_000;
+
+  if (hours < 0) {
+    return {
+      dot: "bg-[#d55668]",
+      badge: "border-[#f1c7ce] bg-[#fff1f4] text-[#b23f50]",
+      label: "Vencido",
+    };
+  }
+
+  if (hours <= 24) {
+    return {
+      dot: "bg-[#e0aa1f]",
+      badge: "border-[#f0deb0] bg-[#fff8e9] text-[#8d6308]",
+      label: "Hoy",
+    };
+  }
+
+  return {
+    dot: "bg-[#2f79d6]",
+    badge: "border-[#c6d8f4] bg-[#ebf3ff] text-[#284f88]",
+    label: "Programado",
+  };
+}
+
+export function ProposalWorkflowView(props: ProposalWorkflowViewProps) {
+  const requirementInputRefs = useRef<Record<string, HTMLInputElement | null>>({});
+  const aiFileInputRef = useRef<HTMLInputElement | null>(null);
+  const autoExtractAttemptedRef = useRef(false);
+  const baseDraft = useMemo(() => createBaseDraft(props), [props]);
+  const [workflow, setWorkflow] = useState<WorkflowDraft>(baseDraft);
+  const [proposalStatus, setProposalStatus] = useState(props.proposal.status);
+  const [documents, setDocuments] = useState<ProposalDocumentView[]>(props.proposal.documents);
+  const [workflowLoaded, setWorkflowLoaded] = useState(false);
+  const [isLoadingWorkflow, setIsLoadingWorkflow] = useState(true);
+  const [isSyncingWorkflow, setIsSyncingWorkflow] = useState(false);
+  const [lastSavedAt, setLastSavedAt] = useState<string | null>(null);
+  const [workflowRevision, setWorkflowRevision] = useState(0);
+  const [isSavingInfo, setIsSavingInfo] = useState(false);
+  const [isSavingReady, setIsSavingReady] = useState(false);
+  const [uploadingRequirementId, setUploadingRequirementId] = useState<string | null>(null);
+  const [draggingRequirementId, setDraggingRequirementId] = useState<string | null>(null);
+  const [isExtractingAi, setIsExtractingAi] = useState(false);
+  const [pdfLoadingKind, setPdfLoadingKind] = useState<"technical" | "economic" | "summary" | null>(null);
+  const [message, setMessage] = useState<string | null>(null);
+  const [errorMessage, setErrorMessage] = useState<string | null>(null);
+  const [lastExtractionAnalysis, setLastExtractionAnalysis] = useState<ApiPayload["analysis"] | null>(null);
+  const [newSectionTitle, setNewSectionTitle] = useState("");
+  const [newMilestoneTitle, setNewMilestoneTitle] = useState("");
+  const [newConcept, setNewConcept] = useState({
+    concept: "",
+    unit: "pieza",
+    quantity: 1,
+    unitPrice: 0,
+  });
+
+  useEffect(() => {
+    let isMounted = true;
+
+    async function loadWorkflow() {
+      setIsLoadingWorkflow(true);
+      setWorkflowLoaded(false);
+      setErrorMessage(null);
+
+      try {
+        const response = await fetch(`/api/proposals/${encodeURIComponent(props.proposal.id)}/workflow`);
+        const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+        if (!response.ok || !payload.ok) {
+          throw new Error(payload.error ?? "No fue posible cargar el flujo de trabajo.");
+        }
+
+        if (!isMounted) {
+          return;
+        }
+
+        setProposalStatus(payload.proposal?.status ?? props.proposal.status);
+        setDocuments(payload.proposal?.documents ?? props.proposal.documents);
+        setWorkflow(payload.workflow ?? baseDraft);
+      } catch (error) {
+        if (!isMounted) {
+          return;
+        }
+
+        setWorkflow(baseDraft);
+        setErrorMessage(error instanceof Error ? error.message : "No fue posible cargar el flujo de trabajo.");
+      } finally {
+        if (isMounted) {
+          setIsLoadingWorkflow(false);
+          setWorkflowLoaded(true);
+          setWorkflowRevision(0);
+        }
+      }
+    }
+
+    loadWorkflow();
+    return () => {
+      isMounted = false;
+    };
+  }, [baseDraft, props.proposal.documents, props.proposal.id, props.proposal.status]);
+
+  useEffect(() => {
+    autoExtractAttemptedRef.current = false;
+  }, [props.proposal.id]);
+
+  const persistWorkflowState = useCallback(async (nextWorkflow: WorkflowDraft) => {
+    setIsSyncingWorkflow(true);
+
+    try {
+      const response = await fetch(`/api/proposals/${encodeURIComponent(props.proposal.id)}/workflow`, {
+        method: "PATCH",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          workflow: nextWorkflow,
+        }),
+      });
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+      if (!response.ok || !payload.ok) {
+        throw new Error(payload.error ?? "No fue posible guardar el flujo de trabajo.");
+      }
+
+      if (payload.proposal?.status) {
+        setProposalStatus(payload.proposal.status);
+      }
+      setLastSavedAt(new Date().toISOString());
+    } catch (error) {
+      setErrorMessage(error instanceof Error ? error.message : "No fue posible guardar el flujo de trabajo.");
+    } finally {
+      setIsSyncingWorkflow(false);
+    }
+  }, [props.proposal.id]);
+
+  function updateWorkflow(updater: (previous: WorkflowDraft) => WorkflowDraft) {
+    setWorkflow((previous) => updater(previous));
+    setWorkflowRevision((previous) => previous + 1);
+  }
+
+  useEffect(() => {
+    if (!workflowLoaded || workflowRevision <= 0) {
+      return;
+    }
+
+    const timer = setTimeout(() => {
+      void persistWorkflowState(workflow);
+    }, 700);
+
+    return () => clearTimeout(timer);
+  }, [workflow, workflowLoaded, workflowRevision, persistWorkflowState]);
+
+  const groupedRequirements = useMemo(() => byCategory(workflow.requirements), [workflow.requirements]);
+  const economicTotals = useMemo(() => computeEconomicTotals(workflow.economicItems), [workflow.economicItems]);
+  const documentsById = useMemo(() => new Map(documents.map((item) => [item.id, item])), [documents]);
+  const sortedMilestones = useMemo(
+    () =>
+      [...workflow.milestones].sort((a, b) => {
+        if (!a.dateIso && !b.dateIso) {
+          return a.title.localeCompare(b.title, "es-MX");
+        }
+        if (!a.dateIso) {
+          return 1;
+        }
+        if (!b.dateIso) {
+          return -1;
+        }
+        return new Date(a.dateIso).getTime() - new Date(b.dateIso).getTime();
+      }),
+    [workflow.milestones],
+  );
+
+  const gate = useMemo(() => computeWorkflowGate(workflow), [workflow]);
+
+  const stepCompletion = useMemo(
+    () => [gate.infoReady, gate.docsReady, gate.technicalReady, gate.economicReady, gate.allReady, gate.datesReady],
+    [gate],
+  );
+  const completionPercent = useMemo(() => computeWorkflowCompletionPercent(workflow), [workflow]);
+
+  async function patchProposal(body: Record<string, unknown>) {
+    const response = await fetch(`/api/proposals/${encodeURIComponent(props.proposal.id)}`, {
+      method: "PATCH",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify(body),
+    });
+
+    const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+    if (!response.ok || !payload.ok || !payload.proposal) {
+      throw new Error(payload.error ?? "No fue posible actualizar la propuesta.");
+    }
+
+    setProposalStatus(payload.proposal.status);
+    if (payload.proposal.documents) {
+      setDocuments(payload.proposal.documents);
+    }
+  }
+
+  async function handleSaveInfo() {
+    setIsSavingInfo(true);
+    setErrorMessage(null);
+    setMessage(null);
+
+    try {
+      await patchProposal({
+        title: workflow.info.title.trim(),
+        issuingEntity: workflow.info.issuingEntity.trim(),
+        summary: workflow.info.description.trim(),
+      });
+      setMessage("Informacion guardada.");
+      await persistWorkflowState(workflow);
+    } catch (error) {
+      setErrorMessage(error instanceof Error ? error.message : "No fue posible guardar la informacion.");
+    } finally {
+      setIsSavingInfo(false);
+    }
+  }
+
+  async function handleRequirementUpload(requirementId: string, file: File | null) {
+    if (!file) {
+      return;
+    }
+
+    setUploadingRequirementId(requirementId);
+    setErrorMessage(null);
+    setMessage(null);
+
+    try {
+      const previousDocumentIds = new Set(documents.map((item) => item.id));
+      const formData = new FormData();
+      formData.append("file", file);
+
+      const response = await fetch(`/api/proposals/${encodeURIComponent(props.proposal.id)}/documents`, {
+        method: "POST",
+        body: formData,
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+      if (!response.ok || !payload.ok || !payload.proposal) {
+        throw new Error(payload.error ?? "No fue posible subir el documento.");
+      }
+
+      const nextDocuments = payload.proposal.documents;
+      const uploadedDocument =
+        nextDocuments.find((item) => !previousDocumentIds.has(item.id)) ??
+        nextDocuments.find((item) => item.fileName === file.name) ??
+        null;
+
+      if (!uploadedDocument) {
+        throw new Error("El archivo se subio, pero no se pudo vincular al requisito.");
+      }
+
+      setDocuments(nextDocuments);
+      setProposalStatus(payload.proposal.status);
+      updateWorkflow((previous) => ({
+        ...previous,
+        requirements: previous.requirements.map((entry) => {
+          if (entry.id !== requirementId) {
+            return entry;
+          }
+
+          const alreadyLinked = entry.evidences.some((evidence) => evidence.documentId === uploadedDocument.id);
+          const nextEvidences = alreadyLinked
+            ? entry.evidences
+            : [
+                {
+                  id: newId("evidence"),
+                  documentId: uploadedDocument.id,
+                  fileName: uploadedDocument.fileName,
+                  uploadedAtIso: uploadedDocument.createdAt,
+                },
+                ...entry.evidences,
+              ];
+
+          return {
+            ...entry,
+            status: entry.status === "na" ? "na" : "completed",
+            evidences: nextEvidences,
+          };
+        }),
+      }));
+      setMessage(`Archivo vinculado: ${uploadedDocument.fileName}`);
+    } catch (error) {
+      setErrorMessage(error instanceof Error ? error.message : "No fue posible subir el documento.");
+    } finally {
+      setUploadingRequirementId(null);
+      const input = requirementInputRefs.current[requirementId];
+      if (input) {
+        input.value = "";
+      }
+    }
+  }
+
+  function removeRequirementEvidence(requirementId: string, evidenceId: string) {
+    updateWorkflow((previous) => ({
+      ...previous,
+      requirements: previous.requirements.map((entry) => {
+        if (entry.id !== requirementId) {
+          return entry;
+        }
+
+        const nextEvidences = entry.evidences.filter((evidence) => evidence.id !== evidenceId);
+        return {
+          ...entry,
+          status: entry.status === "completed" && nextEvidences.length === 0 ? "pending" : entry.status,
+          evidences: nextEvidences,
+        };
+      }),
+    }));
+  }
+
+  async function handleMarkReady() {
+    setIsSavingReady(true);
+    setErrorMessage(null);
+    setMessage(null);
+
+    try {
+      const response = await fetch(`/api/proposals/${encodeURIComponent(props.proposal.id)}/workflow/mark-ready`, {
+        method: "POST",
+      });
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+      if (!response.ok || !payload.ok || !payload.proposal) {
+        throw new Error(payload.error ?? "No fue posible marcar la propuesta.");
+      }
+
+      setProposalStatus(payload.proposal.status);
+
+      updateWorkflow((previous) => ({
+        ...previous,
+        readyMarked: true,
+        step: 6,
+      }));
+      setMessage("Propuesta marcada como Lista para Envio.");
+    } catch (error) {
+      setErrorMessage(error instanceof Error ? error.message : "No fue posible marcar la propuesta.");
+    } finally {
+      setIsSavingReady(false);
+    }
+  }
+
+  const handleExtractWithAi = useCallback(async (files: File[] | null) => {
+    setIsExtractingAi(true);
+    setErrorMessage(null);
+    setMessage(null);
+
+    try {
+      const formData = new FormData();
+      if (files && files.length > 0) {
+        for (const file of files.slice(0, 3)) {
+          formData.append("files", file);
+        }
+      }
+      formData.append("documentType", "BASES_LICITACION");
+      if (workflow.info.issuingEntity.trim()) {
+        formData.append("issuingEntity", workflow.info.issuingEntity.trim());
+      }
+
+      const response = await fetch(`/api/proposals/${encodeURIComponent(props.proposal.id)}/workflow/extract`, {
+        method: "POST",
+        body: formData,
+      });
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+      if (!response.ok || !payload.ok || !payload.workflow || !payload.proposal) {
+        throw new Error(payload.error ?? "No fue posible extraer requisitos con IA.");
+      }
+
+      setWorkflow(payload.workflow);
+      setProposalStatus(payload.proposal.status);
+      setWorkflowRevision(0);
+      setLastExtractionAnalysis(payload.analysis ?? null);
+      const bundleSummary =
+        payload.analysis?.bundle?.sources && payload.analysis.bundle.sources.length > 1
+          ? ` (${payload.analysis.bundle.sources.length} documentos fusionados)`
+          : "";
+      setMessage(
+        payload.analysis?.source === "uploaded_pdf"
+          ? `Extraccion IA completada con PDF cargado${bundleSummary}.`
+          : `Extraccion IA completada con analisis previo de Modulo 4${bundleSummary}.`,
+      );
+    } catch (error) {
+      setErrorMessage(error instanceof Error ? error.message : "No fue posible extraer requisitos con IA.");
+    } finally {
+      setIsExtractingAi(false);
+      if (aiFileInputRef.current) {
+        aiFileInputRef.current.value = "";
+      }
+    }
+  }, [props.proposal.id, workflow.info.issuingEntity]);
+
+  useEffect(() => {
+    if (!props.autoExtractOnLoad || !props.normativeContext) {
+      return;
+    }
+
+    if (!workflowLoaded || isLoadingWorkflow || isExtractingAi || autoExtractAttemptedRef.current) {
+      return;
+    }
+
+    autoExtractAttemptedRef.current = true;
+    void handleExtractWithAi(null);
+  }, [handleExtractWithAi, isExtractingAi, isLoadingWorkflow, props.autoExtractOnLoad, props.normativeContext, workflowLoaded]);
+
+  async function handleDownloadPdf(kind: "technical" | "economic" | "summary") {
+    setPdfLoadingKind(kind);
+    setErrorMessage(null);
+    setMessage(null);
+
+    try {
+      const response = await fetch(`/api/proposals/${encodeURIComponent(props.proposal.id)}/pdf/${kind}`);
+      if (!response.ok) {
+        const payload = (await response.json().catch(() => ({}))) as { error?: string };
+        throw new Error(payload.error ?? "No fue posible generar el PDF.");
+      }
+
+      const blob = await response.blob();
+      const downloadUrl = window.URL.createObjectURL(blob);
+      const disposition = response.headers.get("content-disposition") ?? "";
+      const fileNameMatch = disposition.match(/filename="([^"]+)"/i);
+      const fileName = fileNameMatch?.[1] ?? `${kind}.pdf`;
+
+      const anchor = document.createElement("a");
+      anchor.href = downloadUrl;
+      anchor.download = fileName;
+      document.body.appendChild(anchor);
+      anchor.click();
+      document.body.removeChild(anchor);
+      window.URL.revokeObjectURL(downloadUrl);
+
+      setMessage("PDF generado correctamente.");
+    } catch (error) {
+      setErrorMessage(error instanceof Error ? error.message : "No fue posible generar el PDF.");
+    } finally {
+      setPdfLoadingKind(null);
+    }
+  }
+
+  const hasMissingContinuityContext = !props.linkedSource && !props.normativeContext;
+
+  return (
+    <div className="space-y-5">
+      <section className="flex flex-wrap items-center justify-between gap-3">
+        <div>
+          <p className="text-sm font-semibold uppercase tracking-[0.08em] text-[#60718f]">Gestion de Licitacion</p>
+          <h1 className="text-4xl font-semibold text-[#14274b] [font-family:var(--font-display)]">{workflow.info.title || "Nueva propuesta"}</h1>
+          <p className="mt-1 text-base text-[#5f7090]">
+            Estado: <span className="font-semibold">{proposalStatus}</span> · {completionPercent}% completado
+          </p>
+          <p className="text-xs text-[#6a7895]">
+            {isLoadingWorkflow ? "Cargando flujo..." : isSyncingWorkflow ? "Guardando cambios..." : lastSavedAt ? `Guardado: ${formatDateTime(lastSavedAt)}` : "Sincronizado"}
+          </p>
+        </div>
+        <div className="flex flex-wrap items-center gap-2">
+          <LinkButton href="/gestion-licitaciones" label="Volver al listado" />
+          {props.linkedSource?.sourceUrl ? <LinkButton href={props.linkedSource.sourceUrl} label="Fuente original" external /> : null}
+        </div>
+      </section>
+
+      <div className="h-2 w-full overflow-hidden rounded-full bg-[#d7dfec]">
+        <div className="h-full bg-[#1f3f84]" style={{ width: `${completionPercent}%` }} />
+      </div>
+
+      <ol className="grid gap-2 md:grid-cols-6">
+        {STEPS.map((label, index) => {
+          const stepNumber = index + 1;
+          const isCurrent = workflow.step === stepNumber;
+          const isComplete = stepCompletion[index];
+          return (
+            <li key={label}>
+              <button
+                type="button"
+                className={`w-full rounded-xl border px-2 py-3 text-left transition ${
+                  isCurrent
+                    ? "border-[#1f3f84] bg-[#eaf1ff]"
+                    : isComplete
+                      ? "border-[#b9e6cd] bg-[#eaf9f1]"
+                      : "border-[#d8e1ef] bg-white"
+                }`}
+                onClick={() =>
+                  updateWorkflow((previous) => ({
+                    ...previous,
+                    step: stepNumber,
+                  }))
+                }
+              >
+                <p className="text-xs font-semibold text-[#627390]">Paso {stepNumber}</p>
+                <p className="mt-1 text-sm font-semibold text-[#172a4f]">{label}</p>
+              </button>
+            </li>
+          );
+        })}
+      </ol>
+
+      {errorMessage ? <p className="rounded-xl border border-[#f1c7ce] bg-[#fff1f4] px-3 py-2 text-sm text-[#b23f50]">{errorMessage}</p> : null}
+      {message ? <p className="rounded-xl border border-[#b9e6cd] bg-[#eaf9f1] px-3 py-2 text-sm text-[#1f8b63]">{message}</p> : null}
+      {hasMissingContinuityContext ? (
+        <p className="rounded-xl border border-[#f0deb0] bg-[#fff8e9] px-3 py-2 text-sm text-[#8d6308]">
+          Advertencia de continuidad: esta propuesta no tiene contexto activo de M4, para mantener trazabilidad usa extraccion con PDF o vincula `sourceLicitationId`.
+        </p>
+      ) : null}
+      {lastExtractionAnalysis ? (
+        <Card className="border-[#d5e2f5] bg-[#f5f9ff]">
+          <CardContent className="space-y-2 p-4 text-sm text-[#35507a]">
+            <p className="font-semibold text-[#1d3a67]">Trazabilidad de extraccion (por que este archivo)</p>
+            <p>Fuente usada: {lastExtractionAnalysis.source === "uploaded_pdf" ? "PDF cargado" : "Historial M4 vinculado"}.</p>
+            {lastExtractionAnalysis.bundle?.sources?.length ? (
+              <div className="flex flex-wrap gap-2">
+                {lastExtractionAnalysis.bundle.sources.map((source, index) => (
+                  <span key={`${source.fileName}-${index}`} className="rounded-full border border-[#c9d9f0] bg-white px-2 py-0.5 text-xs">
+                    {source.fileName} ({source.documentType})
+                  </span>
+                ))}
+              </div>
+            ) : null}
+            {lastExtractionAnalysis.warnings && lastExtractionAnalysis.warnings.length > 0 ? (
+              <p className="text-xs text-[#6b7f9f]">Notas: {lastExtractionAnalysis.warnings.slice(0, 2).join(" | ")}</p>
+            ) : null}
+          </CardContent>
+        </Card>
+      ) : null}
+
+      {isLoadingWorkflow ? (
+        <Card className="border-[#d8e1ef]">
+          <CardContent className="p-5">
+            <p className="text-sm text-[#5f7090]">Cargando informacion del flujo de trabajo...</p>
+          </CardContent>
+        </Card>
+      ) : null}
+
+      {!isLoadingWorkflow && workflow.step === 1 ? (
+        <Card className="border-[#d8e1ef]">
+          <CardContent className="space-y-4 p-5">
+            <header className="space-y-1">
+              <p className="text-3xl font-semibold text-[#14274b] [font-family:var(--font-display)]">Informacion General de la Licitacion</p>
+              <p className="text-sm text-[#5f7090]">Verifica y completa los datos base de la convocatoria.</p>
+            </header>
+
+            <div className="grid gap-3 md:grid-cols-2">
+              <label className="space-y-1 text-sm font-semibold text-[#33415c] md:col-span-2">
+                Titulo de la licitacion
+                <input
+                  value={workflow.info.title}
+                  onChange={(event) =>
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      info: { ...previous.info, title: event.target.value },
+                    }))
+                  }
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                />
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c] md:col-span-2">
+                Entidad contratante
+                <input
+                  value={workflow.info.issuingEntity}
+                  onChange={(event) =>
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      info: { ...previous.info, issuingEntity: event.target.value },
+                    }))
+                  }
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                />
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Tipo de licitacion
+                <input
+                  value={workflow.info.procedureType}
+                  onChange={(event) =>
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      info: { ...previous.info, procedureType: event.target.value },
+                    }))
+                  }
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                />
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Jurisdiccion
+                <input
+                  value={workflow.info.jurisdiction}
+                  onChange={(event) =>
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      info: { ...previous.info, jurisdiction: event.target.value },
+                    }))
+                  }
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                />
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Estado
+                <input
+                  value={workflow.info.state}
+                  onChange={(event) =>
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      info: { ...previous.info, state: event.target.value },
+                    }))
+                  }
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                />
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Municipio
+                <input
+                  value={workflow.info.municipality}
+                  onChange={(event) =>
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      info: { ...previous.info, municipality: event.target.value },
+                    }))
+                  }
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                />
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c] md:col-span-2">
+                Sector
+                <input
+                  value={workflow.info.sector}
+                  onChange={(event) =>
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      info: { ...previous.info, sector: event.target.value },
+                    }))
+                  }
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                />
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c] md:col-span-2">
+                Descripcion del objeto
+                <textarea
+                  value={workflow.info.description}
+                  onChange={(event) =>
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      info: { ...previous.info, description: event.target.value },
+                    }))
+                  }
+                  rows={4}
+                  className="w-full rounded-lg border border-[#cfd8e6] px-3 py-2 text-sm"
+                />
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c] md:col-span-2">
+                URL de convocatoria
+                <input
+                  value={workflow.info.convocatoriaUrl}
+                  onChange={(event) =>
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      info: { ...previous.info, convocatoriaUrl: event.target.value },
+                    }))
+                  }
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                />
+              </label>
+            </div>
+
+            <div className="flex justify-between">
+              <Button variant="secondary" onClick={() => updateWorkflow((previous) => ({ ...previous, step: Math.max(1, previous.step - 1) }))}>
+                Anterior
+              </Button>
+              <div className="flex gap-2">
+                <Button onClick={() => void handleSaveInfo()} disabled={isSavingInfo}>
+                  {isSavingInfo ? "Guardando..." : "Guardar Informacion"}
+                </Button>
+                <Button
+                  onClick={() =>
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      step: Math.min(6, previous.step + 1),
+                    }))
+                  }
+                >
+                  Siguiente
+                </Button>
+              </div>
+            </div>
+          </CardContent>
+        </Card>
+      ) : null}
+
+      {!isLoadingWorkflow && workflow.step === 2 ? (
+        <Card className="border-[#d8e1ef]">
+          <CardContent className="space-y-4 p-5">
+            <header className="space-y-1">
+              <p className="text-3xl font-semibold text-[#14274b] [font-family:var(--font-display)]">Checklist de Documentacion Requerida</p>
+              <p className="text-sm text-[#5f7090]">
+                {props.normativeContext
+                  ? `Requisitos extraidos con IA (${props.normativeContext.confidence}). Sube evidencia en cada requisito para marcarlo completo.`
+                  : "No hay analisis IA vinculado; completa los requisitos manualmente y sube evidencia por requisito."}
+              </p>
+            </header>
+
+            {props.normativeContext?.executiveSummary ? (
+              <p className="rounded-xl border border-[#c6d8f4] bg-[#ebf3ff] px-3 py-2 text-sm text-[#284f88]">{props.normativeContext.executiveSummary}</p>
+            ) : null}
+
+            <div className="flex flex-wrap gap-2 rounded-xl border border-[#d8e1ef] bg-[#f8fbff] p-3">
+              <Button size="sm" variant="secondary" onClick={() => void handleExtractWithAi(null)} disabled={isExtractingAi}>
+                {isExtractingAi ? "Extrayendo..." : "Actualizar requisitos y fechas con IA"}
+              </Button>
+              <Button size="sm" variant="secondary" onClick={() => aiFileInputRef.current?.click()} disabled={isExtractingAi}>
+                {isExtractingAi ? "Procesando..." : "Subir hasta 3 PDFs y extraer con IA"}
+              </Button>
+              <input
+                ref={aiFileInputRef}
+                type="file"
+                className="hidden"
+                accept=".pdf,application/pdf"
+                multiple
+                onChange={(event) => {
+                  const files = event.target.files ? Array.from(event.target.files) : [];
+                  void handleExtractWithAi(files.length > 0 ? files : null);
+                }}
+              />
+            </div>
+
+            <section className="space-y-4">
+              {groupedRequirements.length === 0 ? (
+                <p className="rounded-xl border border-[#f0deb0] bg-[#fff8e9] px-3 py-2 text-sm text-[#8d6308]">
+                  Sin requisitos detectados automaticamente. Sube un documento en M4 o agrega controles manuales.
+                </p>
+              ) : (
+                groupedRequirements.map((bucket) => (
+                  <div key={bucket.category} className="space-y-2">
+                    <p className="text-sm font-semibold uppercase tracking-[0.08em] text-[#60718f]">{categoryLabel(bucket.category)}</p>
+                    {bucket.items.map((item) => {
+                      const linkedEvidences = item.evidences
+                        .map((evidence) => {
+                          const linkedDocument = documentsById.get(evidence.documentId);
+                          return {
+                            ...evidence,
+                            fileName: linkedDocument?.fileName ?? evidence.fileName,
+                            uploadedAtIso: linkedDocument?.createdAt ?? evidence.uploadedAtIso,
+                          };
+                        })
+                        .filter((evidence) => evidence.fileName.trim().length > 0);
+                      const needsEvidence = item.status !== "na" && linkedEvidences.length === 0;
+                      const showDropzone = item.status === "pending" || needsEvidence;
+                      const isDragging = draggingRequirementId === item.id;
+                      const isUploadingThis = uploadingRequirementId === item.id;
+
+                      return (
+                        <article key={item.id} className={`rounded-xl border p-3 ${requirementTone(item.status)}`}>
+                          <div className="flex flex-wrap items-start justify-between gap-3">
+                            <div className="space-y-1">
+                              <p className="text-sm font-semibold text-[#1b2f54]">{item.title}</p>
+                              <p className="text-xs text-[#5f7090]">{item.description}</p>
+                              <p className="text-xs font-semibold text-[#4e6488]">{sourceLabel(item.source)}</p>
+                            </div>
+                            <div className="min-w-[220px] space-y-2">
+                              <select
+                                value={item.status}
+                                onChange={(event) => {
+                                  const value = event.target.value as RequirementStatus;
+                                  updateWorkflow((previous) => ({
+                                    ...previous,
+                                    requirements: previous.requirements.map((entry) =>
+                                      entry.id === item.id
+                                        ? {
+                                            ...entry,
+                                            status: value,
+                                          }
+                                        : entry,
+                                    ),
+                                  }));
+                                }}
+                                className="h-9 w-full rounded-lg border border-[#cfd8e6] px-2 text-sm"
+                              >
+                                <option value="pending">Pendiente</option>
+                                <option value="completed">Completo</option>
+                                <option value="na">No aplica</option>
+                              </select>
+                              <input
+                                value={item.note}
+                                onChange={(event) =>
+                                  updateWorkflow((previous) => ({
+                                    ...previous,
+                                    requirements: previous.requirements.map((entry) =>
+                                      entry.id === item.id
+                                        ? {
+                                            ...entry,
+                                            note: event.target.value,
+                                          }
+                                        : entry,
+                                    ),
+                                  }))
+                                }
+                                className="h-9 w-full rounded-lg border border-[#cfd8e6] px-2 text-xs"
+                                placeholder={item.status === "na" ? "Motivo de no aplica" : "Nota opcional"}
+                              />
+                            </div>
+                          </div>
+
+                          <div className="mt-3 space-y-2">
+                            {linkedEvidences.length === 0 ? (
+                              <p className="text-xs font-semibold text-[#8d6308]">Sin evidencia adjunta para este requisito.</p>
+                            ) : (
+                              <ul className="space-y-2">
+                                {linkedEvidences.map((evidence) => (
+                                  <li key={evidence.id} className="flex items-center justify-between gap-2 rounded-lg border border-[#d8e2ef] bg-white px-3 py-2 text-xs">
+                                    <div>
+                                      <p className="font-semibold text-[#1b2f54]">{evidence.fileName}</p>
+                                      <p className="text-[#627391]">{formatDateTime(evidence.uploadedAtIso)}</p>
+                                    </div>
+                                    <button
+                                      type="button"
+                                      className="font-semibold text-[#b23f50]"
+                                      onClick={() => {
+                                        removeRequirementEvidence(item.id, evidence.id);
+                                      }}
+                                    >
+                                      Quitar
+                                    </button>
+                                  </li>
+                                ))}
+                              </ul>
+                            )}
+
+                            <div
+                              className={`rounded-xl border-2 border-dashed px-3 py-3 transition ${
+                                isDragging
+                                  ? "border-[#1f3f84] bg-[#ebf3ff]"
+                                  : showDropzone
+                                    ? "border-[#93a9d4] bg-[#f4f8ff]"
+                                    : "border-[#d8e1ef] bg-[#fbfdff]"
+                              }`}
+                              onDragOver={(event) => {
+                                event.preventDefault();
+                                setDraggingRequirementId(item.id);
+                              }}
+                              onDragLeave={() => {
+                                setDraggingRequirementId((previous) => (previous === item.id ? null : previous));
+                              }}
+                              onDrop={(event) => {
+                                event.preventDefault();
+                                setDraggingRequirementId(null);
+                                const droppedFile = event.dataTransfer.files?.[0] ?? null;
+                                void handleRequirementUpload(item.id, droppedFile);
+                              }}
+                            >
+                              <p className="text-xs font-semibold text-[#33415c]">
+                                {showDropzone
+                                  ? "Archivo pendiente: arrastra aqui o usa el boton para subir evidencia de este requisito."
+                                  : "Puedes adjuntar evidencia adicional para este requisito."}
+                              </p>
+                              <div className="mt-2 flex flex-wrap items-center gap-2">
+                                <Button
+                                  size="sm"
+                                  onClick={() => requirementInputRefs.current[item.id]?.click()}
+                                  disabled={uploadingRequirementId !== null && uploadingRequirementId !== item.id}
+                                >
+                                  {isUploadingThis ? "Subiendo..." : showDropzone ? "Subir archivo pendiente" : "Agregar otro archivo"}
+                                </Button>
+                                <input
+                                  ref={(node) => {
+                                    requirementInputRefs.current[item.id] = node;
+                                  }}
+                                  type="file"
+                                  className="hidden"
+                                  accept=".pdf,.doc,.docx,.xlsx,.jpg,.jpeg,.png"
+                                  onChange={(event) => {
+                                    const file = event.target.files?.[0] ?? null;
+                                    void handleRequirementUpload(item.id, file);
+                                  }}
+                                />
+                                {showDropzone ? <p className="text-xs text-[#627391]">Tambien puedes usar drag & drop.</p> : null}
+                              </div>
+                            </div>
+                          </div>
+                        </article>
+                      );
+                    })}
+                  </div>
+                ))
+              )}
+            </section>
+
+            <div className="flex justify-between">
+              <Button variant="secondary" onClick={() => updateWorkflow((previous) => ({ ...previous, step: 1 }))}>
+                Anterior
+              </Button>
+              <Button onClick={() => updateWorkflow((previous) => ({ ...previous, step: 3 }))}>Siguiente</Button>
+            </div>
+          </CardContent>
+        </Card>
+      ) : null}
+
+      {!isLoadingWorkflow && workflow.step === 3 ? (
+        <Card className="border-[#d8e1ef]">
+          <CardContent className="space-y-4 p-5">
+            <header className="space-y-1">
+              <p className="text-3xl font-semibold text-[#14274b] [font-family:var(--font-display)]">Generador de Propuesta Tecnica</p>
+              <p className="text-sm text-[#5f7090]">
+                {workflow.technicalSections.filter((item) => item.completed).length} de {workflow.technicalSections.length} secciones completadas
+              </p>
+            </header>
+
+            <div className="space-y-2">
+              {workflow.technicalSections.map((section) => (
+                <article key={section.id} className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+                  <div className="flex flex-wrap items-center justify-between gap-2">
+                    <div>
+                      <p className="text-sm font-semibold text-[#1b2f54]">{section.title}</p>
+                      <p className="text-xs text-[#5f7090]">{section.description}</p>
+                    </div>
+                    <label className="inline-flex items-center gap-2 text-sm font-semibold text-[#33415c]">
+                      <input
+                        type="checkbox"
+                        checked={section.completed}
+                        onChange={(event) =>
+                          updateWorkflow((previous) => ({
+                            ...previous,
+                            technicalSections: previous.technicalSections.map((item) =>
+                              item.id === section.id
+                                ? {
+                                    ...item,
+                                    completed: event.target.checked,
+                                  }
+                                : item,
+                            ),
+                          }))
+                        }
+                      />
+                      {section.completed ? "Completada" : "Pendiente"}
+                    </label>
+                  </div>
+                </article>
+              ))}
+            </div>
+
+            <div className="rounded-xl border border-[#d8e1ef] bg-[#f8fbff] p-3">
+              <p className="text-sm font-semibold text-[#223a64]">Agregar nueva seccion</p>
+              <div className="mt-2 flex flex-wrap gap-2">
+                <input
+                  value={newSectionTitle}
+                  onChange={(event) => setNewSectionTitle(event.target.value)}
+                  className="h-10 min-w-[220px] flex-1 rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                  placeholder="Titulo de la seccion"
+                />
+                <Button
+                  onClick={() => {
+                    const title = newSectionTitle.trim();
+                    if (!title) {
+                      return;
+                    }
+
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      technicalSections: [
+                        ...previous.technicalSections,
+                        {
+                          id: newId("section"),
+                          title,
+                          description: "Seccion agregada manualmente.",
+                          completed: false,
+                        },
+                      ],
+                    }));
+                    setNewSectionTitle("");
+                  }}
+                >
+                  Agregar
+                </Button>
+                <Button variant="secondary" onClick={() => void handleDownloadPdf("technical")} disabled={pdfLoadingKind !== null}>
+                  {pdfLoadingKind === "technical" ? "Generando..." : "Generar PDF Propuesta Tecnica"}
+                </Button>
+              </div>
+            </div>
+
+            <div className="flex justify-between">
+              <Button variant="secondary" onClick={() => updateWorkflow((previous) => ({ ...previous, step: 2 }))}>
+                Anterior
+              </Button>
+              <Button onClick={() => updateWorkflow((previous) => ({ ...previous, step: 4 }))}>Siguiente</Button>
+            </div>
+          </CardContent>
+        </Card>
+      ) : null}
+
+      {!isLoadingWorkflow && workflow.step === 4 ? (
+        <Card className="border-[#d8e1ef]">
+          <CardContent className="space-y-4 p-5">
+            <header className="space-y-1">
+              <p className="text-3xl font-semibold text-[#14274b] [font-family:var(--font-display)]">Generador de Propuesta Economica</p>
+              <p className="text-sm text-[#5f7090]">El sistema calcula subtotal, IVA y total automaticamente.</p>
+            </header>
+
+            <div className="overflow-x-auto rounded-xl border border-[#d8e1ef] bg-white">
+              <table className="min-w-full text-sm">
+                <thead className="bg-[#f4f7fc] text-left text-[#33415c]">
+                  <tr>
+                    <th className="px-3 py-2">Concepto</th>
+                    <th className="px-3 py-2">Unidad</th>
+                    <th className="px-3 py-2">Cantidad</th>
+                    <th className="px-3 py-2">P. Unitario</th>
+                    <th className="px-3 py-2">Subtotal</th>
+                    <th className="px-3 py-2" />
+                  </tr>
+                </thead>
+                <tbody>
+                  {workflow.economicItems.map((item) => {
+                    const lineTotal = item.quantity * item.unitPrice;
+                    return (
+                      <tr key={item.id} className="border-t border-[#e4eaf4]">
+                        <td className="px-3 py-2">
+                          <input
+                            value={item.concept}
+                            onChange={(event) =>
+                              updateWorkflow((previous) => ({
+                                ...previous,
+                                economicItems: previous.economicItems.map((entry) =>
+                                  entry.id === item.id
+                                    ? {
+                                        ...entry,
+                                        concept: event.target.value,
+                                      }
+                                    : entry,
+                                ),
+                              }))
+                            }
+                            className="h-9 w-full rounded-lg border border-[#cfd8e6] px-2"
+                          />
+                        </td>
+                        <td className="px-3 py-2">
+                          <input
+                            value={item.unit}
+                            onChange={(event) =>
+                              updateWorkflow((previous) => ({
+                                ...previous,
+                                economicItems: previous.economicItems.map((entry) =>
+                                  entry.id === item.id
+                                    ? {
+                                        ...entry,
+                                        unit: event.target.value,
+                                      }
+                                    : entry,
+                                ),
+                              }))
+                            }
+                            className="h-9 w-full rounded-lg border border-[#cfd8e6] px-2"
+                          />
+                        </td>
+                        <td className="px-3 py-2">
+                          <input
+                            type="number"
+                            min={0}
+                            value={item.quantity}
+                            onChange={(event) =>
+                              updateWorkflow((previous) => ({
+                                ...previous,
+                                economicItems: previous.economicItems.map((entry) =>
+                                  entry.id === item.id
+                                    ? {
+                                        ...entry,
+                                        quantity: Number(event.target.value),
+                                      }
+                                    : entry,
+                                ),
+                              }))
+                            }
+                            className="h-9 w-full rounded-lg border border-[#cfd8e6] px-2"
+                          />
+                        </td>
+                        <td className="px-3 py-2">
+                          <input
+                            type="number"
+                            min={0}
+                            value={item.unitPrice}
+                            onChange={(event) =>
+                              updateWorkflow((previous) => ({
+                                ...previous,
+                                economicItems: previous.economicItems.map((entry) =>
+                                  entry.id === item.id
+                                    ? {
+                                        ...entry,
+                                        unitPrice: Number(event.target.value),
+                                      }
+                                    : entry,
+                                ),
+                              }))
+                            }
+                            className="h-9 w-full rounded-lg border border-[#cfd8e6] px-2"
+                          />
+                        </td>
+                        <td className="px-3 py-2 font-semibold text-[#20345a]">{formatCurrency(lineTotal)}</td>
+                        <td className="px-3 py-2 text-right">
+                          <button
+                            type="button"
+                            className="text-xs font-semibold text-[#b23f50]"
+                            onClick={() =>
+                              updateWorkflow((previous) => ({
+                                ...previous,
+                                economicItems: previous.economicItems.filter((entry) => entry.id !== item.id),
+                              }))
+                            }
+                          >
+                            Eliminar
+                          </button>
+                        </td>
+                      </tr>
+                    );
+                  })}
+                </tbody>
+              </table>
+            </div>
+
+            <div className="rounded-xl border border-[#d8e1ef] bg-[#f8fbff] p-3">
+              <p className="text-sm font-semibold text-[#223a64]">Agregar concepto</p>
+              <div className="mt-2 grid gap-2 md:grid-cols-4">
+                <input
+                  value={newConcept.concept}
+                  onChange={(event) => setNewConcept((previous) => ({ ...previous, concept: event.target.value }))}
+                  className="h-10 rounded-lg border border-[#cfd8e6] px-3 text-sm md:col-span-2"
+                  placeholder="Descripcion del bien o servicio"
+                />
+                <input
+                  value={newConcept.unit}
+                  onChange={(event) => setNewConcept((previous) => ({ ...previous, unit: event.target.value }))}
+                  className="h-10 rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                  placeholder="Unidad"
+                />
+                <input
+                  type="number"
+                  min={1}
+                  value={newConcept.quantity}
+                  onChange={(event) => setNewConcept((previous) => ({ ...previous, quantity: Number(event.target.value) }))}
+                  className="h-10 rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                  placeholder="Cantidad"
+                />
+                <input
+                  type="number"
+                  min={0}
+                  value={newConcept.unitPrice}
+                  onChange={(event) => setNewConcept((previous) => ({ ...previous, unitPrice: Number(event.target.value) }))}
+                  className="h-10 rounded-lg border border-[#cfd8e6] px-3 text-sm md:col-span-3"
+                  placeholder="Precio unitario (MXN)"
+                />
+                <Button
+                  onClick={() => {
+                    if (!newConcept.concept.trim()) {
+                      return;
+                    }
+
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      economicItems: [
+                        ...previous.economicItems,
+                        {
+                          id: newId("economic"),
+                          concept: newConcept.concept.trim(),
+                          unit: newConcept.unit.trim() || "pieza",
+                          quantity: Math.max(1, Math.round(newConcept.quantity)),
+                          unitPrice: Math.max(0, newConcept.unitPrice),
+                        },
+                      ],
+                    }));
+                    setNewConcept({
+                      concept: "",
+                      unit: "pieza",
+                      quantity: 1,
+                      unitPrice: 0,
+                    });
+                  }}
+                >
+                  Agregar
+                </Button>
+              </div>
+            </div>
+
+            <div className="rounded-xl border border-[#d8e1ef] bg-white p-3 text-sm">
+              <p className="flex items-center justify-between">
+                <span>Subtotal</span>
+                <span className="font-semibold">{formatCurrency(economicTotals.subtotal)}</span>
+              </p>
+              <p className="mt-1 flex items-center justify-between">
+                <span>IVA (16%)</span>
+                <span className="font-semibold">{formatCurrency(economicTotals.iva)}</span>
+              </p>
+              <p className="mt-2 flex items-center justify-between text-lg font-semibold text-[#1b2f54]">
+                <span>Total</span>
+                <span>{formatCurrency(economicTotals.total)}</span>
+              </p>
+            </div>
+
+            <div className="flex justify-between">
+              <Button variant="secondary" onClick={() => updateWorkflow((previous) => ({ ...previous, step: 3 }))}>
+                Anterior
+              </Button>
+              <div className="flex gap-2">
+                <Button variant="secondary" onClick={() => void handleDownloadPdf("economic")} disabled={pdfLoadingKind !== null}>
+                  {pdfLoadingKind === "economic" ? "Generando..." : "Generar PDF Propuesta Economica"}
+                </Button>
+                <Button onClick={() => updateWorkflow((previous) => ({ ...previous, step: 5 }))}>Siguiente</Button>
+              </div>
+            </div>
+          </CardContent>
+        </Card>
+      ) : null}
+
+      {!isLoadingWorkflow && workflow.step === 5 ? (
+        <Card className="border-[#d8e1ef]">
+          <CardContent className="space-y-4 p-5">
+            <header className="space-y-1">
+              <p className="text-3xl font-semibold text-[#14274b] [font-family:var(--font-display)]">Checklist Final de Validacion</p>
+              <p className="text-sm text-[#5f7090]">Solo cuando todo este completo podras marcar la propuesta como lista para envio.</p>
+            </header>
+
+            <div className="rounded-xl border border-[#d8e1ef] bg-[#f8fbff] p-3 text-sm text-[#324669]">
+              <p>
+                Requisitos obligatorios: <span className="font-semibold">{gate.resolvedCount}</span> / <span className="font-semibold">{gate.mandatoryCount}</span>
+              </p>
+              <p>Secciones tecnicas completas: {gate.technicalReady ? "Si" : "No"}</p>
+              <p>Propuesta economica completa: {gate.economicReady ? "Si" : "No"}</p>
+              <p>Fechas cargadas: {gate.datesReady ? "Si" : "No"}</p>
+              <p>Firma electronica validada: {gate.signatureReady ? "Si" : "No"}</p>
+            </div>
+
+            <section className="space-y-2">
+              {workflow.requirements.map((item) => {
+                const resolved = isRequirementResolved(item);
+                const evidenceCount = item.evidences.length;
+                return (
+                  <div key={item.id} className="flex items-center justify-between rounded-lg border border-[#d8e1ef] bg-white px-3 py-2 text-sm">
+                    <p className={!resolved ? "text-[#1b2f54]" : "text-[#5f7090]"}>{item.title}</p>
+                    <span className={`font-semibold ${resolved ? "text-[#1f8b63]" : "text-[#b23f50]"}`}>
+                      {resolved ? `${toStatusLabel(item.status)} · ${item.status === "na" ? "Sin archivo" : `${evidenceCount} archivo(s)`}` : "Pendiente de archivo"}
+                    </span>
+                  </div>
+                );
+              })}
+            </section>
+
+            <section className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+              <div className="flex flex-wrap items-start justify-between gap-3">
+                <div>
+                  <p className="text-base font-semibold text-[#1b2f54]">Cumplimiento de firma electronica</p>
+                  <p className="text-sm text-[#5f7090]">{workflow.signatureCompliance.policyName}</p>
+                  <p className="text-xs text-[#627391]">{workflow.signatureCompliance.jurisdictionLabel}</p>
+                </div>
+                <span className={`inline-flex rounded-full border px-3 py-1 text-sm font-semibold ${getSignaturePolicyTone(workflow.signatureCompliance.policyStatus)}`}>
+                  {getSignaturePolicyStatusLabel(workflow.signatureCompliance.policyStatus)}
+                </span>
+              </div>
+
+              {workflow.signatureCompliance.minimumEvidence.length > 0 ? (
+                <ul className="mt-3 space-y-1 text-sm text-[#4f6588]">
+                  {workflow.signatureCompliance.minimumEvidence.map((item, index) => (
+                    <li key={`${item}-${index}`} className="rounded-lg border border-[#e1e8f3] bg-[#f8fbff] px-3 py-2">
+                      {item}
+                    </li>
+                  ))}
+                </ul>
+              ) : (
+                <p className="mt-3 text-sm text-[#5f7090]">No hay evidencia minima configurada.</p>
+              )}
+
+              {workflow.signatureCompliance.notes ? <p className="mt-3 text-sm text-[#5f7090]">{workflow.signatureCompliance.notes}</p> : null}
+              {workflow.signatureCompliance.sourceUrl ? (
+                <a href={workflow.signatureCompliance.sourceUrl} target="_blank" rel="noreferrer" className="mt-2 inline-flex text-sm font-semibold text-[#1f3f84]">
+                  Ver fuente normativa
+                </a>
+              ) : null}
+
+              <label className="mt-3 inline-flex items-center gap-2 text-sm font-semibold text-[#33415c]">
+                <input
+                  type="checkbox"
+                  checked={workflow.signatureCompliance.validatedByLegal}
+                  onChange={(event) =>
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      signatureCompliance: {
+                        ...previous.signatureCompliance,
+                        validatedByLegal: event.target.checked,
+                      },
+                    }))
+                  }
+                />
+                Validacion legal realizada (si aplica)
+              </label>
+            </section>
+
+            <div className="rounded-xl border border-[#d8e1ef] bg-white p-3">
+              <div className="flex flex-wrap items-center justify-between gap-3">
+                <div>
+                  <p className="text-base font-semibold text-[#1b2f54]">{gate.allReady ? "Propuesta lista para envio" : "Completa los pendientes para continuar"}</p>
+                  <p className="text-sm text-[#5f7090]">{workflow.readyMarked ? "Marcada como lista para envio." : "El marcado aplica validacion estricta (100%)."}</p>
+                </div>
+                <div className="flex flex-wrap gap-2">
+                  <Button variant="secondary" onClick={() => void handleDownloadPdf("summary")} disabled={pdfLoadingKind !== null}>
+                    {pdfLoadingKind === "summary" ? "Generando..." : "Imprimir Resumen"}
+                  </Button>
+                  <Button onClick={() => void handleMarkReady()} disabled={!gate.allReady || isSavingReady}>
+                    {isSavingReady ? "Validando..." : "Marcar como Lista para Envio"}
+                  </Button>
+                </div>
+              </div>
+            </div>
+
+            <div className="flex justify-between">
+              <Button variant="secondary" onClick={() => updateWorkflow((previous) => ({ ...previous, step: 4 }))}>
+                Anterior
+              </Button>
+              <Button onClick={() => updateWorkflow((previous) => ({ ...previous, step: 6 }))}>Siguiente</Button>
+            </div>
+          </CardContent>
+        </Card>
+      ) : null}
+
+      {!isLoadingWorkflow && workflow.step === 6 ? (
+        <Card className="border-[#d8e1ef]">
+          <CardContent className="space-y-4 p-5">
+            <header className="space-y-1">
+              <p className="text-3xl font-semibold text-[#14274b] [font-family:var(--font-display)]">Fechas Importantes del Proceso</p>
+              <p className="text-sm text-[#5f7090]">Fechas extraidas automaticamente por IA y por la fuente oficial. Revisa la linea de tiempo para saber que hacer y cuando.</p>
+            </header>
+
+            <div className="flex flex-wrap gap-2 rounded-xl border border-[#d8e1ef] bg-[#f8fbff] p-3">
+              <Button size="sm" variant="secondary" onClick={() => void handleExtractWithAi(null)} disabled={isExtractingAi}>
+                {isExtractingAi ? "Actualizando..." : "Actualizar fechas con IA"}
+              </Button>
+              <Button size="sm" variant="secondary" onClick={() => aiFileInputRef.current?.click()} disabled={isExtractingAi}>
+                {isExtractingAi ? "Procesando..." : "Subir hasta 3 PDFs para actualizar fechas"}
+              </Button>
+              <input
+                ref={aiFileInputRef}
+                type="file"
+                className="hidden"
+                accept=".pdf,application/pdf"
+                multiple
+                onChange={(event) => {
+                  const files = event.target.files ? Array.from(event.target.files) : [];
+                  void handleExtractWithAi(files.length > 0 ? files : null);
+                }}
+              />
+            </div>
+
+            {sortedMilestones.length === 0 ? (
+              <p className="rounded-xl border border-[#f0deb0] bg-[#fff8e9] px-3 py-2 text-sm text-[#8d6308]">Aun no hay fechas cargadas.</p>
+            ) : (
+              <div className="relative space-y-3 pl-7">
+                <span className="pointer-events-none absolute bottom-0 left-3 top-0 w-px bg-[#d8e1ef]" />
+                {sortedMilestones.map((item) => {
+                  const timelineTone = getMilestoneTimelineTone(item.dateIso);
+                  return (
+                    <article key={item.id} className="relative rounded-xl border border-[#d8e1ef] bg-white p-3">
+                      <span className={`absolute -left-[22px] top-5 h-4 w-4 rounded-full border-2 border-white ${timelineTone.dot}`} />
+                      <div className="flex flex-wrap items-start justify-between gap-2">
+                        <div>
+                          <p className="text-sm font-semibold text-[#1b2f54]">{item.title}</p>
+                          <p className="text-xs text-[#5f7090]">{formatDateTime(item.dateIso)}</p>
+                        </div>
+                        <div className="flex flex-wrap gap-2">
+                          <span className={`rounded-full border px-2 py-0.5 text-[11px] font-semibold ${timelineTone.badge}`}>{timelineTone.label}</span>
+                          <span className="rounded-full border border-[#d8e1ef] bg-[#f8fbff] px-2 py-0.5 text-[11px] font-semibold text-[#5f7090]">
+                            {milestoneSourceLabel(item.source)}
+                          </span>
+                        </div>
+                      </div>
+
+                      {item.note ? <p className="mt-2 text-xs text-[#4e6488]">{item.note}</p> : null}
+
+                      <div className="mt-3 grid gap-2 md:grid-cols-2">
+                        <label className="space-y-1 text-xs font-semibold text-[#33415c] md:col-span-2">
+                          Evento
+                          <input
+                            value={item.title}
+                            onChange={(event) =>
+                              updateWorkflow((previous) => ({
+                                ...previous,
+                                milestones: previous.milestones.map((entry) =>
+                                  entry.id === item.id
+                                    ? {
+                                        ...entry,
+                                        title: event.target.value,
+                                      }
+                                    : entry,
+                                ),
+                              }))
+                            }
+                            className="h-9 w-full rounded-lg border border-[#cfd8e6] px-2 text-sm"
+                          />
+                        </label>
+                        <label className="space-y-1 text-xs font-semibold text-[#33415c]">
+                          Fecha y hora
+                          <input
+                            type="datetime-local"
+                            value={isoToLocalInput(item.dateIso)}
+                            onChange={(event) =>
+                              updateWorkflow((previous) => ({
+                                ...previous,
+                                milestones: previous.milestones.map((entry) =>
+                                  entry.id === item.id
+                                    ? {
+                                        ...entry,
+                                        dateIso: localInputToIso(event.target.value),
+                                      }
+                                    : entry,
+                                ),
+                              }))
+                            }
+                            className="h-9 w-full rounded-lg border border-[#cfd8e6] px-2 text-sm"
+                          />
+                        </label>
+                        <label className="space-y-1 text-xs font-semibold text-[#33415c]">
+                          Ubicacion
+                          <input
+                            value={item.location}
+                            onChange={(event) =>
+                              updateWorkflow((previous) => ({
+                                ...previous,
+                                milestones: previous.milestones.map((entry) =>
+                                  entry.id === item.id
+                                    ? {
+                                        ...entry,
+                                        location: event.target.value,
+                                      }
+                                    : entry,
+                                ),
+                              }))
+                            }
+                            className="h-9 w-full rounded-lg border border-[#cfd8e6] px-2 text-sm"
+                          />
+                        </label>
+                        <label className="space-y-1 text-xs font-semibold text-[#33415c] md:col-span-2">
+                          Nota
+                          <input
+                            value={item.note}
+                            onChange={(event) =>
+                              updateWorkflow((previous) => ({
+                                ...previous,
+                                milestones: previous.milestones.map((entry) =>
+                                  entry.id === item.id
+                                    ? {
+                                        ...entry,
+                                        note: event.target.value,
+                                      }
+                                    : entry,
+                                ),
+                              }))
+                            }
+                            className="h-9 w-full rounded-lg border border-[#cfd8e6] px-2 text-sm"
+                          />
+                        </label>
+                      </div>
+                      <div className="mt-2 flex items-center justify-end text-xs">
+                        <button
+                          type="button"
+                          className="font-semibold text-[#b23f50]"
+                          onClick={() =>
+                            updateWorkflow((previous) => ({
+                              ...previous,
+                              milestones: previous.milestones.filter((entry) => entry.id !== item.id),
+                            }))
+                          }
+                        >
+                          Eliminar
+                        </button>
+                      </div>
+                    </article>
+                  );
+                })}
+              </div>
+            )}
+
+            <div className="rounded-xl border border-[#d8e1ef] bg-[#f8fbff] p-3">
+              <p className="text-sm font-semibold text-[#223a64]">Agregar fecha</p>
+              <div className="mt-2 flex flex-wrap gap-2">
+                <input
+                  value={newMilestoneTitle}
+                  onChange={(event) => setNewMilestoneTitle(event.target.value)}
+                  className="h-10 min-w-[220px] flex-1 rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                  placeholder="Nombre del evento"
+                />
+                <Button
+                  onClick={() => {
+                    const title = newMilestoneTitle.trim();
+                    if (!title) {
+                      return;
+                    }
+
+                    updateWorkflow((previous) => ({
+                      ...previous,
+                      milestones: [
+                        ...previous.milestones,
+                        {
+                          id: newId("milestone"),
+                          title,
+                          dateIso: null,
+                          location: "",
+                          note: "",
+                          source: "manual",
+                        },
+                      ],
+                    }));
+                    setNewMilestoneTitle("");
+                  }}
+                >
+                  Agregar Fecha
+                </Button>
+              </div>
+            </div>
+
+            {props.linkedSource?.documentLinks.length ? (
+              <section className="space-y-2">
+                <p className="text-sm font-semibold uppercase tracking-[0.08em] text-[#60718f]">Documentos de la convocatoria</p>
+                <div className="grid gap-2 md:grid-cols-2">
+                  {props.linkedSource.documentLinks.map((item, index) => (
+                    <a
+                      key={`${item.url}-${index}`}
+                      href={item.url}
+                      target="_blank"
+                      rel="noreferrer"
+                      className="rounded-xl border border-[#d8e1ef] bg-white px-3 py-2 text-sm font-semibold text-[#1f3f84]"
+                    >
+                      {item.name}
+                    </a>
+                  ))}
+                </div>
+              </section>
+            ) : null}
+
+            <div className="flex justify-between">
+              <Button variant="secondary" onClick={() => updateWorkflow((previous) => ({ ...previous, step: 5 }))}>
+                Anterior
+              </Button>
+              <Button onClick={() => updateWorkflow((previous) => ({ ...previous, step: 1 }))}>Volver a inicio</Button>
+            </div>
+          </CardContent>
+        </Card>
+      ) : null}
+    </div>
+  );
+}
+
+function LinkButton({ href, label, external }: { href: string; label: string; external?: boolean }) {
+  if (external) {
+    return (
+      <a href={href} target="_blank" rel="noreferrer" className="inline-flex h-10 items-center rounded-lg border border-[#ccd6e5] px-3 text-sm font-semibold text-[#334a73] hover:bg-white">
+        {label}
+      </a>
+    );
+  }
+
+  return (
+    <Link href={href} className="inline-flex h-10 items-center rounded-lg border border-[#ccd6e5] px-3 text-sm font-semibold text-[#334a73] hover:bg-white">
+      {label}
+    </Link>
+  );
+}
diff --git a/src/components/app/proposals-management-view.tsx b/src/components/app/proposals-management-view.tsx
new file mode 100644
index 0000000..c852d9f
--- /dev/null
+++ b/src/components/app/proposals-management-view.tsx
@@ -0,0 +1,555 @@
+"use client";
+
+import Link from "next/link";
+import { useMemo, useRef, useState } from "react";
+import type { ProposalView } from "@/lib/proposals/types";
+import { getProposalStatusLabel } from "@/lib/proposals/status";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+
+type ProposalsManagementViewProps = {
+  initialProposals: ProposalView[];
+  initialSourceLicitationId?: string | null;
+};
+
+type ApiPayload = {
+  ok?: boolean;
+  error?: string;
+  proposal?: ProposalView;
+  proposals?: ProposalView[];
+};
+
+type DraftState = {
+  title: string;
+  issuingEntity: string;
+  summary: string;
+  status: ProposalView["status"];
+};
+
+const STATUS_OPTIONS: ProposalView["status"][] = ["DRAFT", "IN_PROGRESS", "SUBMITTED", "ARCHIVED"];
+
+function statusTone(status: ProposalView["status"]) {
+  if (status === "SUBMITTED") {
+    return "border-[#bce5d1] bg-[#ebf9f1] text-[#1e8b63]";
+  }
+
+  if (status === "IN_PROGRESS") {
+    return "border-[#c6d9f4] bg-[#ebf3ff] text-[#1f4f95]";
+  }
+
+  if (status === "ARCHIVED") {
+    return "border-[#d8e0ed] bg-[#f3f6fb] text-[#566b8f]";
+  }
+
+  return "border-[#f0dfb8] bg-[#fff9ea] text-[#946807]";
+}
+
+function formatDate(value: string) {
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return "Fecha no disponible";
+  }
+
+  return parsed.toLocaleString("es-MX", {
+    day: "2-digit",
+    month: "short",
+    year: "numeric",
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+}
+
+export function ProposalsManagementView({ initialProposals, initialSourceLicitationId }: ProposalsManagementViewProps) {
+  const [proposals, setProposals] = useState<ProposalView[]>(initialProposals);
+  const [query, setQuery] = useState("");
+  const [isCreateOpen, setIsCreateOpen] = useState(false);
+  const [isSubmitting, setIsSubmitting] = useState(false);
+  const [message, setMessage] = useState<string | null>(null);
+  const [errorMessage, setErrorMessage] = useState<string | null>(null);
+  const [drafts, setDrafts] = useState<Record<string, DraftState>>(() =>
+    Object.fromEntries(
+      initialProposals.map((proposal) => [
+        proposal.id,
+        {
+          title: proposal.title,
+          issuingEntity: proposal.issuingEntity,
+          summary: proposal.summary,
+          status: proposal.status,
+        },
+      ]),
+    ),
+  );
+
+  const [newProposal, setNewProposal] = useState({
+    title: "",
+    issuingEntity: "",
+    summary: "",
+    sourceLicitationId: initialSourceLicitationId ?? "",
+  });
+
+  const inputRefs = useRef<Record<string, HTMLInputElement | null>>({});
+
+  const filteredProposals = useMemo(() => {
+    const normalized = query.trim().toLowerCase();
+
+    if (!normalized) {
+      return proposals;
+    }
+
+    return proposals.filter((proposal) => {
+      const composed = `${proposal.title} ${proposal.issuingEntity} ${proposal.summary}`.toLowerCase();
+      return composed.includes(normalized);
+    });
+  }, [proposals, query]);
+
+  function setDraftField(id: string, field: keyof DraftState, value: string) {
+    setDrafts((previous) => ({
+      ...previous,
+      [id]: {
+        ...(previous[id] ?? {
+          title: "",
+          issuingEntity: "",
+          summary: "",
+          status: "DRAFT",
+        }),
+        [field]: value,
+      },
+    }));
+  }
+
+  async function reloadProposals(nextQuery = "") {
+    const response = await fetch(`/api/proposals?q=${encodeURIComponent(nextQuery)}`);
+    const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+    if (!response.ok || !payload.ok || !payload.proposals) {
+      throw new Error(payload.error ?? "No fue posible obtener propuestas.");
+    }
+
+    setProposals(payload.proposals);
+    setDrafts(
+      Object.fromEntries(
+        payload.proposals.map((proposal) => [
+          proposal.id,
+          {
+            title: proposal.title,
+            issuingEntity: proposal.issuingEntity,
+            summary: proposal.summary,
+            status: proposal.status,
+          },
+        ]),
+      ),
+    );
+  }
+
+  async function createProposal() {
+    setErrorMessage(null);
+    setMessage(null);
+    setIsSubmitting(true);
+
+    try {
+      const response = await fetch("/api/proposals", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify(newProposal),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok || !payload.proposal) {
+        setErrorMessage(payload.error ?? "No fue posible crear la propuesta.");
+        return;
+      }
+
+      const createdProposal = payload.proposal as ProposalView;
+      setProposals((previous) => [createdProposal, ...previous]);
+      setDrafts((previous) => ({
+        ...previous,
+        [createdProposal.id]: {
+          title: createdProposal.title,
+          issuingEntity: createdProposal.issuingEntity,
+          summary: createdProposal.summary,
+          status: createdProposal.status,
+        },
+      }));
+      setNewProposal({
+        title: "",
+        issuingEntity: "",
+        summary: "",
+        sourceLicitationId: initialSourceLicitationId ?? "",
+      });
+      setIsCreateOpen(false);
+      setMessage("Propuesta creada correctamente.");
+    } catch {
+      setErrorMessage("No fue posible crear la propuesta.");
+    } finally {
+      setIsSubmitting(false);
+    }
+  }
+
+  async function saveProposal(id: string) {
+    const draft = drafts[id];
+
+    if (!draft) {
+      return;
+    }
+
+    setErrorMessage(null);
+    setMessage(null);
+
+    try {
+      const response = await fetch(`/api/proposals/${id}`, {
+        method: "PATCH",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify(draft),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok || !payload.proposal) {
+        setErrorMessage(payload.error ?? "No fue posible guardar cambios.");
+        return;
+      }
+
+      const updatedProposal = payload.proposal as ProposalView;
+      setProposals((previous) => previous.map((proposal) => (proposal.id === id ? updatedProposal : proposal)));
+      setMessage("Cambios guardados.");
+    } catch {
+      setErrorMessage("No fue posible guardar cambios.");
+    }
+  }
+
+  async function deleteProposal(id: string) {
+    setErrorMessage(null);
+    setMessage(null);
+
+    try {
+      const response = await fetch(`/api/proposals/${id}`, {
+        method: "DELETE",
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok) {
+        setErrorMessage(payload.error ?? "No fue posible eliminar la propuesta.");
+        return;
+      }
+
+      setProposals((previous) => previous.filter((proposal) => proposal.id !== id));
+      setDrafts((previous) => {
+        const next = { ...previous };
+        delete next[id];
+        return next;
+      });
+      setMessage("Propuesta eliminada.");
+    } catch {
+      setErrorMessage("No fue posible eliminar la propuesta.");
+    }
+  }
+
+  async function uploadDocument(id: string, file: File) {
+    setErrorMessage(null);
+    setMessage(null);
+
+    try {
+      const formData = new FormData();
+      formData.append("file", file);
+
+      const response = await fetch(`/api/proposals/${id}/documents`, {
+        method: "POST",
+        body: formData,
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok || !payload.proposal) {
+        setErrorMessage(payload.error ?? "No fue posible subir el documento.");
+        return;
+      }
+
+      const updatedProposal = payload.proposal as ProposalView;
+      setProposals((previous) => previous.map((proposal) => (proposal.id === id ? updatedProposal : proposal)));
+      setDrafts((previous) => ({
+        ...previous,
+        [id]: {
+          ...(previous[id] ?? {
+            title: updatedProposal.title,
+            issuingEntity: updatedProposal.issuingEntity,
+            summary: updatedProposal.summary,
+            status: updatedProposal.status,
+          }),
+          status: updatedProposal.status,
+        },
+      }));
+      setMessage("Documento subido correctamente.");
+    } catch {
+      setErrorMessage("No fue posible subir el documento.");
+    }
+  }
+
+  async function deleteDocument(proposalId: string, documentId: string) {
+    setErrorMessage(null);
+    setMessage(null);
+
+    try {
+      const response = await fetch(`/api/proposals/${proposalId}/documents/${documentId}`, {
+        method: "DELETE",
+      });
+      const payload = (await response.json().catch(() => ({}))) as ApiPayload;
+
+      if (!response.ok || !payload.ok) {
+        setErrorMessage(payload.error ?? "No fue posible eliminar el documento.");
+        return;
+      }
+
+      await reloadProposals(query);
+      setMessage("Documento eliminado.");
+    } catch {
+      setErrorMessage("No fue posible eliminar el documento.");
+    }
+  }
+
+  return (
+    <div className="space-y-4">
+      <section className="flex flex-wrap items-center justify-between gap-3">
+        <label className="w-full max-w-2xl space-y-1 text-sm font-semibold text-[#314764]">
+          Buscar por titulo o entidad
+          <input
+            value={query}
+            onChange={(event) => setQuery(event.target.value)}
+            placeholder="Buscar por titulo o entidad..."
+            className="h-12 w-full rounded-xl border border-[#cfd8e6] bg-white px-4 text-base"
+          />
+        </label>
+
+        <Button size="lg" className="rounded-2xl px-6" onClick={() => setIsCreateOpen(true)}>
+          + Nueva Propuesta
+        </Button>
+      </section>
+
+      {errorMessage ? <p className="rounded-xl border border-[#efc4c4] bg-[#fff1f1] px-3 py-2 text-sm text-[#ad3f3f]">{errorMessage}</p> : null}
+      {message ? <p className="rounded-xl border border-[#bde5ce] bg-[#ecf9f1] px-3 py-2 text-sm text-[#1f7f4f]">{message}</p> : null}
+
+      {filteredProposals.length === 0 ? (
+        <Card className="border-[#cfd8e7]">
+          <CardContent className="py-16 text-center">
+            <p className="text-3xl font-semibold text-[#162748] [font-family:var(--font-display)] md:text-4xl">No hay propuestas</p>
+            <p className="mx-auto mt-2 max-w-3xl text-base text-[#5f7090] md:text-lg">Comienza creando tu primera propuesta de licitacion. El asistente te guiara paso a paso.</p>
+            <Button className="mt-6 rounded-2xl px-8" size="lg" onClick={() => setIsCreateOpen(true)}>
+              + Crear Primera Propuesta
+            </Button>
+          </CardContent>
+        </Card>
+      ) : (
+        <section className="grid gap-4 xl:grid-cols-2">
+          {filteredProposals.map((proposal) => {
+            const draft = drafts[proposal.id] ?? {
+              title: proposal.title,
+              issuingEntity: proposal.issuingEntity,
+              summary: proposal.summary,
+              status: proposal.status,
+            };
+
+            return (
+              <article key={proposal.id} className="rounded-2xl border border-[#d7dfed] bg-white p-5">
+                <div className="flex flex-wrap items-start justify-between gap-3">
+                  <div>
+                    <p className="text-xs font-semibold uppercase tracking-[0.08em] text-[#5d7091]">Actualizada {formatDate(proposal.updatedAt)}</p>
+                    <h3 className="mt-1 text-2xl font-semibold text-[#14264a]">{proposal.title}</h3>
+                    <p className="mt-1 text-xs font-semibold text-[#60718f]">
+                      Paso {proposal.currentStep}/6 · {proposal.completionPercent}% completado
+                    </p>
+                    {proposal.readyForSubmissionAt ? (
+                      <p className="mt-1 text-xs font-semibold text-[#1f8b63]">Lista para envio desde {formatDate(proposal.readyForSubmissionAt)}</p>
+                    ) : null}
+                  </div>
+                  <span className={`inline-flex rounded-full border px-3 py-1 text-sm font-semibold ${statusTone(draft.status)}`}>
+                    {getProposalStatusLabel(draft.status)}
+                  </span>
+                </div>
+
+                <div className="mt-4 grid gap-3">
+                  <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                    Titulo
+                    <input
+                      value={draft.title}
+                      onChange={(event) => setDraftField(proposal.id, "title", event.target.value)}
+                      className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                    />
+                  </label>
+
+                  <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                    Entidad emisora
+                    <input
+                      value={draft.issuingEntity}
+                      onChange={(event) => setDraftField(proposal.id, "issuingEntity", event.target.value)}
+                      className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                    />
+                  </label>
+
+                  <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                    Resumen
+                    <textarea
+                      value={draft.summary}
+                      onChange={(event) => setDraftField(proposal.id, "summary", event.target.value)}
+                      rows={3}
+                      className="w-full rounded-lg border border-[#cfd8e6] px-3 py-2 text-sm"
+                    />
+                  </label>
+
+                  <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                    Estatus
+                    <select
+                      value={draft.status}
+                      onChange={(event) => setDraftField(proposal.id, "status", event.target.value)}
+                      className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                    >
+                      {STATUS_OPTIONS.map((statusOption) => (
+                        <option key={statusOption} value={statusOption}>
+                          {getProposalStatusLabel(statusOption)}
+                        </option>
+                      ))}
+                    </select>
+                  </label>
+                </div>
+
+                <div className="mt-4 rounded-xl border border-[#d9e1ee] bg-[#f8fbff] p-3">
+                  <div
+                    className="flex min-h-[110px] cursor-pointer flex-col items-center justify-center rounded-xl border-2 border-dashed border-[#ccd7ea] bg-white text-center"
+                    onDragOver={(event) => {
+                      event.preventDefault();
+                    }}
+                    onDrop={(event) => {
+                      event.preventDefault();
+                      const dropped = event.dataTransfer.files?.[0];
+                      if (dropped) {
+                        void uploadDocument(proposal.id, dropped);
+                      }
+                    }}
+                    onClick={() => inputRefs.current[proposal.id]?.click()}
+                  >
+                    <p className="text-sm font-semibold text-[#1f3051]">Arrastra un documento aqui</p>
+                    <p className="text-xs text-[#627391]">o haz clic para seleccionar (PDF, DOC, DOCX, XLSX, JPG, PNG)</p>
+                  </div>
+                  <input
+                    ref={(element) => {
+                      inputRefs.current[proposal.id] = element;
+                    }}
+                    type="file"
+                    className="hidden"
+                    accept=".pdf,.doc,.docx,.xlsx,.jpg,.jpeg,.png"
+                    onChange={(event) => {
+                      const file = event.target.files?.[0];
+                      if (file) {
+                        void uploadDocument(proposal.id, file);
+                      }
+                      event.target.value = "";
+                    }}
+                  />
+
+                  {proposal.documents.length > 0 ? (
+                    <ul className="mt-3 space-y-2 text-sm text-[#4a5f84]">
+                      {proposal.documents.map((document) => (
+                        <li key={document.id} className="flex items-center justify-between gap-2 rounded-lg border border-[#d8e2ef] bg-white px-3 py-2">
+                          <span>{document.fileName}</span>
+                          <button
+                            type="button"
+                            className="text-xs font-semibold text-[#b23f50]"
+                            onClick={() => {
+                              void deleteDocument(proposal.id, document.id);
+                            }}
+                          >
+                            Eliminar
+                          </button>
+                        </li>
+                      ))}
+                    </ul>
+                  ) : (
+                    <p className="mt-3 text-xs text-[#627391]">Sin documentos cargados.</p>
+                  )}
+                </div>
+
+                <div className="mt-4 flex flex-wrap gap-2">
+                  <Link href={`/gestion-licitaciones/${encodeURIComponent(proposal.id)}?autofill=1`}>
+                    <Button size="sm">Continuar</Button>
+                  </Link>
+                  <Link href={`/gestion-contratos?proposalId=${encodeURIComponent(proposal.id)}&autocreate=1`}>
+                    <Button size="sm" variant="secondary">
+                      Crear contrato M8
+                    </Button>
+                  </Link>
+                  <Button size="sm" onClick={() => void saveProposal(proposal.id)}>
+                    Guardar cambios
+                  </Button>
+                  <Button size="sm" variant="secondary" onClick={() => void deleteProposal(proposal.id)}>
+                    Eliminar propuesta
+                  </Button>
+                </div>
+              </article>
+            );
+          })}
+        </section>
+      )}
+
+      {isCreateOpen ? (
+        <div className="fixed inset-0 z-50 flex items-center justify-center bg-[#0c1731]/55 p-4" role="dialog" aria-modal="true">
+          <div className="w-full max-w-2xl rounded-2xl bg-white p-5">
+            <h3 className="text-3xl font-semibold text-[#14264a] [font-family:var(--font-display)]">Nueva Propuesta</h3>
+
+            <div className="mt-4 grid gap-3">
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Titulo
+                <input
+                  value={newProposal.title}
+                  onChange={(event) => setNewProposal((previous) => ({ ...previous, title: event.target.value }))}
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                />
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Entidad emisora
+                <input
+                  value={newProposal.issuingEntity}
+                  onChange={(event) => setNewProposal((previous) => ({ ...previous, issuingEntity: event.target.value }))}
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                />
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                Resumen
+                <textarea
+                  value={newProposal.summary}
+                  onChange={(event) => setNewProposal((previous) => ({ ...previous, summary: event.target.value }))}
+                  rows={4}
+                  className="w-full rounded-lg border border-[#cfd8e6] px-3 py-2 text-sm"
+                />
+              </label>
+
+              <label className="space-y-1 text-sm font-semibold text-[#33415c]">
+                ID de oportunidad origen (opcional)
+                <input
+                  value={newProposal.sourceLicitationId}
+                  onChange={(event) => setNewProposal((previous) => ({ ...previous, sourceLicitationId: event.target.value }))}
+                  className="h-10 w-full rounded-lg border border-[#cfd8e6] px-3 text-sm"
+                  placeholder="Se autocompleta si vienes desde Modulo 3"
+                />
+              </label>
+            </div>
+
+            <div className="mt-5 flex justify-end gap-2">
+              <Button variant="secondary" onClick={() => setIsCreateOpen(false)}>
+                Cancelar
+              </Button>
+              <Button onClick={() => void createProposal()} disabled={isSubmitting}>
+                {isSubmitting ? "Creando..." : "Crear propuesta"}
+              </Button>
+            </div>
+          </div>
+        </div>
+      ) : null}
+    </div>
+  );
+}
diff --git a/src/components/app/strategic-diagnostic-wizard.tsx b/src/components/app/strategic-diagnostic-wizard.tsx
index 38b8ab6..ad69e87 100644
--- a/src/components/app/strategic-diagnostic-wizard.tsx
+++ b/src/components/app/strategic-diagnostic-wizard.tsx
@@ -25,6 +25,34 @@ type StrategicDiagnosticWizardProps = {
 
 type TabKey = StrategicSectionKey | "results";
 
+type StrategicAiInsights = {
+  sectionGaps: {
+    sectionKey: StrategicSectionKey;
+    gap: string;
+    impact: string;
+    urgency: "alta" | "media" | "baja";
+  }[];
+  priorityActions: {
+    title: string;
+    description: string;
+    priority: "alta" | "media" | "baja";
+    ownerSuggestion: string;
+    targetDateSuggestion: string;
+  }[];
+  suggestedEvidence: {
+    sectionKey: StrategicSectionKey;
+    category: string;
+    reason: string;
+  }[];
+  suggestedFieldValues: {
+    sectionKey: StrategicSectionKey;
+    fieldPath: string;
+    suggestedValue: string;
+    rationale: string;
+  }[];
+  confidence: "low" | "medium" | "high";
+};
+
 const tabItems: { key: TabKey; label: string }[] = [
   { key: "technical", label: "Capacidades Tecnicas" },
   { key: "experience", label: "Experiencia" },
@@ -135,6 +163,40 @@ function SectionScoreBar({ title, subtitle, score }: { title: string; subtitle:
   );
 }
 
+function setNestedValue(target: unknown, pathSegments: string[], value: string): unknown {
+  if (!pathSegments.length || !target || typeof target !== "object" || Array.isArray(target)) {
+    return target;
+  }
+
+  const [head, ...tail] = pathSegments;
+  const record = target as Record<string, unknown>;
+
+  if (!(head in record)) {
+    return target;
+  }
+
+  if (tail.length === 0) {
+    if (typeof record[head] !== "string") {
+      return target;
+    }
+
+    return {
+      ...record,
+      [head]: value,
+    };
+  }
+
+  const nextValue = setNestedValue(record[head], tail, value);
+  if (nextValue === record[head]) {
+    return target;
+  }
+
+  return {
+    ...record,
+    [head]: nextValue,
+  };
+}
+
 export function StrategicDiagnosticWizard({
   initialData,
   initialScores,
@@ -160,6 +222,10 @@ export function StrategicDiagnosticWizard({
     organization: STRATEGIC_EVIDENCE_CATEGORY_OPTIONS.organization[0] ?? "Otro",
     publicProcurement: STRATEGIC_EVIDENCE_CATEGORY_OPTIONS.publicProcurement[0] ?? "Otro",
   });
+  const [aiInsights, setAiInsights] = useState<StrategicAiInsights | null>(null);
+  const [aiSuggestionId, setAiSuggestionId] = useState<string | null>(null);
+  const [isLoadingAiInsights, setIsLoadingAiInsights] = useState(false);
+  const [isApplyingAiField, setIsApplyingAiField] = useState<string | null>(null);
 
   const progressPercent = useMemo(() => {
     return Math.round((scores.completedSections / scores.totalSections) * 100);
@@ -185,6 +251,20 @@ export function StrategicDiagnosticWizard({
     return tabItems[index + 1]?.key ?? "results";
   }
 
+  async function setAiDecision(decision: "accept" | "dismiss") {
+    if (!aiSuggestionId) {
+      return;
+    }
+
+    await fetch(`/api/ai/suggestions/${encodeURIComponent(aiSuggestionId)}/decision`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({ decision }),
+    });
+  }
+
   async function persistData(section: TabKey, forceCompleted = false) {
     setIsSaving(true);
     setSavingSection(section);
@@ -284,6 +364,103 @@ export function StrategicDiagnosticWizard({
     }
   }
 
+  async function generateAiInsights() {
+    setIsLoadingAiInsights(true);
+    clearFeedback();
+
+    try {
+      const response = await fetch("/api/strategic-diagnostic/ai/insights", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          data,
+          evidenceMetadata: {
+            technical: {
+              count: evidenceBySection.technical.length,
+              categories: Array.from(new Set(evidenceBySection.technical.map((item) => item.category))),
+            },
+            experience: {
+              count: evidenceBySection.experience.length,
+              categories: Array.from(new Set(evidenceBySection.experience.map((item) => item.category))),
+            },
+            organization: {
+              count: evidenceBySection.organization.length,
+              categories: Array.from(new Set(evidenceBySection.organization.map((item) => item.category))),
+            },
+            publicProcurement: {
+              count: evidenceBySection.publicProcurement.length,
+              categories: Array.from(new Set(evidenceBySection.publicProcurement.map((item) => item.category))),
+            },
+          },
+        }),
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as {
+        ok?: boolean;
+        error?: string;
+        sectionGaps?: StrategicAiInsights["sectionGaps"];
+        priorityActions?: StrategicAiInsights["priorityActions"];
+        suggestedEvidence?: StrategicAiInsights["suggestedEvidence"];
+        suggestedFieldValues?: StrategicAiInsights["suggestedFieldValues"];
+        confidence?: StrategicAiInsights["confidence"];
+        suggestionId?: string;
+      };
+
+      if (!response.ok || !payload.ok) {
+        setErrorMessage(payload.error ?? "No fue posible generar plan IA.");
+        return;
+      }
+
+      setAiInsights({
+        sectionGaps: payload.sectionGaps ?? [],
+        priorityActions: payload.priorityActions ?? [],
+        suggestedEvidence: payload.suggestedEvidence ?? [],
+        suggestedFieldValues: payload.suggestedFieldValues ?? [],
+        confidence: payload.confidence ?? "low",
+      });
+      setAiSuggestionId(payload.suggestionId ?? null);
+      setSuccessMessage("Plan sugerido por IA generado.");
+    } catch {
+      setErrorMessage("No fue posible generar plan IA.");
+    } finally {
+      setIsLoadingAiInsights(false);
+    }
+  }
+
+  async function applySuggestedFieldValue(fieldPath: string, value: string) {
+    const segments = fieldPath.split(".").map((segment) => segment.trim()).filter(Boolean);
+
+    if (!segments.length) {
+      return;
+    }
+
+    setIsApplyingAiField(fieldPath);
+    clearFeedback();
+
+    try {
+      let applied = false;
+      setData((previous) => {
+        const nextValue = setNestedValue(previous, segments, value);
+        applied = nextValue !== previous;
+        return (nextValue as StrategicDiagnosticData) ?? previous;
+      });
+
+      if (!applied) {
+        setErrorMessage("Este campo no acepta aplicacion directa desde IA. Aplica manualmente.");
+        return;
+      }
+
+      await setAiDecision("accept");
+      setSuccessMessage(`Valor sugerido aplicado: ${fieldPath}.`);
+    } catch {
+      setErrorMessage("No fue posible aplicar el valor sugerido.");
+    } finally {
+      setIsApplyingAiField(null);
+    }
+  }
+
   function addListItem(section: "technical" | "experience", field: "coverageRegions" | "certifications" | "sectorsServed", rawValue: string) {
     const value = rawValue.trim();
 
@@ -1239,6 +1416,95 @@ export function StrategicDiagnosticWizard({
             </CardContent>
           </Card>
 
+          <Card className="border-[#cfdcf4] bg-[#f7f9ff]">
+            <CardHeader>
+              <h4 className="text-3xl font-semibold text-[#1b2a46]">Plan sugerido por IA</h4>
+              <p className="text-sm text-[#60718e]">Asistencia opcional. Nunca se aplican cambios automaticamente.</p>
+            </CardHeader>
+            <CardContent className="space-y-4">
+              <div className="flex flex-wrap items-center gap-2">
+                <Button type="button" variant="secondary" disabled={isLoadingAiInsights} onClick={() => void generateAiInsights()}>
+                  {isLoadingAiInsights ? "Generando plan IA..." : "Generar plan IA"}
+                </Button>
+                {aiInsights ? (
+                  <Button
+                    type="button"
+                    variant="secondary"
+                    onClick={() => {
+                      void setAiDecision("dismiss");
+                      setAiInsights(null);
+                      setSuccessMessage("Plan IA descartado.");
+                    }}
+                  >
+                    Descartar plan IA
+                  </Button>
+                ) : null}
+                {aiInsights ? (
+                  <p className="text-xs font-semibold text-[#405578]">Confianza IA: {aiInsights.confidence}</p>
+                ) : null}
+              </div>
+
+              {!aiInsights ? <p className="text-sm text-[#60718e]">Genera un plan IA para ver brechas y acciones priorizadas.</p> : null}
+
+              {aiInsights ? (
+                <div className="space-y-4">
+                  <div>
+                    <p className="text-lg font-semibold text-[#1d335a]">Brechas por seccion</p>
+                    <ul className="mt-2 space-y-2 text-sm text-[#4f6385]">
+                      {aiInsights.sectionGaps.map((item) => (
+                        <li key={`${item.sectionKey}-${item.gap}`} className="rounded-lg border border-[#d8e1ef] bg-white px-3 py-2">
+                          <p className="font-semibold">
+                            {item.sectionKey} · {item.urgency}
+                          </p>
+                          <p>{item.gap}</p>
+                          <p className="text-xs">{item.impact}</p>
+                        </li>
+                      ))}
+                    </ul>
+                  </div>
+
+                  <div>
+                    <p className="text-lg font-semibold text-[#1d335a]">Acciones prioritarias</p>
+                    <ul className="mt-2 space-y-2 text-sm text-[#4f6385]">
+                      {aiInsights.priorityActions.map((item) => (
+                        <li key={`${item.title}-${item.priority}`} className="rounded-lg border border-[#d8e1ef] bg-white px-3 py-2">
+                          <p className="font-semibold">{item.title}</p>
+                          <p>{item.description}</p>
+                          <p className="text-xs">
+                            Prioridad: {item.priority} · Responsable sugerido: {item.ownerSuggestion} · Fecha objetivo: {item.targetDateSuggestion}
+                          </p>
+                        </li>
+                      ))}
+                    </ul>
+                  </div>
+
+                  <div>
+                    <p className="text-lg font-semibold text-[#1d335a]">Campos sugeridos para aplicar</p>
+                    <ul className="mt-2 space-y-2 text-sm text-[#4f6385]">
+                      {aiInsights.suggestedFieldValues.map((item) => (
+                        <li key={`${item.fieldPath}-${item.suggestedValue}`} className="rounded-lg border border-[#d8e1ef] bg-white px-3 py-2">
+                          <p className="font-semibold">{item.fieldPath}</p>
+                          <p className="mt-1 text-xs">{item.rationale}</p>
+                          <p className="mt-1 rounded bg-[#f5f8ff] px-2 py-1 text-xs font-semibold text-[#1d335a]">{item.suggestedValue}</p>
+                          <div className="mt-2">
+                            <Button
+                              type="button"
+                              size="sm"
+                              disabled={isApplyingAiField === item.fieldPath}
+                              onClick={() => void applySuggestedFieldValue(item.fieldPath, item.suggestedValue)}
+                            >
+                              {isApplyingAiField === item.fieldPath ? "Aplicando..." : "Aplicar valor"}
+                            </Button>
+                          </div>
+                        </li>
+                      ))}
+                    </ul>
+                  </div>
+                </div>
+              ) : null}
+            </CardContent>
+          </Card>
+
           <Card className="border-[#9bd7bf] bg-[#f6fffb]">
             <CardHeader>
               <h4 className="text-3xl font-semibold text-[#1b2a46]">Modulo 2 Completado! Siguiente paso recomendado</h4>
@@ -1255,8 +1521,8 @@ export function StrategicDiagnosticWizard({
                 <Link href="/licitations">
                   <Button variant="secondary">Ir a Modulo 3</Button>
                 </Link>
-                <Link href="/manual">
-                  <Button variant="secondary">Ir a Analisis Normativo (Modulo 4)</Button>
+                <Link href="/normative-analysis">
+                  <Button variant="secondary">Ir a Modulo 4: Analisis Normativo</Button>
                 </Link>
               </div>
             </CardContent>
diff --git a/src/lib/ai/openai.ts b/src/lib/ai/openai.ts
new file mode 100644
index 0000000..f8e7bad
--- /dev/null
+++ b/src/lib/ai/openai.ts
@@ -0,0 +1,430 @@
+import "server-only";
+
+import { z } from "zod";
+import type { AiConfidence, AiEnvelope, AiUsage, AiWarning } from "@/lib/ai/types";
+
+const DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1";
+const DEFAULT_SMART_MODEL = "gpt-4.1";
+const DEFAULT_SMART_FALLBACK_MODEL = "gpt-4.1-mini";
+const DEFAULT_TIMEOUT_MS = 75_000;
+const DEFAULT_MAX_PROMPT_CHARS = 55_000;
+const DEFAULT_RETRIES = 1;
+
+type OpenAiChatCompletionResponse = {
+  choices?: Array<{
+    message?: {
+      content?: string | null;
+    };
+  }>;
+  model?: string;
+  usage?: {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+  };
+  error?: {
+    message?: string;
+  };
+};
+
+type OpenAiCallBaseInput<T> = {
+  promptVersion: string;
+  systemPrompt: string;
+  userPrompt: string;
+  outputSchema: z.ZodType<T>;
+  model?: string | null;
+  fallbackModel?: string | null;
+  timeoutMs?: number;
+  maxPromptChars?: number;
+  retries?: number;
+  temperature?: number;
+};
+
+type OpenAiJsonSchemaInput<T> = OpenAiCallBaseInput<T> & {
+  schemaName: string;
+  jsonSchema: Record<string, unknown>;
+};
+
+type OpenAiJsonObjectInput<T> = OpenAiCallBaseInput<T> & {
+  initialWarnings?: AiWarning[];
+};
+
+type OpenAiExecutionResult<T> = {
+  data: T;
+  model: string | null;
+  usage: AiUsage | null;
+  rawResponse: Record<string, unknown> | null;
+  warnings: AiWarning[];
+};
+
+function parsePositiveInteger(value: string | undefined, fallback: number) {
+  const parsed = Number.parseInt((value ?? "").trim(), 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+
+function getOpenAiApiKey() {
+  return process.env.OPENAI_API_KEY?.trim() || process.env.API_KEY?.trim() || process.env.api_key?.trim() || "";
+}
+
+function getSmartModel() {
+  return process.env.OPENAI_SMART_MODEL?.trim() || DEFAULT_SMART_MODEL;
+}
+
+function getSmartFallbackModel() {
+  return process.env.OPENAI_SMART_FALLBACK_MODEL?.trim() || DEFAULT_SMART_FALLBACK_MODEL;
+}
+
+function getOpenAiBaseUrl() {
+  return (process.env.OPENAI_API_BASE_URL?.trim() || DEFAULT_OPENAI_BASE_URL).replace(/\/+$/, "");
+}
+
+function truncatePrompt(value: string, maxChars: number) {
+  if (value.length <= maxChars) {
+    return {
+      prompt: value,
+      truncated: false,
+    };
+  }
+
+  return {
+    prompt: `${value.slice(0, maxChars)}\n\n[TEXT_TRUNCATED_TO_${maxChars}_CHARS]`,
+    truncated: true,
+  };
+}
+
+function usageFromPayload(payload: OpenAiChatCompletionResponse): AiUsage {
+  return {
+    promptTokens: payload.usage?.prompt_tokens ?? null,
+    completionTokens: payload.usage?.completion_tokens ?? null,
+    totalTokens: payload.usage?.total_tokens ?? null,
+  };
+}
+
+function extractJsonObject(rawContent: string) {
+  const trimmed = rawContent.trim();
+
+  try {
+    return JSON.parse(trimmed) as unknown;
+  } catch {
+    // Continue with safe extraction.
+  }
+
+  const withoutFence = trimmed
+    .replace(/^```json\s*/i, "")
+    .replace(/^```\s*/i, "")
+    .replace(/\s*```$/i, "")
+    .trim();
+
+  try {
+    return JSON.parse(withoutFence) as unknown;
+  } catch {
+    // Continue with bracket extraction.
+  }
+
+  const firstBrace = withoutFence.indexOf("{");
+  const lastBrace = withoutFence.lastIndexOf("}");
+
+  if (firstBrace >= 0 && lastBrace > firstBrace) {
+    return JSON.parse(withoutFence.slice(firstBrace, lastBrace + 1)) as unknown;
+  }
+
+  throw new Error("La respuesta de OpenAI no contiene un JSON valido.");
+}
+
+function getErrorMessage(error: unknown) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+
+  return String(error);
+}
+
+function inferConfidence(value: unknown): AiConfidence | null {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+
+  const record = value as Record<string, unknown>;
+  const confidence = record.confidence;
+
+  if (confidence === "low" || confidence === "medium" || confidence === "high") {
+    return confidence;
+  }
+
+  if (typeof confidence === "number") {
+    if (confidence >= 0.8) {
+      return "high";
+    }
+
+    if (confidence >= 0.5) {
+      return "medium";
+    }
+
+    return "low";
+  }
+
+  return null;
+}
+
+async function executeOpenAiCall<T>(
+  args: {
+    promptVersion: string;
+    systemPrompt: string;
+    userPrompt: string;
+    outputSchema: z.ZodType<T>;
+    model: string;
+    responseFormat: Record<string, unknown>;
+    timeoutMs: number;
+    retries: number;
+    temperature: number;
+  },
+): Promise<OpenAiExecutionResult<T>> {
+  const apiKey = getOpenAiApiKey();
+
+  if (!apiKey) {
+    throw new Error("No se encontro API key para OpenAI (OPENAI_API_KEY o api_key).");
+  }
+
+  const warnings: AiWarning[] = [];
+  const baseUrl = getOpenAiBaseUrl();
+  const requestBody = {
+    model: args.model,
+    temperature: args.temperature,
+    response_format: args.responseFormat,
+    messages: [
+      { role: "system", content: args.systemPrompt },
+      { role: "user", content: args.userPrompt },
+    ],
+  };
+
+  let lastError: unknown = null;
+
+  for (let attempt = 0; attempt <= args.retries; attempt += 1) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), args.timeoutMs);
+
+    try {
+      const response = await fetch(`${baseUrl}/chat/completions`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify(requestBody),
+        signal: controller.signal,
+      });
+
+      const payload = (await response.json().catch(() => ({}))) as OpenAiChatCompletionResponse;
+
+      if (!response.ok) {
+        const apiMessage = payload.error?.message ? ` ${payload.error.message}` : "";
+        const retryable = response.status >= 500 || response.status === 429;
+
+        if (retryable && attempt < args.retries) {
+          warnings.push({
+            code: "retrying_openai_request",
+            message: `OpenAI devolvio ${response.status}. Reintentando (${attempt + 1}/${args.retries + 1}).`,
+          });
+          continue;
+        }
+
+        throw new Error(`OpenAI devolvio ${response.status}.${apiMessage}`);
+      }
+
+      const rawContent = payload.choices?.[0]?.message?.content;
+
+      if (!rawContent || typeof rawContent !== "string") {
+        throw new Error("OpenAI no devolvio contenido util.");
+      }
+
+      const parsedJson = extractJsonObject(rawContent);
+      const parsed = args.outputSchema.safeParse(parsedJson);
+
+      if (!parsed.success) {
+        throw new Error(`La salida de OpenAI no cumple el esquema esperado: ${parsed.error.issues[0]?.message ?? "sin detalle"}`);
+      }
+
+      return {
+        data: parsed.data,
+        model: payload.model ?? args.model,
+        usage: usageFromPayload(payload),
+        rawResponse: payload as unknown as Record<string, unknown>,
+        warnings,
+      };
+    } catch (error) {
+      lastError = error;
+
+      if (attempt < args.retries) {
+        warnings.push({
+          code: "retrying_openai_request",
+          message: `${getErrorMessage(error)} Reintentando (${attempt + 1}/${args.retries + 1}).`,
+        });
+        continue;
+      }
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+
+  throw new Error(getErrorMessage(lastError));
+}
+
+export async function callOpenAiJsonObjectFallback<T>(input: OpenAiJsonObjectInput<T>): Promise<AiEnvelope<T>> {
+  const model = input.model?.trim() || input.fallbackModel?.trim() || getSmartFallbackModel();
+  const timeoutMs = input.timeoutMs ?? parsePositiveInteger(process.env.OPENAI_SMART_TIMEOUT_MS, DEFAULT_TIMEOUT_MS);
+  const maxPromptChars = input.maxPromptChars ?? parsePositiveInteger(process.env.OPENAI_SMART_MAX_CHARS, DEFAULT_MAX_PROMPT_CHARS);
+  const retries = input.retries ?? DEFAULT_RETRIES;
+  const temperature = typeof input.temperature === "number" ? input.temperature : 0;
+  const { prompt, truncated } = truncatePrompt(input.userPrompt, maxPromptChars);
+  const warnings: AiWarning[] = [...(input.initialWarnings ?? [])];
+
+  if (truncated) {
+    warnings.push({
+      code: "prompt_truncated",
+      message: `El prompt fue truncado a ${maxPromptChars} caracteres para controlar costo y latencia.`,
+    });
+  }
+
+  const requestJson: Record<string, unknown> = {
+    model,
+    temperature,
+    response_format: {
+      type: "json_object",
+    },
+    messages: [
+      { role: "system", content: input.systemPrompt },
+      { role: "user", content: prompt },
+    ],
+  };
+
+  try {
+    const result = await executeOpenAiCall({
+      promptVersion: input.promptVersion,
+      systemPrompt: input.systemPrompt,
+      userPrompt: prompt,
+      outputSchema: input.outputSchema,
+      model,
+      responseFormat: {
+        type: "json_object",
+      },
+      timeoutMs,
+      retries,
+      temperature,
+    });
+
+    return {
+      data: result.data,
+      engine: "openai_json_object",
+      model: result.model,
+      usage: result.usage,
+      warnings: [...warnings, ...result.warnings],
+      confidence: inferConfidence(result.data),
+      promptVersion: input.promptVersion,
+      truncated,
+      requestJson,
+      responseJson: result.rawResponse,
+    };
+  } catch (error) {
+    warnings.push({
+      code: "openai_json_object_failed",
+      message: getErrorMessage(error),
+    });
+
+    return {
+      data: null,
+      engine: "empty_assist",
+      model: null,
+      usage: null,
+      warnings,
+      confidence: null,
+      promptVersion: input.promptVersion,
+      truncated,
+      requestJson,
+      responseJson: null,
+    };
+  }
+}
+
+export async function callOpenAiJsonSchema<T>(input: OpenAiJsonSchemaInput<T>): Promise<AiEnvelope<T>> {
+  const model = input.model?.trim() || getSmartModel();
+  const timeoutMs = input.timeoutMs ?? parsePositiveInteger(process.env.OPENAI_SMART_TIMEOUT_MS, DEFAULT_TIMEOUT_MS);
+  const maxPromptChars = input.maxPromptChars ?? parsePositiveInteger(process.env.OPENAI_SMART_MAX_CHARS, DEFAULT_MAX_PROMPT_CHARS);
+  const retries = input.retries ?? DEFAULT_RETRIES;
+  const temperature = typeof input.temperature === "number" ? input.temperature : 0;
+  const { prompt, truncated } = truncatePrompt(input.userPrompt, maxPromptChars);
+  const warnings: AiWarning[] = [];
+
+  if (truncated) {
+    warnings.push({
+      code: "prompt_truncated",
+      message: `El prompt fue truncado a ${maxPromptChars} caracteres para controlar costo y latencia.`,
+    });
+  }
+
+  const requestJson: Record<string, unknown> = {
+    model,
+    temperature,
+    response_format: {
+      type: "json_schema",
+      json_schema: {
+        name: input.schemaName,
+        strict: true,
+        schema: input.jsonSchema,
+      },
+    },
+    messages: [
+      { role: "system", content: input.systemPrompt },
+      { role: "user", content: prompt },
+    ],
+  };
+
+  try {
+    const result = await executeOpenAiCall({
+      promptVersion: input.promptVersion,
+      systemPrompt: input.systemPrompt,
+      userPrompt: prompt,
+      outputSchema: input.outputSchema,
+      model,
+      responseFormat: {
+        type: "json_schema",
+        json_schema: {
+          name: input.schemaName,
+          strict: true,
+          schema: input.jsonSchema,
+        },
+      },
+      timeoutMs,
+      retries,
+      temperature,
+    });
+
+    return {
+      data: result.data,
+      engine: "openai_json_schema",
+      model: result.model,
+      usage: result.usage,
+      warnings: [...warnings, ...result.warnings],
+      confidence: inferConfidence(result.data),
+      promptVersion: input.promptVersion,
+      truncated,
+      requestJson,
+      responseJson: result.rawResponse,
+    };
+  } catch (error) {
+    warnings.push({
+      code: "openai_json_schema_failed",
+      message: getErrorMessage(error),
+    });
+
+    return callOpenAiJsonObjectFallback({
+      ...input,
+      userPrompt: prompt,
+      initialWarnings: warnings,
+      model: input.fallbackModel?.trim() || getSmartFallbackModel(),
+      timeoutMs,
+      maxPromptChars,
+      retries,
+      temperature,
+    });
+  }
+}
diff --git a/src/lib/ai/suggestions.ts b/src/lib/ai/suggestions.ts
new file mode 100644
index 0000000..97f54e2
--- /dev/null
+++ b/src/lib/ai/suggestions.ts
@@ -0,0 +1,204 @@
+import "server-only";
+
+import { createHash } from "crypto";
+import { AiSuggestionStatus, type Prisma } from "@prisma/client";
+import { prisma } from "@/lib/prisma";
+import type { AiConfidence, AiDecision, AiEnvelope, AiSuggestionStatus as AiSuggestionStatusView } from "@/lib/ai/types";
+
+type CreateAiSuggestionInput = {
+  userId: string;
+  moduleKey: string;
+  featureKey: string;
+  subjectType: string;
+  subjectId: string;
+  inputForHash: unknown;
+  requestJson: unknown;
+  responseJson: unknown;
+  confidence: AiConfidence | number | null;
+  engine: string;
+  model: string | null;
+  usageJson: unknown;
+  warningsJson: unknown;
+  promptVersion: string;
+};
+
+function stableStringify(value: unknown): string {
+  if (value === null || value === undefined) {
+    return "null";
+  }
+
+  if (typeof value === "string") {
+    return JSON.stringify(value);
+  }
+
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+  }
+
+  if (typeof value === "object") {
+    const record = value as Record<string, unknown>;
+    const keys = Object.keys(record).sort();
+    return `{${keys.map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`).join(",")}}`;
+  }
+
+  return JSON.stringify(String(value));
+}
+
+function normalizeConfidence(value: AiConfidence | number | null): number | null {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    if (value >= 0 && value <= 1) {
+      return value;
+    }
+
+    if (value >= 0 && value <= 100) {
+      return value / 100;
+    }
+
+    return null;
+  }
+
+  if (value === "high") {
+    return 0.9;
+  }
+
+  if (value === "medium") {
+    return 0.65;
+  }
+
+  if (value === "low") {
+    return 0.35;
+  }
+
+  return null;
+}
+
+function toJsonValue(value: unknown): Prisma.InputJsonValue {
+  return (value ?? null) as Prisma.InputJsonValue;
+}
+
+export function createAiInputHash(input: unknown): string {
+  return createHash("sha256").update(stableStringify(input)).digest("hex");
+}
+
+export async function storeAiSuggestion(input: CreateAiSuggestionInput) {
+  const inputHash = createAiInputHash(input.inputForHash);
+
+  const existing = await prisma.aiSuggestion.findFirst({
+    where: {
+      userId: input.userId,
+      moduleKey: input.moduleKey,
+      featureKey: input.featureKey,
+      subjectType: input.subjectType,
+      subjectId: input.subjectId,
+      inputHash,
+    },
+  });
+
+  if (existing) {
+    return {
+      suggestionId: existing.id,
+      inputHash,
+      status: existing.status as AiSuggestionStatusView,
+      reused: true,
+    };
+  }
+
+  const created = await prisma.aiSuggestion.create({
+    data: {
+      userId: input.userId,
+      moduleKey: input.moduleKey,
+      featureKey: input.featureKey,
+      subjectType: input.subjectType,
+      subjectId: input.subjectId,
+      inputHash,
+      requestJson: toJsonValue(input.requestJson),
+      responseJson: toJsonValue(input.responseJson),
+      confidence: normalizeConfidence(input.confidence),
+      engine: input.engine,
+      model: input.model,
+      usageJson: toJsonValue(input.usageJson),
+      warningsJson: toJsonValue(input.warningsJson),
+      promptVersion: input.promptVersion,
+      status: AiSuggestionStatus.GENERATED,
+    },
+    select: {
+      id: true,
+      status: true,
+    },
+  });
+
+  return {
+    suggestionId: created.id,
+    inputHash,
+    status: created.status as AiSuggestionStatusView,
+    reused: false,
+  };
+}
+
+export async function storeAiSuggestionFromEnvelope<T>(
+  input: Omit<CreateAiSuggestionInput, "requestJson" | "responseJson" | "confidence" | "engine" | "model" | "usageJson" | "warningsJson" | "promptVersion"> & {
+    envelope: AiEnvelope<T>;
+    responsePayload: unknown;
+  },
+) {
+  return storeAiSuggestion({
+    userId: input.userId,
+    moduleKey: input.moduleKey,
+    featureKey: input.featureKey,
+    subjectType: input.subjectType,
+    subjectId: input.subjectId,
+    inputForHash: input.inputForHash,
+    requestJson: input.envelope.requestJson,
+    responseJson: input.responsePayload,
+    confidence: input.envelope.confidence,
+    engine: input.envelope.engine,
+    model: input.envelope.model,
+    usageJson: input.envelope.usage,
+    warningsJson: input.envelope.warnings,
+    promptVersion: input.envelope.promptVersion,
+  });
+}
+
+export async function applyAiSuggestionDecision(userId: string, suggestionId: string, decision: AiDecision) {
+  const suggestion = await prisma.aiSuggestion.findFirst({
+    where: {
+      id: suggestionId,
+      userId,
+    },
+    select: {
+      id: true,
+      status: true,
+    },
+  });
+
+  if (!suggestion) {
+    return null;
+  }
+
+  const status: AiSuggestionStatus = decision === "accept" ? AiSuggestionStatus.ACCEPTED : AiSuggestionStatus.DISMISSED;
+
+  const updated = await prisma.aiSuggestion.update({
+    where: { id: suggestionId },
+    data: {
+      status,
+      actedAt: new Date(),
+    },
+    select: {
+      id: true,
+      status: true,
+      actedAt: true,
+      updatedAt: true,
+    },
+  });
+
+  return {
+    id: updated.id,
+    status: updated.status as AiSuggestionStatusView,
+    actedAt: updated.actedAt?.toISOString() ?? null,
+    updatedAt: updated.updatedAt.toISOString(),
+  };
+}
diff --git a/src/lib/ai/types.ts b/src/lib/ai/types.ts
new file mode 100644
index 0000000..e927e8c
--- /dev/null
+++ b/src/lib/ai/types.ts
@@ -0,0 +1,31 @@
+export type AiUsage = {
+  promptTokens: number | null;
+  completionTokens: number | null;
+  totalTokens: number | null;
+};
+
+export type AiWarning = {
+  code: string;
+  message: string;
+};
+
+export type AiConfidence = "low" | "medium" | "high";
+
+export type AiSuggestionStatus = "GENERATED" | "ACCEPTED" | "DISMISSED" | "EXPIRED";
+
+export type AiDecision = "accept" | "dismiss";
+
+export type AiEngine = "openai_json_schema" | "openai_json_object" | "empty_assist";
+
+export type AiEnvelope<T> = {
+  data: T | null;
+  engine: AiEngine;
+  model: string | null;
+  usage: AiUsage | null;
+  warnings: AiWarning[];
+  confidence: AiConfidence | null;
+  promptVersion: string;
+  truncated: boolean;
+  requestJson: Record<string, unknown>;
+  responseJson: Record<string, unknown> | null;
+};
diff --git a/src/lib/audits/__tests__/dossier-continuity.integration.test.ts b/src/lib/audits/__tests__/dossier-continuity.integration.test.ts
new file mode 100644
index 0000000..c0b3824
--- /dev/null
+++ b/src/lib/audits/__tests__/dossier-continuity.integration.test.ts
@@ -0,0 +1,118 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const { prismaMock, getM7DatasetForUserMock } = vi.hoisted(() => ({
+  prismaMock: {
+    proposal: {
+      findMany: vi.fn(),
+    },
+    contractRecord: {
+      findMany: vi.fn(),
+    },
+    legalCase: {
+      findMany: vi.fn(),
+    },
+  },
+  getM7DatasetForUserMock: vi.fn(),
+}));
+
+vi.mock("@/lib/prisma", () => ({
+  prisma: prismaMock,
+}));
+
+vi.mock("@/lib/compliance/server", () => ({
+  getM7DatasetForUser: getM7DatasetForUserMock,
+}));
+
+import { buildInstitutionalDossier } from "@/lib/audits/server";
+
+describe("M4 -> M5 -> M8 -> M9 -> M10 continuity integration", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("preserves document lineage and module links in M10 dossier payload", async () => {
+    const createdAt = new Date("2026-04-15T10:00:00.000Z");
+
+    prismaMock.proposal.findMany.mockResolvedValue([
+      {
+        id: "proposal-1",
+        title: "Propuesta Integral",
+        status: "IN_PROGRESS",
+        sourceLicitationId: "licit-1",
+        documents: [
+          {
+            id: "proposal-doc-1",
+            fileName: "propuesta.pdf",
+            mimeType: "application/pdf",
+            sizeBytes: 101,
+            createdAt,
+          },
+        ],
+      },
+    ]);
+
+    prismaMock.contractRecord.findMany.mockResolvedValue([
+      {
+        id: "contract-1",
+        title: "Contrato Marco",
+        status: "ACTIVE",
+        sourceProposal: {
+          id: "proposal-1",
+          title: "Propuesta Integral",
+        },
+        deliverables: [{ id: "del-1" }],
+        payments: [{ id: "pay-1" }],
+        documents: [
+          {
+            id: "contract-doc-1",
+            fileName: "contrato-firmado.pdf",
+            mimeType: "application/pdf",
+            sizeBytes: 202,
+            kind: "SIGNED_CONTRACT",
+            createdAt,
+          },
+        ],
+      },
+    ]);
+
+    prismaMock.legalCase.findMany.mockResolvedValue([
+      {
+        id: "legal-1",
+        caseType: "CONTRACT_BREACH",
+        severity: "HIGH",
+        status: "OPEN",
+        contractId: "contract-1",
+        documents: [
+          {
+            id: "legal-doc-1",
+            title: "Escrito inicial",
+            templateKey: "general_delivery_record",
+            createdAt,
+          },
+        ],
+      },
+    ]);
+
+    getM7DatasetForUserMock.mockResolvedValue({
+      tabs: {
+        alertas: [{ severity: "high" }, { severity: "medium" }],
+      },
+    });
+
+    const dossier = await buildInstitutionalDossier("user-1");
+
+    expect(dossier.summary.proposals).toBe(1);
+    expect(dossier.summary.contracts).toBe(1);
+    expect(dossier.summary.legalCases).toBe(1);
+    expect(dossier.summary.highRiskAlerts).toBe(1);
+
+    expect(dossier.proposals[0]?.links.some((link) => link.href === "/licitations/licit-1")).toBe(true);
+
+    expect(dossier.contracts[0]?.links.some((link) => link.href === "/gestion-licitaciones/proposal-1")).toBe(true);
+    expect(dossier.contracts[0]?.documentEntries[0]?.traceLabel).toContain("propuesta M5");
+    expect(dossier.contracts[0]?.documentEntries[0]?.links.some((link) => link.href === "/api/contracts/contract-1/documents/contract-doc-1")).toBe(true);
+
+    expect(dossier.legal[0]?.links.some((link) => link.href === "/gestion-contratos?contractId=contract-1")).toBe(true);
+    expect(dossier.legal[0]?.documentEntries[0]?.traceLabel).toContain("contract-1");
+  });
+});
diff --git a/src/lib/audits/scoring.ts b/src/lib/audits/scoring.ts
new file mode 100644
index 0000000..57a28c5
--- /dev/null
+++ b/src/lib/audits/scoring.ts
@@ -0,0 +1,166 @@
+import type { AuditSimulationSectionStatus } from "@prisma/client";
+import { AUDIT_SECTION_KEYS, type AuditScoreOutput, type AuditSectionKey } from "@/lib/audits/types";
+
+type AnswerRow = {
+  questionKey: string;
+  answer: string;
+};
+
+type QuestionDefinition = {
+  key: string;
+  section: AuditSectionKey;
+  prompt: string;
+};
+
+export const AUDIT_QUESTIONNAIRE: QuestionDefinition[] = [
+  {
+    key: "fiscal_obligaciones_al_dia",
+    section: "cumplimiento_fiscal",
+    prompt: "La empresa tiene cumplimiento fiscal actualizado?",
+  },
+  {
+    key: "fiscal_opinion_positiva_sat",
+    section: "cumplimiento_fiscal",
+    prompt: "Cuenta con opinion positiva del SAT vigente?",
+  },
+  {
+    key: "laboral_imss_infonavit",
+    section: "cumplimiento_laboral",
+    prompt: "Existen evidencias de cumplimiento IMSS/INFONAVIT?",
+  },
+  {
+    key: "laboral_expedientes_personal",
+    section: "cumplimiento_laboral",
+    prompt: "Se mantienen expedientes laborales completos?",
+  },
+  {
+    key: "legal_contratos_resguardados",
+    section: "documentacion_legal",
+    prompt: "Los contratos y anexos se encuentran resguardados?",
+  },
+  {
+    key: "legal_actas_poderes",
+    section: "documentacion_legal",
+    prompt: "Las actas/poderes estan actualizados y disponibles?",
+  },
+  {
+    key: "operativo_control_entregables",
+    section: "control_operativo",
+    prompt: "Existe control formal de entregables y evidencias?",
+  },
+  {
+    key: "operativo_seguimiento_pagos",
+    section: "control_operativo",
+    prompt: "Se monitorean pagos y facturacion con trazabilidad?",
+  },
+  {
+    key: "finanzas_conciliaciones",
+    section: "transparencia_financiera",
+    prompt: "Hay conciliaciones y soporte de movimientos financieros?",
+  },
+  {
+    key: "finanzas_reportes_riesgo",
+    section: "transparencia_financiera",
+    prompt: "Se generan reportes de riesgo y controles preventivos?",
+  },
+];
+
+const ANSWER_SCORE_MAP: Record<string, number> = {
+  si: 100,
+  yes: 100,
+  parcial: 60,
+  partial: 60,
+  en_proceso: 60,
+  no: 20,
+};
+
+function normalizeAnswer(answer: string) {
+  return answer
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .toLowerCase()
+    .trim()
+    .replace(/\s+/g, "_");
+}
+
+function scoreAnswer(answer: string) {
+  const normalized = normalizeAnswer(answer);
+  return ANSWER_SCORE_MAP[normalized] ?? 40;
+}
+
+function scoreToStatus(score: number): AuditSimulationSectionStatus {
+  if (score >= 80) {
+    return "READY";
+  }
+
+  if (score >= 50) {
+    return "WARNING";
+  }
+
+  return "CRITICAL";
+}
+
+export function scoreAuditResponses(rows: AnswerRow[]): AuditScoreOutput {
+  const answersByQuestion = new Map(rows.map((row) => [row.questionKey, row.answer]));
+  const sectionAccumulator = new Map<AuditSectionKey, { total: number; count: number; missing: number }>();
+
+  for (const key of AUDIT_SECTION_KEYS) {
+    sectionAccumulator.set(key, { total: 0, count: 0, missing: 0 });
+  }
+
+  for (const question of AUDIT_QUESTIONNAIRE) {
+    const answer = answersByQuestion.get(question.key);
+    const bucket = sectionAccumulator.get(question.section);
+
+    if (!bucket) {
+      continue;
+    }
+
+    if (!answer) {
+      bucket.missing += 1;
+      continue;
+    }
+
+    bucket.total += scoreAnswer(answer);
+    bucket.count += 1;
+  }
+
+  const sections = AUDIT_SECTION_KEYS.map((sectionKey) => {
+    const bucket = sectionAccumulator.get(sectionKey) ?? { total: 0, count: 0, missing: 0 };
+    const score = bucket.count > 0 ? Math.round(bucket.total / bucket.count) : 0;
+    const status = scoreToStatus(score);
+
+    const findings: string[] = [];
+    const recommendations: string[] = [];
+
+    if (bucket.missing > 0) {
+      findings.push(`${bucket.missing} reactivos sin respuesta en esta seccion.`);
+    }
+
+    if (status === "CRITICAL") {
+      findings.push("Riesgo critico de incumplimiento en esta seccion.");
+      recommendations.push("Implementar plan correctivo inmediato y evidencia documental.");
+    } else if (status === "WARNING") {
+      findings.push("Se identifican brechas relevantes de control.");
+      recommendations.push("Cerrar brechas operativas con responsables y fechas.");
+    } else {
+      findings.push("Seccion con nivel operativo favorable.");
+      recommendations.push("Mantener controles y actualizar evidencia periodicamente.");
+    }
+
+    return {
+      key: sectionKey,
+      score,
+      status,
+      findings,
+      recommendations,
+    };
+  });
+
+  const overallScore = sections.length > 0 ? Math.round(sections.reduce((sum, item) => sum + item.score, 0) / sections.length) : 0;
+
+  return {
+    overallScore,
+    sections,
+  };
+}
diff --git a/src/lib/audits/server.ts b/src/lib/audits/server.ts
new file mode 100644
index 0000000..976be55
--- /dev/null
+++ b/src/lib/audits/server.ts
@@ -0,0 +1,640 @@
+import "server-only";
+
+import type { Prisma } from "@prisma/client";
+import { prisma } from "@/lib/prisma";
+import { getM7DatasetForUser } from "@/lib/compliance/server";
+import { scoreAuditResponses } from "@/lib/audits/scoring";
+import type {
+  AuditKpiSnapshot,
+  AuditSimulationCreateInput,
+  AuditSimulationScoreInput,
+  AuditSimulationView,
+  InstitutionalDossierFreshness,
+  InstitutionalDossierLoadStrategy,
+  InstitutionalDossierPayload,
+} from "@/lib/audits/types";
+
+function parseStringArray(value: unknown) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+
+  return value.filter((item): item is string => typeof item === "string" && item.trim().length > 0);
+}
+
+const DEFAULT_DOSSIER_STALE_MINUTES = 180;
+
+function resolveDossierStaleMinutes() {
+  const raw = process.env.DOSSIER_STALE_MINUTES?.trim();
+
+  if (!raw) {
+    return DEFAULT_DOSSIER_STALE_MINUTES;
+  }
+
+  const parsed = Number.parseInt(raw, 10);
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    return DEFAULT_DOSSIER_STALE_MINUTES;
+  }
+
+  return parsed;
+}
+
+export const INSTITUTIONAL_DOSSIER_STALE_MINUTES = resolveDossierStaleMinutes();
+
+function computeDossierFreshness(args: {
+  generatedAt: string;
+  source: "live" | "snapshot";
+  strategy: InstitutionalDossierLoadStrategy;
+  snapshotId: string | null;
+}) {
+  const generatedMs = new Date(args.generatedAt).getTime();
+  const thresholdMs = INSTITUTIONAL_DOSSIER_STALE_MINUTES * 60 * 1000;
+  const isStale = !Number.isFinite(generatedMs) || Date.now() - generatedMs > thresholdMs;
+
+  return {
+    generatedAt: args.generatedAt,
+    isStale,
+    source: args.source,
+    strategy: args.strategy,
+    snapshotId: args.snapshotId,
+    staleAfterMinutes: INSTITUTIONAL_DOSSIER_STALE_MINUTES,
+  } satisfies InstitutionalDossierFreshness;
+}
+
+function syncPayloadGeneratedAt(payload: InstitutionalDossierPayload, generatedAt: string): InstitutionalDossierPayload {
+  return {
+    ...payload,
+    generatedAt,
+  };
+}
+
+function mapSimulation(row: {
+  id: string;
+  name: string;
+  auditType: string;
+  status: "DRAFT" | "COMPLETED";
+  overallScore: number | null;
+  completedAt: Date | null;
+  createdAt: Date;
+  updatedAt: Date;
+  sections: Array<{
+    id: string;
+    simulationId: string;
+    key: string;
+    score: number | null;
+    status: "READY" | "WARNING" | "CRITICAL";
+    findingsJson: Prisma.JsonValue | null;
+    recommendationsJson: Prisma.JsonValue | null;
+  }>;
+  responses: Array<{
+    id: string;
+    simulationId: string;
+    questionKey: string;
+    answer: string;
+    evidenceRefsJson: Prisma.JsonValue | null;
+  }>;
+}): AuditSimulationView {
+  return {
+    id: row.id,
+    name: row.name,
+    auditType: row.auditType,
+    status: row.status,
+    overallScore: row.overallScore,
+    completedAt: row.completedAt ? row.completedAt.toISOString() : null,
+    createdAt: row.createdAt.toISOString(),
+    updatedAt: row.updatedAt.toISOString(),
+    sections: row.sections.map((section) => ({
+      id: section.id,
+      simulationId: section.simulationId,
+      key: section.key as AuditSimulationView["sections"][number]["key"],
+      score: section.score,
+      status: section.status,
+      findings: parseStringArray(section.findingsJson),
+      recommendations: parseStringArray(section.recommendationsJson),
+    })),
+    responses: row.responses.map((response) => ({
+      id: response.id,
+      simulationId: response.simulationId,
+      questionKey: response.questionKey,
+      answer: response.answer,
+      evidenceRefs: parseStringArray(response.evidenceRefsJson),
+    })),
+  };
+}
+
+export async function listAuditSimulationsForUser(userId: string) {
+  const rows = await prisma.auditSimulation.findMany({
+    where: { userId },
+    include: {
+      sections: {
+        orderBy: [{ key: "asc" }],
+      },
+      responses: {
+        orderBy: [{ createdAt: "desc" }],
+      },
+    },
+    orderBy: [{ updatedAt: "desc" }],
+    take: 100,
+  });
+
+  return rows.map((row) => mapSimulation(row));
+}
+
+export async function createAuditSimulationForUser(userId: string, input: AuditSimulationCreateInput) {
+  const created = await prisma.auditSimulation.create({
+    data: {
+      userId,
+      name: input.name,
+      auditType: input.auditType,
+      status: "DRAFT",
+    },
+    include: {
+      sections: true,
+      responses: true,
+    },
+  });
+
+  return mapSimulation(created);
+}
+
+export async function scoreAuditSimulationForUser(userId: string, simulationId: string, input: AuditSimulationScoreInput) {
+  const owned = await prisma.auditSimulation.findFirst({
+    where: {
+      id: simulationId,
+      userId,
+    },
+    select: { id: true },
+  });
+
+  if (!owned) {
+    return null;
+  }
+
+  const scoring = scoreAuditResponses(input.responses);
+
+  await prisma.$transaction([
+    prisma.auditChecklistResponse.deleteMany({
+      where: {
+        simulationId,
+      },
+    }),
+    prisma.auditChecklistResponse.createMany({
+      data: input.responses.map((item) => ({
+        simulationId,
+        questionKey: item.questionKey,
+        answer: item.answer,
+        evidenceRefsJson: (item.evidenceRefs ?? []) as Prisma.InputJsonValue,
+      })),
+    }),
+    ...scoring.sections.map((section) =>
+      prisma.auditSimulationSection.upsert({
+        where: {
+          simulationId_key: {
+            simulationId,
+            key: section.key,
+          },
+        },
+        update: {
+          score: section.score,
+          status: section.status,
+          findingsJson: section.findings as Prisma.InputJsonValue,
+          recommendationsJson: section.recommendations as Prisma.InputJsonValue,
+        },
+        create: {
+          simulationId,
+          key: section.key,
+          score: section.score,
+          status: section.status,
+          findingsJson: section.findings as Prisma.InputJsonValue,
+          recommendationsJson: section.recommendations as Prisma.InputJsonValue,
+        },
+      }),
+    ),
+    prisma.auditSimulation.update({
+      where: { id: simulationId },
+      data: {
+        overallScore: scoring.overallScore,
+        status: "COMPLETED",
+        completedAt: new Date(),
+      },
+    }),
+  ]);
+
+  const updated = await prisma.auditSimulation.findUnique({
+    where: { id: simulationId },
+    include: {
+      sections: {
+        orderBy: [{ key: "asc" }],
+      },
+      responses: {
+        orderBy: [{ createdAt: "desc" }],
+      },
+    },
+  });
+
+  return updated ? mapSimulation(updated) : null;
+}
+
+export async function getAuditSimulationDetail(userId: string, simulationId: string) {
+  const row = await prisma.auditSimulation.findFirst({
+    where: {
+      id: simulationId,
+      userId,
+    },
+    include: {
+      sections: {
+        orderBy: [{ key: "asc" }],
+      },
+      responses: {
+        orderBy: [{ createdAt: "desc" }],
+      },
+    },
+  });
+
+  return row ? mapSimulation(row) : null;
+}
+
+export async function getAuditKpisForUser(userId: string): Promise<AuditKpiSnapshot> {
+  const [completedAudits, latestCompleted, contractsCount, contractPdfs, proposalPdfs] = await Promise.all([
+    prisma.auditSimulation.count({
+      where: {
+        userId,
+        status: "COMPLETED",
+      },
+    }),
+    prisma.auditSimulation.findFirst({
+      where: {
+        userId,
+        status: "COMPLETED",
+      },
+      orderBy: [{ completedAt: "desc" }],
+      select: {
+        overallScore: true,
+      },
+    }),
+    prisma.contractRecord.count({
+      where: {
+        userId,
+      },
+    }),
+    prisma.contractDocument.count({
+      where: {
+        contract: {
+          userId,
+        },
+      },
+    }),
+    prisma.proposalDocument.count({
+      where: {
+        userId,
+      },
+    }),
+  ]);
+
+  return {
+    completedAudits,
+    lastScore: latestCompleted?.overallScore ?? null,
+    registeredContracts: contractsCount,
+    securedPdfs: contractPdfs + proposalPdfs,
+  };
+}
+
+export async function buildInstitutionalDossier(userId: string): Promise<InstitutionalDossierPayload> {
+  const [proposals, contracts, legalCases, m7] = await Promise.all([
+    prisma.proposal.findMany({
+      where: { userId },
+      include: {
+        documents: {
+          orderBy: [{ createdAt: "desc" }],
+          select: {
+            id: true,
+            fileName: true,
+            mimeType: true,
+            sizeBytes: true,
+            createdAt: true,
+          },
+        },
+      },
+      orderBy: [{ updatedAt: "desc" }],
+      take: 200,
+    }),
+    prisma.contractRecord.findMany({
+      where: { userId },
+      include: {
+        sourceProposal: {
+          select: {
+            id: true,
+            title: true,
+          },
+        },
+        documents: {
+          orderBy: [{ createdAt: "desc" }],
+          select: {
+            id: true,
+            fileName: true,
+            mimeType: true,
+            sizeBytes: true,
+            kind: true,
+            createdAt: true,
+          },
+        },
+        deliverables: {
+          select: { id: true },
+        },
+        payments: {
+          select: { id: true },
+        },
+      },
+      orderBy: [{ updatedAt: "desc" }],
+      take: 200,
+    }),
+    prisma.legalCase.findMany({
+      where: { userId },
+      include: {
+        documents: {
+          orderBy: [{ createdAt: "desc" }],
+          select: {
+            id: true,
+            title: true,
+            templateKey: true,
+            createdAt: true,
+          },
+        },
+      },
+      orderBy: [{ updatedAt: "desc" }],
+      take: 200,
+    }),
+    getM7DatasetForUser(userId),
+  ]);
+
+  const proposalDocuments = proposals.reduce((sum, item) => sum + item.documents.length, 0);
+  const contractDocuments = contracts.reduce((sum, item) => sum + item.documents.length, 0);
+  const legalDocuments = legalCases.reduce((sum, item) => sum + item.documents.length, 0);
+  const highRiskAlerts = m7.tabs.alertas.filter((item) => item.severity === "high").length;
+
+  const components = [
+    {
+      key: "m5" as const,
+      label: "M5 Propuestas",
+      totalItems: proposals.length,
+      withEvidence: proposals.filter((item) => item.documents.length > 0).length,
+    },
+    {
+      key: "m8" as const,
+      label: "M8 Contratos",
+      totalItems: contracts.length,
+      withEvidence: contracts.filter((item) => item.documents.length > 0).length,
+    },
+    {
+      key: "m9" as const,
+      label: "M9 Casos Legales",
+      totalItems: legalCases.length,
+      withEvidence: legalCases.filter((item) => item.documents.length > 0).length,
+    },
+    {
+      key: "m7" as const,
+      label: "M7 Alertas",
+      totalItems: m7.tabs.alertas.length,
+      withEvidence: Math.max(0, m7.tabs.alertas.length - highRiskAlerts),
+    },
+  ].map((component) => ({
+    ...component,
+    status: component.totalItems > 0 && component.withEvidence >= component.totalItems ? "completo" as const : "incompleto" as const,
+  }));
+
+  return {
+    generatedAt: new Date().toISOString(),
+    summary: {
+      contracts: contracts.length,
+      contractDocuments,
+      proposals: proposals.length,
+      proposalDocuments,
+      legalCases: legalCases.length,
+      legalDocuments,
+      highRiskAlerts,
+    },
+    components,
+    contracts: contracts.map((item) => ({
+      id: item.id,
+      title: item.title,
+      status: item.status,
+      deliverables: item.deliverables.length,
+      payments: item.payments.length,
+      documents: item.documents.length,
+      links: [
+        {
+          label: "Abrir contrato en M8",
+          href: `/gestion-contratos?contractId=${encodeURIComponent(item.id)}`,
+        },
+        {
+          label: "Abrir continuidad legal en M9",
+          href: `/proteccion-legal?contractId=${encodeURIComponent(item.id)}`,
+        },
+        ...(item.sourceProposal
+          ? [
+              {
+                label: "Ver propuesta fuente en M5",
+                href: `/gestion-licitaciones/${encodeURIComponent(item.sourceProposal.id)}`,
+              },
+            ]
+          : []),
+      ],
+      documentEntries: item.documents.map((document) => ({
+        id: document.id,
+        fileName: document.fileName,
+        kind: document.kind,
+        mimeType: document.mimeType,
+        sizeBytes: document.sizeBytes,
+        createdAt: document.createdAt.toISOString(),
+        traceLabel: item.sourceProposal
+          ? `Evidencia contractual de M8 ligada a propuesta M5: ${item.sourceProposal.title}`
+          : "Evidencia contractual cargada en M8.",
+        links: [
+          {
+            label: "Ver contexto en M8",
+            href: `/gestion-contratos?contractId=${encodeURIComponent(item.id)}&documentId=${encodeURIComponent(document.id)}`,
+          },
+          {
+            label: "Descargar evidencia",
+            href: `/api/contracts/${encodeURIComponent(item.id)}/documents/${encodeURIComponent(document.id)}`,
+          },
+          ...(item.sourceProposal
+            ? [
+                {
+                  label: "Rastrear origen en M5",
+                  href: `/gestion-licitaciones/${encodeURIComponent(item.sourceProposal.id)}`,
+                },
+              ]
+            : []),
+        ],
+      })),
+    })),
+    proposals: proposals.map((item) => ({
+      id: item.id,
+      title: item.title,
+      status: item.status,
+      documents: item.documents.length,
+      links: [
+        {
+          label: "Abrir propuesta en M5",
+          href: `/gestion-licitaciones/${encodeURIComponent(item.id)}`,
+        },
+        ...(item.sourceLicitationId
+          ? [
+              {
+                label: "Ver licitacion origen",
+                href: `/licitations/${encodeURIComponent(item.sourceLicitationId)}`,
+              },
+            ]
+          : []),
+      ],
+      documentEntries: item.documents.map((document) => ({
+        id: document.id,
+        fileName: document.fileName,
+        kind: null,
+        mimeType: document.mimeType,
+        sizeBytes: document.sizeBytes,
+        createdAt: document.createdAt.toISOString(),
+        traceLabel: item.sourceLicitationId
+          ? `Documento de propuesta M5 vinculado a licitacion ${item.sourceLicitationId}.`
+          : "Documento de propuesta cargado en M5.",
+        links: [
+          {
+            label: "Ver contexto en M5",
+            href: `/gestion-licitaciones/${encodeURIComponent(item.id)}?documentId=${encodeURIComponent(document.id)}`,
+          },
+          {
+            label: "Descargar evidencia",
+            href: `/api/proposals/${encodeURIComponent(item.id)}/documents/${encodeURIComponent(document.id)}`,
+          },
+        ],
+      })),
+    })),
+    legal: legalCases.map((item) => ({
+      id: item.id,
+      caseType: item.caseType,
+      severity: item.severity,
+      status: item.status,
+      documents: item.documents.length,
+      links: [
+        {
+          label: "Abrir caso en M9",
+          href: item.contractId
+            ? `/proteccion-legal?contractId=${encodeURIComponent(item.contractId)}`
+            : "/proteccion-legal",
+        },
+        ...(item.contractId
+          ? [
+              {
+                label: "Ver contrato asociado en M8",
+                href: `/gestion-contratos?contractId=${encodeURIComponent(item.contractId)}`,
+              },
+            ]
+          : []),
+      ],
+      documentEntries: item.documents.map((document) => ({
+        id: document.id,
+        fileName: document.title,
+        kind: document.templateKey,
+        mimeType: "text/plain",
+        sizeBytes: 0,
+        createdAt: document.createdAt.toISOString(),
+        traceLabel: item.contractId
+          ? `Escrito legal de M9 vinculado al contrato ${item.contractId}.`
+          : "Escrito legal generado en M9.",
+        links: [
+          {
+            label: "Ver contexto en M9",
+            href: item.contractId
+              ? `/proteccion-legal?contractId=${encodeURIComponent(item.contractId)}`
+              : "/proteccion-legal",
+          },
+        ],
+      })),
+    })),
+  };
+}
+
+export async function refreshInstitutionalDossierSnapshot(userId: string) {
+  const payload = await buildInstitutionalDossier(userId);
+
+  const snapshot = await prisma.institutionalDossierSnapshot.create({
+    data: {
+      userId,
+      payloadJson: payload as Prisma.InputJsonValue,
+    },
+  });
+
+  const generatedAt = snapshot.generatedAt.toISOString();
+  const syncedPayload = syncPayloadGeneratedAt(payload, generatedAt);
+
+  return {
+    id: snapshot.id,
+    generatedAt,
+    payload: syncedPayload,
+    freshness: computeDossierFreshness({
+      generatedAt,
+      source: "snapshot",
+      strategy: "snapshot",
+      snapshotId: snapshot.id,
+    }),
+  };
+}
+
+export async function getLatestInstitutionalDossierSnapshot(userId: string) {
+  const latest = await prisma.institutionalDossierSnapshot.findFirst({
+    where: {
+      userId,
+    },
+    orderBy: [{ generatedAt: "desc" }],
+    select: {
+      id: true,
+      generatedAt: true,
+      payloadJson: true,
+    },
+  });
+
+  if (!latest) {
+    return null;
+  }
+
+  const generatedAt = latest.generatedAt.toISOString();
+  const payload = syncPayloadGeneratedAt(latest.payloadJson as InstitutionalDossierPayload, generatedAt);
+
+  return {
+    id: latest.id,
+    generatedAt,
+    payload,
+  };
+}
+
+export async function getInstitutionalDossierForUser(userId: string, strategy: InstitutionalDossierLoadStrategy = "live") {
+  if (strategy === "snapshot") {
+    const latest = await getLatestInstitutionalDossierSnapshot(userId);
+
+    if (latest) {
+      return {
+        dossier: latest.payload,
+        freshness: computeDossierFreshness({
+          generatedAt: latest.generatedAt,
+          source: "snapshot",
+          strategy,
+          snapshotId: latest.id,
+        }),
+      };
+    }
+  }
+
+  const live = await buildInstitutionalDossier(userId);
+  const generatedAt = live.generatedAt;
+
+  return {
+    dossier: live,
+    freshness: computeDossierFreshness({
+      generatedAt,
+      source: "live",
+      strategy,
+      snapshotId: null,
+    }),
+  };
+}
diff --git a/src/lib/audits/types.ts b/src/lib/audits/types.ts
new file mode 100644
index 0000000..af1fca0
--- /dev/null
+++ b/src/lib/audits/types.ts
@@ -0,0 +1,176 @@
+import type { AuditSimulationSectionStatus, AuditSimulationStatus } from "@prisma/client";
+import { z } from "zod";
+
+export const AUDIT_SECTION_KEYS = [
+  "cumplimiento_fiscal",
+  "cumplimiento_laboral",
+  "documentacion_legal",
+  "control_operativo",
+  "transparencia_financiera",
+] as const;
+
+export type AuditSectionKey = (typeof AUDIT_SECTION_KEYS)[number];
+
+export type AuditKpiSnapshot = {
+  completedAudits: number;
+  lastScore: number | null;
+  registeredContracts: number;
+  securedPdfs: number;
+};
+
+export type AuditSimulationView = {
+  id: string;
+  name: string;
+  auditType: string;
+  status: AuditSimulationStatus;
+  overallScore: number | null;
+  completedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+  sections: AuditSimulationSectionView[];
+  responses: AuditChecklistResponseView[];
+};
+
+export type AuditSimulationSectionView = {
+  id: string;
+  simulationId: string;
+  key: AuditSectionKey;
+  score: number | null;
+  status: AuditSimulationSectionStatus;
+  findings: string[];
+  recommendations: string[];
+};
+
+export type AuditChecklistResponseView = {
+  id: string;
+  simulationId: string;
+  questionKey: string;
+  answer: string;
+  evidenceRefs: string[];
+};
+
+export type AuditSectionScore = {
+  key: AuditSectionKey;
+  score: number;
+  status: AuditSimulationSectionStatus;
+  findings: string[];
+  recommendations: string[];
+};
+
+export type AuditScoreOutput = {
+  overallScore: number;
+  sections: AuditSectionScore[];
+};
+
+export type InstitutionalDossierComponentStatus = {
+  key: "m5" | "m8" | "m9" | "m7";
+  label: string;
+  status: "completo" | "incompleto";
+  totalItems: number;
+  withEvidence: number;
+};
+
+export type InstitutionalDossierLoadStrategy = "live" | "snapshot";
+
+export type InstitutionalDossierEvidenceLink = {
+  label: string;
+  href: string;
+};
+
+export type InstitutionalDossierEvidenceDocument = {
+  id: string;
+  fileName: string;
+  kind: string | null;
+  mimeType: string;
+  sizeBytes: number;
+  createdAt: string;
+  traceLabel: string;
+  links: InstitutionalDossierEvidenceLink[];
+};
+
+export type InstitutionalDossierPayload = {
+  generatedAt: string;
+  summary: {
+    contracts: number;
+    contractDocuments: number;
+    proposals: number;
+    proposalDocuments: number;
+    legalCases: number;
+    legalDocuments: number;
+    highRiskAlerts: number;
+  };
+  components: InstitutionalDossierComponentStatus[];
+  contracts: Array<{
+    id: string;
+    title: string;
+    status: string;
+    deliverables: number;
+    payments: number;
+    documents: number;
+    links: InstitutionalDossierEvidenceLink[];
+    documentEntries: InstitutionalDossierEvidenceDocument[];
+  }>;
+  proposals: Array<{
+    id: string;
+    title: string;
+    status: string;
+    documents: number;
+    links: InstitutionalDossierEvidenceLink[];
+    documentEntries: InstitutionalDossierEvidenceDocument[];
+  }>;
+  legal: Array<{
+    id: string;
+    caseType: string;
+    severity: string;
+    status: string;
+    documents: number;
+    links: InstitutionalDossierEvidenceLink[];
+    documentEntries: InstitutionalDossierEvidenceDocument[];
+  }>;
+  aiFindings?: AuditAiFindings | null;
+};
+
+export type InstitutionalDossierFreshness = {
+  generatedAt: string;
+  isStale: boolean;
+  source: "live" | "snapshot";
+  strategy: InstitutionalDossierLoadStrategy;
+  snapshotId: string | null;
+  staleAfterMinutes: number;
+};
+
+export type AuditAiFindings = {
+  auditorLikelyFindings: {
+    area: string;
+    finding: string;
+    severity: "alto" | "medio" | "bajo";
+  }[];
+  missingEvidence: string[];
+  topRisks: string[];
+  remediationPlan: {
+    step: string;
+    priority: "alta" | "media" | "baja";
+    ownerSuggestion: string;
+    targetDate: string;
+  }[];
+  confidence: "low" | "medium" | "high";
+  suggestionId: string;
+};
+
+export const AuditSimulationCreateInputSchema = z.object({
+  name: z.string().trim().min(2).max(220),
+  auditType: z.string().trim().min(2).max(120),
+});
+
+export const AuditSimulationScoreInputSchema = z.object({
+  responses: z.array(
+    z.object({
+      questionKey: z.string().trim().min(2).max(120),
+      answer: z.string().trim().min(1).max(120),
+      evidenceRefs: z.array(z.string().trim().min(1).max(260)).optional(),
+    }),
+  ),
+});
+
+export type AuditSimulationCreateInput = z.infer<typeof AuditSimulationCreateInputSchema>;
+export type AuditSimulationScoreInput = z.infer<typeof AuditSimulationScoreInputSchema>;
diff --git a/src/lib/auth/module-access.ts b/src/lib/auth/module-access.ts
new file mode 100644
index 0000000..4c39948
--- /dev/null
+++ b/src/lib/auth/module-access.ts
@@ -0,0 +1,67 @@
+import "server-only";
+
+import { type ModulePlanKey, type UserRole } from "@prisma/client";
+import { isAdminIdentity } from "@/lib/auth/admin";
+import { prisma } from "@/lib/prisma";
+import { getModulePlanByModuleNumber } from "@/lib/payments/plans";
+
+function isSubscriptionValid(subscription: { isActive: boolean; startsAt: Date; expiresAt: Date | null }, now: Date) {
+  if (!subscription.isActive) {
+    return false;
+  }
+
+  if (subscription.startsAt.getTime() > now.getTime()) {
+    return false;
+  }
+
+  if (subscription.expiresAt && subscription.expiresAt.getTime() < now.getTime()) {
+    return false;
+  }
+
+  return true;
+}
+
+export async function getActivePlanKeysForUser(userId: string) {
+  const now = new Date();
+
+  const subscriptions = await prisma.modulePlanSubscription.findMany({
+    where: {
+      userId,
+      isActive: true,
+    },
+    select: {
+      planKey: true,
+      isActive: true,
+      startsAt: true,
+      expiresAt: true,
+    },
+  });
+
+  return new Set(
+    subscriptions.filter((item) => isSubscriptionValid(item, now)).map((item) => item.planKey as ModulePlanKey),
+  );
+}
+
+export async function hasAnyPaidModuleAccess(userId: string, email: string, role: UserRole) {
+  if (isAdminIdentity(email, role)) {
+    return true;
+  }
+
+  const plans = await getActivePlanKeysForUser(userId);
+  return plans.size > 0;
+}
+
+export async function hasModuleAccess(user: { id: string; email: string; role: UserRole }, moduleNumber: number) {
+  if (isAdminIdentity(user.email, user.role)) {
+    return true;
+  }
+
+  const targetPlan = getModulePlanByModuleNumber(moduleNumber);
+
+  if (!targetPlan) {
+    return true;
+  }
+
+  const activePlans = await getActivePlanKeysForUser(user.id);
+  return activePlans.has(targetPlan.key);
+}
diff --git a/src/lib/compliance/__tests__/m3-m5-m7.integration.test.ts b/src/lib/compliance/__tests__/m3-m5-m7.integration.test.ts
new file mode 100644
index 0000000..d98d1cb
--- /dev/null
+++ b/src/lib/compliance/__tests__/m3-m5-m7.integration.test.ts
@@ -0,0 +1,117 @@
+import { describe, expect, it } from "vitest";
+import { buildM7Dataset, computeM3Counters } from "@/lib/compliance/m7";
+import { ProposalWorkflowStateSchema } from "@/lib/proposals/workflow-state";
+
+function buildWorkflowWithDeadline(dateIso: string) {
+  return ProposalWorkflowStateSchema.parse({
+    step: 5,
+    info: {
+      title: "Licitacion infraestructura",
+      issuingEntity: "Gobierno municipal",
+      procedureType: "Publica",
+      jurisdiction: "Estatal",
+      state: "Nuevo Leon",
+      municipality: "Monterrey",
+      sector: "Obra publica",
+      description: "Proceso de prueba",
+      convocatoriaUrl: "https://example.com/convocatoria",
+    },
+    requirements: [
+      {
+        id: "req-critical",
+        title: "Garantia critica",
+        description: "Incumplimiento puede descalificar la propuesta",
+        category: "legal",
+        mandatory: true,
+        source: "critical_requirement",
+        status: "pending",
+        note: "",
+        evidences: [],
+      },
+    ],
+    technicalSections: [{ id: "tech-1", title: "Alcance tecnico", description: "Detalle tecnico", completed: true }],
+    economicItems: [{ id: "eco-1", concept: "Servicio", unit: "lote", quantity: 1, unitPrice: 1000 }],
+    milestones: [{ id: "mil-1", title: "Entrega", dateIso, location: "", note: "", source: "manual" }],
+    signatureCompliance: {
+      policyStatus: "condicionado",
+      policyName: "Politica piloto",
+      jurisdictionLabel: "Nuevo Leon",
+      sourceUrl: "https://www.nl.gob.mx/",
+      minimumEvidence: ["Acuse"],
+      notes: "",
+      validatedByLegal: false,
+    },
+    readyMarked: false,
+  });
+}
+
+describe("M3 -> M5 -> M7 integration", () => {
+  it("combines M3 preferences with active M5 workflow into M7 KPI snapshot", () => {
+    const now = new Date("2026-04-02T10:00:00.000Z");
+    const m3 = computeM3Counters({
+      totalOpenLicitations: 8,
+      preferences: [{ status: "REVIEWED" }, { status: "INTERESTED" }, { status: "INTERESTED" }],
+      activeLinked: 1,
+    });
+
+    const dataset = buildM7Dataset({
+      proposals: [
+        {
+          id: "proposal-1",
+          title: "Propuesta M5 activa",
+          status: "IN_PROGRESS",
+          sourceLicitationId: "licit-1",
+          workflowDraft: buildWorkflowWithDeadline("2026-04-03T09:00:00.000Z"),
+          updatedAt: now,
+        },
+      ],
+      m3,
+      dueVerifications: [],
+      now,
+    });
+
+    expect(dataset.kpis.activeLicitations).toBe(1);
+    expect(dataset.m3States.consulted).toBe(1);
+    expect(dataset.m3States.interested).toBe(2);
+    expect(dataset.m3States.active).toBe(1);
+    expect(dataset.tabs.checklist.length).toBe(1);
+    expect(dataset.tabs.panelKpi.some((item) => item.label === "M3 Consultadas")).toBe(true);
+  });
+
+  it("raises critical pending alert when high-risk pending items meet near deadlines", () => {
+    const now = new Date("2026-04-02T10:00:00.000Z");
+    const m3 = computeM3Counters({
+      totalOpenLicitations: 3,
+      preferences: [],
+      activeLinked: 1,
+    });
+
+    const dataset = buildM7Dataset({
+      proposals: [
+        {
+          id: "proposal-critical",
+          title: "Propuesta critica",
+          status: "DRAFT",
+          sourceLicitationId: "licit-2",
+          workflowDraft: buildWorkflowWithDeadline("2026-04-02T12:00:00.000Z"),
+          updatedAt: now,
+        },
+      ],
+      m3,
+      dueVerifications: [
+        {
+          sourceId: "nl-reg",
+          sourceTitle: "Reglamento NL",
+          authorityName: "Gobierno NL",
+          dueAt: "2026-04-02T11:00:00.000Z",
+          overdue: false,
+        },
+      ],
+      now,
+    });
+
+    expect(dataset.kpis.criticalPending).toBeGreaterThan(0);
+    expect(dataset.tabs.alertas.some((item) => item.kind === "critical_requirement_pending")).toBe(true);
+    expect(dataset.tabs.alertas.some((item) => item.kind === "deadline_soon")).toBe(true);
+  });
+});
diff --git a/src/lib/compliance/__tests__/m7.test.ts b/src/lib/compliance/__tests__/m7.test.ts
new file mode 100644
index 0000000..5ea87f6
--- /dev/null
+++ b/src/lib/compliance/__tests__/m7.test.ts
@@ -0,0 +1,124 @@
+import { describe, expect, it } from "vitest";
+import { buildM7Dataset, computeM3Counters } from "@/lib/compliance/m7";
+import { ProposalWorkflowStateSchema } from "@/lib/proposals/workflow-state";
+
+function buildWorkflow(overrides?: Partial<ReturnType<typeof ProposalWorkflowStateSchema.parse>>) {
+  const base = ProposalWorkflowStateSchema.parse({
+    step: 5,
+    info: {
+      title: "Proceso de prueba",
+      issuingEntity: "Entidad",
+      procedureType: "Publica",
+      jurisdiction: "Estatal",
+      state: "Nuevo Leon",
+      municipality: "Monterrey",
+      sector: "Tecnologia",
+      description: "Servicio",
+      convocatoriaUrl: "https://example.com",
+    },
+    requirements: [
+      {
+        id: "req-1",
+        title: "Requisito critico",
+        description: "Debe cumplirse",
+        category: "legal",
+        mandatory: true,
+        source: "critical_requirement",
+        status: "pending",
+        note: "",
+        evidences: [],
+      },
+    ],
+    technicalSections: [
+      {
+        id: "tech-1",
+        title: "Tecnica",
+        description: "Seccion",
+        completed: true,
+      },
+    ],
+    economicItems: [
+      {
+        id: "eco-1",
+        concept: "Concepto",
+        unit: "pieza",
+        quantity: 1,
+        unitPrice: 100,
+      },
+    ],
+    milestones: [
+      {
+        id: "mil-1",
+        title: "Entrega",
+        dateIso: "2026-04-03T10:00:00.000Z",
+        location: "",
+        note: "",
+        source: "manual",
+      },
+    ],
+    signatureCompliance: {
+      policyStatus: "requiere_validacion_legal",
+      policyName: "Politica",
+      jurisdictionLabel: "Nuevo Leon",
+      sourceUrl: "",
+      minimumEvidence: ["Opinion legal"],
+      notes: "",
+      validatedByLegal: false,
+    },
+    readyMarked: false,
+  });
+
+  return {
+    ...base,
+    ...(overrides ?? {}),
+  };
+}
+
+describe("buildM7Dataset", () => {
+  it("computes KPIs and tabs using M3+M5 inputs", () => {
+    const now = new Date("2026-04-02T10:00:00.000Z");
+    const m3 = computeM3Counters({
+      totalOpenLicitations: 10,
+      preferences: [{ status: "REVIEWED" }, { status: "INTERESTED" }],
+      activeLinked: 2,
+    });
+
+    const dataset = buildM7Dataset({
+      proposals: [
+        {
+          id: "p-1",
+          title: "Propuesta activa",
+          status: "IN_PROGRESS",
+          sourceLicitationId: "l-1",
+          workflowDraft: buildWorkflow(),
+          updatedAt: now,
+        },
+        {
+          id: "p-2",
+          title: "Archivada",
+          status: "ARCHIVED",
+          sourceLicitationId: "l-2",
+          workflowDraft: buildWorkflow(),
+          updatedAt: now,
+        },
+      ],
+      m3,
+      dueVerifications: [
+        {
+          sourceId: "nl-1",
+          sourceTitle: "Reglamento NL",
+          authorityName: "Gobierno NL",
+          dueAt: "2026-04-04T09:00:00.000Z",
+          overdue: false,
+        },
+      ],
+      now,
+    });
+
+    expect(dataset.kpis.activeLicitations).toBe(1);
+    expect(dataset.kpis.upcoming7Days).toBeGreaterThanOrEqual(2);
+    expect(dataset.kpis.criticalPending).toBeGreaterThan(0);
+    expect(dataset.m3States.consulted).toBe(1);
+    expect(dataset.m3States.interested).toBe(1);
+  });
+});
diff --git a/src/lib/compliance/__tests__/regulations.test.ts b/src/lib/compliance/__tests__/regulations.test.ts
new file mode 100644
index 0000000..3c54155
--- /dev/null
+++ b/src/lib/compliance/__tests__/regulations.test.ts
@@ -0,0 +1,78 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import {
+  listRegulationChangeAlerts,
+  resetRegulationsStateForTests,
+  runPeriodicNormativeVerification,
+  verifyOfficialNormativeSources,
+} from "@/lib/compliance/regulations";
+
+function buildResponse(etag: string, status = 200) {
+  return new Response("", {
+    status,
+    headers: {
+      etag,
+      "last-modified": "Thu, 02 Apr 2026 00:00:00 GMT",
+      "content-length": "100",
+      "content-type": "text/html",
+    },
+  });
+}
+
+describe("regulations verification", () => {
+  beforeEach(async () => {
+    await resetRegulationsStateForTests();
+    vi.useFakeTimers();
+    vi.setSystemTime(new Date("2026-04-02T10:00:00.000Z"));
+  });
+
+  afterEach(async () => {
+    vi.unstubAllGlobals();
+    vi.restoreAllMocks();
+    vi.useRealTimers();
+    await resetRegulationsStateForTests();
+  });
+
+  it("detects source changes and emits regulation update alerts", async () => {
+    const fetchMock = vi
+      .fn<(input: RequestInfo | URL, init?: RequestInit) => Promise<Response>>()
+      .mockResolvedValueOnce(buildResponse("v1"))
+      .mockResolvedValueOnce(buildResponse("v2"));
+
+    vi.stubGlobal("fetch", fetchMock);
+
+    await verifyOfficialNormativeSources(["nl-reglamento-adquisiciones-estatal"]);
+    const changed = await verifyOfficialNormativeSources(["nl-reglamento-adquisiciones-estatal"]);
+
+    expect(changed[0]?.status).toBe("warning");
+    expect(changed[0]?.changed).toBe(true);
+
+    const alerts = await listRegulationChangeAlerts(new Date("2026-04-02T10:30:00.000Z"), 30);
+    expect(alerts.some((item) => item.kind === "normative_regulation_update" && item.severity === "high")).toBe(true);
+  });
+
+  it("records failed verifications and emits pending alerts", async () => {
+    vi.stubGlobal(
+      "fetch",
+      vi.fn<(input: RequestInfo | URL, init?: RequestInit) => Promise<Response>>().mockRejectedValue(new Error("timeout")),
+    );
+
+    const result = await verifyOfficialNormativeSources(["spgg-reglamento-adquisiciones"]);
+    expect(result[0]?.status).toBe("failed");
+
+    const alerts = await listRegulationChangeAlerts(new Date("2026-04-02T11:00:00.000Z"), 30);
+    expect(alerts.some((item) => item.kind === "normative_verification_pending")).toBe(true);
+  });
+
+  it("runs periodic verification only when due", async () => {
+    vi.stubGlobal("fetch", vi.fn<(input: RequestInfo | URL, init?: RequestInit) => Promise<Response>>().mockResolvedValue(buildResponse("v1")));
+
+    const first = await runPeriodicNormativeVerification(new Date("2026-04-02T10:00:00.000Z"));
+    expect(first.checked).toBe(true);
+    expect(first.dueCount).toBeGreaterThan(0);
+    expect(first.results.length).toBe(first.dueCount);
+
+    const second = await runPeriodicNormativeVerification(new Date("2026-04-02T10:05:00.000Z"));
+    expect(second.checked).toBe(false);
+    expect(second.dueCount).toBe(0);
+  });
+});
diff --git a/src/lib/compliance/__tests__/signature-policy.test.ts b/src/lib/compliance/__tests__/signature-policy.test.ts
new file mode 100644
index 0000000..915057f
--- /dev/null
+++ b/src/lib/compliance/__tests__/signature-policy.test.ts
@@ -0,0 +1,35 @@
+import { describe, expect, it } from "vitest";
+import { evaluateSignaturePolicy } from "@/lib/compliance/signature-policy";
+
+describe("evaluateSignaturePolicy", () => {
+  it("returns conservative municipal rule for San Pedro", () => {
+    const evaluation = evaluateSignaturePolicy({
+      stateCode: "NL",
+      municipalityName: "San Pedro Garza Garcia",
+      documentType: "BASES_LICITACION",
+    });
+
+    expect(evaluation.policyStatus).toBe("requiere_validacion_legal");
+    expect(evaluation.evidenceRequired.length).toBeGreaterThan(0);
+  });
+
+  it("returns conditioned rule for Nuevo Leon state scope", () => {
+    const evaluation = evaluateSignaturePolicy({
+      stateCode: "NL",
+      municipalityName: "Monterrey",
+      documentType: "CONVOCATORIA",
+    });
+
+    expect(evaluation.policyStatus).toBe("condicionado");
+    expect(evaluation.policyName.toLowerCase()).toContain("firma electronica");
+  });
+
+  it("defaults to legal validation when jurisdiction is unknown", () => {
+    const evaluation = evaluateSignaturePolicy({
+      stateName: "Estado no configurado",
+      municipalityName: "Municipio X",
+    });
+
+    expect(evaluation.policyStatus).toBe("requiere_validacion_legal");
+  });
+});
diff --git a/src/lib/compliance/m7.ts b/src/lib/compliance/m7.ts
new file mode 100644
index 0000000..33befd7
--- /dev/null
+++ b/src/lib/compliance/m7.ts
@@ -0,0 +1,389 @@
+import type { LicitationReviewStatus, ProposalStatus } from "@prisma/client";
+import { computeWorkflowGate, ProposalWorkflowStateSchema, type ProposalWorkflowState } from "@/lib/proposals/workflow-state";
+import type {
+  ComplianceAlertView,
+  ComplianceChecklistItem,
+  ComplianceDeadlineItem,
+  CompliancePanelItem,
+  M7Dataset,
+  SignaturePolicyStatus,
+} from "@/lib/compliance/types";
+
+type ProposalM7Input = {
+  id: string;
+  title: string;
+  status: ProposalStatus;
+  sourceLicitationId: string | null;
+  workflowDraft: unknown;
+  updatedAt: Date;
+};
+
+type M3Counters = {
+  totalOpenLicitations: number;
+  reviewed: number;
+  interested: number;
+  activeLinked: number;
+};
+
+type VerificationDueItem = {
+  sourceId: string;
+  sourceTitle: string;
+  authorityName: string;
+  dueAt: string;
+  overdue: boolean;
+};
+
+const CRITICAL_DEADLINE_HOURS = 72;
+
+function parseWorkflowDraft(value: unknown) {
+  const parsed = ProposalWorkflowStateSchema.safeParse(value);
+  return parsed.success ? parsed.data : null;
+}
+
+function isCriticalRequirement(requirement: ProposalWorkflowState["requirements"][number]) {
+  if (requirement.source === "critical_requirement") {
+    return true;
+  }
+
+  const text = `${requirement.title} ${requirement.description}`.toLowerCase();
+  return /\bcritic|alto\b|descalific|inhabilit|sancion/.test(text);
+}
+
+function toSignatureStatus(workflow: ProposalWorkflowState): SignaturePolicyStatus {
+  const candidate = (workflow as ProposalWorkflowState & { signatureCompliance?: { policyStatus?: SignaturePolicyStatus } }).signatureCompliance;
+  return candidate?.policyStatus ?? "requiere_validacion_legal";
+}
+
+export function isOperationalProposal(status: ProposalStatus) {
+  return status === "DRAFT" || status === "IN_PROGRESS";
+}
+
+function toDeadlineStatus(dateIso: string, now: Date) {
+  const due = new Date(dateIso);
+  if (Number.isNaN(due.getTime())) {
+    return null;
+  }
+
+  return {
+    due,
+    overdue: due.getTime() < now.getTime(),
+  };
+}
+
+function buildChecklistRows(proposals: Array<ProposalM7Input & { workflow: ProposalWorkflowState }>): ComplianceChecklistItem[] {
+  return proposals.map((proposal) => {
+    const gate = computeWorkflowGate(proposal.workflow);
+    const completionRate = gate.mandatoryCount > 0 ? Math.round((gate.resolvedCount / gate.mandatoryCount) * 100) : 0;
+
+    return {
+      proposalId: proposal.id,
+      proposalTitle: proposal.title,
+      mandatoryResolved: gate.resolvedCount,
+      mandatoryTotal: gate.mandatoryCount,
+      completionRate,
+      signaturePolicyStatus: toSignatureStatus(proposal.workflow),
+    };
+  });
+}
+
+function buildProposalDeadlines(proposals: Array<ProposalM7Input & { workflow: ProposalWorkflowState }>, now: Date): ComplianceDeadlineItem[] {
+  const rows: ComplianceDeadlineItem[] = [];
+
+  for (const proposal of proposals) {
+    for (const milestone of proposal.workflow.milestones) {
+      if (!milestone.dateIso) {
+        continue;
+      }
+
+      const timeline = toDeadlineStatus(milestone.dateIso, now);
+      if (!timeline) {
+        continue;
+      }
+
+      rows.push({
+        id: `${proposal.id}-${milestone.id}`,
+        proposalId: proposal.id,
+        licitationId: proposal.sourceLicitationId,
+        title: milestone.title,
+        description: milestone.note || `Hito de ${proposal.title}`,
+        dueAt: timeline.due.toISOString(),
+        source: "milestone",
+        status: timeline.overdue ? "overdue" : "upcoming",
+      });
+    }
+  }
+
+  return rows;
+}
+
+function buildVerificationDeadlines(items: VerificationDueItem[]): ComplianceDeadlineItem[] {
+  return items.map((item) => ({
+    id: `verification-${item.sourceId}`,
+    proposalId: null,
+    licitationId: item.sourceId,
+    title: `Verificacion normativa: ${item.sourceTitle}`,
+    description: `${item.authorityName} (${item.overdue ? "atrasada" : "programada"})`,
+    dueAt: item.dueAt,
+    source: "normative_verification",
+    status: item.overdue ? "overdue" : "upcoming",
+  }));
+}
+
+function calculateCriticalPending(proposals: Array<ProposalM7Input & { workflow: ProposalWorkflowState }>, deadlines: ComplianceDeadlineItem[], now: Date) {
+  const deadlineByProposal = new Map<string, ComplianceDeadlineItem[]>();
+
+  for (const item of deadlines) {
+    if (!item.proposalId) {
+      continue;
+    }
+
+    const existing = deadlineByProposal.get(item.proposalId) ?? [];
+    existing.push(item);
+    deadlineByProposal.set(item.proposalId, existing);
+  }
+
+  let total = 0;
+
+  for (const proposal of proposals) {
+    const proposalDeadlines = deadlineByProposal.get(proposal.id) ?? [];
+    const hasUrgentDeadline = proposalDeadlines.some((deadline) => {
+      const due = new Date(deadline.dueAt);
+      if (Number.isNaN(due.getTime())) {
+        return false;
+      }
+
+      const diffHours = (due.getTime() - now.getTime()) / 3_600_000;
+      return diffHours <= CRITICAL_DEADLINE_HOURS;
+    });
+
+    if (!hasUrgentDeadline) {
+      continue;
+    }
+
+    const pendingCriticalRequirements = proposal.workflow.requirements.filter((item) => item.status === "pending" && isCriticalRequirement(item));
+    total += pendingCriticalRequirements.length;
+
+    if (toSignatureStatus(proposal.workflow) === "requiere_validacion_legal") {
+      total += 1;
+    }
+  }
+
+  return total;
+}
+
+function buildAlerts(args: {
+  criticalPending: number;
+  deadlines: ComplianceDeadlineItem[];
+  checklist: ComplianceChecklistItem[];
+  now: Date;
+}): ComplianceAlertView[] {
+  const alerts: ComplianceAlertView[] = [];
+
+  for (const deadline of args.deadlines) {
+    const due = new Date(deadline.dueAt);
+    const diffHours = (due.getTime() - args.now.getTime()) / 3_600_000;
+
+    if (deadline.status === "overdue") {
+      alerts.push({
+        id: `alert-overdue-${deadline.id}`,
+        proposalId: deadline.proposalId,
+        licitationId: deadline.licitationId,
+        title: `Vencido: ${deadline.title}`,
+        description: deadline.description,
+        severity: "high",
+        kind: "deadline_overdue",
+        dueAt: deadline.dueAt,
+        createdAt: args.now.toISOString(),
+      });
+      continue;
+    }
+
+    if (diffHours <= 72) {
+      alerts.push({
+        id: `alert-soon-${deadline.id}`,
+        proposalId: deadline.proposalId,
+        licitationId: deadline.licitationId,
+        title: `Vence pronto: ${deadline.title}`,
+        description: deadline.description,
+        severity: diffHours <= 24 ? "high" : "medium",
+        kind: "deadline_soon",
+        dueAt: deadline.dueAt,
+        createdAt: args.now.toISOString(),
+      });
+    }
+  }
+
+  if (args.criticalPending > 0) {
+    alerts.unshift({
+      id: "alert-critical-pending",
+      proposalId: null,
+      licitationId: null,
+      title: "Pendientes criticos detectados",
+      description: `${args.criticalPending} pendientes combinan severidad alta con plazo inminente o vencido.`,
+      severity: "high",
+      kind: "critical_requirement_pending",
+      dueAt: null,
+      createdAt: args.now.toISOString(),
+    });
+  }
+
+  for (const item of args.checklist) {
+    if (item.signaturePolicyStatus === "requiere_validacion_legal") {
+      alerts.push({
+        id: `alert-signature-${item.proposalId}`,
+        proposalId: item.proposalId,
+        licitationId: null,
+        title: `Firma electronica: validacion legal requerida`,
+        description: `La propuesta ${item.proposalTitle} conserva semaforo conservador de firma.`,
+        severity: "medium",
+        kind: "signature_policy",
+        dueAt: null,
+        createdAt: args.now.toISOString(),
+      });
+    }
+  }
+
+  return alerts;
+}
+
+function buildPanelRows(dataset: {
+  activeLicitations: number;
+  completionRate: number;
+  criticalPending: number;
+  upcoming7Days: number;
+  reviewed: number;
+  interested: number;
+}) {
+  const panel: CompliancePanelItem[] = [
+    {
+      id: "panel-active",
+      label: "Licitaciones activas",
+      value: String(dataset.activeLicitations),
+      tone: dataset.activeLicitations > 0 ? "success" : "neutral",
+    },
+    {
+      id: "panel-completion",
+      label: "Completitud obligatoria",
+      value: `${dataset.completionRate}%`,
+      tone: dataset.completionRate >= 70 ? "success" : dataset.completionRate >= 40 ? "warning" : "danger",
+    },
+    {
+      id: "panel-critical",
+      label: "Pendientes criticos",
+      value: String(dataset.criticalPending),
+      tone: dataset.criticalPending > 0 ? "danger" : "success",
+    },
+    {
+      id: "panel-upcoming",
+      label: "Proximos 7 dias",
+      value: String(dataset.upcoming7Days),
+      tone: dataset.upcoming7Days > 0 ? "warning" : "neutral",
+    },
+    {
+      id: "panel-consulted",
+      label: "M3 Consultadas",
+      value: String(dataset.reviewed),
+      tone: "neutral",
+    },
+    {
+      id: "panel-interested",
+      label: "M3 Me interesa",
+      value: String(dataset.interested),
+      tone: "neutral",
+    },
+  ];
+
+  return panel;
+}
+
+export function computeM3Counters(args: {
+  totalOpenLicitations: number;
+  preferences: Array<{ status: LicitationReviewStatus }>;
+  activeLinked: number;
+}): M3Counters {
+  const reviewed = args.preferences.filter((item) => item.status === "REVIEWED").length;
+  const interested = args.preferences.filter((item) => item.status === "INTERESTED").length;
+
+  return {
+    totalOpenLicitations: Math.max(0, args.totalOpenLicitations),
+    reviewed,
+    interested,
+    activeLinked: Math.max(0, args.activeLinked),
+  };
+}
+
+export function buildM7Dataset(args: {
+  proposals: ProposalM7Input[];
+  m3: M3Counters;
+  dueVerifications: VerificationDueItem[];
+  externalAlerts?: ComplianceAlertView[];
+  now?: Date;
+}): M7Dataset {
+  const now = args.now ?? new Date();
+  const horizon = new Date(now);
+  horizon.setUTCDate(horizon.getUTCDate() + 7);
+
+  const activeProposals = args.proposals
+    .filter((proposal) => isOperationalProposal(proposal.status))
+    .map((proposal) => ({
+      ...proposal,
+      workflow: parseWorkflowDraft(proposal.workflowDraft),
+    }))
+    .filter((proposal): proposal is ProposalM7Input & { workflow: ProposalWorkflowState } => Boolean(proposal.workflow));
+
+  const checklist = buildChecklistRows(activeProposals);
+  const proposalDeadlines = buildProposalDeadlines(activeProposals, now);
+  const verificationDeadlines = buildVerificationDeadlines(args.dueVerifications);
+  const allDeadlines = [...proposalDeadlines, ...verificationDeadlines].sort((left, right) => new Date(left.dueAt).getTime() - new Date(right.dueAt).getTime());
+
+  const mandatoryResolved = checklist.reduce((sum, item) => sum + item.mandatoryResolved, 0);
+  const mandatoryTotal = checklist.reduce((sum, item) => sum + item.mandatoryTotal, 0);
+  const completionRate = mandatoryTotal > 0 ? Math.round((mandatoryResolved / mandatoryTotal) * 100) : 0;
+  const upcoming7Days = allDeadlines.filter((item) => {
+    const dueAt = new Date(item.dueAt);
+    return !Number.isNaN(dueAt.getTime()) && dueAt <= horizon;
+  }).length;
+
+  const criticalPending = calculateCriticalPending(activeProposals, allDeadlines, now);
+  const generatedAlerts = buildAlerts({
+    criticalPending,
+    deadlines: allDeadlines,
+    checklist,
+    now,
+  });
+  const alerts = [...generatedAlerts, ...(args.externalAlerts ?? [])];
+
+  const reviewed = args.m3.reviewed;
+  const interested = args.m3.interested;
+  const knownStatus = reviewed + interested;
+  const estimatedNew = Math.max(0, args.m3.totalOpenLicitations - knownStatus);
+
+  return {
+    generatedAt: now.toISOString(),
+    kpis: {
+      activeLicitations: activeProposals.length,
+      completionRate,
+      criticalPending,
+      upcoming7Days,
+    },
+    m3States: {
+      consulted: reviewed,
+      interested,
+      active: args.m3.activeLinked,
+      new: estimatedNew,
+    },
+    tabs: {
+      plazos: allDeadlines,
+      alertas: alerts,
+      checklist,
+      panelKpi: buildPanelRows({
+        activeLicitations: activeProposals.length,
+        completionRate,
+        criticalPending,
+        upcoming7Days,
+        reviewed,
+        interested,
+      }),
+    },
+  };
+}
diff --git a/src/lib/compliance/regulations.ts b/src/lib/compliance/regulations.ts
new file mode 100644
index 0000000..ebc9229
--- /dev/null
+++ b/src/lib/compliance/regulations.ts
@@ -0,0 +1,735 @@
+import { createHash } from "node:crypto";
+import { NormativeVerificationStatus, OfficialNormativeSourceType } from "@prisma/client";
+import type {
+  ComplianceAlertView,
+  NormativeVerificationResultView,
+  OfficialNormativeSourceView,
+  OfficialNormativeSuggestionInput,
+} from "@/lib/compliance/types";
+import { prisma } from "@/lib/prisma";
+
+type InternalVerificationState = {
+  lastKnownHash: string | null;
+  lastVerifiedAt: string | null;
+  nextCheckAt: string | null;
+  lastStatus: "success" | "warning" | "failed" | null;
+  lastMessage: string | null;
+  lastChangedAt: string | null;
+};
+
+const DEFAULT_CHECK_INTERVAL_DAYS = 7;
+const VERIFY_TIMEOUT_MS = 15_000;
+const TEST_ENV = process.env.NODE_ENV === "test";
+
+const DEFAULT_OFFICIAL_SOURCES: OfficialNormativeSourceView[] = [
+  {
+    id: "nl-ley-adquisiciones-estatal",
+    stateCode: "NL",
+    stateName: "Nuevo Leon",
+    municipalityCode: null,
+    municipalityName: null,
+    authorityName: "Gobierno del Estado de Nuevo Leon",
+    title: "Ley de Adquisiciones, Arrendamientos y Contratacion de Servicios del Estado de Nuevo Leon",
+    officialUrl: "https://www.hcnl.gob.mx/trabajo_legislativo/leyes/",
+    sourceType: "ley",
+    versionLabel: null,
+    lastKnownHash: null,
+    lastVerifiedAt: null,
+    nextCheckAt: null,
+    isPilot: true,
+  },
+  {
+    id: "nl-reglamento-adquisiciones-estatal",
+    stateCode: "NL",
+    stateName: "Nuevo Leon",
+    municipalityCode: null,
+    municipalityName: null,
+    authorityName: "Gobierno del Estado de Nuevo Leon",
+    title: "Reglamento de la Ley de Adquisiciones del Estado de Nuevo Leon",
+    officialUrl: "https://www.nl.gob.mx/",
+    sourceType: "reglamento",
+    versionLabel: null,
+    lastKnownHash: null,
+    lastVerifiedAt: null,
+    nextCheckAt: null,
+    isPilot: true,
+  },
+  {
+    id: "spgg-reglamento-adquisiciones",
+    stateCode: "NL",
+    stateName: "Nuevo Leon",
+    municipalityCode: "SPGG",
+    municipalityName: "San Pedro Garza Garcia",
+    authorityName: "Municipio de San Pedro Garza Garcia",
+    title: "Reglamento de Adquisiciones y Contratacion de Servicios de San Pedro Garza Garcia",
+    officialUrl: "https://www.sanpedro.gob.mx/",
+    sourceType: "reglamento",
+    versionLabel: null,
+    lastKnownHash: null,
+    lastVerifiedAt: null,
+    nextCheckAt: null,
+    isPilot: true,
+  },
+];
+
+const inMemorySuggestions: Array<OfficialNormativeSuggestionInput & { id: string; createdAt: string }> = [];
+const inMemoryVerificationState = new Map<string, InternalVerificationState>();
+
+function addDaysIso(base: Date, days: number) {
+  const copy = new Date(base);
+  copy.setUTCDate(copy.getUTCDate() + days);
+  return copy.toISOString();
+}
+
+function normalize(value: string | null | undefined) {
+  return (value ?? "")
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .toLowerCase()
+    .trim();
+}
+
+function composeFingerprint(url: string, headers: Headers) {
+  const etag = headers.get("etag") ?? "";
+  const lastModified = headers.get("last-modified") ?? "";
+  const contentLength = headers.get("content-length") ?? "";
+  const contentType = headers.get("content-type") ?? "";
+  return `${url}|${etag}|${lastModified}|${contentLength}|${contentType}`;
+}
+
+function sha256(value: string) {
+  return createHash("sha256").update(value).digest("hex");
+}
+
+function toPrismaSourceType(value: OfficialNormativeSourceView["sourceType"]) {
+  if (value === "ley") {
+    return OfficialNormativeSourceType.LEY;
+  }
+
+  if (value === "reglamento") {
+    return OfficialNormativeSourceType.REGLAMENTO;
+  }
+
+  if (value === "lineamiento") {
+    return OfficialNormativeSourceType.LINEAMIENTO;
+  }
+
+  return OfficialNormativeSourceType.PORTAL;
+}
+
+function fromPrismaSourceType(value: OfficialNormativeSourceType): OfficialNormativeSourceView["sourceType"] {
+  if (value === OfficialNormativeSourceType.LEY) {
+    return "ley";
+  }
+
+  if (value === OfficialNormativeSourceType.REGLAMENTO) {
+    return "reglamento";
+  }
+
+  if (value === OfficialNormativeSourceType.LINEAMIENTO) {
+    return "lineamiento";
+  }
+
+  return "portal";
+}
+
+function toPrismaStatus(value: "success" | "warning" | "failed") {
+  if (value === "success") {
+    return NormativeVerificationStatus.SUCCESS;
+  }
+
+  if (value === "warning") {
+    return NormativeVerificationStatus.WARNING;
+  }
+
+  return NormativeVerificationStatus.FAILED;
+}
+
+function fromPrismaStatus(value: NormativeVerificationStatus | null): "success" | "warning" | "failed" | null {
+  if (!value) {
+    return null;
+  }
+
+  if (value === NormativeVerificationStatus.SUCCESS) {
+    return "success";
+  }
+
+  if (value === NormativeVerificationStatus.WARNING) {
+    return "warning";
+  }
+
+  return "failed";
+}
+
+function mapSourceRowToView(row: {
+  id: string;
+  stateCode: string;
+  stateName: string;
+  municipalityCode: string | null;
+  municipalityName: string | null;
+  authorityName: string;
+  title: string;
+  officialUrl: string;
+  sourceType: OfficialNormativeSourceType;
+  versionLabel: string | null;
+  lastKnownHash: string | null;
+  lastVerifiedAt: Date | null;
+  nextCheckAt: Date | null;
+  isPilot: boolean;
+}) {
+  return {
+    id: row.id,
+    stateCode: row.stateCode,
+    stateName: row.stateName,
+    municipalityCode: row.municipalityCode,
+    municipalityName: row.municipalityName,
+    authorityName: row.authorityName,
+    title: row.title,
+    officialUrl: row.officialUrl,
+    sourceType: fromPrismaSourceType(row.sourceType),
+    versionLabel: row.versionLabel,
+    lastKnownHash: row.lastKnownHash,
+    lastVerifiedAt: row.lastVerifiedAt?.toISOString() ?? null,
+    nextCheckAt: row.nextCheckAt?.toISOString() ?? null,
+    isPilot: row.isPilot,
+  } satisfies OfficialNormativeSourceView;
+}
+
+async function fetchSourceMetadata(url: string) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), VERIFY_TIMEOUT_MS);
+
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      redirect: "follow",
+      signal: controller.signal,
+    });
+
+    const fingerprint = composeFingerprint(response.url || url, response.headers);
+    return {
+      ok: response.ok,
+      status: response.status,
+      hash: sha256(fingerprint),
+      finalUrl: response.url || url,
+    };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+function filterSources(
+  sources: OfficialNormativeSourceView[],
+  filters?: {
+    stateCode?: string | null;
+    municipalityCode?: string | null;
+    pilotOnly?: boolean;
+  },
+) {
+  const stateCode = normalize(filters?.stateCode);
+  const municipalityCode = normalize(filters?.municipalityCode);
+
+  return sources.filter((source) => {
+    if (filters?.pilotOnly && !source.isPilot) {
+      return false;
+    }
+
+    if (stateCode && normalize(source.stateCode) !== stateCode) {
+      return false;
+    }
+
+    if (municipalityCode && normalize(source.municipalityCode) !== municipalityCode) {
+      return false;
+    }
+
+    return true;
+  });
+}
+
+async function ensureDefaultSourcesPersisted() {
+  await Promise.all(
+    DEFAULT_OFFICIAL_SOURCES.map((source) =>
+      prisma.officialNormativeSource.upsert({
+        where: { id: source.id },
+        update: {
+          stateCode: source.stateCode,
+          stateName: source.stateName,
+          municipalityCode: source.municipalityCode,
+          municipalityName: source.municipalityName,
+          authorityName: source.authorityName,
+          title: source.title,
+          officialUrl: source.officialUrl,
+          sourceType: toPrismaSourceType(source.sourceType),
+          versionLabel: source.versionLabel,
+          isPilot: source.isPilot,
+        },
+        create: {
+          id: source.id,
+          stateCode: source.stateCode,
+          stateName: source.stateName,
+          municipalityCode: source.municipalityCode,
+          municipalityName: source.municipalityName,
+          authorityName: source.authorityName,
+          title: source.title,
+          officialUrl: source.officialUrl,
+          sourceType: toPrismaSourceType(source.sourceType),
+          versionLabel: source.versionLabel,
+          isPilot: source.isPilot,
+        },
+      }),
+    ),
+  );
+}
+
+function listInMemorySources(filters?: {
+  stateCode?: string | null;
+  municipalityCode?: string | null;
+  pilotOnly?: boolean;
+}) {
+  const sources = DEFAULT_OFFICIAL_SOURCES.map((source) => {
+    const state = inMemoryVerificationState.get(source.id);
+    return {
+      ...source,
+      lastKnownHash: state?.lastKnownHash ?? source.lastKnownHash,
+      lastVerifiedAt: state?.lastVerifiedAt ?? source.lastVerifiedAt,
+      nextCheckAt: state?.nextCheckAt ?? source.nextCheckAt,
+    };
+  });
+
+  return filterSources(sources, filters);
+}
+
+export async function listOfficialNormativeSources(filters?: {
+  stateCode?: string | null;
+  municipalityCode?: string | null;
+  pilotOnly?: boolean;
+}) {
+  if (TEST_ENV) {
+    return listInMemorySources(filters);
+  }
+
+  await ensureDefaultSourcesPersisted();
+  const rows = await prisma.officialNormativeSource.findMany({
+    orderBy: [{ stateCode: "asc" }, { municipalityCode: "asc" }, { title: "asc" }],
+  });
+
+  return filterSources(rows.map(mapSourceRowToView), filters);
+}
+
+export async function suggestOfficialNormativeSource(input: OfficialNormativeSuggestionInput) {
+  if (TEST_ENV) {
+    const suggestion = {
+      ...input,
+      id: `suggestion-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+      createdAt: new Date().toISOString(),
+    };
+    inMemorySuggestions.unshift(suggestion);
+    return suggestion;
+  }
+
+  const created = await prisma.officialNormativeSuggestion.create({
+    data: {
+      stateCode: input.stateCode,
+      municipalityCode: input.municipalityCode ?? null,
+      authorityName: input.authorityName,
+      title: input.title,
+      officialUrl: input.officialUrl,
+      sourceType: toPrismaSourceType(input.sourceType),
+      notes: input.notes ?? null,
+    },
+    select: {
+      id: true,
+      stateCode: true,
+      municipalityCode: true,
+      authorityName: true,
+      title: true,
+      officialUrl: true,
+      sourceType: true,
+      notes: true,
+      createdAt: true,
+    },
+  });
+
+  return {
+    id: created.id,
+    stateCode: created.stateCode,
+    municipalityCode: created.municipalityCode,
+    authorityName: created.authorityName,
+    title: created.title,
+    officialUrl: created.officialUrl,
+    sourceType: fromPrismaSourceType(created.sourceType),
+    notes: created.notes ?? undefined,
+    createdAt: created.createdAt.toISOString(),
+  };
+}
+
+export async function listOfficialNormativeSuggestions() {
+  if (TEST_ENV) {
+    return [...inMemorySuggestions];
+  }
+
+  const rows = await prisma.officialNormativeSuggestion.findMany({
+    orderBy: [{ createdAt: "desc" }],
+    take: 200,
+    select: {
+      id: true,
+      stateCode: true,
+      municipalityCode: true,
+      authorityName: true,
+      title: true,
+      officialUrl: true,
+      sourceType: true,
+      notes: true,
+      createdAt: true,
+    },
+  });
+
+  return rows.map((row) => ({
+    id: row.id,
+    stateCode: row.stateCode,
+    municipalityCode: row.municipalityCode,
+    authorityName: row.authorityName,
+    title: row.title,
+    officialUrl: row.officialUrl,
+    sourceType: fromPrismaSourceType(row.sourceType),
+    notes: row.notes ?? undefined,
+    createdAt: row.createdAt.toISOString(),
+  }));
+}
+
+export async function verifyOfficialNormativeSources(sourceIds?: string[]) {
+  const now = new Date();
+
+  if (TEST_ENV) {
+    const sources = sourceIds && sourceIds.length > 0 ? DEFAULT_OFFICIAL_SOURCES.filter((source) => sourceIds.includes(source.id)) : DEFAULT_OFFICIAL_SOURCES;
+    const results: NormativeVerificationResultView[] = [];
+
+    for (const source of sources) {
+      const previous = inMemoryVerificationState.get(source.id) ?? {
+        lastKnownHash: source.lastKnownHash,
+        lastVerifiedAt: source.lastVerifiedAt,
+        nextCheckAt: source.nextCheckAt,
+        lastStatus: null,
+        lastMessage: null,
+        lastChangedAt: null,
+      };
+
+      try {
+        const metadata = await fetchSourceMetadata(source.officialUrl);
+        const changed = Boolean(previous.lastKnownHash && metadata.hash !== previous.lastKnownHash);
+        const checkedAt = now.toISOString();
+        const status: "success" | "warning" | "failed" = metadata.ok ? (changed ? "warning" : "success") : "failed";
+        const message = metadata.ok
+          ? changed
+            ? "Se detecto cambio potencial en fuente normativa oficial."
+            : "Fuente normativa verificada sin cambios."
+          : "La fuente normativa no respondio correctamente.";
+
+        inMemoryVerificationState.set(source.id, {
+          lastKnownHash: metadata.hash,
+          lastVerifiedAt: checkedAt,
+          nextCheckAt: addDaysIso(now, DEFAULT_CHECK_INTERVAL_DAYS),
+          lastStatus: status,
+          lastMessage: message,
+          lastChangedAt: changed ? checkedAt : previous.lastChangedAt,
+        });
+
+        results.push({
+          sourceId: source.id,
+          checkedAt,
+          changed,
+          status,
+          httpStatus: metadata.status,
+          observedHash: metadata.hash,
+          message,
+        });
+      } catch (error) {
+        const checkedAt = now.toISOString();
+        const message = error instanceof Error ? error.message : "No fue posible verificar la fuente normativa.";
+
+        inMemoryVerificationState.set(source.id, {
+          lastKnownHash: previous.lastKnownHash ?? null,
+          lastVerifiedAt: checkedAt,
+          nextCheckAt: addDaysIso(now, 1),
+          lastStatus: "failed",
+          lastMessage: message,
+          lastChangedAt: previous.lastChangedAt ?? null,
+        });
+
+        results.push({
+          sourceId: source.id,
+          checkedAt,
+          changed: false,
+          status: "failed",
+          httpStatus: null,
+          observedHash: previous.lastKnownHash ?? null,
+          message,
+        });
+      }
+    }
+
+    return results;
+  }
+
+  await ensureDefaultSourcesPersisted();
+  const sources = await prisma.officialNormativeSource.findMany({
+    where: sourceIds && sourceIds.length > 0 ? { id: { in: sourceIds } } : undefined,
+    orderBy: [{ title: "asc" }],
+    select: {
+      id: true,
+      officialUrl: true,
+      lastKnownHash: true,
+      lastChangedAt: true,
+    },
+  });
+
+  const results: NormativeVerificationResultView[] = [];
+
+  for (const source of sources) {
+    try {
+      const metadata = await fetchSourceMetadata(source.officialUrl);
+      const changed = Boolean(source.lastKnownHash && metadata.hash !== source.lastKnownHash);
+      const checkedAt = now.toISOString();
+      const status: "success" | "warning" | "failed" = metadata.ok ? (changed ? "warning" : "success") : "failed";
+      const message = metadata.ok
+        ? changed
+          ? "Se detecto cambio potencial en fuente normativa oficial."
+          : "Fuente normativa verificada sin cambios."
+        : "La fuente normativa no respondio correctamente.";
+
+      await prisma.officialNormativeSource.update({
+        where: { id: source.id },
+        data: {
+          lastKnownHash: metadata.hash,
+          lastVerifiedAt: now,
+          nextCheckAt: new Date(addDaysIso(now, DEFAULT_CHECK_INTERVAL_DAYS)),
+          lastStatus: toPrismaStatus(status),
+          lastMessage: message,
+          lastChangedAt: changed ? now : source.lastChangedAt,
+        },
+      });
+
+      results.push({
+        sourceId: source.id,
+        checkedAt,
+        changed,
+        status,
+        httpStatus: metadata.status,
+        observedHash: metadata.hash,
+        message,
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "No fue posible verificar la fuente normativa.";
+
+      await prisma.officialNormativeSource.update({
+        where: { id: source.id },
+        data: {
+          lastVerifiedAt: now,
+          nextCheckAt: new Date(addDaysIso(now, 1)),
+          lastStatus: NormativeVerificationStatus.FAILED,
+          lastMessage: message,
+        },
+      });
+
+      results.push({
+        sourceId: source.id,
+        checkedAt: now.toISOString(),
+        changed: false,
+        status: "failed",
+        httpStatus: null,
+        observedHash: source.lastKnownHash,
+        message,
+      });
+    }
+  }
+
+  return results;
+}
+
+export async function getNormativeSourcesDueForVerification(now = new Date()) {
+  const nowTime = now.getTime();
+  const sources = await listOfficialNormativeSources({ pilotOnly: true });
+
+  return sources
+    .filter((source) => {
+      if (!source.lastVerifiedAt || !source.nextCheckAt) {
+        return true;
+      }
+
+      const nextCheck = new Date(source.nextCheckAt);
+      if (Number.isNaN(nextCheck.getTime())) {
+        return true;
+      }
+
+      return nextCheck.getTime() <= nowTime;
+    })
+    .map((source) => source.id);
+}
+
+export async function runPeriodicNormativeVerification(now = new Date()) {
+  const dueSourceIds = await getNormativeSourcesDueForVerification(now);
+
+  if (dueSourceIds.length === 0) {
+    return {
+      checkedAt: now.toISOString(),
+      checked: false,
+      dueCount: 0,
+      results: [] as NormativeVerificationResultView[],
+    };
+  }
+
+  const results = await verifyOfficialNormativeSources(dueSourceIds);
+  return {
+    checkedAt: now.toISOString(),
+    checked: true,
+    dueCount: dueSourceIds.length,
+    results,
+  };
+}
+
+export async function listRegulationChangeAlerts(now = new Date(), lookbackDays = 30): Promise<ComplianceAlertView[]> {
+  const threshold = new Date(now);
+  threshold.setUTCDate(threshold.getUTCDate() - Math.max(1, lookbackDays));
+
+  if (TEST_ENV) {
+    const sourcesById = new Map(DEFAULT_OFFICIAL_SOURCES.map((source) => [source.id, source]));
+    const alerts: ComplianceAlertView[] = [];
+
+    for (const [sourceId, state] of inMemoryVerificationState.entries()) {
+      const source = sourcesById.get(sourceId);
+      if (!source || !state.lastVerifiedAt) {
+        continue;
+      }
+
+      const verifiedAt = new Date(state.lastVerifiedAt);
+      if (Number.isNaN(verifiedAt.getTime()) || verifiedAt < threshold) {
+        continue;
+      }
+
+      if (state.lastStatus === "warning") {
+        alerts.push({
+          id: `reg-update-${sourceId}`,
+          proposalId: null,
+          licitationId: sourceId,
+          title: "Cambio detectado en fuente normativa",
+          description: `${source.title}: ${state.lastMessage ?? "Se detectaron cambios en metadatos oficiales."}`,
+          severity: "high",
+          kind: "normative_regulation_update",
+          dueAt: state.lastVerifiedAt,
+          createdAt: state.lastVerifiedAt,
+        });
+      }
+
+      if (state.lastStatus === "failed") {
+        alerts.push({
+          id: `reg-failed-${sourceId}`,
+          proposalId: null,
+          licitationId: sourceId,
+          title: "Verificacion normativa fallida",
+          description: `${source.title}: ${state.lastMessage ?? "No fue posible verificar la fuente."}`,
+          severity: "medium",
+          kind: "normative_verification_pending",
+          dueAt: state.nextCheckAt,
+          createdAt: state.lastVerifiedAt,
+        });
+      }
+    }
+
+    return alerts;
+  }
+
+  await ensureDefaultSourcesPersisted();
+  const rows = await prisma.officialNormativeSource.findMany({
+    where: {
+      lastVerifiedAt: { gte: threshold },
+      lastStatus: { in: [NormativeVerificationStatus.WARNING, NormativeVerificationStatus.FAILED] },
+    },
+    orderBy: [{ lastVerifiedAt: "desc" }],
+    select: {
+      id: true,
+      title: true,
+      lastStatus: true,
+      lastMessage: true,
+      lastVerifiedAt: true,
+      nextCheckAt: true,
+    },
+  });
+
+  const alerts: ComplianceAlertView[] = [];
+
+  for (const row of rows) {
+    if (!row.lastVerifiedAt || !row.lastStatus) {
+      continue;
+    }
+
+    const status = fromPrismaStatus(row.lastStatus);
+    if (status === "warning") {
+      alerts.push({
+        id: `reg-update-${row.id}`,
+        proposalId: null,
+        licitationId: row.id,
+        title: "Cambio detectado en fuente normativa",
+        description: `${row.title}: ${row.lastMessage ?? "Se detectaron cambios en metadatos oficiales."}`,
+        severity: "high",
+        kind: "normative_regulation_update",
+        dueAt: row.lastVerifiedAt.toISOString(),
+        createdAt: row.lastVerifiedAt.toISOString(),
+      });
+      continue;
+    }
+
+    if (status === "failed") {
+      alerts.push({
+        id: `reg-failed-${row.id}`,
+        proposalId: null,
+        licitationId: row.id,
+        title: "Verificacion normativa fallida",
+        description: `${row.title}: ${row.lastMessage ?? "No fue posible verificar la fuente."}`,
+        severity: "medium",
+        kind: "normative_verification_pending",
+        dueAt: row.nextCheckAt?.toISOString() ?? null,
+        createdAt: row.lastVerifiedAt.toISOString(),
+      });
+    }
+  }
+
+  return alerts;
+}
+
+export async function getDueNormativeVerifications(now = new Date(), horizonDays = 7) {
+  const horizon = new Date(now);
+  horizon.setUTCDate(horizon.getUTCDate() + Math.max(0, horizonDays));
+
+  const sources = await listOfficialNormativeSources({ pilotOnly: true });
+  return sources
+    .map((source) => {
+      const dueAtIso = source.nextCheckAt ?? addDaysIso(now, 1);
+      const dueAt = new Date(dueAtIso);
+      if (Number.isNaN(dueAt.getTime())) {
+        return null;
+      }
+
+      if (dueAt > horizon) {
+        return null;
+      }
+
+      return {
+        sourceId: source.id,
+        sourceTitle: source.title,
+        authorityName: source.authorityName,
+        dueAt: dueAt.toISOString(),
+        overdue: dueAt.getTime() < now.getTime(),
+      };
+    })
+    .filter((item): item is { sourceId: string; sourceTitle: string; authorityName: string; dueAt: string; overdue: boolean } => Boolean(item))
+    .sort((left, right) => new Date(left.dueAt).getTime() - new Date(right.dueAt).getTime());
+}
+
+export async function resetRegulationsStateForTests() {
+  if (!TEST_ENV) {
+    return;
+  }
+
+  inMemoryVerificationState.clear();
+  inMemorySuggestions.splice(0, inMemorySuggestions.length);
+}
diff --git a/src/lib/compliance/server.ts b/src/lib/compliance/server.ts
new file mode 100644
index 0000000..df34849
--- /dev/null
+++ b/src/lib/compliance/server.ts
@@ -0,0 +1,168 @@
+import "server-only";
+
+import { prisma } from "@/lib/prisma";
+import type { ComplianceAlertView } from "@/lib/compliance/types";
+import { buildM7Dataset, computeM3Counters } from "@/lib/compliance/m7";
+import { getDueNormativeVerifications, listRegulationChangeAlerts } from "@/lib/compliance/regulations";
+
+export async function getM7DatasetForUser(userId: string, now = new Date()) {
+  const [proposals, preferences, totalOpenLicitations] = await Promise.all([
+    prisma.proposal.findMany({
+      where: {
+        userId,
+      },
+      select: {
+        id: true,
+        title: true,
+        status: true,
+        sourceLicitationId: true,
+        workflowDraft: true,
+        updatedAt: true,
+      },
+      orderBy: [{ updatedAt: "desc" }],
+      take: 200,
+    }),
+    prisma.licitationUserPreference.findMany({
+      where: {
+        userId,
+      },
+      select: {
+        status: true,
+      },
+    }),
+    prisma.licitation.count({
+      where: {
+        OR: [{ isOpen: true }, { closingDate: { gte: now } }],
+        municipality: {
+          isActive: true,
+        },
+      },
+    }),
+  ]);
+
+  const activeLinked = new Set(
+    proposals
+      .filter((item) => item.status !== "ARCHIVED" && item.sourceLicitationId)
+      .map((item) => item.sourceLicitationId as string),
+  ).size;
+
+  const m3 = computeM3Counters({
+    totalOpenLicitations,
+    preferences,
+    activeLinked,
+  });
+
+  const [dueVerifications, regulationAlerts, overdueDeliverables, disputedPayments, highSeverityCases] = await Promise.all([
+    getDueNormativeVerifications(now, 7),
+    listRegulationChangeAlerts(now, 30),
+    prisma.contractDeliverable.findMany({
+      where: {
+        contract: {
+          userId,
+        },
+        status: {
+          in: ["PENDING", "OVERDUE"],
+        },
+        dueDate: {
+          lt: now,
+        },
+      },
+      select: {
+        id: true,
+        title: true,
+        dueDate: true,
+        contract: {
+          select: {
+            id: true,
+            title: true,
+          },
+        },
+      },
+      orderBy: [{ dueDate: "asc" }],
+      take: 50,
+    }),
+    prisma.contractPayment.findMany({
+      where: {
+        contract: {
+          userId,
+        },
+        status: "DISPUTED",
+      },
+      select: {
+        id: true,
+        concept: true,
+        paymentDate: true,
+        amount: true,
+        contract: {
+          select: {
+            id: true,
+            title: true,
+          },
+        },
+      },
+      orderBy: [{ paymentDate: "desc" }],
+      take: 50,
+    }),
+    prisma.legalCase.findMany({
+      where: {
+        userId,
+        severity: "HIGH",
+        status: {
+          in: ["OPEN", "IN_PROGRESS", "ESCALATED"],
+        },
+      },
+      select: {
+        id: true,
+        caseType: true,
+        counterparty: true,
+        openedAt: true,
+      },
+      orderBy: [{ openedAt: "desc" }],
+      take: 50,
+    }),
+  ]);
+
+  const crossModuleAlerts: ComplianceAlertView[] = [
+    ...overdueDeliverables.map((item) => ({
+      id: `contract-deliverable-overdue-${item.id}`,
+      proposalId: null,
+      licitationId: item.contract.id,
+      title: `Entregable vencido: ${item.contract.title}`,
+      description: item.title,
+      severity: "high" as const,
+      kind: "contract_deliverable_overdue" as const,
+      dueAt: item.dueDate ? item.dueDate.toISOString() : null,
+      createdAt: now.toISOString(),
+    })),
+    ...disputedPayments.map((item) => ({
+      id: `contract-payment-disputed-${item.id}`,
+      proposalId: null,
+      licitationId: item.contract.id,
+      title: `Pago en disputa: ${item.contract.title}`,
+      description: `${item.concept} (${Number(item.amount).toLocaleString("es-MX")} MXN)`,
+      severity: "high" as const,
+      kind: "contract_payment_disputed" as const,
+      dueAt: item.paymentDate.toISOString(),
+      createdAt: now.toISOString(),
+    })),
+    ...highSeverityCases.map((item) => ({
+      id: `legal-high-severity-${item.id}`,
+      proposalId: null,
+      licitationId: null,
+      title: `Caso legal alta severidad: ${item.caseType}`,
+      description: `Contraparte: ${item.counterparty}`,
+      severity: "high" as const,
+      kind: "legal_case_high_severity" as const,
+      dueAt: item.openedAt.toISOString(),
+      createdAt: now.toISOString(),
+    })),
+  ];
+
+  return buildM7Dataset({
+    proposals,
+    m3,
+    dueVerifications,
+    externalAlerts: [...regulationAlerts, ...crossModuleAlerts],
+    now,
+  });
+}
diff --git a/src/lib/compliance/signature-policy.ts b/src/lib/compliance/signature-policy.ts
new file mode 100644
index 0000000..2a5b8fe
--- /dev/null
+++ b/src/lib/compliance/signature-policy.ts
@@ -0,0 +1,133 @@
+import type { SignaturePolicyEvaluation, SignaturePolicyMatrixEntry, SignaturePolicyStatus } from "@/lib/compliance/types";
+
+const MATRIX: SignaturePolicyMatrixEntry[] = [
+  {
+    id: "nl-general-licitaciones",
+    stateCode: "NL",
+    stateName: "Nuevo Leon",
+    municipalityCode: null,
+    municipalityName: null,
+    appliesTo: "licitaciones",
+    policyStatus: "condicionado",
+    policyName: "Firma electronica avanzada condicionada por convocatoria",
+    evidenceRequired: [
+      "Verificacion expresa en Bases/Convocatoria de admision de firma electronica",
+      "Acuse de autenticidad o certificado vigente de la e.firma",
+      "Respaldo de representacion legal de firmantes",
+    ],
+    notes: "Si no existe clausula expresa de admision, se escala a validacion legal interna.",
+    sourceUrl: "https://www.nl.gob.mx/",
+  },
+  {
+    id: "nl-san-pedro",
+    stateCode: "NL",
+    stateName: "Nuevo Leon",
+    municipalityCode: "SPGG",
+    municipalityName: "San Pedro Garza Garcia",
+    appliesTo: "licitaciones",
+    policyStatus: "requiere_validacion_legal",
+    policyName: "Municipio con validacion legal previa obligatoria",
+    evidenceRequired: [
+      "Reglamento municipal vigente de adquisiciones",
+      "Reglas de firma indicadas en convocatoria especifica",
+      "Opinion legal documentada antes de envio",
+    ],
+    notes: "Configuracion conservadora para piloto: no asumir autorizacion automatica de firma electronica.",
+    sourceUrl: "https://www.sanpedro.gob.mx/",
+  },
+];
+
+function normalize(value: string | null | undefined) {
+  return (value ?? "")
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .toLowerCase()
+    .trim();
+}
+
+function isMatch(entry: SignaturePolicyMatrixEntry, input: { stateCode?: string | null; stateName?: string | null; municipalityName?: string | null }) {
+  const stateCode = normalize(input.stateCode);
+  const stateName = normalize(input.stateName);
+  const municipalityName = normalize(input.municipalityName);
+
+  const entryStateCode = normalize(entry.stateCode);
+  const entryStateName = normalize(entry.stateName);
+  const entryMunicipalityName = normalize(entry.municipalityName);
+
+  const stateMatches = (stateCode && stateCode === entryStateCode) || (stateName && stateName === entryStateName);
+  if (!stateMatches) {
+    return false;
+  }
+
+  if (!entryMunicipalityName) {
+    return true;
+  }
+
+  return Boolean(municipalityName && municipalityName === entryMunicipalityName);
+}
+
+export function evaluateSignaturePolicy(input: {
+  stateCode?: string | null;
+  stateName?: string | null;
+  municipalityName?: string | null;
+  documentType?: "BASES_LICITACION" | "CONVOCATORIA" | "ANEXOS" | "OTRO" | "REGLAMENTO" | "LEY";
+}): SignaturePolicyEvaluation {
+  const exactMunicipality = MATRIX.find((entry) => Boolean(entry.municipalityName) && isMatch(entry, input));
+  const stateDefault = MATRIX.find((entry) => !entry.municipalityName && isMatch(entry, input));
+  const chosen = exactMunicipality ?? stateDefault;
+
+  if (!chosen) {
+    return {
+      policyStatus: "requiere_validacion_legal",
+      policyName: "Sin certeza regulatoria local",
+      evidenceRequired: [
+        "Reglamento oficial vigente de la jurisdiccion",
+        "Clausula explicita en la convocatoria sobre firma electronica",
+        "Opinion legal interna previa al envio",
+      ],
+      notes: "Sin confirmacion oficial suficiente. Regla conservadora: requiere validacion legal.",
+      jurisdictionLabel: input.stateName?.trim() || "Jurisdiccion no definida",
+      sourceUrl: null,
+    };
+  }
+
+  const documentHint = input.documentType ? `Documento base: ${input.documentType}.` : "";
+  const jurisdictionLabel = chosen.municipalityName ? `${chosen.municipalityName}, ${chosen.stateName}` : chosen.stateName;
+
+  return {
+    policyStatus: chosen.policyStatus,
+    policyName: chosen.policyName,
+    evidenceRequired: chosen.evidenceRequired,
+    notes: `${chosen.notes}${documentHint ? ` ${documentHint}` : ""}`.trim(),
+    jurisdictionLabel,
+    sourceUrl: chosen.sourceUrl,
+  };
+}
+
+export function getSignaturePolicyStatusLabel(status: SignaturePolicyStatus) {
+  if (status === "permitido") {
+    return "Permitido";
+  }
+
+  if (status === "condicionado") {
+    return "Condicionado";
+  }
+
+  return "Requiere validacion legal";
+}
+
+export function getSignaturePolicyTone(status: SignaturePolicyStatus) {
+  if (status === "permitido") {
+    return "border-[#b9e6cd] bg-[#eaf9f1] text-[#1f8b63]";
+  }
+
+  if (status === "condicionado") {
+    return "border-[#f0deb0] bg-[#fff8e9] text-[#8d6308]";
+  }
+
+  return "border-[#f1c7ce] bg-[#fff1f4] text-[#b03f4f]";
+}
+
+export function listSignaturePolicyMatrix() {
+  return [...MATRIX];
+}
diff --git a/src/lib/compliance/types.ts b/src/lib/compliance/types.ts
new file mode 100644
index 0000000..e3a83e0
--- /dev/null
+++ b/src/lib/compliance/types.ts
@@ -0,0 +1,156 @@
+export type SignaturePolicyStatus = "permitido" | "condicionado" | "requiere_validacion_legal";
+
+export type SignaturePolicyMatrixEntry = {
+  id: string;
+  stateCode: string;
+  stateName: string;
+  municipalityCode: string | null;
+  municipalityName: string | null;
+  appliesTo: "licitaciones" | "contratos" | "general";
+  policyStatus: SignaturePolicyStatus;
+  policyName: string;
+  evidenceRequired: string[];
+  notes: string;
+  sourceUrl: string | null;
+};
+
+export type SignaturePolicyEvaluation = {
+  policyStatus: SignaturePolicyStatus;
+  policyName: string;
+  evidenceRequired: string[];
+  notes: string;
+  jurisdictionLabel: string;
+  sourceUrl: string | null;
+};
+
+export type ComplianceAlertSeverity = "high" | "medium" | "low";
+
+export type ComplianceAlertKind =
+  | "deadline_overdue"
+  | "deadline_soon"
+  | "critical_requirement_pending"
+  | "signature_policy"
+  | "normative_regulation_update"
+  | "normative_verification_pending"
+  | "contract_deliverable_overdue"
+  | "contract_payment_disputed"
+  | "legal_case_high_severity";
+
+export type ComplianceAlertView = {
+  id: string;
+  proposalId: string | null;
+  licitationId: string | null;
+  title: string;
+  description: string;
+  severity: ComplianceAlertSeverity;
+  kind: ComplianceAlertKind;
+  dueAt: string | null;
+  createdAt: string;
+};
+
+export type ComplianceDeadlineItem = {
+  id: string;
+  proposalId: string | null;
+  licitationId: string | null;
+  title: string;
+  description: string;
+  dueAt: string;
+  source: "milestone" | "normative_verification";
+  status: "upcoming" | "overdue";
+};
+
+export type ComplianceChecklistItem = {
+  proposalId: string;
+  proposalTitle: string;
+  mandatoryResolved: number;
+  mandatoryTotal: number;
+  completionRate: number;
+  signaturePolicyStatus: SignaturePolicyStatus;
+};
+
+export type CompliancePanelItem = {
+  id: string;
+  label: string;
+  value: string;
+  tone: "neutral" | "success" | "warning" | "danger";
+};
+
+export type M7KpiSnapshot = {
+  activeLicitations: number;
+  completionRate: number;
+  criticalPending: number;
+  upcoming7Days: number;
+};
+
+export type M7Dataset = {
+  generatedAt: string;
+  kpis: M7KpiSnapshot;
+  m3States: {
+    consulted: number;
+    interested: number;
+    active: number;
+    new: number;
+  };
+  tabs: {
+    plazos: ComplianceDeadlineItem[];
+    alertas: ComplianceAlertView[];
+    checklist: ComplianceChecklistItem[];
+    panelKpi: CompliancePanelItem[];
+  };
+  aiPlaybook?: M7AiPlaybook | null;
+};
+
+export type M7AiPlaybook = {
+  predictedIncidents: {
+    title: string;
+    likelihood: "alta" | "media" | "baja";
+    impact: "alto" | "medio" | "bajo";
+    timeHorizon: string;
+  }[];
+  priorityOrder: string[];
+  preventiveActions: {
+    action: string;
+    ownerSuggestion: string;
+    targetDate: string;
+  }[];
+  escalationAdvice: string[];
+  confidence: "low" | "medium" | "high";
+  suggestionId: string;
+};
+
+export type OfficialNormativeSourceView = {
+  id: string;
+  stateCode: string;
+  stateName: string;
+  municipalityCode: string | null;
+  municipalityName: string | null;
+  authorityName: string;
+  title: string;
+  officialUrl: string;
+  sourceType: "ley" | "reglamento" | "lineamiento" | "portal";
+  versionLabel: string | null;
+  lastKnownHash: string | null;
+  lastVerifiedAt: string | null;
+  nextCheckAt: string | null;
+  isPilot: boolean;
+};
+
+export type OfficialNormativeSuggestionInput = {
+  stateCode: string;
+  municipalityCode?: string | null;
+  authorityName: string;
+  title: string;
+  officialUrl: string;
+  sourceType: OfficialNormativeSourceView["sourceType"];
+  notes?: string;
+};
+
+export type NormativeVerificationResultView = {
+  sourceId: string;
+  checkedAt: string;
+  changed: boolean;
+  status: "success" | "warning" | "failed";
+  httpStatus: number | null;
+  observedHash: string | null;
+  message: string;
+};
diff --git a/src/lib/contracts/__tests__/proposal-continuity.test.ts b/src/lib/contracts/__tests__/proposal-continuity.test.ts
new file mode 100644
index 0000000..5f4376f
--- /dev/null
+++ b/src/lib/contracts/__tests__/proposal-continuity.test.ts
@@ -0,0 +1,203 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const { prismaMock, readStoredProposalDocumentMock, storeContractDocumentFileMock } = vi.hoisted(() => ({
+  prismaMock: {
+    proposal: {
+      findFirst: vi.fn(),
+    },
+    contractDocument: {
+      findMany: vi.fn(),
+      create: vi.fn(),
+    },
+  },
+  readStoredProposalDocumentMock: vi.fn(),
+  storeContractDocumentFileMock: vi.fn(),
+}));
+
+vi.mock("@/lib/prisma", () => ({
+  prisma: prismaMock,
+}));
+
+vi.mock("@/lib/proposals/storage", async () => {
+  const actual = await vi.importActual<typeof import("@/lib/proposals/storage")>("@/lib/proposals/storage");
+  return {
+    ...actual,
+    readStoredProposalDocument: readStoredProposalDocumentMock,
+  };
+});
+
+vi.mock("@/lib/contracts/storage", async () => {
+  const actual = await vi.importActual<typeof import("@/lib/contracts/storage")>("@/lib/contracts/storage");
+  return {
+    ...actual,
+    storeContractDocumentFile: storeContractDocumentFileMock,
+  };
+});
+
+import {
+  ensureProposalPdfLinkedToContract,
+  getLatestProposalPdfSourceForUser,
+  isPdfProposalDocument,
+} from "@/lib/contracts/proposal-continuity";
+
+describe("proposal continuity", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("detects PDF proposal documents by mime type or file extension", () => {
+    expect(isPdfProposalDocument({ fileName: "source.pdf", mimeType: "application/octet-stream" })).toBe(true);
+    expect(isPdfProposalDocument({ fileName: "source.bin", mimeType: "application/pdf" })).toBe(true);
+    expect(isPdfProposalDocument({ fileName: "source.docx", mimeType: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" })).toBe(
+      false,
+    );
+  });
+
+  it("returns proposal_not_found when proposal does not belong to user", async () => {
+    prismaMock.proposal.findFirst.mockResolvedValue(null);
+
+    const result = await getLatestProposalPdfSourceForUser("user-1", "proposal-1");
+
+    expect(result).toEqual({ status: "proposal_not_found" });
+    expect(readStoredProposalDocumentMock).not.toHaveBeenCalled();
+  });
+
+  it("returns pdf_not_found when proposal has no PDF document", async () => {
+    prismaMock.proposal.findFirst.mockResolvedValue({
+      id: "proposal-1",
+      title: "Propuesta sin PDF",
+      documents: [{ id: "doc-1", fileName: "evidencia.docx", filePath: "storage/proposals/u/p/doc-1.docx", mimeType: "application/vnd.openxmlformats-officedocument.wordprocessingml.document", sizeBytes: 20, checksumSha256: null, createdAt: new Date() }],
+    });
+
+    const result = await getLatestProposalPdfSourceForUser("user-1", "proposal-1");
+
+    expect(result).toEqual({
+      status: "pdf_not_found",
+      proposal: { id: "proposal-1", title: "Propuesta sin PDF" },
+    });
+    expect(readStoredProposalDocumentMock).not.toHaveBeenCalled();
+  });
+
+  it("returns PDF source when proposal has a PDF document", async () => {
+    const fileBuffer = Buffer.from("pdf");
+    prismaMock.proposal.findFirst.mockResolvedValue({
+      id: "proposal-1",
+      title: "Propuesta con PDF",
+      documents: [
+        {
+          id: "doc-2",
+          fileName: "contrato.pdf",
+          filePath: "storage/proposals/u/p/doc-2.pdf",
+          mimeType: "application/pdf",
+          sizeBytes: 120,
+          checksumSha256: "sha-source",
+          createdAt: new Date(),
+        },
+      ],
+    });
+    readStoredProposalDocumentMock.mockResolvedValue(fileBuffer);
+
+    const result = await getLatestProposalPdfSourceForUser("user-1", "proposal-1");
+
+    expect(result).toEqual({
+      status: "ok",
+      source: {
+        proposal: { id: "proposal-1", title: "Propuesta con PDF" },
+        document: {
+          id: "doc-2",
+          fileName: "contrato.pdf",
+          filePath: "storage/proposals/u/p/doc-2.pdf",
+          mimeType: "application/pdf",
+          sizeBytes: 120,
+          checksumSha256: "sha-source",
+          createdAt: expect.any(Date),
+        },
+        fileBuffer,
+      },
+    });
+    expect(readStoredProposalDocumentMock).toHaveBeenCalledTimes(1);
+    expect(readStoredProposalDocumentMock.mock.calls[0]?.[0]).toBe("storage/proposals/u/p/doc-2.pdf");
+  });
+
+  it("avoids creating duplicate contract document when checksum matches", async () => {
+    prismaMock.contractDocument.findMany.mockResolvedValue([
+      {
+        id: "existing-doc",
+        fileName: "contrato.pdf",
+        sizeBytes: 120,
+        checksumSha256: "sha-source",
+      },
+    ]);
+
+    const result = await ensureProposalPdfLinkedToContract({
+      userId: "user-1",
+      contractId: "contract-1",
+      source: {
+        proposal: { id: "proposal-1", title: "Propuesta" },
+        document: {
+          id: "proposal-doc",
+          fileName: "contrato.pdf",
+          filePath: "storage/proposals/u/p/doc.pdf",
+          mimeType: "application/pdf",
+          sizeBytes: 120,
+          checksumSha256: "sha-source",
+          createdAt: new Date(),
+        },
+        fileBuffer: Buffer.from("pdf"),
+      },
+    });
+
+    expect(result).toEqual({ created: false, documentId: "existing-doc" });
+    expect(storeContractDocumentFileMock).not.toHaveBeenCalled();
+    expect(prismaMock.contractDocument.create).not.toHaveBeenCalled();
+  });
+
+  it("stores and links proposal PDF when no duplicate exists", async () => {
+    prismaMock.contractDocument.findMany.mockResolvedValue([]);
+    storeContractDocumentFileMock.mockResolvedValue({
+      fileName: "contract-copy.pdf",
+      filePath: "storage/contracts/user-1/contract-1/copy.pdf",
+      mimeType: "application/pdf",
+      sizeBytes: 120,
+      checksumSha256: "sha-copy",
+    });
+    prismaMock.contractDocument.create.mockResolvedValue({
+      id: "new-doc",
+    });
+
+    const result = await ensureProposalPdfLinkedToContract({
+      userId: "user-1",
+      contractId: "contract-1",
+      source: {
+        proposal: { id: "proposal-1", title: "Propuesta" },
+        document: {
+          id: "proposal-doc",
+          fileName: "contrato.pdf",
+          filePath: "storage/proposals/u/p/doc.pdf",
+          mimeType: "application/pdf",
+          sizeBytes: 120,
+          checksumSha256: "sha-source",
+          createdAt: new Date(),
+        },
+        fileBuffer: Buffer.from("pdf"),
+      },
+    });
+
+    expect(result).toEqual({ created: true, documentId: "new-doc" });
+    expect(storeContractDocumentFileMock).toHaveBeenCalledWith("user-1", "contract-1", "contrato.pdf", "application/pdf", expect.any(Buffer));
+    expect(prismaMock.contractDocument.create).toHaveBeenCalledWith({
+      data: {
+        contractId: "contract-1",
+        fileName: "contract-copy.pdf",
+        filePath: "storage/contracts/user-1/contract-1/copy.pdf",
+        mimeType: "application/pdf",
+        sizeBytes: 120,
+        checksumSha256: "sha-copy",
+        kind: "SIGNED_CONTRACT",
+      },
+      select: {
+        id: true,
+      },
+    });
+  });
+});
diff --git a/src/lib/contracts/extraction.ts b/src/lib/contracts/extraction.ts
new file mode 100644
index 0000000..7197caf
--- /dev/null
+++ b/src/lib/contracts/extraction.ts
@@ -0,0 +1,458 @@
+import { z } from "zod";
+import type { ContractAiExtractionOutput, ContractRiskClause } from "@/lib/contracts/types";
+
+const DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1";
+const DEFAULT_OPENAI_MODEL = "gpt-4.1-mini";
+const DEFAULT_TIMEOUT_MS = 60_000;
+const DEFAULT_MAX_TEXT_CHARS = 45_000;
+
+const ContractExtractionResponseSchema = z.object({
+  fields: z
+    .object({
+      title: z.string().nullable().optional(),
+      counterpartyEntity: z.string().nullable().optional(),
+      contractNumber: z.string().nullable().optional(),
+      contractType: z.string().nullable().optional(),
+      startDate: z.string().nullable().optional(),
+      endDate: z.string().nullable().optional(),
+      totalAmount: z.union([z.number(), z.string()]).nullable().optional(),
+      currency: z.string().nullable().optional(),
+      description: z.string().nullable().optional(),
+    })
+    .nullable()
+    .optional(),
+  deliverables: z
+    .array(
+      z.object({
+        title: z.string().nullable().optional(),
+        dueDate: z.string().nullable().optional(),
+        amountLinked: z.union([z.number(), z.string()]).nullable().optional(),
+        notes: z.string().nullable().optional(),
+      }),
+    )
+    .nullable()
+    .optional(),
+  paymentMilestones: z
+    .array(
+      z.object({
+        concept: z.string().nullable().optional(),
+        paymentDate: z.string().nullable().optional(),
+        amount: z.union([z.number(), z.string()]).nullable().optional(),
+      }),
+    )
+    .nullable()
+    .optional(),
+  riskClauses: z
+    .array(
+      z.object({
+        title: z.string().nullable().optional(),
+        snippet: z.string().nullable().optional(),
+        riskLevel: z.enum(["low", "medium", "high"]).nullable().optional(),
+      }),
+    )
+    .nullable()
+    .optional(),
+});
+
+type OpenAiChatCompletionResponse = {
+  choices?: Array<{
+    message?: {
+      content?: string | null;
+    };
+  }>;
+  model?: string;
+  usage?: {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+  };
+  error?: {
+    message?: string;
+  };
+};
+
+function parsePositiveInteger(value: string | undefined, fallback: number) {
+  const parsed = Number.parseInt((value ?? "").trim(), 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+
+function getOpenAiApiKey() {
+  return process.env.OPENAI_API_KEY?.trim() || process.env.API_KEY?.trim() || process.env.api_key?.trim() || "";
+}
+
+function compactText(value: string, maxLength = 600) {
+  const compacted = value.replace(/\s+/g, " ").trim();
+  if (!compacted) {
+    return null;
+  }
+
+  return compacted.length > maxLength ? compacted.slice(0, maxLength) : compacted;
+}
+
+function normalizeIsoDate(value: unknown): string | null {
+  if (!value || typeof value !== "string") {
+    return null;
+  }
+
+  const compact = value.trim();
+  if (!compact) {
+    return null;
+  }
+
+  const parsed = new Date(compact);
+  if (Number.isNaN(parsed.getTime())) {
+    return null;
+  }
+
+  return parsed.toISOString();
+}
+
+function normalizeAmount(value: unknown): number | null {
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? Number(value.toFixed(2)) : null;
+  }
+
+  if (typeof value !== "string") {
+    return null;
+  }
+
+  const normalized = value
+    .replace(/[^\d.,-]/g, "")
+    .replace(/\.(?=.*\.)/g, "")
+    .replace(/,/g, ".");
+
+  const parsed = Number.parseFloat(normalized);
+  if (!Number.isFinite(parsed)) {
+    return null;
+  }
+
+  return Number(parsed.toFixed(2));
+}
+
+function clampText(fullText: string) {
+  const maxChars = parsePositiveInteger(process.env.OPENAI_CONTRACT_MAX_CHARS, DEFAULT_MAX_TEXT_CHARS);
+
+  if (fullText.length <= maxChars) {
+    return fullText;
+  }
+
+  return `${fullText.slice(0, maxChars)}\n\n[TEXT_TRUNCATED_TO_${maxChars}_CHARS]`;
+}
+
+function extractJsonObject(raw: string) {
+  const trimmed = raw.trim();
+
+  try {
+    return JSON.parse(trimmed) as unknown;
+  } catch {
+    // Continue with alternative parsing.
+  }
+
+  const noFence = trimmed
+    .replace(/^```json\s*/i, "")
+    .replace(/^```\s*/i, "")
+    .replace(/\s*```$/i, "")
+    .trim();
+
+  try {
+    return JSON.parse(noFence) as unknown;
+  } catch {
+    // Continue with slicing.
+  }
+
+  const firstBrace = noFence.indexOf("{");
+  const lastBrace = noFence.lastIndexOf("}");
+
+  if (firstBrace >= 0 && lastBrace > firstBrace) {
+    return JSON.parse(noFence.slice(firstBrace, lastBrace + 1)) as unknown;
+  }
+
+  throw new Error("La respuesta de IA no contiene JSON valido.");
+}
+
+function inferContractNumber(text: string) {
+  const match = text.match(/(?:contrato|numero\s+de\s+contrato|expediente)\s*(?:no\.?|num(?:ero)?\.?|:)\s*([a-z0-9\-_/]{4,40})/i);
+  return compactText(match?.[1] ?? "", 80);
+}
+
+function inferAmount(text: string) {
+  const match = text.match(/(?:monto\s+total|importe\s+total|total\s+a\s+pagar)\s*[:\-]?\s*\$?\s*([\d.,]{4,20})/i);
+  return normalizeAmount(match?.[1] ?? null);
+}
+
+function inferCounterparty(text: string) {
+  const match = text.match(/(?:entidad\s+contratante|dependencia|contratante)\s*[:\-]\s*([^\n]{4,160})/i);
+  return compactText(match?.[1] ?? "", 220);
+}
+
+function inferTitle(text: string) {
+  const lines = text
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean);
+
+  const contractLine = lines.find((line) => /\bcontrato\b/i.test(line));
+  return compactText(contractLine ?? lines[0] ?? "Contrato sin titulo", 220);
+}
+
+function inferContractType(text: string) {
+  if (/obra\s+publica/i.test(text)) {
+    return "Obra publica";
+  }
+
+  if (/servicio/i.test(text)) {
+    return "Servicios";
+  }
+
+  if (/adquisicion/i.test(text)) {
+    return "Adquisiciones";
+  }
+
+  return "General";
+}
+
+function inferDeliverables(text: string) {
+  const lines = text.split(/\r?\n/);
+  const rows = lines
+    .filter((line) => /entregable|hito|entrega/i.test(line))
+    .slice(0, 12)
+    .map((line) => ({
+      title: compactText(line, 220) ?? "Entregable detectado",
+      dueDate: null,
+      amountLinked: null,
+      notes: null,
+    }));
+
+  return rows;
+}
+
+function inferPaymentMilestones(text: string) {
+  const lines = text.split(/\r?\n/);
+  const rows = lines
+    .filter((line) => /pago|anticipo|estimacion|factura/i.test(line))
+    .slice(0, 12)
+    .map((line) => ({
+      concept: compactText(line, 220) ?? "Hito de pago detectado",
+      paymentDate: null,
+      amount: null,
+    }));
+
+  return rows;
+}
+
+function inferRiskClauses(text: string): ContractRiskClause[] {
+  const lines = text.split(/\r?\n/);
+  const catalog: Array<{ key: string; title: string; riskLevel: "medium" | "high" }> = [
+    { key: "penalizacion", title: "Penalizaciones economicas", riskLevel: "high" },
+    { key: "rescision", title: "Causal de rescision", riskLevel: "high" },
+    { key: "garantia", title: "Garantias y fianzas", riskLevel: "medium" },
+    { key: "retencion", title: "Retencion de pagos", riskLevel: "high" },
+    { key: "sancion", title: "Sanciones administrativas", riskLevel: "high" },
+  ];
+
+  const matches: ContractRiskClause[] = [];
+
+  for (const item of catalog) {
+    const foundLine = lines.find((line) => line.toLowerCase().includes(item.key));
+
+    if (!foundLine) {
+      continue;
+    }
+
+    matches.push({
+      title: item.title,
+      snippet: compactText(foundLine, 320) ?? item.title,
+      riskLevel: item.riskLevel,
+      requiresLegalValidation: true,
+    });
+  }
+
+  return matches;
+}
+
+function buildRegexFallback(fullText: string): ContractAiExtractionOutput {
+  const riskClauses = inferRiskClauses(fullText);
+
+  return {
+    fields: {
+      title: inferTitle(fullText),
+      counterpartyEntity: inferCounterparty(fullText),
+      contractNumber: inferContractNumber(fullText),
+      contractType: inferContractType(fullText),
+      startDate: null,
+      endDate: null,
+      totalAmount: inferAmount(fullText),
+      currency: "MXN",
+      description: compactText(fullText, 800),
+    },
+    deliverables: inferDeliverables(fullText),
+    paymentMilestones: inferPaymentMilestones(fullText),
+    riskClauses,
+    warnings: [
+      {
+        code: "CONTRACT_EXTRACTION_FALLBACK",
+        message: "Extraccion parcial con heuristicas. Requiere validacion legal.",
+      },
+    ],
+    engine: "regex_fallback",
+    model: null,
+    usage: null,
+  };
+}
+
+function normalizeAiOutput(payload: z.infer<typeof ContractExtractionResponseSchema>): ContractAiExtractionOutput {
+  const fallback = buildRegexFallback("");
+
+  const fields = payload.fields ?? {};
+  const deliverables = Array.isArray(payload.deliverables) ? payload.deliverables : [];
+  const paymentMilestones = Array.isArray(payload.paymentMilestones) ? payload.paymentMilestones : [];
+  const riskClauses = Array.isArray(payload.riskClauses) ? payload.riskClauses : [];
+
+  return {
+    fields: {
+      title: compactText(fields.title ?? "", 220),
+      counterpartyEntity: compactText(fields.counterpartyEntity ?? "", 220),
+      contractNumber: compactText(fields.contractNumber ?? "", 120),
+      contractType: compactText(fields.contractType ?? "", 120),
+      startDate: normalizeIsoDate(fields.startDate),
+      endDate: normalizeIsoDate(fields.endDate),
+      totalAmount: normalizeAmount(fields.totalAmount),
+      currency: compactText(fields.currency ?? "", 10) ?? "MXN",
+      description: compactText(fields.description ?? "", 1200),
+    },
+    deliverables: deliverables
+      .map((item) => ({
+        title: compactText(item.title ?? "", 220),
+        dueDate: normalizeIsoDate(item.dueDate),
+        amountLinked: normalizeAmount(item.amountLinked),
+        notes: compactText(item.notes ?? "", 500),
+      }))
+      .filter((item): item is { title: string; dueDate: string | null; amountLinked: number | null; notes: string | null } => Boolean(item.title)),
+    paymentMilestones: paymentMilestones
+      .map((item) => ({
+        concept: compactText(item.concept ?? "", 220),
+        paymentDate: normalizeIsoDate(item.paymentDate),
+        amount: normalizeAmount(item.amount),
+      }))
+      .filter((item): item is { concept: string; paymentDate: string | null; amount: number | null } => Boolean(item.concept)),
+    riskClauses: riskClauses
+      .map((item) => ({
+        title: compactText(item.title ?? "", 160),
+        snippet: compactText(item.snippet ?? "", 320),
+        riskLevel: item.riskLevel ?? "medium",
+        requiresLegalValidation: true,
+      }))
+      .filter((item): item is ContractRiskClause => Boolean(item.title) && Boolean(item.snippet)),
+    warnings: fallback.warnings,
+    engine: "openai_json_object",
+    model: null,
+    usage: null,
+  };
+}
+
+async function callOpenAi(fullText: string) {
+  const apiKey = getOpenAiApiKey();
+
+  if (!apiKey) {
+    throw new Error("No se encontro API key para OpenAI.");
+  }
+
+  const model = process.env.OPENAI_CONTRACT_MODEL?.trim() || DEFAULT_OPENAI_MODEL;
+  const timeoutMs = parsePositiveInteger(process.env.OPENAI_CONTRACT_TIMEOUT_MS, DEFAULT_TIMEOUT_MS);
+  const baseUrl = (process.env.OPENAI_API_BASE_URL?.trim() || DEFAULT_OPENAI_BASE_URL).replace(/\/+$/, "");
+
+  const systemPrompt = [
+    "Eres analista juridico especializado en contratos publicos mexicanos.",
+    "Responde unicamente JSON valido.",
+    "Si no hay certeza en un campo usa null.",
+    "Identifica riesgos contractuales y marca enfoque conservador.",
+  ].join(" ");
+
+  const userPrompt = [
+    "Extrae campos del contrato y devuelve JSON con claves: fields, deliverables, paymentMilestones, riskClauses.",
+    "fields: title,counterpartyEntity,contractNumber,contractType,startDate,endDate,totalAmount,currency,description.",
+    "deliverables: [{title,dueDate,amountLinked,notes}]",
+    "paymentMilestones: [{concept,paymentDate,amount}]",
+    "riskClauses: [{title,snippet,riskLevel}]",
+    "Texto:",
+    clampText(fullText),
+  ].join("\n\n");
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+
+  try {
+    const response = await fetch(`${baseUrl}/chat/completions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`,
+      },
+      body: JSON.stringify({
+        model,
+        temperature: 0,
+        response_format: {
+          type: "json_object",
+        },
+        messages: [
+          { role: "system", content: systemPrompt },
+          { role: "user", content: userPrompt },
+        ],
+      }),
+      signal: controller.signal,
+    });
+
+    const payload = (await response.json().catch(() => ({}))) as OpenAiChatCompletionResponse;
+
+    if (!response.ok) {
+      throw new Error(payload.error?.message ?? `OpenAI error ${response.status}`);
+    }
+
+    const content = payload.choices?.[0]?.message?.content;
+
+    if (!content) {
+      throw new Error("OpenAI no devolvio contenido util.");
+    }
+
+    const parsed = ContractExtractionResponseSchema.parse(extractJsonObject(content));
+    const normalized = normalizeAiOutput(parsed);
+
+    return {
+      ...normalized,
+      engine: "openai_json_object" as const,
+      model: payload.model ?? model,
+      usage: {
+        promptTokens: payload.usage?.prompt_tokens ?? null,
+        completionTokens: payload.usage?.completion_tokens ?? null,
+        totalTokens: payload.usage?.total_tokens ?? null,
+      },
+      warnings: [
+        {
+          code: "LEGAL_VALIDATION_REQUIRED",
+          message: "Resultado automatizado. Requiere validacion legal antes de uso formal.",
+        },
+      ],
+    };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+export async function extractContractWithAi(fullText: string): Promise<ContractAiExtractionOutput> {
+  const cleaned = fullText.trim();
+
+  if (!cleaned) {
+    return buildRegexFallback(fullText);
+  }
+
+  try {
+    return await callOpenAi(cleaned);
+  } catch (error) {
+    const fallback = buildRegexFallback(cleaned);
+    fallback.warnings.push({
+      code: "OPENAI_CONTRACT_EXTRACTION_FAILED",
+      message: error instanceof Error ? error.message : "No fue posible usar IA para extraer el contrato.",
+    });
+    return fallback;
+  }
+}
diff --git a/src/lib/contracts/proposal-continuity.ts b/src/lib/contracts/proposal-continuity.ts
new file mode 100644
index 0000000..8a4665d
--- /dev/null
+++ b/src/lib/contracts/proposal-continuity.ts
@@ -0,0 +1,144 @@
+import "server-only";
+
+import { prisma } from "@/lib/prisma";
+import { MAX_CONTRACT_PDF_BYTES, storeContractDocumentFile } from "@/lib/contracts/storage";
+import { readStoredProposalDocument } from "@/lib/proposals/storage";
+
+type ProposalPdfDocument = {
+  id: string;
+  fileName: string;
+  filePath: string;
+  mimeType: string;
+  sizeBytes: number;
+  checksumSha256: string | null;
+  createdAt: Date;
+};
+
+export type ProposalPdfSource = {
+  proposal: {
+    id: string;
+    title: string;
+  };
+  document: ProposalPdfDocument;
+  fileBuffer: Buffer;
+};
+
+export type ProposalPdfLookupResult =
+  | { status: "proposal_not_found" }
+  | { status: "pdf_not_found"; proposal: { id: string; title: string } }
+  | { status: "ok"; source: ProposalPdfSource };
+
+export function isPdfProposalDocument(document: { fileName: string; mimeType: string }) {
+  return document.mimeType === "application/pdf" || document.fileName.toLowerCase().endsWith(".pdf");
+}
+
+export async function getLatestProposalPdfSourceForUser(userId: string, proposalId: string): Promise<ProposalPdfLookupResult> {
+  const proposal = await prisma.proposal.findFirst({
+    where: {
+      id: proposalId,
+      userId,
+    },
+    select: {
+      id: true,
+      title: true,
+      documents: {
+        orderBy: [{ createdAt: "desc" }],
+        select: {
+          id: true,
+          fileName: true,
+          filePath: true,
+          mimeType: true,
+          sizeBytes: true,
+          checksumSha256: true,
+          createdAt: true,
+        },
+      },
+    },
+  });
+
+  if (!proposal) {
+    return { status: "proposal_not_found" };
+  }
+
+  const latestPdf = proposal.documents.find((item) => isPdfProposalDocument(item)) ?? null;
+  if (!latestPdf) {
+    return {
+      status: "pdf_not_found",
+      proposal: {
+        id: proposal.id,
+        title: proposal.title,
+      },
+    };
+  }
+
+  const fileBuffer = await readStoredProposalDocument(latestPdf.filePath, MAX_CONTRACT_PDF_BYTES);
+  return {
+    status: "ok",
+    source: {
+      proposal: {
+        id: proposal.id,
+        title: proposal.title,
+      },
+      document: latestPdf,
+      fileBuffer,
+    },
+  };
+}
+
+export async function ensureProposalPdfLinkedToContract(args: {
+  userId: string;
+  contractId: string;
+  source: ProposalPdfSource;
+}) {
+  const { userId, contractId, source } = args;
+
+  const recentDocuments = await prisma.contractDocument.findMany({
+    where: {
+      contractId,
+    },
+    orderBy: [{ createdAt: "desc" }],
+    take: 25,
+    select: {
+      id: true,
+      fileName: true,
+      sizeBytes: true,
+      checksumSha256: true,
+    },
+  });
+
+  const duplicate = recentDocuments.find((item) => {
+    if (source.document.checksumSha256 && item.checksumSha256) {
+      return source.document.checksumSha256 === item.checksumSha256;
+    }
+
+    return item.fileName === source.document.fileName && item.sizeBytes === source.document.sizeBytes;
+  });
+
+  if (duplicate) {
+    return {
+      created: false,
+      documentId: duplicate.id,
+    };
+  }
+
+  const stored = await storeContractDocumentFile(userId, contractId, source.document.fileName, source.document.mimeType, source.fileBuffer);
+  const created = await prisma.contractDocument.create({
+    data: {
+      contractId,
+      fileName: stored.fileName,
+      filePath: stored.filePath,
+      mimeType: stored.mimeType,
+      sizeBytes: stored.sizeBytes,
+      checksumSha256: stored.checksumSha256,
+      kind: "SIGNED_CONTRACT",
+    },
+    select: {
+      id: true,
+    },
+  });
+
+  return {
+    created: true,
+    documentId: created.id,
+  };
+}
diff --git a/src/lib/contracts/server.ts b/src/lib/contracts/server.ts
new file mode 100644
index 0000000..62041f8
--- /dev/null
+++ b/src/lib/contracts/server.ts
@@ -0,0 +1,281 @@
+import "server-only";
+
+import type { Prisma } from "@prisma/client";
+import { prisma } from "@/lib/prisma";
+import type {
+  ContractAiExtractionOutput,
+  ContractCreateInput,
+  ContractDeliverableView,
+  ContractKpiSnapshot,
+  ContractListFilters,
+  ContractPaymentView,
+  ContractRecordView,
+} from "@/lib/contracts/types";
+
+function toNumber(value: Prisma.Decimal | number | string | null | undefined) {
+  if (value === null || value === undefined) {
+    return null;
+  }
+
+  const numeric = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(numeric) ? Number(numeric) : null;
+}
+
+function toIso(value: Date | null | undefined) {
+  return value ? value.toISOString() : null;
+}
+
+export function isContractOperational(args: {
+  status: "ACTIVE" | "COMPLETED" | "PAUSED" | "CANCELLED";
+  endDate: Date | null;
+  now?: Date;
+}) {
+  if (args.status !== "ACTIVE") {
+    return false;
+  }
+
+  if (!args.endDate) {
+    return true;
+  }
+
+  const now = args.now ?? new Date();
+  return args.endDate.getTime() >= now.getTime();
+}
+
+function isDeliverableOverdue(input: {
+  status: "PENDING" | "DELIVERED" | "APPROVED" | "REJECTED" | "OVERDUE";
+  dueDate: Date | null;
+  now: Date;
+}) {
+  if (input.status === "OVERDUE") {
+    return true;
+  }
+
+  if (input.status !== "PENDING" || !input.dueDate) {
+    return false;
+  }
+
+  return input.dueDate.getTime() < input.now.getTime();
+}
+
+function mapDeliverable(
+  row: {
+    id: string;
+    contractId: string;
+    title: string;
+    dueDate: Date | null;
+    amountLinked: Prisma.Decimal | null;
+    status: "PENDING" | "DELIVERED" | "APPROVED" | "REJECTED" | "OVERDUE";
+    deliveredAt: Date | null;
+    approvedAt: Date | null;
+    notes: string;
+    createdAt: Date;
+    updatedAt: Date;
+  },
+  now: Date,
+): ContractDeliverableView {
+  return {
+    id: row.id,
+    contractId: row.contractId,
+    title: row.title,
+    dueDate: toIso(row.dueDate),
+    amountLinked: toNumber(row.amountLinked),
+    status: row.status,
+    deliveredAt: toIso(row.deliveredAt),
+    approvedAt: toIso(row.approvedAt),
+    notes: row.notes,
+    isOverdue: isDeliverableOverdue({
+      status: row.status,
+      dueDate: row.dueDate,
+      now,
+    }),
+    createdAt: row.createdAt.toISOString(),
+    updatedAt: row.updatedAt.toISOString(),
+  };
+}
+
+function mapPayment(row: {
+  id: string;
+  contractId: string;
+  amount: Prisma.Decimal;
+  paymentDate: Date;
+  invoiceNumber: string | null;
+  concept: string;
+  status: "REGISTERED" | "CONFIRMED" | "DISPUTED";
+  createdAt: Date;
+  updatedAt: Date;
+}): ContractPaymentView {
+  return {
+    id: row.id,
+    contractId: row.contractId,
+    amount: toNumber(row.amount) ?? 0,
+    paymentDate: row.paymentDate.toISOString(),
+    invoiceNumber: row.invoiceNumber,
+    concept: row.concept,
+    status: row.status,
+    createdAt: row.createdAt.toISOString(),
+    updatedAt: row.updatedAt.toISOString(),
+  };
+}
+
+function computeProgress(deliverables: ContractDeliverableView[]) {
+  const total = deliverables.length;
+
+  if (total === 0) {
+    return {
+      completed: 0,
+      total: 0,
+      percent: 0,
+    };
+  }
+
+  const completed = deliverables.filter((item) => item.status === "DELIVERED" || item.status === "APPROVED").length;
+  const percent = Math.round((completed / total) * 100);
+
+  return {
+    completed,
+    total,
+    percent,
+  };
+}
+
+export function computeContractKpis(contracts: ContractRecordView[]): ContractKpiSnapshot {
+  const activeContracts = contracts.filter((item) => item.isActiveOperational).length;
+  let totalCollected = 0;
+  let pendingDeliverables = 0;
+  let overdueDeliverables = 0;
+
+  for (const contract of contracts) {
+    for (const payment of contract.payments) {
+      if (payment.status === "CONFIRMED") {
+        totalCollected += payment.amount;
+      }
+    }
+
+    for (const deliverable of contract.deliverables) {
+      if (deliverable.status === "PENDING") {
+        pendingDeliverables += 1;
+      }
+
+      if (deliverable.isOverdue) {
+        overdueDeliverables += 1;
+      }
+    }
+  }
+
+  return {
+    activeContracts,
+    totalCollected: Number(totalCollected.toFixed(2)),
+    pendingDeliverables,
+    overdueDeliverables,
+  };
+}
+
+export async function listContractsForUser(userId: string, filters: ContractListFilters = {}, now = new Date()) {
+  const where: Prisma.ContractRecordWhereInput = {
+    userId,
+  };
+
+  if (filters.status) {
+    where.status = filters.status;
+  }
+
+  if (filters.q) {
+    where.OR = [
+      { title: { contains: filters.q, mode: "insensitive" } },
+      { counterpartyEntity: { contains: filters.q, mode: "insensitive" } },
+      { contractNumber: { contains: filters.q, mode: "insensitive" } },
+      { contractType: { contains: filters.q, mode: "insensitive" } },
+    ];
+  }
+
+  const orderBy: Prisma.ContractRecordOrderByWithRelationInput[] =
+    filters.sort === "endDate"
+      ? [{ endDate: "asc" }, { updatedAt: "desc" }]
+      : filters.sort === "createdAt"
+        ? [{ createdAt: "desc" }]
+        : [{ updatedAt: "desc" }];
+
+  const rows = await prisma.contractRecord.findMany({
+    where,
+    orderBy,
+    include: {
+      deliverables: {
+        orderBy: [{ dueDate: "asc" }, { createdAt: "asc" }],
+      },
+      payments: {
+        orderBy: [{ paymentDate: "desc" }, { createdAt: "desc" }],
+      },
+      documents: {
+        orderBy: [{ createdAt: "desc" }],
+      },
+    },
+    take: 200,
+  });
+
+  return rows.map<ContractRecordView>((row) => {
+    const deliverables = row.deliverables.map((item) => mapDeliverable(item, now));
+
+    return {
+      id: row.id,
+      sourceProposalId: row.sourceProposalId,
+      title: row.title,
+      counterpartyEntity: row.counterpartyEntity,
+      contractNumber: row.contractNumber,
+      contractType: row.contractType,
+      startDate: toIso(row.startDate),
+      endDate: toIso(row.endDate),
+      totalAmount: toNumber(row.totalAmount),
+      currency: row.currency,
+      status: row.status,
+      description: row.description,
+      progress: computeProgress(deliverables),
+      isActiveOperational: isContractOperational({
+        status: row.status,
+        endDate: row.endDate,
+        now,
+      }),
+      createdAt: row.createdAt.toISOString(),
+      updatedAt: row.updatedAt.toISOString(),
+      deliverables,
+      payments: row.payments.map((item) => mapPayment(item)),
+      documents: row.documents.map((item) => ({
+        id: item.id,
+        contractId: item.contractId,
+        fileName: item.fileName,
+        filePath: item.filePath,
+        mimeType: item.mimeType,
+        sizeBytes: item.sizeBytes,
+        checksumSha256: item.checksumSha256,
+        kind: item.kind,
+        createdAt: item.createdAt.toISOString(),
+      })),
+    };
+  });
+}
+
+export async function getContractsKpisForUser(userId: string, now = new Date()) {
+  const contracts = await listContractsForUser(userId, {}, now);
+  return computeContractKpis(contracts);
+}
+
+export function contractCreateInputFromExtraction(args: {
+  extraction: ContractAiExtractionOutput;
+  fallbackTitle?: string;
+}): ContractCreateInput {
+  const { extraction } = args;
+
+  return {
+    title: extraction.fields.title ?? args.fallbackTitle ?? "Contrato sin titulo",
+    counterpartyEntity: extraction.fields.counterpartyEntity ?? "Entidad contratante por validar",
+    contractNumber: extraction.fields.contractNumber,
+    contractType: extraction.fields.contractType ?? "General",
+    startDate: extraction.fields.startDate,
+    endDate: extraction.fields.endDate,
+    totalAmount: extraction.fields.totalAmount,
+    currency: extraction.fields.currency ?? "MXN",
+    description: extraction.fields.description ?? "",
+    status: "ACTIVE",
+    sourceProposalId: null,
+  };
+}
diff --git a/src/lib/contracts/storage.ts b/src/lib/contracts/storage.ts
new file mode 100644
index 0000000..5861797
--- /dev/null
+++ b/src/lib/contracts/storage.ts
@@ -0,0 +1,130 @@
+import "server-only";
+
+import { createHash, randomUUID } from "node:crypto";
+import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+export const MAX_CONTRACT_PDF_BYTES = 20 * 1024 * 1024;
+
+const CONTRACT_STORAGE_ROOT = path.join(process.cwd(), "storage", "contracts");
+
+export type StoredContractFile = {
+  fileName: string;
+  filePath: string;
+  mimeType: string;
+  sizeBytes: number;
+  checksumSha256: string;
+};
+
+function normalizeExtension(fileName: string, mimeType: string) {
+  const normalized = fileName.trim().toLowerCase();
+  if (normalized.endsWith(".pdf")) {
+    return "pdf";
+  }
+
+  if (normalized.endsWith(".xml")) {
+    return "xml";
+  }
+
+  if (normalized.endsWith(".jpg") || normalized.endsWith(".jpeg")) {
+    return "jpg";
+  }
+
+  if (normalized.endsWith(".png")) {
+    return "png";
+  }
+
+  if (mimeType === "application/pdf") {
+    return "pdf";
+  }
+
+  if (mimeType === "application/xml" || mimeType === "text/xml") {
+    return "xml";
+  }
+
+  return "bin";
+}
+
+function sanitizeFileName(fileName: string, extension: string) {
+  const compact = fileName.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-");
+  const fallback = compact || `contract-document.${extension}`;
+  return fallback.endsWith(`.${extension}`) ? fallback : `${fallback}.${extension}`;
+}
+
+export async function storeContractDocumentFile(
+  userId: string,
+  contractId: string,
+  originalFileName: string,
+  mimeType: string,
+  fileBuffer: Buffer,
+): Promise<StoredContractFile> {
+  const extension = normalizeExtension(originalFileName, mimeType);
+  const safeOriginalName = sanitizeFileName(originalFileName, extension);
+  const userContractDir = path.join(CONTRACT_STORAGE_ROOT, userId, contractId);
+  const storedFileName = `${Date.now()}-${randomUUID()}.${extension}`;
+  const absolutePath = path.join(userContractDir, storedFileName);
+
+  await mkdir(userContractDir, { recursive: true });
+  await writeFile(absolutePath, fileBuffer);
+
+  return {
+    fileName: safeOriginalName,
+    filePath: path.join("storage", "contracts", userId, contractId, storedFileName).replace(/\\/g, "/"),
+    mimeType: mimeType || "application/octet-stream",
+    sizeBytes: fileBuffer.byteLength,
+    checksumSha256: createHash("sha256").update(fileBuffer).digest("hex"),
+  };
+}
+
+export async function removeStoredContractDocumentFile(relativeFilePath: string | null | undefined) {
+  if (!relativeFilePath) {
+    return;
+  }
+
+  const storageRoot = path.resolve(process.cwd(), "storage");
+  const absolutePath = path.resolve(process.cwd(), relativeFilePath);
+
+  if (!absolutePath.startsWith(`${storageRoot}${path.sep}`)) {
+    return;
+  }
+
+  try {
+    await unlink(absolutePath);
+  } catch {
+    // Ignore cleanup errors.
+  }
+}
+
+export async function readStoredContractDocumentFile(relativeFilePath: string, maxBytes = MAX_CONTRACT_PDF_BYTES) {
+  const storageRoot = path.resolve(process.cwd(), "storage");
+  const absolutePath = path.resolve(process.cwd(), relativeFilePath);
+
+  if (!absolutePath.startsWith(`${storageRoot}${path.sep}`)) {
+    throw new Error("CONTRACT_DOCUMENT_INVALID_PATH");
+  }
+
+  try {
+    const buffer = await readFile(absolutePath);
+
+    if (!buffer.byteLength) {
+      throw new Error("CONTRACT_DOCUMENT_EMPTY");
+    }
+
+    if (buffer.byteLength > maxBytes) {
+      throw new Error("CONTRACT_DOCUMENT_TOO_LARGE");
+    }
+
+    return buffer;
+  } catch (error) {
+    if (
+      error &&
+      typeof error === "object" &&
+      "code" in error &&
+      (error as NodeJS.ErrnoException).code === "ENOENT"
+    ) {
+      throw new Error("CONTRACT_DOCUMENT_NOT_FOUND");
+    }
+
+    throw error;
+  }
+}
diff --git a/src/lib/contracts/types.ts b/src/lib/contracts/types.ts
new file mode 100644
index 0000000..2eb9df5
--- /dev/null
+++ b/src/lib/contracts/types.ts
@@ -0,0 +1,194 @@
+import type {
+  ContractDeliverableStatus,
+  ContractDocumentKind,
+  ContractPaymentStatus,
+  ContractStatus,
+} from "@prisma/client";
+import { z } from "zod";
+
+export type ContractKpiSnapshot = {
+  activeContracts: number;
+  totalCollected: number;
+  pendingDeliverables: number;
+  overdueDeliverables: number;
+};
+
+export type ContractProgressSnapshot = {
+  completed: number;
+  total: number;
+  percent: number;
+};
+
+export type ContractDeliverableView = {
+  id: string;
+  contractId: string;
+  title: string;
+  dueDate: string | null;
+  amountLinked: number | null;
+  status: ContractDeliverableStatus;
+  deliveredAt: string | null;
+  approvedAt: string | null;
+  notes: string;
+  isOverdue: boolean;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type ContractPaymentView = {
+  id: string;
+  contractId: string;
+  amount: number;
+  paymentDate: string;
+  invoiceNumber: string | null;
+  concept: string;
+  status: ContractPaymentStatus;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type ContractDocumentView = {
+  id: string;
+  contractId: string;
+  fileName: string;
+  filePath: string;
+  mimeType: string;
+  sizeBytes: number;
+  checksumSha256: string | null;
+  kind: ContractDocumentKind;
+  createdAt: string;
+};
+
+export type ContractRecordView = {
+  id: string;
+  sourceProposalId: string | null;
+  title: string;
+  counterpartyEntity: string;
+  contractNumber: string | null;
+  contractType: string;
+  startDate: string | null;
+  endDate: string | null;
+  totalAmount: number | null;
+  currency: string;
+  status: ContractStatus;
+  description: string;
+  progress: ContractProgressSnapshot;
+  isActiveOperational: boolean;
+  createdAt: string;
+  updatedAt: string;
+  deliverables: ContractDeliverableView[];
+  payments: ContractPaymentView[];
+  documents: ContractDocumentView[];
+};
+
+export type ContractExtractionWarning = {
+  code: string;
+  message: string;
+};
+
+export type ContractRiskClause = {
+  title: string;
+  snippet: string;
+  riskLevel: "low" | "medium" | "high";
+  requiresLegalValidation: boolean;
+};
+
+export type ContractDeliverableExtracted = {
+  title: string;
+  dueDate: string | null;
+  amountLinked: number | null;
+  notes: string | null;
+};
+
+export type ContractPaymentMilestoneExtracted = {
+  concept: string;
+  paymentDate: string | null;
+  amount: number | null;
+};
+
+export type ContractAiExtractionInput = {
+  fileName: string;
+  text: string;
+};
+
+export type ContractAiExtractionOutput = {
+  fields: {
+    title: string | null;
+    counterpartyEntity: string | null;
+    contractNumber: string | null;
+    contractType: string | null;
+    startDate: string | null;
+    endDate: string | null;
+    totalAmount: number | null;
+    currency: string | null;
+    description: string | null;
+  };
+  deliverables: ContractDeliverableExtracted[];
+  paymentMilestones: ContractPaymentMilestoneExtracted[];
+  riskClauses: ContractRiskClause[];
+  warnings: ContractExtractionWarning[];
+  engine: "openai_json_object" | "regex_fallback";
+  model: string | null;
+  usage:
+    | {
+        promptTokens: number | null;
+        completionTokens: number | null;
+        totalTokens: number | null;
+      }
+    | null;
+};
+
+export const ContractCreateInputSchema = z.object({
+  sourceProposalId: z.string().trim().min(1).optional().nullable(),
+  title: z.string().trim().min(3).max(220),
+  counterpartyEntity: z.string().trim().min(2).max(220),
+  contractNumber: z.string().trim().max(120).optional().nullable(),
+  contractType: z.string().trim().min(2).max(120),
+  startDate: z.string().datetime().optional().nullable(),
+  endDate: z.string().datetime().optional().nullable(),
+  totalAmount: z.number().finite().nonnegative().optional().nullable(),
+  currency: z.string().trim().min(3).max(10).optional(),
+  status: z.enum(["ACTIVE", "COMPLETED", "PAUSED", "CANCELLED"]).optional(),
+  description: z.string().trim().max(6000).optional(),
+});
+
+export const ContractUpdateInputSchema = ContractCreateInputSchema.partial().extend({
+  status: z.enum(["ACTIVE", "COMPLETED", "PAUSED", "CANCELLED"]).optional(),
+});
+
+export const ContractListFiltersSchema = z.object({
+  q: z.string().trim().optional(),
+  status: z.enum(["ACTIVE", "COMPLETED", "PAUSED", "CANCELLED"]).optional(),
+  sort: z.enum(["updatedAt", "endDate", "createdAt"]).optional(),
+});
+
+export const DeliverableCreateInputSchema = z.object({
+  title: z.string().trim().min(2).max(220),
+  dueDate: z.string().datetime().optional().nullable(),
+  amountLinked: z.number().finite().nonnegative().optional().nullable(),
+  notes: z.string().trim().max(3000).optional(),
+});
+
+export const DeliverableUpdateInputSchema = z.object({
+  status: z.enum(["PENDING", "DELIVERED", "APPROVED", "REJECTED", "OVERDUE"]).optional(),
+  dueDate: z.string().datetime().optional().nullable(),
+  deliveredAt: z.string().datetime().optional().nullable(),
+  approvedAt: z.string().datetime().optional().nullable(),
+  notes: z.string().trim().max(3000).optional(),
+  amountLinked: z.number().finite().nonnegative().optional().nullable(),
+  title: z.string().trim().min(2).max(220).optional(),
+});
+
+export const PaymentCreateInputSchema = z.object({
+  amount: z.number().finite().positive(),
+  paymentDate: z.string().datetime(),
+  invoiceNumber: z.string().trim().max(120).optional().nullable(),
+  concept: z.string().trim().min(2).max(500),
+  status: z.enum(["REGISTERED", "CONFIRMED", "DISPUTED"]).optional(),
+});
+
+export type ContractCreateInput = z.infer<typeof ContractCreateInputSchema>;
+export type ContractUpdateInput = z.infer<typeof ContractUpdateInputSchema>;
+export type ContractListFilters = z.infer<typeof ContractListFiltersSchema>;
+export type DeliverableCreateInput = z.infer<typeof DeliverableCreateInputSchema>;
+export type DeliverableUpdateInput = z.infer<typeof DeliverableUpdateInputSchema>;
+export type PaymentCreateInput = z.infer<typeof PaymentCreateInputSchema>;
diff --git a/src/lib/cron/auth.ts b/src/lib/cron/auth.ts
new file mode 100644
index 0000000..0b47321
--- /dev/null
+++ b/src/lib/cron/auth.ts
@@ -0,0 +1,36 @@
+import "server-only";
+
+import { licitationsConfig } from "@/lib/licitations/config";
+
+function readBearerToken(value: string | null) {
+  if (!value) {
+    return "";
+  }
+
+  const normalized = value.trim();
+  if (!normalized.toLowerCase().startsWith("bearer ")) {
+    return "";
+  }
+
+  return normalized.slice(7).trim();
+}
+
+export function isAuthorizedCronRequest(request: Request) {
+  const syncToken = request.headers.get("x-sync-token")?.trim() ?? "";
+  if (licitationsConfig.syncCronToken && syncToken && syncToken === licitationsConfig.syncCronToken) {
+    return true;
+  }
+
+  const bearerToken = readBearerToken(request.headers.get("authorization"));
+  if (licitationsConfig.cronSecret && bearerToken && bearerToken === licitationsConfig.cronSecret) {
+    return true;
+  }
+
+  const url = new URL(request.url);
+  const queryToken = url.searchParams.get("token")?.trim() ?? "";
+  if (licitationsConfig.syncCronToken && queryToken && queryToken === licitationsConfig.syncCronToken) {
+    return true;
+  }
+
+  return false;
+}
diff --git a/src/lib/layout/__tests__/header.test.ts b/src/lib/layout/__tests__/header.test.ts
new file mode 100644
index 0000000..9660ffc
--- /dev/null
+++ b/src/lib/layout/__tests__/header.test.ts
@@ -0,0 +1,23 @@
+import { describe, expect, it } from "vitest";
+import { getHeaderVisibility, resolveHeaderMode } from "@/lib/layout/header";
+
+describe("layout header mode", () => {
+  it("returns public mode for guests in auto mode", () => {
+    expect(resolveHeaderMode(false, "auto")).toBe("public");
+  });
+
+  it("returns module mode only for authenticated users", () => {
+    expect(resolveHeaderMode(true, "module")).toBe("module");
+    expect(resolveHeaderMode(false, "module")).toBe("public");
+  });
+
+  it("exposes visibility flags for module header", () => {
+    const visibility = getHeaderVisibility(true, "module");
+
+    expect(visibility.mode).toBe("module");
+    expect(visibility.showBackLink).toBe(true);
+    expect(visibility.showUserControls).toBe(true);
+    expect(visibility.showMarketingNav).toBe(false);
+    expect(visibility.showAuthButtons).toBe(false);
+  });
+});
diff --git a/src/lib/layout/header.ts b/src/lib/layout/header.ts
new file mode 100644
index 0000000..876c920
--- /dev/null
+++ b/src/lib/layout/header.ts
@@ -0,0 +1,38 @@
+export type HeaderMode = "public" | "app" | "module";
+export type HeaderModeRequest = HeaderMode | "auto";
+
+export function resolveHeaderMode(hasUser: boolean, requestedMode: HeaderModeRequest = "auto"): HeaderMode {
+  if (requestedMode === "public") {
+    return "public";
+  }
+
+  if (requestedMode === "app") {
+    return hasUser ? "app" : "public";
+  }
+
+  if (requestedMode === "module") {
+    return hasUser ? "module" : "public";
+  }
+
+  return hasUser ? "app" : "public";
+}
+
+export type HeaderVisibility = {
+  mode: HeaderMode;
+  showMarketingNav: boolean;
+  showAuthButtons: boolean;
+  showUserControls: boolean;
+  showBackLink: boolean;
+};
+
+export function getHeaderVisibility(hasUser: boolean, requestedMode: HeaderModeRequest = "auto"): HeaderVisibility {
+  const mode = resolveHeaderMode(hasUser, requestedMode);
+
+  return {
+    mode,
+    showMarketingNav: mode === "public",
+    showAuthButtons: mode === "public",
+    showUserControls: mode !== "public" && hasUser,
+    showBackLink: mode === "module" && hasUser,
+  };
+}
diff --git a/src/lib/legal/ai-documents.ts b/src/lib/legal/ai-documents.ts
new file mode 100644
index 0000000..d4f17b7
--- /dev/null
+++ b/src/lib/legal/ai-documents.ts
@@ -0,0 +1,268 @@
+import type { LegalCaseType, LegalCaseSeverity } from "@prisma/client";
+import type {
+  LegalDocumentGenerationInput,
+  LegalDocumentGenerationOutput,
+  LegalTemplateKey,
+  LegalTemplateView,
+} from "@/lib/legal/types";
+
+const DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1";
+const DEFAULT_OPENAI_MODEL = "gpt-4.1-mini";
+const DEFAULT_TIMEOUT_MS = 60_000;
+
+const LEGAL_TEMPLATE_CATALOG: Record<LegalTemplateKey, LegalTemplateView> = {
+  general_delivery_record: {
+    key: "general_delivery_record",
+    category: "general",
+    title: "Acta entrega-recepcion",
+    body: `ACTA DE ENTREGA-RECEPCION\n\nFecha: {{fecha}}\nEmpresa: {{companyName}}\nContraparte: {{counterparty}}\n\nSe deja constancia de la entrega de bienes/servicios conforme al contrato aplicable.\n\nDetalle: {{description}}\n\nFirmas:\n- Representante empresa\n- Representante contraparte`,
+  },
+  breach_disagreement_letter: {
+    key: "breach_disagreement_letter",
+    category: "breach",
+    title: "Carta de inconformidad por incumplimiento",
+    body: `CARTA DE INCONFORMIDAD\n\nA quien corresponda:\n\nPor medio del presente escrito, {{companyName}} manifiesta inconformidad por incumplimiento contractual de {{counterparty}}.\n\nHechos: {{description}}\nObjetivo: {{objective}}\n\nSolicitamos atencion y respuesta dentro del plazo legal aplicable.`,
+  },
+  payment_release_request: {
+    key: "payment_release_request",
+    category: "payment",
+    title: "Solicitud de liberacion de pago",
+    body: `SOLICITUD DE LIBERACION DE PAGO\n\nEmpresa solicitante: {{companyName}}\nContraparte: {{counterparty}}\nMonto en riesgo: {{amountAtRisk}}\n\nSe solicita la liberacion inmediata del pago retenido, derivado de las obligaciones cumplidas conforme al contrato.\n\nSoporte: {{description}}`,
+  },
+  sanctions_challenge_resource: {
+    key: "sanctions_challenge_resource",
+    category: "sanctions",
+    title: "Recurso de inconformidad por sancion",
+    body: `RECURSO DE INCONFORMIDAD\n\nPromovente: {{companyName}}\nAutoridad/Contraparte: {{counterparty}}\n\nSe promueve recurso en contra de la sancion impuesta, por considerarla improcedente.\n\nAntecedentes: {{description}}\nPretension: {{objective}}`,
+  },
+};
+
+type OpenAiChatCompletionResponse = {
+  choices?: Array<{
+    message?: {
+      content?: string | null;
+    };
+  }>;
+  model?: string;
+  usage?: {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+  };
+  error?: {
+    message?: string;
+  };
+};
+
+function parsePositiveInteger(value: string | undefined, fallback: number) {
+  const parsed = Number.parseInt((value ?? "").trim(), 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+
+function getOpenAiApiKey() {
+  return process.env.OPENAI_API_KEY?.trim() || process.env.API_KEY?.trim() || process.env.api_key?.trim() || "";
+}
+
+function toCaseLabel(caseType: LegalCaseType) {
+  if (caseType === "PAYMENT_RETENTION") {
+    return "Retencion de pagos";
+  }
+
+  if (caseType === "UNJUST_SANCTION") {
+    return "Sancion injustificada";
+  }
+
+  if (caseType === "CONTRACT_DISPUTE") {
+    return "Controversia contractual";
+  }
+
+  return "Incumplimiento contractual";
+}
+
+function toSeverityLabel(severity: LegalCaseSeverity) {
+  if (severity === "HIGH") {
+    return "Alta";
+  }
+
+  if (severity === "MEDIUM") {
+    return "Media";
+  }
+
+  return "Baja";
+}
+
+function compactText(value: string, maxLength = 1_500) {
+  const compacted = value.replace(/\s+/g, " ").trim();
+  if (!compacted) {
+    return "";
+  }
+
+  return compacted.length > maxLength ? compacted.slice(0, maxLength) : compacted;
+}
+
+function interpolateTemplate(template: string, input: LegalDocumentGenerationInput) {
+  const date = new Date().toLocaleDateString("es-MX", {
+    year: "numeric",
+    month: "long",
+    day: "2-digit",
+  });
+
+  return template
+    .replaceAll("{{fecha}}", date)
+    .replaceAll("{{companyName}}", input.companyName)
+    .replaceAll("{{counterparty}}", input.counterparty)
+    .replaceAll("{{amountAtRisk}}", input.amountAtRisk ? `$${input.amountAtRisk.toLocaleString("es-MX")}` : "No especificado")
+    .replaceAll("{{description}}", input.description)
+    .replaceAll("{{objective}}", input.objective);
+}
+
+function buildTemplateFallback(input: LegalDocumentGenerationInput): LegalDocumentGenerationOutput {
+  const defaultTemplateKey: LegalTemplateKey =
+    input.caseType === "PAYMENT_RETENTION"
+      ? "payment_release_request"
+      : input.caseType === "UNJUST_SANCTION"
+        ? "sanctions_challenge_resource"
+        : "breach_disagreement_letter";
+
+  const selectedTemplate = LEGAL_TEMPLATE_CATALOG[input.templateKey ?? defaultTemplateKey];
+  const content = interpolateTemplate(selectedTemplate.body, input);
+
+  return {
+    title: selectedTemplate.title,
+    content,
+    engine: "template_fallback",
+    model: null,
+    warnings: ["Generado con plantilla base. Requiere validacion legal antes de presentar."],
+    usage: null,
+  };
+}
+
+function extractJson(raw: string) {
+  const trimmed = raw.trim();
+
+  try {
+    return JSON.parse(trimmed) as unknown;
+  } catch {
+    // Continue with safe extraction.
+  }
+
+  const noFence = trimmed
+    .replace(/^```json\s*/i, "")
+    .replace(/^```\s*/i, "")
+    .replace(/\s*```$/i, "")
+    .trim();
+
+  const first = noFence.indexOf("{");
+  const last = noFence.lastIndexOf("}");
+
+  if (first >= 0 && last > first) {
+    return JSON.parse(noFence.slice(first, last + 1)) as unknown;
+  }
+
+  throw new Error("Respuesta de IA sin JSON valido.");
+}
+
+async function callOpenAi(input: LegalDocumentGenerationInput): Promise<LegalDocumentGenerationOutput> {
+  const apiKey = getOpenAiApiKey();
+
+  if (!apiKey) {
+    throw new Error("No se encontro API key para OpenAI.");
+  }
+
+  const model = process.env.OPENAI_LEGAL_MODEL?.trim() || DEFAULT_OPENAI_MODEL;
+  const timeoutMs = parsePositiveInteger(process.env.OPENAI_LEGAL_TIMEOUT_MS, DEFAULT_TIMEOUT_MS);
+  const baseUrl = (process.env.OPENAI_API_BASE_URL?.trim() || DEFAULT_OPENAI_BASE_URL).replace(/\/+$/, "");
+
+  const systemPrompt = [
+    "Eres abogado de contratacion publica en Mexico.",
+    "Redacta borradores legales estructurados y claros.",
+    "Responde solo JSON con claves title y content.",
+    "Incorpora advertencia de validacion legal cuando aplique.",
+  ].join(" ");
+
+  const userPrompt = [
+    `Tipo de caso: ${toCaseLabel(input.caseType)}`,
+    `Severidad: ${toSeverityLabel(input.severity)}`,
+    `Empresa: ${input.companyName}`,
+    `Contraparte: ${input.counterparty}`,
+    `Monto en riesgo: ${input.amountAtRisk ?? "No especificado"}`,
+    `Objetivo legal: ${input.objective}`,
+    "Descripcion del caso:",
+    compactText(input.description, 2_000),
+    "Genera un escrito legal breve con: encabezado, hechos, fundamentos, peticion y cierre.",
+  ].join("\n\n");
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+
+  try {
+    const response = await fetch(`${baseUrl}/chat/completions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`,
+      },
+      body: JSON.stringify({
+        model,
+        temperature: 0.2,
+        response_format: {
+          type: "json_object",
+        },
+        messages: [
+          { role: "system", content: systemPrompt },
+          { role: "user", content: userPrompt },
+        ],
+      }),
+      signal: controller.signal,
+    });
+
+    const payload = (await response.json().catch(() => ({}))) as OpenAiChatCompletionResponse;
+
+    if (!response.ok) {
+      throw new Error(payload.error?.message ?? `OpenAI error ${response.status}`);
+    }
+
+    const content = payload.choices?.[0]?.message?.content;
+
+    if (!content) {
+      throw new Error("OpenAI no devolvio contenido util.");
+    }
+
+    const parsed = extractJson(content) as { title?: unknown; content?: unknown };
+    const title = typeof parsed.title === "string" ? compactText(parsed.title, 220) : "Escrito legal";
+    const body = typeof parsed.content === "string" ? parsed.content.trim() : "";
+
+    if (!body) {
+      throw new Error("OpenAI devolvio un contenido vacio.");
+    }
+
+    return {
+      title,
+      content: body,
+      engine: "openai_json_object",
+      model: payload.model ?? model,
+      warnings: ["Borrador generado por IA. Requiere validacion legal."],
+      usage: {
+        promptTokens: payload.usage?.prompt_tokens ?? null,
+        completionTokens: payload.usage?.completion_tokens ?? null,
+        totalTokens: payload.usage?.total_tokens ?? null,
+      },
+    };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+export function listLegalTemplates() {
+  return Object.values(LEGAL_TEMPLATE_CATALOG);
+}
+
+export async function generateLegalDocument(input: LegalDocumentGenerationInput): Promise<LegalDocumentGenerationOutput> {
+  try {
+    return await callOpenAi(input);
+  } catch (error) {
+    const fallback = buildTemplateFallback(input);
+    fallback.warnings.push(error instanceof Error ? error.message : "No fue posible generar escrito con IA.");
+    return fallback;
+  }
+}
diff --git a/src/lib/legal/diagnosis.ts b/src/lib/legal/diagnosis.ts
new file mode 100644
index 0000000..427f5d4
--- /dev/null
+++ b/src/lib/legal/diagnosis.ts
@@ -0,0 +1,234 @@
+import type { LegalCaseSeverity, LegalCaseType } from "@prisma/client";
+import type {
+  DiagnosisAnswers,
+  DiagnosisRecommendation,
+  EscalationRouteStep,
+  EscalationStepProgress,
+  LegalTemplateKey,
+} from "@/lib/legal/types";
+
+export const ESCALATION_ROUTE_CATALOG: EscalationRouteStep[] = [
+  {
+    key: "formal_requirement",
+    title: "Requerimiento formal",
+    estimatedWindow: "3 a 7 dias habiles",
+    checklist: [
+      "Integrar contrato, anexos y evidencia de incumplimiento.",
+      "Emitir requerimiento con monto/obligacion precisa.",
+      "Registrar acuse o constancia de notificacion.",
+    ],
+    requiresLawyer: false,
+    dependsOn: null,
+  },
+  {
+    key: "administrative_conciliation",
+    title: "Conciliacion administrativa",
+    estimatedWindow: "1 a 3 semanas",
+    checklist: [
+      "Solicitar mesa de conciliacion ante autoridad competente.",
+      "Preparar posicion de negociacion y alternativas.",
+      "Documentar minutas y compromisos por escrito.",
+    ],
+    requiresLawyer: false,
+    dependsOn: "formal_requirement",
+  },
+  {
+    key: "oic_complaint",
+    title: "Queja ante OIC",
+    estimatedWindow: "2 a 6 semanas",
+    checklist: [
+      "Preparar relato cronologico y pruebas.",
+      "Identificar servidor publico o unidad responsable.",
+      "Presentar queja con firma y anexos.",
+    ],
+    requiresLawyer: true,
+    dependsOn: "administrative_conciliation",
+  },
+  {
+    key: "sfp_or_state_challenge",
+    title: "Inconformidad ante SFP u organo estatal",
+    estimatedWindow: "3 a 8 semanas",
+    checklist: [
+      "Confirmar causal de inconformidad aplicable.",
+      "Integrar expediente con evidencia validada.",
+      "Presentar escrito y dar seguimiento a prevenciones.",
+    ],
+    requiresLawyer: true,
+    dependsOn: "oic_complaint",
+  },
+  {
+    key: "jurisdictional_path",
+    title: "Via jurisdiccional",
+    estimatedWindow: "3 a 12 meses",
+    checklist: [
+      "Definir tribunal/instancia competente.",
+      "Preparar demanda y pruebas tecnicas/periciales.",
+      "Controlar terminos procesales con agenda legal.",
+    ],
+    requiresLawyer: true,
+    dependsOn: "sfp_or_state_challenge",
+  },
+];
+
+function normalizeString(value: unknown) {
+  return typeof value === "string" ? value.trim().toLowerCase() : "";
+}
+
+function toCaseType(value: DiagnosisAnswers["breachType"]): LegalCaseType {
+  if (value === "payment_retention") {
+    return "PAYMENT_RETENTION";
+  }
+
+  if (value === "unjust_sanction") {
+    return "UNJUST_SANCTION";
+  }
+
+  if (value === "contract_dispute") {
+    return "CONTRACT_DISPUTE";
+  }
+
+  return "CONTRACT_BREACH";
+}
+
+function inferSeverity(answers: DiagnosisAnswers): LegalCaseSeverity {
+  let score = 0;
+
+  if (answers.urgency === "high") {
+    score += 2;
+  }
+
+  if (answers.amountAtRisk && answers.amountAtRisk >= 500_000) {
+    score += 2;
+  } else if (answers.amountAtRisk && answers.amountAtRisk >= 100_000) {
+    score += 1;
+  }
+
+  if (answers.processStage === "trial" || answers.processStage === "ongoing_claim") {
+    score += 2;
+  }
+
+  if (answers.evidenceLevel === "none") {
+    score += 1;
+  }
+
+  if (score >= 4) {
+    return "HIGH";
+  }
+
+  if (score >= 2) {
+    return "MEDIUM";
+  }
+
+  return "LOW";
+}
+
+function inferTemplates(caseType: LegalCaseType): LegalTemplateKey[] {
+  if (caseType === "PAYMENT_RETENTION") {
+    return ["payment_release_request", "general_delivery_record"];
+  }
+
+  if (caseType === "UNJUST_SANCTION") {
+    return ["sanctions_challenge_resource", "breach_disagreement_letter"];
+  }
+
+  if (caseType === "CONTRACT_DISPUTE") {
+    return ["breach_disagreement_letter", "general_delivery_record"];
+  }
+
+  return ["breach_disagreement_letter", "general_delivery_record"];
+}
+
+function inferRoute(answers: DiagnosisAnswers, severity: LegalCaseSeverity): EscalationRouteStep[] {
+  const baseSteps = [...ESCALATION_ROUTE_CATALOG];
+
+  if (severity === "LOW" && answers.processStage !== "trial") {
+    return baseSteps.slice(0, 2);
+  }
+
+  if (severity === "MEDIUM") {
+    return baseSteps.slice(0, 4);
+  }
+
+  return baseSteps;
+}
+
+export function parseDiagnosisAnswers(raw: Record<string, unknown>): DiagnosisAnswers {
+  const breachTypeRaw = normalizeString(raw.breachType);
+  const processStageRaw = normalizeString(raw.processStage);
+  const evidenceLevelRaw = normalizeString(raw.evidenceLevel);
+  const urgencyRaw = normalizeString(raw.urgency);
+  const objectiveRaw = normalizeString(raw.objective);
+
+  const amountAtRiskCandidate = raw.amountAtRisk;
+  const amountAtRisk =
+    typeof amountAtRiskCandidate === "number"
+      ? Number.isFinite(amountAtRiskCandidate)
+        ? amountAtRiskCandidate
+        : null
+      : typeof amountAtRiskCandidate === "string"
+        ? Number.parseFloat(amountAtRiskCandidate.replace(/[^\d.,-]/g, "").replace(/,/g, "."))
+        : null;
+
+  return {
+    breachType:
+      breachTypeRaw === "payment_retention" || breachTypeRaw === "unjust_sanction" || breachTypeRaw === "contract_dispute" || breachTypeRaw === "contract_breach"
+        ? breachTypeRaw
+        : null,
+    processStage:
+      processStageRaw === "none" ||
+      processStageRaw === "informal_notice" ||
+      processStageRaw === "formal_notice" ||
+      processStageRaw === "ongoing_claim" ||
+      processStageRaw === "trial"
+        ? processStageRaw
+        : null,
+    evidenceLevel:
+      evidenceLevelRaw === "none" || evidenceLevelRaw === "basic" || evidenceLevelRaw === "solid" || evidenceLevelRaw === "robust"
+        ? evidenceLevelRaw
+        : null,
+    urgency: urgencyRaw === "low" || urgencyRaw === "medium" || urgencyRaw === "high" ? urgencyRaw : null,
+    objective: objectiveRaw === "payment" || objectiveRaw === "correction" || objectiveRaw === "challenge" || objectiveRaw === "mediation" ? objectiveRaw : null,
+    amountAtRisk: amountAtRisk && Number.isFinite(amountAtRisk) ? Number(amountAtRisk.toFixed(2)) : null,
+  };
+}
+
+export function evaluateDiagnosis(answers: DiagnosisAnswers): DiagnosisRecommendation {
+  const suggestedCaseType = toCaseType(answers.breachType);
+  const suggestedSeverity = inferSeverity(answers);
+  const suggestedRoute = inferRoute(answers, suggestedSeverity);
+  const recommendedTemplates = inferTemplates(suggestedCaseType);
+
+  const notes = ["Clasificacion automatica con enfoque conservador."];
+
+  if (!answers.evidenceLevel || answers.evidenceLevel === "none") {
+    notes.push("Falta evidencia suficiente: requiere validacion legal.");
+  }
+
+  if (suggestedSeverity === "HIGH") {
+    notes.push("Caso de alta severidad: escalar con asesoria juridica.");
+  }
+
+  return {
+    suggestedSeverity,
+    suggestedCaseType,
+    suggestedRoute,
+    recommendedTemplates,
+    notes,
+  };
+}
+
+export function buildEscalationProgress(logs: Array<{ routeStepKey: string; completedAt: Date | null; notes: string }>): EscalationStepProgress[] {
+  const logMap = new Map(logs.map((item) => [item.routeStepKey, item]));
+
+  return ESCALATION_ROUTE_CATALOG.map((step) => {
+    const current = logMap.get(step.key);
+    const dependsOn = step.dependsOn ? logMap.get(step.dependsOn) : null;
+
+    return {
+      ...step,
+      completedAt: current?.completedAt ? current.completedAt.toISOString() : null,
+      notes: current?.notes ?? "",
+      isBlocked: Boolean(step.dependsOn && !dependsOn?.completedAt),
+    };
+  });
+}
diff --git a/src/lib/legal/server.ts b/src/lib/legal/server.ts
new file mode 100644
index 0000000..72709a8
--- /dev/null
+++ b/src/lib/legal/server.ts
@@ -0,0 +1,150 @@
+import "server-only";
+
+import type { Prisma } from "@prisma/client";
+import { prisma } from "@/lib/prisma";
+import { buildEscalationProgress } from "@/lib/legal/diagnosis";
+import type {
+  LegalCaseView,
+  LegalDirectoryEntityView,
+  LegalDirectoryFilters,
+  LegalKpiSnapshot,
+} from "@/lib/legal/types";
+
+function toNumber(value: Prisma.Decimal | number | string | null | undefined) {
+  if (value === null || value === undefined) {
+    return null;
+  }
+
+  const numeric = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(numeric) ? Number(numeric) : null;
+}
+
+function mapCase(row: {
+  id: string;
+  contractId: string | null;
+  caseType: "CONTRACT_BREACH" | "PAYMENT_RETENTION" | "UNJUST_SANCTION" | "CONTRACT_DISPUTE";
+  severity: "LOW" | "MEDIUM" | "HIGH";
+  counterparty: string;
+  description: string;
+  amountAtRisk: Prisma.Decimal | null;
+  status: "OPEN" | "IN_PROGRESS" | "ESCALATED" | "RESOLVED" | "CLOSED";
+  openedAt: Date;
+  resolvedAt: Date | null;
+  createdAt: Date;
+  updatedAt: Date;
+}): LegalCaseView {
+  return {
+    id: row.id,
+    contractId: row.contractId,
+    caseType: row.caseType,
+    severity: row.severity,
+    counterparty: row.counterparty,
+    description: row.description,
+    amountAtRisk: toNumber(row.amountAtRisk),
+    status: row.status,
+    openedAt: row.openedAt.toISOString(),
+    resolvedAt: row.resolvedAt ? row.resolvedAt.toISOString() : null,
+    createdAt: row.createdAt.toISOString(),
+    updatedAt: row.updatedAt.toISOString(),
+  };
+}
+
+export async function listLegalCasesForUser(userId: string) {
+  const rows = await prisma.legalCase.findMany({
+    where: { userId },
+    orderBy: [{ updatedAt: "desc" }],
+    take: 200,
+  });
+
+  return rows.map((row) => mapCase(row));
+}
+
+export function computeLegalKpis(cases: LegalCaseView[]): LegalKpiSnapshot {
+  let amountAtRisk = 0;
+
+  for (const item of cases) {
+    if (item.amountAtRisk) {
+      amountAtRisk += item.amountAtRisk;
+    }
+  }
+
+  return {
+    openCases: cases.filter((item) => item.status === "OPEN" || item.status === "IN_PROGRESS" || item.status === "ESCALATED").length,
+    highSeverityCases: cases.filter((item) => item.severity === "HIGH" && item.status !== "CLOSED" && item.status !== "RESOLVED").length,
+    amountAtRisk: Number(amountAtRisk.toFixed(2)),
+    resolvedCases: cases.filter((item) => item.status === "RESOLVED" || item.status === "CLOSED").length,
+  };
+}
+
+export async function getLegalKpisForUser(userId: string) {
+  const cases = await listLegalCasesForUser(userId);
+  return computeLegalKpis(cases);
+}
+
+export async function getEscalationForCase(userId: string, caseId: string) {
+  const legalCase = await prisma.legalCase.findFirst({
+    where: {
+      id: caseId,
+      userId,
+    },
+    select: {
+      id: true,
+      escalationLogs: {
+        orderBy: [{ updatedAt: "desc" }],
+        select: {
+          routeStepKey: true,
+          completedAt: true,
+          notes: true,
+        },
+      },
+    },
+  });
+
+  if (!legalCase) {
+    return null;
+  }
+
+  return {
+    caseId: legalCase.id,
+    steps: buildEscalationProgress(legalCase.escalationLogs),
+  };
+}
+
+export async function listLegalDirectory(filters: LegalDirectoryFilters = {}): Promise<LegalDirectoryEntityView[]> {
+  const where: Prisma.LegalDirectoryEntityWhereInput = {
+    isActive: true,
+  };
+
+  if (filters.jurisdictionLevel) {
+    where.jurisdictionLevel = filters.jurisdictionLevel;
+  }
+
+  if (filters.stateCode) {
+    where.stateCode = filters.stateCode.toUpperCase();
+  }
+
+  if (filters.q) {
+    where.OR = [
+      { name: { contains: filters.q, mode: "insensitive" } },
+      { websiteUrl: { contains: filters.q, mode: "insensitive" } },
+    ];
+  }
+
+  const rows = await prisma.legalDirectoryEntity.findMany({
+    where,
+    orderBy: [{ jurisdictionLevel: "asc" }, { name: "asc" }],
+    take: 400,
+  });
+
+  return rows.map((row) => ({
+    id: row.id,
+    jurisdictionLevel: row.jurisdictionLevel,
+    name: row.name,
+    scopeTags: Array.isArray(row.scopeTagsJson) ? row.scopeTagsJson.filter((item): item is string => typeof item === "string") : [],
+    websiteUrl: row.websiteUrl,
+    phone: row.phone,
+    email: row.email,
+    stateCode: row.stateCode,
+    municipalityCode: row.municipalityCode,
+  }));
+}
diff --git a/src/lib/legal/types.ts b/src/lib/legal/types.ts
new file mode 100644
index 0000000..5cff5d1
--- /dev/null
+++ b/src/lib/legal/types.ts
@@ -0,0 +1,175 @@
+import type { ContractStatus, LegalCaseSeverity, LegalCaseStatus, LegalCaseType, LegalJurisdictionLevel } from "@prisma/client";
+import { z } from "zod";
+
+export type LegalKpiSnapshot = {
+  openCases: number;
+  highSeverityCases: number;
+  amountAtRisk: number;
+  resolvedCases: number;
+};
+
+export type LegalCaseView = {
+  id: string;
+  contractId: string | null;
+  caseType: LegalCaseType;
+  severity: LegalCaseSeverity;
+  counterparty: string;
+  description: string;
+  amountAtRisk: number | null;
+  status: LegalCaseStatus;
+  openedAt: string;
+  resolvedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type LegalContractOptionView = {
+  id: string;
+  title: string;
+  contractNumber: string | null;
+  counterpartyEntity: string;
+  status: ContractStatus;
+};
+
+export type DiagnosisAnswers = {
+  breachType: "contract_breach" | "payment_retention" | "unjust_sanction" | "contract_dispute" | null;
+  processStage: "none" | "informal_notice" | "formal_notice" | "ongoing_claim" | "trial" | null;
+  evidenceLevel: "none" | "basic" | "solid" | "robust" | null;
+  urgency: "low" | "medium" | "high" | null;
+  objective: "payment" | "correction" | "challenge" | "mediation" | null;
+  amountAtRisk: number | null;
+};
+
+export type DiagnosisRecommendation = {
+  suggestedSeverity: LegalCaseSeverity;
+  suggestedCaseType: LegalCaseType;
+  suggestedRoute: EscalationRouteStep[];
+  recommendedTemplates: LegalTemplateKey[];
+  notes: string[];
+};
+
+export type EscalationRouteStep = {
+  key: "formal_requirement" | "administrative_conciliation" | "oic_complaint" | "sfp_or_state_challenge" | "jurisdictional_path";
+  title: string;
+  estimatedWindow: string;
+  checklist: string[];
+  requiresLawyer: boolean;
+  dependsOn: string | null;
+};
+
+export type EscalationStepProgress = EscalationRouteStep & {
+  completedAt: string | null;
+  notes: string;
+  isBlocked: boolean;
+};
+
+export type LegalTemplateKey =
+  | "general_delivery_record"
+  | "breach_disagreement_letter"
+  | "payment_release_request"
+  | "sanctions_challenge_resource";
+
+export type LegalTemplateView = {
+  key: LegalTemplateKey;
+  category: "general" | "breach" | "payment" | "sanctions";
+  title: string;
+  body: string;
+};
+
+export type LegalDirectoryEntityView = {
+  id: string;
+  jurisdictionLevel: LegalJurisdictionLevel;
+  name: string;
+  scopeTags: string[];
+  websiteUrl: string | null;
+  phone: string | null;
+  email: string | null;
+  stateCode: string | null;
+  municipalityCode: string | null;
+};
+
+export type LegalDocumentGenerationInput = {
+  legalCaseId: string | null;
+  caseType: LegalCaseType;
+  severity: LegalCaseSeverity;
+  templateKey: LegalTemplateKey | null;
+  counterparty: string;
+  companyName: string;
+  amountAtRisk: number | null;
+  description: string;
+  objective: string;
+};
+
+export type LegalDocumentGenerationOutput = {
+  title: string;
+  content: string;
+  engine: "openai_json_object" | "template_fallback";
+  model: string | null;
+  warnings: string[];
+  usage:
+    | {
+        promptTokens: number | null;
+        completionTokens: number | null;
+        totalTokens: number | null;
+      }
+    | null;
+};
+
+export const LegalCaseCreateInputSchema = z.object({
+  contractId: z.string().trim().min(1).optional().nullable(),
+  caseType: z.enum(["CONTRACT_BREACH", "PAYMENT_RETENTION", "UNJUST_SANCTION", "CONTRACT_DISPUTE"]),
+  severity: z.enum(["LOW", "MEDIUM", "HIGH"]).default("MEDIUM"),
+  counterparty: z.string().trim().min(2).max(220),
+  description: z.string().trim().min(10).max(8000),
+  amountAtRisk: z.number().finite().nonnegative().optional().nullable(),
+  status: z.enum(["OPEN", "IN_PROGRESS", "ESCALATED", "RESOLVED", "CLOSED"]).optional(),
+});
+
+export const LegalCaseUpdateInputSchema = z.object({
+  severity: z.enum(["LOW", "MEDIUM", "HIGH"]).optional(),
+  status: z.enum(["OPEN", "IN_PROGRESS", "ESCALATED", "RESOLVED", "CLOSED"]).optional(),
+  resolvedAt: z.string().datetime().optional().nullable(),
+  description: z.string().trim().max(8000).optional(),
+  amountAtRisk: z.number().finite().nonnegative().optional().nullable(),
+  counterparty: z.string().trim().min(2).max(220).optional(),
+});
+
+export const LegalDiagnosisStartInputSchema = z.object({
+  contractId: z.string().trim().min(1).optional().nullable(),
+});
+
+export const LegalDiagnosisAnswerInputSchema = z.object({
+  diagnosisId: z.string().trim().min(1),
+  stepIndex: z.number().int().min(1).max(4),
+  answers: z.record(z.string(), z.unknown()),
+  finalize: z.boolean().optional(),
+});
+
+export const LegalDirectoryFiltersSchema = z.object({
+  jurisdictionLevel: z.enum(["FEDERAL", "STATE", "MUNICIPAL"]).optional(),
+  stateCode: z.string().trim().max(12).optional(),
+  q: z.string().trim().max(120).optional(),
+});
+
+export const LegalDocumentGenerateInputSchema = z.object({
+  legalCaseId: z.string().trim().min(1).optional().nullable(),
+  caseType: z.enum(["CONTRACT_BREACH", "PAYMENT_RETENTION", "UNJUST_SANCTION", "CONTRACT_DISPUTE"]),
+  severity: z.enum(["LOW", "MEDIUM", "HIGH"]),
+  templateKey: z
+    .enum(["general_delivery_record", "breach_disagreement_letter", "payment_release_request", "sanctions_challenge_resource"])
+    .optional()
+    .nullable(),
+  counterparty: z.string().trim().min(2).max(220),
+  companyName: z.string().trim().min(2).max(220),
+  amountAtRisk: z.number().finite().nonnegative().optional().nullable(),
+  description: z.string().trim().min(10).max(8000),
+  objective: z.string().trim().min(2).max(600),
+  title: z.string().trim().max(220).optional().nullable(),
+});
+
+export type LegalCaseCreateInput = z.infer<typeof LegalCaseCreateInputSchema>;
+export type LegalCaseUpdateInput = z.infer<typeof LegalCaseUpdateInputSchema>;
+export type LegalDiagnosisStartInput = z.infer<typeof LegalDiagnosisStartInputSchema>;
+export type LegalDiagnosisAnswerInput = z.infer<typeof LegalDiagnosisAnswerInputSchema>;
+export type LegalDirectoryFilters = z.infer<typeof LegalDirectoryFiltersSchema>;
+export type LegalDocumentGenerateInput = z.infer<typeof LegalDocumentGenerateInputSchema>;
diff --git a/src/lib/licitations/__tests__/documents-bundle.test.ts b/src/lib/licitations/__tests__/documents-bundle.test.ts
new file mode 100644
index 0000000..4447169
--- /dev/null
+++ b/src/lib/licitations/__tests__/documents-bundle.test.ts
@@ -0,0 +1,43 @@
+import { describe, expect, it } from "vitest";
+import { inferLicitationBundleDocumentKind, rankLicitationDocumentsForBundle } from "@/lib/licitations/documents";
+
+describe("licitation document bundle ranking", () => {
+  it("classifies common naming patterns for Bases/Convocatoria/Anexos", () => {
+    expect(
+      inferLicitationBundleDocumentKind({
+        name: "Bases de Licitacion 2026",
+        type: "application/pdf",
+        url: "https://example.com/bases.pdf",
+      }),
+    ).toBe("BASES_LICITACION");
+
+    expect(
+      inferLicitationBundleDocumentKind({
+        name: "Convocatoria publica",
+        type: "application/pdf",
+        url: "https://example.com/convocatoria.pdf",
+      }),
+    ).toBe("CONVOCATORIA");
+
+    expect(
+      inferLicitationBundleDocumentKind({
+        name: "Anexo tecnico 1",
+        type: "application/pdf",
+        url: "https://example.com/anexo.pdf",
+      }),
+    ).toBe("ANEXOS");
+  });
+
+  it("returns best candidate per bundle kind", () => {
+    const ranked = rankLicitationDocumentsForBundle([
+      { name: "Bases de Licitacion", type: "application/pdf", url: "https://example.com/bases.pdf" },
+      { name: "Convocatoria", type: "application/pdf", url: "https://example.com/convocatoria.pdf" },
+      { name: "Anexo Tecnico", type: "application/pdf", url: "https://example.com/anexo.pdf" },
+      { name: "Acta de fallo", type: "application/pdf", url: "https://example.com/fallo.pdf" },
+    ]);
+
+    expect(ranked.bases[0]?.url).toContain("bases.pdf");
+    expect(ranked.convocatoria[0]?.url).toContain("convocatoria.pdf");
+    expect(ranked.anexos[0]?.url).toContain("anexo.pdf");
+  });
+});
diff --git a/src/lib/licitations/__tests__/licitaya-state.test.ts b/src/lib/licitations/__tests__/licitaya-state.test.ts
new file mode 100644
index 0000000..a681ca8
--- /dev/null
+++ b/src/lib/licitations/__tests__/licitaya-state.test.ts
@@ -0,0 +1,14 @@
+import { describe, expect, it } from "vitest";
+import { resolveLicitayaState } from "@/lib/licitations/licitaya-state";
+
+describe("resolveLicitayaState", () => {
+  it("maps LicitaYa state tokens to internal state codes", () => {
+    expect(resolveLicitayaState("NLE")).toMatchObject({ stateCode: "19" });
+    expect(resolveLicitayaState("cdmx")).toMatchObject({ stateCode: "9" });
+  });
+
+  it("returns null for unknown tokens", () => {
+    expect(resolveLicitayaState("XX")).toBeNull();
+    expect(resolveLicitayaState(null)).toBeNull();
+  });
+});
diff --git a/src/lib/licitations/__tests__/module3.test.ts b/src/lib/licitations/__tests__/module3.test.ts
new file mode 100644
index 0000000..eed354a
--- /dev/null
+++ b/src/lib/licitations/__tests__/module3.test.ts
@@ -0,0 +1,29 @@
+import { describe, expect, it } from "vitest";
+import { computeModule3Summary, getViabilityLevel } from "@/lib/licitations/module3";
+
+describe("module3 helpers", () => {
+  it("classifies viability levels by score threshold", () => {
+    expect(getViabilityLevel(80)).toBe("alta");
+    expect(getViabilityLevel(55)).toBe("media");
+    expect(getViabilityLevel(10)).toBe("baja");
+  });
+
+  it("computes summary KPIs including recent opportunities", () => {
+    const now = new Date("2026-03-21T12:00:00.000Z");
+    const summary = computeModule3Summary(
+      9,
+      [
+        { id: "a", score: 80, publishDate: "2026-03-20T09:00:00.000Z" },
+        { id: "b", score: 55, publishDate: "2026-03-10T09:00:00.000Z" },
+        { id: "c", score: 20, publishDate: "2026-03-21T09:00:00.000Z" },
+      ],
+      now,
+    );
+
+    expect(summary.opportunities).toBe(9);
+    expect(summary.highViability).toBe(1);
+    expect(summary.mediumViability).toBe(1);
+    expect(summary.averageCompatibility).toBe(52);
+    expect(summary.newToReview).toBe(2);
+  });
+});
diff --git a/src/lib/licitations/__tests__/sync-status.test.ts b/src/lib/licitations/__tests__/sync-status.test.ts
new file mode 100644
index 0000000..f92c214
--- /dev/null
+++ b/src/lib/licitations/__tests__/sync-status.test.ts
@@ -0,0 +1,38 @@
+import { SyncRunStatus } from "@prisma/client";
+import { describe, expect, it } from "vitest";
+import { resolveSyncStatus } from "@/lib/licitations/sync-status";
+import type { SyncStats } from "@/lib/licitations/types";
+
+function makeStats(overrides?: Partial<SyncStats>): SyncStats {
+  return {
+    totalFetched: 0,
+    inserted: 0,
+    updated: 0,
+    skipped: 0,
+    errors: 0,
+    latestPublishDate: null,
+    ...overrides,
+  };
+}
+
+describe("resolveSyncStatus", () => {
+  it("returns success when there are no errors and no blocking warnings", () => {
+    const status = resolveSyncStatus(makeStats({ totalFetched: 4, inserted: 2, updated: 1 }), []);
+    expect(status).toBe(SyncRunStatus.SUCCESS);
+  });
+
+  it("returns partial when no records were fetched and warnings exist", () => {
+    const status = resolveSyncStatus(makeStats({ totalFetched: 0 }), ["anti-bot challenge"]);
+    expect(status).toBe(SyncRunStatus.PARTIAL);
+  });
+
+  it("returns failed when there are errors and no persisted records", () => {
+    const status = resolveSyncStatus(makeStats({ errors: 2, inserted: 0, updated: 0 }), []);
+    expect(status).toBe(SyncRunStatus.FAILED);
+  });
+
+  it("returns partial when there are errors but some records were persisted", () => {
+    const status = resolveSyncStatus(makeStats({ errors: 1, inserted: 3, updated: 0 }), []);
+    expect(status).toBe(SyncRunStatus.PARTIAL);
+  });
+});
diff --git a/src/lib/licitations/ai-recommendations.ts b/src/lib/licitations/ai-recommendations.ts
new file mode 100644
index 0000000..e4333fe
--- /dev/null
+++ b/src/lib/licitations/ai-recommendations.ts
@@ -0,0 +1,208 @@
+import "server-only";
+
+import { z } from "zod";
+import { callOpenAiJsonSchema } from "@/lib/ai/openai";
+import { storeAiSuggestionFromEnvelope } from "@/lib/ai/suggestions";
+import { getLicitationRecommendationsForUser } from "@/lib/licitations/recommendations";
+import type { RecommendationResultItem } from "@/lib/licitations/types";
+
+const M3_PROMPT_VERSION = "m3_ai_rerank_v1";
+const DEFAULT_TOP_RERANK = 12;
+const MAX_TOP_RERANK = 25;
+
+const M3EvaluationSchema = z.object({
+  id: z.string().min(1),
+  aiScore: z.number().min(0).max(100),
+  aiReasons: z.array(z.string().min(5).max(320)).max(5),
+  aiRisks: z.array(z.string().min(5).max(320)).max(5),
+  nextStep: z.string().min(8).max(300),
+  confidence: z.number().min(0).max(1).optional(),
+});
+
+const M3AiResponseSchema = z.object({
+  evaluations: z.array(M3EvaluationSchema).max(MAX_TOP_RERANK),
+  confidence: z.enum(["low", "medium", "high"]).optional(),
+});
+
+const M3AiJsonSchema = {
+  type: "object",
+  additionalProperties: false,
+  required: ["evaluations"],
+  properties: {
+    evaluations: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["id", "aiScore", "aiReasons", "aiRisks", "nextStep"],
+        properties: {
+          id: { type: "string" },
+          aiScore: { type: "number", minimum: 0, maximum: 100 },
+          aiReasons: {
+            type: "array",
+            items: { type: "string" },
+          },
+          aiRisks: {
+            type: "array",
+            items: { type: "string" },
+          },
+          nextStep: { type: "string" },
+          confidence: { type: "number", minimum: 0, maximum: 1 },
+        },
+      },
+    },
+    confidence: { type: "string", enum: ["low", "medium", "high"] },
+  },
+} as const;
+
+export type AiRecommendationResultItem = RecommendationResultItem & {
+  deterministicScore: number;
+  aiScore: number;
+  blendedScore: number;
+  aiReasons: string[];
+  aiRisks: string[];
+  nextStep: string;
+  suggestionId: string | null;
+};
+
+export async function getAiEnhancedLicitationRecommendationsForUser(
+  userId: string,
+  options?: {
+    profileId?: string | null;
+    top?: number;
+  },
+) {
+  const deterministic = await getLicitationRecommendationsForUser(userId, options?.profileId);
+  const requestedTop = Number.isFinite(options?.top) ? Number(options?.top) : DEFAULT_TOP_RERANK;
+  const rerankTop = Math.max(1, Math.min(MAX_TOP_RERANK, Math.floor(requestedTop)));
+
+  if (deterministic.results.length === 0) {
+    return {
+      profileId: deterministic.profileId,
+      results: [] as AiRecommendationResultItem[],
+      meta: {
+        engine: "empty_assist",
+        model: null,
+        usage: null,
+        warnings: [{ code: "no_candidates", message: "No existen licitaciones candidatas para evaluar." }],
+        confidence: null,
+      },
+    };
+  }
+
+  const topCandidates = deterministic.results.slice(0, rerankTop);
+  const remainingCandidates = deterministic.results.slice(rerankTop);
+
+  const systemPrompt = [
+    "Eres un analista senior de licitaciones publicas en Mexico.",
+    "Tu tarea es re-evaluar licitaciones ya pre-rankeadas de forma determinista.",
+    "No inventes datos externos y responde solo JSON valido en espanol.",
+    "aiScore representa ajuste semantico de ajuste estrategico (0 a 100).",
+  ].join(" ");
+
+  const userPrompt = [
+    "Empresa y ranking determinista previo:",
+    JSON.stringify({
+      profileId: deterministic.profileId,
+      candidates: topCandidates.map((item) => ({
+        id: item.id,
+        deterministicScore: item.score,
+        title: item.title,
+        description: item.description,
+        amount: item.amount,
+        procedureType: item.procedureType,
+        category: item.category,
+        municipalityName: item.municipalityName,
+        stateName: item.stateName,
+        source: item.source,
+      })),
+    }),
+    "",
+    "Para cada id devuelve:",
+    "- aiScore: 0-100.",
+    "- aiReasons: 1 a 3 razones concretas.",
+    "- aiRisks: 0 a 3 riesgos relevantes para decidir interes.",
+    "- nextStep: siguiente accion recomendada para el equipo comercial.",
+  ].join("\n");
+
+  const envelope = await callOpenAiJsonSchema({
+    promptVersion: M3_PROMPT_VERSION,
+    systemPrompt,
+    userPrompt,
+    outputSchema: M3AiResponseSchema,
+    schemaName: "m3_licitation_rerank",
+    jsonSchema: M3AiJsonSchema as unknown as Record<string, unknown>,
+    model: process.env.OPENAI_M3_MODEL?.trim() || undefined,
+  });
+
+  const evaluations = envelope.data?.evaluations ?? [];
+  const evaluationById = new Map(evaluations.map((item) => [item.id, item]));
+
+  const enhancedTop = await Promise.all(
+    topCandidates.map(async (candidate) => {
+      const evaluation = evaluationById.get(candidate.id);
+      const aiScore = evaluation ? Math.max(0, Math.min(100, Math.round(evaluation.aiScore))) : candidate.score;
+      const blendedScore = Math.round(candidate.score * 0.7 + aiScore * 0.3);
+      const aiReasons = evaluation?.aiReasons ?? [];
+      const aiRisks = evaluation?.aiRisks ?? [];
+      const nextStep = evaluation?.nextStep ?? "Validar terminos y preparar analisis normativo en Modulo 4.";
+
+      const persisted = await storeAiSuggestionFromEnvelope({
+        userId,
+        moduleKey: "M3",
+        featureKey: "licitation_rerank",
+        subjectType: "licitation",
+        subjectId: candidate.id,
+        inputForHash: {
+          profileId: deterministic.profileId,
+          candidate,
+        },
+        envelope,
+        responsePayload: {
+          id: candidate.id,
+          deterministicScore: candidate.score,
+          aiScore,
+          blendedScore,
+          aiReasons,
+          aiRisks,
+          nextStep,
+        },
+      });
+
+      return {
+        ...candidate,
+        deterministicScore: candidate.score,
+        aiScore,
+        blendedScore,
+        aiReasons,
+        aiRisks,
+        nextStep,
+        suggestionId: persisted.suggestionId,
+      } satisfies AiRecommendationResultItem;
+    }),
+  );
+
+  const rerankedTop = [...enhancedTop].sort((left, right) => right.blendedScore - left.blendedScore);
+  const passthrough = remainingCandidates.map((candidate) => ({
+    ...candidate,
+    deterministicScore: candidate.score,
+    aiScore: candidate.score,
+    blendedScore: candidate.score,
+    aiReasons: [] as string[],
+    aiRisks: [] as string[],
+    nextStep: "Completa el perfil para mejorar el analisis de ajuste en futuras recomendaciones.",
+    suggestionId: null,
+  }));
+
+  return {
+    profileId: deterministic.profileId,
+    results: [...rerankedTop, ...passthrough],
+    meta: {
+      engine: envelope.engine,
+      model: envelope.model,
+      usage: envelope.usage,
+      warnings: envelope.warnings,
+      confidence: envelope.confidence,
+    },
+  };
+}
diff --git a/src/lib/licitations/config.ts b/src/lib/licitations/config.ts
index 2c000cb..8316522 100644
--- a/src/lib/licitations/config.ts
+++ b/src/lib/licitations/config.ts
@@ -35,4 +35,12 @@ export const licitationsConfig = {
   maxMunicipalitiesPerRun: parseInteger(process.env.LICITATIONS_MAX_MUNICIPALITIES_PER_RUN, 100),
   scrapingEnabledByDefault: parseBoolean(process.env.LICITATIONS_SCRAPING_ENABLED, true),
   syncCronToken: process.env.LICITATIONS_SYNC_TOKEN ?? "",
+  licitayaEnabled: parseBoolean(process.env.LICITAYA_ENABLED, true),
+  licitayaItemsPerPage: parseInteger(process.env.LICITAYA_ITEMS_PER_PAGE, 50),
+  licitayaMaxPagesPerRun: parseInteger(process.env.LICITAYA_MAX_PAGES_PER_RUN, 3),
+  licitayaSyncIntervalHours: parseInteger(process.env.LICITAYA_SYNC_INTERVAL_HOURS, 12),
+  licitayaDateOffsetDays: parseInteger(process.env.LICITAYA_DATE_OFFSET_DAYS, 1),
+  licitayaDateFallbackWindowDays: parseInteger(process.env.LICITAYA_DATE_FALLBACK_WINDOW_DAYS, 3),
+  licitayaTimeoutMs: parseInteger(process.env.LICITAYA_TIMEOUT_MS, 20000),
+  cronSecret: process.env.CRON_SECRET ?? "",
 };
diff --git a/src/lib/licitations/connectors/licitaya.ts b/src/lib/licitations/connectors/licitaya.ts
new file mode 100644
index 0000000..a80978b
--- /dev/null
+++ b/src/lib/licitations/connectors/licitaya.ts
@@ -0,0 +1,397 @@
+import "server-only";
+
+import { request as httpsRequest } from "node:https";
+import { LicitationSource } from "@prisma/client";
+import { licitationsConfig } from "@/lib/licitations/config";
+import { mapCategory, mapProcedureType, parseDateMaybe, pickFirstText, sanitizeDocuments } from "@/lib/licitations/normalize";
+import type { ConnectorResult, NormalizedDocument, NormalizedLicitationInput } from "@/lib/licitations/types";
+import { delay, normalizeUrl, withRetries } from "@/lib/licitations/utils";
+
+const DEFAULT_BASE_URL = "https://www.licitaya.com.mx/api/v1";
+
+function toText(value: unknown) {
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  }
+
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+
+  return null;
+}
+
+function formatDateForQuery(date: Date) {
+  const year = String(date.getUTCFullYear());
+  const month = String(date.getUTCMonth() + 1).padStart(2, "0");
+  const day = String(date.getUTCDate()).padStart(2, "0");
+  return `${year}${month}${day}`;
+}
+
+function buildDocument(name: string, value: unknown, baseUrl: string): NormalizedDocument | null {
+  const rawUrl = toText(value);
+
+  if (!rawUrl) {
+    return null;
+  }
+
+  const normalizedUrl = normalizeUrl(rawUrl, baseUrl);
+
+  if (!normalizedUrl) {
+    return null;
+  }
+
+  return {
+    name,
+    url: normalizedUrl,
+  };
+}
+
+function mapLicitayaRecord(record: Record<string, unknown>, requestUrl: string): NormalizedLicitationInput | null {
+  const tenderId = toText(record.tenderId);
+  const title = pickFirstText([toText(record.tender_object), toText(record.expanded_search), tenderId ? `Licitacion ${tenderId}` : null]);
+
+  if (!tenderId || !title) {
+    return null;
+  }
+
+  const lotObjects = Array.isArray(record.lots)
+    ? record.lots
+        .map((lot) => (lot && typeof lot === "object" ? toText((lot as Record<string, unknown>).lot_object) : null))
+        .filter((entry): entry is string => Boolean(entry))
+        .slice(0, 8)
+    : [];
+
+  const description = pickFirstText([toText(record.expanded_search), toText(record.extra_info), lotObjects.join(" | "), null]) || null;
+  const publishDate = parseDateMaybe(toText(record.catalog_date));
+  const closingDate = parseDateMaybe(toText(record.close_date));
+  const stateToken = toText(record.state);
+  const documents = sanitizeDocuments(
+    [
+      buildDocument("Ficha LicitaYa", record.url, requestUrl),
+      buildDocument("Fuente alterna", record.url2, requestUrl),
+    ].filter((entry): entry is NormalizedDocument => entry !== null),
+  );
+
+  return {
+    sourceRecordId: tenderId,
+    tenderCode: pickFirstText([toText(record.number), toText(record.number2), toText(record.reference), toText(record.process), null]) || null,
+    procedureType: mapProcedureType(toText(record.type)),
+    title,
+    description,
+    category: mapCategory(`${title} ${description ?? ""}`),
+    isOpen: closingDate ? closingDate >= new Date() : true,
+    publishDate,
+    closingDate,
+    supplierAwarded: toText(record.agency),
+    documents,
+    rawSourceUrl: requestUrl,
+    rawPayload: {
+      source: "licitaya",
+      licitayaState: stateToken,
+      licitayaCity: toText(record.city),
+      licitayaCountry: toText(record.country),
+      record,
+    },
+  };
+}
+
+function resolveRuntimeConfig() {
+  const apiKey = process.env.LICITAYA_API_KEY?.trim();
+
+  if (!apiKey) {
+    throw new Error("LICITAYA_API_KEY no esta configurada.");
+  }
+
+  const baseUrl = (process.env.LICITAYA_BASE_URL?.trim() || DEFAULT_BASE_URL).replace(/\/+$/, "");
+  return {
+    apiKey,
+    baseUrl,
+  };
+}
+
+function buildHeaders(apiKey: string) {
+  return {
+    "X-API-KEY": apiKey,
+    Accept: "application/json",
+    "User-Agent": process.env.LICITAYA_USER_AGENT?.trim() || "undici",
+    "Accept-Encoding": "identity",
+    "Cache-Control": "no-cache",
+    Pragma: "no-cache",
+  };
+}
+
+type TextResponse = {
+  status: number;
+  body: string;
+};
+
+async function requestText(url: URL, headers: Record<string, string>, timeoutMs: number, redirectCount = 0): Promise<TextResponse> {
+  return new Promise((resolve, reject) => {
+    const req = httpsRequest(
+      url,
+      {
+        method: "GET",
+        headers,
+      },
+      (response) => {
+        const status = response.statusCode ?? 0;
+        const locationHeader = response.headers.location;
+
+        if (locationHeader && [301, 302, 303, 307, 308].includes(status) && redirectCount < 3) {
+          const redirectedUrl = new URL(locationHeader, url);
+          requestText(redirectedUrl, headers, timeoutMs, redirectCount + 1).then(resolve).catch(reject);
+          response.resume();
+          return;
+        }
+
+        const chunks: Buffer[] = [];
+
+        response.on("data", (chunk) => {
+          chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        });
+
+        response.on("end", () => {
+          resolve({
+            status,
+            body: Buffer.concat(chunks).toString("utf8"),
+          });
+        });
+      },
+    );
+
+    req.on("error", reject);
+    req.setTimeout(timeoutMs, () => {
+      req.destroy(new Error(`Request timed out after ${timeoutMs} ms.`));
+    });
+    req.end();
+  });
+}
+
+function resolveTargetDate(offsetDays: number) {
+  const now = new Date();
+  now.setUTCDate(now.getUTCDate() - Math.max(0, offsetDays));
+  return now;
+}
+
+function parseJsonPayload(rawBody: string) {
+  const trimmed = rawBody.trim();
+
+  if (!trimmed) {
+    return null;
+  }
+
+  const sanitized = trimmed.startsWith("\uFEFF") ? trimmed.slice(1) : trimmed;
+
+  try {
+    return JSON.parse(sanitized) as Record<string, unknown>;
+  } catch {
+    return null;
+  }
+}
+
+export async function fetchLicitayaLicitations(): Promise<ConnectorResult> {
+  const runtime = resolveRuntimeConfig();
+  const itemsPerPage = Math.max(1, Math.min(100, licitationsConfig.licitayaItemsPerPage));
+  const maxPages = Math.max(1, licitationsConfig.licitayaMaxPagesPerRun);
+  const startOffset = Math.max(0, licitationsConfig.licitayaDateOffsetDays);
+  const fallbackWindow = Math.max(0, licitationsConfig.licitayaDateFallbackWindowDays);
+
+  const deduped = new Map<string, NormalizedLicitationInput>();
+  const warnings: string[] = [];
+  const emptyDates: string[] = [];
+  let rawSourceUrl: string | null = null;
+
+  for (let fallbackIndex = 0; fallbackIndex <= fallbackWindow; fallbackIndex += 1) {
+    const dateOffset = startOffset + fallbackIndex;
+    const targetDate = formatDateForQuery(resolveTargetDate(dateOffset));
+
+    let currentPage = 1;
+    let totalPages = 1;
+    let dateHadHardFailure = false;
+    let dateHadNotFound = false;
+
+    while (currentPage <= maxPages && currentPage <= totalPages) {
+      const requestUrl = new URL("tender/search", `${runtime.baseUrl}/`);
+      requestUrl.searchParams.set("date", targetDate);
+      requestUrl.searchParams.set("items", String(itemsPerPage));
+      requestUrl.searchParams.set("page", String(currentPage));
+      requestUrl.searchParams.set("order", "1");
+      rawSourceUrl = requestUrl.toString();
+
+      let response: TextResponse;
+
+      try {
+        response = await withRetries(
+          async () => requestText(requestUrl, buildHeaders(runtime.apiKey), licitationsConfig.licitayaTimeoutMs),
+          {
+            retries: licitationsConfig.maxRetries,
+            initialDelayMs: Math.max(250, Math.floor(licitationsConfig.requestDelayMs / 2)),
+            maxDelayMs: 5000,
+          },
+        );
+      } catch (error) {
+        const message = error instanceof Error ? error.message : "Error desconocido";
+        warnings.push(`Error consultando LicitaYa (${targetDate}, pagina ${currentPage}): ${message}`);
+        dateHadHardFailure = true;
+        break;
+      }
+
+      if (response.status === 404) {
+        dateHadNotFound = true;
+        break;
+      }
+
+      if (response.status < 200 || response.status >= 300) {
+        warnings.push(`LicitaYa devolvio ${response.status} para ${requestUrl.toString()}.`);
+        dateHadHardFailure = true;
+        break;
+      }
+
+      const rawBody = response.body;
+      const payload = parseJsonPayload(rawBody);
+
+      if (!payload) {
+        const bodyPreview = rawBody.trim().slice(0, 200);
+        warnings.push(`No se pudo parsear JSON de LicitaYa (${targetDate}, pagina ${currentPage}). Preview: ${bodyPreview || "(vacio)"}`);
+        dateHadHardFailure = true;
+        break;
+      }
+
+      const totalPagesCandidate = Number.parseInt(toText(payload.total_pages) ?? "", 10);
+
+      if (Number.isFinite(totalPagesCandidate) && totalPagesCandidate > 0) {
+        totalPages = totalPagesCandidate;
+      }
+
+      const pageResults = Array.isArray(payload.results) ? payload.results : [];
+
+      for (const row of pageResults) {
+        if (!row || typeof row !== "object") {
+          continue;
+        }
+
+        const mapped = mapLicitayaRecord(row as Record<string, unknown>, requestUrl.toString());
+
+        if (!mapped) {
+          continue;
+        }
+
+        const key = mapped.sourceRecordId ?? mapped.title;
+        deduped.set(key, mapped);
+      }
+
+      if (currentPage >= totalPages || currentPage >= maxPages) {
+        break;
+      }
+
+      currentPage += 1;
+      await delay(licitationsConfig.requestDelayMs);
+    }
+
+    if (deduped.size > 0) {
+      if (fallbackIndex > 0) {
+        warnings.push(`LicitaYa se sincronizo usando una fecha retroactiva (${targetDate}).`);
+      }
+
+      return {
+        source: LicitationSource.LICITAYA,
+        items: [...deduped.values()],
+        rawSourceUrl,
+        warnings,
+      };
+    }
+
+    if (dateHadNotFound) {
+      emptyDates.push(targetDate);
+      continue;
+    }
+
+    if (dateHadHardFailure) {
+      break;
+    }
+  }
+
+  const fallbackTenderIds = (process.env.LICITAYA_FALLBACK_TENDER_IDS ?? "SCRZJ")
+    .split(",")
+    .map((item) => item.trim())
+    .filter(Boolean)
+    .slice(0, 5);
+
+  for (const tenderId of fallbackTenderIds) {
+    const requestUrl = new URL(`tender/${encodeURIComponent(tenderId)}`, `${runtime.baseUrl}/`);
+    rawSourceUrl = requestUrl.toString();
+
+    let response: TextResponse;
+
+    try {
+      response = await withRetries(
+        async () => {
+            return await requestText(requestUrl, buildHeaders(runtime.apiKey), licitationsConfig.licitayaTimeoutMs);
+          },
+        {
+          retries: licitationsConfig.maxRetries,
+          initialDelayMs: Math.max(250, Math.floor(licitationsConfig.requestDelayMs / 2)),
+          maxDelayMs: 5000,
+        },
+      );
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Error desconocido";
+      warnings.push(`Error consultando fallback de LicitaYa (${tenderId}): ${message}`);
+      continue;
+    }
+
+    if (response.status < 200 || response.status >= 300) {
+      warnings.push(`Fallback de LicitaYa devolvio ${response.status} para tender ${tenderId}.`);
+      continue;
+    }
+
+    const rawBody = response.body;
+    const payload = parseJsonPayload(rawBody);
+
+    if (!payload) {
+      const bodyPreview = rawBody.trim().slice(0, 200);
+      warnings.push(`No se pudo parsear JSON del fallback de LicitaYa (${tenderId}). Preview: ${bodyPreview || "(vacio)"}`);
+      continue;
+    }
+
+    const resultObject = payload.results;
+
+    if (!resultObject || typeof resultObject !== "object") {
+      continue;
+    }
+
+    const mapped = mapLicitayaRecord(resultObject as Record<string, unknown>, requestUrl.toString());
+
+    if (!mapped) {
+      continue;
+    }
+
+    const key = mapped.sourceRecordId ?? mapped.title;
+    deduped.set(key, mapped);
+  }
+
+  if (deduped.size > 0) {
+    warnings.push("LicitaYa se sincronizo via fallback de tenderId.");
+    return {
+      source: LicitationSource.LICITAYA,
+      items: [...deduped.values()],
+      rawSourceUrl,
+      warnings,
+    };
+  }
+
+  if (emptyDates.length > 0) {
+    const firstDate = emptyDates[0];
+    const lastDate = emptyDates[emptyDates.length - 1];
+    warnings.push(`LicitaYa sin resultados para ${emptyDates.length} fechas consultadas (${firstDate} a ${lastDate}).`);
+  }
+
+  return {
+    source: LicitationSource.LICITAYA,
+    items: [],
+    rawSourceUrl,
+    warnings,
+  };
+}
diff --git a/src/lib/licitations/constants.ts b/src/lib/licitations/constants.ts
new file mode 100644
index 0000000..e874903
--- /dev/null
+++ b/src/lib/licitations/constants.ts
@@ -0,0 +1,2 @@
+export const LICITAYA_MUNICIPALITY_CODE = "LICITAYA";
+export const LICITAYA_FALLBACK_STATE_CODE = "00";
diff --git a/src/lib/licitations/documents.ts b/src/lib/licitations/documents.ts
new file mode 100644
index 0000000..40696f9
--- /dev/null
+++ b/src/lib/licitations/documents.ts
@@ -0,0 +1,263 @@
+export type LicitationDocumentLink = {
+  name: string;
+  url: string;
+  type: string | null;
+};
+
+export type LicitationBundleDocumentKind = "BASES_LICITACION" | "CONVOCATORIA" | "ANEXOS" | "OTRO";
+
+export type RankedLicitationBundleDocument = LicitationDocumentLink & {
+  bundleKind: LicitationBundleDocumentKind;
+  bundleScore: number;
+};
+
+export type LicitationDocumentBundleSelection = {
+  bases: RankedLicitationBundleDocument[];
+  convocatoria: RankedLicitationBundleDocument[];
+  anexos: RankedLicitationBundleDocument[];
+  extras: RankedLicitationBundleDocument[];
+};
+
+function normalizeText(value: unknown) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function normalizeSearchText(value: string) {
+  return value
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .toLowerCase();
+}
+
+function isHttpUrl(value: string) {
+  try {
+    const parsed = new URL(value);
+    return parsed.protocol === "http:" || parsed.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+
+function toSearchText(document: LicitationDocumentLink) {
+  return normalizeSearchText(`${document.name} ${document.type ?? ""} ${document.url}`);
+}
+
+export function inferLicitationBundleDocumentKind(document: LicitationDocumentLink): LicitationBundleDocumentKind {
+  const text = toSearchText(document);
+
+  if (/\bbase(s)?\b|\bpliego\b|\bterminos\b|\bespecificaciones\b/.test(text)) {
+    return "BASES_LICITACION";
+  }
+
+  if (/\bconvocatoria\b|\binvitacion\b|\bllamado\b/.test(text)) {
+    return "CONVOCATORIA";
+  }
+
+  if (/\banexo(s)?\b|\bapendice\b|\bformato(s)?\b/.test(text)) {
+    return "ANEXOS";
+  }
+
+  return "OTRO";
+}
+
+export function parseLicitationDocumentLinks(value: unknown): LicitationDocumentLink[] {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+
+  const seen = new Set<string>();
+  const output: LicitationDocumentLink[] = [];
+
+  for (const item of value) {
+    if (!item || typeof item !== "object") {
+      continue;
+    }
+
+    const record = item as Record<string, unknown>;
+    const name = normalizeText(record.name) || "Documento";
+    const url = normalizeText(record.url);
+    const type = normalizeText(record.type) || null;
+
+    if (!url || !isHttpUrl(url)) {
+      continue;
+    }
+
+    const signature = `${name.toLowerCase()}|${url}`;
+    if (seen.has(signature)) {
+      continue;
+    }
+
+    seen.add(signature);
+    output.push({ name, url, type });
+  }
+
+  return output;
+}
+
+export function isLikelyPdfUrl(value: string | null | undefined) {
+  const url = normalizeText(value);
+  if (!url) {
+    return false;
+  }
+
+  return /\.pdf(?:$|[?#])/i.test(url);
+}
+
+export function isPdfDocument(document: LicitationDocumentLink) {
+  if (isLikelyPdfUrl(document.url)) {
+    return true;
+  }
+
+  const lowerType = (document.type ?? "").toLowerCase();
+  if (lowerType.includes("pdf") || lowerType.includes("application/pdf")) {
+    return true;
+  }
+
+  const lowerName = document.name.toLowerCase();
+  return lowerName.endsWith(".pdf") || lowerName.includes("pdf");
+}
+
+function getPrimaryScore(document: LicitationDocumentLink) {
+  const text = toSearchText(document);
+  let score = 0;
+
+  if (isPdfDocument(document)) {
+    score += 400;
+  }
+
+  if (/\bbases?\b|\bconvocatoria\b|\blicitaci[oó]n\b|\bpliego\b|\bt[eé]rminos\b/.test(text)) {
+    score += 180;
+  }
+
+  if (/\banexo\b|\bformato\b|\bdocumento\b/.test(text)) {
+    score += 40;
+  }
+
+  if (/\bfallo\b|\badjudicaci[oó]n\b|\bresultado\b|\bacta\b|\baclaraci[oó]n\b/.test(text)) {
+    score -= 80;
+  }
+
+  if (/\.(zip|rar)(?:$|[?#])/i.test(document.url) || /\bzip\b|\brar\b/.test(text)) {
+    score -= 120;
+  }
+
+  return score;
+}
+
+function getBundleKindBoost(document: LicitationDocumentLink, kind: LicitationBundleDocumentKind) {
+  const text = toSearchText(document);
+
+  if (kind === "BASES_LICITACION") {
+    if (/\bbase(s)?\b|\bpliego\b|\bterminos\b/.test(text)) {
+      return 180;
+    }
+    if (/\bconvocatoria\b/.test(text)) {
+      return 35;
+    }
+    if (/\banexo(s)?\b/.test(text)) {
+      return -20;
+    }
+    return 0;
+  }
+
+  if (kind === "CONVOCATORIA") {
+    if (/\bconvocatoria\b|\binvitacion\b/.test(text)) {
+      return 180;
+    }
+    if (/\bbase(s)?\b/.test(text)) {
+      return -10;
+    }
+    if (/\banexo(s)?\b/.test(text)) {
+      return -20;
+    }
+    return 0;
+  }
+
+  if (kind === "ANEXOS") {
+    if (/\banexo(s)?\b|\bapendice\b/.test(text)) {
+      return 180;
+    }
+    if (/\bformato(s)?\b/.test(text)) {
+      return 90;
+    }
+    if (/\bbase(s)?\b/.test(text)) {
+      return -15;
+    }
+    return 0;
+  }
+
+  return 0;
+}
+
+function computeBundleScore(document: LicitationDocumentLink, kind: LicitationBundleDocumentKind) {
+  return getPrimaryScore(document) + getBundleKindBoost(document, kind);
+}
+
+function toRankedBundleDocument(document: LicitationDocumentLink, kind: LicitationBundleDocumentKind): RankedLicitationBundleDocument {
+  return {
+    ...document,
+    bundleKind: kind,
+    bundleScore: computeBundleScore(document, kind),
+  };
+}
+
+function dedupeBundleDocuments(documents: RankedLicitationBundleDocument[]) {
+  const seen = new Set<string>();
+  const deduped: RankedLicitationBundleDocument[] = [];
+
+  for (const document of documents) {
+    const signature = `${document.url}|${document.bundleKind}`;
+    if (seen.has(signature)) {
+      continue;
+    }
+    seen.add(signature);
+    deduped.push(document);
+  }
+
+  return deduped;
+}
+
+export function rankLicitationDocumentsForBundle(documents: LicitationDocumentLink[], maxPerKind = 1): LicitationDocumentBundleSelection {
+  const ranked = documents.map((document) => {
+    const inferredKind = inferLicitationBundleDocumentKind(document);
+    return toRankedBundleDocument(document, inferredKind);
+  });
+
+  const sortByScore = (left: RankedLicitationBundleDocument, right: RankedLicitationBundleDocument) => right.bundleScore - left.bundleScore;
+  const limit = Math.max(1, maxPerKind);
+
+  const bases = dedupeBundleDocuments(ranked.filter((item) => item.bundleKind === "BASES_LICITACION").sort(sortByScore)).slice(0, limit);
+  const convocatoria = dedupeBundleDocuments(ranked.filter((item) => item.bundleKind === "CONVOCATORIA").sort(sortByScore)).slice(0, limit);
+  const anexos = dedupeBundleDocuments(ranked.filter((item) => item.bundleKind === "ANEXOS").sort(sortByScore)).slice(0, limit);
+  const extras = dedupeBundleDocuments(
+    ranked
+      .filter((item) => item.bundleKind !== "BASES_LICITACION" && item.bundleKind !== "CONVOCATORIA" && item.bundleKind !== "ANEXOS")
+      .sort(sortByScore),
+  );
+
+  return {
+    bases,
+    convocatoria,
+    anexos,
+    extras,
+  };
+}
+
+export function pickPrimaryLicitationDocument(documents: LicitationDocumentLink[]) {
+  if (!documents.length) {
+    return null;
+  }
+
+  return [...documents]
+    .sort((left, right) => getPrimaryScore(right) - getPrimaryScore(left))
+    .at(0) ?? null;
+}
+
+export function pickPrimaryLicitationPdfDocument(documents: LicitationDocumentLink[]) {
+  const pdfDocuments = documents.filter((item) => isPdfDocument(item));
+  if (!pdfDocuments.length) {
+    return null;
+  }
+
+  return pickPrimaryLicitationDocument(pdfDocuments);
+}
diff --git a/src/lib/licitations/labels.ts b/src/lib/licitations/labels.ts
index 6323c50..67e2a6d 100644
--- a/src/lib/licitations/labels.ts
+++ b/src/lib/licitations/labels.ts
@@ -45,5 +45,9 @@ export function getSourceLabel(source: LicitationSource) {
     return "Plataforma Nacional de Transparencia";
   }
 
+  if (source === LicitationSource.LICITAYA) {
+    return "LicitaYa API";
+  }
+
   return "Portal municipal (respaldo)";
 }
diff --git a/src/lib/licitations/licitaya-state.ts b/src/lib/licitations/licitaya-state.ts
new file mode 100644
index 0000000..1fa156f
--- /dev/null
+++ b/src/lib/licitations/licitaya-state.ts
@@ -0,0 +1,63 @@
+type LicitayaStateInfo = {
+  stateCode: string;
+  stateName: string;
+};
+
+const LICITAYA_STATE_MAP: Record<string, LicitayaStateInfo> = {
+  AGS: { stateCode: "1", stateName: "Aguascalientes" },
+  BCN: { stateCode: "2", stateName: "Baja California" },
+  BCS: { stateCode: "3", stateName: "Baja California Sur" },
+  CAM: { stateCode: "4", stateName: "Campeche" },
+  CHP: { stateCode: "5", stateName: "Chiapas" },
+  CHH: { stateCode: "6", stateName: "Chihuahua" },
+  COA: { stateCode: "7", stateName: "Coahuila" },
+  COL: { stateCode: "8", stateName: "Colima" },
+  CMX: { stateCode: "9", stateName: "Ciudad de Mexico" },
+  CDMX: { stateCode: "9", stateName: "Ciudad de Mexico" },
+  DUR: { stateCode: "10", stateName: "Durango" },
+  GUA: { stateCode: "11", stateName: "Guanajuato" },
+  GRO: { stateCode: "12", stateName: "Guerrero" },
+  HID: { stateCode: "13", stateName: "Hidalgo" },
+  JAL: { stateCode: "14", stateName: "Jalisco" },
+  MEX: { stateCode: "15", stateName: "Estado de Mexico" },
+  MIC: { stateCode: "16", stateName: "Michoacan" },
+  MOR: { stateCode: "17", stateName: "Morelos" },
+  NAY: { stateCode: "18", stateName: "Nayarit" },
+  NLE: { stateCode: "19", stateName: "Nuevo Leon" },
+  OAX: { stateCode: "20", stateName: "Oaxaca" },
+  PUE: { stateCode: "21", stateName: "Puebla" },
+  QUE: { stateCode: "22", stateName: "Queretaro" },
+  ROO: { stateCode: "23", stateName: "Quintana Roo" },
+  SLP: { stateCode: "24", stateName: "San Luis Potosi" },
+  SIN: { stateCode: "25", stateName: "Sinaloa" },
+  SON: { stateCode: "26", stateName: "Sonora" },
+  TAB: { stateCode: "27", stateName: "Tabasco" },
+  TAM: { stateCode: "28", stateName: "Tamaulipas" },
+  TLA: { stateCode: "29", stateName: "Tlaxcala" },
+  VER: { stateCode: "30", stateName: "Veracruz" },
+  YUC: { stateCode: "31", stateName: "Yucatan" },
+  ZAC: { stateCode: "32", stateName: "Zacatecas" },
+};
+
+function normalizeStateToken(value: string | null | undefined) {
+  if (!value) {
+    return null;
+  }
+
+  const normalized = value
+    .toUpperCase()
+    .replace(/[^A-Z]/g, "")
+    .trim();
+
+  return normalized.length > 0 ? normalized : null;
+}
+
+export function resolveLicitayaState(value: string | null | undefined): LicitayaStateInfo | null {
+  const token = normalizeStateToken(value);
+
+  if (!token) {
+    return null;
+  }
+
+  return LICITAYA_STATE_MAP[token] ?? null;
+}
diff --git a/src/lib/licitations/module3.ts b/src/lib/licitations/module3.ts
new file mode 100644
index 0000000..05177fa
--- /dev/null
+++ b/src/lib/licitations/module3.ts
@@ -0,0 +1,62 @@
+export type ViabilityLevel = "alta" | "media" | "baja";
+
+export type RecommendationCardView = {
+  id: string;
+  score: number;
+  publishDate?: string | null;
+};
+
+export type Module3Summary = {
+  opportunities: number;
+  highViability: number;
+  mediumViability: number;
+  averageCompatibility: number;
+  newToReview: number;
+};
+
+export function getViabilityLevel(score: number): ViabilityLevel {
+  if (score >= 70) {
+    return "alta";
+  }
+
+  if (score >= 40) {
+    return "media";
+  }
+
+  return "baja";
+}
+
+export function computeModule3Summary(totalResults: number, recommendations: RecommendationCardView[], now = new Date()): Module3Summary {
+  const scores = recommendations
+    .map((item) => Number(item.score))
+    .filter((score) => Number.isFinite(score) && score >= 0)
+    .slice(0, 100);
+
+  const highViability = scores.filter((score) => getViabilityLevel(score) === "alta").length;
+  const mediumViability = scores.filter((score) => getViabilityLevel(score) === "media").length;
+  const averageCompatibility = scores.length ? Math.round(scores.reduce((sum, score) => sum + score, 0) / scores.length) : 0;
+
+  const recentThreshold = new Date(now);
+  recentThreshold.setDate(recentThreshold.getDate() - 7);
+
+  const newToReview = recommendations.filter((item) => {
+    if (!item.publishDate) {
+      return false;
+    }
+
+    const parsedDate = new Date(item.publishDate);
+    if (Number.isNaN(parsedDate.getTime())) {
+      return false;
+    }
+
+    return parsedDate >= recentThreshold;
+  }).length;
+
+  return {
+    opportunities: totalResults,
+    highViability,
+    mediumViability,
+    averageCompatibility,
+    newToReview,
+  };
+}
diff --git a/src/lib/licitations/preferences.ts b/src/lib/licitations/preferences.ts
new file mode 100644
index 0000000..f42770d
--- /dev/null
+++ b/src/lib/licitations/preferences.ts
@@ -0,0 +1,28 @@
+export const LICITATION_REVIEW_STATUSES = ["NEW", "REVIEWED", "INTERESTED", "DISCARDED"] as const;
+
+export type LicitationReviewStatusView = (typeof LICITATION_REVIEW_STATUSES)[number];
+
+export function parseLicitationReviewStatus(value: unknown): LicitationReviewStatusView | null {
+  if (typeof value !== "string") {
+    return null;
+  }
+
+  const normalized = value.trim().toUpperCase();
+  return LICITATION_REVIEW_STATUSES.find((status) => status === normalized) ?? null;
+}
+
+export function getLicitationReviewStatusLabel(status: LicitationReviewStatusView) {
+  if (status === "REVIEWED") {
+    return "Consultada";
+  }
+
+  if (status === "INTERESTED") {
+    return "Me interesa";
+  }
+
+  if (status === "DISCARDED") {
+    return "Descartada";
+  }
+
+  return "Nueva";
+}
diff --git a/src/lib/licitations/query.ts b/src/lib/licitations/query.ts
index 8217ac5..f7554d7 100644
--- a/src/lib/licitations/query.ts
+++ b/src/lib/licitations/query.ts
@@ -1,6 +1,7 @@
 import "server-only";
 
 import { LicitationProcedureType, type Prisma } from "@prisma/client";
+import { LICITAYA_MUNICIPALITY_CODE } from "@/lib/licitations/constants";
 import { prisma } from "@/lib/prisma";
 
 type LicitationQueryParams = {
@@ -53,6 +54,9 @@ export async function listMunicipalities(filters?: { state?: string | null }) {
   return prisma.municipality.findMany({
     where: {
       isActive: true,
+      municipalityCode: {
+        not: LICITAYA_MUNICIPALITY_CODE,
+      },
       ...(filters?.state ? { stateCode: filters.state } : {}),
     },
     orderBy: [{ stateName: "asc" }, { municipalityName: "asc" }],
diff --git a/src/lib/licitations/sync-status.ts b/src/lib/licitations/sync-status.ts
new file mode 100644
index 0000000..c561d18
--- /dev/null
+++ b/src/lib/licitations/sync-status.ts
@@ -0,0 +1,19 @@
+import { SyncRunStatus } from "@prisma/client";
+import type { SyncStats } from "@/lib/licitations/types";
+
+export function resolveSyncStatus(stats: SyncStats, warnings: string[] = []): SyncRunStatus {
+  if (stats.errors > 0) {
+    return stats.inserted > 0 || stats.updated > 0 ? SyncRunStatus.PARTIAL : SyncRunStatus.FAILED;
+  }
+
+  if (stats.totalFetched === 0 && warnings.length > 0) {
+    return SyncRunStatus.PARTIAL;
+  }
+
+  return SyncRunStatus.SUCCESS;
+}
+
+export function shouldAdvanceOpenSyncTimestamp(status: SyncRunStatus, stats: SyncStats) {
+  const hasMeaningfulProgress = stats.totalFetched > 0 || stats.inserted > 0 || stats.updated > 0;
+  return status !== SyncRunStatus.FAILED && hasMeaningfulProgress;
+}
diff --git a/src/lib/licitations/sync.ts b/src/lib/licitations/sync.ts
index 18f191c..768b994 100644
--- a/src/lib/licitations/sync.ts
+++ b/src/lib/licitations/sync.ts
@@ -1,10 +1,14 @@
 import "server-only";
 
-import { LicitationSource, Prisma, SyncRunStatus } from "@prisma/client";
+import { LicitationSource, MunicipalOpenPortalType, Prisma, SyncRunStatus } from "@prisma/client";
 import { licitationsConfig } from "@/lib/licitations/config";
+import { LICITAYA_FALLBACK_STATE_CODE, LICITAYA_MUNICIPALITY_CODE } from "@/lib/licitations/constants";
+import { fetchLicitayaLicitations } from "@/lib/licitations/connectors/licitaya";
+import { resolveLicitayaState } from "@/lib/licitations/licitaya-state";
 import { fetchMunicipalBackupLicitations, fetchMunicipalOpenLicitations } from "@/lib/licitations/connectors/municipal";
 import { fetchPntLicitations } from "@/lib/licitations/connectors/pnt";
 import { buildStableRecordId, sanitizeDocuments } from "@/lib/licitations/normalize";
+import { resolveSyncStatus, shouldAdvanceOpenSyncTimestamp } from "@/lib/licitations/sync-status";
 import { prisma } from "@/lib/prisma";
 import type { ConnectorResult, MunicipalityConnectorInput, SyncStats } from "@/lib/licitations/types";
 import { delay } from "@/lib/licitations/utils";
@@ -28,6 +32,20 @@ const MUNICIPALITY_SELECT = {
   isActive: true,
 } satisfies Prisma.MunicipalitySelect;
 
+type SourceResult = {
+  source: LicitationSource;
+  status: SyncRunStatus;
+  stats: SyncStats;
+  warnings: string[];
+};
+
+export type MunicipalitySyncResult = {
+  municipality: MunicipalityConnectorInput;
+  skipped: boolean;
+  reason: string | null;
+  sourceResults: SourceResult[];
+};
+
 function createEmptyStats(): SyncStats {
   return {
     totalFetched: 0,
@@ -169,18 +187,6 @@ async function upsertConnectorItems(municipality: MunicipalityConnectorInput, co
   return stats;
 }
 
-function resolveSyncStatus(stats: SyncStats): SyncRunStatus {
-  if (stats.errors === 0) {
-    return SyncRunStatus.SUCCESS;
-  }
-
-  if (stats.inserted > 0 || stats.updated > 0) {
-    return SyncRunStatus.PARTIAL;
-  }
-
-  return SyncRunStatus.FAILED;
-}
-
 async function runConnectorSync(municipality: MunicipalityConnectorInput, source: LicitationSource, connector: () => Promise<ConnectorResult>) {
   const syncRun = await prisma.syncRun.create({
     data: {
@@ -193,7 +199,7 @@ async function runConnectorSync(municipality: MunicipalityConnectorInput, source
   try {
     const connectorResult = await connector();
     const stats = await upsertConnectorItems(municipality, connectorResult);
-    const status = resolveSyncStatus(stats);
+    const status = resolveSyncStatus(stats, connectorResult.warnings);
     const error = status === SyncRunStatus.FAILED ? "No se pudieron persistir registros de licitaciones." : null;
 
     await prisma.syncRun.update({
@@ -209,7 +215,7 @@ async function runConnectorSync(municipality: MunicipalityConnectorInput, source
       },
     });
 
-    if (source === LicitationSource.MUNICIPAL_OPEN_PORTAL && status !== SyncRunStatus.FAILED) {
+    if (source === LicitationSource.MUNICIPAL_OPEN_PORTAL && shouldAdvanceOpenSyncTimestamp(status, stats)) {
       await prisma.municipality.update({
         where: { id: municipality.id },
         data: {
@@ -299,8 +305,8 @@ export async function runMunicipalityLicitationsSync(
     includePnt?: boolean;
     force?: boolean;
   },
-) {
-  const sourceResults: Array<{ source: LicitationSource; status: SyncRunStatus; stats: SyncStats; warnings: string[] }> = [];
+): Promise<MunicipalitySyncResult> {
+  const sourceResults: SourceResult[] = [];
 
   if (!licitationSyncEnabledForMunicipality(municipality)) {
     return {
@@ -352,18 +358,209 @@ function licitationSyncEnabledForMunicipality(municipality: MunicipalityConnecto
   return licitationsConfig.scrapingEnabledByDefault && municipality.scrapingEnabled;
 }
 
+function shouldIncludeLicitayaSync(includeLicitaya?: boolean) {
+  if (typeof includeLicitaya === "boolean") {
+    return includeLicitaya;
+  }
+
+  return licitationsConfig.licitayaEnabled;
+}
+
+function readRawPayloadString(rawPayload: Record<string, unknown>, key: string) {
+  const value = rawPayload[key];
+
+  if (typeof value !== "string") {
+    return null;
+  }
+
+  const normalized = value.trim();
+  return normalized ? normalized : null;
+}
+
+async function shouldRunLicitayaThisCycle(force = false) {
+  if (force) {
+    return true;
+  }
+
+  const intervalHours = licitationsConfig.licitayaSyncIntervalHours > 0 ? licitationsConfig.licitayaSyncIntervalHours : 12;
+  const latestRun = await prisma.syncRun.findFirst({
+    where: {
+      source: LicitationSource.LICITAYA,
+      status: {
+        in: [SyncRunStatus.SUCCESS, SyncRunStatus.PARTIAL],
+      },
+      finishedAt: {
+        not: null,
+      },
+    },
+    orderBy: {
+      finishedAt: "desc",
+    },
+    select: {
+      finishedAt: true,
+    },
+  });
+
+  if (!latestRun?.finishedAt) {
+    return true;
+  }
+
+  const nextRunAt = new Date(latestRun.finishedAt);
+  nextRunAt.setUTCHours(nextRunAt.getUTCHours() + intervalHours);
+  return nextRunAt <= new Date();
+}
+
+async function buildStateNameLookup() {
+  const rows = await prisma.municipality.findMany({
+    where: {
+      isActive: true,
+      municipalityCode: {
+        not: LICITAYA_MUNICIPALITY_CODE,
+      },
+    },
+    select: {
+      stateCode: true,
+      stateName: true,
+    },
+    distinct: ["stateCode"],
+  });
+
+  return new Map(rows.map((row) => [row.stateCode, row.stateName]));
+}
+
+async function ensureLicitayaMunicipality(stateCode: string, stateName: string): Promise<MunicipalityConnectorInput> {
+  const municipalityName = `Cobertura LicitaYa (${stateName})`;
+
+  return prisma.municipality.upsert({
+    where: {
+      stateCode_municipalityCode: {
+        stateCode,
+        municipalityCode: LICITAYA_MUNICIPALITY_CODE,
+      },
+    },
+    update: {
+      stateName,
+      municipalityName,
+      isActive: true,
+      scrapingEnabled: false,
+      openPortalType: MunicipalOpenPortalType.GENERIC,
+      openPortalUrl: null,
+      backupUrl: null,
+      pntEntryUrl: null,
+      pntEntityId: null,
+      pntSectorId: null,
+      pntSubjectId: null,
+    },
+    create: {
+      stateCode,
+      stateName,
+      municipalityCode: LICITAYA_MUNICIPALITY_CODE,
+      municipalityName,
+      openPortalType: MunicipalOpenPortalType.GENERIC,
+      scrapingEnabled: false,
+      isActive: true,
+    },
+    select: MUNICIPALITY_SELECT,
+  });
+}
+
+async function runLicitayaSourceSync(options?: { force?: boolean }): Promise<MunicipalitySyncResult[]> {
+  if (!(await shouldRunLicitayaThisCycle(options?.force))) {
+    return [];
+  }
+
+  const connectorResult = await fetchLicitayaLicitations();
+  const stateNameLookup = await buildStateNameLookup();
+
+  const grouped = new Map<
+    string,
+    {
+      stateName: string;
+      items: ConnectorResult["items"];
+    }
+  >();
+
+  let unresolvedStateItems = 0;
+
+  for (const item of connectorResult.items) {
+    const stateToken = readRawPayloadString(item.rawPayload, "licitayaState");
+    const resolvedState = resolveLicitayaState(stateToken);
+
+    if (!resolvedState) {
+      unresolvedStateItems += 1;
+    }
+
+    const stateCode = resolvedState?.stateCode ?? LICITAYA_FALLBACK_STATE_CODE;
+    const inferredStateName = stateNameLookup.get(stateCode) ?? resolvedState?.stateName ?? "Cobertura nacional";
+    const bucket = grouped.get(stateCode);
+
+    if (!bucket) {
+      grouped.set(stateCode, {
+        stateName: inferredStateName,
+        items: [item],
+      });
+      continue;
+    }
+
+    bucket.items.push(item);
+  }
+
+  if (grouped.size === 0) {
+    grouped.set(LICITAYA_FALLBACK_STATE_CODE, {
+      stateName: "Cobertura nacional",
+      items: [],
+    });
+  }
+
+  const warnings = [...connectorResult.warnings];
+
+  if (unresolvedStateItems > 0) {
+    warnings.push(`No se pudo mapear el estado para ${unresolvedStateItems} registros de LicitaYa.`);
+  }
+
+  const stateBuckets = [...grouped.entries()];
+  const results: MunicipalitySyncResult[] = [];
+
+  for (let index = 0; index < stateBuckets.length; index += 1) {
+    const [stateCode, bucket] = stateBuckets[index];
+    const municipality = await ensureLicitayaMunicipality(stateCode, bucket.stateName);
+    const sourceResult = await runConnectorSync(municipality, LicitationSource.LICITAYA, async () => ({
+      source: LicitationSource.LICITAYA,
+      items: bucket.items,
+      rawSourceUrl: connectorResult.rawSourceUrl,
+      warnings: index === 0 ? warnings : [],
+    }));
+
+    results.push({
+      municipality,
+      skipped: false,
+      reason: null,
+      sourceResults: [sourceResult],
+    });
+  }
+
+  return results;
+}
+
 export async function runDailyLicitationsSync(options?: {
   municipalityId?: string;
   limit?: number;
   skip?: number;
   targetYear?: number;
   includePnt?: boolean;
+  includeLicitaya?: boolean;
   force?: boolean;
 }) {
   const municipalities = await prisma.municipality.findMany({
     where: {
       isActive: true,
-      ...(options?.municipalityId ? { id: options.municipalityId } : {}),
+      ...(options?.municipalityId
+        ? { id: options.municipalityId }
+        : {
+            municipalityCode: {
+              not: LICITAYA_MUNICIPALITY_CODE,
+            },
+          }),
     },
     orderBy: [{ stateCode: "asc" }, { municipalityName: "asc" }],
     take: options?.limit ?? licitationsConfig.maxMunicipalitiesPerRun,
@@ -371,7 +568,7 @@ export async function runDailyLicitationsSync(options?: {
     select: MUNICIPALITY_SELECT,
   });
 
-  const results = [] as Awaited<ReturnType<typeof runMunicipalityLicitationsSync>>[];
+  const results: MunicipalitySyncResult[] = [];
 
   for (const municipality of municipalities) {
     const result = await runMunicipalityLicitationsSync(municipality, {
@@ -384,8 +581,19 @@ export async function runDailyLicitationsSync(options?: {
     await delay(licitationsConfig.requestDelayMs);
   }
 
+  if (shouldIncludeLicitayaSync(options?.includeLicitaya)) {
+    const licitayaResults = await runLicitayaSourceSync({
+      force: options?.force,
+    });
+    results.push(...licitayaResults);
+  }
+
+  const licitayaBucketsProcessed = results.filter((result) => result.municipality.municipalityCode === LICITAYA_MUNICIPALITY_CODE).length;
+
   return {
     processedMunicipalities: municipalities.length,
+    processedScopes: results.length,
+    processedLicitayaBuckets: licitayaBucketsProcessed,
     skippedMunicipalities: options?.skip ?? 0,
     results,
   };
diff --git a/src/lib/licitations/types.ts b/src/lib/licitations/types.ts
index b642722..6da56a9 100644
--- a/src/lib/licitations/types.ts
+++ b/src/lib/licitations/types.ts
@@ -75,4 +75,11 @@ export type RecommendationResultItem = {
   municipalityName: string;
   stateName: string;
   source: string;
+  deterministicScore?: number;
+  aiScore?: number;
+  blendedScore?: number;
+  aiReasons?: string[];
+  aiRisks?: string[];
+  nextStep?: string | null;
+  suggestionId?: string | null;
 };
diff --git a/src/lib/normative-analysis/__tests__/ai-analyze.test.ts b/src/lib/normative-analysis/__tests__/ai-analyze.test.ts
new file mode 100644
index 0000000..b2a01b6
--- /dev/null
+++ b/src/lib/normative-analysis/__tests__/ai-analyze.test.ts
@@ -0,0 +1,119 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { analyzeNormativeTextWithAi } from "@/lib/normative-analysis/ai-analyze";
+
+function mockOpenAiResponse(payload: unknown, options?: { ok?: boolean; status?: number }) {
+  return {
+    ok: options?.ok ?? true,
+    status: options?.status ?? 200,
+    json: async () => payload,
+  };
+}
+
+const input = {
+  text: "El licitante debera presentar propuesta tecnica y economica. La falta de firma sera causa de descalificacion. Marca exclusiva no aceptada.",
+  fileName: "bases.pdf",
+  documentType: "BASES_LICITACION" as const,
+  issuingEntity: "Municipio",
+  methodUsed: "ocr" as const,
+  numPages: 5,
+  warnings: [],
+};
+
+describe("analyzeNormativeTextWithAi", () => {
+  afterEach(() => {
+    vi.unstubAllGlobals();
+    vi.restoreAllMocks();
+    delete process.env.OPENAI_API_KEY;
+  });
+
+  it("keeps AI engine by normalizing partial JSON-schema responses", async () => {
+    process.env.OPENAI_API_KEY = "test-key";
+
+    const fetchMock = vi.fn(async () =>
+      mockOpenAiResponse({
+        model: "gpt-4.1-mini-test",
+        choices: [
+          {
+            message: {
+              content: JSON.stringify({
+                analysis: {
+                  executiveSummary: "Resumen ejecutivo del documento con observaciones relevantes para tomar decision.",
+                  participationViability: { score: 72, level: "media", rationale: "Requiere atencion documental." },
+                  risk: { level: "alto", description: "Riesgo por requisitos de descalificacion." },
+                  requiredChecklist: [{ title: "Carta", description: "Presentar carta bajo protesta." }],
+                  criticalRequirements: [{ title: "Firma", description: "Sin firma se descalifica.", severity: "alto" }],
+                  lockIns: [{ title: "Marca", impact: "Se menciona marca exclusiva.", recommendation: "Solicitar equivalencia." }],
+                  preparationRecommendations: [{ title: "Plan", description: "Preparar expediente.", priority: "alta" }],
+                  officialFormats: ["A", "B", "C"],
+                  valueForMoney: { score: 65, signals: ["Precio competitivo"], actions: ["Presentar TCO"] },
+                  circularEconomy: { applicable: false, signals: ["No aplica"], actions: ["Mantener cumplimiento"] },
+                  sourceTraceability: [{ documentType: "BASES_LICITACION", sourceLabel: "Bases", fields: ["requiredChecklist"] }],
+                  confidence: "medium",
+                },
+              }),
+            },
+          },
+        ],
+      }),
+    );
+
+    vi.stubGlobal("fetch", fetchMock);
+
+    const output = await analyzeNormativeTextWithAi(input);
+
+    expect(output.engine).toBe("openai_json_schema");
+    expect(output.result.requiredChecklist.length).toBeGreaterThan(0);
+    expect(output.result.officialFormats.length).toBeGreaterThan(0);
+    expect(output.warnings.some((warning) => warning.includes("normalizo respuesta AI parcial"))).toBe(true);
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+  });
+
+  it("accepts flat json_object responses without analysis envelope", async () => {
+    process.env.OPENAI_API_KEY = "test-key";
+
+    const fetchMock = vi
+      .fn()
+      .mockResolvedValueOnce(
+        mockOpenAiResponse(
+          {
+            error: { message: "schema mode temporary unavailable" },
+          },
+          { ok: false, status: 500 },
+        ),
+      )
+      .mockResolvedValueOnce(
+        mockOpenAiResponse({
+          model: "gpt-4.1-mini-test",
+          choices: [
+            {
+              message: {
+                content: JSON.stringify({
+                  executiveSummary: "Analisis sintetico con hallazgos principales para el area de contratacion.",
+                  participationViability: { score: 70, level: "media", rationale: "Hay riesgo controlable." },
+                  risk: { level: "medio", description: "Existen condiciones de atencion prioritaria." },
+                  requiredChecklist: [{ title: "Documentacion", description: "Presentar requisitos obligatorios." }],
+                  criticalRequirements: [{ title: "Plazo", description: "Plazo corto de entrega.", severity: "medio" }],
+                  lockIns: [],
+                  preparationRecommendations: [{ title: "Checklist", description: "Revisar entregables.", priority: "alta" }],
+                  officialFormats: ["Anexo tecnico", "Formato economico"],
+                  valueForMoney: { score: 68, signals: ["Calidad-precio"], actions: ["Justificar costo total"] },
+                  circularEconomy: { applicable: false, signals: ["Sin criterio explicito"], actions: ["Agregar opcion voluntaria"] },
+                  sourceTraceability: [{ documentType: "BASES_LICITACION", sourceLabel: "Bases", fields: ["criticalRequirements"] }],
+                  confidence: "medium",
+                }),
+              },
+            },
+          ],
+        }),
+      );
+
+    vi.stubGlobal("fetch", fetchMock);
+
+    const output = await analyzeNormativeTextWithAi(input);
+
+    expect(output.engine).toBe("openai_json_object");
+    expect(output.result.requiredChecklist.length).toBeGreaterThan(0);
+    expect(output.warnings.some((warning) => warning.includes("JSON object como fallback"))).toBe(true);
+    expect(fetchMock).toHaveBeenCalledTimes(2);
+  });
+});
diff --git a/src/lib/normative-analysis/__tests__/bundle.test.ts b/src/lib/normative-analysis/__tests__/bundle.test.ts
new file mode 100644
index 0000000..a0f7a61
--- /dev/null
+++ b/src/lib/normative-analysis/__tests__/bundle.test.ts
@@ -0,0 +1,119 @@
+import { describe, expect, it } from "vitest";
+import type { NormativeAnalysisResult, NormativeDocumentType } from "@/lib/normative-analysis/analyze";
+import { mergeNormativeBundleSources } from "@/lib/normative-analysis/bundle";
+
+function makeResult(label: string, documentType: NormativeDocumentType): NormativeAnalysisResult {
+  return {
+    executiveSummary: `Resumen ${label}`,
+    participationViability: {
+      score: 70,
+      level: "media",
+      rationale: "Racional",
+    },
+    risk: {
+      level: "medio",
+      description: "Riesgo controlable",
+    },
+    requiredChecklist: [
+      {
+        title: "Formato de personalidad",
+        description: `Checklist ${label}`,
+      },
+    ],
+    criticalRequirements: [
+      {
+        title: "Carta critica",
+        description: `Critico ${label}`,
+        severity: "alto",
+      },
+    ],
+    lockIns: [
+      {
+        title: "Candado propietario",
+        impact: `Impacto ${label}`,
+        recommendation: "Solicitar equivalencia",
+      },
+    ],
+    preparationRecommendations: [
+      {
+        title: `Preparacion ${label}`,
+        description: "Accion",
+        priority: "alta",
+      },
+    ],
+    officialFormats: ["Formato A"],
+    valueForMoney: {
+      score: 65,
+      signals: [`Senal ${label}`],
+      actions: ["Analizar costo total"],
+    },
+    circularEconomy: {
+      applicable: documentType === "ANEXOS",
+      signals: ["Reciclaje"],
+      actions: ["Plan de residuos"],
+    },
+    sourceTraceability: [
+      {
+        documentType,
+        sourceLabel: label,
+        fields: ["requiredChecklist"],
+      },
+    ],
+    confidence: "medium",
+  };
+}
+
+describe("mergeNormativeBundleSources", () => {
+  it("prioritizes Bases over Convocatoria on conflicting checklist items", () => {
+    const convocatoria = makeResult("convocatoria", "CONVOCATORIA");
+    convocatoria.requiredChecklist[0] = {
+      title: "Formato de personalidad",
+      description: "Texto convocatoria",
+    };
+
+    const bases = makeResult("bases", "BASES_LICITACION");
+    bases.requiredChecklist[0] = {
+      title: "Formato de personalidad",
+      description: "Texto bases",
+    };
+
+    const merged = mergeNormativeBundleSources([
+      {
+        sourceId: "conv",
+        fileName: "convocatoria.pdf",
+        documentType: "CONVOCATORIA",
+        result: convocatoria,
+      },
+      {
+        sourceId: "bases",
+        fileName: "bases.pdf",
+        documentType: "BASES_LICITACION",
+        result: bases,
+      },
+    ]);
+
+    expect(merged.result.requiredChecklist[0]?.description).toBe("Texto bases");
+    expect(merged.conflicts.length).toBeGreaterThan(0);
+  });
+
+  it("aggregates traceability and value-for-money signals", () => {
+    const merged = mergeNormativeBundleSources([
+      {
+        sourceId: "bases",
+        fileName: "bases.pdf",
+        documentType: "BASES_LICITACION",
+        result: makeResult("bases", "BASES_LICITACION"),
+      },
+      {
+        sourceId: "anexo",
+        fileName: "anexo.pdf",
+        documentType: "ANEXOS",
+        result: makeResult("anexo", "ANEXOS"),
+      },
+    ]);
+
+    expect(merged.result.sourceTraceability.length).toBe(2);
+    expect(merged.result.valueForMoney.signals.length).toBeGreaterThanOrEqual(2);
+    expect(merged.result.circularEconomy.actions.length).toBeGreaterThan(0);
+  });
+});
diff --git a/src/lib/normative-analysis/ai-analyze.ts b/src/lib/normative-analysis/ai-analyze.ts
new file mode 100644
index 0000000..a970bec
--- /dev/null
+++ b/src/lib/normative-analysis/ai-analyze.ts
@@ -0,0 +1,858 @@
+import "server-only";
+
+import { z } from "zod";
+import { analyzeNormativeText, type NormativeAnalysisInput, type NormativeAnalysisResult } from "@/lib/normative-analysis/analyze";
+
+const DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1";
+const DEFAULT_OPENAI_MODEL = "gpt-4.1-mini";
+const DEFAULT_TIMEOUT_MS = 75_000;
+const DEFAULT_MAX_TEXT_CHARS = 55_000;
+const MAX_WARNING_ISSUES = 4;
+
+const DOCUMENT_TYPES = ["BASES_LICITACION", "CONVOCATORIA", "ANEXOS", "REGLAMENTO", "LEY", "OTRO"] as const;
+const VIABILITY_LEVELS = ["alta", "media", "baja"] as const;
+const RISK_LEVELS = ["alto", "medio", "bajo"] as const;
+const PRIORITY_LEVELS = ["alta", "media", "baja"] as const;
+const CONFIDENCE_LEVELS = ["low", "medium", "high"] as const;
+
+type OpenAiChatCompletionResponse = {
+  choices?: Array<{
+    message?: {
+      content?: string | null;
+    };
+  }>;
+  model?: string;
+  usage?: {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+  };
+  error?: {
+    message?: string;
+  };
+};
+
+type NormativeAiUsage = {
+  promptTokens: number | null;
+  completionTokens: number | null;
+  totalTokens: number | null;
+};
+
+export type NormativeAiEngine = "openai_json_schema" | "openai_json_object" | "heuristic_fallback";
+
+export type NormativeAiAnalysisOutput = {
+  result: NormativeAnalysisResult;
+  engine: NormativeAiEngine;
+  model: string | null;
+  warnings: string[];
+  usage: NormativeAiUsage | null;
+};
+
+const ChecklistItemSchema = z.object({
+  title: z.string().min(3).max(180),
+  description: z.string().min(10).max(1500),
+});
+
+const CriticalItemSchema = z.object({
+  title: z.string().min(3).max(180),
+  description: z.string().min(10).max(1500),
+  severity: z.enum(["alto", "medio", "bajo"]),
+});
+
+const LockInItemSchema = z.object({
+  title: z.string().min(3).max(220),
+  impact: z.string().min(10).max(1800),
+  recommendation: z.string().min(10).max(1800),
+});
+
+const PreparationRecommendationSchema = z.object({
+  title: z.string().min(3).max(220),
+  description: z.string().min(10).max(1600),
+  priority: z.enum(["alta", "media", "baja"]),
+});
+
+const SourceTraceabilitySchema = z.object({
+  documentType: z.enum(["BASES_LICITACION", "CONVOCATORIA", "ANEXOS", "REGLAMENTO", "LEY", "OTRO"]),
+  sourceLabel: z.string().min(2).max(120),
+  fields: z.array(z.string().min(2).max(120)).max(40),
+});
+
+const NormativeAiResultSchema: z.ZodType<NormativeAnalysisResult> = z.object({
+  executiveSummary: z.string().min(40).max(6000),
+  participationViability: z.object({
+    score: z.number().int().min(0).max(100),
+    level: z.enum(["alta", "media", "baja"]),
+    rationale: z.string().min(10).max(1200),
+  }),
+  risk: z.object({
+    level: z.enum(["alto", "medio", "bajo"]),
+    description: z.string().min(10).max(1200),
+  }),
+  requiredChecklist: z.array(ChecklistItemSchema).min(3).max(20),
+  criticalRequirements: z.array(CriticalItemSchema).min(1).max(10),
+  lockIns: z.array(LockInItemSchema).max(8),
+  preparationRecommendations: z.array(PreparationRecommendationSchema).min(3).max(10),
+  officialFormats: z.array(z.string().min(10).max(500)).min(3).max(25),
+  valueForMoney: z.object({
+    score: z.number().int().min(0).max(100),
+    signals: z.array(z.string().min(10).max(900)).max(8),
+    actions: z.array(z.string().min(10).max(900)).max(8),
+  }),
+  circularEconomy: z.object({
+    applicable: z.boolean(),
+    signals: z.array(z.string().min(10).max(900)).max(8),
+    actions: z.array(z.string().min(10).max(900)).max(8),
+  }),
+  sourceTraceability: z.array(SourceTraceabilitySchema).max(20),
+  confidence: z.enum(["low", "medium", "high"]),
+});
+
+const NormativeAiResponseSchema = z.object({
+  analysis: NormativeAiResultSchema,
+});
+
+const NormativeAiJsonSchema = {
+  name: "normative_analysis_result",
+  strict: true,
+  schema: {
+    type: "object",
+    additionalProperties: false,
+    required: ["analysis"],
+    properties: {
+      analysis: {
+        type: "object",
+        additionalProperties: false,
+        required: [
+          "executiveSummary",
+          "participationViability",
+          "risk",
+          "requiredChecklist",
+          "criticalRequirements",
+          "lockIns",
+          "preparationRecommendations",
+          "officialFormats",
+          "valueForMoney",
+          "circularEconomy",
+          "sourceTraceability",
+          "confidence",
+        ],
+        properties: {
+          executiveSummary: { type: "string" },
+          participationViability: {
+            type: "object",
+            additionalProperties: false,
+            required: ["score", "level", "rationale"],
+            properties: {
+              score: { type: "integer", minimum: 0, maximum: 100 },
+              level: { type: "string", enum: ["alta", "media", "baja"] },
+              rationale: { type: "string" },
+            },
+          },
+          risk: {
+            type: "object",
+            additionalProperties: false,
+            required: ["level", "description"],
+            properties: {
+              level: { type: "string", enum: ["alto", "medio", "bajo"] },
+              description: { type: "string" },
+            },
+          },
+          requiredChecklist: {
+            type: "array",
+            items: {
+              type: "object",
+              additionalProperties: false,
+              required: ["title", "description"],
+              properties: {
+                title: { type: "string" },
+                description: { type: "string" },
+              },
+            },
+          },
+          criticalRequirements: {
+            type: "array",
+            items: {
+              type: "object",
+              additionalProperties: false,
+              required: ["title", "description", "severity"],
+              properties: {
+                title: { type: "string" },
+                description: { type: "string" },
+                severity: { type: "string", enum: ["alto", "medio", "bajo"] },
+              },
+            },
+          },
+          lockIns: {
+            type: "array",
+            items: {
+              type: "object",
+              additionalProperties: false,
+              required: ["title", "impact", "recommendation"],
+              properties: {
+                title: { type: "string" },
+                impact: { type: "string" },
+                recommendation: { type: "string" },
+              },
+            },
+          },
+          preparationRecommendations: {
+            type: "array",
+            items: {
+              type: "object",
+              additionalProperties: false,
+              required: ["title", "description", "priority"],
+              properties: {
+                title: { type: "string" },
+                description: { type: "string" },
+                priority: { type: "string", enum: ["alta", "media", "baja"] },
+              },
+            },
+          },
+          officialFormats: {
+            type: "array",
+            items: { type: "string" },
+          },
+          valueForMoney: {
+            type: "object",
+            additionalProperties: false,
+            required: ["score", "signals", "actions"],
+            properties: {
+              score: { type: "integer", minimum: 0, maximum: 100 },
+              signals: { type: "array", items: { type: "string" } },
+              actions: { type: "array", items: { type: "string" } },
+            },
+          },
+          circularEconomy: {
+            type: "object",
+            additionalProperties: false,
+            required: ["applicable", "signals", "actions"],
+            properties: {
+              applicable: { type: "boolean" },
+              signals: { type: "array", items: { type: "string" } },
+              actions: { type: "array", items: { type: "string" } },
+            },
+          },
+          sourceTraceability: {
+            type: "array",
+            items: {
+              type: "object",
+              additionalProperties: false,
+              required: ["documentType", "sourceLabel", "fields"],
+              properties: {
+                documentType: { type: "string", enum: ["BASES_LICITACION", "CONVOCATORIA", "ANEXOS", "REGLAMENTO", "LEY", "OTRO"] },
+                sourceLabel: { type: "string" },
+                fields: { type: "array", items: { type: "string" } },
+              },
+            },
+          },
+          confidence: { type: "string", enum: ["low", "medium", "high"] },
+        },
+      },
+    },
+  },
+} as const;
+
+function parsePositiveInteger(value: string | undefined, fallback: number) {
+  const parsed = Number.parseInt((value ?? "").trim(), 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+
+function getOpenAiApiKey() {
+  return process.env.OPENAI_API_KEY?.trim() || process.env.API_KEY?.trim() || process.env.api_key?.trim() || "";
+}
+
+function clampInputText(fullText: string) {
+  const maxChars = parsePositiveInteger(process.env.OPENAI_NORMATIVE_MAX_CHARS, DEFAULT_MAX_TEXT_CHARS);
+  if (fullText.length <= maxChars) {
+    return fullText;
+  }
+
+  return `${fullText.slice(0, maxChars)}\n\n[TEXT_TRUNCATED_TO_${maxChars}_CHARS]`;
+}
+
+function extractJsonObject(rawContent: string) {
+  const trimmed = rawContent.trim();
+
+  try {
+    return JSON.parse(trimmed) as unknown;
+  } catch {
+    // Continue with secondary parsing.
+  }
+
+  const withoutFence = trimmed
+    .replace(/^```json\s*/i, "")
+    .replace(/^```\s*/i, "")
+    .replace(/\s*```$/i, "")
+    .trim();
+
+  try {
+    return JSON.parse(withoutFence) as unknown;
+  } catch {
+    // Continue with bracket extraction.
+  }
+
+  const firstBrace = withoutFence.indexOf("{");
+  const lastBrace = withoutFence.lastIndexOf("}");
+
+  if (firstBrace >= 0 && lastBrace > firstBrace) {
+    return JSON.parse(withoutFence.slice(firstBrace, lastBrace + 1)) as unknown;
+  }
+
+  throw new Error("La respuesta de OpenAI no contiene un JSON valido.");
+}
+
+function isObject(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+
+function compactText(value: string) {
+  return value.replace(/\s+/g, " ").trim();
+}
+
+function readString(value: unknown) {
+  if (typeof value !== "string") {
+    return null;
+  }
+
+  const normalized = compactText(value);
+  return normalized.length > 0 ? normalized : null;
+}
+
+function truncate(value: string, maxLength: number) {
+  return value.length <= maxLength ? value : value.slice(0, maxLength).trim();
+}
+
+function readArray(value: unknown) {
+  return Array.isArray(value) ? value : [];
+}
+
+function readNumber(value: unknown, fallback: number) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+
+  if (typeof value === "string") {
+    const parsed = Number.parseFloat(value.trim());
+    if (Number.isFinite(parsed)) {
+      return parsed;
+    }
+  }
+
+  return fallback;
+}
+
+function readBoolean(value: unknown, fallback: boolean) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true" || normalized === "1" || normalized === "si" || normalized === "sí") {
+      return true;
+    }
+    if (normalized === "false" || normalized === "0" || normalized === "no") {
+      return false;
+    }
+  }
+
+  return fallback;
+}
+
+function readEnum<T extends string>(value: unknown, values: readonly T[], fallback: T): T {
+  if (typeof value !== "string") {
+    return fallback;
+  }
+
+  const normalized = value.trim().toLowerCase();
+  const match = values.find((candidate) => candidate.toLowerCase() === normalized);
+  return match ?? fallback;
+}
+
+function uniqueByText<T>(items: T[], selector: (item: T) => string, maxItems: number) {
+  const seen = new Set<string>();
+  const result: T[] = [];
+
+  for (const item of items) {
+    const key = selector(item);
+    if (!key || seen.has(key)) {
+      continue;
+    }
+
+    seen.add(key);
+    result.push(item);
+    if (result.length >= maxItems) {
+      break;
+    }
+  }
+
+  return result;
+}
+
+function normalizeStringArray(value: unknown, fallback: string[], maxItems: number, minLength = 1) {
+  const collected = readArray(value)
+    .map((item) => readString(item))
+    .filter((item): item is string => typeof item === "string" && item.length >= minLength);
+  const source = collected.length > 0 ? collected : fallback;
+  const normalized = source.map((item) => truncate(item, 900));
+  return uniqueByText(normalized, (item) => item.toLowerCase(), maxItems);
+}
+
+function normalizeChecklist(value: unknown, fallback: NormativeAnalysisResult["requiredChecklist"]) {
+  const collected = readArray(value)
+    .map((item) => {
+      if (!isObject(item)) {
+        return null;
+      }
+
+      const title = readString(item.title) ?? readString(item.description);
+      const description = readString(item.description) ?? title;
+      if (!title || !description) {
+        return null;
+      }
+
+      return {
+        title: truncate(title, 180),
+        description: truncate(description, 1500),
+      };
+    })
+    .filter((item): item is NonNullable<typeof item> => item !== null);
+
+  const source = collected.length > 0 ? collected : fallback;
+  return uniqueByText(source, (item) => item.title.toLowerCase(), 20);
+}
+
+function normalizeCriticalRequirements(value: unknown, fallback: NormativeAnalysisResult["criticalRequirements"]) {
+  const collected = readArray(value)
+    .map((item) => {
+      if (!isObject(item)) {
+        return null;
+      }
+
+      const title = readString(item.title) ?? readString(item.description);
+      const description = readString(item.description) ?? title;
+      if (!title || !description) {
+        return null;
+      }
+
+      return {
+        title: truncate(title, 180),
+        description: truncate(description, 1500),
+        severity: readEnum(item.severity, RISK_LEVELS, "medio"),
+      };
+    })
+    .filter((item): item is NonNullable<typeof item> => item !== null);
+
+  const source = collected.length > 0 ? collected : fallback;
+  return uniqueByText(source, (item) => item.title.toLowerCase(), 10);
+}
+
+function normalizeLockIns(value: unknown, fallback: NormativeAnalysisResult["lockIns"]) {
+  const collected = readArray(value)
+    .map((item) => {
+      if (!isObject(item)) {
+        return null;
+      }
+
+      const title = readString(item.title) ?? readString(item.impact);
+      const impact = readString(item.impact) ?? title;
+      const recommendation = readString(item.recommendation);
+
+      if (!title || !impact || !recommendation) {
+        return null;
+      }
+
+      return {
+        title: truncate(title, 220),
+        impact: truncate(impact, 1800),
+        recommendation: truncate(recommendation, 1800),
+      };
+    })
+    .filter((item): item is NonNullable<typeof item> => item !== null);
+
+  const source = collected.length > 0 ? collected : fallback;
+  return uniqueByText(source, (item) => item.title.toLowerCase(), 8);
+}
+
+function normalizePreparationRecommendations(value: unknown, fallback: NormativeAnalysisResult["preparationRecommendations"]) {
+  const collected = readArray(value)
+    .map((item) => {
+      if (!isObject(item)) {
+        return null;
+      }
+
+      const title = readString(item.title) ?? readString(item.description);
+      const description = readString(item.description) ?? title;
+
+      if (!title || !description) {
+        return null;
+      }
+
+      return {
+        title: truncate(title, 220),
+        description: truncate(description, 1600),
+        priority: readEnum(item.priority, PRIORITY_LEVELS, "media"),
+      };
+    })
+    .filter((item): item is NonNullable<typeof item> => item !== null);
+
+  const source = collected.length > 0 ? collected : fallback;
+  return uniqueByText(source, (item) => item.title.toLowerCase(), 10);
+}
+
+function normalizeSourceTraceability(value: unknown, fallback: NormativeAnalysisResult["sourceTraceability"]) {
+  const collected = readArray(value)
+    .map((item) => {
+      if (!isObject(item)) {
+        return null;
+      }
+
+      const sourceLabel = readString(item.sourceLabel);
+      if (!sourceLabel) {
+        return null;
+      }
+
+      const fields = normalizeStringArray(item.fields, [], 40, 2);
+
+      return {
+        documentType: readEnum(item.documentType, DOCUMENT_TYPES, "OTRO"),
+        sourceLabel: truncate(sourceLabel, 120),
+        fields,
+      };
+    })
+    .filter((item): item is NonNullable<typeof item> => item !== null);
+
+  return collected.length > 0 ? collected.slice(0, 20) : fallback.slice(0, 20);
+}
+
+function appearsToBeAnalysisObject(value: Record<string, unknown>) {
+  const keys = Object.keys(value);
+  if (keys.length === 0) {
+    return false;
+  }
+
+  const meaningfulKeys = [
+    "executiveSummary",
+    "participationViability",
+    "risk",
+    "requiredChecklist",
+    "criticalRequirements",
+    "lockIns",
+    "preparationRecommendations",
+    "officialFormats",
+    "valueForMoney",
+    "circularEconomy",
+    "sourceTraceability",
+    "confidence",
+  ];
+
+  let matched = 0;
+  for (const key of meaningfulKeys) {
+    if (key in value) {
+      matched += 1;
+    }
+  }
+
+  return matched >= 3;
+}
+
+function pickAnalysisCandidate(payload: unknown) {
+  if (!isObject(payload)) {
+    return null;
+  }
+
+  if (isObject(payload.analysis)) {
+    return payload.analysis;
+  }
+
+  if (isObject(payload.data) && isObject(payload.data.analysis)) {
+    return payload.data.analysis;
+  }
+
+  if (appearsToBeAnalysisObject(payload)) {
+    return payload;
+  }
+
+  return null;
+}
+
+function zodIssueSummary(error: z.ZodError) {
+  return error.issues
+    .slice(0, MAX_WARNING_ISSUES)
+    .map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`)
+    .join(" | ");
+}
+
+function normalizeFromCandidate(candidate: Record<string, unknown>, fallback: NormativeAnalysisResult): NormativeAnalysisResult {
+  const participationCandidate = isObject(candidate.participationViability) ? candidate.participationViability : null;
+  const riskCandidate = isObject(candidate.risk) ? candidate.risk : null;
+  const valueForMoneyCandidate = isObject(candidate.valueForMoney) ? candidate.valueForMoney : null;
+  const circularEconomyCandidate = isObject(candidate.circularEconomy) ? candidate.circularEconomy : null;
+
+  return {
+    executiveSummary: readString(candidate.executiveSummary) ?? fallback.executiveSummary,
+    participationViability: {
+      score: Math.max(0, Math.min(100, Math.round(readNumber(participationCandidate?.score, fallback.participationViability.score)))),
+      level: readEnum(participationCandidate?.level, VIABILITY_LEVELS, fallback.participationViability.level),
+      rationale: readString(participationCandidate?.rationale) ?? fallback.participationViability.rationale,
+    },
+    risk: {
+      level: readEnum(riskCandidate?.level, RISK_LEVELS, fallback.risk.level),
+      description: readString(riskCandidate?.description) ?? fallback.risk.description,
+    },
+    requiredChecklist: normalizeChecklist(candidate.requiredChecklist, fallback.requiredChecklist),
+    criticalRequirements: normalizeCriticalRequirements(candidate.criticalRequirements, fallback.criticalRequirements),
+    lockIns: normalizeLockIns(candidate.lockIns, fallback.lockIns),
+    preparationRecommendations: normalizePreparationRecommendations(candidate.preparationRecommendations, fallback.preparationRecommendations),
+    officialFormats: normalizeStringArray(candidate.officialFormats, fallback.officialFormats, 25, 3),
+    valueForMoney: {
+      score: Math.max(0, Math.min(100, Math.round(readNumber(valueForMoneyCandidate?.score, fallback.valueForMoney.score)))),
+      signals: normalizeStringArray(valueForMoneyCandidate?.signals, fallback.valueForMoney.signals, 8, 3),
+      actions: normalizeStringArray(valueForMoneyCandidate?.actions, fallback.valueForMoney.actions, 8, 3),
+    },
+    circularEconomy: {
+      applicable: readBoolean(circularEconomyCandidate?.applicable, fallback.circularEconomy.applicable),
+      signals: normalizeStringArray(circularEconomyCandidate?.signals, fallback.circularEconomy.signals, 8, 3),
+      actions: normalizeStringArray(circularEconomyCandidate?.actions, fallback.circularEconomy.actions, 8, 3),
+    },
+    sourceTraceability: normalizeSourceTraceability(candidate.sourceTraceability, fallback.sourceTraceability),
+    confidence: readEnum(candidate.confidence, CONFIDENCE_LEVELS, fallback.confidence),
+  };
+}
+
+function normalizeResult(result: NormativeAnalysisResult): NormativeAnalysisResult {
+  const normalizedChecklist = result.requiredChecklist.slice(0, 20);
+  const normalizedCritical = result.criticalRequirements.slice(0, 10);
+  const normalizedLockIns = result.lockIns.slice(0, 8);
+  const normalizedRecommendations = result.preparationRecommendations.slice(0, 10);
+  const normalizedFormats = result.officialFormats.slice(0, 25);
+  const normalizedTraceability = result.sourceTraceability.slice(0, 20);
+  const normalizedValueForMoneySignals = result.valueForMoney.signals.slice(0, 8);
+  const normalizedValueForMoneyActions = result.valueForMoney.actions.slice(0, 8);
+  const normalizedCircularSignals = result.circularEconomy.signals.slice(0, 8);
+  const normalizedCircularActions = result.circularEconomy.actions.slice(0, 8);
+
+  return {
+    ...result,
+    requiredChecklist: normalizedChecklist,
+    criticalRequirements: normalizedCritical,
+    lockIns: normalizedLockIns,
+    preparationRecommendations: normalizedRecommendations,
+    officialFormats: normalizedFormats,
+    sourceTraceability: normalizedTraceability,
+    valueForMoney: {
+      score: Math.max(0, Math.min(100, Math.round(result.valueForMoney.score))),
+      signals:
+        normalizedValueForMoneySignals.length > 0
+          ? normalizedValueForMoneySignals
+          : ["No se detectaron senales explicitas de valor por dinero en el documento."],
+      actions:
+        normalizedValueForMoneyActions.length > 0
+          ? normalizedValueForMoneyActions
+          : ["Incorporar analisis de costo total de propiedad y evidencia de eficiencia."],
+    },
+    circularEconomy: {
+      applicable: result.circularEconomy.applicable,
+      signals:
+        normalizedCircularSignals.length > 0
+          ? normalizedCircularSignals
+          : ["No se detectaron criterios explicitos de economia circular."],
+      actions:
+        normalizedCircularActions.length > 0
+          ? normalizedCircularActions
+          : ["Agregar acciones de reutilizacion, reciclaje o disposicion responsable cuando aplique."],
+    },
+    participationViability: {
+      ...result.participationViability,
+      score: Math.max(0, Math.min(100, Math.round(result.participationViability.score))),
+    },
+  };
+}
+
+function usageFromPayload(payload: OpenAiChatCompletionResponse): NormativeAiUsage {
+  return {
+    promptTokens: payload.usage?.prompt_tokens ?? null,
+    completionTokens: payload.usage?.completion_tokens ?? null,
+    totalTokens: payload.usage?.total_tokens ?? null,
+  };
+}
+
+function buildPrompts(input: NormativeAnalysisInput) {
+  const inputText = clampInputText(input.text);
+  const documentType = input.documentType;
+  const issuingEntity = input.issuingEntity ?? "No especificada";
+  const extractionMethod = input.methodUsed;
+  const pageCount = input.numPages;
+
+  const systemPrompt = [
+    "Eres un analista senior de contratacion publica en Mexico especializado en licitaciones y cumplimiento normativo.",
+    "Debes entregar un analisis practico y accionable para equipos que preparan propuestas.",
+    "No inventes datos fuera del texto proporcionado. Si algo no aparece claramente, se conservador.",
+    "Responde siempre en espanol.",
+    "Devuelve unicamente JSON valido siguiendo exactamente el esquema solicitado.",
+  ].join(" ");
+
+  const userPrompt = [
+    "Analiza el siguiente documento normativo de licitacion y devuelve un analisis completo.",
+    `Tipo de documento: ${documentType}`,
+    `Entidad emisora: ${issuingEntity}`,
+    `Metodo de extraccion: ${extractionMethod}`,
+    `Numero de paginas: ${pageCount}`,
+    "",
+    "Criterios de salida:",
+    "- executiveSummary: resumen ejecutivo claro y util para decision.",
+    "- participationViability.score: probabilidad realista (0-100) de participar con exito.",
+    "- requiredChecklist: requisitos obligatorios concretos detectados.",
+    "- criticalRequirements: requisitos de alto impacto y severidad.",
+    "- lockIns: posibles candados/restricciones y recomendacion de accion.",
+    "- preparationRecommendations: plan de preparacion accionable con prioridad.",
+    "- officialFormats: formatos/anexos/manifestos oficiales detectados o requeridos.",
+    "- valueForMoney: senales y acciones sobre costo total, eficiencia y calidad-precio.",
+    "- circularEconomy: senales y acciones de economia circular (si aplica).",
+    "- sourceTraceability: trazabilidad por documento origen y campos detectados.",
+    "",
+    "Texto del documento:",
+    inputText,
+  ].join("\n");
+
+  return {
+    systemPrompt,
+    userPrompt,
+  };
+}
+
+async function callOpenAiNormativeAnalysis(input: NormativeAnalysisInput, mode: "json_schema" | "json_object") {
+  const apiKey = getOpenAiApiKey();
+  if (!apiKey) {
+    throw new Error("No se encontro API key para OpenAI (OPENAI_API_KEY o api_key).");
+  }
+
+  const model = process.env.OPENAI_NORMATIVE_MODEL?.trim() || DEFAULT_OPENAI_MODEL;
+  const timeoutMs = parsePositiveInteger(process.env.OPENAI_NORMATIVE_TIMEOUT_MS, DEFAULT_TIMEOUT_MS);
+  const baseUrl = (process.env.OPENAI_API_BASE_URL?.trim() || DEFAULT_OPENAI_BASE_URL).replace(/\/+$/, "");
+  const { systemPrompt, userPrompt } = buildPrompts(input);
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+
+  try {
+    const response = await fetch(`${baseUrl}/chat/completions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`,
+      },
+      body: JSON.stringify({
+        model,
+        temperature: 0,
+        response_format:
+          mode === "json_schema"
+            ? {
+                type: "json_schema",
+                json_schema: NormativeAiJsonSchema,
+              }
+            : {
+                type: "json_object",
+              },
+        messages: [
+          { role: "system", content: systemPrompt },
+          { role: "user", content: userPrompt },
+        ],
+      }),
+      signal: controller.signal,
+    });
+
+    const payload = (await response.json().catch(() => ({}))) as OpenAiChatCompletionResponse;
+
+    if (!response.ok) {
+      const apiError = payload.error?.message ? ` ${payload.error.message}` : "";
+      throw new Error(`OpenAI devolvio ${response.status}.${apiError}`);
+    }
+
+    const rawContent = payload.choices?.[0]?.message?.content;
+    if (!rawContent || typeof rawContent !== "string") {
+      throw new Error("OpenAI no devolvio contenido util.");
+    }
+
+    const parsedContent = extractJsonObject(rawContent);
+    const strictParsed = NormativeAiResponseSchema.safeParse(parsedContent);
+
+    if (strictParsed.success) {
+      const normalized = normalizeResult(strictParsed.data.analysis);
+
+      return {
+        result: normalized,
+        model: payload.model ?? model,
+        usage: usageFromPayload(payload),
+        warnings: [] as string[],
+      };
+    }
+
+    const candidate = pickAnalysisCandidate(parsedContent);
+    if (!candidate) {
+      const detail = zodIssueSummary(strictParsed.error);
+      throw new Error(`OpenAI devolvio JSON sin estructura de analisis util. ${detail}`);
+    }
+
+    const heuristicBaseline = analyzeNormativeText(input);
+    const tolerantResult = normalizeResult(normalizeFromCandidate(candidate, heuristicBaseline));
+    const issueSummary = zodIssueSummary(strictParsed.error);
+
+    return {
+      result: tolerantResult,
+      model: payload.model ?? model,
+      usage: usageFromPayload(payload),
+      warnings: [`Se normalizo respuesta AI parcial fuera de schema estricto. ${issueSummary}`],
+    };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+export async function analyzeNormativeTextWithAi(input: NormativeAnalysisInput): Promise<NormativeAiAnalysisOutput> {
+  const warnings: string[] = [];
+
+  try {
+    const ai = await callOpenAiNormativeAnalysis(input, "json_schema");
+    warnings.push(...ai.warnings);
+
+    return {
+      result: ai.result,
+      engine: "openai_json_schema",
+      model: ai.model,
+      warnings,
+      usage: ai.usage,
+    };
+  } catch (schemaError) {
+    const schemaMessage = schemaError instanceof Error ? schemaError.message : String(schemaError);
+    warnings.push(`OpenAI JSON schema no disponible: ${schemaMessage}`);
+  }
+
+  try {
+    const ai = await callOpenAiNormativeAnalysis(input, "json_object");
+    warnings.push(...ai.warnings);
+    warnings.push("Se uso OpenAI JSON object como fallback del modo JSON schema.");
+
+    return {
+      result: ai.result,
+      engine: "openai_json_object",
+      model: ai.model,
+      warnings,
+      usage: ai.usage,
+    };
+  } catch (jsonObjectError) {
+    const jsonObjectMessage = jsonObjectError instanceof Error ? jsonObjectError.message : String(jsonObjectError);
+    warnings.push(`OpenAI JSON object fallo: ${jsonObjectMessage}`);
+  }
+
+  const fallback = analyzeNormativeText(input);
+  warnings.push("Se activo el motor heuristico como ultimo recurso.");
+
+  return {
+    result: fallback,
+    engine: "heuristic_fallback",
+    model: null,
+    warnings,
+    usage: null,
+  };
+}
diff --git a/src/lib/normative-analysis/analyze.ts b/src/lib/normative-analysis/analyze.ts
new file mode 100644
index 0000000..e42dff5
--- /dev/null
+++ b/src/lib/normative-analysis/analyze.ts
@@ -0,0 +1,555 @@
+export type NormativeDocumentType = "BASES_LICITACION" | "CONVOCATORIA" | "ANEXOS" | "REGLAMENTO" | "LEY" | "OTRO";
+
+export type NormativeAnalysisInput = {
+  text: string;
+  fileName: string;
+  documentType: NormativeDocumentType;
+  issuingEntity: string | null;
+  methodUsed: "direct" | "ocr";
+  numPages: number;
+  warnings: string[];
+};
+
+export type NormativeSeverity = "alto" | "medio" | "bajo";
+export type NormativePriority = "alta" | "media" | "baja";
+
+export type NormativeChecklistItem = {
+  title: string;
+  description: string;
+};
+
+export type NormativeCriticalItem = NormativeChecklistItem & {
+  severity: NormativeSeverity;
+};
+
+export type NormativeLockInItem = {
+  title: string;
+  impact: string;
+  recommendation: string;
+};
+
+export type NormativePreparationRecommendation = {
+  title: string;
+  description: string;
+  priority: NormativePriority;
+};
+
+export type NormativeSourceTraceabilityItem = {
+  documentType: NormativeDocumentType;
+  sourceLabel: string;
+  fields: string[];
+};
+
+export type NormativeAnalysisResult = {
+  executiveSummary: string;
+  participationViability: {
+    score: number;
+    level: "alta" | "media" | "baja";
+    rationale: string;
+  };
+  risk: {
+    level: NormativeSeverity;
+    description: string;
+  };
+  requiredChecklist: NormativeChecklistItem[];
+  criticalRequirements: NormativeCriticalItem[];
+  lockIns: NormativeLockInItem[];
+  preparationRecommendations: NormativePreparationRecommendation[];
+  officialFormats: string[];
+  valueForMoney: {
+    score: number;
+    signals: string[];
+    actions: string[];
+  };
+  circularEconomy: {
+    applicable: boolean;
+    signals: string[];
+    actions: string[];
+  };
+  sourceTraceability: NormativeSourceTraceabilityItem[];
+  confidence: "low" | "medium" | "high";
+};
+
+const MAX_LINE_LENGTH = 260;
+const MAX_CHECKLIST_ITEMS = 15;
+const MAX_CRITICAL_ITEMS = 5;
+const MAX_LOCKINS = 3;
+
+const requirementPattern =
+  /\b(deber[áa]n?|obligatori[oa]s?|requisit[oa]s?|se requiere|se solicita|presentar|entregar|acreditar|cumplir|debe|deber[áa]\s+contar|anexar|adjuntar|constancia)\b/i;
+const riskPattern =
+  /\b(descalific|sanci[oó]n|penaliz|incumpl|inhabilit|rescisi[oó]n|causal|desechad|inviable|impugnable|no\s+se\s+acepta|motivo\s+de\s+desechamiento)\w*/i;
+const criticalPattern =
+  /\b(cualquier documento|no se acepta|imposible|obligatorio|causa de descalificaci[oó]n|deber[áa]|ser[áa]\s+descalificad[oa]|desechamiento)\b/i;
+const lockInPattern =
+  /\b(board member|leadership|dmtf|oem|distribuidor autorizado|fabricante|propietari[oa]|certificaci[oó]n exclusiva|marca(?:\s+determinada)?|patente|licencia propietaria|exclusiv[oa]|unico proveedor|[uú]nica marca|solamente|equivalente no aceptado)\b/i;
+const deadlinePattern = /\b(cierre|fecha l[ií]mite|l[ií]mite de|apertura|junta|fallo|calendario|cronograma|vigencia|plazo|entrega)\b/i;
+const formatPattern = /\b(anexo|formato)\b/i;
+
+const datePattern =
+  /\b\d{1,2}[\/\-]\d{1,2}[\/\-]\d{2,4}\b|\b\d{1,2}\s+de\s+[a-zA-Záéíóúñ]+\s+de\s+\d{4}\b|\b\d{4}[\/\-]\d{2}[\/\-]\d{2}\b/;
+
+const defaultFormatTemplates = [
+  "Acredita la existencia legal del licitante y las facultades de su representante para presentar la propuesta y firmar el contrato.",
+  "Carta de compromiso donde el licitante acepta someterse a reglas, requisitos y especificaciones de la licitacion.",
+  "Manifiesto de conocimiento y aceptacion de bases y aclaraciones.",
+  "Declaracion bajo protesta de decir verdad de no estar en supuestos de inhabilitacion.",
+  "Compromiso de conducirse honestamente y abstenerse de conductas para obtener ventajas indebidas.",
+  "Manifestacion de contar con politica de integridad (personas morales).",
+  "Declaracion de propuesta independiente y sin colusion.",
+  "Declaracion sobre procedencia extranjera de bienes ofertados (si aplica).",
+  "Declaracion sobre procedencia nacional de bienes o servicios ofertados.",
+  "Formato de clasificacion de empresa (micro, pequena o mediana).",
+  "Checklist de documentos entregados por el licitante.",
+  "Declaracion de inexistencia de conflicto de interes del representante, socios o accionistas.",
+  "Declaracion de no emitir comprobantes fiscales sin activos para prestar servicios (no EFOS).",
+];
+
+function cleanText(value: string) {
+  return value.replace(/\u00a0/g, " ").replace(/\r/g, "\n").replace(/[ \t]+/g, " ").trim();
+}
+
+function compactLine(value: string) {
+  const compact = value.replace(/\s+/g, " ").trim();
+  if (!compact) {
+    return null;
+  }
+
+  if (compact.length > MAX_LINE_LENGTH) {
+    return `${compact.slice(0, MAX_LINE_LENGTH - 1)}...`;
+  }
+
+  return compact;
+}
+
+function splitLines(text: string) {
+  return text
+    .split("\n")
+    .map((line) => compactLine(line))
+    .filter((line): line is string => Boolean(line));
+}
+
+function splitSentences(text: string) {
+  return text
+    .split(/(?<=[.!?])\s+/)
+    .map((sentence) => compactLine(sentence))
+    .filter((sentence): sentence is string => Boolean(sentence));
+}
+
+function toUnique<T>(values: T[], keySelector: (value: T) => string, maxItems = Number.POSITIVE_INFINITY) {
+  const seen = new Set<string>();
+  const result: T[] = [];
+
+  for (const value of values) {
+    const key = keySelector(value);
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    result.push(value);
+
+    if (result.length >= maxItems) {
+      break;
+    }
+  }
+
+  return result;
+}
+
+function clamp(value: number, min: number, max: number) {
+  return Math.max(min, Math.min(max, value));
+}
+
+function compactWords(value: string, maxWords: number) {
+  const words = value
+    .replace(/[•·]/g, " ")
+    .replace(/^[-–—\s]+/, "")
+    .trim()
+    .split(/\s+/)
+    .filter(Boolean);
+
+  return words.slice(0, maxWords).join(" ");
+}
+
+function titleFromLine(line: string) {
+  const normalized = line
+    .replace(/^[0-9]+[.)]\s*/, "")
+    .replace(/^[-–—]+\s*/, "")
+    .replace(/\.$/, "")
+    .trim();
+
+  if (normalized.length <= 80) {
+    return normalized;
+  }
+
+  return `${compactWords(normalized, 8)}...`;
+}
+
+function buildExecutiveSummary(
+  sentences: string[],
+  documentType: NormativeDocumentType,
+  requiredChecklist: NormativeChecklistItem[],
+  criticalRequirements: NormativeCriticalItem[],
+  lockIns: NormativeLockInItem[],
+) {
+  const intro =
+    sentences
+      .filter((sentence) => requirementPattern.test(sentence) || deadlinePattern.test(sentence) || datePattern.test(sentence))
+      .slice(0, 3)
+      .join(" ") ||
+    sentences.slice(0, 2).join(" ") ||
+    "No se detecto suficiente contenido para construir un resumen ejecutivo robusto.";
+
+  const typeLabel = documentType.toLowerCase().replace("_", " ");
+  const metrics = `Se identificaron ${requiredChecklist.length} requisitos obligatorios, ${criticalRequirements.length} puntos criticos y ${lockIns.length} posibles candados.`;
+
+  return `Analisis de ${typeLabel}: ${intro} ${metrics}`;
+}
+
+function buildRequiredChecklist(lines: string[]) {
+  const candidates = lines.filter((line) => requirementPattern.test(line) || deadlinePattern.test(line));
+
+  return toUnique(
+    candidates.map((line) => ({
+      title: titleFromLine(line),
+      description: line,
+    })),
+    (item) => item.title.toLowerCase(),
+    MAX_CHECKLIST_ITEMS,
+  );
+}
+
+function criticalSeverity(line: string): NormativeSeverity {
+  if (riskPattern.test(line) || /\b(cualquier|imposible|descalificacion|inviable|obligatorio)\b/i.test(line)) {
+    return "alto";
+  }
+
+  if (/\b(restring|limit|vigencia|garantia|fianza|solvencia|capacidad financiera)\b/i.test(line)) {
+    return "medio";
+  }
+
+  return "bajo";
+}
+
+function buildCriticalRequirements(lines: string[], requiredChecklist: NormativeChecklistItem[]) {
+  const explicit = lines.filter((line) => riskPattern.test(line) || criticalPattern.test(line));
+
+  const source = explicit.length > 0 ? explicit : requiredChecklist.slice(0, 6).map((item) => item.description);
+
+  return toUnique(
+    source.map((line) => ({
+      title: titleFromLine(line),
+      description: line,
+      severity: criticalSeverity(line),
+    })),
+    (item) => item.title.toLowerCase(),
+    MAX_CRITICAL_ITEMS,
+  );
+}
+
+function recommendationForLockIn(line: string) {
+  const normalized = line.toLowerCase();
+
+  if (normalized.includes("dmtf") || normalized.includes("board member") || normalized.includes("leadership")) {
+    return "Solicitar en Junta de Aclaraciones una alternativa equivalente que no restrinja indebidamente la competencia.";
+  }
+
+  if (normalized.includes("oem") || normalized.includes("fabricante") || normalized.includes("distribuidor autorizado")) {
+    return "Iniciar de inmediato negociacion de respaldo con OEM y preparar evidencia documental del acuerdo.";
+  }
+
+  if (normalized.includes("propietari") || normalized.includes("marca")) {
+    return "Evaluar impugnacion tecnica o solicitud de aclaracion para permitir equivalencias funcionales certificadas.";
+  }
+
+  return "Preparar pregunta tecnica en Junta de Aclaraciones para justificar proporcionalidad del requisito.";
+}
+
+function buildLockIns(lines: string[], criticalRequirements: NormativeCriticalItem[]) {
+  const lockinLines = lines.filter((line) => lockInPattern.test(line));
+  const source = lockinLines.length > 0 ? lockinLines : criticalRequirements.filter((item) => item.severity === "alto").map((item) => item.description);
+
+  return toUnique(
+    source.map((line) => ({
+      title: titleFromLine(line),
+      impact: line,
+      recommendation: recommendationForLockIn(line),
+    })),
+    (item) => item.title.toLowerCase(),
+    MAX_LOCKINS,
+  );
+}
+
+function buildPreparationRecommendations(riskLevel: NormativeSeverity, lockIns: NormativeLockInItem[]) {
+  const recommendations: NormativePreparationRecommendation[] = [
+    {
+      title: "Crear un cuarto de guerra con checklists exhaustivos",
+      description:
+        "Asignar responsables por paquete documental y ejecutar doble revision de cada requisito antes de integrar la propuesta final.",
+      priority: "alta",
+    },
+    {
+      title: "Asegurar la carta de respaldo del fabricante (OEM)",
+      description:
+        "Gestionar respaldo oficial del fabricante para cubrir requisitos de distribuidor autorizado, garantias y despliegue tecnico.",
+      priority: lockIns.length > 0 ? "alta" : "media",
+    },
+    {
+      title: "Preparar una Junta de Aclaraciones estrategica",
+      description:
+        "Presentar preguntas puntuales sobre requisitos restrictivos y proponer alternativas tecnicas equivalentes para ampliar competencia.",
+      priority: riskLevel === "alto" ? "alta" : "media",
+    },
+    {
+      title: "Validacion financiera y de garantias por adelantado",
+      description:
+        "Tramitar con anticipacion garantias de seriedad y evidencia de capacidad financiera para evitar retrasos de ultimo momento.",
+      priority: "media",
+    },
+    {
+      title: "Enfoque en propuesta de valor y sostenibilidad",
+      description:
+        "Destacar certificaciones, cumplimiento tecnico y costo total de propiedad para fortalecer la evaluacion integral de la oferta.",
+      priority: "media",
+    },
+    {
+      title: "Documentar la solucion de software de gestion",
+      description:
+        "Alinear fichas tecnicas y evidencia funcional con cada punto del anexo tecnico para demostrar cumplimiento completo.",
+      priority: riskLevel === "alto" ? "alta" : "media",
+    },
+  ];
+
+  return recommendations;
+}
+
+function buildOfficialFormats(lines: string[]) {
+  const detected = lines
+    .filter((line) => formatPattern.test(line))
+    .map((line) => line.replace(/\.$/, "").trim())
+    .filter((line) => line.length >= 30);
+
+  const uniqueDetected = toUnique(detected, (item) => item.toLowerCase(), 20);
+
+  const countHintMatch = lines.join(" ").match(/\b(\d{1,2})\s+formatos?\b/i);
+  const hintedCount = countHintMatch ? Number.parseInt(countHintMatch[1], 10) : null;
+  const targetCount = hintedCount && Number.isFinite(hintedCount) ? clamp(hintedCount, 6, 20) : 13;
+
+  const merged = [...uniqueDetected];
+
+  for (const template of defaultFormatTemplates) {
+    if (merged.length >= targetCount) {
+      break;
+    }
+
+    if (!merged.some((item) => item.toLowerCase() === template.toLowerCase())) {
+      merged.push(template);
+    }
+  }
+
+  return merged.slice(0, targetCount);
+}
+
+function buildValueForMoney(lines: string[], viabilityScore: number, riskLevel: NormativeSeverity) {
+  const signals = toUnique(
+    lines.filter((line) => /\bcosto\b|\bprecio\b|\bcalidad\b|\beficiencia\b|\bgarantia\b|\bciclo de vida\b|\btotal\b/i.test(line)),
+    (line) => line.toLowerCase(),
+    6,
+  );
+
+  const actions = [
+    "Incluir costo total de propiedad (CAPEX + OPEX) con supuestos verificables.",
+    "Demostrar relacion calidad-precio con matriz comparativa y riesgos mitigados.",
+    "Presentar indicadores de eficiencia operativa y garantia de desempeno.",
+  ];
+
+  const signalBonus = Math.min(18, signals.length * 3);
+  const riskPenalty = riskLevel === "alto" ? 18 : riskLevel === "medio" ? 10 : 4;
+  const score = Math.round(clamp(viabilityScore + signalBonus - riskPenalty, 25, 96));
+
+  return {
+    score,
+    signals: signals.length > 0 ? signals : ["No se detectaron señales explicitas; se recomienda justificar costo total y eficiencia con evidencia."],
+    actions,
+  };
+}
+
+function buildCircularEconomy(lines: string[]) {
+  const signals = toUnique(
+    lines.filter((line) => /\bcircular\b|\brecicl|reutiliz|remanufact|residu|huella|emision|sustent|sostenib/i.test(line)),
+    (line) => line.toLowerCase(),
+    6,
+  );
+
+  if (signals.length === 0) {
+    return {
+      applicable: false,
+      signals: ["No se encontraron criterios ambientales explicitos en el texto analizado."],
+      actions: ["Agregar propuesta voluntaria de economia circular (reuso, reciclaje, disposicion responsable) para diferenciar oferta."],
+    };
+  }
+
+  return {
+    applicable: true,
+    signals,
+    actions: [
+      "Vincular criterios de reutilizacion/reciclaje con entregables y metrica de cumplimiento.",
+      "Incluir plan de manejo de residuos y evidencia documental de trazabilidad.",
+      "Cuantificar reduccion de impacto ambiental (energia, emisiones o materiales).",
+    ],
+  };
+}
+
+function buildSourceTraceability(args: {
+  documentType: NormativeDocumentType;
+  requiredChecklist: NormativeChecklistItem[];
+  criticalRequirements: NormativeCriticalItem[];
+  lockIns: NormativeLockInItem[];
+  officialFormats: string[];
+}): NormativeSourceTraceabilityItem[] {
+  const fields: string[] = [];
+  if (args.requiredChecklist.length > 0) {
+    fields.push("requiredChecklist");
+  }
+  if (args.criticalRequirements.length > 0) {
+    fields.push("criticalRequirements");
+  }
+  if (args.lockIns.length > 0) {
+    fields.push("lockIns");
+  }
+  if (args.officialFormats.length > 0) {
+    fields.push("officialFormats");
+  }
+
+  const sourceLabel =
+    args.documentType === "BASES_LICITACION"
+      ? "Bases"
+      : args.documentType === "CONVOCATORIA"
+        ? "Convocatoria"
+        : args.documentType === "ANEXOS"
+          ? "Anexos"
+        : args.documentType === "REGLAMENTO"
+          ? "Reglamento"
+          : args.documentType === "LEY"
+            ? "Ley"
+            : "Documento";
+
+  return [
+    {
+      documentType: args.documentType,
+      sourceLabel,
+      fields,
+    },
+  ];
+}
+
+function getConfidence(textLength: number, findingsCount: number) {
+  if (textLength >= 3500 && findingsCount >= 14) {
+    return "high" as const;
+  }
+
+  if (textLength >= 1200 && findingsCount >= 7) {
+    return "medium" as const;
+  }
+
+  return "low" as const;
+}
+
+function getRiskLevel(criticalRequirements: NormativeCriticalItem[], lockIns: NormativeLockInItem[]) {
+  const highCount = criticalRequirements.filter((item) => item.severity === "alto").length;
+  const mediumCount = criticalRequirements.filter((item) => item.severity === "medio").length;
+
+  if (highCount >= 3 || lockIns.length >= 3) {
+    return {
+      level: "alto" as const,
+      description: "Multiples requisitos complejos o restrictivos.",
+    };
+  }
+
+  if (highCount >= 1 || mediumCount >= 3 || lockIns.length >= 1) {
+    return {
+      level: "medio" as const,
+      description: "Existen requisitos sensibles que requieren preparacion anticipada.",
+    };
+  }
+
+  return {
+    level: "bajo" as const,
+    description: "No se detectan barreras criticas fuera de la preparacion documental normal.",
+  };
+}
+
+function getViability(requiredCount: number, criticalRequirements: NormativeCriticalItem[], lockIns: NormativeLockInItem[], confidence: "low" | "medium" | "high") {
+  const criticalHighCount = criticalRequirements.filter((item) => item.severity === "alto").length;
+  const criticalMediumCount = criticalRequirements.filter((item) => item.severity === "medio").length;
+
+  const confidencePenalty = confidence === "low" ? 8 : confidence === "medium" ? 3 : 0;
+  const requirementPenalty = Math.max(0, requiredCount - 8) * 1.8;
+  const criticalPenalty = criticalHighCount * 8 + criticalMediumCount * 3;
+  const lockInPenalty = lockIns.length * 6;
+
+  const score = Math.round(clamp(88 - confidencePenalty - requirementPenalty - criticalPenalty - lockInPenalty, 20, 95));
+
+  if (score >= 75) {
+    return {
+      score,
+      level: "alta" as const,
+      rationale: "Viabilidad favorable con una ruta de cumplimiento clara.",
+    };
+  }
+
+  if (score >= 55) {
+    return {
+      score,
+      level: "media" as const,
+      rationale: "Requiere preparacion adicional para reducir riesgo de descalificacion.",
+    };
+  }
+
+  return {
+    score,
+    level: "baja" as const,
+    rationale: "Riesgo elevado: se recomienda estrategia documental y legal reforzada antes de participar.",
+  };
+}
+
+export function analyzeNormativeText(input: NormativeAnalysisInput): NormativeAnalysisResult {
+  const cleaned = cleanText(input.text);
+  const lines = splitLines(cleaned);
+  const sentences = splitSentences(cleaned);
+
+  const requiredChecklist = buildRequiredChecklist(lines);
+  const criticalRequirements = buildCriticalRequirements(lines, requiredChecklist);
+  const lockIns = buildLockIns(lines, criticalRequirements);
+  const findingsCount = requiredChecklist.length + criticalRequirements.length + lockIns.length;
+  const confidence = getConfidence(cleaned.length, findingsCount);
+  const risk = getRiskLevel(criticalRequirements, lockIns);
+  const participationViability = getViability(requiredChecklist.length, criticalRequirements, lockIns, confidence);
+  const preparationRecommendations = buildPreparationRecommendations(risk.level, lockIns);
+  const officialFormats = buildOfficialFormats(lines);
+  const valueForMoney = buildValueForMoney(lines, participationViability.score, risk.level);
+  const circularEconomy = buildCircularEconomy(lines);
+  const sourceTraceability = buildSourceTraceability({
+    documentType: input.documentType,
+    requiredChecklist,
+    criticalRequirements,
+    lockIns,
+    officialFormats,
+  });
+  const executiveSummary = buildExecutiveSummary(sentences, input.documentType, requiredChecklist, criticalRequirements, lockIns);
+
+  return {
+    executiveSummary,
+    participationViability,
+    risk,
+    requiredChecklist,
+    criticalRequirements,
+    lockIns,
+    preparationRecommendations,
+    officialFormats,
+    valueForMoney,
+    circularEconomy,
+    sourceTraceability,
+    confidence,
+  };
+}
diff --git a/src/lib/normative-analysis/bundle.ts b/src/lib/normative-analysis/bundle.ts
new file mode 100644
index 0000000..3516c2f
--- /dev/null
+++ b/src/lib/normative-analysis/bundle.ts
@@ -0,0 +1,352 @@
+import type {
+  NormativeAnalysisResult,
+  NormativeCriticalItem,
+  NormativeDocumentType,
+  NormativeLockInItem,
+  NormativePreparationRecommendation,
+  NormativeChecklistItem,
+  NormativeSourceTraceabilityItem,
+} from "@/lib/normative-analysis/analyze";
+
+export type NormativeBundleSourceAnalysis = {
+  sourceId: string;
+  fileName: string;
+  documentType: NormativeDocumentType;
+  result: NormativeAnalysisResult;
+};
+
+export type NormativeBundleConflict = {
+  title: string;
+  field: "requiredChecklist" | "criticalRequirements" | "lockIns";
+  keptDocumentType: NormativeDocumentType;
+  replacedDocumentType: NormativeDocumentType;
+};
+
+export type NormativeBundleMergeResult = {
+  result: NormativeAnalysisResult;
+  sources: Array<{
+    sourceId: string;
+    fileName: string;
+    documentType: NormativeDocumentType;
+  }>;
+  conflicts: NormativeBundleConflict[];
+};
+
+function normalize(value: string) {
+  return value
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, " ")
+    .trim();
+}
+
+function docPriority(type: NormativeDocumentType) {
+  if (type === "BASES_LICITACION") {
+    return 5;
+  }
+
+  if (type === "CONVOCATORIA") {
+    return 4;
+  }
+
+  if (type === "ANEXOS") {
+    return 3;
+  }
+
+  if (type === "REGLAMENTO" || type === "LEY") {
+    return 2;
+  }
+
+  return 1;
+}
+
+function riskWeight(level: NormativeAnalysisResult["risk"]["level"]) {
+  if (level === "alto") {
+    return 3;
+  }
+
+  if (level === "medio") {
+    return 2;
+  }
+
+  return 1;
+}
+
+function dedupeList(items: string[], limit: number) {
+  const seen = new Set<string>();
+  const output: string[] = [];
+
+  for (const item of items) {
+    const normalized = normalize(item);
+    if (!normalized || seen.has(normalized)) {
+      continue;
+    }
+
+    seen.add(normalized);
+    output.push(item.trim());
+
+    if (output.length >= limit) {
+      break;
+    }
+  }
+
+  return output;
+}
+
+function mergeByTitle<TItem extends { title: string }>(args: {
+  field: "requiredChecklist" | "criticalRequirements" | "lockIns";
+  sources: NormativeBundleSourceAnalysis[];
+  readItems: (result: NormativeAnalysisResult) => TItem[];
+}): { items: TItem[]; conflicts: NormativeBundleConflict[] } {
+  const chosen = new Map<string, { item: TItem; documentType: NormativeDocumentType; priority: number }>();
+  const conflicts: NormativeBundleConflict[] = [];
+
+  for (const source of args.sources) {
+    const items = args.readItems(source.result);
+    const priority = docPriority(source.documentType);
+
+    for (const item of items) {
+      const signature = normalize(item.title);
+      if (!signature) {
+        continue;
+      }
+
+      const previous = chosen.get(signature);
+      if (!previous) {
+        chosen.set(signature, { item, documentType: source.documentType, priority });
+        continue;
+      }
+
+      if (priority > previous.priority) {
+        conflicts.push({
+          title: item.title,
+          field: args.field,
+          keptDocumentType: source.documentType,
+          replacedDocumentType: previous.documentType,
+        });
+        chosen.set(signature, { item, documentType: source.documentType, priority });
+      }
+    }
+  }
+
+  const items = Array.from(chosen.values())
+    .sort((left, right) => right.priority - left.priority)
+    .map((entry) => entry.item);
+
+  return {
+    items,
+    conflicts,
+  };
+}
+
+function toConfidence(rank: number): NormativeAnalysisResult["confidence"] {
+  if (rank >= 2.4) {
+    return "high";
+  }
+
+  if (rank >= 1.4) {
+    return "medium";
+  }
+
+  return "low";
+}
+
+function confidenceRank(value: NormativeAnalysisResult["confidence"]) {
+  if (value === "high") {
+    return 3;
+  }
+
+  if (value === "medium") {
+    return 2;
+  }
+
+  return 1;
+}
+
+function mergeExecutiveSummary(sources: NormativeBundleSourceAnalysis[]) {
+  const sorted = [...sources].sort((left, right) => docPriority(right.documentType) - docPriority(left.documentType));
+  const first = sorted[0];
+  if (!first) {
+    return "Sin analisis disponible.";
+  }
+
+  const suffix = sorted.length > 1 ? ` Se fusionaron ${sorted.length} documentos priorizando Bases.` : "";
+  return `${first.result.executiveSummary}${suffix}`.trim();
+}
+
+function mergeOfficialFormats(sources: NormativeBundleSourceAnalysis[]) {
+  const ordered = [...sources].sort((left, right) => docPriority(right.documentType) - docPriority(left.documentType));
+  const formats = ordered.flatMap((source) => source.result.officialFormats);
+  return dedupeList(formats, 30);
+}
+
+function mergePreparations(sources: NormativeBundleSourceAnalysis[]) {
+  const all: NormativePreparationRecommendation[] = [];
+  const seen = new Set<string>();
+
+  for (const source of sources) {
+    for (const item of source.result.preparationRecommendations) {
+      const signature = normalize(item.title);
+      if (!signature || seen.has(signature)) {
+        continue;
+      }
+      seen.add(signature);
+      all.push(item);
+    }
+  }
+
+  return all.slice(0, 12);
+}
+
+function mergeSourceTraceability(sources: NormativeBundleSourceAnalysis[]) {
+  const traceability: NormativeSourceTraceabilityItem[] = [];
+
+  for (const source of sources) {
+    const fromResult = source.result.sourceTraceability.map((item) => ({
+      ...item,
+      documentType: item.documentType,
+    }));
+
+    if (fromResult.length > 0) {
+      traceability.push(...fromResult);
+      continue;
+    }
+
+    traceability.push({
+      documentType: source.documentType,
+      sourceLabel: source.fileName,
+      fields: ["requiredChecklist", "criticalRequirements", "officialFormats"],
+    });
+  }
+
+  return traceability;
+}
+
+function mergeChecklist(sources: NormativeBundleSourceAnalysis[]) {
+  return mergeByTitle<NormativeChecklistItem>({
+    field: "requiredChecklist",
+    sources,
+    readItems: (result) => result.requiredChecklist,
+  });
+}
+
+function mergeCritical(sources: NormativeBundleSourceAnalysis[]) {
+  return mergeByTitle<NormativeCriticalItem>({
+    field: "criticalRequirements",
+    sources,
+    readItems: (result) => result.criticalRequirements,
+  });
+}
+
+function mergeLockIns(sources: NormativeBundleSourceAnalysis[]) {
+  return mergeByTitle<NormativeLockInItem>({
+    field: "lockIns",
+    sources,
+    readItems: (result) => result.lockIns,
+  });
+}
+
+export function mergeNormativeBundleSources(sources: NormativeBundleSourceAnalysis[]): NormativeBundleMergeResult {
+  if (sources.length === 0) {
+    const empty: NormativeAnalysisResult = {
+      executiveSummary: "Sin analisis disponible.",
+      participationViability: {
+        score: 0,
+        level: "baja",
+        rationale: "Sin datos para estimar viabilidad.",
+      },
+      risk: {
+        level: "alto",
+        description: "Sin datos para estimar riesgo.",
+      },
+      requiredChecklist: [],
+      criticalRequirements: [],
+      lockIns: [],
+      preparationRecommendations: [],
+      officialFormats: [],
+      valueForMoney: {
+        score: 0,
+        signals: [],
+        actions: [],
+      },
+      circularEconomy: {
+        applicable: false,
+        signals: [],
+        actions: [],
+      },
+      sourceTraceability: [],
+      confidence: "low",
+    };
+
+    return {
+      result: empty,
+      sources: [],
+      conflicts: [],
+    };
+  }
+
+  const viabilityWeighted = sources.reduce((sum, source) => sum + source.result.participationViability.score * docPriority(source.documentType), 0);
+  const viabilityWeightTotal = sources.reduce((sum, source) => sum + docPriority(source.documentType), 0);
+  const viabilityScore = Math.round(viabilityWeighted / Math.max(1, viabilityWeightTotal));
+
+  const highestRisk = sources
+    .map((source) => source.result.risk)
+    .sort((left, right) => riskWeight(right.level) - riskWeight(left.level))[0];
+
+  const confidenceAvg = sources.reduce((sum, source) => sum + confidenceRank(source.result.confidence), 0) / Math.max(1, sources.length);
+
+  const checklist = mergeChecklist(sources);
+  const critical = mergeCritical(sources);
+  const lockIns = mergeLockIns(sources);
+
+  const valueForMoneyScore = Math.round(
+    sources.reduce((sum, source) => sum + source.result.valueForMoney.score * docPriority(source.documentType), 0) / Math.max(1, viabilityWeightTotal),
+  );
+  const valueForMoneySignals = dedupeList(sources.flatMap((source) => source.result.valueForMoney.signals), 12);
+  const valueForMoneyActions = dedupeList(sources.flatMap((source) => source.result.valueForMoney.actions), 12);
+
+  const circularSignals = dedupeList(sources.flatMap((source) => source.result.circularEconomy.signals), 12);
+  const circularActions = dedupeList(sources.flatMap((source) => source.result.circularEconomy.actions), 12);
+  const circularApplicable = sources.some((source) => source.result.circularEconomy.applicable);
+
+  const mergedResult: NormativeAnalysisResult = {
+    executiveSummary: mergeExecutiveSummary(sources),
+    participationViability: {
+      score: viabilityScore,
+      level: viabilityScore >= 75 ? "alta" : viabilityScore >= 55 ? "media" : "baja",
+      rationale: "Resultado consolidado de bundle documental (Bases/Convocatoria/Anexos) con prioridad por fuente.",
+    },
+    risk: highestRisk ?? {
+      level: "alto",
+      description: "Sin datos",
+    },
+    requiredChecklist: checklist.items.slice(0, 30),
+    criticalRequirements: critical.items.slice(0, 15),
+    lockIns: lockIns.items.slice(0, 10),
+    preparationRecommendations: mergePreparations(sources),
+    officialFormats: mergeOfficialFormats(sources),
+    valueForMoney: {
+      score: valueForMoneyScore,
+      signals: valueForMoneySignals,
+      actions: valueForMoneyActions,
+    },
+    circularEconomy: {
+      applicable: circularApplicable,
+      signals: circularSignals,
+      actions: circularActions,
+    },
+    sourceTraceability: mergeSourceTraceability(sources),
+    confidence: toConfidence(confidenceAvg),
+  };
+
+  return {
+    result: mergedResult,
+    sources: sources.map((source) => ({
+      sourceId: source.sourceId,
+      fileName: source.fileName,
+      documentType: source.documentType,
+    })),
+    conflicts: [...checklist.conflicts, ...critical.conflicts, ...lockIns.conflicts],
+  };
+}
diff --git a/src/lib/normative-analysis/history.ts b/src/lib/normative-analysis/history.ts
new file mode 100644
index 0000000..4014000
--- /dev/null
+++ b/src/lib/normative-analysis/history.ts
@@ -0,0 +1,198 @@
+import type { NormativeAnalysisHistory } from "@prisma/client";
+import type { NormativeAnalysisResult } from "@/lib/normative-analysis/analyze";
+
+export type NormativeAnalysisHistoryView = {
+  id: string;
+  sourceLicitationId: string | null;
+  fileName: string;
+  documentType: "BASES_LICITACION" | "CONVOCATORIA" | "REGLAMENTO" | "LEY" | "OTRO";
+  issuingEntity: string | null;
+  methodUsed: "direct" | "ocr";
+  numPages: number;
+  warnings: string[];
+  extractedChars: number;
+  analyzedAt: string;
+  viabilityScore: number;
+  riskLevel: "alto" | "medio" | "bajo";
+  confidence: "low" | "medium" | "high";
+  result: NormativeAnalysisResult;
+};
+
+function parseWarnings(value: unknown) {
+  if (!Array.isArray(value)) {
+    return [] as string[];
+  }
+
+  return value.filter((item): item is string => typeof item === "string" && item.trim().length > 0);
+}
+
+function isObject(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+
+function parseResult(value: unknown): NormativeAnalysisResult {
+  if (!isObject(value)) {
+    return {
+      executiveSummary: "No fue posible recuperar el resultado del analisis.",
+      participationViability: {
+        score: 0,
+        level: "baja",
+        rationale: "Sin datos",
+      },
+      risk: {
+        level: "alto",
+        description: "Sin datos",
+      },
+      requiredChecklist: [],
+      criticalRequirements: [],
+      lockIns: [],
+      preparationRecommendations: [],
+      officialFormats: [],
+      valueForMoney: {
+        score: 0,
+        signals: [],
+        actions: [],
+      },
+      circularEconomy: {
+        applicable: false,
+        signals: [],
+        actions: [],
+      },
+      sourceTraceability: [],
+      confidence: "low",
+    };
+  }
+
+  const candidate = value as Partial<NormativeAnalysisResult>;
+
+  return {
+    executiveSummary: typeof candidate.executiveSummary === "string" ? candidate.executiveSummary : "Sin resumen disponible.",
+    participationViability:
+      candidate.participationViability && typeof candidate.participationViability === "object"
+        ? {
+            score:
+              typeof candidate.participationViability.score === "number"
+                ? Math.round(candidate.participationViability.score)
+                : 0,
+            level:
+              candidate.participationViability.level === "alta" ||
+              candidate.participationViability.level === "media" ||
+              candidate.participationViability.level === "baja"
+                ? candidate.participationViability.level
+                : "baja",
+            rationale:
+              typeof candidate.participationViability.rationale === "string" ? candidate.participationViability.rationale : "Sin detalle disponible.",
+          }
+        : {
+            score: 0,
+            level: "baja",
+            rationale: "Sin detalle disponible.",
+          },
+    risk:
+      candidate.risk && typeof candidate.risk === "object"
+        ? {
+            level: candidate.risk.level === "alto" || candidate.risk.level === "medio" || candidate.risk.level === "bajo" ? candidate.risk.level : "alto",
+            description: typeof candidate.risk.description === "string" ? candidate.risk.description : "Sin detalle disponible.",
+          }
+        : {
+            level: "alto",
+            description: "Sin detalle disponible.",
+          },
+    requiredChecklist: Array.isArray(candidate.requiredChecklist)
+      ? candidate.requiredChecklist.filter((item): item is NonNullable<NormativeAnalysisResult["requiredChecklist"]>[number] => {
+          return isObject(item) && typeof item.title === "string" && typeof item.description === "string";
+        })
+      : [],
+    criticalRequirements: Array.isArray(candidate.criticalRequirements)
+      ? candidate.criticalRequirements.filter((item): item is NonNullable<NormativeAnalysisResult["criticalRequirements"]>[number] => {
+          return (
+            isObject(item) &&
+            typeof item.title === "string" &&
+            typeof item.description === "string" &&
+            (item.severity === "alto" || item.severity === "medio" || item.severity === "bajo")
+          );
+        })
+      : [],
+    lockIns: Array.isArray(candidate.lockIns)
+      ? candidate.lockIns.filter((item): item is NonNullable<NormativeAnalysisResult["lockIns"]>[number] => {
+          return isObject(item) && typeof item.title === "string" && typeof item.impact === "string" && typeof item.recommendation === "string";
+        })
+      : [],
+    preparationRecommendations: Array.isArray(candidate.preparationRecommendations)
+      ? candidate.preparationRecommendations.filter((item): item is NonNullable<NormativeAnalysisResult["preparationRecommendations"]>[number] => {
+          return (
+            isObject(item) &&
+            typeof item.title === "string" &&
+            typeof item.description === "string" &&
+            (item.priority === "alta" || item.priority === "media" || item.priority === "baja")
+          );
+        })
+      : [],
+    officialFormats: Array.isArray(candidate.officialFormats)
+      ? candidate.officialFormats.filter((item): item is string => typeof item === "string")
+      : [],
+    valueForMoney:
+      candidate.valueForMoney && isObject(candidate.valueForMoney)
+        ? {
+            score: typeof candidate.valueForMoney.score === "number" ? Math.round(candidate.valueForMoney.score) : 0,
+            signals: Array.isArray(candidate.valueForMoney.signals)
+              ? candidate.valueForMoney.signals.filter((item): item is string => typeof item === "string" && item.trim().length > 0)
+              : [],
+            actions: Array.isArray(candidate.valueForMoney.actions)
+              ? candidate.valueForMoney.actions.filter((item): item is string => typeof item === "string" && item.trim().length > 0)
+              : [],
+          }
+        : {
+            score: 0,
+            signals: [],
+            actions: [],
+          },
+    circularEconomy:
+      candidate.circularEconomy && isObject(candidate.circularEconomy)
+        ? {
+            applicable: Boolean(candidate.circularEconomy.applicable),
+            signals: Array.isArray(candidate.circularEconomy.signals)
+              ? candidate.circularEconomy.signals.filter((item): item is string => typeof item === "string" && item.trim().length > 0)
+              : [],
+            actions: Array.isArray(candidate.circularEconomy.actions)
+              ? candidate.circularEconomy.actions.filter((item): item is string => typeof item === "string" && item.trim().length > 0)
+              : [],
+          }
+        : {
+            applicable: false,
+            signals: [],
+            actions: [],
+          },
+    sourceTraceability: Array.isArray(candidate.sourceTraceability)
+      ? candidate.sourceTraceability.filter((item): item is NonNullable<NormativeAnalysisResult["sourceTraceability"]>[number] => {
+          return (
+            isObject(item) &&
+            typeof item.documentType === "string" &&
+            typeof item.sourceLabel === "string" &&
+            Array.isArray(item.fields) &&
+            item.fields.every((field) => typeof field === "string")
+          );
+        })
+      : [],
+    confidence: candidate.confidence === "high" || candidate.confidence === "medium" || candidate.confidence === "low" ? candidate.confidence : "low",
+  };
+}
+
+export function toNormativeHistoryView(entry: Pick<NormativeAnalysisHistory, "id" | "sourceLicitationId" | "fileName" | "documentType" | "issuingEntity" | "methodUsed" | "numPages" | "warnings" | "extractedChars" | "analyzedAt" | "viabilityScore" | "riskLevel" | "confidence" | "result">): NormativeAnalysisHistoryView {
+  return {
+    id: entry.id,
+    sourceLicitationId: entry.sourceLicitationId,
+    fileName: entry.fileName,
+    documentType: entry.documentType,
+    issuingEntity: entry.issuingEntity,
+    methodUsed: entry.methodUsed === "OCR" ? "ocr" : "direct",
+    numPages: entry.numPages,
+    warnings: parseWarnings(entry.warnings),
+    extractedChars: entry.extractedChars,
+    analyzedAt: entry.analyzedAt.toISOString(),
+    viabilityScore: entry.viabilityScore,
+    riskLevel: entry.riskLevel === "ALTO" ? "alto" : entry.riskLevel === "MEDIO" ? "medio" : "bajo",
+    confidence: entry.confidence === "HIGH" ? "high" : entry.confidence === "MEDIUM" ? "medium" : "low",
+    result: parseResult(entry.result),
+  };
+}
diff --git a/src/lib/payments/mercadopago.ts b/src/lib/payments/mercadopago.ts
new file mode 100644
index 0000000..8dd0f71
--- /dev/null
+++ b/src/lib/payments/mercadopago.ts
@@ -0,0 +1,112 @@
+import "server-only";
+
+type MercadoPreferenceItem = {
+  id: string;
+  title: string;
+  quantity: number;
+  unit_price: number;
+  currency_id: string;
+};
+
+type CreatePreferenceInput = {
+  externalReference: string;
+  payerEmail: string;
+  items: MercadoPreferenceItem[];
+  successUrl: string;
+  failureUrl: string;
+  pendingUrl: string;
+  notificationUrl: string;
+};
+
+type MercadoPayment = {
+  id: number;
+  status: string;
+  external_reference?: string;
+  order?: {
+    id?: string;
+  };
+};
+
+const DEFAULT_MERCADO_API_BASE_URL = "https://api.mercadopago.com";
+
+function getMercadoApiBaseUrl() {
+  return (process.env.MP_API_BASE_URL?.trim() || process.env.MERCADO_PAGO_API_BASE_URL?.trim() || DEFAULT_MERCADO_API_BASE_URL).replace(/\/+$/, "");
+}
+
+export function getMercadoPagoAccessToken() {
+  return process.env.MP_ACCESS_TOKEN?.trim() || process.env.MERCADO_PAGO_ACCESS_TOKEN?.trim() || "";
+}
+
+export function hasMercadoPagoConfig() {
+  return Boolean(getMercadoPagoAccessToken());
+}
+
+function getHeaders(idempotencyKey?: string) {
+  const accessToken = getMercadoPagoAccessToken();
+
+  if (!accessToken) {
+    throw new Error("Mercado Pago access token is not configured.");
+  }
+
+  const headers: Record<string, string> = {
+    Authorization: `Bearer ${accessToken}`,
+    "Content-Type": "application/json",
+  };
+
+  if (idempotencyKey) {
+    headers["X-Idempotency-Key"] = idempotencyKey;
+  }
+
+  return headers;
+}
+
+export async function createMercadoPreference(input: CreatePreferenceInput) {
+  const response = await fetch(`${getMercadoApiBaseUrl()}/checkout/preferences`, {
+    method: "POST",
+    headers: getHeaders(input.externalReference),
+    body: JSON.stringify({
+      items: input.items,
+      payer: {
+        email: input.payerEmail,
+      },
+      external_reference: input.externalReference,
+      back_urls: {
+        success: input.successUrl,
+        failure: input.failureUrl,
+        pending: input.pendingUrl,
+      },
+      auto_return: "approved",
+      notification_url: input.notificationUrl,
+    }),
+    cache: "no-store",
+  });
+
+  const payload = (await response.json().catch(() => null)) as Record<string, unknown> | null;
+
+  if (!response.ok || !payload) {
+    throw new Error("No fue posible crear la preferencia en Mercado Pago.");
+  }
+
+  return {
+    id: typeof payload.id === "string" ? payload.id : "",
+    initPoint: typeof payload.init_point === "string" ? payload.init_point : "",
+    sandboxInitPoint: typeof payload.sandbox_init_point === "string" ? payload.sandbox_init_point : "",
+    rawPayload: payload,
+  };
+}
+
+export async function fetchMercadoPaymentById(paymentId: string) {
+  const response = await fetch(`${getMercadoApiBaseUrl()}/v1/payments/${encodeURIComponent(paymentId)}`, {
+    method: "GET",
+    headers: getHeaders(),
+    cache: "no-store",
+  });
+
+  const payload = (await response.json().catch(() => null)) as MercadoPayment | null;
+
+  if (!response.ok || !payload) {
+    throw new Error("No fue posible consultar el pago en Mercado Pago.");
+  }
+
+  return payload;
+}
diff --git a/src/lib/payments/plans.ts b/src/lib/payments/plans.ts
new file mode 100644
index 0000000..22a657e
--- /dev/null
+++ b/src/lib/payments/plans.ts
@@ -0,0 +1,70 @@
+import "server-only";
+
+import { ModulePlanKey } from "@prisma/client";
+
+export type PlanUiKey = "plan-1" | "plan-2" | "plan-3";
+
+type ModulePlanDefinition = {
+  key: ModulePlanKey;
+  uiKey: PlanUiKey;
+  name: string;
+  moduleStart: number;
+  moduleEnd: number;
+  monthlyPrice: number;
+  currency: string;
+  benefits: string;
+};
+
+export const MODULE_PLANS: ModulePlanDefinition[] = [
+  {
+    key: ModulePlanKey.PLAN_2_4,
+    uiKey: "plan-1",
+    name: "Plan 1",
+    moduleStart: 2,
+    moduleEnd: 4,
+    monthlyPrice: 499,
+    currency: "MXN",
+    benefits: "2 usuarios - 50 creditos IA",
+  },
+  {
+    key: ModulePlanKey.PLAN_5_7,
+    uiKey: "plan-2",
+    name: "Plan 2",
+    moduleStart: 5,
+    moduleEnd: 7,
+    monthlyPrice: 999,
+    currency: "MXN",
+    benefits: "5 usuarios - 150 creditos IA",
+  },
+  {
+    key: ModulePlanKey.PLAN_8_10,
+    uiKey: "plan-3",
+    name: "Plan 3",
+    moduleStart: 8,
+    moduleEnd: 10,
+    monthlyPrice: 1999,
+    currency: "MXN",
+    benefits: "Usuarios ilimitados - 500 creditos IA",
+  },
+];
+
+export const MODULE_PLAN_BY_KEY = new Map(MODULE_PLANS.map((item) => [item.key, item]));
+export const MODULE_PLAN_BY_UI_KEY = new Map(MODULE_PLANS.map((item) => [item.uiKey, item]));
+
+export function getModulePlanByUiKey(planKey: string) {
+  return MODULE_PLAN_BY_UI_KEY.get(planKey as PlanUiKey) ?? null;
+}
+
+export function getModulePlanByModuleNumber(moduleNumber: number) {
+  return MODULE_PLANS.find((plan) => moduleNumber >= plan.moduleStart && moduleNumber <= plan.moduleEnd) ?? null;
+}
+
+export function getPlanDescription(planKey: ModulePlanKey) {
+  const plan = MODULE_PLAN_BY_KEY.get(planKey);
+
+  if (!plan) {
+    return "Plan";
+  }
+
+  return `${plan.name} Modulos ${plan.moduleStart}-${plan.moduleEnd}`;
+}
diff --git a/src/lib/payments/subscriptions.ts b/src/lib/payments/subscriptions.ts
new file mode 100644
index 0000000..79fc297
--- /dev/null
+++ b/src/lib/payments/subscriptions.ts
@@ -0,0 +1,109 @@
+import "server-only";
+
+import { ModulePlanPurchaseStatus, type ModulePlanKey, type Prisma, type PrismaClient } from "@prisma/client";
+
+type PaymentSyncInput = {
+  externalReference: string;
+  paymentId: string;
+  paymentStatus: string;
+  mercadoOrderId?: string | null;
+  rawPayload?: unknown;
+};
+
+export function isApprovedPaymentStatus(status: string) {
+  return status.toLowerCase() === "approved";
+}
+
+function resolvePurchaseStatus(status: string) {
+  const normalized = status.toLowerCase();
+
+  if (normalized === "approved") {
+    return ModulePlanPurchaseStatus.APPROVED;
+  }
+
+  if (normalized === "rejected") {
+    return ModulePlanPurchaseStatus.REJECTED;
+  }
+
+  if (normalized === "cancelled") {
+    return ModulePlanPurchaseStatus.CANCELLED;
+  }
+
+  return ModulePlanPurchaseStatus.PENDING;
+}
+
+function getPlanDurationDays() {
+  const raw = process.env.MP_PLAN_DURATION_DAYS?.trim() || "30";
+  const parsed = Number(raw);
+
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    return 30;
+  }
+
+  return Math.floor(parsed);
+}
+
+function computePlanExpiration(from: Date) {
+  const expiration = new Date(from);
+  expiration.setDate(expiration.getDate() + getPlanDurationDays());
+  return expiration;
+}
+
+export async function syncPurchaseFromPayment(prisma: PrismaClient, input: PaymentSyncInput) {
+  const purchase = await prisma.modulePlanPurchase.findUnique({
+    where: { externalReference: input.externalReference },
+    select: {
+      id: true,
+      userId: true,
+      planKey: true,
+      status: true,
+    },
+  });
+
+  if (!purchase) {
+    return null;
+  }
+
+  const resolvedStatus = resolvePurchaseStatus(input.paymentStatus);
+  const now = new Date();
+
+  await prisma.modulePlanPurchase.update({
+    where: { id: purchase.id },
+    data: {
+      status: resolvedStatus,
+      mercadoPaymentId: input.paymentId,
+      mercadoOrderId: input.mercadoOrderId ?? undefined,
+      approvedAt: resolvedStatus === ModulePlanPurchaseStatus.APPROVED ? now : undefined,
+      responseJson: (input.rawPayload ?? {}) as Prisma.InputJsonValue,
+    },
+  });
+
+  if (!isApprovedPaymentStatus(input.paymentStatus)) {
+    return purchase;
+  }
+
+  await prisma.modulePlanSubscription.upsert({
+    where: {
+      userId_planKey: {
+        userId: purchase.userId,
+        planKey: purchase.planKey as ModulePlanKey,
+      },
+    },
+    update: {
+      sourcePurchaseId: purchase.id,
+      isActive: true,
+      startsAt: now,
+      expiresAt: computePlanExpiration(now),
+    },
+    create: {
+      userId: purchase.userId,
+      planKey: purchase.planKey as ModulePlanKey,
+      sourcePurchaseId: purchase.id,
+      isActive: true,
+      startsAt: now,
+      expiresAt: computePlanExpiration(now),
+    },
+  });
+
+  return purchase;
+}
diff --git a/src/lib/proposals/__tests__/status.test.ts b/src/lib/proposals/__tests__/status.test.ts
new file mode 100644
index 0000000..f67ce72
--- /dev/null
+++ b/src/lib/proposals/__tests__/status.test.ts
@@ -0,0 +1,24 @@
+import { describe, expect, it } from "vitest";
+import { canTransitionProposalStatus, getProposalStatusLabel, parseProposalStatus } from "@/lib/proposals/status";
+
+describe("proposal status", () => {
+  it("parses only valid statuses", () => {
+    expect(parseProposalStatus("DRAFT")).toBe("DRAFT");
+    expect(parseProposalStatus("SUBMITTED")).toBe("SUBMITTED");
+    expect(parseProposalStatus("INVALID")).toBeNull();
+  });
+
+  it("validates allowed transitions", () => {
+    expect(canTransitionProposalStatus("DRAFT", "IN_PROGRESS")).toBe(true);
+    expect(canTransitionProposalStatus("IN_PROGRESS", "SUBMITTED")).toBe(true);
+    expect(canTransitionProposalStatus("SUBMITTED", "DRAFT")).toBe(false);
+    expect(canTransitionProposalStatus("ARCHIVED", "DRAFT")).toBe(false);
+  });
+
+  it("returns spanish labels", () => {
+    expect(getProposalStatusLabel("DRAFT")).toBe("Borrador");
+    expect(getProposalStatusLabel("IN_PROGRESS")).toBe("En progreso");
+    expect(getProposalStatusLabel("SUBMITTED")).toBe("Enviada");
+    expect(getProposalStatusLabel("ARCHIVED")).toBe("Archivada");
+  });
+});
diff --git a/src/lib/proposals/__tests__/workflow-state.test.ts b/src/lib/proposals/__tests__/workflow-state.test.ts
new file mode 100644
index 0000000..086489c
--- /dev/null
+++ b/src/lib/proposals/__tests__/workflow-state.test.ts
@@ -0,0 +1,145 @@
+import { describe, expect, it } from "vitest";
+import { ProposalWorkflowStateSchema, computeWorkflowCompletionPercent, computeWorkflowGate } from "@/lib/proposals/workflow-state";
+
+function buildBaseWorkflow() {
+  return ProposalWorkflowStateSchema.parse({
+    step: 5,
+    info: {
+      title: "Licitacion de prueba",
+      issuingEntity: "Entidad contratante",
+      procedureType: "Publica",
+      jurisdiction: "Federal",
+      state: "Nuevo Leon",
+      municipality: "San Pedro",
+      sector: "Tecnologia",
+      description: "Servicio de arrendamiento",
+      convocatoriaUrl: "https://example.com/convocatoria",
+    },
+    requirements: [
+      {
+        id: "req-1",
+        title: "Formato I",
+        description: "Acreditacion de personalidad",
+        category: "legal",
+        mandatory: true,
+        source: "official_format",
+        status: "completed",
+        note: "",
+        evidences: [
+          {
+            id: "evidence-1",
+            documentId: "doc-1",
+            fileName: "formato-i.pdf",
+            uploadedAtIso: "2026-01-10T10:00:00.000Z",
+          },
+        ],
+      },
+      {
+        id: "req-2",
+        title: "Carta de fabricante",
+        description: "Documento tecnico",
+        category: "tecnico",
+        mandatory: true,
+        source: "required_checklist",
+        status: "completed",
+        note: "",
+        evidences: [
+          {
+            id: "evidence-2",
+            documentId: "doc-2",
+            fileName: "carta-fabricante.pdf",
+            uploadedAtIso: "2026-01-10T10:05:00.000Z",
+          },
+        ],
+      },
+    ],
+    technicalSections: [
+      {
+        id: "section-1",
+        title: "Propuesta tecnica",
+        description: "Detalle tecnico",
+        completed: true,
+      },
+    ],
+    economicItems: [
+      {
+        id: "eco-1",
+        concept: "Equipo de computo",
+        unit: "pieza",
+        quantity: 10,
+        unitPrice: 1000,
+      },
+    ],
+    milestones: [
+      {
+        id: "milestone-1",
+        title: "Presentacion de propuestas",
+        dateIso: "2026-11-30T20:00:00.000Z",
+        location: "Sala de juntas",
+        note: "",
+      },
+    ],
+    signatureCompliance: {
+      policyStatus: "condicionado",
+      policyName: "Politica estatal",
+      jurisdictionLabel: "Nuevo Leon",
+      sourceUrl: "https://www.nl.gob.mx/",
+      minimumEvidence: ["Clausula expresa en convocatoria", "Certificado de firma"],
+      notes: "",
+      validatedByLegal: true,
+    },
+    readyMarked: false,
+  });
+}
+
+describe("proposal workflow state", () => {
+  it("returns allReady true when every hard-gate condition is met", () => {
+    const workflow = buildBaseWorkflow();
+    const gate = computeWorkflowGate(workflow);
+
+    expect(gate.infoReady).toBe(true);
+    expect(gate.docsReady).toBe(true);
+    expect(gate.technicalReady).toBe(true);
+    expect(gate.economicReady).toBe(true);
+    expect(gate.datesReady).toBe(true);
+    expect(gate.signatureReady).toBe(true);
+    expect(gate.allReady).toBe(true);
+  });
+
+  it("blocks readiness when mandatory requirements remain pending", () => {
+    const workflow = buildBaseWorkflow();
+    workflow.requirements[0] = {
+      ...workflow.requirements[0],
+      status: "pending",
+    };
+
+    const gate = computeWorkflowGate(workflow);
+    expect(gate.docsReady).toBe(false);
+    expect(gate.allReady).toBe(false);
+  });
+
+  it("computes completion percentage from six-step gate states", () => {
+    const workflow = buildBaseWorkflow();
+    expect(computeWorkflowCompletionPercent(workflow)).toBe(100);
+
+    workflow.milestones[0] = {
+      ...workflow.milestones[0],
+      dateIso: null,
+    };
+
+    expect(computeWorkflowCompletionPercent(workflow)).toBe(67);
+  });
+
+  it("requires legal validation when signature policy is flagged as critical", () => {
+    const workflow = buildBaseWorkflow();
+    workflow.signatureCompliance = {
+      ...workflow.signatureCompliance,
+      policyStatus: "requiere_validacion_legal",
+      validatedByLegal: false,
+    };
+
+    const gate = computeWorkflowGate(workflow);
+    expect(gate.signatureReady).toBe(false);
+    expect(gate.allReady).toBe(false);
+  });
+});
diff --git a/src/lib/proposals/pdf.ts b/src/lib/proposals/pdf.ts
new file mode 100644
index 0000000..5f2f2a8
--- /dev/null
+++ b/src/lib/proposals/pdf.ts
@@ -0,0 +1,263 @@
+import "server-only";
+
+import { chromium } from "playwright";
+import type { ProposalWorkflowState } from "@/lib/proposals/workflow-state";
+
+export type ProposalPdfKind = "technical" | "economic" | "summary";
+
+export type ProposalPdfInput = {
+  kind: ProposalPdfKind;
+  proposal: {
+    title: string;
+    issuingEntity: string;
+    summary: string;
+    status: string;
+    currentStep: number;
+    completionPercent: number;
+    updatedAtIso: string;
+  };
+  workflow: ProposalWorkflowState;
+};
+
+function escapeHtml(value: string) {
+  return value
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;");
+}
+
+function formatDateTime(value: string) {
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return value;
+  }
+
+  return parsed.toLocaleString("es-MX", {
+    year: "numeric",
+    month: "long",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+}
+
+function formatCurrency(value: number) {
+  return value.toLocaleString("es-MX", {
+    style: "currency",
+    currency: "MXN",
+    maximumFractionDigits: 2,
+  });
+}
+
+function renderHeader(input: ProposalPdfInput) {
+  return `
+    <header class="header">
+      <h1>${escapeHtml(input.proposal.title)}</h1>
+      <p><strong>Entidad:</strong> ${escapeHtml(input.proposal.issuingEntity || "Por definir")}</p>
+      <p><strong>Estatus:</strong> ${escapeHtml(input.proposal.status)} · <strong>Progreso:</strong> ${input.proposal.completionPercent}%</p>
+      <p><strong>Actualizada:</strong> ${escapeHtml(formatDateTime(input.proposal.updatedAtIso))}</p>
+    </header>
+  `;
+}
+
+function renderTechnicalSections(input: ProposalPdfInput) {
+  const rows = input.workflow.technicalSections
+    .map((item, index) => {
+      return `
+        <tr>
+          <td>${index + 1}</td>
+          <td>${escapeHtml(item.title)}</td>
+          <td>${escapeHtml(item.description)}</td>
+          <td>${item.completed ? "Completada" : "Pendiente"}</td>
+        </tr>
+      `;
+    })
+    .join("");
+
+  return `
+    <section>
+      <h2>Propuesta Tecnica</h2>
+      <table>
+        <thead>
+          <tr>
+            <th>#</th>
+            <th>Seccion</th>
+            <th>Descripcion</th>
+            <th>Estatus</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${rows || '<tr><td colspan="4">Sin secciones registradas.</td></tr>'}
+        </tbody>
+      </table>
+    </section>
+  `;
+}
+
+function renderEconomicItems(input: ProposalPdfInput) {
+  const rows = input.workflow.economicItems
+    .map((item, index) => {
+      const lineTotal = item.quantity * item.unitPrice;
+      return `
+        <tr>
+          <td>${index + 1}</td>
+          <td>${escapeHtml(item.concept)}</td>
+          <td>${escapeHtml(item.unit)}</td>
+          <td>${item.quantity}</td>
+          <td>${formatCurrency(item.unitPrice)}</td>
+          <td>${formatCurrency(lineTotal)}</td>
+        </tr>
+      `;
+    })
+    .join("");
+
+  const subtotal = input.workflow.economicItems.reduce((acc, item) => acc + item.quantity * item.unitPrice, 0);
+  const iva = subtotal * 0.16;
+  const total = subtotal + iva;
+
+  return `
+    <section>
+      <h2>Propuesta Economica</h2>
+      <table>
+        <thead>
+          <tr>
+            <th>#</th>
+            <th>Concepto</th>
+            <th>Unidad</th>
+            <th>Cantidad</th>
+            <th>P. Unitario</th>
+            <th>Subtotal</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${rows || '<tr><td colspan="6">Sin conceptos registrados.</td></tr>'}
+        </tbody>
+      </table>
+
+      <div class="totals">
+        <p><span>Subtotal:</span> <strong>${formatCurrency(subtotal)}</strong></p>
+        <p><span>IVA (16%):</span> <strong>${formatCurrency(iva)}</strong></p>
+        <p><span>Total:</span> <strong>${formatCurrency(total)}</strong></p>
+      </div>
+    </section>
+  `;
+}
+
+function renderSummary(input: ProposalPdfInput) {
+  const requirements = input.workflow.requirements
+    .map((item) => `<li><strong>${escapeHtml(item.title)}</strong> — ${escapeHtml(item.status)}</li>`)
+    .join("");
+  const milestones = input.workflow.milestones
+    .map((item) => `<li><strong>${escapeHtml(item.title)}</strong> — ${escapeHtml(item.dateIso ? formatDateTime(item.dateIso) : "Sin fecha")}</li>`)
+    .join("");
+
+  return `
+    <section>
+      <h2>Resumen de la Licitacion</h2>
+      <p>${escapeHtml(input.workflow.info.description || input.proposal.summary || "Sin descripcion disponible.")}</p>
+      <p><strong>Tipo/Jurisdiccion:</strong> ${escapeHtml(input.workflow.info.procedureType)} · ${escapeHtml(input.workflow.info.jurisdiction)}</p>
+      <p><strong>Ubicacion:</strong> ${escapeHtml(input.workflow.info.state)} · ${escapeHtml(input.workflow.info.municipality)}</p>
+    </section>
+
+    <section>
+      <h3>Checklist</h3>
+      <ul>${requirements || "<li>Sin requisitos registrados.</li>"}</ul>
+    </section>
+
+    <section>
+      <h3>Fechas importantes</h3>
+      <ul>${milestones || "<li>Sin fechas registradas.</li>"}</ul>
+    </section>
+  `;
+}
+
+function renderBody(input: ProposalPdfInput) {
+  if (input.kind === "technical") {
+    return renderTechnicalSections(input);
+  }
+
+  if (input.kind === "economic") {
+    return renderEconomicItems(input);
+  }
+
+  return renderSummary(input);
+}
+
+function renderHtml(input: ProposalPdfInput) {
+  const title =
+    input.kind === "technical"
+      ? "PDF - Propuesta Tecnica"
+      : input.kind === "economic"
+        ? "PDF - Propuesta Economica"
+        : "PDF - Resumen de Licitacion";
+
+  return `
+    <!doctype html>
+    <html lang="es">
+      <head>
+        <meta charset="utf-8" />
+        <title>${escapeHtml(title)}</title>
+        <style>
+          * { box-sizing: border-box; }
+          body { font-family: Arial, sans-serif; color: #1c2b46; margin: 0; padding: 30px; font-size: 12px; }
+          h1 { font-size: 24px; margin: 0 0 8px; }
+          h2 { font-size: 18px; margin: 20px 0 10px; }
+          h3 { font-size: 14px; margin: 16px 0 8px; }
+          p { margin: 4px 0; line-height: 1.4; }
+          .header { border-bottom: 1px solid #d6deeb; padding-bottom: 10px; }
+          table { width: 100%; border-collapse: collapse; margin-top: 8px; }
+          th, td { border: 1px solid #d6deeb; padding: 8px; vertical-align: top; text-align: left; }
+          thead th { background: #eef2f8; }
+          .totals { margin-top: 12px; width: 280px; margin-left: auto; }
+          .totals p { display: flex; justify-content: space-between; }
+          ul { margin: 8px 0 0 18px; padding: 0; }
+          li { margin: 4px 0; }
+        </style>
+      </head>
+      <body>
+        ${renderHeader(input)}
+        ${renderBody(input)}
+      </body>
+    </html>
+  `;
+}
+
+export function buildPdfFilename(args: { kind: ProposalPdfKind; title: string }) {
+  const suffix = args.kind === "technical" ? "propuesta-tecnica" : args.kind === "economic" ? "propuesta-economica" : "resumen-licitacion";
+  const safeTitle =
+    args.title
+      .trim()
+      .toLowerCase()
+      .replace(/[^a-z0-9]+/g, "-")
+      .replace(/^-+|-+$/g, "") || "propuesta";
+
+  return `${safeTitle}-${suffix}.pdf`;
+}
+
+export async function generateProposalPdf(input: ProposalPdfInput) {
+  const browser = await chromium.launch({
+    headless: true,
+  });
+
+  try {
+    const page = await browser.newPage();
+    await page.setContent(renderHtml(input), { waitUntil: "load" });
+    const buffer = await page.pdf({
+      format: "A4",
+      printBackground: true,
+      margin: {
+        top: "16mm",
+        right: "12mm",
+        bottom: "16mm",
+        left: "12mm",
+      },
+    });
+
+    return buffer;
+  } finally {
+    await browser.close();
+  }
+}
+
diff --git a/src/lib/proposals/server.ts b/src/lib/proposals/server.ts
new file mode 100644
index 0000000..159e4c9
--- /dev/null
+++ b/src/lib/proposals/server.ts
@@ -0,0 +1,158 @@
+import "server-only";
+
+import { Prisma, type ProposalStatus } from "@prisma/client";
+import { prisma } from "@/lib/prisma";
+import type { ProposalDocumentView, ProposalView } from "@/lib/proposals/types";
+
+type ProposalDocumentRecord = {
+  id: string;
+  fileName: string;
+  mimeType: string;
+  sizeBytes: number;
+  createdAt: Date;
+};
+
+type ProposalWithProgress = {
+  id: string;
+  title: string;
+  issuingEntity: string;
+  summary: string;
+  currentStep: number;
+  completionPercent: number;
+  readyForSubmissionAt: Date | null;
+  status: ProposalStatus;
+  sourceLicitationId: string | null;
+  createdAt: Date;
+  updatedAt: Date;
+  documents: ProposalDocumentRecord[];
+};
+
+type LegacyProposal = Omit<ProposalWithProgress, "currentStep" | "completionPercent" | "readyForSubmissionAt">;
+
+function isLegacyWorkflowSchemaError(error: unknown) {
+  return error instanceof Prisma.PrismaClientKnownRequestError && (error.code === "P2021" || error.code === "P2022");
+}
+
+function toDocumentView(document: ProposalDocumentRecord): ProposalDocumentView {
+  return {
+    id: document.id,
+    fileName: document.fileName,
+    mimeType: document.mimeType,
+    sizeBytes: document.sizeBytes,
+    createdAt: document.createdAt.toISOString(),
+  };
+}
+
+function toProposalView(item: ProposalWithProgress): ProposalView {
+  return {
+    id: item.id,
+    title: item.title,
+    issuingEntity: item.issuingEntity,
+    summary: item.summary,
+    currentStep: item.currentStep,
+    completionPercent: item.completionPercent,
+    readyForSubmissionAt: item.readyForSubmissionAt ? item.readyForSubmissionAt.toISOString() : null,
+    status: item.status,
+    sourceLicitationId: item.sourceLicitationId,
+    createdAt: item.createdAt.toISOString(),
+    updatedAt: item.updatedAt.toISOString(),
+    documents: item.documents.map(toDocumentView),
+  };
+}
+
+function toLegacyProposalView(item: LegacyProposal): ProposalView {
+  return {
+    id: item.id,
+    title: item.title,
+    issuingEntity: item.issuingEntity,
+    summary: item.summary,
+    currentStep: 1,
+    completionPercent: 0,
+    readyForSubmissionAt: null,
+    status: item.status,
+    sourceLicitationId: item.sourceLicitationId,
+    createdAt: item.createdAt.toISOString(),
+    updatedAt: item.updatedAt.toISOString(),
+    documents: item.documents.map(toDocumentView),
+  };
+}
+
+export async function listUserProposals(userId: string, search: string) {
+  const normalized = search.trim();
+  const where = {
+    userId,
+    ...(normalized
+      ? {
+          OR: [
+            { title: { contains: normalized, mode: "insensitive" as const } },
+            { issuingEntity: { contains: normalized, mode: "insensitive" as const } },
+            { summary: { contains: normalized, mode: "insensitive" as const } },
+          ],
+        }
+      : {}),
+  };
+  const orderBy = [{ updatedAt: "desc" as const }, { createdAt: "desc" as const }];
+
+  try {
+    const rows = await prisma.proposal.findMany({
+      where,
+      orderBy,
+      select: {
+        id: true,
+        title: true,
+        issuingEntity: true,
+        summary: true,
+        currentStep: true,
+        completionPercent: true,
+        readyForSubmissionAt: true,
+        status: true,
+        sourceLicitationId: true,
+        createdAt: true,
+        updatedAt: true,
+        documents: {
+          orderBy: [{ createdAt: "desc" }],
+          select: {
+            id: true,
+            fileName: true,
+            mimeType: true,
+            sizeBytes: true,
+            createdAt: true,
+          },
+        },
+      },
+    });
+
+    return rows.map(toProposalView);
+  } catch (error) {
+    if (!isLegacyWorkflowSchemaError(error)) {
+      throw error;
+    }
+
+    const rows = await prisma.proposal.findMany({
+      where,
+      orderBy,
+      select: {
+        id: true,
+        title: true,
+        issuingEntity: true,
+        summary: true,
+        status: true,
+        sourceLicitationId: true,
+        createdAt: true,
+        updatedAt: true,
+        documents: {
+          orderBy: [{ createdAt: "desc" }],
+          select: {
+            id: true,
+            fileName: true,
+            mimeType: true,
+            sizeBytes: true,
+            createdAt: true,
+          },
+        },
+      },
+    });
+
+    return rows.map(toLegacyProposalView);
+  }
+}
diff --git a/src/lib/proposals/status.ts b/src/lib/proposals/status.ts
new file mode 100644
index 0000000..21fc107
--- /dev/null
+++ b/src/lib/proposals/status.ts
@@ -0,0 +1,40 @@
+export type ProposalStatusValue = "DRAFT" | "IN_PROGRESS" | "SUBMITTED" | "ARCHIVED";
+
+const ALLOWED_TRANSITIONS: Record<ProposalStatusValue, ProposalStatusValue[]> = {
+  DRAFT: ["IN_PROGRESS", "ARCHIVED"],
+  IN_PROGRESS: ["SUBMITTED", "ARCHIVED"],
+  SUBMITTED: ["ARCHIVED"],
+  ARCHIVED: [],
+};
+
+export function parseProposalStatus(value: unknown): ProposalStatusValue | null {
+  if (value === "DRAFT" || value === "IN_PROGRESS" || value === "SUBMITTED" || value === "ARCHIVED") {
+    return value;
+  }
+
+  return null;
+}
+
+export function canTransitionProposalStatus(from: ProposalStatusValue, to: ProposalStatusValue) {
+  if (from === to) {
+    return true;
+  }
+
+  return ALLOWED_TRANSITIONS[from].includes(to);
+}
+
+export function getProposalStatusLabel(status: ProposalStatusValue) {
+  if (status === "DRAFT") {
+    return "Borrador";
+  }
+
+  if (status === "IN_PROGRESS") {
+    return "En progreso";
+  }
+
+  if (status === "SUBMITTED") {
+    return "Enviada";
+  }
+
+  return "Archivada";
+}
diff --git a/src/lib/proposals/storage.ts b/src/lib/proposals/storage.ts
new file mode 100644
index 0000000..3a8eec7
--- /dev/null
+++ b/src/lib/proposals/storage.ts
@@ -0,0 +1,117 @@
+import "server-only";
+
+import { createHash, randomUUID } from "node:crypto";
+import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+export const MAX_PROPOSAL_DOCUMENT_BYTES = 20 * 1024 * 1024;
+
+const PROPOSAL_STORAGE_ROOT = path.join(process.cwd(), "storage", "proposals");
+
+const EXTENSION_BY_MIME: Record<string, string> = {
+  "application/pdf": "pdf",
+  "application/msword": "doc",
+  "application/vnd.openxmlformats-officedocument.wordprocessingml.document": "docx",
+  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "xlsx",
+  "image/jpeg": "jpg",
+  "image/png": "png",
+};
+
+export function isAllowedProposalMimeType(mimeType: string) {
+  return mimeType in EXTENSION_BY_MIME;
+}
+
+function normalizeExtension(fileName: string, mimeType: string) {
+  const fromMime = EXTENSION_BY_MIME[mimeType] ?? "";
+  const fromName = fileName.includes(".") ? fileName.split(".").pop()?.toLowerCase() ?? "" : "";
+  return fromMime || fromName || "bin";
+}
+
+function sanitizeFileName(fileName: string, extension: string) {
+  const withoutExtension = fileName.replace(/\.[^/.]+$/, "");
+  const safeBase = withoutExtension.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-") || "document";
+  const safeExtension = extension.replace(/[^a-z0-9]+/g, "") || "bin";
+  return `${safeBase}.${safeExtension}`;
+}
+
+export type StoredProposalDocument = {
+  fileName: string;
+  storedFileName: string;
+  filePath: string;
+  mimeType: string;
+  sizeBytes: number;
+  checksumSha256: string;
+};
+
+export async function storeProposalDocument(userId: string, proposalId: string, originalFileName: string, mimeType: string, buffer: Buffer) {
+  const extension = normalizeExtension(originalFileName, mimeType);
+  const safeOriginalName = sanitizeFileName(originalFileName, extension);
+  const targetDirectory = path.join(PROPOSAL_STORAGE_ROOT, userId, proposalId);
+  const storedFileName = `${Date.now()}-${randomUUID()}.${extension}`;
+  const absolutePath = path.join(targetDirectory, storedFileName);
+
+  await mkdir(targetDirectory, { recursive: true });
+  await writeFile(absolutePath, buffer);
+
+  return {
+    fileName: safeOriginalName,
+    storedFileName,
+    filePath: path.join("storage", "proposals", userId, proposalId, storedFileName).replace(/\\/g, "/"),
+    mimeType,
+    sizeBytes: buffer.byteLength,
+    checksumSha256: createHash("sha256").update(buffer).digest("hex"),
+  } satisfies StoredProposalDocument;
+}
+
+export async function removeStoredProposalDocument(relativeFilePath: string | null | undefined) {
+  if (!relativeFilePath) {
+    return;
+  }
+
+  const storageRoot = path.resolve(process.cwd(), "storage");
+  const absolutePath = path.resolve(process.cwd(), relativeFilePath);
+
+  if (!absolutePath.startsWith(`${storageRoot}${path.sep}`)) {
+    return;
+  }
+
+  try {
+    await unlink(absolutePath);
+  } catch {
+    // Ignore delete errors.
+  }
+}
+
+export async function readStoredProposalDocument(relativeFilePath: string, maxBytes = MAX_PROPOSAL_DOCUMENT_BYTES) {
+  const storageRoot = path.resolve(process.cwd(), "storage");
+  const absolutePath = path.resolve(process.cwd(), relativeFilePath);
+
+  if (!absolutePath.startsWith(`${storageRoot}${path.sep}`)) {
+    throw new Error("PROPOSAL_DOCUMENT_INVALID_PATH");
+  }
+
+  try {
+    const buffer = await readFile(absolutePath);
+
+    if (!buffer.byteLength) {
+      throw new Error("PROPOSAL_DOCUMENT_EMPTY");
+    }
+
+    if (buffer.byteLength > maxBytes) {
+      throw new Error("PROPOSAL_DOCUMENT_TOO_LARGE");
+    }
+
+    return buffer;
+  } catch (error) {
+    if (
+      error &&
+      typeof error === "object" &&
+      "code" in error &&
+      (error as NodeJS.ErrnoException).code === "ENOENT"
+    ) {
+      throw new Error("PROPOSAL_DOCUMENT_NOT_FOUND");
+    }
+
+    throw error;
+  }
+}
diff --git a/src/lib/proposals/types.ts b/src/lib/proposals/types.ts
new file mode 100644
index 0000000..d979638
--- /dev/null
+++ b/src/lib/proposals/types.ts
@@ -0,0 +1,28 @@
+import type { ProposalStatus } from "@prisma/client";
+
+export type ProposalDocumentView = {
+  id: string;
+  fileName: string;
+  mimeType: string;
+  sizeBytes: number;
+  createdAt: string;
+};
+
+export type ProposalView = {
+  id: string;
+  title: string;
+  issuingEntity: string;
+  summary: string;
+  currentStep: number;
+  completionPercent: number;
+  readyForSubmissionAt: string | null;
+  status: ProposalStatus;
+  sourceLicitationId: string | null;
+  createdAt: string;
+  updatedAt: string;
+  documents: ProposalDocumentView[];
+};
+
+export type ProposalListPayload = {
+  proposals: ProposalView[];
+};
diff --git a/src/lib/proposals/workflow-default.ts b/src/lib/proposals/workflow-default.ts
new file mode 100644
index 0000000..18eacbb
--- /dev/null
+++ b/src/lib/proposals/workflow-default.ts
@@ -0,0 +1,117 @@
+import type { WorkflowMilestoneSeed, WorkflowRequirementSeed, WorkflowTechnicalSectionSeed } from "@/lib/proposals/workflow";
+import type { ProposalWorkflowState } from "@/lib/proposals/workflow-state";
+import { evaluateSignaturePolicy } from "@/lib/compliance/signature-policy";
+
+function toProcedureTypeLabel(value: string | null | undefined) {
+  if (value === "LICITACION_PUBLICA") {
+    return "Publica";
+  }
+
+  if (value === "INVITACION_RESTRINGIDA") {
+    return "Invitacion restringida";
+  }
+
+  if (value === "ADJUDICACION_DIRECTA") {
+    return "Adjudicacion directa";
+  }
+
+  return "Por definir";
+}
+
+export function buildDefaultWorkflowDraft(args: {
+  proposal: {
+    title: string;
+    issuingEntity: string;
+    summary: string;
+    status: "DRAFT" | "IN_PROGRESS" | "SUBMITTED" | "ARCHIVED";
+  };
+  linkedSource?: {
+    title: string;
+    description: string | null;
+    issuingEntity: string | null;
+    procedureType: string | null;
+    stateName: string;
+    municipalityName: string;
+    sourceUrl: string | null;
+    milestones: WorkflowMilestoneSeed[];
+  } | null;
+  requirementSeeds?: WorkflowRequirementSeed[];
+  technicalSectionSeeds?: WorkflowTechnicalSectionSeed[];
+}): ProposalWorkflowState {
+  const requirementSeeds = args.requirementSeeds ?? [];
+  const technicalSectionSeeds = args.technicalSectionSeeds ?? [];
+  const linkedSource = args.linkedSource ?? null;
+  const signaturePolicy = evaluateSignaturePolicy({
+    stateName: linkedSource?.stateName ?? null,
+    municipalityName: linkedSource?.municipalityName ?? null,
+    documentType: "BASES_LICITACION",
+  });
+
+  const requirements: ProposalWorkflowState["requirements"] = requirementSeeds.map((seed) => ({
+    ...seed,
+    status: "pending",
+    note: "",
+    evidences: [],
+  }));
+
+  const technicalSections: ProposalWorkflowState["technicalSections"] =
+    technicalSectionSeeds.length > 0
+      ? technicalSectionSeeds.map((seed) => ({
+          id: seed.id,
+          title: seed.title,
+          description: seed.description,
+          completed: false,
+        }))
+      : [
+          {
+            id: "section-default-1",
+            title: "Documentacion Legal y Administrativa",
+            description: "Completa y valida los formatos requeridos por la convocatoria.",
+            completed: false,
+          },
+          {
+            id: "section-default-2",
+            title: "Propuesta Tecnica Detallada",
+            description: "Describe alcance, metodologia y cumplimiento de especificaciones.",
+            completed: false,
+          },
+          {
+            id: "section-default-3",
+            title: "Acreditacion de Experiencia y Capacidad Tecnica",
+            description: "Integra cartas, certificaciones y evidencia tecnica del equipo.",
+            completed: false,
+          },
+        ];
+
+  return {
+    step: 1,
+    info: {
+      title: args.proposal.title || linkedSource?.title || "",
+      issuingEntity: args.proposal.issuingEntity || linkedSource?.issuingEntity || "",
+      procedureType: toProcedureTypeLabel(linkedSource?.procedureType),
+      jurisdiction: linkedSource ? "Federal / Estatal" : "Por definir",
+      state: linkedSource?.stateName ?? "",
+      municipality: linkedSource?.municipalityName ?? "",
+      sector: "",
+      description: linkedSource?.description || args.proposal.summary || "",
+      convocatoriaUrl: linkedSource?.sourceUrl ?? "",
+    },
+    requirements,
+    technicalSections,
+    economicItems: [],
+    milestones: (linkedSource?.milestones ?? []).map((item) => ({
+      ...item,
+      source: item.source ?? "licitation",
+    })),
+    signatureCompliance: {
+      policyStatus: signaturePolicy.policyStatus,
+      policyName: signaturePolicy.policyName,
+      jurisdictionLabel: signaturePolicy.jurisdictionLabel,
+      sourceUrl: signaturePolicy.sourceUrl ?? "",
+      minimumEvidence: signaturePolicy.evidenceRequired,
+      notes: signaturePolicy.notes,
+      validatedByLegal: false,
+    },
+    readyMarked: args.proposal.status === "SUBMITTED",
+  };
+}
diff --git a/src/lib/proposals/workflow-state.ts b/src/lib/proposals/workflow-state.ts
new file mode 100644
index 0000000..a67a462
--- /dev/null
+++ b/src/lib/proposals/workflow-state.ts
@@ -0,0 +1,139 @@
+import { z } from "zod";
+
+export const WorkflowRequirementStatusSchema = z.enum(["pending", "completed", "na"]);
+
+export const WorkflowRequirementEvidenceStateSchema = z.object({
+  id: z.string().min(1).max(220),
+  documentId: z.string().min(1).max(220),
+  fileName: z.string().min(1).max(500),
+  uploadedAtIso: z.string().datetime({ offset: true }),
+});
+
+export const WorkflowRequirementStateSchema = z.object({
+  id: z.string().min(1).max(220),
+  title: z.string().min(1).max(500),
+  description: z.string().min(1).max(2500),
+  category: z.enum(["administrativo", "legal", "tecnico", "economico", "general"]),
+  mandatory: z.boolean(),
+  source: z.enum(["official_format", "required_checklist", "critical_requirement", "lock_in"]),
+  status: WorkflowRequirementStatusSchema,
+  note: z.string().max(1200),
+  evidences: z.array(WorkflowRequirementEvidenceStateSchema).max(50).default([]),
+});
+
+export const WorkflowMilestoneSourceSchema = z.enum(["ai", "licitation", "manual"]);
+
+export const WorkflowTechnicalSectionStateSchema = z.object({
+  id: z.string().min(1).max(220),
+  title: z.string().min(1).max(500),
+  description: z.string().min(1).max(2500),
+  completed: z.boolean(),
+});
+
+export const WorkflowEconomicItemStateSchema = z.object({
+  id: z.string().min(1).max(220),
+  concept: z.string().max(500),
+  unit: z.string().max(120),
+  quantity: z.number().finite().min(0).max(1_000_000),
+  unitPrice: z.number().finite().min(0).max(1_000_000_000),
+});
+
+export const WorkflowMilestoneStateSchema = z.object({
+  id: z.string().min(1).max(220),
+  title: z.string().min(1).max(500),
+  dateIso: z.string().datetime({ offset: true }).nullable(),
+  location: z.string().max(800),
+  note: z.string().max(1200),
+  source: WorkflowMilestoneSourceSchema.default("manual"),
+});
+
+export const WorkflowSignatureComplianceStateSchema = z.object({
+  policyStatus: z.enum(["permitido", "condicionado", "requiere_validacion_legal"]).default("requiere_validacion_legal"),
+  policyName: z.string().max(320).default("Sin politica definida"),
+  jurisdictionLabel: z.string().max(220).default("Jurisdiccion no definida"),
+  sourceUrl: z.string().max(2000).default(""),
+  minimumEvidence: z.array(z.string().max(400)).max(20).default([]),
+  notes: z.string().max(1600).default(""),
+  validatedByLegal: z.boolean().default(false),
+});
+
+export const ProposalWorkflowStateSchema = z.object({
+  step: z.number().int().min(1).max(6),
+  info: z.object({
+    title: z.string().max(500),
+    issuingEntity: z.string().max(500),
+    procedureType: z.string().max(200),
+    jurisdiction: z.string().max(200),
+    state: z.string().max(200),
+    municipality: z.string().max(200),
+    sector: z.string().max(200),
+    description: z.string().max(5000),
+    convocatoriaUrl: z.string().max(2000),
+  }),
+  requirements: z.array(WorkflowRequirementStateSchema).max(500),
+  technicalSections: z.array(WorkflowTechnicalSectionStateSchema).max(200),
+  economicItems: z.array(WorkflowEconomicItemStateSchema).max(2000),
+  milestones: z.array(WorkflowMilestoneStateSchema).max(500),
+  signatureCompliance: WorkflowSignatureComplianceStateSchema.default({
+    policyStatus: "requiere_validacion_legal",
+    policyName: "Sin politica definida",
+    jurisdictionLabel: "Jurisdiccion no definida",
+    sourceUrl: "",
+    minimumEvidence: [],
+    notes: "",
+    validatedByLegal: false,
+  }),
+  readyMarked: z.boolean(),
+});
+
+export type ProposalWorkflowState = z.infer<typeof ProposalWorkflowStateSchema>;
+export type WorkflowRequirementState = z.infer<typeof WorkflowRequirementStateSchema>;
+
+export type ProposalWorkflowGate = {
+  mandatoryCount: number;
+  resolvedCount: number;
+  docsReady: boolean;
+  technicalReady: boolean;
+  economicReady: boolean;
+  datesReady: boolean;
+  signatureReady: boolean;
+  infoReady: boolean;
+  allReady: boolean;
+};
+
+export function clampWorkflowStep(value: number) {
+  return Math.max(1, Math.min(6, Math.round(value)));
+}
+
+export function computeWorkflowGate(workflow: ProposalWorkflowState): ProposalWorkflowGate {
+  const mandatoryRequirements = workflow.requirements.filter((item) => item.mandatory);
+  const resolvedRequirements = mandatoryRequirements.filter((item) => item.status !== "pending" && (item.status === "na" || item.evidences.length > 0)).length;
+  const docsReady = mandatoryRequirements.length > 0 && resolvedRequirements === mandatoryRequirements.length;
+
+  const technicalReady = workflow.technicalSections.length > 0 && workflow.technicalSections.every((item) => item.completed);
+  const economicReady =
+    workflow.economicItems.length > 0 &&
+    workflow.economicItems.every((item) => item.concept.trim().length > 0 && item.quantity > 0 && item.unitPrice >= 0);
+  const datesReady = workflow.milestones.length > 0 && workflow.milestones.every((item) => Boolean(item.dateIso));
+  const signatureReady =
+    workflow.signatureCompliance.policyStatus !== "requiere_validacion_legal" || workflow.signatureCompliance.validatedByLegal;
+  const infoReady = workflow.info.title.trim().length > 0 && workflow.info.issuingEntity.trim().length > 0;
+
+  return {
+    mandatoryCount: mandatoryRequirements.length,
+    resolvedCount: resolvedRequirements,
+    docsReady,
+    technicalReady,
+    economicReady,
+    datesReady,
+    signatureReady,
+    infoReady,
+    allReady: docsReady && technicalReady && economicReady && datesReady && signatureReady && infoReady,
+  };
+}
+
+export function computeWorkflowCompletionPercent(workflow: ProposalWorkflowState) {
+  const gate = computeWorkflowGate(workflow);
+  const stepCompletion = [gate.infoReady, gate.docsReady, gate.technicalReady, gate.economicReady, gate.allReady, gate.datesReady];
+  return Math.round((stepCompletion.filter(Boolean).length / 6) * 100);
+}
diff --git a/src/lib/proposals/workflow.ts b/src/lib/proposals/workflow.ts
new file mode 100644
index 0000000..7bf6d94
--- /dev/null
+++ b/src/lib/proposals/workflow.ts
@@ -0,0 +1,510 @@
+import type { NormativeAnalysisResult } from "@/lib/normative-analysis/analyze";
+import type { ProposalWorkflowState } from "@/lib/proposals/workflow-state";
+
+export type WorkflowRequirementCategory = "administrativo" | "legal" | "tecnico" | "economico" | "general";
+export type WorkflowRequirementSource = "official_format" | "required_checklist" | "critical_requirement" | "lock_in";
+
+export type WorkflowRequirementSeed = {
+  id: string;
+  title: string;
+  description: string;
+  category: WorkflowRequirementCategory;
+  mandatory: boolean;
+  source: WorkflowRequirementSource;
+};
+
+export type WorkflowTechnicalSectionSeed = {
+  id: string;
+  title: string;
+  description: string;
+};
+
+export type WorkflowMilestoneSeed = {
+  id: string;
+  title: string;
+  dateIso: string | null;
+  location: string;
+  note: string;
+  source: "ai" | "licitation" | "manual";
+};
+
+export function normalizeWorkflowKey(value: string) {
+  return value
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
+export function inferRequirementCategory(title: string): WorkflowRequirementCategory {
+  const normalized = normalizeWorkflowKey(title);
+
+  if (
+    normalized.includes("anexo") ||
+    normalized.includes("garantia") ||
+    normalized.includes("fianza") ||
+    normalized.includes("capacidad-financiera") ||
+    normalized.includes("propuesta-economica")
+  ) {
+    return "economico";
+  }
+
+  if (
+    normalized.includes("tecnica") ||
+    normalized.includes("especificacion") ||
+    normalized.includes("fabricante") ||
+    normalized.includes("certificacion") ||
+    normalized.includes("dmtf")
+  ) {
+    return "tecnico";
+  }
+
+  if (
+    normalized.includes("integridad") ||
+    normalized.includes("manifiesto") ||
+    normalized.includes("impedimento") ||
+    normalized.includes("acreditacion") ||
+    normalized.includes("personalidad") ||
+    normalized.includes("independiente") ||
+    normalized.includes("legal")
+  ) {
+    return "legal";
+  }
+
+  if (normalized.includes("checklist") || normalized.includes("documentacion") || normalized.includes("administrativ")) {
+    return "administrativo";
+  }
+
+  return "general";
+}
+
+function buildRequirementId(source: WorkflowRequirementSource, title: string, index: number) {
+  const key = normalizeWorkflowKey(title) || `item-${index + 1}`;
+  return `${source}-${key}`;
+}
+
+export function buildRequirementSeeds(result: NormativeAnalysisResult): WorkflowRequirementSeed[] {
+  const buckets: WorkflowRequirementSeed[] = [];
+
+  for (let index = 0; index < result.officialFormats.length; index += 1) {
+    const item = result.officialFormats[index];
+    const title = item.trim();
+    if (!title) {
+      continue;
+    }
+
+    buckets.push({
+      id: buildRequirementId("official_format", title, index),
+      title,
+      description: "Formato oficial detectado en el analisis normativo.",
+      category: inferRequirementCategory(title),
+      mandatory: true,
+      source: "official_format",
+    });
+  }
+
+  for (let index = 0; index < result.requiredChecklist.length; index += 1) {
+    const item = result.requiredChecklist[index];
+    const title = item.title.trim();
+    if (!title) {
+      continue;
+    }
+
+    buckets.push({
+      id: buildRequirementId("required_checklist", title, index),
+      title,
+      description: item.description,
+      category: inferRequirementCategory(title),
+      mandatory: true,
+      source: "required_checklist",
+    });
+  }
+
+  for (let index = 0; index < result.criticalRequirements.length; index += 1) {
+    const item = result.criticalRequirements[index];
+    const title = item.title.trim();
+    if (!title) {
+      continue;
+    }
+
+    buckets.push({
+      id: buildRequirementId("critical_requirement", title, index),
+      title,
+      description: item.description,
+      category: inferRequirementCategory(title),
+      mandatory: true,
+      source: "critical_requirement",
+    });
+  }
+
+  for (let index = 0; index < result.lockIns.length; index += 1) {
+    const item = result.lockIns[index];
+    const title = item.title.trim();
+    if (!title) {
+      continue;
+    }
+
+    buckets.push({
+      id: buildRequirementId("lock_in", title, index),
+      title,
+      description: item.impact,
+      category: inferRequirementCategory(title),
+      mandatory: true,
+      source: "lock_in",
+    });
+  }
+
+  return dedupeRequirementSeeds(buckets);
+}
+
+export function dedupeRequirementSeeds(requirements: WorkflowRequirementSeed[]) {
+  const seen = new Set<string>();
+  const deduped: WorkflowRequirementSeed[] = [];
+
+  for (const item of requirements) {
+    const signature = normalizeWorkflowKey(item.title);
+    if (!signature || seen.has(signature)) {
+      continue;
+    }
+
+    seen.add(signature);
+    deduped.push(item);
+  }
+
+  return deduped;
+}
+
+export function mergeWorkflowRequirementsWithSeeds(
+  existing: ProposalWorkflowState["requirements"],
+  seeds: WorkflowRequirementSeed[],
+): ProposalWorkflowState["requirements"] {
+  const existingByTitle = new Map(existing.map((item) => [normalizeWorkflowKey(item.title), item]));
+
+  return seeds.map((seed) => {
+    const key = normalizeWorkflowKey(seed.title);
+    const previous = existingByTitle.get(key);
+
+    return {
+      id: seed.id,
+      title: seed.title,
+      description: seed.description,
+      category: seed.category,
+      mandatory: seed.mandatory,
+      source: seed.source,
+      status: previous?.status ?? "pending",
+      note: previous?.note ?? "",
+      evidences: previous?.evidences ?? [],
+    };
+  });
+}
+
+function normalizeMilestoneTitle(title: string) {
+  const normalized = normalizeWorkflowKey(title);
+  return normalized || "evento";
+}
+
+function monthToNumber(monthRaw: string) {
+  const month = monthRaw
+    .toLowerCase()
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "");
+
+  const mapping: Record<string, number> = {
+    enero: 0,
+    febrero: 1,
+    marzo: 2,
+    abril: 3,
+    mayo: 4,
+    junio: 5,
+    julio: 6,
+    agosto: 7,
+    septiembre: 8,
+    setiembre: 8,
+    octubre: 9,
+    noviembre: 10,
+    diciembre: 11,
+  };
+
+  return mapping[month] ?? null;
+}
+
+function normalizeYear(value: number) {
+  if (value < 100) {
+    return value >= 70 ? 1900 + value : 2000 + value;
+  }
+
+  return value;
+}
+
+function buildIsoFromParts(year: number, month: number, day: number, hour = 0, minute = 0) {
+  const date = new Date(Date.UTC(year, month, day, hour, minute, 0, 0));
+  if (Number.isNaN(date.getTime())) {
+    return null;
+  }
+
+  return date.toISOString();
+}
+
+function parseDateFromText(value: string) {
+  const isoMatch = value.match(/\b(20\d{2}|19\d{2})[\/\-](\d{1,2})[\/\-](\d{1,2})(?:\s+a\s+las\s+(\d{1,2}):(\d{2})|\s+(\d{1,2}):(\d{2}))?/i);
+  if (isoMatch) {
+    const year = Number.parseInt(isoMatch[1] ?? "0", 10);
+    const month = Number.parseInt(isoMatch[2] ?? "0", 10) - 1;
+    const day = Number.parseInt(isoMatch[3] ?? "0", 10);
+    const hour = Number.parseInt(isoMatch[4] ?? isoMatch[6] ?? "0", 10);
+    const minute = Number.parseInt(isoMatch[5] ?? isoMatch[7] ?? "0", 10);
+    if (month >= 0 && month <= 11 && day >= 1 && day <= 31) {
+      return buildIsoFromParts(year, month, day, hour, minute);
+    }
+  }
+
+  const slashMatch = value.match(/\b(\d{1,2})[\/\-](\d{1,2})[\/\-](\d{2,4})(?:\s+a\s+las\s+(\d{1,2}):(\d{2})|\s+(\d{1,2}):(\d{2}))?/i);
+  if (slashMatch) {
+    const day = Number.parseInt(slashMatch[1] ?? "0", 10);
+    const month = Number.parseInt(slashMatch[2] ?? "0", 10) - 1;
+    const year = normalizeYear(Number.parseInt(slashMatch[3] ?? "0", 10));
+    const hour = Number.parseInt(slashMatch[4] ?? slashMatch[6] ?? "0", 10);
+    const minute = Number.parseInt(slashMatch[5] ?? slashMatch[7] ?? "0", 10);
+    if (month >= 0 && month <= 11 && day >= 1 && day <= 31) {
+      return buildIsoFromParts(year, month, day, hour, minute);
+    }
+  }
+
+  const namedMonthMatch = value.match(
+    /\b(\d{1,2})\s+de\s+([a-zA-Z\u00C0-\u017F]+)\s+de\s+(\d{2,4})(?:\s+(?:a\s+las\s+)?(\d{1,2}):(\d{2}))?/i,
+  );
+  if (namedMonthMatch) {
+    const day = Number.parseInt(namedMonthMatch[1] ?? "0", 10);
+    const month = monthToNumber(namedMonthMatch[2] ?? "");
+    const year = normalizeYear(Number.parseInt(namedMonthMatch[3] ?? "0", 10));
+    const hour = Number.parseInt(namedMonthMatch[4] ?? "0", 10);
+    const minute = Number.parseInt(namedMonthMatch[5] ?? "0", 10);
+    if (month !== null && day >= 1 && day <= 31) {
+      return buildIsoFromParts(year, month, day, hour, minute);
+    }
+  }
+
+  return null;
+}
+
+function inferMilestoneTitle(fallbackTitle: string, text: string) {
+  const lower = text.toLowerCase();
+  if (lower.includes("junta") && lower.includes("aclar")) {
+    return "Junta de aclaraciones";
+  }
+  if (lower.includes("venta de bases") || lower.includes("registro")) {
+    return "Venta de bases y registro";
+  }
+  if (lower.includes("presentacion") && lower.includes("propuest")) {
+    return "Presentacion de propuestas";
+  }
+  if (lower.includes("apertura") && lower.includes("economic")) {
+    return "Apertura economica";
+  }
+  if (lower.includes("fallo") || lower.includes("adjudic")) {
+    return "Fallo y adjudicacion";
+  }
+  if (lower.includes("visita") && lower.includes("sitio")) {
+    return "Visita a sitio";
+  }
+
+  const compact = fallbackTitle.trim() || text.trim();
+  if (compact.length <= 80) {
+    return compact;
+  }
+
+  return `${compact.slice(0, 77).trimEnd()}...`;
+}
+
+function dedupeMilestones(seeds: WorkflowMilestoneSeed[]) {
+  const seen = new Set<string>();
+  const deduped: WorkflowMilestoneSeed[] = [];
+
+  for (const seed of seeds) {
+    const key = `${normalizeMilestoneTitle(seed.title)}|${seed.dateIso ?? ""}`;
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    deduped.push(seed);
+  }
+
+  return deduped;
+}
+
+export function buildMilestoneSeedsFromAnalysis(result: NormativeAnalysisResult): WorkflowMilestoneSeed[] {
+  const candidates = [
+    ...result.requiredChecklist.map((item) => ({ title: item.title, description: item.description })),
+    ...result.criticalRequirements.map((item) => ({ title: item.title, description: item.description })),
+    { title: "Resumen ejecutivo", description: result.executiveSummary },
+  ];
+
+  const milestoneSeeds: WorkflowMilestoneSeed[] = [];
+
+  for (const candidate of candidates) {
+    const combined = `${candidate.title}. ${candidate.description}`.trim();
+    const dateIso = parseDateFromText(combined);
+    if (!dateIso) {
+      continue;
+    }
+
+    const normalizedTitle = inferMilestoneTitle(candidate.title, combined);
+    milestoneSeeds.push({
+      id: `ai-milestone-${normalizeMilestoneTitle(normalizedTitle)}-${milestoneSeeds.length + 1}`,
+      title: normalizedTitle,
+      dateIso,
+      location: "",
+      note: candidate.description.length <= 240 ? candidate.description : `${candidate.description.slice(0, 237)}...`,
+      source: "ai",
+    });
+
+    if (milestoneSeeds.length >= 10) {
+      break;
+    }
+  }
+
+  return dedupeMilestones(milestoneSeeds);
+}
+
+export function mergeWorkflowMilestonesWithSeeds(
+  existing: ProposalWorkflowState["milestones"],
+  seeds: WorkflowMilestoneSeed[],
+): ProposalWorkflowState["milestones"] {
+  const existingByTitle = new Map(existing.map((item) => [normalizeMilestoneTitle(item.title), item]));
+  const usedExistingIds = new Set<string>();
+
+  const merged = seeds.map((seed) => {
+    const key = normalizeMilestoneTitle(seed.title);
+    const previous = existingByTitle.get(key);
+    if (previous) {
+      usedExistingIds.add(previous.id);
+    }
+
+    return {
+      id: previous?.id ?? seed.id,
+      title: previous?.title ?? seed.title,
+      dateIso: previous?.dateIso ?? seed.dateIso,
+      location: previous?.location ?? seed.location,
+      note: previous?.note ?? seed.note,
+      source: previous?.source ?? seed.source,
+    };
+  });
+
+  for (const item of existing) {
+    if (usedExistingIds.has(item.id)) {
+      continue;
+    }
+    merged.push(item);
+  }
+
+  return dedupeMilestones(merged).sort((a, b) => {
+    if (!a.dateIso && !b.dateIso) {
+      return a.title.localeCompare(b.title, "es-MX");
+    }
+    if (!a.dateIso) {
+      return 1;
+    }
+    if (!b.dateIso) {
+      return -1;
+    }
+    return new Date(a.dateIso).getTime() - new Date(b.dateIso).getTime();
+  });
+}
+
+export function mergeWorkflowTechnicalSectionsWithSeeds(
+  existing: ProposalWorkflowState["technicalSections"],
+  seeds: WorkflowTechnicalSectionSeed[],
+): ProposalWorkflowState["technicalSections"] {
+  const existingByTitle = new Map(existing.map((item) => [normalizeWorkflowKey(item.title), item]));
+
+  return seeds.map((seed) => {
+    const key = normalizeWorkflowKey(seed.title);
+    const previous = existingByTitle.get(key);
+
+    return {
+      id: seed.id,
+      title: seed.title,
+      description: seed.description,
+      completed: previous?.completed ?? false,
+    };
+  });
+}
+
+export function applyAiSeedsToWorkflow(
+  workflow: ProposalWorkflowState,
+  args: {
+    requirementSeeds: WorkflowRequirementSeed[];
+    technicalSectionSeeds: WorkflowTechnicalSectionSeed[];
+    milestoneSeeds?: WorkflowMilestoneSeed[];
+  },
+): ProposalWorkflowState {
+  return {
+    ...workflow,
+    requirements: mergeWorkflowRequirementsWithSeeds(workflow.requirements, args.requirementSeeds),
+    technicalSections: mergeWorkflowTechnicalSectionsWithSeeds(workflow.technicalSections, args.technicalSectionSeeds),
+    milestones: args.milestoneSeeds ? mergeWorkflowMilestonesWithSeeds(workflow.milestones, args.milestoneSeeds) : workflow.milestones,
+  };
+}
+
+export function buildTechnicalSectionSeeds(result: NormativeAnalysisResult): WorkflowTechnicalSectionSeed[] {
+  const fromAi = result.preparationRecommendations.slice(0, 6).map((item, index) => ({
+    id: `section-ai-${index + 1}`,
+    title: item.title,
+    description: item.description,
+  }));
+
+  const valueForMoneyActions = result.valueForMoney.actions.slice(0, 2).map((action, index) => ({
+    id: `section-vfm-${index + 1}`,
+    title: `Valor por dinero ${index + 1}`,
+    description: action,
+  }));
+
+  const circularActions = result.circularEconomy.actions.slice(0, 2).map((action, index) => ({
+    id: `section-circular-${index + 1}`,
+    title: `Economia circular ${index + 1}`,
+    description: action,
+  }));
+
+  const merged = [...fromAi, ...valueForMoneyActions, ...circularActions];
+  const deduped = dedupeTechnicalSections(merged);
+
+  if (deduped.length > 0) {
+    return deduped.slice(0, 8);
+  }
+
+  return [
+    {
+      id: "section-default-1",
+      title: "Documentacion Legal y Administrativa",
+      description: "Integra los formatos y anexos legales solicitados en bases.",
+    },
+    {
+      id: "section-default-2",
+      title: "Propuesta Tecnica Detallada",
+      description: "Describe alcance, metodologia, entregables y cumplimiento tecnico.",
+    },
+    {
+      id: "section-default-3",
+      title: "Acreditacion de Experiencia y Capacidad Tecnica",
+      description: "Evidencia experiencia, cartas y certificaciones requeridas.",
+    },
+  ];
+}
+
+function dedupeTechnicalSections(sections: WorkflowTechnicalSectionSeed[]) {
+  const seen = new Set<string>();
+  const output: WorkflowTechnicalSectionSeed[] = [];
+
+  for (const section of sections) {
+    const key = normalizeWorkflowKey(section.title);
+    if (!key || seen.has(key)) {
+      continue;
+    }
+
+    seen.add(key);
+    output.push(section);
+  }
+
+  return output;
+}
diff --git a/src/lib/strategic-diagnostic/types.ts b/src/lib/strategic-diagnostic/types.ts
index ef67ffa..36823fe 100644
--- a/src/lib/strategic-diagnostic/types.ts
+++ b/src/lib/strategic-diagnostic/types.ts
@@ -71,9 +71,39 @@ export type StrategicDiagnosticSnapshot = {
   data: StrategicDiagnosticData;
   scores: StrategicDiagnosticScores;
   evidenceBySection: Record<StrategicSectionKey, StrategicEvidenceDocumentView[]>;
+  aiInsights?: StrategicAiInsights | null;
   completedAt: string | null;
 };
 
+export type StrategicAiInsights = {
+  sectionGaps: {
+    sectionKey: StrategicSectionKey;
+    gap: string;
+    impact: string;
+    urgency: "alta" | "media" | "baja";
+  }[];
+  priorityActions: {
+    title: string;
+    description: string;
+    priority: "alta" | "media" | "baja";
+    ownerSuggestion: string;
+    targetDateSuggestion: string;
+  }[];
+  suggestedEvidence: {
+    sectionKey: StrategicSectionKey;
+    category: string;
+    reason: string;
+  }[];
+  suggestedFieldValues: {
+    sectionKey: StrategicSectionKey;
+    fieldPath: string;
+    suggestedValue: string;
+    rationale: string;
+  }[];
+  confidence: "low" | "medium" | "high";
+  suggestionId: string;
+};
+
 export const STRATEGIC_EVIDENCE_CATEGORY_OPTIONS: Record<StrategicSectionKey, string[]> = {
   technical: ["Certificacion ISO", "Certificacion tecnica", "Ficha tecnica", "Catalogo de productos", "Otro"],
   experience: ["Contrato previo", "Carta de recomendacion", "Constancia de cumplimiento", "Caso de exito", "Otro"],
diff --git a/src/lib/test/server-only.ts b/src/lib/test/server-only.ts
new file mode 100644
index 0000000..cb0ff5c
--- /dev/null
+++ b/src/lib/test/server-only.ts
@@ -0,0 +1 @@
+export {};
diff --git a/vercel.json b/vercel.json
new file mode 100644
index 0000000..f539c39
--- /dev/null
+++ b/vercel.json
@@ -0,0 +1,12 @@
+{
+  "crons": [
+    {
+      "path": "/api/cron/licitations-sync?include_regulations=1",
+      "schedule": "0 */12 * * *"
+    },
+    {
+      "path": "/api/cron/regulations-verify",
+      "schedule": "30 5 * * *"
+    }
+  ]
+}
diff --git a/vitest.config.ts b/vitest.config.ts
index 6780a79..416dc97 100644
--- a/vitest.config.ts
+++ b/vitest.config.ts
@@ -8,6 +8,7 @@ export default defineConfig({
   resolve: {
     alias: {
       "@": path.resolve(__dirname, "./src"),
+      "server-only": path.resolve(__dirname, "./src/lib/test/server-only.ts"),
     },
   },
 });