# Applied AI Foundation

## Docs

- [Agents](https://docs.appliedaifoundation.org/agents/overview.md): AI agents that automate complex workflows and tasks
- [Document Search](https://docs.appliedaifoundation.org/document-search/overview.md): Intelligent search across your organization's documents
- [What is a Ballast Water Treatment System](https://docs.appliedaifoundation.org/microapps/bwts/concepts/bwts-overview.md): Primer on ballast water operations, why UV treatment is used, and the role of the 16-lamp array.
- [IMO D-2 Standard](https://docs.appliedaifoundation.org/microapps/bwts/concepts/imo-d2-regulation.md): What the IMO Ballast Water Management Convention requires and how the dashboard tracks it.
- [USCG Type Approval Standards](https://docs.appliedaifoundation.org/microapps/bwts/concepts/uscg-standards.md): The United States Coast Guard's stricter ballast water discharge standard and what it means for UV systems.
- [UV Disinfection Technology](https://docs.appliedaifoundation.org/microapps/bwts/concepts/uv-disinfection.md): How UV intensity is generated, measured, and why lamp efficiency degrades over time.
- [API Reference](https://docs.appliedaifoundation.org/microapps/bwts/data/api-reference.md): All ten REST endpoints, their query parameters, and example response shapes.
- [Database Schema Overview](https://docs.appliedaifoundation.org/microapps/bwts/data/schema-overview.md): PostgreSQL tables that back the BWTS dashboard, with table names, row counts, and relationships.
- [Telemetry Fields Reference](https://docs.appliedaifoundation.org/microapps/bwts/data/telemetry-fields.md): Complete field-by-field reference for bwts_iot_telemetry, including units, data types, and threshold values.
- [System Architecture](https://docs.appliedaifoundation.org/microapps/bwts/internal/architecture.md): Data flow, component boundaries, and how the Next.js frontend communicates with Cloud SQL.
- [Environment Variables](https://docs.appliedaifoundation.org/microapps/bwts/internal/environment-variables.md): All required environment variables for connecting to Cloud SQL and GCP.
- [Technology Stack](https://docs.appliedaifoundation.org/microapps/bwts/internal/tech-stack.md): All libraries, frameworks, and services used in the BWTS dashboard.
- [BWTS IoT Monitoring Dashboard](https://docs.appliedaifoundation.org/microapps/bwts/introduction.md): Real-time UV lamp performance monitoring, predictive maintenance, and IMO/USCG compliance for Ballast Water Treatment Systems.
- [Health Score Calculation](https://docs.appliedaifoundation.org/microapps/bwts/methodology/health-score.md): How the system's 0–100 composite health score is derived from four component sub-scores.
- [Progressive Data Loading](https://docs.appliedaifoundation.org/microapps/bwts/methodology/progressive-loading.md): The two-stage loading architecture that delivers instant renders for large historical datasets.
- [Remaining Useful Life (RUL) Prediction](https://docs.appliedaifoundation.org/microapps/bwts/methodology/rul-algorithm.md): How per-lamp failure probability and RUL hours are predicted and surfaced in the dashboard.
- [UV Intensity Thresholds](https://docs.appliedaifoundation.org/microapps/bwts/methodology/uv-thresholds.md): The three key UV intensity levels used for compliance checking, operational targets, and lamp efficiency tiers.
- [Comparative Analysis Tab](https://docs.appliedaifoundation.org/microapps/bwts/product/comparative-analysis-tab.md): Hour-by-hour lamp efficiency comparison between any two of the 16 UV lamps over a selectable date range.
- [Compliance Monitoring Tab](https://docs.appliedaifoundation.org/microapps/bwts/product/compliance-tab.md): Live IMO D-2 and USCG compliance status, treatment effectiveness summary, and system event audit trail.
- [Data Export Tab](https://docs.appliedaifoundation.org/microapps/bwts/product/data-export-tab.md): Excel-style filtering of telemetry records with CSV and PDF download.
- [Overview Tab](https://docs.appliedaifoundation.org/microapps/bwts/product/overview-tab.md): Real-time system status via the central 16-lamp diamond array and surrounding metric panels.
- [Predictive Maintenance Tab](https://docs.appliedaifoundation.org/microapps/bwts/product/predictive-maintenance-tab.md): ML-based failure probability, remaining useful life per lamp, and scheduled maintenance cost analysis.
- [Trend Analysis Tab](https://docs.appliedaifoundation.org/microapps/bwts/product/trend-analysis-tab.md): Historical UV, health, and lamp efficiency trends with date-range filtering and runtime-based degradation charts.
- [Getting Started](https://docs.appliedaifoundation.org/microapps/bwts/quickstart.md): Access your BWTS dashboard and take a first look at the six monitoring views.
- [IMO CII](https://docs.appliedaifoundation.org/microapps/emissions/concepts/cii.md): Carbon Intensity Indicator — what it is, who it applies to, and how the platform handles it.
- [Compliance frameworks at a glance](https://docs.appliedaifoundation.org/microapps/emissions/concepts/compliance-overview.md): Side-by-side comparison of the five maritime regulations supported by the platform.
- [EU ETS](https://docs.appliedaifoundation.org/microapps/emissions/concepts/eu-ets.md): How the EU Emissions Trading System applies to shipping, and how the platform tracks coverage and cost.
- [EU MRV](https://docs.appliedaifoundation.org/microapps/emissions/concepts/eu-mrv.md): Monitoring, Reporting, and Verification — voyage-level CO₂ data for THETIS-MRV submission.
- [FuelEU Maritime](https://docs.appliedaifoundation.org/microapps/emissions/concepts/fuel-eu.md): Well-to-Wake GHG intensity targets, supported fuels, and how compliance is calculated.
- [IMO DCS](https://docs.appliedaifoundation.org/microapps/emissions/concepts/imo-dcs.md): Annual Data Collection System submission for fuel oil consumption.
- [Data model](https://docs.appliedaifoundation.org/microapps/emissions/data/data-model.md): What the platform stores — three tables, customer-relevant fields.
- [Excel upload format](https://docs.appliedaifoundation.org/microapps/emissions/data/excel-upload-format.md): What columns the platform expects, how headers are normalised, and how validation works.
- [Vessel onboarding](https://docs.appliedaifoundation.org/microapps/emissions/data/vessel-onboarding.md): Two paths — pick from the existing fleet, or register a new vessel before uploading data.
- [Architecture](https://docs.appliedaifoundation.org/microapps/emissions/internal/architecture.md): How data flows from Postgres to the user's screen, and the key design decisions along the way.
- [Database (PostgreSQL on Cloud SQL)](https://docs.appliedaifoundation.org/microapps/emissions/internal/database-postgres.md): Connection, pooling, retry logic, and table layout.
- [Environment variables](https://docs.appliedaifoundation.org/microapps/emissions/internal/environment-variables.md): Every env var the app reads, what it does, and what it defaults to.
- [Local development](https://docs.appliedaifoundation.org/microapps/emissions/internal/local-development.md): Get the app running locally.
- [Services layer](https://docs.appliedaifoundation.org/microapps/emissions/internal/services-layer.md): Where the business logic lives — five services that every page and every report calls into.
- [Tech stack](https://docs.appliedaifoundation.org/microapps/emissions/internal/tech-stack.md): Versions and roles of every major dependency.
- [Maritime Emissions Dashboard](https://docs.appliedaifoundation.org/microapps/emissions/introduction.md): Maritime emissions compliance for CII, EU ETS, FuelEU Maritime, EU MRV, and IMO DCS — in one dashboard.
- [CII formulas](https://docs.appliedaifoundation.org/microapps/emissions/methodology/cii-formulas.md): Reference-line formula, ship-type constants, rating boundaries, and reduction factors used by the CII engine.
- [EEOI](https://docs.appliedaifoundation.org/microapps/emissions/methodology/eeoi.md): Energy Efficiency Operational Indicator — by TEU and by weight, when to use which.
- [EU ETS coverage](https://docs.appliedaifoundation.org/microapps/emissions/methodology/eu-ets-coverage.md): Port classification, voyage segmentation, and per-leg coverage logic.
- [FuelEU WtW](https://docs.appliedaifoundation.org/microapps/emissions/methodology/fuel-eu-wtw.md): Well-to-Wake intensity formulas, Annex II default factors, methane slip, and biofuel period dating.
- [Reefer correction](https://docs.appliedaifoundation.org/microapps/emissions/methodology/reefer-correction.md): How reefer-container CO₂ is stripped from CII per IMO MEPC.355(78).
- [Data upload](https://docs.appliedaifoundation.org/microapps/emissions/product/data-upload.md): Drag-drop Excel consumption logs with preview, validation, and duplicate detection.
- [EU ETS dashboard](https://docs.appliedaifoundation.org/microapps/emissions/product/eu-ets-dashboard.md): Phase-in factor, voyage classification, and leg-level coverage for EU ETS exposure.
- [Fleet overview](https://docs.appliedaifoundation.org/microapps/emissions/product/fleet-overview.md): The home page — a single screen for fleet-wide CII, EU ETS, and FuelEU status.
- [FuelEU dashboard](https://docs.appliedaifoundation.org/microapps/emissions/product/fuel-eu-dashboard.md): GHG intensity tracking, fuel mix analysis, and per-vessel compliance ranking.
- [Methodology explorer](https://docs.appliedaifoundation.org/microapps/emissions/product/methodology-explorer.md): In-app calculators and reference tables for CII, EU ETS, and FuelEU.
- [Reports hub](https://docs.appliedaifoundation.org/microapps/emissions/product/reports-hub.md): One-click generation of all five regulatory reports.
- [Vessel detail](https://docs.appliedaifoundation.org/microapps/emissions/product/vessel-detail.md): Deep dive into a single vessel's annual performance — CII, EEOI, fuel mix, voyages, and legs.
- [Voyage maps](https://docs.appliedaifoundation.org/microapps/emissions/product/voyage-maps.md): Interactive map view of vessel routes with voyage-level filtering and table sync.
- [5-minute tour](https://docs.appliedaifoundation.org/microapps/emissions/quickstart.md): Walk through the platform end to end — from fleet KPIs to a downloadable CII Statement.
- [Overview](https://docs.appliedaifoundation.org/microapps/overview.md): Lightweight applications powered by AI agents
- [Filling reports](https://docs.appliedaifoundation.org/microapps/voyage-reports/form/filling-reports.md): Section-by-section walkthrough of each report type — what to type, what's auto-calculated, and what's optional.
- [Guidelines documents](https://docs.appliedaifoundation.org/microapps/voyage-reports/form/guidelines-pdf.md): What's in each of the seven guideline documents bundled with the form, and which one to read for which question.
- [Form overview](https://docs.appliedaifoundation.org/microapps/voyage-reports/form/overview.md): What the form is, the report tabs, the left-rail navigation, and how the file is structured.
- [Submitting a report](https://docs.appliedaifoundation.org/microapps/voyage-reports/form/submitting.md): What happens when you click Submit — encryption, the preview dialog, the email format, and the local archive.
- [Validation](https://docs.appliedaifoundation.org/microapps/voyage-reports/form/validation.md): Mandatory fields, blocking errors, non-blocking warnings, and how Settings limits drive the warnings.
- [Bunker Report](https://docs.appliedaifoundation.org/microapps/voyage-reports/guidelines/bunker-report.md): Complete walkthrough of the Bunker Report — BDN table, biofuel dialog, blend components, and worked examples.
- [Cargo Discharge & Heating](https://docs.appliedaifoundation.org/microapps/voyage-reports/guidelines/cargo-discharge-heating.md): CII-allowance bunker reporting for tankers — Framo, Marflex, and steam-turbine discharge systems.
- [Event Scenarios](https://docs.appliedaifoundation.org/microapps/voyage-reports/guidelines/event-scenarios.md): Eleven operational scenario diagrams showing correct event sequencing for common voyage situations.
- [Forms Guidelines](https://docs.appliedaifoundation.org/microapps/voyage-reports/guidelines/forms-guidelines.md): Field-by-field walkthrough of Noon, Arrival and Departure reports, submission workflow, and FAQs.
- [New Reports](https://docs.appliedaifoundation.org/microapps/voyage-reports/guidelines/new-reports.md): Statement of Facts, Port Performance Survey, Delay Report, and Month-End Bunker Data — the supplementary Metaweave reports.
- [Settings & History](https://docs.appliedaifoundation.org/microapps/voyage-reports/guidelines/settings-history.md): Shore-side setup, vessel-side linking of history.json, the daily submit flow, and the History Viewer.
- [STS / Ice / Emergency](https://docs.appliedaifoundation.org/microapps/voyage-reports/guidelines/sts-ice-emergency.md): Reporting Ship-to-Ship operations, ice navigation, refuge port calls, and SAR/piracy periods.
- [Bootstrap scripts](https://docs.appliedaifoundation.org/microapps/voyage-reports/history/bootstrap-scripts.md): Two standalone scripts to seed history.json from an Excel export or generate a synthetic year of test data.
- [history.json data format](https://docs.appliedaifoundation.org/microapps/voyage-reports/history/data-format.md): The JSON schema each row follows, and what's inside the payload for each report type.
- [History viewer overview](https://docs.appliedaifoundation.org/microapps/voyage-reports/history/overview.md): What the viewer is, what it can do, and what it can't.
- [Setting up history.json](https://docs.appliedaifoundation.org/microapps/voyage-reports/history/setup.md): Where the file comes from, who creates it, how to link it on the vessel, and what gets written on every Submit.
- [Viewing past reports](https://docs.appliedaifoundation.org/microapps/voyage-reports/history/viewing.md): The click path from opening the viewer to exporting filtered submissions to Excel.
- [Metaweave Voyage Reporting](https://docs.appliedaifoundation.org/microapps/voyage-reports/introduction.md): Self-contained HTML forms for vessel-side reporting, a local history archive, and a Python pipeline that ingests submissions into PostgreSQL.
- [Configuration](https://docs.appliedaifoundation.org/microapps/voyage-reports/pipeline/configuration.md): Every environment variable the pipeline reads, where it's used, and what happens if it's missing.
- [Data model](https://docs.appliedaifoundation.org/microapps/voyage-reports/pipeline/data-model.md): 17 SQLAlchemy tables, hierarchy, unique constraints, CASCADE behaviour.
- [ETL stages](https://docs.appliedaifoundation.org/microapps/voyage-reports/pipeline/etl-stages.md): Fetcher, Parser, Mapper, Writer — what each stage does and how it can fail.
- [Installation](https://docs.appliedaifoundation.org/microapps/voyage-reports/pipeline/installation.md): Set up the pipeline in a venv with Cloud SQL Connector and Azure access.
- [Pipeline overview](https://docs.appliedaifoundation.org/microapps/voyage-reports/pipeline/overview.md): ETL flow from Outlook email to a row in PostgreSQL.
- [Running the pipeline](https://docs.appliedaifoundation.org/microapps/voyage-reports/pipeline/running.md): CLI flags, default behaviour, scheduled invocation, and what each log line means.
- [5-minute tour](https://docs.appliedaifoundation.org/microapps/voyage-reports/quickstart.md): From opening the form on the vessel to seeing a row in PostgreSQL — the whole loop, end to end.
- [Auxiliary Engine Performance](https://docs.appliedaifoundation.org/skills/ae-performance.md): End-to-end pipeline that captures auxiliary engine telemetry, scores blackout risk, classifies SFOC and overhaul exposure, and produces a senior expert review.
- [Certificate Surveillance](https://docs.appliedaifoundation.org/skills/certificates.md): Statutory and trade certificate portfolio tracking — expiry windows, authority gaps, renewal lead-time, and PSC detention-risk scoring.
- [Class Society Surveillance](https://docs.appliedaifoundation.org/skills/class.md): End-to-end pipeline that scrapes class society portals, classifies surveys and certificates by status, scores PSC detention risk, and produces a senior compliance review.
- [Compliance Surveillance](https://docs.appliedaifoundation.org/skills/compliance.md): PSC, SIRE 2.0, CDI, VIR and CII — five regulatory regimes, one detention-and-commercial-impact view.
- [Crew Surveillance](https://docs.appliedaifoundation.org/skills/crew.md): Manning compliance, certificate validity, contract pressure, relief logistics and rest-hour exposure — the four constraints that decide whether a vessel can sail.
- [Defect Surveillance](https://docs.appliedaifoundation.org/skills/defects.md): A unified view of every defect against a vessel — from PSC findings to near-misses to open Conditions of Class — with severity-weighted age scoring and systemic-pattern detection.
- [Flag Circulars Sync](https://docs.appliedaifoundation.org/skills/download-flag-circulars.md): Downloads and syncs the latest official circulars from flag-state authorities — Panama, Singapore, Hong Kong, Marshall Islands, Liberia, Malta, Bahamas.
- [Makers Circulars Sync](https://docs.appliedaifoundation.org/skills/download-makers-circulars.md): Downloads and syncs equipment manufacturer service letters (MAN B&W, Framo, Yanmar, etc.) into the local document library.
- [Emissions Surveillance](https://docs.appliedaifoundation.org/skills/emissions.md): CII, EEOI, EU ETS, FuelEU and IMO DCS — every regulatory regime that turns CO₂ into commercial consequence, with rolling computation and forecast.
- [Vessel Financial Surveillance](https://docs.appliedaifoundation.org/skills/financial.md): Budget vs actual with pro-rata accounting, year-end forecasting, fund-balance tracking, and category-level cost-driver attribution.
- [Technical Forms Surveillance](https://docs.appliedaifoundation.org/skills/forms.md): Form-by-form submission compliance plus the analytical layer that turns each form's data into engineering insights — bearing clearances, scrape-down iron, scavenge condition, and more.
- [Fuel Oil Surveillance](https://docs.appliedaifoundation.org/skills/fuel-oil.md): Bunker quality, ROB position, consumption variance and stem planning — every fuel-borne risk a Technical Superintendent owns, scored and routed.
- [IHM Surveillance](https://docs.appliedaifoundation.org/skills/ihm.md): Inventory of Hazardous Materials — IHM Part I/II/III, MMPL maintenance procedures, certificate status, outstanding tasks under EU SRR and Hong Kong Convention.
- [Image Analysis](https://docs.appliedaifoundation.org/skills/image-analysis.md): AI-vision analysis for any image — describes content in general mode, or assesses equipment condition and renames vessel inspection photos in maritime mode.
- [Image Generator](https://docs.appliedaifoundation.org/skills/image-generator.md): Generates AI images from text prompts — Nano Banana for fast iteration, Nano Banana Pro for professional quality with strong text rendering.
- [LSA / FFA Surveillance](https://docs.appliedaifoundation.org/skills/lsa.md): Life-Saving Appliances and Fire-Fighting Appliances — service history, upcoming maintenance, flag-specific requirements, and the saturday-routine compliance view.
- [Lube Oil Surveillance](https://docs.appliedaifoundation.org/skills/lube-oil.md): End-to-end pipeline that captures lube oil lab analysis, shore-sampling compliance, tank ROB, and consumption — flags wear-metal trends, contamination, and bunker planning gaps.
- [Maritime Report Generator](https://docs.appliedaifoundation.org/skills/maritime-report-generator.md): Turns inspection photos and vessel data into polished, self-contained maritime HTML reports — VIR, Owner's Report, Incident Investigation, Dry Dock.
- [Main Engine Performance](https://docs.appliedaifoundation.org/skills/me-performance.md): End-to-end pipeline that captures main engine telemetry, classifies cylinder uniformity, scores SFOC variance and overhaul exposure, and produces a TSI-grade expert review.
- [Email Surveillance](https://docs.appliedaifoundation.org/skills/outlook-email-sync.md): Sync Outlook inbox into a searchable local store — then track follow-up emails per topic so a Technical Superintendent always knows what's been chased and when.
- [Overview](https://docs.appliedaifoundation.org/skills/overview.md): Reusable capabilities that extend agents — collectors, analyzers, and tools across maritime operations, documents, and reporting.
- [PDF to Markdown](https://docs.appliedaifoundation.org/skills/pdf-to-markdown.md): Extracts PDFs to structured markdown using AI vision — preserves tables, diagrams, and layout, and builds search indexes.
- [PDF Vision Extractor](https://docs.appliedaifoundation.org/skills/pdf-vision-extractor.md): Tiled AI-vision extraction for accurate Q&A on engineering diagrams, maintenance tables, and complex PDF pages.
- [Planned Maintenance Surveillance](https://docs.appliedaifoundation.org/skills/pms.md): Counter-driven maintenance compliance — overdue job ranking, machinery-family rollups, and the maintenance-debt index that tells a TSI which vessel needs attention this week.
- [Procurement Surveillance](https://docs.appliedaifoundation.org/skills/purchase.md): PR-to-payment funnel analysis — aged POs, forwarder backlog, supplier scorecards, safety-critical pipeline tracking.
- [QHSE Investigation Report](https://docs.appliedaifoundation.org/skills/qhse-investigation-report.md): Cross-domain Quality, Health, Safety, and Environment investigation — pulls findings from every QHSE area and links them into one auditable report.
- [Search Indexed Documents](https://docs.appliedaifoundation.org/skills/search-indexed-documents.md): Searches across the maritime document library — IMPA codes, flag circulars, makers circulars, IMO publications, SMS, ship manuals — with exact-quote evidence.
- [Consumption Log Validator](https://docs.appliedaifoundation.org/skills/validate-consumption-log-data.md): Validates vessel noon report and consumption log data before submission to CII, EU MRV, IMO DCS, and FuelEU calculation tools.
- [Vessel Intelligence](https://docs.appliedaifoundation.org/skills/vessel-intelligence.md): Queries and writes vessel intelligence — observations, notes, learnings, cases, and evidence — across vessel and fleet.
- [Voyage Performance Surveillance](https://docs.appliedaifoundation.org/skills/voyage.md): Position, track history, Charter Party compliance, weather-routed performance and demurrage exposure — voyage-level intelligence in one rolling view.
- [Water Treatment Surveillance](https://docs.appliedaifoundation.org/skills/water-treatment.md): Boiler, cooling, potable and FWG chemistry — parameter compliance, contamination risk, and chemical-ROB consumption tracking.

## OpenAPI Specs

- [openapi](https://docs.appliedaifoundation.org/api-reference/openapi.json)