# martinsdesiqueiraigor-art/casillas_app_2 architecture

> Architecture diagram of the GitHub repository martinsdesiqueiraigor-art/casillas_app_2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/martinsdesiqueiraigor-art/casillas_app_2
- Repository: https://github.com/martinsdesiqueiraigor-art/casillas_app_2

## Overview

Casillas 2.0 is a browser-based machining calculator PWA. Users enter through authentication, the app checks trial or commercial entitlement, then routes them to local technical calculators, CNC code generation, reference tables, and guidance; calculations do not require a server. The app also provides CNC consulting and offline resource caching. The graph preserves the documented feature set, while some module-to-calculator links rely on the SOURCE INDEX; unsampled commercial and offline details are represented only where documented.

Main entry points: [`js/app.js`](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/app.js) (App router), [`js/trial.js`](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/trial.js) (Trial and licensing), [`js/auth-page.js`](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/auth-page.js) (Authentication screen), [`js/auth.js`](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/auth.js) (Supabase Auth client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and entitlement"]
  node_authpage["Authentication screen<br/>[auth-page.js]"]
  node_auth["Supabase Auth client<br/>[auth.js]"]
  node_supabase["Supabase SDK<br/>[supabase.bundle.js]"]
  node_trial["Trial and licensing<br/>[trial.js]"]
  node_commercial[("Supabase commercial RPCs")]
end

subgraph group_runtime["Application runtime"]
  node_app["App router<br/>[app.js]"]
  node_state["State and persistence<br/>[state.js]"]
  node_db[("Local database<br/>[db.js]")]
  node_menu["Navigation menu<br/>[menu.js]"]
  node_icons["SVG icons<br/>[icons.js]"]
  node_keyboard["Input keyboard<br/>[keyboard.js]"]
  node_utils["UI utilities<br/>[utils.js]"]
end

subgraph group_calculators["Machining calculators"]
  node_trigui["Trigonometry UI<br/>[trig.js]"]
  node_trigcalc["Trigonometry calculations<br/>[trig.js]"]
  node_coniui["Taper UI<br/>[coni.js]"]
  node_conicalc["Taper calculations<br/>[coni.js]"]
  node_polyui["Polygon UI<br/>[poly.js]"]
  node_polycalc["Polygon calculations<br/>[poly.js]"]
  node_furosui["Circular drilling UI<br/>[furos.js]"]
  node_furocalc["Drilling calculations<br/>[furos.js]"]
  node_roscaui["Thread UI<br/>[rosca.js]"]
  node_roscacalc["Thread calculations<br/>[rosca.js]"]
  node_tolui["ISO tolerance UI<br/>[tol.js]"]
  node_tolcalc["Tolerance calculations<br/>[tol.js]"]
  node_toldata["Tolerance tables<br/>[tolerancias.js]"]
  node_potui["Cutting power UI<br/>[potencia.js]"]
  node_potcalc["Cutting power calculations<br/>[potencia.js]"]
  node_chavui["Keyway UI<br/>[chaveta.js]"]
  node_chavcalc["Keyway calculations<br/>[chaveta.js]"]
  node_chavdata["DIN 6885 key tables<br/>[chavetas.js]"]
end

subgraph group_cnc["CNC tools and guidance"]
  node_prog["CNC code generator UI<br/>[prog.js]"]
  node_gcode["G-code generation<br/>[gcode.js]"]
  node_guia["CNC programming guide<br/>[guia.js]"]
end

subgraph group_references["Reference and support"]
end

node_user(("Machining professional"))

node_user -->|"signs in"| node_authpage
node_authpage -->|"uses Auth"| node_auth
node_auth -->|"calls Auth"| node_supabase
node_user -->|"opens app"| node_app
node_app -->|"checks access"| node_trial
node_trial -->|"checks entitlement"| node_supabase
node_trial -.->|"calls RPCs"| node_commercial
node_app -->|"initializes"| node_db
node_app -->|"loads and saves"| node_state
node_state -->|"reads and writes"| node_db
node_app -->|"initializes routing"| node_menu
node_app -->|"initializes inputs"| node_keyboard
node_menu -->|"renders icons"| node_icons
node_app -->|"loads module"| node_trigui
node_app -->|"loads module"| node_coniui
node_app -->|"loads module"| node_polyui
node_app -->|"loads module"| node_furosui
node_app -->|"loads module"| node_roscaui
node_app -->|"loads module"| node_tolui
node_app -->|"loads module"| node_potui
node_app -->|"loads module"| node_chavui
node_app -->|"loads module"| node_prog
node_app -->|"loads module"| node_guia
node_trigui -->|"calculates with"| node_trigcalc
node_coniui -->|"calculates with"| node_conicalc
node_polyui -->|"calculates with"| node_polycalc
node_furosui -->|"calculates with"| node_furocalc
node_roscaui -->|"calculates with"| node_roscacalc
node_tolui -->|"calculates with"| node_tolcalc
node_tolcalc -->|"reads table"| node_toldata
node_potui -->|"calculates with"| node_potcalc
node_chavui -->|"calculates with"| node_chavcalc
node_chavcalc -->|"reads table"| node_chavdata
node_prog -->|"generates code"| node_gcode

click node_authpage "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/auth-page.js"
click node_auth "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/auth.js"
click node_supabase "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/supabase.bundle.js"
click node_trial "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/trial.js"
click node_app "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/app.js"
click node_state "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/state.js"
click node_db "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/db.js"
click node_menu "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/menu.js"
click node_icons "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/icons.js"
click node_keyboard "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/keyboard.js"
click node_utils "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/utils.js"
click node_trigui "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/trig.js"
click node_trigcalc "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/trig.js"
click node_coniui "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/coni.js"
click node_conicalc "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/coni.js"
click node_polyui "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/poly.js"
click node_polycalc "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/poly.js"
click node_furosui "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/furos.js"
click node_furocalc "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/furos.js"
click node_roscaui "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/rosca.js"
click node_roscacalc "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/rosca.js"
click node_tolui "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/tol.js"
click node_tolcalc "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/tol.js"
click node_toldata "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/data/tolerancias.js"
click node_potui "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/potencia.js"
click node_potcalc "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/potencia.js"
click node_chavui "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/chaveta.js"
click node_chavcalc "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/chaveta.js"
click node_chavdata "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/data/chavetas.js"
click node_prog "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/prog.js"
click node_gcode "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/gcode.js"
click node_guia "https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/guia.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_authpage,node_auth,node_supabase,node_trial,node_commercial toneBlue
class node_app,node_state,node_db,node_menu,node_icons,node_keyboard,node_utils toneAmber
class node_trigui,node_trigcalc,node_coniui,node_conicalc,node_polyui,node_polycalc,node_furosui,node_furocalc,node_roscaui,node_roscacalc,node_tolui,node_tolcalc,node_toldata,node_potui,node_potcalc,node_chavui,node_chavcalc,node_chavdata toneMint
class node_prog,node_gcode,node_guia toneRose
class node_user toneIndigo
```

## Components

### Access and entitlement

- [Authentication screen](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/auth-page.js): `js/auth-page.js`
- [Supabase Auth client](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/auth.js): `js/auth.js`
- [Supabase SDK](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/supabase.bundle.js): `js/supabase.bundle.js`
- [Trial and licensing](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/trial.js): `js/trial.js`
- **Supabase commercial RPCs**

### Application runtime

- [App router](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/app.js): `js/app.js`
- [State and persistence](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/state.js): `js/state.js`
- [Local database](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/db.js): `js/db.js`
- [Navigation menu](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/menu.js): `js/menu.js`
- [SVG icons](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/icons.js): `js/icons.js`
- [Input keyboard](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/keyboard.js): `js/keyboard.js`
- [UI utilities](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/utils.js): `js/utils.js`

### Machining calculators

- [Trigonometry UI](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/trig.js): `js/modules/trig.js`
- [Trigonometry calculations](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/trig.js): `js/calc/trig.js`
- [Taper UI](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/coni.js): `js/modules/coni.js`
- [Taper calculations](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/coni.js): `js/calc/coni.js`
- [Polygon UI](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/poly.js): `js/modules/poly.js`
- [Polygon calculations](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/poly.js): `js/calc/poly.js`
- [Circular drilling UI](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/furos.js): `js/modules/furos.js`
- [Drilling calculations](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/furos.js): `js/calc/furos.js`
- [Thread UI](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/rosca.js): `js/modules/rosca.js`
- [Thread calculations](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/rosca.js): `js/calc/rosca.js`
- [ISO tolerance UI](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/tol.js): `js/modules/tol.js`
- [Tolerance calculations](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/tol.js): `js/calc/tol.js`
- [Tolerance tables](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/data/tolerancias.js): `js/data/tolerancias.js`
- [Cutting power UI](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/potencia.js): `js/modules/potencia.js`
- [Cutting power calculations](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/potencia.js): `js/calc/potencia.js`
- [Keyway UI](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/chaveta.js): `js/modules/chaveta.js`
- [Keyway calculations](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/chaveta.js): `js/calc/chaveta.js`
- [DIN 6885 key tables](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/data/chavetas.js): `js/data/chavetas.js`

### CNC tools and guidance

- [CNC code generator UI](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/prog.js): `js/modules/prog.js`
- [G-code generation](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/calc/gcode.js): `js/calc/gcode.js`
- [CNC programming guide](https://github.com/martinsdesiqueiraigor-art/casillas_app_2/blob/casillas-2.0/js/modules/guia.js): `js/modules/guia.js`

### Other components

- **Machining professional**

## Connections

- Machining professional → Authentication screen: signs in (evidence: `README.md`)
- Authentication screen → Supabase Auth client: uses Auth (evidence: `js/auth-page.js`)
- Supabase Auth client → Supabase SDK: calls Auth (evidence: `js/auth.js`)
- Machining professional → App router: opens app (evidence: `README.md`)
- App router → Trial and licensing: checks access (evidence: `js/app.js`)
- Trial and licensing → Supabase SDK: checks entitlement (evidence: `js/trial.js`)
- Trial and licensing → Supabase commercial RPCs: calls RPCs (evidence: `README.md`)
- App router → Local database: initializes (evidence: `js/app.js`)
- App router → State and persistence: loads and saves (evidence: `js/app.js`)
- State and persistence → Local database: reads and writes (evidence: `js/state.js`)
- App router → Navigation menu: initializes routing (evidence: `js/app.js`)
- App router → Input keyboard: initializes inputs (evidence: `js/app.js`)
- Navigation menu → SVG icons: renders icons (evidence: `js/menu.js`)
- App router → Trigonometry UI: loads module (evidence: `js/app.js`)
- App router → Taper UI: loads module (evidence: `js/app.js`)
- App router → Polygon UI: loads module (evidence: `js/app.js`)
- App router → Circular drilling UI: loads module (evidence: `js/app.js`)
- App router → Thread UI: loads module (evidence: `js/app.js`)
- App router → ISO tolerance UI: loads module (evidence: `js/app.js`)
- App router → Cutting power UI: loads module (evidence: `js/app.js`)
- App router → Keyway UI: loads module (evidence: `js/app.js`)
- App router → CNC code generator UI: loads module (evidence: `js/app.js`)
- App router → CNC programming guide: loads module (evidence: `js/app.js`)
- Trigonometry UI → Trigonometry calculations: calculates with (evidence: `js/modules/trig.js`)
- Taper UI → Taper calculations: calculates with (evidence: `js/modules/coni.js`)
- Polygon UI → Polygon calculations: calculates with (evidence: `js/modules/poly.js`)
- Circular drilling UI → Drilling calculations: calculates with (evidence: `js/modules/furos.js`)
- Thread UI → Thread calculations: calculates with (evidence: `js/modules/rosca.js`)
- ISO tolerance UI → Tolerance calculations: calculates with (evidence: `js/modules/tol.js`)
- Tolerance calculations → Tolerance tables: reads table (evidence: `js/calc/tol.js`)
- Cutting power UI → Cutting power calculations: calculates with (evidence: `js/modules/potencia.js`)
- Keyway UI → Keyway calculations: calculates with (evidence: `js/modules/chaveta.js`)
- Keyway calculations → DIN 6885 key tables: reads table (evidence: `js/calc/chaveta.js`)
- CNC code generator UI → G-code generation: generates code (evidence: `js/modules/prog.js`)
