HomeAI SystemsHow It WorksMedia HubContact
EnglishFrançais
Request a Demo Launch App

Project & Market Intelligence
Practical Guide

Prepare your data, import it into the system, and start managing projects, estimates, contractor quotes, and proposals — step by step.

Prepare Your Data

The system works with your existing project and market data. Download the sample CSV files below, adapt them to your data, and import them to get started immediately.

Download Sample Data

CSV files with realistic fictional data — ready to import or adapt

Download Sample CSVs (ZIP)

CSV File Structures

Daily Usage Files

Projects projects.csv

Your project directory. One row per project with client, budget, timeline, and status.

ColumnDescriptionExample
nameProject nameRéhabilitation Route Abidjan-Bouaké
typeProject typeinfrastructure
locationProject locationAbidjan, Côte d'Ivoire
client_nameClient nameGEOROUTE CONSTRUCTION
budgetProject budget2500000000
currencyCurrency codeXOF
start_dateStart date (YYYY-MM-DD)2026-01-15
end_dateEnd date (YYYY-MM-DD)2026-12-31
statusProject statusactive
descriptionProject descriptionRéhabilitation de 150 km de route
manager_nameProject manager nameKouassi Marc

Project Scopes project_scopes.csv

Scope breakdown by phase, area, and item. One row per scope item linked to a project.

ColumnDescriptionExample
project_nameProject name (must match projects.csv)Réhabilitation Route Abidjan-Bouaké
phaseProject phasePhase 1
areaArea or zoneSection A
itemScope item descriptionTerrassement et nivellement
quantityQuantity for this item150
unitUnit of measurekm
notesAdditional notesIncludes drainage works

Takeoffs takeoffs.csv

Quantity takeoffs from plans or drawings. One row per measured element linked to a project.

ColumnDescriptionExample
project_nameProject name (must match projects.csv)Réhabilitation Route Abidjan-Bouaké
elementElement measuredBéton de chaussée
quantityMeasured quantity4500
unitUnit of measurem3
sourceSource of measurementPlan v2.1
notesAdditional notesExcludes intersections

Estimates estimates.csv

Cost estimates by trade and line item. One row per estimate line with unit price, total, and margin.

ColumnDescriptionExample
project_nameProject name (must match projects.csv)Réhabilitation Route Abidjan-Bouaké
tradeTrade or disciplineGénie civil
line_itemLine item descriptionBéton de chaussée
quantityEstimated quantity4500
unitUnit of measurem3
unit_priceUnit price95000
currencyCurrency codeXOF
line_totalLine total427500000
cost_totalLine cost total315000000
marginLine margin112500000
sourceEstimate sourcehistorical_data
confidenceConfidence levelhigh

Contractors contractors.csv

Your contractor directory. One row per contractor with trade, location, rating, and specialties.

ColumnDescriptionExample
nameContractor company nameGEOROUTE CONSTRUCTION
tradePrimary tradeTravaux publics
contact_emailContact emailcontact@georoute.example
contact_phoneContact phone+225 27 10 00 01 00
countryCountry of operationCôte d'Ivoire
cityCityAbidjan
ratingPerformance rating (1-5)4.5
projects_completedNumber of completed projects120
statusContractor statusactive
verifiedVerification statusyes
specialtiesSpecialties or capabilitiesRoutes; terrassement; drainage

Contractor Quotes contractor_quotes.csv

Quotes received from contractors for specific projects. One row per quote with amount, duration, and terms.

ColumnDescriptionExample
project_nameProject name (must match projects.csv)Réhabilitation Route Abidjan-Bouaké
contractor_nameContractor name (must match contractors.csv)GEOROUTE CONSTRUCTION
tradeTrade or scopeTravaux publics
amountQuoted amount1850000000
currencyCurrency codeXOF
duration_daysEstimated duration in days240
validity_daysQuote validity in days30
payment_termsPayment terms30% advance, balance on milestones
statusQuote statusreceived
notesAdditional notesIncludes equipment mobilization

Proposals proposals.csv

Proposals submitted to clients. One row per proposal with amount, duration, and response tracking.

ColumnDescriptionExample
project_nameProject name (must match projects.csv)Réhabilitation Route Abidjan-Bouaké
client_nameClient nameGEOROUTE CONSTRUCTION
amountProposed amount2200000000
currencyCurrency codeXOF
duration_daysProposed duration in days300
validity_daysProposal validity in days60
statusProposal statussent
sent_dateDate sent (YYYY-MM-DD)2026-01-10
response_dateClient response date
notesAdditional notesAwaiting client feedback

