ENGINE 08

SFS-E08-ATL · DOCUMENTATION-AS-ARTIFACT · REV 2026-07-20 · PRODUCTION

PRODUCTION = runnable end-to-end, CI-backed, full test suite passing. All data fictional.

Finance Operations Atlas

A finance department's operating map, generated as one self-contained HTML file

Finance Operations Atlas turns a typed Python model of drives, recurring workstreams, a location directory, and calendar events into a deterministic single-file HTML map. The fictional demonstration runs locally with no server, build chain, external resources, or third-party dependencies.

The map and renderer live in source. Every structural count on this page is recomputed by the Atlas CLI or its test suite.

Run it Book a consultation

Architecture

functional block stack · static overview

Select a layer

The Atlas is a data-to-artifact pipeline. Select a layer to see what it contributes to the generated map.

Key specifications

at a glance

2,952¹

Tests

the checks that pin the model, generator, artifact, and confidentiality boundary

5²

Views

five ways into one shared operating model

5 nodes · 14 briefings³

Map coverage

four fictional drives, the systems group, and their mapped areas

4 · 24 steps⁴

Process coverage

recurring workstreams and their clickable process steps

33 rows⁵

Find It

location entries filter as the user types

16 events⁶

Calendar

the recurring finance rhythm keyed to a December 31 year-end

What it does for you

plain terms

Finance teams depend on structural knowledge: where records live, how recurring processes run, what conventions mean, and when work happens. When that context is scattered across people's memories and disconnected documents, onboarding slows down and handoffs become fragile.

Find a record without relying on someone's memory⁷. The Find It view filters the location directory as the user types, connecting a requested record to its declared location and working notes. The demonstration carries 33 searchable rows across finance functions.

Open a recurring process at the step that matters⁸. Four workstream pipelines expose 24 clickable steps. Each step can show its declared inputs, outputs, locations, and watch-fors without requiring a separate process document.

Regenerate and redistribute one portable map⁹. Update atlas_data.py, rerun the standard-library generator, and redistribute one HTML file. With unchanged data, repeated runs produce byte-identical output, keeping review focused on real model changes.

Functional block diagram

engineering · each block links to its source

Plain terms

Atlas Data Model. declares the fictional department map
Payload Builder. prepares one consistent map for every view
Deterministic Render. combines the data with the page shell
Single HTML File. opens locally without a server
Five Atlas Views. turn the same model into browsable operating context

Engineering

Atlas Data Model. frozen dataclasses, tuples, metadata, and palette tokens
Payload Builder. flattens dataclasses, resolves palette keys, and preserves source order
Deterministic Render. escapes metadata, serializes safe JSON, and substitutes inline CSS and JavaScript
Single HTML File. one committed UTF-8 artifact with no external resource tags or URLs
Five Atlas Views. Overview, Drive Map, Workstreams, Find It, and Calendar render client-side

Instruction set

every public command

Command	Operation	Output	Exit	Artifacts
`py generate.py`	render the Atlas to its default path	model-count summary and output path	0	out/finance-operations-atlas.html
`py generate.py --out somewhere.html`	render to a chosen output path	model-count summary and chosen path	0	somewhere.html
`py generate.py --help`	show the Atlas generator options	usage: generate.py [-h] [--out OUT]	0	none
`py -3 -m pytest -q`	run the Atlas test suite	pytest pass/fail summary	0 when the suite passes	none
`py -3 -m pytest --collect-only -q -o addopts=`	collect the Atlas test inventory without running it	2,952 tests collected	0	none

Benchmarks

measured demo results

Measure	Result
Repeat-build stability¹⁰	byte-identical across two generator runs unchanged source produces an unchanged artifact
Drive-map coverage¹¹	5 + 14 drive/system nodes + folder briefings
Workstream coverage¹²	4 / 24 workstreams / clickable steps
Location directory¹³	33 Find It rows
Recurring calendar¹⁴	16 monthly, quarterly, and annual events
Engine tests¹⁵	2,952 tests

Control characteristics

engineering

Plain terms

The Atlas guarantees a reproducible offline document generated from declared source data; it is not a live control, verification, or approval system.

