Development Proposal
1. Executive Summary
The Challenge
Organizations face slow, inconsistent, and untraceable capital allocation processes. Investment proposals arrive in disparate formats, evaluations depend on individual biases, and there is no auditable record of the decisions made. The manual review cycle takes weeks, with information scattered across emails, documents, and meetings, preventing objective comparisons and organizational learning.
The Solution
Capital Compass is an intelligent platform that standardizes and accelerates the complete investment proposal evaluation process. An AI assistant guides submitters through a structured conversational intake in 4 phases, automatically extracts data into a standardized schema, applies multidimensional deterministic scoring, and orchestrates a financial approval workflow — all backed by an immutable ledger that guarantees complete traceability.
Conversational Intake
AI-guided chat with Gemini 2.0 Flash. 4 structured phases: Identity, Hypothesis, Impact, Economics. Real-time streaming via SSE.
Deterministic Scoring
4-dimension evaluation (25 pts each = 100 max): hypothesis quality, impact clarity, cost confidence, execution readiness. Anti-gaming flags.
Approval Workflow
Full lifecycle: draft → AI review → finance review → decision. Approve, reject, or revision requested with mandatory justification.
Ledger & Audit
Append-only ledger with monotonic sequence. Recomputable materialized snapshot. Full audit log. Immutable original hypothesis.
Dashboard & Portfolio
Executive view with key metrics. Portfolio view with filters by status, department, score. Prioritized review queue for finance reviewers.
Reports & PDF
Automatic generation of the CFO Capital Allocation Brief in PDF. Threaded comments with AI assistance for collaborative review.
2. Solution Overview
Platform Architecture
Capital Compass is built on a 100% serverless architecture on AWS, with clear separation between frontend, backend, and data layers:
Infrastructure Interaction Map
The following diagram shows how services communicate with each other at runtime, including protocols and data flow direction:
Architectural Principles
- Serverless-first: Lambda + RDS eliminate server management and scale with demand.
- Event sourcing lite: Append-only ledger as the source of truth; snapshot as a materialized projection.
- Dual auth: Cognito for email/password + Firebase for Google Sign-In, both verified with JWT.
- Structured schema: InitiativeData v1.0.0 as the contract between AI intake and deterministic scoring.
- Streaming-first for AI: SSE for chat and comment responses, minimizing perceived latency.
- Immutability: Original hypothesis captured on first submission; ledger with no UPDATE/DELETE.
System Roles
| Role | Description | Key Permissions |
|---|---|---|
| Submitter | Investment requestor | Create proposals, AI chat, edit drafts, view own status |
| Finance Reviewer | Financial reviewer | Review queue, approve/reject, score override, AI comments |
| Admin | Platform administrator | Full access, user/role management, audit log, ledger |
3. Scope & Deliverables
Deliverables
| # | Deliverable | Module | Description |
|---|---|---|---|
| 1 | AWS Infrastructure | Platform | VPC, RDS PostgreSQL 16, Lambda Functions (9), Cognito User Pool, EventBridge Scheduler. IaC with SAM/CloudFormation. |
| 2 | Dual Auth (Cognito + Firebase) | Platform | Email/password login via Cognito, Google Sign-In via Firebase. JWT verification in Lambda. PostConfirmation trigger. |
| 3 | AI Conversational Intake | Intake | Guided chat with Gemini 2.0 Flash across 4 phases (Identity, Hypothesis, Impact, Economics). Real-time SSE streaming. |
| 4 | Structured Data Extraction | Intake | Lambda that extracts JSON from transcript into InitiativeData v1.0.0 schema with 7 JSONB sections. |
| 5 | Deterministic Scoring | Scoring | 4 dimensions (hypothesis quality, impact clarity, cost confidence, execution readiness) × 25 pts. Anti-gaming flags. AI narrative. |
| 6 | Financial Decision Workflow | Workflow | Approve/reject/revision_requested. Score override with justification. Materiality band, strategic alignment, portfolio fit. |
| 7 | Append-Only Ledger | Ledger | 6 immutable event types with monotonic sequence. Recomputable materialized snapshot from events. |
| 8 | Executive Dashboard | Dashboard | Key portfolio metrics, overall proposal status, filters by status/department/score. |
| 9 | Portfolio View | Dashboard | Complete view of all proposals with search, filters, and sorting. Detail view with scores, comments, and history. |
| 10 | Review Queue | Workflow | Prioritized queue for finance reviewers with proposals in finance_review, scores, and AI recommendations. |
| 11 | PDF Generation | Reports | CFO Capital Allocation Brief: executive summary, scores, financial breakdown, risks, timeline. |
| 12 | AI-Assisted Comments | Reports | Threaded comment system with AI refinement via streaming SSE. AI-generated content flag. |
| 13 | Automated Quarterly Rollup | Ledger | Quarterly EventBridge job that detects proposals in HOLD >90 days and flags them as resolution_required. |
| 14 | Admin Panel | Platform | User, role, and department management. Audit log and event ledger views. |
| 15 | Deployment & Documentation | Platform | Frontend on Amplify (auto-deploy), backend on SAM. Technical documentation and operations manual. |
Out of Scope (Future Phases)
The following items are not included in this phase and may be addressed in subsequent phases:
ERP/Accounting Integrations
Connection with SAP, Oracle, NetSuite, or other financial systems for automatic budget data synchronization.
Native Mobile App
Dedicated mobile application for iOS/Android. The platform is responsive but does not include a native app.
Advanced Analytics & ML
Predictive models for proposal success, automated industry benchmarking, portfolio clustering.
Multi-tenancy
Support for multiple organizations in a single instance. The platform is single-tenant.
4. Timeline
The project is executed in 5 phases over 4 weeks, with incremental deliveries and validations at the end of each phase.
Phase Details
| Phase | Duration | Key Activities |
|---|---|---|
| 1. Infrastructure & Auth | 1 week (W1) | VPC setup, RDS PostgreSQL, schema migration, SAM template, Cognito User Pool, Firebase Auth (Google), PostConfirmation Lambda, deploy pipeline. |
| 2. Intake & AI | 2 weeks (W1–W2) | Conversational chat with Gemini 2.0 Flash, 4 intake phases (Identity/Hypothesis/Impact/Economics), SSE streaming, structured data extraction, InitiativeData v1.0.0 schema. |
| 3. Scoring & Decision | 2 weeks (W2–W3) | Deterministic scoring engine (4 dimensions), anti-gaming flags, AI narrative, financial decision workflow (approve/reject/revise), score override, review queue. |
| 4. Dashboard & Ledger | 2 weeks (W3–W4) | Executive dashboard, portfolio view, append-only ledger, materialized snapshot, audit log, quarterly-rollup, PDF generation (Capital Allocation Brief), AI-assisted comments. |
| 5. QA & Deploy | 1 week (W4) | End-to-end testing (Vitest + Testing Library), bug fixes, performance optimization, production deploy (Amplify + SAM), documentation, formal delivery. |
5. Investment
Weekly Payment Schedule
| Week | Amount |
|---|---|
| Week 1 | $8,500 MXN + IVA |
| Week 2 | $8,500 MXN + IVA |
| Week 3 | $8,500 MXN + IVA |
| Week 4 | $8,500 MXN + IVA |
| Total | $34,000 MXN + IVA |
Payment Terms
Weekly payment of $8,500 MXN + IVA — Billed at the start of each week for a total of 4 weeks.
Infrastructure Costs (client responsibility)
| Service | Free Tier | Post-Free Tier Cost |
|---|---|---|
| AWS RDS db.t4g.micro | 750h/month (12 months) | ~$13/month |
| AWS Cognito | 10,000 MAU (permanent) | $0 |
| AWS Lambda | 1M req/month (permanent) | $0 |
| AWS Amplify Hosting | 12 months free | ~$0.01/month |
| AWS NAT Gateway | No free tier | ~$32/month |
| Google AI Studio (Gemini) | Generous free tier | Usage-based |
| Estimated monthly total | ~$35 – $50/month | |
6. Support & Maintenance
Included Post-Delivery Support
30 days of corrective support at no additional cost after formal project delivery. Includes:
- Bug fixes reported during the period
- Minor configuration adjustments
- Support via dedicated channel (Slack/email)
- Basic AWS infrastructure monitoring
Optional Maintenance
Monthly post-delivery maintenance plan, quoted based on project complexity:
- Continuous monitoring of Lambda, RDS, and Amplify
- Security updates and dependency upgrades
- Technical support with defined SLA
- AWS performance and cost optimization
- Scoring model and AI prompt adjustments
7. Terms & Conditions
- Infrastructure and Third-Party Services: Costs for Google Cloud, domains, certificates, storage, transactional email, and any external services are not included in this proposal and will be the client's responsibility.
- Functional Validation: This proposal contemplates an initial functional landing to finalize fields, rules, and pilot exceptions. If structural changes to the process or new undocumented rules arise during development, their impact on scope, timeline, and cost will be evaluated.
- Intellectual Property: Once 100% of the project is paid in full, intellectual property of the developed source code will be transferred to the client.
- Scope Changes: Any additional functionality not contemplated in this proposal will be analyzed and quoted separately.
- Migrations and Integrations: This phase does not include automatic historical data migration, ERP/accounting integrations, or external automations, unless explicitly stated in the scope.
- Confidentiality: All information shared during the project will be treated under principles of confidentiality between both parties.
- Disclaimer of Liability: After formal delivery of the solution and corresponding settlement, Zulunity is released from future responsibilities regarding operation, evolution, or maintenance of the system, except under express engagement of the optional support service.
8. Next Steps
- Proposal Approval — Internal validation of terms, scope, and investment.
- Contract Signing — Formalization of the project kickoff.
- Advance Payment — Resource activation and team scheduling.
- Kick-Off Session — Finalize mandatory fields, stakeholders, exception rules, and base catalogs for the pilot.
- Development Start — Formal kickoff with periodic follow-ups and incremental deliveries.