Market Intelligence Files

Material Prices material_prices.csv

Market prices for construction materials. One row per material with supplier and location.

ColumnDescriptionExample
nameMaterial nameCiment CEM II 42.5
unitUnit of measuretonnes
unit_priceMarket unit price85000
currencyCurrency codeXOF
categoryMaterial categoryCiment
supplierSupplier nameCIMENTERIE DU SAHEL
countryCountryCôte d'Ivoire
cityCityAbidjan
quality_levelQuality levelstandard

Labor Rates labor_rates.csv

Market labor rates by trade and location. One row per trade-rate combination.

ColumnDescriptionExample
tradeTrade or disciplineMaçon
unitUnit of measureday
rateLabor rate15000
currencyCurrency codeXOF
countryCountryCôte d'Ivoire
cityCityAbidjan
quality_levelQuality levelstandard

Equipment Rates equipment_rates.csv

Market equipment rental rates by location. One row per equipment-rate combination.

ColumnDescriptionExample
nameEquipment nameBulldozer D6
unitUnit of measureday
rateRental rate350000
currencyCurrency codeXOF
countryCountryCôte d'Ivoire
cityCityAbidjan

Decision Tracking

Decision Records decision_records.csv

Key project decisions with rationale and impact. One row per decision linked to a project.

ColumnDescriptionExample
project_nameProject name (must match projects.csv)Réhabilitation Route Abidjan-Bouaké
decisionDecision madeAwarded civil works to GEOROUTE CONSTRUCTION
rationaleRationale for the decisionBest price-quality ratio and proven track record
impactImpact on projectCost savings of 12% vs second quote
decided_byDecision makerDiabaté Aminata
decided_atDecision date (YYYY-MM-DD)2026-01-20

Import Your Data

Once your CSV files are ready, importing them takes seconds. The system validates every file and shows you exactly what will be imported.

1

Open the App Chat

Launch the Project & Market Intelligence app. You'll see a chat interface — this is your command center.

2

Attach Your CSV File

Click the + button to attach a CSV file, or drag and drop it into the chat.

3

Tell the System What to Do

Describe what you want in plain language:

"Import these projects"
"Import these contractors"
"Import these material prices"
4

Review the Validation

The system automatically checks your data and shows you:

• Number of rows detected and ready to import
• Data quality score (percentage)
• Any errors or warnings (missing columns, invalid dates, unknown projects)
• A preview of the first rows

5

Confirm the Import

Once you're satisfied with the validation results, confirm the import. Your data is now available for estimates, quotes, proposals, and reporting.

Daily Workflows

Once your data is imported, here's what your team can do every day — just by asking in plain language.

1

Create Projects

Define new projects with client, budget, timeline, and manager.

"Create a project for rehabilitating 150 km of road for GEOROUTE CONSTRUCTION, budget 2.5 billion XOF, starting January 2026"

Result: A project record with name, type, location, client, budget, dates, status, and manager — ready for scoping.

📊 Dashboard: Dashboard → Projects tab → '+' button → fill name, category, city, surface, rooms, quality, budget → Save

2

Define Scopes

Break down project work into phases, areas, and items with quantities.

"Define the scope for Phase 1 of the Abidjan-Bouaké project: earthworks, drainage, and paving"

Result: A structured scope breakdown with phases, areas, items, quantities, and units — ready for takeoff.

📊 Dashboard: Dashboard → Projects tab → click project → Scope section → add scope items, requirements, exclusions, assumptions → Save

3

Run Quantity Takeoffs

Extract quantities from plans or drawings and link them to project elements.

"Run a takeoff for concrete pavement from Plan v2.1 — 4500 m3"

Result: Takeoff records with element, quantity, unit, and source — ready for estimating.

📊 Dashboard: Dashboard → Estimates tab → '+' button → add line items with designation, cost type, unit, quantity

4

Generate Cost Estimates

Build detailed cost estimates by trade using takeoffs and market prices.

"Generate a cost estimate for the Abidjan-Bouaké project using current material and labor rates"

Result: A line-by-line estimate with quantities, unit prices, totals, costs, margins, and confidence levels by trade.

📊 Dashboard: Dashboard → Estimates tab → select project → view calculated costs with margin and contingency

5

Collect Contractor Quotes

