Operations Manual & Feature Guide

This document provides an in-depth operational, functional, and technical walkthrough of every page, component, modal popup, and action button across 3CN platform.

Portal Location: Home Page (/)

Controls & Buttons Map

• ① Upper TV Thematic Ticker: Dynamic banner grouping news into thematic clusters (⭐ TOP, 🤖 TECH, 🚀 SPACE, 🧬 BIO, ⚛️ QUANTUM). Clicking a cluster isolates and displays only news belonging to that topic.
• ② [ ‹ Yesterday ] Button: Loads previous day's edition while preserving current podcast audio queue state.
• ③ 📅 Today's Edition Badge: Central pill showing current edition date; clicking it instantly returns to today's edition.
• ④ [ Next › ] Button: Advances towards newer editions (disabled on today's edition).
• ⑤ [ 🎙️ Listen to this Edition ] Button: Enqueues the entire day's package into MantoX Radio, automatically playing Track 0 Radio Host Intro followed by the 3 articles (see Chapter 02 MantoX Radio).
• ⑥ Bookmark Icon 🔖 (on NewsCard): 1-click toggles article saving to browser localStorage (see Chapter 06 Local Bookmarks).
• ⑦ Source & License Badge: Displays original publisher (e.g., NASA, Nature, Phys.org) with direct link to source paper and CC BY 4.0 open license compliance.

Configuration & Parameter Domain

Portal Location: Floating Upper Player & Playlist Drawer

Controls & Buttons Map

• ① Play / Pause Button (fa-play / fa-pause): Starts or pauses playback with seamless HTML5 audio buffering.
• ② Previous / Next Track Buttons: Instantly jumps between articles without interrupting playback session.
• ③ Timeline Scrubbing Bar: Interactive slider to seek forward/backward with real-time timestamps ("01:24 / 03:45").
• ④ Speed Pills (1.0x, 1.25x, 1.5x): Adjusts speech tempo in real time while preserving natural voice pitch.
• ⑤ Playlist Button (fa-list-ol): Opens sliding playlist drawer; allows jumping to any track or removing tracks with ✕.
• ⑥ Minimize / Close Button: Minimizes player to a floating pill or stops audio completely.

Configuration & Parameter Domain

Portal Location: News Archive (/news)

Controls & Buttons Map

• ① Neural Search Bar (fa-brain): Reactive search input with 300ms debounce. Typing displays the green .search-ai-active-pill indicating ONNX vector search is engaged.
• ② Timeframe Switcher Pills ([ 7D | 1M | 3M | 1Y | All ]): Instantly recalculates (0ms latency directly from cached RAM) category proportions and Donut Chart slices across 7 days, 1 month, 3 months, 1 year, or the entire archive.
• ③ SVG Vector Donut Chart: Circular chart with proportional colored slices ensuring 100% exact coverage, interactive hover tooltips, and dynamic centered counter.
• ④ Interactive Category Cards (e.g., 🔬 Science (20.8%)): Filters archive with 1 click navigating to clean canonical SEO URL /news/category/science.
• ⑤ Interactive Hashtag Cloud (e.g., #quantum (12)): Popular topic pills leading directly to clean route /news/topic/quantum.
• ⑥ 🧠 AI 94% Result Badge: Displays Cosine Similarity score computed by local all-MiniLM-L6 INT8 neural model.
• ⑦ 🔤 Keyword Result Badge: Indicates exact text match on title, tags or content.
• ⑧ In-Memory Filter State: Ad-hoc searches and advanced filters are kept in memory (Scoped); navigating back from an article restores scroll position and active filters without polluting URL query strings.
• ⑨ [ 🔖 Saved for later (N) ] Filter Chip: Isolates all articles saved in user's local bookmarks (see Chapter 06 Bookmarks).

Configuration & Parameter Domain

Portal Location: Article Detail Page (/article/...) & NewsCards

Controls & Buttons Map

• ① [ 👶 Explain it simply ] Pill: Displays simplified explanation rewritten with metaphors for non-specialists.
• ② [ ⚖️ Pros and Cons ] Pill: Displays balanced critical analysis weighing benefits against technological limitations or ethical costs.
• ③ [ 🔭 What lies ahead ] Pill: Displays 5-year future outlook and industrial/health implications.
• ④ Glassmorphic Answer Card: Translucent popup appearing beneath pills with smooth animation and ✕ dismiss button.
• ⑤ Copy Link Button (fa-link): Copies direct permalink with anchor tag to clipboard.

Configuration & Parameter Domain

Portal Location: Fullscreen Immersive Overlay

Controls & Buttons Map

• ① [ 📖 Zen Mode ] Toggle Button: Engages fullscreen reading canvas, hiding header, footer and sidebars.
• ② ☀️ Day / 📜 Sepia / 🌙 OLED Selectors: Switches canvas paper styles instantaneously.
• ③ Font Scaler Controls (A- / A+): Dynamically scales typography and persists preferences.
• ④ [ ✕ Exit ] Button: Dismisses Zen mode (also bound to physical ESC keyboard key).

Portal Location: Header & Sliding Lateral Drawer

Controls & Buttons Map

• ① Header Bookmark Icon: Displays live saved count (e.g., 🔖 (3)); clicking opens slide-in drawer.
• ② Saved News List: Compact cards with title, category badge and date; clicking navigates directly to article.
• ③ Delete Single Bookmark (fa-trash-can): Instantly removes article from local storage.
• ④ [ 🎙️ Add all to Radio Playlist ] Button: Bulk loads all saved bookmarks into MantoX Radio player (see Chapter 02 MantoX Radio).
• ⑤ [ Clear All ] Button: Empties all saved bookmarks after a quick confirmation.

Portal Location: Login Page (/login)

Controls & Buttons Map

• ① OTP Input Field: Secure box to enter single-use timed token.
• ② [ Sign In ] Button: Cryptographically validates token and establishes secure server-side session.
• ③ Logout Button (fa-right-from-bracket): Present in all admin headers; terminates session and redirects to Home.

Configuration & Parameter Domain

Portal Location: Review Dashboard (/review)

Controls & Buttons Map

• ① Deploy Version Badge: Displays timestamp of currently running server build.
• ② Context Help Icon ((i)): Opens this manual chapter in a new browser tab.
• ③ [ Scheduler Dashboard ] Button: Quick jump to Quartz engine console (Chapter 11 Scheduler).
• ④ ⭐ Average Rating: X.X KPI Pill: Real-time average quality score given by AI to pending drafts.
• ⑤ [ 🚀 Batch Scheduling & Publishing ] Button: Expands scheduler panel to assign approved news into daily publication slots (Morning 08:00, Afternoon 13:30, Evening 19:30).
• ⑥ [ ✅ Approve ] Button (on Card): Sets status to Approved, ready for timed release.
• ⑦ [ ❌ Reject ] Button (on Card): Rejects article (Rejected status) permanently discarding it.
• ⑧ [ ✏️ Edit ] Button (on Card): Opens in-place quick editing modal (👉 Read Chapter 09 QuickEditModal).
• ⑨ [ 🔄 Reprocess ] Button (on Card): Opens AI model regeneration modal (👉 Read Chapter 10 ReprocessModal).

Configuration & Parameter Domain

Portal Location: Modal Window on /review (Click ✏️ Edit)

Controls & Buttons Map

• ① Language Switch Tabs ([ 🇮🇹 Italian ] / [ 🇬🇧 English ]): Instantly switches between localized Italian and English fields.
• ② "Field to Edit" Dropdown:
  1. 📌 Article Title: Edits headline displayed across cards and article pages.
  2. 📖 Main Content: Modifies popular science article body.
  3. 🧠 Expert Insight (Bonus): Modifies specialist technical analysis.
  4. 🏷️ Category & Hashtags: Modifies category and #hashtag list.
  5. 👶 Smart Q&A: Explain Simply: Edits simplified explanation (see Chapter 04).
  6. ⚖️ Smart Q&A: Pros and Cons: Edits critical balanced analysis.
  7. 🔭 Smart Q&A: What Lies Ahead: Edits 5-year outlook.
• ③ Dynamic Input Field / Textarea: Automatically pre-fills with current database value.
• ④ [ Cancel ] Button: Closes modal without saving changes.
• ⑤ [ 💾 Save Changes ] Button: Writes update to database and updates underlying card with green confirmation feedback.

Portal Location: Modal Window on /review (Click 🔄 Reprocess)

Controls & Buttons Map

• ① "Reprocess Now (Live)" Radio: Executes synchronous LLM call in real-time during your session.
• ② "Target AI Model" Dropdown: Selects specific LLM model (e.g., google/gemma-2, meta-llama/llama-3, openrouter/free).
• ③ "Enqueue (Batch)" Radio: Resets status to raw for processing in next scheduled batch (Chapter 11 Scheduler).
• ④ [ ⚡ Reprocess ] Button: Triggers execution with animated spinner and live UI update.

Portal Location: Scheduler Dashboard (/Sched)

Controls & Buttons Map

• ① Tool Hub Modules (4 Large Buttons): Direct access to system tools:
  • 📁 File Manager: Filesystem & Storage Explorer (Chapter 13).
  • 🎛️ Live Config: Zero-downtime runtime parameter overrides (Chapter 14).
  • 🌐 Resources & RESX: Bilingual UI text manager (Chapter 15).
  • 💾 SQL Console: 15 diagnostic presets & query console (Chapter 12).
• ② Content Monitor ([ Refresh ] Button): Live counts of DB Articles, TTS Audio, and AI Enrichment.
• ③ [ 🧹 Force Garbage Collection ] Button: Manually triggers .NET GC and compacts Large Object Heap (LOH) to release RAM after heavy embeddings generation.
• ④ [ Refresh RAM Metrics ] Button: Reloads App WorkingSet and Server RAM load percentage.
• ⑤ [ ⚡ Run Now ] Button (on Quartz Job): Triggers immediate batch execution without waiting for cron schedule.
• ⑥ Override Execution Flags Box: Input field to supply custom flag strings (e.g., news,tts) for granular execution.

Pipeline Execution Flags (Elab String)

🍳 Pipeline Flag Recipes for Real-World Scenarios

Portal Location: Tool Hub ➔ SQL Console (/sql)

Platform Highlights ("Chicche")

• 15 Diagnostic Presets: Pre-built queries categorized into Workflow & States (In Review, In Queue, Raw Feeds, Discarded, Errors), AI & Semantic Search (Missing Vectors, Missing Insights, Rating ≥ 8.5, LLM Models), and System & Quartz (Triggers, Row Counts).
• In-Place Record Editor Modal: Selecting any row in the grid activates the [ ✏️ Edit Record ] button, opening a modal to update field values with schema validation without writing manual UPDATE statements.
• Dynamic Typography Zoom (S / M / L): Switch grid density between Small (ultra-compact inspection), Medium (standard), and Large (presentation or accessibility).
• RFC 4180 CSV Export: Instant client-side generation of Excel-compatible CSV files with UTF-8 BOM, escaped separators and preserved timestamps.

Controls & Buttons Map

• ① Table Sidebar Toggle ([ Show Tables ] / [ Expand View ]): Collapses or restores the left table navigation tree to maximize query visualization space.
• ② Left Panel "Database Tables": Displays all database tables with real-time row counts; clicking any table automatically generates a SELECT TOP 50 * query in the editor.
• ③ Filter Tables Field: Instant search input to filter tables and views in real-time.
• ④ "Quick Queries (15 Diagnostic Presets)" Dropdown: Instant execution of key queries across editorial, AI, and scheduler operational domains.
• ⑤ [ Execute Query ] Button: Runs SQL query with 100-row safety limit, displaying execution time (e.g. "⏱️ 12 ms").
• ⑥ Font Zoom Density Selector (S / M / L): Instantly adapts table typography size and padding.
• ⑦ [ ✏️ Edit Record ] Button: Opens the modal editor on the selected row (Fig. 12.2).
• ⑧ [ 📄 Export CSV ] Button: Downloads query results in RFC 4180 compliant CSV format.

Parameters & Configuration Domain

Portal Location: Tool Hub ➔ File Manager (/files)

Platform Highlights ("Chicche")

• Directory Tree Export Modal: Generates a full text report of the entire application directory hierarchy, detailing sizes, file counts, and subdirectories (Fig. 13.2).
• Integrated Audio Player: Click any generated MP3 file to stream audio directly inside the browser without downloading.
• Secure File Upload Modal: Upload configuration or data files with automatic extension validation and size constraints (Fig. 13.3).
• Real-Time Filter: Instant client-side search across all file and directory names in the current folder.

Controls & Buttons Map

• ① Navigable Breadcrumbs: Clickable path segments to navigate back to parent folders (e.g. Root › private › backup).
• ② [ 🌳 Export Directory Tree ] Button: Opens modal to generate and download structured directory reports (Fig. 13.2).
• ③ [ ➕ Upload File ] Button: Opens modal to upload files into active folder (Fig. 13.3).
• ④ File Search Bar: Filters items in the current directory view.
• ⑤ Action Buttons on File Rows:
  • 👁️ Preview: Views text or opens audio player.
  • ⬇️ Download: Downloads file directly to local disk.
  • 🗑️ Delete: Opens confirmation modal before permanent removal.

Parameters & Configuration Domain

Portal Location: Tool Hub ➔ Live Config (/config)

Platform Highlights ("Chicche")

• Zero-Downtime Overrides: Updates parameters in memory immediately without restarting IIS or interrupting running Quartz jobs.
• Tree vs Flat View Modes: Toggle between collapsible section tree and full searchable flat table with a single click.
• Secrets Masking & Reveal: API keys, passwords, and tokens are masked by default (`••••••••••••••••`) with a toggle button to reveal values securely.
• New Key Registration Modal: Register new hierarchical properties with automatic type detection (Fig. 14.2).

Controls & Buttons Map

• ① View Mode Selector ([ 📁 Sections ] / [ 📋 Flat List ]): Switches between hierarchical section tree and flat list.
• ② [ ➕ New Key ] Button: Opens modal to register a new configuration property (Fig. 14.2).
• ③ Search Bar: Real-time filtering across keys and values.
• ④ [ ✏️ Edit ] Button: Switches row into inline editor (with boolean toggle switch or text input).
• ⑤ [ 👁️ Eye ] Button: Unmasks/masks secret values.

Parameters & Configuration Domain

Portal Location: Tool Hub ➔ Resources & Languages (/resources)

Platform Highlights ("Chicche")

• Missing Translations Diagnostic Tabs: Filter tabs [ Missing in EN (N) ] and [ Missing in IT (N) ] isolate untranslated keys instantly, ensuring 100% bilingual parity.
• Side-by-Side Bilingual Editor: Edit Italian and English text simultaneously with instant preview of formatting.
• Atomic Disk & Memory Sync: Changes are saved directly into `.resx` XML files and updated in the in-memory cache without application restarts.
• New Bilingual Key Registration Modal: Create new localized strings with both Italian and English values in one operation (Fig. 15.2).

Controls & Buttons Map

• ① [ All (N) ] Filter Tab: Shows all registered translation keys.
• ② [ Missing in EN (N) ] Filter Tab: Isolates keys lacking English translation for fast completion.
• ③ [ Missing in IT (N) ] Filter Tab: Isolates keys lacking Italian translation.
• ④ [ ➕ New Key ] Button: Opens modal to register a new bilingual key (Fig. 15.2).
• ⑤ [ ✏️ Edit ] Button: Activates side-by-side editing textareas for Italian and English.

Parameters & Configuration Domain

Portal Location: Public Endpoints (/llms.txt, /llms-full.txt) & HeadContent (/{slug})

Specifications & Endpoint Map

• ① GET /llms.txt Endpoint: Delivers a concise platform overview in clean Markdown for AI Crawlers: editorial mission, canonical category links, and current top stories.
• ② GET /llms-full.txt Endpoint: Full structured text dump with article summaries, expert insights, and Smart Q&A takeaways (ELI5, Pros & Cons, What's Next) enabling generative engines to cite 3CN as a primary source.
• ③ Schema.org NewsArticle Graph: Emits ISO 8601 publication/modification timestamps, author, category, tags, and canonical URL in every article's <head> block.
• ④ AudioObject Attachment: Directly links the neural HD MP3 podcast track to the article for search cataloging and Google News audio features.
• ⑤ FAQPage Entity: Models the 3 Smart Q&A flash pills as structured Question/Answer pairs to trigger expandable Rich Snippets in Google Search results.

Portal Location: Batch Scheduler & Console (/Sched) & Review Workflow (/review)

Controls Map & KPI Cards

• ① "SEO Compliance" Card: Measures the percentage of published articles with complete metadata, valid bilingual SEO slugs and clean summaries; the info icon (i) shows a descriptive tooltip on hover.
• ② "XML Sitemap" Card: Live count of URLs mapped in the /sitemap.xml endpoint (articles, categories, institutional pages), ensuring no approved content remains unindexed.
• ③ "Robots Directives" Card: Operational status of /robots.txt, configured to welcome Googlebot, Bingbot, and LLM web crawlers (GPTBot, PerplexityBot, ClaudeBot), while protecting private administrative routes.
• ④ "Structured Data" Card: Count of active Schema.org JSON-LD graphs (NewsArticle, BreadcrumbList, AudioObject, FAQPage) verified at runtime.
• ⑤ "IndexNow Push" Card: Monitors real-time connection status to the IndexNow protocol, reporting "Ready" or the count of URLs successfully synced with Bing and partner search networks.
• ⑥ [ ⚡ Push to IndexNow ] Button: Triggers bulk submission of all published articles to the IndexNow API (https://api.indexnow.org/indexnow) via serialized batches validated by domain host key verification (/{key}.txt).
• ⑦ [ 🗺️ XML Sitemap ] Button: Opens the dynamic XML sitemap in a new tab for direct inspection of <lastmod> timestamps and entry structure.
• ⑧ [ 🤖 Robots.txt ] Button: Immediately inspects the live crawler directive file to confirm user-agent permissions and sitemap pointer.
• ⑨ [ 🔍 Search Console ] Button: Direct shortcut to the verified Google Search Console property to monitor impressions, clicks, rankings and crawl health.
• ⑩ SERP & Schema.org Inspector: Interactive preview widget displaying the exact search snippet rendering (title, date, breadcrumb, description) alongside the live JSON-LD payload for any selected article.

Parameters & Configuration Domain

Portal Location: Tool Hub ➔ Backup Manager (/tools/backup) & Pre-Deploy Rollback Script

Resilience Highlights ("Chicche")

• Automated Pre-Deploy Snapshot: Every publish script run automatically bundles a timestamped compressed ZIP archive of the entire IIS application folder and a native SQL Server backup before overwriting a single byte.
• Instant 30-Second Rollback: In case of post-deployment exceptions or regressions, administrators can restore the previous known-good deployment with a single PowerShell command, completely eliminating downtime.
• Emergency RecoveryKey Procedure: If administrator email delivery is unavailable, the emergency URL /login?token=RECOVERY_KEY safely triggers a fresh magic link without exposing credentials or introducing insecure production bypasses.
• Automated Retention & Disk Pruning: Snapshots older than the configured threshold (default: 30 days) are automatically pruned by background maintenance jobs to prevent storage saturation.

Controls Map & Operational Boxes

• ① Snapshot Statistics & Storage Footprint: Real-time counter of available restore points, timestamp of latest verified backup, and total disk usage.
• ② [ 💾 Create New Backup ] Button: Opens modal to execute on-demand hot backups (SQL Database, Media Assets, or Full System Snapshot).
• ③ Chronological Snapshots Table: Detailed list with creation timestamps, archive file sizes, backup scopes, SHA-256 checksums, and notes.
• ④ [ ⬇️ Download Archive ] Button: Downloads selected `.zip` backup archive for secure off-site cold storage.
• ⑤ [ 🔄 Restore ] Button: Initiates guarded recovery modal with mandatory confirmation to prevent accidental overwrites.
• ⑥ [ 🗑️ Delete Snapshot ] Button: Permanently deletes obsolete backup files to reclaim disk volume capacity.

Guided Restore Modal (Fig. 18.2)

Emergency Quick Rollback Workflow (IIS Production)

Parameters & Configuration Domain