Engineering

Deterministic envelope. offline default mode.

No timestamps and no randomness: unchanged source data renders byte-identical output.
One self-contained HTML document: CSS, payload JSON, and dependency-free JavaScript are embedded with no server, CDN, or external resources.
All entities, people, paths, platforms, banks, and figures in the demonstration are fictional; tax content references public law only.
Native buttons, labelled regions, visible keyboard focus, responsive layouts, and reduced-motion handling are built into the generated page.

Operating limits

what it refuses to do

This is a fictional demonstration artifact, not a published map of any real finance department, entity registry, drive, system, bank, or person.¹⁶
The Atlas renders the structure declared in atlas_data.py; it does not connect to, inspect, synchronize, or update live drives and systems.¹⁷
Updating the map requires editing its source data, rerunning the generator, and redistributing the resulting file; the artifact is not a live discovery service.¹⁸
Tax content is limited to public-law references for CRA Form T1134 and the Regulation 5907 series.¹⁹

See it run

brand animation

Isometric Finance Operations Atlas concept linking entities and bank accounts to systems and a canonical source, with a stale copy labelled as flagged — Concept visual from the repository's Atlas media. The generated Atlas is a fictional static-data demonstration, not a live system monitor.

Integration

how to run it

Distribution: public repository, MIT license.

git clone https://github.com/sophonfinance-wq/finance-automation-portfolio.git && cd finance-automation-portfolio/finance-atlas && py generate.py

py generate.py --out somewhere.html

Source on GitHub Engine README All tests, by engine Run in Codespaces

Substantiation

1py -3 -m pytest --collect-only -q -o addopts= (finance-atlas/); 2,952 tests collected on 2026-07-21 and pinned in site-datasheets/counts.json
2finance-atlas/README.md — What the artifact contains: Overview, Drive Map, Workstreams, Find It, and Calendar
3finance-atlas/generate.py main() derives len(DRIVES) and the folder total; py -3 generate.py --out <temp> reported 5 (+14 folder briefings)
4finance-atlas/generate.py main() derives len(WORKSTREAMS) and the step total; py -3 generate.py --out <temp> reported 4 (24 steps)
5finance-atlas/README.md — Find It is a live-filtered 33-row lookup table; cross-checked by finance-atlas/generate.py CLI output
6finance-atlas/README.md — Calendar contains 16 monthly, quarterly, and annual events; cross-checked by finance-atlas/generate.py CLI output
7finance-atlas/README.md — What the artifact contains and 60-second tour; finance-atlas/atlas_data.py FINDIT
8finance-atlas/README.md — Workstreams; finance-atlas/generate.py main() reported 4 workstreams and 24 steps
9finance-atlas/README.md — The problem it solves and Regenerate it; finance-atlas/atlas_tests/test_generator.py
10finance-atlas/atlas_tests/test_generator.py — test_two_generator_runs_are_byte_identical; locally reproduced on 2026-07-20 with matching SHA-256 hashes
11finance-atlas/generate.py main() live CLI summary; finance-atlas/atlas_data.py DRIVES
12finance-atlas/generate.py main() live CLI summary; finance-atlas/atlas_data.py WORKSTREAMS
13finance-atlas/README.md — 33-row Find It table; finance-atlas/atlas_data.py FINDIT
14finance-atlas/README.md — 16 events; finance-atlas/atlas_data.py CALENDAR
15py -3 -m pytest --collect-only -q -o addopts= (finance-atlas/); verified 2026-07-20 and pinned in site-datasheets/counts.json
16finance-atlas/README.md — demonstration-artifact disclaimer; finance-atlas/atlas_data.py module docstring
17finance-atlas/README.md — single self-contained page with no server or external resources; finance-atlas/generate.py imports and render path
18finance-atlas/README.md — documentation-as-artifact workflow and Regenerate it
19finance-atlas/README.md — demonstration-artifact scope; finance-atlas/atlas_data.py module docstring

Show us where the hours go.

One conversation: you describe the work that consumes your team's month; we tell you plainly what this engine can take over, what it can't, and what a scoped first phase would cost. Your people keep approval authority.

Book a free consultation