Comci Agent Sites UI

Public web UI and Sites deployment layer for Comci Agent.

This repository is not the canonical Comci Agent core. The canonical CLI, REST contract, MCP server, automation behavior, provider integration, and release ownership live in techkwon/comci-agent. Use this repository only for the public browser experience, same-origin API proxy routes, and ChatGPT Sites deployment assets.

Links

Target	URL
Public site	https://comci-agent-timetable-20260807.techkwon.chatgpt.site
Site source	https://github.com/techkwon/comci-agent-sites-ui
Canonical core source	https://github.com/techkwon/comci-agent

Repository Boundary

Choose the canonical core repository for:

• Python CLI behavior and packaged releases
• REST schema ownership and compatibility changes
• MCP server behavior
• upstream provider integration, diagnostics, retries, and normalization
• automation, watch mode, snapshots, and non-browser workflows

Choose this site repository only for:

• public web UI copy, layout, accessibility, and responsive behavior
• same-origin browser API proxy routes under /api/v1/*
• Sites deployment metadata and static public assets
• anonymous UI examples that demonstrate where user-provided values belong

Privacy Behavior

• The site does not preselect a real school.
• Examples use anonymous placeholders such as 학교명, 00000, teacher 1, grade 1, and class 1.
• Public artifacts must not include real school identifiers, protected school names, real teacher names, or real timetable records.
• Browser requests go through this site's server-side provider/proxy path. The browser must not call upstream timetable pages directly.
• Teacher names shown by the UI should remain masked or redacted when that behavior belongs to the core contract.

Capability And Status Boundaries

The public UI can show school search, teacher/class timetable lookup, change inspection, schema links, doctor links, and CLI install examples when the backing provider is available.

This repository does not prove upstream availability. Health pages and rendered UI only prove that the site is deployed and can route requests. Treat provider status, CLI correctness, REST schema changes, MCP behavior, and automation behavior as canonical-core concerns and verify them in techkwon/comci-agent.

This is not an official Comcigan product, official API, or partner service. It must not bypass login, CAPTCHA, access controls, or non-public data boundaries.

Local Development

Node.js 22.13 or newer is required.

npm install
npm run dev

The local default URL is http://localhost:3000.

Verification

Run the site checks from this repository:

npm run lint
npx tsc --noEmit -p tsconfig.app.json
npm test
npm audit --omit=dev

npm test builds the Vinext app, runs domain/provider/API contract tests, and runs the rendered HTML test.

The CLI examples displayed by the site are anonymous usage examples for the canonical core project. Do not treat this repository as the place to validate CLI implementation behavior.

Public API Proxy Routes

• GET /health/live
• GET /health/ready
• GET /api/v1/schools?name=
• GET /api/v1/teachers?school_code=&date=
• GET /api/v1/teachers/{teacher_id}/day?school_code=&school_name=&date=
• GET /api/v1/teachers/{teacher_id}/week?school_code=&school_name=&date=
• GET /api/v1/classes/{grade}/{class_no}/day?school_code=&school_name=&date=
• GET /api/v1/classes/{grade}/{class_no}/week?school_code=&school_name=&date=
• GET /api/v1/changes?scope=&school_code=&school_name=&...
• GET /api/v1/schema/{name}
• GET /api/v1/doctor

Successful responses use the documented envelope shape: schema_version, request_id, ok, data, and warnings. Core schema ownership belongs to techkwon/comci-agent.

License

Source-visible proprietary software. See LICENSE. Public repository visibility does not grant reuse, modification, or redistribution rights.