# RFLF VOC Kinetics Lab - Technical Specification

## Application

- Framework: React 19 + TypeScript + Vite/TanStack Start.
- Styling: Tailwind CSS v4 and local design tokens.
- Charts: Recharts.
- Icons: Lucide React.
- Runtime data: local JSON only; no remote API calls.
- Deployment target: static/serverless Vercel-compatible build.

## Project configuration

All public links are centralized in `src/lib/project-config.ts`:

- final report: `/downloads/FAPESP_RFLF_Final_Report.pdf`
- experimental workbook: `/downloads/RFLF_VOC_Kinetics_Experimental_Data.xlsx`
- complete package: `/downloads/RFLF_VOC_Kinetics_Project.zip`
- methodology: `/downloads/methodology.md`
- technical specification: `/downloads/technical_specification.md`
- QA report: `/downloads/QA_REPORT.md`

Internal download links use the HTML `download` attribute. The GitHub link remains external.

## Data files

The website reads the following files from `src/data/`:

- `dashboard_kpis.json`
- `workflow_steps.json`
- `reactor_configuration.json`
- `catalyst_characterization.json`
- `calibration_limits.json`
- `experiment_plan.json`
- `experimental_data.json`
- `kinetic_parameters.json`
- `model_curves.json`
- `butanone_case.json`
- `methodology_sources.json`
- `qa_controls.json`
- `source_notes.json`

## Diagram implementation

Both principal diagrams are inline accessible SVG components in `src/components/site/diagrams.tsx`.

### `PhotocatalysisMechanism`

The diagram is formatted to reproduce the report's scientific sequence without overlapping labels:

- valence band (BV/HOMO) below conduction band (BC/LUMO);
- 254 nm photon absorption and band-gap excitation;
- electron-hole pair generation;
- charge migration to surface sites;
- reduction route at the upper surface and oxidation route at the lower surface;
- explicit boundary that only parent-VOC disappearance was measured.

### `ReactorSchematic`

The diagram represents the complete evidence chain shown and described in the report:

- compressor, heat exchanger, adsorption dryer and rotameter;
- separate H2O and VOC bubbler branches;
- annular RFLF with concentric UVC lamp;
- cyclone, solids reservoir and screw feeder recirculation;
- exhaust hood;
- inlet/outlet sampling taps;
- low-flow peristaltic pump, valve relay, GC-PID/TID and data acquisition;
- Q, Gs, RH/T/P and Delta P measurement context.

## Favicon

`public/favicon.ico` is generated from the same rounded cyan-teal-emerald flask mark used in the navigation brand tile. `public/favicon.svg` is retained as the vector source.

## Download artifacts

- The PDF is a direct conversion of the supplied final scientific-report DOCX.
- The XLSX workbook contains summary, experimental data, reconstructed curves, kinetic parameters, calibration limits, reactor configuration, catalyst details, the butanone case, QA controls and sources/normalisation notes.
- The complete ZIP contains the report, workbook, structured data, reproducible model script/notebook, report figures, documentation and a clean website-source snapshot.

## Build and verification

The delivery is accepted only when:

1. `npm run build` succeeds without TypeScript errors.
2. all six local download paths exist;
3. the final report PDF renders as 45 pages;
4. the XLSX workbook contains no formula-error tokens in the checked ranges;
5. the complete package ZIP opens and contains the declared folders;
6. the favicon is a valid multi-resolution ICO file.