https://mwiki.costasano.club/index.php?action=history&feed=atom&title=ICT%3ANumbering_v_4.1 2026-07-22T23:28:18Z Revision history for this page on the wiki MediaWiki 1.45.1 https://mwiki.costasano.club/index.php?title=ICT:Numbering_v_4.1&diff=259&oldid=prev 2026-01-30T12:05:03Z

<p>Created page with &quot;= Numbering and Identifier Policy = This page defines the official policy for identifiers, numbering, and file naming within the Costasano Heritage Database. It establishes a single, consistent strategy to ensure: * uniqueness * predictability * stability over time * minimal editorial effort * long-term maintainability Identifiers are technical labels only. They must never encode interpretation or semantics beyond grouping and sequencing. == Scope == This policy...&quot;</p> <p><b>New page</b></p><div>= Numbering and Identifier Policy =<br /> <br /> This page defines the official policy for identifiers, numbering, and file naming within the Costasano Heritage Database.<br /> <br /> It establishes a single, consistent strategy to ensure:<br /> <br /> * uniqueness<br /> * predictability<br /> * stability over time<br /> * minimal editorial effort<br /> * long-term maintainability<br /> <br /> Identifiers are technical labels only.<br /> <br /> They must never encode interpretation or semantics beyond grouping and sequencing.<br /> <br /> <br /> <br /> == Scope ==<br /> <br /> This policy applies to:<br /> <br /> * DigitalAssets<br /> * HeritageObjects (if numbered)<br /> * MediaWiki file names derived from DigitalAssets<br /> <br /> It does NOT apply to:<br /> <br /> * Persons<br /> * Organizations<br /> * Places<br /> * Keywords<br /> * lookup tables<br /> <br /> <br /> <br /> = Core philosophy =<br /> <br /> <br /> <br /> == Separation of concerns ==<br /> <br /> The system strictly separates:<br /> <br /> * Files → storage only<br /> * DigitalAssets → interpretation and metadata<br /> * Research entities → historical meaning<br /> <br /> Therefore:<br /> <br /> Files must NEVER define identity.<br /> <br /> Identity is defined only by research entities (primarily DigitalAssets).<br /> <br /> <br /> <br /> == Identifiers are mechanical ==<br /> <br /> Identifiers:<br /> <br /> * are generated automatically<br /> * are sequential<br /> * are context-based<br /> * contain no interpretation<br /> * must not be edited manually<br /> <br /> Meaning belongs in metadata fields, not in the identifier.<br /> <br /> <br /> <br /> == One source of truth ==<br /> <br /> Each entity has exactly one identifier.<br /> <br /> Derived objects must reuse that identifier rather than creating new numbering systems.<br /> <br /> No parallel or competing counters are allowed.<br /> <br /> <br /> <br /> = Identifier structure =<br /> <br /> <br /> <br /> == Standard format ==<br /> <br /> Numbered entities use:<br /> <br /> CHAPTER–CONTEXT–COUNTER<br /> <br /> Example:<br /> <br /> CH03-ROM-0007<br /> <br /> <br /> <br /> === Components ===<br /> <br /> ==== Chapter ====<br /> <br /> Short code of the ResearchChapter.<br /> <br /> Provides narrative grouping.<br /> <br /> Example:<br /> <br /> CH03<br /> <br /> <br /> <br /> ==== Context ====<br /> <br /> Short code of either:<br /> <br /> * an Organization, or<br /> * a Place<br /> <br /> Whichever best describes the primary context.<br /> <br /> The slot is neutral and does not distinguish between actor or location.<br /> <br /> Examples:<br /> <br /> ROM<br /> FLO<br /> ARCH<br /> CONG<br /> <br /> <br /> <br /> ==== Counter ====<br /> <br /> Sequential integer:<br /> <br /> * starts at 1<br /> * unique within (chapter + context)<br /> * zero padded<br /> * automatically computed<br /> <br /> Examples:<br /> <br /> 0001<br /> 0002<br /> 0003<br /> <br /> <br /> <br /> == Example ==<br /> <br /> CH03-ROM-0015<br /> <br /> Means:<br /> <br /> * Chapter 03<br /> * Context Rome<br /> * 15th registered item in this group<br /> <br /> Nothing more.<br /> <br /> <br /> <br /> = DigitalAssets numbering =<br /> <br /> <br /> <br /> == Principle ==<br /> <br /> DigitalAssets are the primary numbered entities because they represent concrete research sources.<br /> <br /> Each DigitalAsset receives exactly one identifier.<br /> <br /> <br /> <br /> == Implementation ==<br /> <br /> The DigitalAssets table stores:<br /> <br /> * chapter_id<br /> * context_code<br /> * sequence_number<br /> * identifier<br /> <br /> When creating a new record:<br /> <br /> # determine chapter<br /> # determine context (organization or place)<br /> # query MAX(sequence_number) for that pair<br /> # next = max + 1<br /> # compose identifier<br /> # save identifier<br /> <br /> No counter table exists.<br /> <br /> The table itself acts as the counter history.<br /> <br /> <br /> <br /> == Rationale ==<br /> <br /> This approach:<br /> <br /> * avoids locking or race conditions<br /> * avoids separate counter tables<br /> * is simple to understand<br /> * works reliably with Cargo<br /> * is easy to debug<br /> <br /> <br /> <br /> = File naming policy =<br /> <br /> <br /> <br /> == Core rule ==<br /> <br /> Files are storage only.<br /> <br /> Files must NEVER have independent numbering.<br /> <br /> <br /> <br /> == Naming rule ==<br /> <br /> The file name MUST reuse the DigitalAsset identifier.<br /> <br /> Format:<br /> <br /> identifier + extension<br /> <br /> Examples:<br /> <br /> CH03-ROM-0007.jpg<br /> CH03-ROM-0007.tif<br /> CH03-ROM-0007.pdf<br /> <br /> <br /> <br /> == Why ==<br /> <br /> This guarantees:<br /> <br /> * one file ↔ one DigitalAsset<br /> * immediate visual matching<br /> * no duplicate numbering systems<br /> * easier exports and backups<br /> * long-term stability<br /> <br /> <br /> <br /> == Derivatives ==<br /> <br /> Derived files reuse the same base identifier with suffixes.<br /> <br /> Examples:<br /> <br /> CH03-ROM-0007_master.tif<br /> CH03-ROM-0007_web.jpg<br /> CH03-ROM-0007_ocr.pdf<br /> <br /> No new counters are created.<br /> <br /> <br /> <br /> == Prohibited ==<br /> <br /> The following are not allowed:<br /> <br /> * independent file numbering<br /> * MediaWiki auto-generated names<br /> * timestamps<br /> * random hashes<br /> * renaming after upload<br /> * separate file counters<br /> <br /> <br /> <br /> = HeritageObjects numbering (optional) =<br /> <br /> HeritageObjects may optionally use the same scheme if sequential registration is useful.<br /> <br /> If used:<br /> <br /> * follow the same structure<br /> * maintain separate counters<br /> * never mix sequences with DigitalAssets<br /> <br /> <br /> <br /> = What is NOT numbered =<br /> <br /> The following entities intentionally do not use numbering:<br /> <br /> * Persons<br /> * Organizations<br /> * Places<br /> * Keywords<br /> * lookup tables<br /> <br /> These are identified by names or codes only.<br /> <br /> Numbering would add complexity without benefit.<br /> <br /> <br /> <br /> = Editorial workflow =<br /> <br /> <br /> <br /> == DigitalAsset creation ==<br /> <br /> # create DigitalAsset page via form<br /> # identifier generated automatically<br /> # upload file using that exact name<br /> # link file<br /> <br /> Never upload files first and rename later.<br /> <br /> <br /> <br /> == Maintenance rule ==<br /> <br /> Identifiers are permanent.<br /> <br /> They must never be changed after creation.<br /> <br /> <br /> <br /> = Design principles summary =<br /> <br /> The system prioritizes:<br /> <br /> * simplicity<br /> * determinism<br /> * automation<br /> * long-term stability<br /> * minimal dependencies<br /> <br /> Boring, predictable numbering is preferred over clever solutions.<br /> <br /> <br /> <br /> == Status ==<br /> <br /> Official numbering and identifier policy – Version 1.0</div>

Mngr