Overview
Automation enabled

APIM Portal Overview

Quick visibility into the files and artefacts that power the APIM portals. Use the portal selector or feature rail above to jump straight into the PM or Survey experiences, and open frequently used folders in a single click. You can also review the platform health check without leaving the overview.

UI demo

Idle

Launches a Preventive Maintenance checklist walkthrough in a new window and records each step here for review.

UI demo log ready. Press Run UI demo to begin.

    Runtime database

    Monitor and toggle the sqlite storage used by PM and Survey portals.

    Runtime sqlite storage is connected. Checklist and Survey portals can write checklist data.

    Last updated 2025-12-04T22:19:46Z

    Markdown Checklists

    Shared checklist markdown directory

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\docs\checklists

    5 file(s). Latest: Example.md • 2025-11-18 22:44

    Checklist JSONL

    Serialized checklist state

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\docs\checklists\.generated\readme_input_checklist.jsonl

    Updated 2025-11-16 20:45 • 503 B

    Survey Checklist JSONL

    Serialized survey checklist state

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\docs\checklists\.generated\survey_input_checklist.jsonl

    Updated 2025-11-16 20:45 • 503 B

    Checklist TEX Reports

    Timestamped checklist TEX reports under docs/checklists/tex/reports/<slug>

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\docs\checklists\tex\reports\readme

    No files present yet.

    Survey TEX Reports

    Timestamped Survey TEX reports under docs/checklists/tex/reports/survey

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\docs\checklists\tex\reports\survey

    No files present yet.

    Checklist Saved JSONL Reports

    Exports saved from the checklist portal

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\docs\checklists\.generated\savedReports

    1 file(s). Latest: camping_20251117T035825.jsonl • 2025-11-16 22:58

    Survey Saved JSONL Reports

    Exports saved from the survey portal

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\APIM_Survey\docs\jsonl\savedReports

    No files present yet.

    Dev Check Logs

    Log files generated by the overview dev check runner

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\logs\dev_checks

    7 file(s). Latest: pm_contract_pipeline_20250930T140643Z.log • 2025-11-17 06:46

    Private asset staging

    Directory for staged private asset zip bundles

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\APIM_Mod\custom_assets

    1 file(s). Latest: README.md • 2025-11-17 06:25

    CLI testing hooks

    Quick commands for pinging the running portal and validating TEX exports.

    • python tools/ping_portal.py --slug pm --timeout 30 — confirms the root route is healthy and triggers a PM TEX export without opening a browser.
    • python tools/test_tex_exports.py --timeout 30 — writes markers into PM + other checklists, regenerates TEX, and asserts PM stays isolated. Pass --slugs readme sample to skip survey during appendix template work.

    If the script reports missing JSON snapshots, stop the server and run python APIM.py --reset-runtime while the portal is stopped to refresh the PM/Survey snapshots. The harness now auto-regenerates custom slug snapshots (README, sample, etc.) on demand.

    Developer validation runner

    Trigger the automated test and lint suite directly from the overview portal. Results are written into logs/dev_checks so they can be shared alongside manual notes.

    Private assets staging

    Confirm that client-provided markdown, LaTeX, branding, and GLB packs are staged before launching PM or Survey sessions. Review the staging checklist in docs/analysis/private_asset_staging.md for the full workflow.

    Asset pack importer

    Load zipped bundles from APIM_Mod/custom_assets, review validation warnings, and restore the generic placeholder pack when you need to reset the runtime files.

    Before reloading, open PM or Survey and choose Actions → Save State to preserve in-progress work.

    Show staging instructions

    Private asset pack staging

    This directory consolidates the staged asset packs referenced by the Private assets overview tab. Each pack mirrors the runtime directories that must be populated before running PM or Survey exports. The importer planned in docs/private_asset_pack_plan.md will load packs from this folder directly once zip automation is implemented.

    Provided bundles

    Directory Purpose
    apim_generic_assets/ Safe placeholder pack with redacted markdown, LaTeX, branding, and prototype assets. Use this to verify importer flows without touching client materials.
    apim_cvmewt_assets/ Redacted reference that documents the Cvmewt-specific filenames and folder structure expected by production deployments. Replace the placeholders with the actual private copies locally.

    The .txt markers inside each pack indicate where binary assets (GLB, PNG) belong. When preparing a private build, replace the placeholder text with the real files and remove the .txt suffixes before zipping the directory for import. Each pack is organized so its contents can be zipped at the repository root and copied into the runtime directories shown below.

    Tip: The portal overview now exposes a Make asset pack folder button that stages the latest runtime markdown, LaTeX, branding, JSONL saves, and optional GLB assets into a correctly named apim_<slug>_assets directory. Disable the GLB toggle to create the lightweight _lite variant without performing manual file copies.

    APIM_Branding/
      logos/
        cvmewt-logo.png
    docs/checklists/
      pm.md
      survey.md
      tex/templates/
        pm.tex
        survey.tex
    APIM_Survey/
      static/room_design_proto/assets/
        manifest.json
        glb/
        previews/
        textures/
    

    How to use these packs manually

    1. Copy the desired directory from this folder to a safe local workspace.
    2. Replace any placeholder files with the private copies supplied by stakeholders, dropping .txt suffixes from binary assets as you go.
    3. Zip the directory at the repository root (e.g., zip -r apim_generic_assets.zip apim_generic_assets/) or point upcoming automation to the prepared directory.
    4. Launch the runtime and confirm the Private assets tab reports green checks for each directory before running exports.

    Git hygiene

    Do not commit extracted private files or modified packs. Follow the safeguards in docs/analysis/private_asset_staging.md to keep markdown, LaTeX, branding, and GLB assets out of version control. Add any organization-specific ignore rules to .git/info/exclude or a local wrapper script so git status stays clean after loading a private pack.

    Source: C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\APIM_Mod\custom_assets\README.md

    Markdown checklists

    Feeds the Checklist Portal and workspace so launches match the client-approved procedures.

    Ready

    Expected: canonical checklists (pm.md, survey.md, etc.) staged for runtime seeding.

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\docs\checklists

    Checklist LaTeX template

    Controls checklist PDF exports so headers and legal language reflect the engagement.

    Ready

    Expected: Report_Template.tex with branded headers and legal copy.

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\docs\checklists\tex\templates\readme.tex

    Zeiss branding

    Populates logos and marks inside generated checklist and survey exports.

    Ready

    Expected: zeiss-logo-rgb.png and any engagement-specific branding assets.

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\APIM_Branding\logos\cvmewt-logo.png

    GLB pack drop zone

    Supplies Survey 3D prototype assets without checking private files into Git.

    Ready

    Expected: assets.json plus GLB binaries, textures, and thumbnails per pack.

    C:\Users\asher\Documents\caddy-webserver\cvmewt\2025-11-22_APIM_Python\APIM_Survey\static\room_design_proto\interactive_3d_room\assets