Request and record quotes from qualified contractors for specific trades.

"Record a quote from GEOROUTE CONSTRUCTION for civil works at 1.85 billion XOF, 240 days"

Result: A quote record linked to the project and contractor with amount, duration, validity, and payment terms.

📊 Dashboard: Dashboard → Quotes tab → '+' button → select project and contractor → enter amount, duration, conditions

6

Compare Quotes

Compare contractor quotes side by side with price, duration, and terms.

"Compare all quotes received for the Abidjan-Bouaké project and rank them by value"

Result: A comparison table with amount, duration, payment terms, contractor rating, and weighted ranking.

📊 Dashboard: Dashboard → Quotes tab → 'Compare' button → side-by-side comparison with recommendation

7

Create Proposals

Generate client proposals with pricing, duration, and validity tracking.

"Create a proposal for GEOROUTE CONSTRUCTION at 2.2 billion XOF, 300 days, valid 60 days"

Result: A proposal record with amount, duration, validity, status, and sent date — ready for client submission.

📊 Dashboard: Dashboard → Proposals tab → '+' button → select project and estimate → generate proposal with margin

8

Track Pipeline

Monitor all projects and proposals by status, value, and stage.

"Show me the project pipeline for 2026 with total value by status"

Result: A pipeline dashboard with project count, total value, and breakdown by status (active, pending, awarded, lost).

📊 Dashboard: Dashboard → Pipeline tab → all projects with status, budget, proposal status, risk alerts

9

Monitor Risk Alerts

Get alerts when material prices spike, quotes expire, or projects fall behind.

"Show me all risk alerts for active projects"

Result: A risk report with expired quotes, price increases, schedule risks, and budget overruns — prioritized by severity.

📊 Dashboard: Dashboard → Overview tab → alerts shown with color codes (red=critical, orange=high, yellow=medium)

10

Analyze Performance

Compare estimated vs actual costs, margins, and durations across projects.

"Compare estimated vs actual performance for all completed projects in 2025"

Result: A performance analysis with cost variance, margin realization, and schedule adherence by project and trade.

📊 Dashboard: Dashboard → Analytics tab → statistics, win rate, average margin, project duration

11

Export Reports

Export any estimate, comparison, pipeline, or analysis to PDF or CSV.

"Export the cost estimate for the Abidjan-Bouaké project to PDF"

Result: A formatted PDF report ready for client presentations, internal reviews, or stakeholder sharing.

📊 Dashboard: Dashboard → any tab → ⋮ menu → Export PDF or CSV

Market Intelligence Workflows

Update material, labor, and equipment prices — and compare your internal prices with current market rates.

1

Update Material Prices

Keep your material prices current. When you update a price, all active estimates using that material are flagged for recalculation.

"Update the cement price to 85,000 XOF per tonne"

Result: The material price is updated, and all active estimates using that material are flagged for recalculation.

📊 Dashboard: Dashboard → Estimates tab → Materials sub-section → update prices, see which projects are affected

2

Compare Your Prices with Market Prices

The AI performs a web search to find current market prices and compares them with your internal prices.

"Compare my material prices with the market"

Result: A comparison table showing your internal prices vs market prices, with percentage deviations highlighted.

📊 Dashboard: Available via chat only (the AI performs a web search to find current market prices)

3

Track Labor & Equipment Rates

Maintain current labor rates by trade and equipment rental rates by location.

"What are the current labor rates in Abidjan?"

Result: A table of labor rates by trade and equipment rental rates by location, with quality indicators.

📊 Dashboard: Dashboard → Estimates tab → Labor & Equipment sub-sections → rates by trade, location, and quality

AI Advisor & Decision Learning

Simulate cost scenarios, verify margin health, generate payment schedules, get contractor recommendations, predict new project costs, and learn from past decisions.

1

Simulate Cost Scenarios

Compare 3 cost scenarios side by side to help your client decide.

"Simulate cost scenarios for the Villa Riviera project"

Result: A side-by-side comparison of 3 scenarios (Economic -10%, Standard, Premium +15%), each with its own margin and contingency.

📊 Dashboard: Dashboard → Advisor tab → select estimate → 'Simulate scenarios' button → 3-scenario comparison table

2

Verify Margin Health

Check whether your margin is healthy, below threshold, or at a loss — with the minimum selling price.

"Verify the margin for the Villa Riviera project"

Result: A status indicator (OK / below threshold / loss) with the minimum selling price and recommendations.

📊 Dashboard: Dashboard → Advisor tab → select estimate → adjust minimum margin slider → 'Margin guard' button

3

Generate Payment Schedule

Generate a milestone-based payment schedule for your project.

"Generate a payment schedule for the Villa Riviera project"

Result: A milestone-based payment schedule (default: 30% advance, 20% start, 25% mid-point, 25% receipt) with amounts.

📊 Dashboard: Dashboard → Advisor tab → select estimate → 'Payment schedule' button → milestone table

4

Get Contractor Recommendation

Get a ranked list of contractors filtered by service category, scored by rating, verified status, completed projects, and learned patterns.

"Recommend a contractor for the Villa Riviera project"

Result: A ranked list of contractors with justification based on rating, verification, past projects, and learned decision patterns.

📊 Dashboard: Dashboard → Advisor tab → 'Recommend contractor' button → ranked list with justification

5

Predict New Project Cost

Predict the cost of a new project based on your historical data, learned patterns, and current market prices.

"Predict the cost for a 150m² renovation in Abidjan"

Result: A cost prediction based on your historical projects, learned patterns, and current market prices — with a confidence range.

📊 Dashboard: Dashboard → Analytics tab → 'Cost prediction' sub-section → enter project parameters → get prediction

6

Record & Learn from Decisions

Record key decisions with justification. After project completion, update the result and run Auto-Learn to generate patterns for future predictions.

"Record a decision: chose Construire Pro for Villa Riviera, best overall score, 24-month warranty"

Result: The decision is recorded with title, type, justification, and decision maker. After project completion, update the result (success/failure/partial) and run Auto-Learn to generate patterns for future predictions.

📊 Dashboard: Dashboard → Decisions tab → 'Record Decision' button → fill title, type, justification, decision maker → Save. After project: update result → 'Auto-Learn' button to generate patterns

7

Track Customer Feedback

Mark proposals as sent, accepted, or refused — accepted proposals feed into the learning system.

"Mark the Villa Riviera proposal as accepted"

Result: The proposal status is updated (sent/accepted/refused) with response date and reason. Accepted proposals feed into the learning system.

📊 Dashboard: Dashboard → Proposals tab → ⋮ menu → 'Send to client' / 'Mark accepted' / 'Mark refused'

Contractor Management & Notifications

Manage your contractor directory, stay informed with real-time alerts, and get an instant snapshot of all your project activity.

1

Manage Contractors

Create and update contractor records with trade, service categories, contact details, rating, and verification status.

"Create a contractor: BTP Plus, masonry, Abidjan, rating 4.2/5"

Result: A contractor record with trade, service categories (auto-suggested from trade), email, phone, city, rating, completed projects, and verification status.

📊 Dashboard: Dashboard → Quotes tab → Contractors section → '+' button → fill name, trade, service categories, contact, rating → Save

2

Check Notifications

The notification bell aggregates all project events: proposals sent, pending, accepted, or refused.

"What are my recent notifications?"

Result: A list grouped by type: info (proposal sent), attention (proposal pending 35+ days), success (proposal accepted), error (proposal refused).

📊 Dashboard: Click the bell icon at top → notification list → click to navigate to project → 'Mark all as read'

3

View Your Project Overview

Your home page — an instant snapshot of all your project activity in one place.

"Show me the pipeline"

Result: A pipeline view of all projects with status (draft, in progress, completed), budget vs estimate, proposal status, and risk alerts.

📊 Dashboard: Dashboard → Overview tab — your home page with an instant snapshot of all project activity

Get the Most Out of the System

Keep project names consistent

Use the exact same project name across all files (projects, scopes, takeoffs, estimates, quotes, proposals). The system links all project data by name.

Keep contractor names consistent

Use the exact same contractor name in the contractors file and the quotes file. The system links quotes to contractor profiles by name.

Update market prices regularly

Material, labor, and equipment rates change over time. Import updated prices periodically so your estimates always reflect current market conditions.

Use ISO dates

Always use YYYY-MM-DD format for dates. This avoids ambiguity between regional formats and ensures accurate timeline tracking.

Record key decisions

Log important project decisions with rationale and impact. This creates a valuable audit trail and helps with future project planning.

Ask follow-up questions

After any analysis, you can ask follow-up questions like "Show me the cost breakdown by trade" or "What's driving the margin gap on this project?"

Ready to Get Started?

Launch the app and import your data, or request a personalized demo.